1602b7bbad
- Wiki 7 文件关键数字刷新：迁移 96→103、实体 45→46、前端 163→225、测试 5→36 - 修复 architecture.md PostgreSQL 版本不一致（18→16） - 修复 erp-ai.md 实体数 3→6、erp-health.md 实体数 45→46 - 更新 index.md 文档索引：specs 41、plans 38、discussions 18 - 新增事件注册表/方法论/分析报告引用 - 新增页面/组件测试设计规格（模式化工厂方案） - 新增 Q2 路线图规格（技术债 + 新功能并行 8 周）
132 lines
4.7 KiB
Markdown
132 lines
4.7 KiB
Markdown
# HMS Q2 路线图 — 技术债清理 + 新功能并行推进
|
||
|
||
> 日期: 2026-05-03 | 类型: 设计规格 | 状态: 定稿
|
||
>
|
||
> **目标：** 在 8 周内（2026-05 ~ 2026-06），以 60% 技术债 + 40% 新功能的节奏，将项目健康度从 B+ 提升到 A-。
|
||
|
||
## 1. 背景
|
||
|
||
### 当前状态
|
||
|
||
止血（P0）和补短板（P1）阶段已基本完成：
|
||
- ✅ 编译器警告清零（22 → 0）
|
||
- ✅ 孤立事件清理（36% → 0%）
|
||
- ✅ Store 单元测试（52 个）+ API 契约测试（244 个）
|
||
- ✅ 前端错误处理统一（9 文件）
|
||
- ✅ Tracing 补全（health_data + action_inbox）
|
||
- ✅ 限流 fail-close（默认 true）
|
||
- ✅ Wiki 数据一致性刷新
|
||
- ✅ 小程序透析模块 + 知情同意页面
|
||
|
||
### 剩余技术债
|
||
|
||
| 项 | 现状 | 目标 |
|
||
|----|------|------|
|
||
| 页面/组件测试 | 1/99 (~3%) | 85/99 (85%) |
|
||
| 千行 service 文件 | 4 个 | 0 个 |
|
||
| 前端大组件 | 5 个 500+ 行 | 0 个 |
|
||
| TypeScript any | Web 10 / 小程序 28 | Web 0 / 小程序 <5 |
|
||
|
||
### 新功能需求
|
||
|
||
| 方向 | 设计规格 | 实施状态 |
|
||
|------|---------|---------|
|
||
| AI 功能前端补全 | 已有 SSE 后端 | 前端无 UI 入口 |
|
||
| 工作台深度优化 | 已有设计规格 | Phase 1 完成，v2 待开始 |
|
||
| 实时体征 + BLE | 已有设计规格 | 未实施 |
|
||
| 小程序体验优化 | 已有设计规格 | 部分完成 |
|
||
|
||
## 2. 时间线与里程碑
|
||
|
||
### W1-2：AI 前端补全 + 测试工厂基础
|
||
|
||
**技术债 (60%)**
|
||
- 开发页面测试工厂（renderWithProviders + createListPageTests）
|
||
- 第一批页面测试（20 个健康管理核心页面）
|
||
|
||
**新功能 (40%)**
|
||
- AI 分析列表页 — 展示历史分析记录
|
||
- AI 分析详情页 — SSE 流式响应 UI
|
||
- AI Prompt 管理页 — CRUD + 激活/回滚
|
||
- AI 用量仪表盘 — 用量统计图表
|
||
|
||
**里程碑 M1:** AI 分析页面可用 + 20 页面测试通过
|
||
|
||
### W3-4：工作台优化 + 测试扩展
|
||
|
||
**技术债 (60%)**
|
||
- createDetailPageTests + createFormPageTests 工厂
|
||
- 第二批页面测试（30 个）
|
||
|
||
**新功能 (40%)**
|
||
- 医生操作台 v2 — AI 洞察面板集成 + 行动收件箱增强
|
||
- 健康管理师工作台 v2 — 团队概览 + 任务分配优化
|
||
|
||
**里程碑 M2:** 工作台 v2 上线 + 50 页面测试通过
|
||
|
||
### W5-6：实时体征 + 大文件拆分
|
||
|
||
**技术债 (60%)**
|
||
- points_service.rs (1863 行) → 拆为 4 个模块
|
||
- stats_service.rs (1117 行) → 拆为 3 个模块
|
||
- patient_service.rs (1118 行) → 拆为 4 个模块
|
||
- health_data_service.rs (1056 行) → 拆为 3 个模块
|
||
|
||
**新功能 (40%)**
|
||
- 实时体征管线 MVP — SSE 推送 + 前端图表实时更新
|
||
- BLE 设备适配器增强 — 小米手环数据同步优化
|
||
|
||
**里程碑 M3:** 实时体征管线 MVP + 4 个千行文件拆分完成
|
||
|
||
### W7-8：小程序优化 + 测试收尾
|
||
|
||
**技术债 (60%)**
|
||
- createDashboardPageTests 工厂
|
||
- 第三批页面测试（20 个）+ 手写测试（14 个复杂页面）
|
||
- TypeScript any 消除（Web 10 → 0）
|
||
|
||
**新功能 (40%)**
|
||
- 小程序医生端体验优化 — 告警处理流程 + 患者快速查看
|
||
- 小程序患者端优化 — 适老化改进 + 健康数据可视化增强
|
||
|
||
**里程碑 M4:** 小程序优化完成 + 页面覆盖率 85%
|
||
|
||
## 3. 新功能依赖关系
|
||
|
||
```
|
||
AI 前端补全（W1-2）
|
||
└→ 工作台优化（W3-4）— AI 洞察面板是工作台组件
|
||
└→ 实时体征管线（W5-6）— 体征数据在工作台展示
|
||
|
||
小程序优化（W7-8）— 独立模块，可任意时序
|
||
```
|
||
|
||
## 4. 成功度量
|
||
|
||
| 指标 | 当前 | W2 | W4 | W6 | W8 |
|
||
|------|------|----|----|----|-----|
|
||
| 页面测试覆盖率 | 3% | 21% | 51% | 51% | 85% |
|
||
| 千行 service 文件 | 4 | 4 | 4 | 0 | 0 |
|
||
| AI 端点有 UI 入口 | 0/4 | 4/4 | 4/4 | 4/4 | 4/4 |
|
||
| 工作台功能完整度 | Phase 1 | Phase 1 | Phase 2 | Phase 2 | Phase 2 |
|
||
| TypeScript any (Web) | 10 | 10 | 10 | 10 | 0 |
|
||
| 项目健康度评分 | B+ | — | — | — | A- |
|
||
|
||
## 5. 风险
|
||
|
||
| 风险 | 影响 | 缓解 |
|
||
|------|------|------|
|
||
| 新功能范围蔓延 | 技术债推迟 | 每周严格 60/40 比例 |
|
||
| 测试工厂不支持页面变体 | 覆盖率虚高 | 工厂先验证 3 个差异最大页面 |
|
||
| 实时体征管线技术复杂 | W5-6 延期 | 先做 SSE 推送 MVP，不做 WebSocket |
|
||
| 单人开发瓶颈 | 所有任务串行 | 技术债和新功能交替进行，避免上下文切换 |
|
||
|
||
## 6. 与其他规格的关系
|
||
|
||
本路线图引用以下已有规格作为实施输入：
|
||
- `2026-05-03-web-page-component-testing-design.md` — 页面测试工厂
|
||
- `2026-04-26-realtime-vital-signs-pipeline-design.md` — 实时体征管线
|
||
- `2026-04-28-ui-ux-overhaul-design.md` — 工作台/UI 重构
|
||
- `2026-04-25-erp-ai-module-design.md` — AI 模块设计
|
||
- `2026-04-26-BLE-device-adaptation-design.md` — BLE 设备适配
|