iven/hms
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(health): 六维度全面均衡分析报告 + 六专家组头脑风暴评审

Browse Source 
- 新增六维度分析报告：架构(7.5)/代码质量(7.0)/业务完整度(7.5)/安全合规(7.5)/生产就绪(5.5)/可扩展性(6.5)，综合 6.9/10 (B)
- 组织 6 位虚拟专家（架构师/后端/前端/安全/DevOps/产品）独立评审，综合 7.0/10 (B)，较上次 6.4/10 提升 +0.6
- 识别 Top 5 行动优先级：OpenAPI 注解补全、性能基准、event.rs 拆分、小程序测试、冻结模块解冻
- 制定三个月路线图：Month 1 质量加固 → Month 2 功能补全 → Month 3 生产化
- 更新 wiki/index.md 关键数字（57 实体、999 测试、24 unwrap、75+ 权限码等）
This commit is contained in:
iven
2026-05-11 03:43:51 +08:00
parent 6269815046
commit 9487ccb62e
3 changed files with 641 additions and 27 deletions
Download Patch File Download Diff File Expand all files Collapse all files

64
wiki/index.md
View File

@@ -4,33 +4,36 @@
## 关键数字
> 最后更新: 2026-05-09 | 数据截止: commit 890c132 (第 716 次提交)
> 最后更新: 2026-05-11 | 数据截止: commit c716cc0 (feat/media-library-banner 分支)
| 指标 | 值 |
|------|-----|
| Rust crate | 18 个（erp-core + 5 基础业务 + erp-health + erp-ai + erp-dialysis + erp-plugin + 5 插件 + erp-plugin-prototype） |
| 数据库表 | 30 基础表 + 44 健康业务表 + 3 AI 表（已实现） |
| 数据库迁移 | 129 个 |
| 后端路由 | 250+ 个（8 公开 + 14 FHIR + 2 网关 + ~230 受保护） |
| Rust crate | 17 个（erp-core + 5 基础业务 + erp-health + erp-ai + erp-dialysis + erp-plugin + 7 插件/原型） |
| Rust 源文件 | 599 个 |
| 数据库表 | 30 基础表 + 49 健康业务表 + 9 AI 表 + 3 媒体库/轮播图表 |
| 数据库迁移 | 137 个（最新 m20260510_000137） |
| 后端路由 | 260+ 个（11 公开 + 14 FHIR + 2 网关 + ~240 受保护） |
| 核心模块 | 5 基础 (auth/config/workflow/message/plugin) + 3 业务 (health + ai + dialysis) |
| erp-health 实体 | 46 个 Entity（~36k 行 Rust，179 文件） |
| erp-ai 实体 | 6 个 Entity（~7k 行 Rust，45 文件，4 AI Provider） |
| Web 前端 | 283 个 TS/TSX 文件（55 路由，含 38 健康路由 + 6 冻结路由） |
| 微信小程序 | Taro 4.2 + React 18，118 个 TS/TSX 文件 / 59 页面 / 3 TabBar + 医生端分包（10 子包） |
| 前端单元测试 | 62 个测试文件（vitest）+ 13 E2E spec（playwright） |
| 后端测试 | 611 单元 + 153 集成 = 772 个函数（97.5% 通过率） |
| 总代码量 | Rust ~87k 行（579 源文件）+ Web 前端 283 文件 + 小程序 118 文件 |
| 事件系统 | 31+ 事件类型（health 模块内）/ 23 幂等消费者 / Outbox + LISTEN/NOTIFY |
| DTO | 105+ 个结构体（20+ 文件） |
| 权限码 | 50 声明（health 39 + ai 6 + dialysis 5）+ 56 基础模块手动注册 |
| erp-health 实体 | **57 个** Entity（31 handler / 36 service / 21 DTO，189 文件） |
| erp-ai 实体 | 9 个 Entity（45 文件，4 AI Provider） |
| Web 前端 | 297 个 TS/TSX 文件（29 活跃路由 + 6 冻结路由，52 API 模块） |
| 微信小程序 | Taro 4.2 + React 18，124 个 TS/TSX 文件 / 66 页面 / 4 TabBar + 医生端分包 |
| 前端单元测试 | 62 个测试文件（472 Web 断言 + 39 MP 断言）+ 13 E2E spec（124 断言） |
| 后端测试 | **999 个函数**（815 同步 + 184 异步），78 个文件含内联测试 |
| 事件系统 | 31 事件类型（health 模块内）/ 23 幂等消费者 / Outbox + LISTEN/NOTIFY |
| 权限码 | **75+ 个**（health 28 + auth 25 + ai 7 + workflow 8 + dialysis 5 + plugin 2） |
| 生产 unwrap | **24 处**（从 514 降至 24），全为安全解包 |
| utoipa 注解 | 322 个 / 21/64 handler 文件 = 33% 覆盖 |
| Clippy | **全 workspace 0 警告**（2026-05-07 清零） |
| 依赖版本 | 全部最新主版本线（Rust edition 2024） |
| API 文档 | `http://localhost:3000/api/docs/openapi.json` |
| Git 提交 | 716 次 |
| 审计状态 | V1: 83% (2026-04-30) → V2: 85% (2026-05-05)，P0 安全修复已完成 |
| Git 提交 | 720+ 次 |
| 系统分析评分 | **6.9/10 (B)**（六维度全面均衡分析，2026-05-11） |
| 审计状态 | V1: 83% → V2: 85%，P0 安全修复已完成，V2 CRITICAL 全清零 |
| 角色测试 | R01-R05 全角色验证完成，86.5% 通过率，5 个 BUG 已修复；小程序 MP 多角色 96.2% 通过率 |
| UI/UX 重构 | Phase 1-5 完成（6 共享组件 + 4 角色仪表盘 + 个人统计数据 + 表单抽屉 + 小程序优化） |
| Design Token | 10 级字号 + 4 结构 token，68 SCSS 文件全面接入（634 引用，3 特殊硬编码），关怀模式 CSS 变量级联自动生效 |
| 项目阶段 | **上线前质量加固**（近 30 次提交全为 fix 类型） |
| Design Token | 10 级字号 + 4 结构 token，68 SCSS 文件全面接入，关怀模式 CSS 变量级联自动生效 |
| 长者模式 | 58/58 页面 100% 覆盖 |
| 项目阶段 | **功能完善**（媒体库+轮播图+文章编辑器上线，6 模块冻结待解冻） |
## 症状导航
@@ -74,6 +77,10 @@
| 冻结模块 API 可绕过 | [[erp-server]] frozen_module | 后端无拦截中间件 | **已修复：** 新增 `frozen_module_middleware` |
| 积分端点 403 权限码错 | [[erp-health]] points_handler | 患者端用了 `health.health-data.list` | **已修复：** 改为 `health.points.list` |
| MCP 审计大量 LOGIN_REDIRECT | [[miniprogram]] §6.8 审计脚本 | 测试用户密码配置错误 | **已修复：** 所有测试用户密码均为 `Admin@2026`（不是 `Test@2026`） |
| 小程序访客轮播图不显示 | [[miniprogram]] 访客首页 | `TARO_APP_DEFAULT_TENANT_ID` 未配置 | **已修复：** `.env` 添加默认 tenant_id，空字符串时跳过 API 调用 |
| 小程序轮播图图片 404 | [[erp-health]] 公开端点 | Axum 路由参数 `:id` → `{id}` 语法变更 + URL 拼接缺失 `/api/v1` | **已修复：** 路由改用 `{banner_id}`，新增 `/public/banner-image/{id}` 图片服务端点 |
| 前端媒体库图片 401 | [[frontend]] MediaLibrary | `/uploads` 路径需要 JWT 认证 | **已修复：** 新增 `resolveMediaUrl()` 工具函数自动拼接 `?token=`，Vite 代理 `/uploads` |
| 后端启动 panic "Path segments must not start with `:`" | [[erp-health]] module.rs | Axum v0.8+ 路由参数语法变更 | 路由定义使用 `{param}` 而非 `:param` |
## 模块导航
@@ -89,8 +96,8 @@
- erp-plugin — WASM 运行时 · 动态表 · 热更新（HMS 保留但非主要扩展方式）
### 核心业务层（HMS 专属）
- [[erp-health]] — **患者管理 · 健康数据 · 预约排班 · 随访管理 · 咨询管理 · 内容管理 · 积分商城 · 透析管理 · 线下活动 · 日常监测 · 告警系统**（原生 Rust 模块，46 实体，已实现）
- [[erp-ai]] — **AI 智能分析 · 化验单解读 · 趋势分析 · 报告摘要**（原生 Rust 模块，6 实体，Phase 1 MVP，已对接本地 Ollama qwen3:4b）
- [[erp-health]] — **患者管理 · 健康数据 · 预约排班 · 随访管理 · 咨询管理 · 内容管理 · 媒体库 · 轮播图管理 · 积分商城 · 透析管理 · 线下活动 · 日常监测 · 告警系统**（原生 Rust 模块，57 实体 / 31 handler / 36 service，已实现）
- [[erp-ai]] — **AI 智能分析 · 化验单解读 · 趋势分析 · 报告摘要**（原生 Rust 模块，9 实体 / 45 文件 / 4 AI Provider，Phase 1 MVP）
### 组装层
- [[erp-server]] — Axum 入口 · AppState · 7+ 模块注册 · 后台任务 · 优雅关闭
@@ -100,8 +107,8 @@
### 基础设施
- [[infrastructure]] — 连接信息 · 环境变量 · 一键启动 (**单一真相源**)
- [[database]] — SeaORM 迁移 · 多租户表结构（128 迁移）
- [[frontend]] — React 19 SPA · 健康管理页面（55 路由 + 工作台组件）
- [[database]] — SeaORM 迁移 · 多租户表结构（137 迁移）
- [[frontend]] — React 19 SPA · 健康管理页面（29 活跃路由 + 6 冻结 + 工作台组件）
- [[testing]] — 验证清单 · 测试分布 · 性能基准
## 核心架构问答
@@ -121,13 +128,15 @@
| 健康模块设计规格 | `docs/superpowers/specs/2026-04-23-health-management-module-design.md` |
| AI 模块设计规格 | `docs/superpowers/specs/2026-04-25-erp-ai-module-design.md` |
| 内容管理设计规格 | `docs/superpowers/specs/2026-04-26-content-management-design.md` |
| 媒体库+轮播图设计规格 | `docs/superpowers/specs/2026-05-10-media-library-banner-design.md` |
| 六维度全面均衡分析 | `docs/superpowers/specs/2026-05-11-system-comprehensive-analysis-design.md`（6.9/10 B，六维度评估） |
| PII 加密扩展规格 | `docs/superpowers/specs/2026-04-26-pii-encryption-expansion-design.md` |
| 实时体征管线探讨 | `docs/superpowers/specs/2026-04-26-realtime-vital-signs-pipeline-design.md` |
| 平台复盘与演进 | `docs/superpowers/specs/2026-04-26-platform-retrospective-and-evolution-design.md` |
| 设计规格（全量） | `docs/superpowers/specs/` (47 份) |
| 设计规格（全量） | `docs/superpowers/specs/` (50 份) |
| UI/UX 重构设计规格 | `docs/superpowers/specs/2026-04-28-ui-ux-overhaul-design.md` |
| UI/UX 重构实施计划 | `docs/superpowers/plans/2026-04-28-ui-ux-overhaul-plan.md` |
| 实施计划（全量） | `docs/superpowers/plans/` (49 份) |
| 实施计划（全量） | `docs/superpowers/plans/` (51 份) |
| 全系统审计报告（V1） | `docs/audits/08-audit-report-2026-04-30.md`（83% 总体完成度，2 CRITICAL + 3 HIGH） |
| 全系统审计报告（V2） | `docs/audits/v2/13-final-report.md`（85% 总体完成度，P0 安全修复已完成） |
| 审计基线快照 | `docs/audits/00-baseline-snapshot.md` |
@@ -138,12 +147,13 @@
| 审计差距模式 | `docs/audits/05-gap-patterns.md`（5 种模式，透析/知情同意 MP 缺失） |
| 审计错误处理 | `docs/audits/06-error-handling.md`（SSE 不挂起 / 日志 30% 覆盖） |
| 审计测试覆盖 | `docs/audits/07-test-coverage.md`（772 测试 / 前端极低 / AI 无集成测试） |
| 讨论记录 | `docs/discussions/` (26 份) |
| 讨论记录 | `docs/discussions/` (29 份) |
| 事件注册表 | `docs/event-registry.md` |
| Wiki 方法论 | `docs/wiki-methodology.md` |
| 项目深度分析 | `docs/superpowers/specs/2026-05-03-project-analysis-brainstorm-design.md`（5 专家组分析，B+ 评分） |
| 三维度系统分析 | `docs/discussions/2026-05-07-three-dimension-analysis.md`（后端/前端/质量三维深度分析，2026-05-07） |
| 多专家组头脑风暴 | `docs/discussions/2026-05-07-expert-brainstorm-session.md`（5 专家组评审，综合 6.4/10 B-，行动清单） |
| 六维度系统分析+头脑风暴 | `docs/superpowers/specs/2026-05-11-system-comprehensive-analysis-design.md`（6 专家组，综合 6.9/10 B，三个月路线图） |
| 角色测试计划（全量） | `docs/qa/role-test-plans/` (R01-R05) |
| 角色测试结果 | `docs/qa/role-test-results/` (R01 100% / R02 100% / R03 90.9% / R04 90.0% / R05 72.7% → 修复后待复测) |
| 系统集成测试结果 | `docs/qa/role-test-results/T00-system-integration-results.md` (20/28 通过) |