docs(wiki): 全景梳理 — 更新 9 个 wiki + CLAUDE.md scope + 头脑风暴记录
基于 3 个并行探索代理的全面扫描结果,更新 wiki 数据至实际状态: - index.md: 18 crate / 76 迁移 / 44 实体 / 77k 行 / 409 提交 - erp-health.md: 44 实体 / 21 handler / 22 权限 / 25 事件 / 6 消费者 - erp-server.md: 9 后台任务 / RLS 中间件栈 - architecture.md: 新增 erp-ai/dialysis 到依赖图 / 测试覆盖表 - testing.md: 225 单元 + 159 集成 / 4 模块零测试警告 - database.md: 76 迁移 / RLS+哈希链+盲索引+Dead Letter - erp-core.md: PiiCrypto 加密体系 / EventBus 完整描述 - frontend.md: 163 文件 / 5 store / 10 API 文件 - CLAUDE.md: 新增 health/ai/dialysis/assessment scope 头脑风暴 4 个议题决策: - dialysis: 接入激活 - 测试: 按风险排序(workflow > ai > message > config) - AI: 数据桥接优先 - 路线图: AI 驱动 3 个月 5 Phase
This commit is contained in:
@@ -12,8 +12,8 @@ tags: [frontend, react, antd, vite, spa]
|
||||
## 1. 设计决策
|
||||
|
||||
- **组件库优先** — Ant Design 6,不自造轮子
|
||||
- **状态集中** — Zustand 管理全局状态(4 个 store)
|
||||
- **API 层分离** — HTTP 调用封装到 `src/api/`(28 个文件),组件不直接 fetch
|
||||
- **状态集中** — Zustand 管理全局状态(5 个 store)
|
||||
- **API 层分离** — HTTP 调用封装到 `src/api/`(含 health/ 和 ai/ 子目录),组件不直接 fetch
|
||||
- **代理开发** — Vite 代理 `/api` 到后端 3000 端口
|
||||
- **HashRouter** — 不需要服务端 fallback 配置,部署更稳健
|
||||
- **懒加载** — 除 Login 外所有页面使用 `lazy()` 按需加载
|
||||
@@ -186,16 +186,17 @@ React 19.2.4 / Ant Design 6.3.5 / React Router 7.14.0 / Zustand 5.0.12 / Vite 8.
|
||||
|
||||
## 4. 代码逻辑
|
||||
|
||||
### 状态管理(4 个 Zustand Store)
|
||||
### 状态管理(5 个 Zustand Store)
|
||||
|
||||
| Store | 状态 |
|
||||
|-------|------|
|
||||
| `app.ts` | theme(blue/warm/dark/emerald), sidebarCollapsed, localStorage 持久化 |
|
||||
| `auth.ts` | user, isAuthenticated, localStorage 持久化 |
|
||||
| `message.ts` | unreadCount, recentMessages, 请求去重 |
|
||||
| `health.ts` | 患者/医生姓名缓存与批量解析 |
|
||||
| `message.ts` | unreadCount, recentMessages, SSE 实时推送连接, 请求去重 |
|
||||
| `plugin.ts` | plugins 列表, 动态菜单, schema 缓存, 请求去重 |
|
||||
|
||||
### 健康模块 API 文件(7 个)
|
||||
### 健康模块 API 文件(10 个)
|
||||
|
||||
| 文件 | 覆盖端点 |
|
||||
|------|---------|
|
||||
@@ -206,14 +207,19 @@ React 19.2.4 / Ant Design 6.3.5 / React Router 7.14.0 / Zustand 5.0.12 / Vite 8.
|
||||
| `followUp.ts` | 随访任务 + 记录 |
|
||||
| `consultations.ts` | 咨询会话 + 消息 + 导出 |
|
||||
| `articles.ts` | 健康文章 |
|
||||
| `points.ts` | 积分系统 |
|
||||
| `deviceReadings.ts` | 设备数据采集 |
|
||||
| `alerts.ts` | 健康预警 |
|
||||
|
||||
### 前端单元测试(3 个)
|
||||
### 前端单元测试(5 个)
|
||||
|
||||
| 文件 | 测试内容 |
|
||||
|------|---------|
|
||||
| `constants/health.test.ts` | 健康常量定义验证 |
|
||||
| `hooks/useThemeMode.test.ts` | 暗色模式 hook |
|
||||
| `hooks/useDebouncedValue.test.ts` | 防抖 hook |
|
||||
| `pages/health/components/StatusTag.test.tsx` | 状态标签渲染 |
|
||||
| `utils/exprEvaluator.test.ts` | 表达式求值 |
|
||||
|
||||
### 插件页面系统
|
||||
|
||||
|
||||
Reference in New Issue
Block a user