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

2.0 KiB

[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,按垂直切片推进。