iven/hms
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0da59c6a0e2db7f1c58d70b68bdfb60d3d503ebf
hms/docs/superpowers/specs/2026-05-03-q2-roadmap-design.md
iven 1602b7bbad
Some checks failed
CI / rust-check (push) Has been cancelled
Details
CI / rust-test (push) Has been cancelled
Details
CI / frontend-build (push) Has been cancelled
Details
CI / security-audit (push) Has been cancelled
Details
docs(wiki): Wiki 全面刷新 + Q2 路线图 + 测试补强设计规格 
- 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 周）
2026-05-03 22:33:08 +08:00

4.7 KiB
Raw Blame History

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 设备适配
Reference in New Issue View Git Blame Copy Permalink