feat(health): 添加 erp-health 健康管理模块骨架
新建 erp-health 原生 Rust crate，覆盖设计规格中定义的 5 大业务域： - 16 个 SeaORM Entity（患者/家属/标签/医生/健康档案/体征/化验单/预约/排班/随访/咨询等） - 16 表数据库迁移（含索引、外键、默认值、可回滚） - 40+ API 路由骨架（患者管理/健康数据/预约排班/随访/咨询/医生管理） - 12 个权限声明（health.patient/health-data/appointment/follow-up/consultation/doctor 各 .list/.manage） - DTO / Service / Handler / Event 四层架构，Service 使用 todo!() 占位 - erp-server 集成：模块注册 + AppState FromRef 桥接 + 路由挂载 同步更新 CLAUDE.md 项目进度、wiki 知识库、设计规格文档。
This commit is contained in:
iven
124
wiki/index.md
124
wiki/index.md
@@ -1,95 +1,71 @@
|
||||
# ERP 平台底座 — 知识库
|
||||
# HMS 健康管理平台 — 知识库
|
||||
|
||||
## 项目画像
|
||||
> **Health Management System (HMS)** — 面向体检中心/医疗机构的综合健康管理平台。从 ERP 底座分叉，继承身份权限/工作流/消息/配置等基础能力，`erp-health` 原生模块承载医疗业务。
|
||||
|
||||
**模块化 SaaS ERP 底座**，Rust + React 技术栈，提供身份权限/工作流/消息/配置/插件五大基础模块，支持行业业务模块快速插接。
|
||||
## 关键数字
|
||||
|
||||
关键数字：
|
||||
- 13 个 Rust crate（9 个已实现 + 2 个插件原型 + 2 个业务插件），1 个前端 SPA
|
||||
- 37 个数据库迁移
|
||||
- 6 个业务模块 (auth, config, workflow, message, plugin, server)
|
||||
- 4 个插件 crate (plugin-prototype, plugin-test-sample, plugin-crm, plugin-inventory)
|
||||
- Health Check API (`/api/v1/health`)
|
||||
- OpenAPI JSON (`/api/docs/openapi.json`)
|
||||
- Phase 1-6 全部完成，WASM 插件系统已集成到主服务
|
||||
- Q2-Q4 成熟度路线图已完成（安全地基/架构强化/测试覆盖/插件生态）
|
||||
| 指标 | 值 |
|
||||
|------|-----|
|
||||
| Rust crate | 14 个（7 核心 + erp-health + 6 插件） |
|
||||
| 数据库表 | 30+ 基础表 + 16 健康业务表（规划中） |
|
||||
| 核心模块 | 5 基础 (auth/config/workflow/message/plugin) + 1 业务 (health) |
|
||||
| 健康模块页面 | 13 个（规划中） |
|
||||
| API 文档 | `http://localhost:3000/api/docs/openapi.json` |
|
||||
|
||||
## 模块导航树
|
||||
## 症状导航
|
||||
|
||||
### L1 基础层
|
||||
| 症状 | 先查 | 再查 | 常见根因 |
|
||||
|------|------|------|----------|
|
||||
| API 返回 403 | 权限码检查 | [[wasm-plugin]] 权限系统 | 权限码不匹配 / 缺少 .list 权限 |
|
||||
| API 返回 500 无日志 | [[erp-core]] 错误链 | 后端 tracing 输出 | AppError::Internal 静默 |
|
||||
| 数据库连接失败 | [[infrastructure]] | PostgreSQL 服务状态 | 服务未启动 / 环境变量未设置 |
|
||||
| 前端 401 刷新时 | [[frontend]] auth store | API client token 刷新 | token 过期未主动刷新 |
|
||||
| 迁移执行失败 | [[database]] | PostgreSQL 日志 | 表冲突 / 唯一索引 + 软删除 |
|
||||
| 端口被占用 | [[infrastructure]] dev.ps1 | 端口 5174-5189 进程 | 残留 Vite 进程 |
|
||||
| 预约超额 | [[erp-health]] 排班并发 | appointment CAS 操作 | 并发控制未走原子 CAS |
|
||||
| 跨租户数据泄漏 | [[architecture]] 多租户策略 | [[database]] tenant_id | 查询缺少 tenant_id 过滤 |
|
||||
|
||||
## 模块导航
|
||||
|
||||
### 基础层（继承自 ERP 底座）
|
||||
- [[erp-core]] — 错误体系 · 事件总线 · 模块 trait · 共享类型
|
||||
- [[erp-common]] — ID 生成 · 时间戳 · 编号生成工具
|
||||
- [[architecture]] — 架构决策 · 设计原则 · 技术选型
|
||||
|
||||
### L2 业务层
|
||||
- erp-auth — 用户/角色/权限/组织/部门/岗位管理 · JWT 认证 · RBAC · 行级数据权限
|
||||
### 业务层（继承自 ERP 底座）
|
||||
- erp-auth — 用户/角色/权限/组织/部门/岗位 · JWT · RBAC · 行级数据权限
|
||||
- erp-config — 字典/菜单/设置/编号规则/主题/语言
|
||||
- erp-workflow — BPMN 解析 · Token 驱动执行 · 任务分配 · 流程设计器
|
||||
- erp-message — 消息 CRUD · 模板管理 · 订阅偏好 · 通知面板 · 事件集成
|
||||
- erp-plugin — 插件管理 · WASM 运行时 · 动态表 · 数据 CRUD · 生命周期管理 · 热更新 · 行级数据权限
|
||||
- erp-workflow — BPMN 解析 · Token 驱动 · 任务分配
|
||||
- erp-message — 消息 CRUD · 模板 · 订阅 · 通知面板
|
||||
- erp-plugin — WASM 运行时 · 动态表 · 热更新（HMS 保留但非主要扩展方式）
|
||||
|
||||
### L3 组装层
|
||||
- [[erp-server]] — Axum 服务入口 · AppState · ModuleRegistry 集成 · 配置加载 · 数据库连接 · 优雅关闭
|
||||
### 核心业务层（HMS 专属）
|
||||
- [[erp-health]] — **患者管理 · 健康数据 · 预约排班 · 随访管理 · 咨询管理**（原生 Rust 模块）
|
||||
|
||||
### 插件系统
|
||||
- [[wasm-plugin]] — Wasmtime 运行时 · WIT 接口契约 · Host API · Fuel 资源限制 · 插件制作完整流程
|
||||
- erp-plugin-crm — CRM 客户管理插件 (5 实体/9 权限/6 页面)
|
||||
- erp-plugin-inventory — 进销存管理插件 (6 实体/12 权限/6 页面)
|
||||
### 组装层
|
||||
- [[erp-server]] — Axum 入口 · AppState · 模块注册 · 后台任务 · 优雅关闭
|
||||
|
||||
### 基础设施
|
||||
- [[database]] — SeaORM 迁移 · 多租户表结构 · 软删除模式
|
||||
- [[infrastructure]] — Windows 开发环境 · PostgreSQL 16 · Redis 7 · 一键启动脚本
|
||||
- [[frontend]] — React SPA · Ant Design 布局 · Zustand 状态
|
||||
- [[testing]] — 测试环境指南 · 验证清单 · 常见问题
|
||||
- [[infrastructure]] — 连接信息 · 环境变量 · 一键启动 (**单一真相源**)
|
||||
- [[database]] — SeaORM 迁移 · 多租户表结构
|
||||
- [[frontend]] — React 19 SPA · 健康管理页面
|
||||
- [[testing]] — 验证清单 · 测试分布 · 性能基准
|
||||
|
||||
### 横切关注点
|
||||
- [[architecture]] — 架构决策记录 · 设计原则 · 技术选型理由
|
||||
## 核心架构问答
|
||||
|
||||
## 核心架构决策
|
||||
**为什么 erp-health 用原生模块而非 WASM 插件？** 医疗业务需要 16+ 强类型实体、自定义 API（趋势分析/统计报表）、文件上传（化验单/体检报告）、未来 AI 集成，超出 WASM 插件能力范围。详见 [[erp-health]]。
|
||||
|
||||
**模块间如何通信？** 通过 [[erp-core]] 的 EventBus 发布/订阅 DomainEvent，不直接依赖。
|
||||
**模块间如何通信？** [[erp-core]] EventBus 发布/订阅 DomainEvent。erp-health 发布 `patient.created`、`appointment.confirmed` 等事件，订阅 `workflow.task.completed` 等。详见 [[architecture]]。
|
||||
|
||||
**多租户怎么隔离？** 共享数据库 + tenant_id 列过滤，中间件从 JWT 注入 TenantContext。详见 [[database]] 和 [[architecture]]。
|
||||
**多租户怎么隔离？** 共享数据库 + `tenant_id` 列过滤，中间件从 JWT 注入。详见 [[database]] [[architecture]]。
|
||||
|
||||
**错误怎么传播？** 业务 crate 用 thiserror → AppError → Axum IntoResponse 自动转 HTTP。详见 [[erp-core]] 错误处理链。
|
||||
**患者/医护与 erp-auth 的关系？** 账号走 `users` 表，erp-health 通过 `user_id` 外键关联扩展字段（科室、职称、档案等）。患者可先建档后绑定账号。
|
||||
|
||||
**状态如何共享？** AppState 包含 DB、Config、EventBus、ModuleRegistry，通过 Axum State 提取器注入所有 handler。
|
||||
## 文档索引
|
||||
|
||||
**ModuleRegistry 怎么工作？** 每个 Phase 2+ 的业务模块实现 ErpModule trait，在 main.rs 中链式注册。registry 自动构建路由和事件处理器。
|
||||
|
||||
**插件系统怎么扩展业务？** 通过 [[wasm-plugin]] 的 WASM 沙箱运行第三方插件，插件通过 WIT 定义的 Host API 与系统交互。详细流程见插件制作指南。
|
||||
|
||||
**版本差异怎么办？** package.json 使用 React 19 + Ant Design 6（比规格文档更新），以实际代码为准。
|
||||
|
||||
**行级数据权限怎么控制？** role_permissions 表增加 data_scope 字段（all/self/department/department_tree），JWT 中间件注入 department_ids，插件数据查询自动拼接 scope 条件。
|
||||
|
||||
**插件怎么热更新？** 通过 `/api/v1/admin/plugins/{id}/upgrade` 上传新版本 WASM + manifest，系统对比 schema 变更执行增量 DDL，卸载旧 WASM 加载新 WASM，失败时保持旧版本继续运行。
|
||||
|
||||
## 开发进度
|
||||
|
||||
| Phase | 内容 | 状态 |
|
||||
|-------|------|------|
|
||||
| 1 | 基础设施 | 完成 |
|
||||
| 2 | 身份与权限 | 完成 |
|
||||
| 3 | 系统配置 | 完成 |
|
||||
| 4 | 工作流引擎 | 完成 |
|
||||
| 5 | 消息中心 | 完成 |
|
||||
| 6 | 整合与打磨 | 完成 |
|
||||
| - | WASM 插件原型 | V1-V6 验证通过 |
|
||||
| - | 插件系统集成 | 已集成到主服务 |
|
||||
| - | CRM 插件 | 完成 |
|
||||
| - | Q2 安全地基 + CI/CD | 完成 |
|
||||
| - | Q3 架构强化 + 前端体验 | 完成 |
|
||||
| - | Q4 测试覆盖 + 插件生态 | 完成 |
|
||||
|
||||
## 关键文档索引
|
||||
|
||||
| 文档 | 位置 |
|
||||
| 类型 | 位置 |
|
||||
|------|------|
|
||||
| 设计规格 | `docs/superpowers/specs/2026-04-10-erp-platform-base-design.md` |
|
||||
| 实施计划 | `docs/superpowers/plans/2026-04-10-erp-platform-base-plan.md` |
|
||||
| WASM 插件设计 | `docs/superpowers/specs/2026-04-13-wasm-plugin-system-design.md` |
|
||||
| WASM 插件计划 | `docs/superpowers/plans/2026-04-13-wasm-plugin-system-plan.md` |
|
||||
| CRM 插件设计 | `docs/superpowers/specs/2026-04-16-crm-plugin-design.md` |
|
||||
| CRM 插件计划 | `docs/superpowers/plans/2026-04-16-crm-plugin-plan.md` |
|
||||
| 健康模块设计规格 | `docs/superpowers/specs/2026-04-23-health-management-module-design.md` |
|
||||
| 设计规格 | `docs/superpowers/specs/` |
|
||||
| 实施计划 | `docs/superpowers/plans/` |
|
||||
| 协作规则 | `CLAUDE.md` |
|
||||
| 设计评审 | `plans/squishy-pondering-aho-agent-a23c7497aadc6da41.md` |
|
||||
| 插件制作指南 | `.claude/skills/plugin-development/SKILL.md` |
|
||||
|
||||
Reference in New Issue
Block a user