antissoft / lvqianmeiye_ERP

工资服务接口检查报告.md 4.21 KB

工资服务接口检查报告

检查时间

2025-01-XX

检查范围

检查所有工资计算服务的导入、锁定、确认接口实现情况。

工资服务清单

1. LqSalaryService (健康师工资)

  • 实体表: lq_salary_statistics
  • 导入接口: ✅ POST /import
  • 确认接口: ✅ POST /confirm
  • 锁定接口: ❓ 未找到专门的锁定接口（可能通过PUT/PATCH更新IsLocked字段）

2. LqTechTeacherSalaryService (科技部老师工资)

  • 实体表: lq_tech_teacher_salary_statistics
  • 导入接口: ✅ POST /import
  • 确认接口: ✅ POST /confirm
  • 锁定接口: ❓ 未找到专门的锁定接口（可能通过PUT/PATCH更新IsLocked字段）

3. LqAssistantSalaryService (店助工资)

  • 实体表: lq_assistant_salary_statistics
  • 导入接口: ✅ POST /import
  • 确认接口: ✅ POST /confirm
  • 锁定接口: ❓ 未找到专门的锁定接口（可能通过PUT/PATCH更新IsLocked字段）

4. LqStoreManagerSalaryService (店长工资)

  • 实体表: lq_store_manager_salary_statistics
  • 导入接口: ✅ POST /import
  • 确认接口: ✅ POST /confirm
  • 锁定接口: ❓ 未找到专门的锁定接口（可能通过PUT/PATCH更新IsLocked字段）

5. LqDirectorSalaryService (主任工资)

  • 实体表: lq_director_salary_statistics
  • 导入接口: ✅ POST /import
  • 确认接口: ✅ POST /confirm
  • 锁定接口: ❓ 未找到专门的锁定接口（可能通过PUT/PATCH更新IsLocked字段）

6. LqMajorProjectTeacherSalaryService (大项目部老师工资)

  • 实体表: lq_major_project_teacher_salary_statistics
  • 导入接口: ✅ POST /import
  • 确认接口: ✅ POST /confirm
  • 锁定接口: ❓ 未找到专门的锁定接口（可能通过PUT/PATCH更新IsLocked字段）

7. LqMajorProjectDirectorSalaryService (大项目主管工资)

  • 实体表: lq_major_project_director_salary_statistics
  • 导入接口: ✅ POST /import
  • 确认接口: ✅ POST /confirm
  • 锁定接口: ❓ 未找到专门的锁定接口（可能通过PUT/PATCH更新IsLocked字段）

8. LqTechGeneralManagerSalaryService (科技部总经理工资)

  • 实体表: lq_tech_general_manager_salary_statistics
  • 导入接口: ✅ POST /import
  • 确认接口: ✅ POST /confirm
  • 锁定接口: ❓ 未找到专门的锁定接口（可能通过PUT/PATCH更新IsLocked字段）

9. LqBusinessUnitManagerSalaryService (事业部总经理/经理工资)

  • 实体表: lq_business_unit_manager_salary_statistics
  • 导入接口: ✅ POST /import
  • 确认接口: ✅ POST /confirm
  • 锁定接口: ❓ 未找到专门的锁定接口（可能通过PUT/PATCH更新IsLocked字段）

接口实现统计

接口类型 已实现 未实现 总计
导入接口 (import) 9 0 9
确认接口 (confirm) 9 0 9
锁定接口 (lock) 0 9 9

发现的问题

问题1: 缺少锁定接口

  • 状态: ⚠️ 所有工资服务都缺少专门的锁定接口
  • 影响: 锁定功能可能通过其他方式实现（如PUT/PATCH更新接口）
  • 建议: 需要确认锁定功能的实现方式

备注

  1. 锁定功能: 从代码逻辑看，锁定功能（IsLocked字段）可能在以下方式实现：

    • 通过标准的PUT/PATCH更新接口更新IsLocked字段
    • 通过列表的批量更新功能
    • 或者前端通过更新功能手动设置IsLocked=1

  2. 导入功能: 所有9个工资服务的导入接口都已实现，支持Excel导入

  3. 确认功能: 所有9个工资服务的确认接口都已实现，员工可以确认工资条

  4. 保护逻辑:

    • 计算工资时：跳过已锁定（IsLocked=1）或已确认（EmployeeConfirmStatus=1）的记录
    • 导入时：跳过已锁定（IsLocked=1）或已确认（EmployeeConfirmStatus=1）的记录
    • 员工确认时：只允许确认已锁定（IsLocked=1）的记录

建议

  1. ✅ 导入接口: 所有服务都已实现，无需额外工作
  2. ✅ 确认接口: 所有服务都已实现，无需额外工作
  3. ⚠️ 锁定接口: 需要确认是否需要专门的锁定接口，或者锁定功能已通过其他方式实现