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
parent 6d1a7fba98
commit 1602b7bbad
9 changed files with 620 additions and 38 deletions
--- a/docs/superpowers/specs/2026-05-03-q2-roadmap-design.md
+++ b/docs/superpowers/specs/2026-05-03-q2-roadmap-design.md
@@ -0,0 +1,131 @@
+# 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 设备适配
--- a/docs/superpowers/specs/2026-05-03-web-page-component-testing-design.md
+++ b/docs/superpowers/specs/2026-05-03-web-page-component-testing-design.md
@@ -0,0 +1,446 @@
+# Web 前端页面/组件全面测试设计规格
+
+> 日期: 2026-05-03 | 类型: 设计规格 | 状态: 定稿
+>
+> **目标：** 为 HMS Web 前端页面/组件建立全面测试覆盖，从当前 ~3% 页面覆盖率提升到 85%（约 85/99 个页面有测试文件）。
+
+## 1. 背景与动机
+
+### 为什么做
+
+2026-05-03 深度分析报告中，4 个专家组独立将「前端测试空白」标记为最大质量风险。虽然此后的工作已完成 Store 测试（6 个）和 API 契约测试（25 个），但 **99 个页面/组件中仅有 1 个（StatusTag）有测试**。
+
+页面级测试的缺失意味着：
+- 任何重构都无法验证不引入回归
+- 错误处理统一化（18 文件）已执行但无测试保障
+- 大组件拆分（5 个 500+ 行文件）因无安全网而风险过高
+
+### 范围
+
+- **覆盖：** Web 前端 99 个页面/组件 TSX 文件
+- **不含：** Store 测试（已完成）、API 契约测试（已完成）、E2E 测试（独立维护）
+- **工具：** Vitest + @testing-library/react + msw
+
+## 2. 页面模式分类
+
+分析 99 个页面组件后识别出 4 种核心交互模式：
+
+### 模式 1：列表页（ListPage）— ~50 个页面
+
+**特征：** Ant Design Table + FilterBar + 分页 + 新建/编辑弹窗
+
+**示例：** PatientList, AppointmentList, AlertList, DoctorList, Users, Roles, Organizations, Messages, ArticleManageList, PointsProductList, PointsOrderList, PointsRuleList, AlertRuleList, FollowUpTaskList, FollowUpRecordList, FollowUpTemplateList, ConsultationList, DeviceManage, DialysisManageList, OfflineEventList, DictionaryManager, MenuConfig, NumberingRules, PluginAdmin, PluginMarket, AuditLogViewer, PendingTasks, CompletedTasks, ProcessDefinitions, InstanceMonitor
+
+**测试要点：**
+1. 初始渲染调用列表 API
+2. 表格渲染正确的列名
+3. 分页翻页传递正确参数
+4. 筛选器传递正确参数
+5. 新建按钮可点击
+6. 编辑按钮可点击
+
+### 模式 2：详情页（DetailPage）— ~15 个页面
+
+**特征：** 多 Tab 切换 + 子组件按 Tab 加载
+
+**示例：** PatientDetail, ConsultationDetail, PatientDetail 内的 Tab 组件（VitalSignsTab, LabReportsTab, FollowUpTab, FamilyMembersTab, HealthRecordsTab, DeviceReadingsTab, PointsAccountTab, DailyMonitoringTab, AiSuggestionTab）
+
+**测试要点：**
+1. URL 参数正确传递
+2. Tab 切换加载对应数据
+3. 返回导航正常
+
+### 模式 3：表单页（FormPage）— ~10 个页面
+
+**特征：** 独立表单页面 + 提交/保存
+
+**示例：** ArticleEditor, Login, ArticleCategoryManage, ArticleTagManage, PatientTagManage, ChangePassword, ThemeSettings, LanguageManager, SystemSettings
+
+**测试要点：**
+1. 表单字段正确渲染
+2. 必填校验触发
+3. 提交调用正确 API
+4. 成功后正确跳转或提示
+
+### 模式 4：仪表盘页（DashboardPage）— ~10 个页面
+
+**特征：** 统计卡片 + 图表 + 数据聚合
+
+**示例：** Home, StatisticsDashboard, AlertDashboard, AiUsageDashboard, AiAnalysisList, AiPromptList, AiUsageDashboard, DashboardWidgets
+
+**测试要点：**
+1. 统计 API 正确调用
+2. 数据渲染到卡片
+3. 时间范围切换传参正确
+
+### 不归类 — ~14 个复杂页面
+
+PluginCRUDPage, PluginDashboardPage, PluginGraphPage, PluginKanbanPage, PluginTabsPage, PluginTreePage, ProcessDesigner, ProcessViewer, Settings（容器页）, Workflow（容器页）, CalendarView, VitalSignsChart, ImagePreview, AlertDetailPanel
+
+这些页面需要独立手写测试。
+
+## 3. 技术架构
+
+### 3.1 工具链
+
+```
+vitest 4 + @testing-library/react 16 + msw 2
+```
+
+**选择 msw 的理由：**
+- 拦截层在网络层，与 axios/fetch 解耦
+- API mock handlers 可与已有 API 契约测试共享
+- 支持真实 HTTP 状态码和错误场景模拟
+- 不需要在每个测试文件中手动 jest.fn()
+
+### 3.2 文件结构
+
+```
+apps/web/src/test/
+├── setup.ts                     # 已有：jsdom setup + @testing-library/jest-dom
+├── factories/
+│   ├── listPageTests.ts         # createListPageTests() — 列表页测试工厂
+│   ├── detailPageTests.ts       # createDetailPageTests() — 详情页测试工厂
+│   ├── formPageTests.ts         # createFormPageTests() — 表单页测试工厂
+│   └── dashboardPageTests.ts    # createDashboardPageTests() — 仪表盘测试工厂
+├── helpers/
+│   ├── renderWithProviders.tsx   # Router + Zustand Store + AntD ConfigProvider 包裹
+│   ├── mswServer.ts             # msw server setup/teardown
+│   ├── apiHandlers.ts           # 通用 API mock handlers（与契约测试共享）
+│   └── testFixtures.ts          # 测试数据工厂（患者、医生、预约等）
+```
+
+### 3.3 工厂函数接口
+
+```typescript
+// 列表页测试工厂
+interface ListPageTestConfig {
+  component: React.ComponentType;
+  apiUrl: string;
+  columns: string[];
+  filters?: Array<{ name: string; type: 'select' | 'input' | 'date' }>;
+  hasCreate?: boolean;
+  hasEdit?: boolean;
+  hasDelete?: boolean;
+  mockData: Record<string, unknown>[];
+}
+
+function createListPageTests(config: ListPageTestConfig): void;
+
+// 详情页测试工厂
+interface DetailPageTestConfig {
+  component: React.ComponentType;
+  detailApiUrl: string;
+  tabs: Array<{ label: string; apiUrl: string }>;
+  mockDetail: Record<string, unknown>;
+}
+
+function createDetailPageTests(config: DetailPageTestConfig): void;
+
+// 表单页测试工厂
+interface FormPageTestConfig {
+  component: React.ComponentType;
+  submitApiUrl: string;
+  submitMethod: 'POST' | 'PUT';
+  requiredFields: string[];
+  mockInitialValues?: Record<string, unknown>;
+}
+
+function createFormPageTests(config: FormPageTestConfig): void;
+
+// 仪表盘测试工厂
+interface DashboardTestConfig {
+  component: React.ComponentType;
+  statsApis: Array<{ url: string; responseKey: string }>;
+  hasDateRangePicker?: boolean;
+}
+
+function createDashboardPageTests(config: DashboardTestConfig): void;
+```
+
+### 3.4 renderWithProviders
+
+```typescript
+// 统一包裹组件，模拟真实运行环境
+function renderWithProviders(
+  ui: React.ReactElement,
+  options?: {
+    initialRoute?: string;
+    preloadedState?: Record<string, unknown>;
+    userRole?: 'admin' | 'doctor' | 'nurse';
+  }
+): {
+  ...RenderResult;
+  store: ReturnType<typeof useStore>;
+};
+```
+
+包裹内容：
+- `<MemoryRouter>` — 模拟路由
+- Zustand store 重置 + 预填充 — Zustand v5 不使用 Provider，通过 `zustand/testing` 或直接 store.setState 注入测试状态
+- Ant Design `<ConfigProvider>` — 中文 locale + 主题（注意 antd v6 的 Modal 默认渲染到 document.body，需设置 `getContainer` 或使用 `container.baseElement`）
+
+## 4. 执行策略
+
+### 4.1 分批计划
+
+#### 第一批（~20 个测试文件）：健康管理核心流程
+
+优先覆盖患者和预约管理，这是所有业务的基础。
+
+**工厂开发 + 核心页面：**
+
+| 页面 | 模式 | 说明 |
+|------|------|------|
+| PatientList | ListPage | 患者列表 — 验证工厂 |
+| PatientDetail | DetailPage | 患者详情 — 验证工厂 |
+| AppointmentList | ListPage | 预约列表 |
+| FollowUpTaskList | ListPage | 随访任务 |
+| FollowUpRecordList | ListPage | 随访记录 |
+| AlertList | ListPage | 告警列表 |
+| AlertDashboard | DashboardPage | 告警仪表盘 |
+| ConsultationList | ListPage | 咨询列表 |
+| ConsultationDetail | DetailPage | 咨询详情 |
+| DoctorList | ListPage | 医生列表 |
+| DoctorSchedule | FormPage | 医生排班 |
+| VitalSignsTab | DetailPage(sub) | 体征 Tab |
+| LabReportsTab | DetailPage(sub) | 化验 Tab |
+| StatusTag | 已有 | 补充更多场景 |
+| PatientSelect | FormPage(sub) | 患者选择器 |
+| DoctorSelect | FormPage(sub) | 医生选择器 |
+| FilterBar | 组件测试 | 筛选栏 |
+| ExportButton | 组件测试 | 导出按钮 |
+| AiSuggestionTab | DetailPage(sub) | AI 建议 Tab |
+| HealthRecordsTab | DetailPage(sub) | 健康记录 Tab |
+
+#### 第二批（~30 个测试文件）：其余健康管理 + 基础模块
+
+| 域 | 页面数 | 模式 |
+|----|--------|------|
+| 积分系统 | 3 (PointsProductList, PointsOrderList, PointsRuleList) | ListPage |
+| 内容管理 | 4 (ArticleManageList, ArticleEditor, ArticleCategoryManage, ArticleTagManage) | ListPage + FormPage |
+| 设备 + 透析 + 线下活动 | 3 | ListPage |
+| 基础：Users, Roles, Organizations, Messages | 4 | ListPage |
+| Login | 1 | FormPage |
+| 健康管理剩余 | ~14 | 混合 |
+
+#### 第三批（~20 个测试文件）：设置 + 工作流 + 插件 + 复杂页面
+
+| 域 | 页面数 | 说明 |
+|----|--------|------|
+| 设置页面 | 8 | ListPage + FormPage |
+| 工作流 | 6 | 混合（ProcessDesigner 手写） |
+| 插件 | 7 | 混合（多个需手写） |
+| 仪表盘 | 3 | DashboardPage |
+| 复杂页面手写 | ~14 | 独立测试 |
+
+### 4.2 覆盖率目标
+
+| 阶段 | 新增测试文件 | 累计测试文件 | 页面覆盖率 |
+|------|------------|------------|-----------|
+| 当前 | 0 | 36 | ~3% (1/99) |
+| 第一批完成 | +20 | 56 | ~21% |
+| 第二批完成 | +30 | 86 | ~51% |
+| 第三批完成 | +20 | 106 | ~85%（含手写 14） |
+
+> **页面覆盖率 = 有测试文件的页面数 / 总页面数（99）。** 目标 85/99 = 85%。
+
+### 4.3 工厂优先开发顺序
+
+1. `createListPageTests` — 覆盖最多页面（~50 个），第一个开发
+2. `renderWithProviders` + `mswServer` — 所有工厂的基础
+3. `createDetailPageTests` — 覆盖 ~15 个页面
+4. `createFormPageTests` — 覆盖 ~10 个页面
+5. `createDashboardPageTests` — 覆盖 ~10 个页面
+
+每个工厂开发后，用第一批中的 2-3 个页面验证设计，确认可行后再推广。
+
+## 5. 验证标准
+
+### 工厂验证
+
+- [ ] 每个工厂至少用 3 个不同页面验证
+- [ ] 工厂生成的测试在 CI 中通过
+- [ ] `pnpm test:coverage` 输出可查看覆盖率
+
+### 阶段验收
+
+- [ ] 第一批：20 个测试文件通过，PatientList + AppointmentList 完整覆盖
+- [ ] 第二批：累计 86 个测试文件通过
+- [ ] 第三批：累计 106 个测试文件通过，页面覆盖率 85%
+
+### 不做
+
+- 不追求 100% 行覆盖率 — 目标是页面覆盖率 85%
+- 不测 Ant Design 组件内部行为 — 只测我们的业务逻辑
+- 不建立快照测试 — 价值低
+- 不测 CSS 样式 — 由视觉回归测试覆盖
+
+## 6. 风险与缓解措施
+
+### 风险 1：工厂函数无法覆盖同模式内的变异性
+
+50 个列表页虽然共享 Table + FilterBar 模式，但 API 调用方式、筛选器类型、自定义操作按钮差异较大。如果工厂配置接口不足，会退化为逐个手写。
+
+**缓解：** 开发 ListPage 工厂后，立即用差异最大的 3 个页面（PatientList 复杂筛选、AlertList 自定义操作、Users 简单列表）验证。如果配置接口不足，先调整工厂接口再推广。
+
+### 风险 2：Ant Design v6 在 jsdom 下的兼容性
+
+antd 的 Modal/Drawer 默认渲染到 `document.body`，超出 testing-library 的默认查询范围。Select/DatePicker 等组件的弹出层在 jsdom 中行为可能不同。
+
+**缓解：** 在 `renderWithProviders` 中设置 `container.baseElement: document.body`；对 Modal 组件使用 `attachTo` 配置；必要时为 antd 弹窗组件编写自定义查询函数。
+
+### 风险 3：Zustand v5 测试隔离
+
+Zustand v5 移除了 `<Provider>`，store 隔离方式变化。`renderWithProviders` 需要使用 `store.setState()` 直接注入状态而非 Provider 包裹。
+
+**缓解：** 项目已有 Store 测试（6 个）验证了 Zustand v5 的测试模式，沿用相同方法。
+
+### 风险 4：测试运行时间增长
+
+99 个页面测试 + msw 拦截会显著增加 CI 运行时间。
+
+**缓解：** Vitest 默认并行运行；对慢测试标记 `@slow` 隔离运行；CI 中使用 `vitest --reporter=verbose` 配合覆盖率阈值门控（不达标则失败）。
+
+## 附录：99 个页面/组件完整分类
+
+### 列表页模式（ListPage）— 42 个
+
+| # | 页面文件 | 域 |
+|---|---------|-----|
+| 1 | PatientList | health |
+| 2 | AppointmentList | health |
+| 3 | DoctorList | health |
+| 4 | AlertList | health |
+| 5 | AlertRuleList | health |
+| 6 | FollowUpTaskList | health |
+| 7 | FollowUpRecordList | health |
+| 8 | FollowUpTemplateList | health |
+| 9 | ConsultationList | health |
+| 10 | ArticleManageList | health |
+| 11 | PointsProductList | health |
+| 12 | PointsOrderList | health |
+| 13 | PointsRuleList | health |
+| 14 | DeviceManage | health |
+| 15 | DialysisManageList | health |
+| 16 | OfflineEventList | health |
+| 17 | Users | auth |
+| 18 | Roles | auth |
+| 19 | Organizations | auth |
+| 20 | Messages | message |
+| 21 | DictionaryManager | config |
+| 22 | MenuConfig | config |
+| 23 | NumberingRules | config |
+| 24 | AuditLogViewer | config |
+| 25 | PluginAdmin | plugin |
+| 26 | PluginMarket | plugin |
+| 27 | PendingTasks | workflow |
+| 28 | CompletedTasks | workflow |
+| 29 | ProcessDefinitions | workflow |
+| 30 | InstanceMonitor | workflow |
+| 31 | AiAnalysisList | ai |
+| 32 | AiPromptList | ai |
+| 33 | ActionInbox | health |
+| 34 | StatisticsDashboard | health |
+| 35 | ArticleCategoryManage | health |
+| 36 | ArticleTagManage | health |
+| 37 | PatientTagManage | health |
+| 38 | ThemeSettings | config |
+| 39 | LanguageManager | config |
+| 40 | SystemSettings | config |
+| 41 | ChangePassword | auth |
+| 42 | MessageTemplates | message |
+
+### 详情页模式（DetailPage）— 17 个
+
+| # | 页面/组件文件 | 域 |
+|---|--------------|-----|
+| 1 | PatientDetail | health |
+| 2 | ConsultationDetail | health |
+| 3 | VitalSignsTab | health/component |
+| 4 | LabReportsTab | health/component |
+| 5 | FollowUpTab | health/component |
+| 6 | FamilyMembersTab | health/component |
+| 7 | HealthRecordsTab | health/component |
+| 8 | DeviceReadingsTab | health/component |
+| 9 | PointsAccountTab | health/component |
+| 10 | DailyMonitoringTab | health/component |
+| 11 | AiSuggestionTab | health/component |
+| 12 | AlertDetailPanel | health/component |
+| 13 | ActionDetailDrawer | health/workbench |
+| 14 | TaskDetail | health/workbench |
+| 15 | TaskQueue | health/workbench |
+| 16 | TodoList | health/workbench |
+| 17 | TeamOverviewPanel | health/workbench |
+
+### 表单页模式（FormPage）— 10 个
+
+| # | 页面文件 | 域 |
+|---|---------|-----|
+| 1 | ArticleEditor | health |
+| 2 | Login | auth |
+| 3 | DoctorSchedule | health |
+| 4 | NotificationPreferences | message |
+| 5 | NotificationList | message |
+| 6 | DashboardWidgets | dashboard |
+| 7 | ProcessViewer | workflow |
+| 8 | DoctorWorkbench | health/workbench |
+| 9 | OperatorWorkbench | health/workbench |
+| 10 | AdminDashboard | health/workbench |
+
+### 仪表盘模式（DashboardPage）— 10 个
+
+| # | 页面文件 | 域 |
+|---|---------|-----|
+| 1 | Home | core |
+| 2 | AlertDashboard | health |
+| 3 | AiUsageDashboard | ai |
+| 4 | AiInsightPanel | health/workbench |
+| 5 | AdminDashboard (StatisticsDashboard) | health/stats |
+| 6 | DoctorDashboard (StatisticsDashboard) | health/stats |
+| 7 | HealthDataCenter (StatisticsDashboard) | health/stats |
+| 8 | NurseDashboard (StatisticsDashboard) | health/stats |
+| 9 | OperatorDashboard (StatisticsDashboard) | health/stats |
+| 10 | DashboardWidgets | dashboard |
+
+### 手写测试 — 20 个复杂页面
+
+| # | 页面文件 | 域 | 复杂度原因 |
+|---|---------|-----|-----------|
+| 1 | PluginCRUDPage | plugin | 动态表单 + 插件数据 |
+| 2 | PluginDashboardPage | plugin | 动态图表 |
+| 3 | PluginGraphPage | plugin | @xyflow/react 图编辑 |
+| 4 | PluginKanbanPage | plugin | 拖拽看板 |
+| 5 | PluginTabsPage | plugin | 动态 Tab |
+| 6 | PluginTreePage | plugin | 树形结构 |
+| 7 | ProcessDesigner | workflow | BPMN 设计器 |
+| 8 | CalendarView | health/component | 日历交互 |
+| 9 | VitalSignsChart | health/component | ECharts 图表 |
+| 10 | ImagePreview | health/component | 图片预览 |
+| 11 | PatientSelect | health/component | 异步搜索选择器 |
+| 12 | DoctorSelect | health/component | 异步搜索选择器 |
+| 13 | FilterBar | component | 通用筛选组件 |
+| 14 | ExportButton | component | 文件导出 |
+| 15 | StatusTag | health/component | 已有，需补充 |
+| 16 | Settings | core | 容器页面 |
+| 17 | Workflow | core | 容器页面 |
+| 18 | PluginCRUDPageInner | plugin | CRUD 内部逻辑 |
+| 19 | DetailDrawer | plugin | 抽屉详情 |
+| 20 | ImportModal | plugin | 导入弹窗 |
+
+### 排除（非页面组件）
+
+- `dashboardConstants.tsx` — 常量定义文件，不含 React 组件
+
+> **分类合计：** 42 列表 + 17 详情 + 10 表单 + 10 仪表盘 + 20 手写 = 99。页面覆盖率目标 = (99 - 14 未覆盖) / 99 ≈ 85%。
+
+## 预估工时
+
+| 阶段 | 内容 | 预估人时 | 说明 |
+|------|------|---------|------|
+| 基础设施 | renderWithProviders + mswServer + testFixtures | 4h | 一次性投入 |
+| 工厂开发 | 4 个工厂函数 | 12h | 每个工厂 3h |
+| 第一批 | 20 个页面测试 | 12h | 工厂模式，每个 ~0.6h |
+| 第二批 | 30 个页面测试 | 18h | 工厂模式 |
+| 第三批 | 20 个手写 + 17 个工厂 | 24h | 手写页面耗时较高 |
+| **总计** | | **~70h** | 约 2 周全职工作 |