环境服务管理平台 · uni-app + Vue 3 + TypeScript + Pinia + Tailwind
报告生成日期:2026-07-13 | 数据基准:master 分支最新提交(UI2.0 + 客户/合同模块)
页面总数
54页
8 主包 + 46 子包
原型完成度
100%
54/54 原型页面已实现
API 模块
12个
客户/合同已接真实接口
状态管理
11个 Store
Pinia 全覆盖
首页、我的任务、项目库、发布任务、消息通知、任务提醒、知识库、个人中心等
排班管理、人员/车辆管理、应急班组、在岗人员、可视化大屏、任务审核等
每日任务、SOP 施工流程、历史/明日任务、电子签名验收等
按优先级排列,建议自上而下推进
后端地址硬编码 http://localhost:8080/api
src/api/request.ts 中 BASE_URL 写死为本地地址,真机/发布环境无法访问。建议按环境(dev/test/prod)配置 Base URL,并在 manifest 或环境变量中管理。
登录态失效缺少统一拦截
request 封装已带 Bearer Token,但建议确认 401/Token 过期时是否统一跳转登录页并清空本地存储,避免各页面各自处理。
实时定位与消息推送仍停留在"框架就绪"
DEV_LOG 标记 uni.getLocation / uni-push 待接入真实设备与后端。施工轨迹上报、任务到达提醒等依赖此能力,需与后端排期联调。
调度端发布任务页仍引用 Mock 数据
subPackages/pages-dispatch/publishTask.vue 是全项目唯一还在引用 src/mock 的页面;客户/合同模块已全面切换真实接口,建议同步迁移并清理 mock 中"旧版演示数据"。
客户/合同入口不在 TabBar,需确认导航可达性
pages/customer、pages/contract 位于主包但 TabBar 仅含首页/任务/排班/我的。若仅从首页快捷入口进入,建议在"我的"或首页固化入口,并验证销售端角色的可见权限控制。
开发文档过期:DEV_LOG.md 停留在 2026-06-22
之后的 UI 2.0 改版、登录页增强、客户/合同模块均未记录。建议补一轮更新,或在 README 中标注文档时效。
无自动化测试
已安装 vitest / @vue/test-utils 但 package.json 无 test 脚本、无测试文件。关键链路(登录鉴权、客户/合同表单提交、任务状态流转)建议补最小单测。
重复页面可考虑收敛
noticeList / noticeDetail / notification / messageList / knowledgeList 等在 common、sales、dispatch、construction 多个子包各有一份。功能一致的建议统一引用 common 版本,减少维护成本(当前约 91 个 .vue 文件)。