docs: 全局文档梳理归档 — 删除过期文件 + 归档 V1/早期设计 + wiki 数据校正 + CLAUDE.md 规则优化

**根目录清理:**
- 删除 CLAUDE-1.md(ZCLAW 旧项目配置,HMS 已完全脱离)
- 移动 DESIGN.md → docs/archive/(ERP 旧设计系统)
- 删除 plans/ 98 个临时会话计划文件

**归档重组:**
- V1 审计(12 文件)→ docs/archive/audits-v1/
- 早期 CRM/插件迭代设计(13 文件)→ docs/archive/superpowers-early/
- 已完成/已取代设计(28 文件)→ docs/archive/superpowers-completed/
- 早期讨论/测试报告 → docs/archive/discussions-early/ + test-reports-early/
- QA 重复文件清理(3 个旧版 result 文件)

**wiki 数据校正:**
- 迁移数 137→145,源文件 599→649,提交数 720→800+
- 小程序文件 124→163,Web 前端 297→332
- 后端测试 999→943(实际统计),权限码 75+→128
- 文档索引新增归档目录说明

**CLAUDE.md 规则优化:**
- §2.5 闭环工作法:提交+文档+推送三合一 + wiki 更新触发条件
- §2.6 Feature DoD:新增文档一致性检查项
- §6 反模式:新增 wiki 更新滞后/推送不及时警告
This commit is contained in:
iven
2026-05-15 09:29:04 +08:00
parent dc983945ff
commit 18fa6ce6d4
92 changed files with 53 additions and 10253 deletions

View File

@@ -24,7 +24,7 @@ tags: [database, seaorm, migration, multi-tenant]
| 文件 | 职责 |
|------|------|
| `crates/erp-server/migration/src/lib.rs` | Migrator 注册所有迁移 |
| `crates/erp-server/migration/src/m*.rs` | 103 个迁移文件 |
| `crates/erp-server/migration/src/m*.rs` | 145 个迁移文件 |
| `crates/erp-core/src/types.rs` | BaseFields 标准字段定义 |
### 迁移命名规则

View File

@@ -4,30 +4,30 @@
## 关键数字
> 最后更新: 2026-05-13 | 数据截止: feat/media-library-banner 分支
> 最后更新: 2026-05-15 | 数据截止: feat/media-library-banner 分支
| 指标 | 值 |
|------|-----|
| Rust crate | 17 个erp-core + 5 基础业务 + erp-health + erp-ai + erp-dialysis + erp-plugin + 7 插件/原型) |
| Rust 源文件 | 599 个 |
| Rust 源文件 | **649 个** |
| 数据库表 | 30 基础表 + 49 健康业务表 + 9 AI 表 + 3 媒体库/轮播图表 |
| 数据库迁移 | 137 个(最新 m20260510_000137 |
| 数据库迁移 | **145 个**(最新 m20260513_000145 |
| 后端路由 | 260+ 个11 公开 + 14 FHIR + 2 网关 + ~240 受保护) |
| 核心模块 | 5 基础 (auth/config/workflow/message/plugin) + 3 业务 (health + ai + dialysis) |
| erp-health 实体 | **57 个** Entity31 handler / 36 service / 21 DTO189 文件) |
| erp-ai 实体 | 9 个 Entity45 文件4 AI Provider |
| Web 前端 | 297 个 TS/TSX 文件29 活跃路由 + 6 冻结路由52 API 模块) |
| 微信小程序 | Taro 4.2 + React 18124 个 TS/TSX 文件 / 66 页面 / 4 TabBar + 医生端分包 |
| 前端单元测试 | 62 个测试文件472 Web 断言 + 39 MP 断言)+ 13 E2E spec124 断言) |
| 后端测试 | **999 个函数**815 同步 + 184 异步78 个文件含内联测试 |
| Web 前端 | 332 个 TS/TSX 文件29 活跃路由 + 6 冻结路由52 API 模块) |
| 微信小程序 | Taro 4.2 + React 18163 个 TS/TSX 文件 / 66 页面 / 4 TabBar + 医生端分包 |
| 前端单元测试 | 88 个测试文件472 Web 断言 + 39 MP 断言)+ 13 E2E spec124 断言) |
| 后端测试 | **943 个函数**762 同步 + 181 异步79 个文件含内联测试 |
| 事件系统 | 31 事件类型health 模块内)/ 23 幂等消费者 / Outbox + LISTEN/NOTIFY |
| 权限码 | **75+**health 28 + auth 25 + ai 7 + workflow 8 + dialysis 5 + plugin 2 |
| 权限码 | **128**health 28 + auth 25 + ai 7 + workflow 8 + dialysis 5 + plugin 2 + Copilot + 媒体库 |
| 生产 unwrap | **24 处**(从 514 降至 24全为安全解包 |
| utoipa 注解 | 322 个 / 21/64 handler 文件 = 33% 覆盖 |
| utoipa 注解 | 88 个文件含注解 |
| Clippy | **全 workspace 0 警告**2026-05-07 清零) |
| 依赖版本 | 全部最新主版本线Rust edition 2024 |
| API 文档 | `http://localhost:3000/api/docs/openapi.json` |
| Git 提交 | 720+ 次 |
| Git 提交 | **800+ 次** |
| 系统分析评分 | **6.9/10 (B)**六维度全面均衡分析2026-05-11 |
| 审计状态 | V1: 83% → V2: 85%P0 安全修复已完成V2 CRITICAL 全清零 |
| 角色测试 | R01-R05 全角色验证完成86.5% 通过率5 个 BUG 已修复;小程序 MP 多角色 96.2% 通过率 |
@@ -120,7 +120,7 @@
### 基础设施
- [[infrastructure]] — 连接信息 · 环境变量 · 一键启动 (**单一真相源**)
- [[database]] — SeaORM 迁移 · 多租户表结构137 迁移)
- [[database]] — SeaORM 迁移 · 多租户表结构145 迁移)
- [[frontend]] — React 19 SPA · 健康管理页面29 活跃路由 + 6 冻结 + 工作台组件)
- [[testing]] — 验证清单 · 测试分布 · 性能基准
@@ -138,38 +138,27 @@
| 类型 | 位置 |
|------|------|
| 健康模块设计规格 | `docs/superpowers/specs/2026-04-23-health-management-module-design.md` |
| 健康模块设计规格 | `docs/superpowers/specs/2026-04-23-health-management-module-design.md`(已归档到 `archive/superpowers-completed/` |
| 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` |
| Copilot 基因化设计 | `docs/superpowers/specs/2026-05-11-copilot-gene-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/` (50 份) |
| 设计规格(活跃) | `docs/superpowers/specs/` (32 份) |
| 实施计划(活跃) | `docs/superpowers/plans/` (30 份) |
| 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/` (51 份) |
| 全系统审计报告V1 | `docs/audits/08-audit-report-2026-04-30.md`83% 总体完成度2 CRITICAL + 3 HIGH |
| 全系统审计报告V1 | `docs/archive/audits-v1/08-audit-report-2026-04-30.md`(已归档) |
| 全系统审计报告V2 | `docs/audits/v2/13-final-report.md`85% 总体完成度P0 安全修复已完成) |
| 审计基线快照 | `docs/audits/00-baseline-snapshot.md` |
| 审计功能清单 | `docs/audits/01-feature-inventory.md`328 路由三端映射矩阵) |
| 审计后端完整性 | `docs/audits/02-backend-integrity.md`100% 调用链连通) |
| 审计事件系统 | `docs/audits/03-event-system.md`25 事件 / 14 消费者 / 100% payload 一致) |
| 审计参数配置 | `docs/audits/04-parameter-config.md`105 DTO / 50 权限码 / 数据映射缺口) |
| 审计差距模式 | `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/` (29 份) |
| 讨论记录 | `docs/discussions/` (41 份) |
| 事件注册表 | `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 通过) |
| 小程序 E2E 测试结果 | `docs/qa/role-test-results/T10-miniprogram-e2e-results.md` (需手动执行) |
| 协作规则 | `CLAUDE.md` |
| 插件制作指南 | `.claude/skills/plugin-development/SKILL.md` |
| **归档** | |
| 早期 CRM/插件设计 | `docs/archive/superpowers-early/` (13 份4月13-20日早期迭代) |
| 已完成设计/计划 | `docs/archive/superpowers-completed/` (28 份,已实施完成) |
| V1 审计报告 | `docs/archive/audits-v1/` (13 份,已被 V2 取代) |
| 早期讨论/测试报告 | `docs/archive/discussions-early/` + `docs/archive/test-reports-early/` |