Files
caiwuzongzhang/docs/issues/012-p1-frontend-production-api-integration.md

38 lines
2.0 KiB
Markdown

# [P1] 前端生产 API 集成并移除演示数据
## 背景
当前双端 UI 已完成,但公司、账户、流水、审核、余额、结账和提醒主要来自静态 HTML、`pairData()`、DOM 修改或 `localStorage`。这会造成页面看似成功但服务端没有事实记录。
## 范围
- 为每个后端垂直切片建立 API 客户端、加载/空/错误/重试状态。
- 用服务端真实数据替换 A-F 公司、A 公司固定上下文、静态流水和演示审核行。
- 删除 `pairData()` 模拟核算和业务状态 `localStorage`;仅允许保留无业务风险的 UI 偏好。
- 表单提交以服务端响应为权威,失败时不得先显示成功或修改最终状态。
- 保留总账/公司独立路由、四统计卡层级、响应式、键盘和减少动效支持。
- 为上传、账户审批、手工记录审批、匹配确认、查询导出和结账建立端到端测试。
## 验收标准
- [ ] 刷新页面、重新登录和换一台客户端后,业务状态一致。
- [ ] 仓库中不再存在用于业务结果的 `pairData()``IMP-DEMO-*` 或硬编码 A-F 数据源。
- [ ] 公司上下文来自认证会话,不能由客户端选择或篡改。
- [ ] 所有成功提示都对应已提交的服务端事务;失败有明确恢复动作。
- [ ] 管理端和公司端仍是独立页面和不同首页优先级。
- [ ] 375、768、1024、1440px 下无页面级溢出,关键流程键盘可操作,状态不只依赖颜色。
- [ ] 关键端到端流程在 CI 中通过,浏览器控制台无未处理错误。
## 实施建议
不要等所有后端完成后一次性重写前端。按 Issue 004-011 的垂直切片逐步接入,每完成一个资源就删除对应演示状态。
## 测试
- 总账端和公司端分别覆盖登录、上传、审核、匹配、查询、导出、结账和刷新恢复的端到端测试。
- 覆盖公司级权限篡改、API 失败重试、空状态、慢响应、重复提交、移动端布局、键盘操作和减少动效模式。
## 依赖
Issue 003-011,按垂直切片推进。