补充移动端产品设计与全量开发文档

This commit is contained in:
czl231
2026-09-07 19:14:58 +08:00
parent 1dd21e6df1
commit a0a4bb1218
196 changed files with 2601 additions and 0 deletions

View File

@@ -0,0 +1,44 @@
# 操作日志:服务端 App 三岗位开发文档
操作时间2026-09-06 17:49:13
操作类型:新增
影响模块:服务端 App 产品设计落地、Flutter 开发规划、Staff Client API 规划
## 操作前状态
- 安装维修端、配送端、安全检查端最新产品设计图已生成,共 122 张。
- 已有《服务端 APP 三岗位产品设计与开发》高层说明,但未逐页落到路由、接口、状态和验收。
- 当前 Flutter 仅有通用任务页面和三栏导航Go Staff Client API 只覆盖基础登录、准入、任务、配送、钱包和取证能力。
## 具体操作
- 核对三个最新产品设计目录及岗位产品设计说明。
- 核对 `apps/service_app` 当前路由、领域模型、Repository 和离线草稿能力。
- 核对 `backend/api/internal/routers/client.go` 中已注册 Staff Client API。
- 新增全量开发文档,逐项覆盖 40 个安装维修页面、42 个配送页面和 40 个安全检查页面。
- 明确蓝色主题、无紫色、无 AI 元素的视觉要求,并记录与旧移动端设计系统的冲突处理。
- 补充接口规划、状态机、数据模型、离线、安全、测试、阶段计划和完成定义。
## 操作后状态
- 已形成可供产品、Flutter、后端和测试共同评审的全量开发基线。
- 文档明确区分“已有、部分、待开发”,未将设计图误记为已实现功能。
- 未修改现有业务代码、数据库或接口行为。
## 文件变更
- 新增 `docs/项目文档_服务端APP三岗位全量功能开发_v1.0.md`
- 新增 `docs/操作日志_服务端APP三岗位开发文档_20260906.md`
- 更新 `docs/README.md` 的专题实施文档索引。
## 验证结果
- 已检查 Markdown 表格、标题层级、页面数量、角色编码和现有 API 路径。
- 已确认全量文档小于 1500 行。
- 未运行 Flutter 或 Go 测试,因为本次只新增文档,不改变可执行代码。
## 风险评估
- 新增接口均为目标设计,开发前仍需完成产品口径、权限和数据库评审。
- 旧设计系统中的服务端紫色主题与最新设计冲突,实施 P0 时必须同步代码和文档,并验证用户端主题无回归。
- 三岗位共享基础设施但业务状态机不同,开发时不可继续扩展为一个通用动态表单。