Blame

7d667a Harry 2026-10-03 11:43:40
docs: record frontend-backend consistency and mark earlier plans
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#早期用例规划)仅作历史参考。