清道夫App — 开发进度报告

环境服务管理平台 · uni-app + Vue 3 + TypeScript + Pinia + Tailwind

报告生成日期:2026-07-13 | 数据基准:master 分支最新提交(UI2.0 + 客户/合同模块)

页面总数

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/customerpages/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。