Blame
|
1 | # 前后端功能与数据一致性检查(2026-10-03) |
||||||
| 2 | ||||||||
| 3 | ## 完成标准 |
|||||||
| 4 | ||||||||
| 5 | 按业务能力核对,不以接口数量代替功能完成。每项能力分别记录: |
|||||||
| 6 | ||||||||
| 7 | | 核对项 | 完成要求 | |
|||||||
| 8 | |---|---| |
|||||||
| 9 | | 后端 | 新增、读取、修改、删除或归档等适用操作可用;权限、状态转换、持久化和回读一致。并非每项业务都必须支持物理删除。 | |
|||||||
| 10 | | 前端 | 决定向用户开放的操作具备入口、表单、列表或详情、提交反馈和错误处理;内部专用能力可不开放,但须明确标记。 | |
|||||||
| 11 | | 前后端契约 | 前端调用的函数、请求字段、必填项、成功响应字段和失败分支与后端一致。 | |
|||||||
| 12 | | 测试站闭环 | 用隔离的 QA 数据验证操作、回读及清理或归档;Schemathesis 验证请求和响应契约。 | |
|||||||
| 13 | ||||||||
| 14 | ## 2026-10-03 核对结果 |
|||||||
| 15 | ||||||||
| 16 | | 范围 | 结果 | |
|||||||
| 17 | |---|---| |
|||||||
| 18 | | 当前本地 ERP 源码 | 214 个后端云函数与 OpenAPI 清单一一对应;前端调用 192 个函数,均能找到后端契约。 | |
|||||||
| 19 | | 前端参数 | 169 处显式请求对象经静态检查,字段名及可确定的必填项符合 OpenAPI;变量和展开对象仍须由流程测试验证。 | |
|||||||
| 20 | | 测试站读取接口 | Schemathesis 分别执行 30 个示例请求和 30 个生成请求;两组均仅在 `getPayrollMonthlyLedger` 发现响应契约失败。其余请求符合其声明的状态码、内容类型和响应结构;部分请求返回预期的 400 或 404,不能据此认定业务数据完整。 | |
|||||||
| 21 | | 测试站 CRUD | 临时组织单元完成新增、回读、修改、回读、删除、删除后回读;六步成功,QA 记录已清理。 | |
|||||||
| 22 | | 版本差异 | 测试站 OpenAPI 有 215 个接口,本地源码有 214 个;测试站多 `getMileageBonusList`。跨版本计数不能直接作为功能缺口。 | |
|||||||
| 23 | ||||||||
| 24 | ## 仅后端存在、当前前端未调用的 22 个接口 |
|||||||
| 25 | ||||||||
| 26 | 这些是**代码对比事实**,不自动等于应向最终用户开放。逐项决定“用户可见 / 内部专用 / 停用”后,再按完成标准验收。 |
|||||||
| 27 | ||||||||
| 28 | | 领域 | 接口 | |
|||||||
| 29 | |---|---| |
|||||||
| 30 | | 人事与组织(11) | `assignOrganizationEmployee`、`attachEmployeeContract`、`backfillEmployeeIdentifiers`、`backfillEmployeeSourceLinks`、`backfillOrganizationFromEmployees`、`endEmployeeAssignment`、`getEmployeeSourceTrace`、`getHrReadiness`、`mapEmployeeIdentity`、`saveOrganizationTransfer`、`transferOrganizationEmployee` | |
|||||||
| 31 | | 财务(4) | `closeFinancePeriod`、`getFinanceCases`、`getTrialBalance`、`previewPayrollJournal` | |
|||||||
| 32 | | 考勤(3) | `confirmAttendanceDay`、`getAttendanceSummaryList`、`rebuildAttendanceSummaries` | |
|||||||
| 33 | | 奖惩(2) | `saveAwardPunishmentEntry`、`saveAwardPunishmentPlan` | |
|||||||
| 34 | | 其他(2) | `importDriverProfileAssets`、已停用的 `logFileAccess` | |
|||||||
| 35 | ||||||||
| 36 | `getHrReadiness` 与 `getEmployeeSourceTrace` 在应用说明中已明确为仅有云函数、界面未接入。其余接口的用户可见性需结合当前业务流程决定。原有[早期角色规划](Home#早期角色规划)、[早期场景规划](Home#早期场景规划)及[早期用例规划](Home#早期用例规划)仅作历史参考。 |
|||||||
