# 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 设备适配