antissoft / lvqianmeiye_ERP

  # 修改加班系数接口测试说明
  
  **接口地址**：`PUT /api/Extend/LqXhHyhk/{id}/overtime-coefficient`  
  **创建日期**：2025年1月  
  **文档目的**：说明如何测试修改加班系数接口
  
  ---
  
  ## 一、接口说明
  
  ### 1.1 接口信息
  
  - **请求方式**：PUT
  - **接口路径**：`/api/Extend/LqXhHyhk/{id}/overtime-coefficient`
  - **Content-Type**：`application/json`
  - **需要认证**：是（Bearer Token）
  
  ### 1.2 请求参数
  
  **路径参数**：
  - `id`：消耗单编号（string）
  
  **请求体**：
  ```json
  {
    "overtimeCoefficient": 0.5
  }
  ```
  
  **参数说明**：
  - `overtimeCoefficient`：新的加班系数（decimal?）
    - `NULL` 或 `0`：表示非加班单
    - 大于 `0`（如 0.5、1、1.5）：表示加班单，系数值表示加倍的倍数
  
  ### 1.3 响应格式
  
  **成功响应**（200）：
  ```json
  {
    "code": 200,
    "msg": "操作成功",
    "data": null
  }
  ```
  
  **错误响应**（400/500）：
  ```json
  {
    "code": 400,
    "msg": "错误信息",
    "data": null
  }
  ```
  
  ---
  
  ## 二、测试步骤
  
  ### 2.1 使用测试脚本（推荐）
  

  **测试脚本位置**：`项目文档相关/scripts/sh/test_update_overtime_coefficient.sh`

  
  **执行命令**：
  ```bash
  cd /Users/mr.wang/代码库/绿纤/lvqianmeiye_ERP

  ./项目文档相关/scripts/sh/test_update_overtime_coefficient.sh

  ```
  
  **测试脚本包含的测试用例**：
  1. ✅ 获取登录token
  2. ✅ 获取消耗单记录ID
  3. ✅ 查询当前消耗单信息
  4. ✅ 修改加班系数为0.5
  5. ✅ 验证修改结果（检查计算是否正确）
  6. ✅ 修改加班系数为1.0
  7. ✅ 修改加班系数为0（非加班单）
  8. ✅ 验证修改为0后的结果
  9. ✅ 测试不存在的ID（错误处理）
  10. ✅ 测试无效参数（负数）
  
  ---
  
  ### 2.2 使用curl命令手动测试
  
  #### 步骤1：获取登录token
  
  ```bash

  TOKEN=$(curl -s -X POST "http://localhost:2015/api/oauth/Login" \

    -H "Content-Type: application/x-www-form-urlencoded" \
    -d "account=admin&password=e10adc3949ba59abbe56e057f20f883e" | \
    python3 -c "import sys, json; print(json.load(sys.stdin)['data']['token'])")
  ```
  
  #### 步骤2：获取一个消耗单记录ID
  
  ```bash

  CONSUME_ID=$(curl -s -X GET "http://localhost:2015/api/Extend/LqXhHyhk?currentPage=1&pageSize=1" \

    -H "Authorization: $TOKEN" | \
    python3 -c "import sys, json; data = json.load(sys.stdin); print(data.get('data', {}).get('list', [{}])[0].get('id', ''))")
  ```
  
  #### 步骤3：查询当前消耗单信息
  
  ```bash

  curl -s -X GET "http://localhost:2015/api/Extend/LqXhHyhk/$CONSUME_ID" \

    -H "Authorization: $TOKEN" | python3 -m json.tool
  ```
  
  #### 步骤4：修改加班系数为0.5
  
  ```bash

  curl -s -X PUT "http://localhost:2015/api/Extend/LqXhHyhk/$CONSUME_ID/overtime-coefficient" \

    -H "Authorization: $TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "overtimeCoefficient": 0.5
    }' | python3 -m json.tool
  ```
  
  #### 步骤5：验证修改结果
  
  ```bash

  curl -s -X GET "http://localhost:2015/api/Extend/LqXhHyhk/$CONSUME_ID" \

    -H "Authorization: $TOKEN" | python3 -m json.tool
  ```
  
  **验证要点**：
  - 检查 `overtimeCoefficient` 是否为 0.5
  - 检查 `overtimeSgfy`（加班手工费）是否正确计算：`原始手工费 × 0.5`
  - 检查 `sgfy`（最终手工费）是否正确计算：`原始手工费 + 加班手工费`
  - 检查品项明细的 `overtimeProjectNumber` 和 `projectNumber` 是否正确
  - 检查健康师业绩的 `overtimeKdpxNumber`、`kdpxNumber`、`overtimeLaborCost`、`laborCost` 是否正确
  
  ---
  
  ### 2.3 使用Postman测试
  
  1. **创建新请求**
     - 方法：PUT

     - URL：`http://localhost:2015/api/Extend/LqXhHyhk/{id}/overtime-coefficient`

     - 将 `{id}` 替换为实际的消耗单ID
  
  2. **设置请求头**
     - `Authorization`: `Bearer {token}`
     - `Content-Type`: `application/json`
  
  3. **设置请求体**（Body -> raw -> JSON）
     ```json
     {
       "overtimeCoefficient": 0.5
     }
     ```
  
  4. **发送请求并验证响应**
  
  ---
  
  ## 三、测试用例
  
  ### 3.1 正常测试用例
  
  #### 测试用例1：修改加班系数为0.5
  
  **前置条件**：
  - 存在一个有效的消耗单记录
  - 原始手工费 = 100元
  - 原始项目次数 = 2次
  
  **操作步骤**：
  1. 调用接口，设置 `overtimeCoefficient = 0.5`
  
  **预期结果**：
  - 主表：
    - `overtimeCoefficient = 0.5`
    - `overtimeSgfy = 100 × 0.5 = 50元`
    - `sgfy = 100 + 50 = 150元`
  - 品项明细：
    - `overtimeProjectNumber = 2 × 0.5 = 1次`
    - `projectNumber = 2 + 1 = 3次`
  - 健康师业绩：
    - `overtimeKdpxNumber = 原始值 × 0.5`
    - `kdpxNumber = 原始值 + 加班值 + 陪同值`
    - `overtimeLaborCost = 原始值 × 0.5`
    - `laborCost = 原始值 + 加班值`
  
  ---
  
  #### 测试用例2：修改加班系数为1.0
  
  **操作步骤**：
  1. 调用接口，设置 `overtimeCoefficient = 1.0`
  
  **预期结果**：
  - 加班手工费 = 原始手工费 × 1.0 = 原始手工费
  - 最终手工费 = 原始手工费 × 2
  
  ---
  
  #### 测试用例3：修改加班系数为0（非加班单）
  
  **操作步骤**：
  1. 调用接口，设置 `overtimeCoefficient = 0`
  
  **预期结果**：
  - 所有加班相关字段（`F_Overtime*`）都变为 0
  - 最终值 = 原始值
  
  ---
  
  ### 3.2 异常测试用例
  
  #### 测试用例4：不存在的消耗单ID
  
  **操作步骤**：
  1. 调用接口，使用不存在的ID（如：999999999999999999）
  
  **预期结果**：
  - 返回错误：`耗卡记录不存在或已作废`
  - HTTP状态码：400
  
  ---
  
  #### 测试用例5：无效参数（负数）
  
  **操作步骤**：
  1. 调用接口，设置 `overtimeCoefficient = -0.5`
  
  **预期结果**：
  - 系统应该允许负数（如果需要限制，需要在前端或后端添加验证）
  - 或者返回参数验证错误
  
  ---
  
  #### 测试用例6：原始数据不存在
  
  **操作步骤**：
  1. 找到一个原始手工费为空的消耗单记录
  2. 尝试修改加班系数
  
  **预期结果**：
  - 如果原始手工费为空且最终手工费也为空，应该返回错误：`原始手工费不存在，无法修改加班系数`
  - 如果原始手工费为空但最终手工费存在，应该自动使用最终手工费作为原始值
  
  ---
  
  ## 四、验证要点
  
  ### 4.1 数据一致性验证
  
  1. **原始数据不变**：
     - ✅ 所有 `F_Original*` 字段保持不变
     - ✅ 验证方法：修改前后对比原始字段值
  
  2. **加班数据重新计算**：
     - ✅ 所有 `F_Overtime*` 字段都根据新系数重新计算
     - ✅ 验证方法：检查计算公式是否正确
  
  3. **最终数据正确**：
     - ✅ 所有最终字段 = 原始值 + 加班值
     - ✅ 验证方法：检查最终值是否等于原始值 + 加班值
  
  ---
  
  ### 4.2 事务一致性验证
  
  1. **事务回滚测试**：
     - 在更新过程中模拟异常（如数据库连接断开）
     - 验证所有数据是否回滚，保持一致性
  
  2. **并发测试**：
     - 同时修改同一个消耗单的加班系数
     - 验证数据是否正确，不会出现脏数据
  
  ---
  
  ### 4.3 性能验证
  
  1. **批量更新性能**：
     - 测试有大量品项明细和健康师业绩的消耗单
     - 验证更新速度是否可接受
  
  ---
  
  ## 五、常见问题
  
  ### 5.1 原始数据为空怎么办？
  
  **问题**：如果原始数据（`F_Original*`）为空，系统会如何处理？
  
  **答案**：
  - 系统会自动从当前值中推导出原始值
  - 对于主表：如果 `OriginalSgfy` 为空，使用 `Sgfy` 作为原始值
  - 对于品项明细：如果 `OriginalProjectNumber` 为空，使用 `ProjectNumber` 作为原始值
  - 对于健康师业绩：从最终值中减去加班值和陪同值，得到原始值
  
  ---
  
  ### 5.2 科技部老师业绩是否参与计算？
  
  **问题**：科技部老师业绩表的加班字段是否会被更新？
  
  **答案**：
  - 当前代码中，科技部老师业绩表的加班字段被固定为 0，不参与加班计算
  - 如果需要支持，可以取消注释代码中的相关部分
  
  ---
  
  ### 5.3 修改后是否需要重新计算业绩？
  
  **问题**：修改加班系数后，是否需要重新计算相关的业绩统计？
  
  **答案**：
  - 修改加班系数只影响当前消耗单的数据
  - 如果业绩统计是基于消耗单数据实时计算的，会自动反映新的加班系数
  - 如果业绩统计是预先计算的，可能需要重新计算相关统计
  
  ---
  
  ## 六、测试结果记录
  
  ### 6.1 测试环境
  
  - **测试时间**：2025年1月

  - **测试环境**：开发环境（localhost:2015）

  - **测试人员**：开发团队
  
  ### 6.2 测试结果
  
  | 测试用例 | 测试结果 | 备注 |
  |---------|---------|------|
  | 修改加班系数为0.5 | ✅ 通过 | 计算正确 |
  | 修改加班系数为1.0 | ✅ 通过 | 计算正确 |
  | 修改加班系数为0 | ✅ 通过 | 所有加班字段为0 |
  | 不存在的ID | ✅ 通过 | 返回正确错误信息 |
  | 无效参数（负数） | ⚠️ 待验证 | 需要确认业务规则 |
  | 原始数据为空 | ✅ 通过 | 自动推导原始值 |
  
  ---
  
  ## 七、总结
  
  ### 7.1 接口功能
  
  ✅ **已实现功能**：
  - 修改消耗单的加班系数
  - 自动重新计算所有相关的加班字段
  - 使用事务保证数据一致性
  - 处理原始数据为空的情况
  
  ### 7.2 注意事项
  
  1. **数据备份**：修改前建议备份数据
  2. **权限控制**：确保只有有权限的用户才能修改
  3. **日志记录**：建议记录修改操作日志
  4. **性能考虑**：对于有大量明细的消耗单，更新可能需要一些时间
  
  ---
  
  **文档结束**