页面总数

54页

8 主包 + 46 子包

原型完成度

100%

54/54 原型页面已实现

API 模块

12个

客户/合同已接真实接口

状态管理

11个 Store

Pinia 全覆盖

## 开发阶段进度

阶段一 · 基础架构与 24 页小程序风格重构 已完成
阶段二 · 补齐 12 个缺失页面（基本信息/消息/知识库等） 已完成
阶段三 · 高级组件（图片上传/地图/电子签名/图表） 已完成
UI 2.0 改版 + 登录页增强（记住密码/密码可见性） 已完成
客户管理 / 合同管理模块（含回款记录、跟进记录） 已完成
后端联调收尾（实时定位、消息推送、Mock 清理） 进行中 · 约 60%

## 三端角色页面覆盖

销售端 21 页 · 完成

首页、我的任务、项目库、发布任务、消息通知、任务提醒、知识库、个人中心等

调度端 19 页 · 完成

排班管理、人员/车辆管理、应急班组、在岗人员、可视化大屏、任务审核等

施工端 13 页 · 完成

每日任务、SOP 施工流程、历史/明日任务、电子签名验收等

## 待完善事项

按优先级排列，建议自上而下推进

P0 · 高

后端地址硬编码 `http://localhost:8080/api`

`src/api/request.ts` 中 BASE_URL 写死为本地地址，真机/发布环境无法访问。建议按环境（dev/test/prod）配置 Base URL，并在 manifest 或环境变量中管理。

P0 · 高

登录态失效缺少统一拦截

request 封装已带 Bearer Token，但建议确认 401/Token 过期时是否统一跳转登录页并清空本地存储，避免各页面各自处理。

P1 · 中

实时定位与消息推送仍停留在"框架就绪"

DEV_LOG 标记 `uni.getLocation` / `uni-push` 待接入真实设备与后端。施工轨迹上报、任务到达提醒等依赖此能力，需与后端排期联调。

P1 · 中

调度端发布任务页仍引用 Mock 数据

`subPackages/pages-dispatch/publishTask.vue` 是全项目唯一还在引用 `src/mock` 的页面；客户/合同模块已全面切换真实接口，建议同步迁移并清理 mock 中"旧版演示数据"。

P1 · 中

客户/合同入口不在 TabBar，需确认导航可达性

`pages/customer`、`pages/contract` 位于主包但 TabBar 仅含首页/任务/排班/我的。若仅从首页快捷入口进入，建议在"我的"或首页固化入口，并验证销售端角色的可见权限控制。

P2 · 低

开发文档过期：DEV_LOG.md 停留在 2026-06-22

之后的 UI 2.0 改版、登录页增强、客户/合同模块均未记录。建议补一轮更新，或在 README 中标注文档时效。

P2 · 低

无自动化测试

已安装 vitest / @vue/test-utils 但 package.json 无 test 脚本、无测试文件。关键链路（登录鉴权、客户/合同表单提交、任务状态流转）建议补最小单测。

P2 · 低

重复页面可考虑收敛

noticeList / noticeDetail / notification / messageList / knowledgeList 等在 common、sales、dispatch、construction 多个子包各有一份。功能一致的建议统一引用 common 版本，减少维护成本（当前约 91 个 .vue 文件）。

## 建议下一步路线

1. 1环境化 Base URL：区分开发/生产环境，完成真机预览验证。
2. 2清除 Mock 残留：迁移 dispatch/publishTask，删除 mock 旧数据。
3. 3联调定位与推送：与后端确认接口与证书，落地实时定位 + uni-push。
4. 4补关键链路测试与文档：登录、合同回款、任务流转三条链路；同步更新 DEV_LOG。