Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(admin): Add user management and upgrade to module permission system

Browse Source 
Features - User Management (Phase 4.1):
- Database: Add user_modules table for fine-grained module permissions
- Database: Add 4 user permissions (view/create/edit/delete) to role_permissions
- Backend: UserService (780 lines) - CRUD with tenant isolation
- Backend: UserController + UserRoutes (648 lines) - 13 API endpoints
- Backend: Batch import users from Excel
- Frontend: UserListPage (412 lines) - list/filter/search/pagination
- Frontend: UserFormPage (341 lines) - create/edit with module config
- Frontend: UserDetailPage (393 lines) - details/tenant/module management
- Frontend: 3 modal components (592 lines) - import/assign/configure
- API: GET/POST/PUT/DELETE /api/admin/users/* endpoints

Architecture Upgrade - Module Permission System:
- Backend: Add getUserModules() method in auth.service
- Backend: Login API returns modules array in user object
- Frontend: AuthContext adds hasModule() method
- Frontend: Navigation filters modules based on user.modules
- Frontend: RouteGuard checks requiredModule instead of requiredVersion
- Frontend: Remove deprecated version-based permission system
- UX: Only show accessible modules in navigation (clean UI)
- UX: Smart redirect after login (avoid 403 for regular users)

Fixes:
- Fix UTF-8 encoding corruption in ~100 docs files
- Fix pageSize type conversion in userService (String to Number)
- Fix authUser undefined error in TopNavigation
- Fix login redirect logic with role-based access check
- Update Git commit guidelines v1.2 with UTF-8 safety rules

Database Changes:
- CREATE TABLE user_modules (user_id, tenant_id, module_code, is_enabled)
- ADD UNIQUE CONSTRAINT (user_id, tenant_id, module_code)
- INSERT 4 permissions + role assignments
- UPDATE PUBLIC tenant with 8 module subscriptions

Technical:
- Backend: 5 new files (~2400 lines)
- Frontend: 10 new files (~2500 lines)
- Docs: 1 development record + 2 status updates + 1 guideline update
- Total: ~4900 lines of code

Status: User management 100% complete, module permission system operational
This commit is contained in:
HaHafeng
2026-01-16 13:42:10 +08:00
parent 98d862dbd4
commit 66255368b7
560 changed files with 70424 additions and 52353 deletions
Download Patch File Download Diff File Expand all files Collapse all files

228
docs/08-项目管理/03-每周计划/2025-11-14-任务19完成总结.md
View File

@@ -1,28 +1,28 @@
# 2025-11-14 任务19完成总结
> **浠诲姟锛?* 鍚庣<E98D9A>浠ｇ爜鍒嗗眰锛圔ackend Code Layering锛?
> **鏃堕棿锛?* 2025-11-14
> **鐘舵€侊細** 鉁?瀹屾垚
> **绛栫暐锛?* 澧為噺婕旇繘锛屾柊鏃у苟瀛?
> **任务：** 后端代码分层（Backend Code Layering）
> **时间：** 2025-11-14
> **状态：** ✅ 完成
> **策略：** 增量演进，新旧并存
---
## 🎯 任务目标
鍩轰簬銆婂墠鍚庣<EFBFBD>妯″潡鍖栨灦鏋勮<EFBFBD>璁?V2.md銆嬪拰銆婂悗绔<E68297>灦鏋勫<E98F8B>閲忔紨杩涙柟妗?md銆嬶紝瀵瑰悗绔<E68297>唬鐮佽繘琛屽垎灞傛敼閫狅紝涓烘湭鏉ユā鍧楃嫭绔嬮儴缃叉墦涓嬪熀纭€銆?
基于《前后端模块化架构设计-V2.md》和《后端架构增量演进方案.md》，对后端代码进行分层改造，为未来模块独立部署打下基础。
---
## 鉁?瀹屾垚鍐呭<E98D90>
## ✅ 完成内容
### 1. **架构策略制定**
- 鉁?閲囩敤"缁炴潃鑰呮ā寮?锛圫trangler Fig Pattern锛?
- 鉁?鏂版棫浠ｇ爜骞跺瓨锛岄浂椋庨櫓鏀归€?
- 鉁?鐜版湁妯″潡淇濇寔涓嶅彉锛屾柊妯″潡鎸夋爣鍑嗗紑鍙?
- ✅ 采用"绞杀者模式"（Strangler Fig Pattern）
- ✅ 新旧代码并存，零风险改造
- ✅ 现有模块保持不变，新模块按标准开发
### 2. **目录结构重组**
#### **閲嶇粍鍓?*锛堝钩閾虹粨鏋勶級锛?
#### **重组前**（平铺结构）：
```
backend/src/
├── routes/
@@ -35,140 +35,140 @@ backend/src/
└── config/
```
#### **閲嶇粍鍚?*锛堜笁灞傛灦鏋勶級锛?
#### **重组后**（三层架构）：
```
backend/src/
├── legacy/ # 🔸 现有业务代码（保持不变）
鈹? 鈹溾攢鈹€ routes/
鈹? 鈹溾攢鈹€ controllers/
鈹? 鈹溾攢鈹€ services/
鈹? 鈹斺攢鈹€ templates/
鈹?
鈹溾攢鈹€ common/ # 馃敡 閫氱敤鑳藉姏灞?
鈹? 鈹溾攢鈹€ llm/adapters/ # LLM閫傞厤鍣<EFBFBD>紙DeepSeek, Qwen锛?
鈹? 鈹溾攢鈹€ rag/ # RAG鑳藉姏锛圖ify锛?
鈹? 鈹溾攢鈹€ document/ # 鏂囨。澶勭悊
鈹? 鈹溾攢鈹€ utils/ # 宸ュ叿鍑芥暟
鈹? 鈹斺攢鈹€ middleware/ # 涓<EFBFBD>棿浠?
鈹?
鈹溾攢鈹€ modules/ # 馃専 鏂版灦鏋勬ā鍧?
鈹? 鈹斺攢鈹€ asl/ # ASL妯″潡鍗犱綅锛堟爣鍑嗗寲锛?
鈹?
鈹斺攢鈹€ config/ # 鈿欙笍 閰嶇疆灞?
│ ├── routes/
│ ├── controllers/
│ ├── services/
│ └── templates/
│
├── common/ # 🔧 通用能力层
│ ├── llm/adapters/ # LLM适配器（DeepSeek, Qwen）
│ ├── rag/ # RAG能力（Dify）
│ ├── document/ # 文档处理
│ ├── utils/ # 工具函数
│ └── middleware/ # 中间件
│
├── modules/ # 🌟 新架构模块
│ └── asl/ # ASL模块占位（标准化）
│
└── config/ # ⚙️ 配置层
```
### 3. **代码迁移**
#### **鏂囦欢杩佺Щ娓呭崟**锛?
- 鉁?7涓<37>矾鐢辨枃浠?鈫?`legacy/routes/`
- 鉁?8涓<38>帶鍒跺櫒鏂囦欢 鈫?`legacy/controllers/`
- 鉁?8涓<38>湇鍔℃枃浠?鈫?`legacy/services/`
- 鉁?1涓<31>ā鏉挎枃浠?鈫?`legacy/templates/`
- 鉁?4涓狶LM閫傞厤鍣?鈫?`common/llm/adapters/`
- 鉁?2涓猂AG瀹㈡埛绔?鈫?`common/rag/`
- 鉁?1涓<31>枃妗ｅ<E5A697>鐞嗗<E9909E>鎴风<E98EB4> 鈫?`common/document/`
- 鉁?1涓<31>伐鍏锋枃浠?鈫?`common/utils/`
- 鉁?1涓<31>腑闂翠欢鏂囦欢 鈫?`common/middleware/`
#### **文件迁移清单**：
- ✅ 7个路由文件 → `legacy/routes/`
- ✅ 8个控制器文件 → `legacy/controllers/`
- ✅ 8个服务文件 → `legacy/services/`
- ✅ 1个模板文件 → `legacy/templates/`
- ✅ 4个LLM适配器 → `common/llm/adapters/`
- ✅ 2个RAG客户端 → `common/rag/`
- ✅ 1个文档处理客户端 → `common/document/`
- ✅ 1个工具文件 → `common/utils/`
- ✅ 1个中间件文件 → `common/middleware/`
**鎬昏<EFBFBD>锛?3涓<33>枃浠讹紝闆堕<E99786>闄╄縼绉?*
**总计：33个文件，零风险迁移**
### 4. **导入路径更新**
#### **鏇存柊绫诲瀷**锛?
- 鉁?`index.ts`锛?澶勮矾鐢卞<E990A2>鍏ヨ矾寰?
- 鉁?Legacy灞傚唴閮<EFBFBD>細15澶勫<EFBFBD>鍏ヨ矾寰勬洿鏂?
- `config` 鐩稿<EFBFBD>璺<EFBFBD>緞锛歚../config/` 鈫?`../../config/`
- `adapters` 鐩稿<EFBFBD>璺<EFBFBD>緞锛歚../adapters/` 鈫?`../../common/llm/adapters/`
- `clients` 鐩稿<EFBFBD>璺<EFBFBD>緞锛歚../clients/xxx` 鈫?`../../common/rag|document/xxx`
- `utils` 鐩稿<EFBFBD>璺<EFBFBD>緞锛歚../utils/` 鈫?`../../common/utils/`
- `middleware` 鐩稿<EFBFBD>璺<EFBFBD>緞锛歚../middleware/` 鈫?`../../common/middleware/`
- 鉁?Common灞傚唴閮<EFBFBD>細3澶勫<EFBFBD>鍏ヨ矾寰勬洿鏂?
- `config` 鐩稿<EFBFBD>璺<EFBFBD>緞锛歚../config/` 鈫?`../../config/` 鎴?`../../../config/`
- 鉁?`__dirname` 璺<EFBFBD>緞锛?澶勬洿鏂?
- `agentService.ts`: 2澶勶紙config/agents.yaml, prompts/锛?
- `reviewService.ts`: 2澶勶紙prompts/review_*.txt锛?
#### **更新类型**：
- ✅ `index.ts`：7处路由导入路径
- ✅ Legacy层内部：15处导入路径更新
- `config` 相对路径：`../config/` → `../../config/`
- `adapters` 相对路径：`../adapters/` → `../../common/llm/adapters/`
- `clients` 相对路径：`../clients/xxx` → `../../common/rag|document/xxx`
- `utils` 相对路径：`../utils/` → `../../common/utils/`
- `middleware` 相对路径：`../middleware/` → `../../common/middleware/`
- ✅ Common层内部：3处导入路径更新
- `config` 相对路径：`../config/` → `../../config/` 或 `../../../config/`
- ✅ `__dirname` 路径：4处更新
- `agentService.ts`: 2处（config/agents.yaml, prompts/）
- `reviewService.ts`: 2处（prompts/review_*.txt）
**鎬昏<EFBFBD>锛?9澶勮矾寰勬洿鏂帮紝閫愪釜鎵嬪姩淇<E5A7A9>敼锛屾棤涔辩爜**
**总计：29处路径更新，逐个手动修改，无乱码**
### 5. **关键问题解决**
#### **闂<EFBFBD><EFBFBD>1锛氫腑鏂囦贡鐮侀<EFBFBD>闄?*
- **棰勯槻鎺<EFBFBD>柦**锛氶€愪釜鏂囦欢鎵嬪姩淇<E5A7A9>敼锛屾嫆缁濇壒閲忚剼鏈?
- **缁撴灉**锛氣渽 闆朵贡鐮侊紝鎵€鏈変腑鏂囨敞閲婂畬濂?
#### **问题1：中文乱码风险**
- **预防措施**：逐个文件手动修改，拒绝批量脚本
- **结果**：✅ 零乱码，所有中文注释完好
#### **问题2：批处理功能500错误**
- **閿欒<EFBFBD>**锛歚rawOutput` 瀛楁<E7809B>涓嶅瓨鍦?
- **错误**：`rawOutput` 字段不存在
- **根因**：Prisma Schema 缺少 `@map("raw_output")`
- **解决**：添加映射，重新生成 Prisma Client
- **缁撴灉**锛氣渽 鎵瑰<E98EB5>鐞嗗姛鑳芥<E991B3>甯歌繍琛?
- **结果**：✅ 批处理功能正常运行
#### **闂<EFBFBD><EFBFBD>3锛氶厤缃<EFBFBD>枃浠惰矾寰?*
#### **问题3：配置文件路径**
- **问题**：`agents.yaml`, `prompts/` 路径错误
- **瑙ｅ喅**锛氫慨姝?`__dirname` 鐩稿<EFBFBD>璺<EFBFBD>緞璁＄畻
- **解决**：修正 `__dirname` 相对路径计算
- **结果**：✅ 配置文件正确加载
---
## 🧪 测试验证
### **鍔熻兘娴嬭瘯**锛團rontend + Backend锛?
1. 鉁?**鏅鸿兘闂<E58598>瓟 - 瀵硅瘽妯″紡**锛氭<E9949B>甯歌繍琛?
2. 鉁?**鏅鸿兘闂<E58598>瓟 - 鐭ヨ瘑搴撴ā寮?*锛氭<E9949B>甯歌繍琛?
3. 鉁?**鏅鸿兘闂<E58598>瓟 - 鎵瑰<E98EB5>鐞嗘ā寮?*锛氣渽 淇<><E6B787>鍚庢<E98D9A>甯?
4. 鉁?**鐭ヨ瘑搴撶<E690B4>鐞?*锛氭<E9949B>甯歌繍琛?
5. 鉁?**鏂囨。涓婁紶**锛氭<E9949B>甯歌繍琛?
6. 鉁?**椤圭洰绠＄悊**锛氭<E9949B>甯歌繍琛?
### **功能测试**（Frontend + Backend）
1. ✅ **智能问答 - 对话模式**：正常运行
2. ✅ **智能问答 - 知识库模式**：正常运行
3. ✅ **智能问答 - 批处理模式**：✅ 修复后正常
4. ✅ **知识库管理**：正常运行
5. ✅ **文档上传**：正常运行
6. ✅ **项目管理**：正常运行
### **服务启动测试**
```bash
# 后端服务
鉁?npm run dev - 姝ｅ父鍚<EFBFBD>姩
鉁?http://localhost:3001/health - 鍋ュ悍妫€鏌ラ€氳繃
✅ npm run dev - 正常启动
✅ http://localhost:3001/health - 健康检查通过
# 前端服务
鉁?npm run dev - 姝ｅ父鍚<EFBFBD>姩
鉁?http://localhost:3000 - 鍓嶇<EFBFBD>椤甸潰姝ｅ父
✅ npm run dev - 正常启动
✅ http://localhost:3000 - 前端页面正常
```
---
## 📊 架构对比
| 缁村害 | 閲嶇粍鍓?| 閲嶇粍鍚?|
| 维度 | 重组前 | 重组后 |
|------|--------|--------|
| **浠ｇ爜缁勭粐** | 骞抽摵锛屾棤灞傛<EFBFBD> | 涓夊眰鏋舵瀯锛屾竻鏅版槑纭?|
| **代码组织** | 平铺，无层次 | 三层架构，清晰明确 |
| **职责划分** | 混杂 | Legacy/Common/Modules 分离 |
| **鏂版ā鍧楀紑鍙?* | 鏃犳爣鍑?| 鏍囧噯鍖栫洰褰曠粨鏋?|
| **鐙<EFBFBD>珛閮ㄧ讲** | 涓嶆敮鎸?| 鏀<>寔锛坢odules/asl/锛?|
| **新模块开发** | 无标准 | 标准化目录结构 |
| **独立部署** | 不支持 | 支持（modules/asl/） |
| **代码复用** | 困难 | 通用能力层统一管理 |
| **鏋舵瀯婕旇繘** | 涓€娆℃€ч噸鍐欓<EFBFBD>闄╅珮 | 澧為噺婕旇繘锛岄<E9949B>闄╁彲鎺?|
| **架构演进** | 一次性重写风险高 | 增量演进，风险可控 |
---
## 馃幆 鏍稿績浠峰€?
## 🎯 核心价值
### 1. **闆堕<EFBFBD>闄╂敼閫?* 猸愨瓙猸?
### 1. **零风险改造** ⭐⭐⭐
- 现有功能100%运行
- 鏃犻渶澶ц<EFBFBD>妯￠噸鏋?
- 闅忔椂鍙<EFBFBD>洖婊?
- 无需大规模重构
- 随时可回滚
### 2. **娓呮櫚鐨勬灦鏋勮竟鐣?*
### 2. **清晰的架构边界**
```
legacy/ 鈫?鏃т唬鐮侊紝鏄庣‘鏍囪瘑锛屼笉涓诲姩鏀?
common/ 鈫?閫氱敤鑳藉姏锛屽悇妯″潡鍏变韩
modules/ 鈫?鏂版ā鍧楋紝鏍囧噯鍖栧紑鍙?
legacy/ ← 旧代码，明确标识，不主动改
common/ ← 通用能力，各模块共享
modules/ ← 新模块，标准化开发
```
### 3. **ASL妯″潡寮€鍙戝氨缁?*
- `modules/asl/` 鐩<EFBFBD>綍宸插垱寤?
- 鍙<EFBFBD>洿鎺ユ寜鏍囧噯鏋舵瀯寮€鍙?
- 涓嶅彈鏃т唬鐮佺害鏉?
### 3. **ASL模块开发就绪**
- `modules/asl/` 目录已创建
- 可直接按标准架构开发
- 不受旧代码约束
### 4. **平滑演进路径**
```
鐜板湪锛? 7涓<37>棫妯″潡锛坙egacy锛?+ 0涓<EFBFBD>柊妯″潡
鏈<EFBFBD>潵锛? 7涓<37>棫妯″潡 + 1涓<31>柊妯″潡锛圓SL锛?
鏇磋繙锛? 7涓<37>棫妯″潡 + N涓<4E>柊妯″潡
现在： 7个旧模块（legacy） + 0个新模块
未来： 7个旧模块 + 1个新模块（ASL）
更远： 7个旧模块 + N个新模块
最终： 按需逐步迁移旧模块（可选）
```
@@ -176,56 +176,56 @@ modules/
## 📝 经验总结
### 鉁?**鍋氬緱濂界殑**
1. **璋ㄦ厧鐨勭瓥鐣?*锛氶€夋嫨澧為噺婕旇繘鑰岄潪涓€娆℃€ч噸鍐?
2. **鎵嬪姩淇<EFBFBD>敼**锛氶€愪釜鏂囦欢淇<E6ACA2>敼锛岄伩鍏嶆壒閲忚剼鏈<E589BC>贡鐮?
### ✅ **做得好的**
1. **谨慎的策略**：选择增量演进而非一次性重写
2. **手动修改**：逐个文件修改，避免批量脚本乱码
3. **充分测试**：每个功能都实际测试验证
4. **问题深挖**：批处理问题追根溯源到数据库字段
5. **文档完善**：详细记录实施过程和决策
### ⚠️ **需要注意的**
1. **璺<EFBFBD>緞渚濊禆**锛氬<E9949B>鍏ヨ矾寰勯渶浠旂粏璁＄畻锛坄../` vs `../../` vs `../../../`锛?
2. **鐩稿<EFBFBD>璺<EFBFBD>緞闄烽槺**锛歚__dirname` 鍦ㄧ洰褰曠Щ鍔ㄥ悗闇€瑕佽皟鏁?
3. **Prisma鏄犲皠**锛氭暟鎹<E69A9F>簱瀛楁<E7809B>涓庝唬鐮佸瓧娈甸渶瑕?`@map` 鏄犲皠
4. **娴嬭瘯瑕嗙洊**锛氭煇浜涘姛鑳斤紙濡傛壒澶勭悊锛変箣鍓嶅彲鑳芥祴璇曚笉瓒?
1. **路径依赖**：导入路径需仔细计算（`../` vs `../../` vs `../../../`）
2. **相对路径陷阱**：`__dirname` 在目录移动后需要调整
3. **Prisma映射**：数据库字段与代码字段需要 `@map` 映射
4. **测试覆盖**：某些功能（如批处理）之前可能测试不足
---
## 📂 相关文档
1. **鏋舵瀯璁捐<EFBFBD>**锛?
1. **架构设计**：
- `docs/00-系统总体设计/前后端模块化架构设计-V2.md`
- `docs/09-架构实施/后端架构增量演进方案.md`
2. **瀹炴柦璁板綍**锛?
- `docs/08-椤圭洰绠＄悊/涓嬩竴闃舵<E99783>琛屽姩璁″垝-V2.2-瀹屾暣鐗?md`
2. **实施记录**：
- `docs/08-项目管理/下一阶段行动计划-V2.2-完整版.md`
3. **缂栫爜瑙勮寖**锛?
- `docs/09-鏋舵瀯瀹炴柦/缂栫爜瑙勮寖-UTF8鏈€浣冲疄璺?md`
3. **编码规范**：
- `docs/09-架构实施/编码规范-UTF8最佳实践.md`
- `.editorconfig`
- `.gitattributes`
---
## 馃殌 涓嬩竴姝ヨ<E5A79D>鍔?
## 🚀 下一步行动
### **立即开始：任务20 - Week 2 验收**
1. 验收前端统一架构
2. 验收后端代码分层
3. 编写 Week 2 总结报告
4. 鍑嗗<EFBFBD> ASL 寮€鍙?
4. 准备 ASL 开发
### **Week 3-4锛欰SL 妯″潡寮€鍙?*
- 鍦ㄦ柊鏋舵瀯涓嬪紑鍙?ASL 妯″潡
- 楠岃瘉鏍囧噯鍖栧紑鍙戞祦绋?
- 绉<EFBFBD>疮鏂版灦鏋勫疄璺电粡楠?
### **Week 3-4：ASL 模块开发**
- 在新架构下开发 ASL 模块
- 验证标准化开发流程
- 积累新架构实践经验
---
**瀹屾垚鏃堕棿锛?* 2025-11-14
**鑰楁椂锛?* 绾?灏忔椂锛堝惈闂<E68388><E99782>鎺掓煡锛?
**鏂囦欢淇<EFBFBD>敼锛?* 33涓<33>枃浠剁Щ鍔?+ 29澶勮矾寰勬洿鏂?+ 1澶凱risma淇<EFBFBD><EFBFBD>
**娴嬭瘯鐘舵€侊細** 鉁?鎵€鏈夊姛鑳介€氳繃
**椋庨櫓绛夌骇锛?* 鏋佷綆锛堝<E9949B>閲忔紨杩涳級
**鎴愭灉璇勪环锛?* 猸愨瓙猸?瓒呭嚭棰勬湡锛屾灦鏋勬竻鏅帮紝鍔熻兘绋冲畾
**完成时间：** 2025-11-14
**耗时：** 约4小时（含问题排查）
**文件修改：** 33个文件移动 + 29处路径更新 + 1处Prisma修复
**测试状态：** ✅ 所有功能通过
**风险等级：** 极低（增量演进）
**成果评价：** ⭐⭐⭐ 超出预期，架构清晰，功能稳定