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

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
2026-01-16 13:42:10 +08:00
parent 98d862dbd4
commit 66255368b7
560 changed files with 70424 additions and 52353 deletions
--- a/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-11-21-真实LLM集成完成报告.md
+++ b/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-11-21-真实LLM集成完成报告.md
@@ -2,24 +2,24 @@

 **日期**: 2025-11-21  
 **任务**: 将Mock AI替换为真实LLM调用  
-**çŠ¶æ€?*: âœ?å®Œæˆ<C3A6>  
+**状态**: ✅ 完成  

 ---

 ## 📋 背景

-### ä¹‹å‰<EFBFBD>çš„çŠ¶æ€?
- âœ?å·²å®Œæˆ?Prompt è®¾è®¡ï¼ˆv1.0.0-MVPï¼?
- âœ?å·²å®žçŽ?`llmScreeningService.ts`ï¼ˆçœŸå®žLLMè°ƒç”¨ï¼?
- âœ?å·²å®Œæˆ<C3A6>æµ‹è¯•æ¡†æž¶å’Œè´¨é‡<C3A9>éªŒè¯<C3A8>
- â<EFBFBD>?**é—®é¢˜**: `screeningService.ts` ä¸ä½¿ç”?`mockAIScreening` ç”Ÿæˆ<EFBFBD>å<EFBFBD>‡æ•°æ<EFBFBD>?
+### 之前的状态
+- ✅ 已完成 Prompt 设计（v1.0.0-MVP）
+- ✅ 已实现 `llmScreeningService.ts`（真实LLM调用）
+- ✅ 已完成测试框架和质量验证
+- ❌ **问题**: `screeningService.ts` 中使用 `mockAIScreening` 生成假数据

-### ç”¨æˆ·éœ€æ±?
-ä»?è®¾ç½®ä¸Žå<C5BD>¯åŠ?é¡µé<C2B5>¢ä¸Šä¼ çœŸå®žæ–‡çŒ®æ•°æ<C2B0>®å<C2AE>Žï¼Œ**ä½¿ç”¨çœŸå®žçš?DeepSeek å’?Qwen API è¿›è¡Œç›é€?*ï¼Œè€Œä¸<C3A4>æ˜¯æ¨¡æ‹Ÿæ•°æ<C2B0>®ã€?
+### 用户需求
+从"设置与启动"页面上传真实文献数据后，**使用真实的 DeepSeek 和 Qwen API 进行筛选**，而不是模拟数据。

 ---

-## âœ?å®Œæˆ<C3A6>å†…å®¹
+## ✅ 完成内容

 ### 1. 修改 `screeningService.ts`

@@ -34,10 +34,10 @@ import { llmScreeningService } from './llmScreeningService.js';

 **替换处理逻辑**:
 ```typescript
-// â<EFBFBD>?æ—§ä»£ç <C3A7>ï¼ˆMockï¼?
+// ❌ 旧代码（Mock）
 const result = await mockAIScreening(projectId, literature);

-// âœ?æ–°ä»£ç <C3A7>ï¼ˆçœŸå®žLLMï¼?
+// ✅ 新代码（真实LLM）
 const screeningResult = await llmScreeningService.dualModelScreening(
  literature.id,
  literature.title,
@@ -87,7 +87,7 @@ const screeningResult = await llmScreeningService.dualModelScreening(
     // DeepSeek结果
     dsModelName: screeningResult.deepseekModel,
     dsPJudgment: screeningResult.deepseek.judgment.P,
-     // ... å®Œæ•´çš„å—æ®µæ˜ å°?
+     // ... 完整的字段映射
   };
   ```

@@ -97,65 +97,65 @@ const screeningResult = await llmScreeningService.dualModelScreening(

 ### 用户操作流程
 ```
-1. è®¿é—®"è®¾ç½®ä¸Žå<C5BD>¯åŠ?é¡µé<C2B5>¢
-   â†?
+1. 访问"设置与启动"页面
+   ↓
 2. 填写 PICOS 标准
-   â†?
+   ↓
 3. 上传 Excel 文献列表（例如：199篇）
-   â†?
+   ↓
 4. 点击"开始AI初筛"
-   â†?
-5. å<EFBFBD>Žç«¯è‡ªåŠ¨å¤„ç<EFBFBD>†ï¼?
+   ↓
+5. 后端自动处理：
   a. 创建项目
   b. 导入文献
-   c. å<EFBFBD>¯åŠ¨ç›é€‰ä»»åŠ?
-   â†?
+   c. 启动筛选任务
+   ↓
 6. 真实LLM处理（每篇约10-15秒）
   a. 调用 DeepSeek API
   b. 调用 Qwen API
-   c. å¯¹æ¯”ç»“æžœï¼Œæ£€æµ‹å†²çª?
+   c. 对比结果，检测冲突
   d. 保存到数据库
-   â†?
-7. å‰<EFBFBD>ç«¯è‡ªåŠ¨è·³è½¬åˆ?å®¡æ ¸å·¥ä½œå<C593>?
-   â†?
-8. æ˜¾ç¤ºçœŸå®žçš„AIç›é€‰ç»“æž?
+   ↓
+7. 前端自动跳转到"审核工作台"
+   ↓
+8. 显示真实的AI筛选结果
 ```

-### æŠ€æœ¯æµ<EFBFBD>ç¨?
+### 技术流程

 ```
 前端: TitleScreeningSettings.tsx
-  â†?POST /api/v1/asl/literatures/import
+  ↓ POST /api/v1/asl/literatures/import
  
 后端: literatureController.ts
-  â†?importLiteratures()
-  â†?startScreeningTask()
+  ↓ importLiteratures()
+  ↓ startScreeningTask()
  
 后端: screeningService.ts
-  â†?processLiteraturesInBackground()
-  â†?for each literature:
-      â†?llmScreeningService.dualModelScreening()
+  ↓ processLiteraturesInBackground()
+  ↓ for each literature:
+      ↓ llmScreeningService.dualModelScreening()
      
 后端: llmScreeningService.ts
-  â†?Promise.all([
+  ↓ Promise.all([
      screenWithModel('deepseek-chat', ...),
      screenWithModel('qwen-max', ...),
    ])
  
 后端: LLMFactory
-  â†?getAdapter('deepseek-v3')
-  â†?getAdapter('qwen3-72b')
+  ↓ getAdapter('deepseek-v3')
+  ↓ getAdapter('qwen3-72b')
  
 真实API调用
-  â†?DeepSeek API
-  â†?Qwen API
+  ↓ DeepSeek API
+  ↓ Qwen API
  
 结果保存
-  â†?AslScreeningResult è¡?
+  ↓ AslScreeningResult 表
  
 前端: ScreeningWorkbench.tsx
-  â†?GET /api/v1/asl/projects/:projectId/screening-results
-  â†?æ˜¾ç¤ºçœŸå®žç»“æžœ
+  ↓ GET /api/v1/asl/projects/:projectId/screening-results
+  ↓ 显示真实结果
 ```

 ---
@@ -165,46 +165,46 @@ const screeningResult = await llmScreeningService.dualModelScreening(
 ### 单篇文献处理时间
 | 步骤 | 耗时（串行） |
 |-----|------------|
-| DeepSeek API è°ƒç”¨ | 5-10ç§?|
-| Qwen API è°ƒç”¨ | 5-10ç§?|
-| ç»“æžœä¿<EFBFBD>å˜ | 0.1ç§?|
-| **æ€»è®¡** | **10-20ç§?* |
+| DeepSeek API 调用 | 5-10秒 |
+| Qwen API 调用 | 5-10秒 |
+| 结果保存 | 0.1秒 |
+| **总计** | **10-20秒** |

-### æ‰¹é‡<EFBFBD>å¤„ç<EFBFBD>†æ—¶é—´ï¼?99ç¯‡ï¼‰
+### 批量处理时间（199篇）
 | 模式 | 耗时 | 说明 |
 |-----|------|-----|
 | **串行处理** | 33-66分钟 | 当前实现（避免API限流）|
-| å¹¶å<EFBFBD>‘å¤„ç<EFBFBD>†ï¼?ä¸ªï¼‰ | 11-22åˆ†é’Ÿ | å<>¯é€‰ä¼˜åŒ–ï¼ˆéœ€æµ‹è¯•ï¼?|
-| å¹¶å<EFBFBD>‘å¤„ç<EFBFBD>†ï¼?0ä¸ªï¼‰ | 3-7åˆ†é’Ÿ | é£Žé™©ï¼šå<C5A1>¯èƒ½è§¦å<C2A6>‘APIé™<C3A9>é¢<C3A9> |
+| 并发处理（3个） | 11-22分钟 | 可选优化（需测试） |
+| 并发处理（10个） | 3-7分钟 | 风险：可能触发API限额 |

 **当前策略**: 串行处理（稳定优先）

 ---

-## ðŸŽ¯ ä¸ŽMockæ•°æ<C2B0>®çš„å¯¹æ¯?
+## 🎯 与Mock数据的对比

-### Mock æ•°æ<EFBFBD>®ï¼ˆæ—§ï¼?
+### Mock 数据（旧）
 ```javascript
-// â<EFBFBD>?å<>‡æ•°æ<C2B0>?
+// ❌ 假数据
 dsPEvidence: "模拟证据: 研究人群与PICO中的P标准匹配"
-dsReason: "åŸºäºŽæ ‡é¢˜å’Œæ‘˜è¦<EFBFBD>åˆ†æž<EFBFBD>ï¼Œè¯¥æ–‡çŒ®ç¬¦å<EFBFBD>ˆçº³å…¥æ ‡å‡†ã€?
-dsConclusion: randomConclusion() // éš<EFBFBD>æœºï¼?
+dsReason: "基于标题和摘要分析，该文献符合纳入标准。"
+dsConclusion: randomConclusion() // 随机！

-// ç‰¹ç‚¹ï¼?
- 1ç§’å®Œæˆ?99ç¯?
+// 特点：
+- 1秒完成199篇
 - 证据都是"模拟证据"
 - 判断结果随机生成
 ```

-### çœŸå®žLLMï¼ˆæ–°ï¼?
+### 真实LLM（新）
 ```javascript
-// âœ?çœŸå®žæ•°æ<C2B0>®
+// ✅ 真实数据
 dsPEvidence: "This study included adult patients with type 2 diabetes mellitus aged 18 years or older, which matches the population criteria."
 dsReason: "The study population consists of T2DM patients, the intervention is an SGLT2 inhibitor (empagliflozin), the comparator is placebo, and the study design is a randomized controlled trial. All PICO criteria are met. The study reports on cardiovascular outcomes including MACE, heart failure hospitalization, and cardiovascular death, which are the outcomes of interest."
-dsConclusion: "include" // AIçœŸå®žåˆ¤æ–ï¼?
+dsConclusion: "include" // AI真实判断！

-// ç‰¹ç‚¹ï¼?
- 33-66åˆ†é’Ÿå®Œæˆ<EFBFBD>199ç¯?
+// 特点：
+- 33-66分钟完成199篇
 - 证据引用文献原文
 - 判断基于Prompt v1.0.0-MVP
 - 准确率：60%（首次测试）
@@ -222,12 +222,12 @@ node check-data.mjs

 ### 预期输出（真实数据）
 ```
-ðŸ”¬ ç›é€‰ç»“æžœæ ·æœ?
+🔬 筛选结果样本:
  [1] 文献: Assessment of Thrombectomy versus Combined...
      DeepSeek: include (P:match, I:partial, C:mismatch, S:match)
      Qwen:     exclude (P:mismatch, I:mismatch, C:partial, S:match)
-      å†²çª<EFBFBD>çŠ¶æ€? conflict
-      æ˜¯å<EFBFBD>¦æœ‰è¯<EFBFBD>æ<EFBFBD>? DeepSeek=true, Qwen=true  âœ?
+      冲突状态: conflict
+      是否有证据: DeepSeek=true, Qwen=true  ✅

  证据示例:
  - dsPEvidence: "The study population consists of..."
@@ -245,17 +245,17 @@ node check-data.mjs
   - 不合格的输出会被拒绝

 2. **错误处理**:
-   - å<EFBFBD>•ç¯‡æ–‡çŒ®å¤±è´¥ä¸<EFBFBD>å½±å“<EFBFBD>æ•´ä½“ä»»åŠ?
+   - 单篇文献失败不影响整体任务
   - 详细错误日志记录

 3. **进度追踪**:
-   - æ¯?0ç¯‡æ›´æ–°ä¸€æ¬¡è¿›åº?
-   - å®žæ—¶ç»Ÿè®¡æˆ<EFBFBD>åŠŸ/å†²çª<C3A7>/å¤±è´¥æ•?
+   - 每10篇更新一次进度
+   - 实时统计成功/冲突/失败数

-4. **å<EFBFBD>¯è¿½æº¯æ€?*:
-   - è®°å½•åŽŸå§‹LLMè¾“å‡ºï¼ˆ`rawOutput`ï¼?
-   - è®°å½•Promptç‰ˆæœ¬ï¼ˆ`promptVersion`ï¼?
-   - è®°å½•å¤„ç<EFBFBD>†æ—¶é—´ï¼ˆ`aiProcessedAt`ï¼?
+4. **可追溯性**:
+   - 记录原始LLM输出（`rawOutput`）
+   - 记录Prompt版本（`promptVersion`）
+   - 记录处理时间（`aiProcessedAt`）

 ---

@@ -264,8 +264,8 @@ node check-data.mjs
 ### Step 1: 准备测试数据
 ```
 使用现有测试文件:
- PICOS: docs/.../æµ‹è¯•æ¡ˆä¾‹çš„PICOSã€<EFBFBD>çº³å…¥æ ‡å‡†ã€<EFBFBD>æŽ’é™¤æ ‡å‡?txt
- Excel: docs/.../Test Cases.xlsx (199ç¯‡æ–‡çŒ?
+- PICOS: docs/.../测试案例的PICOS、纳入标准、排除标准.txt
+- Excel: docs/.../Test Cases.xlsx (199篇文献)
 ```

 ### Step 2: 执行测试
@@ -274,8 +274,8 @@ node check-data.mjs
 3. 访问: `http://localhost:3001`
 4. 填写PICOS + 上传Excel
 5. 点击"开始AI初筛"
-6. **ç‰å¾…30-60åˆ†é’Ÿ**ï¼?99ç¯‡Ã?0ç§’ï¼‰
-7. æŸ¥çœ‹å®¡æ ¸å·¥ä½œå<EFBFBD>?
+6. **等待30-60分钟**（199篇×20秒）
+7. 查看审核工作台

 ### Step 3: 验证结果
 ```bash
@@ -284,18 +284,18 @@ node check-data.mjs
 ```

 **检查项**:
- [ ] æ‰€æœ‰æ–‡çŒ®éƒ½æœ‰ç›é€‰ç»“æž?
- [ ] è¯<EFBFBD>æ<EFBFBD>®ä¸<EFBFBD>å†<EFBFBD>æ˜?æ¨¡æ‹Ÿè¯<C3A8>æ<EFBFBD>®"
+- [ ] 所有文献都有筛选结果
+- [ ] 证据不再是"模拟证据"
 - [ ] 证据包含文献原文引用
 - [ ] 判断理由详细且符合逻辑
- [ ] å†²çª<EFBFBD>æ£€æµ‹å‡†ç¡®ï¼ˆconclusionä¸<EFBFBD>å<EFBFBD>Œï¼?
+- [ ] 冲突检测准确（conclusion不同）

 ---

 ## ⚠️ 注意事项

 ### API密钥配置
-ç¡®ä¿<EFBFBD>çŽ¯å¢ƒå<EFBFBD>˜é‡<EFBFBD>å·²é…<EFBFBD>ç½?
+确保环境变量已配置:
 ```bash
 # .env
 DEEPSEEK_API_KEY=sk-xxxxx
@@ -306,33 +306,33 @@ QWEN_API_KEY=sk-xxxxx
 - DeepSeek: 60 RPM（每分钟请求数）
 - Qwen: 60 RPM

-**å½“å‰<EFBFBD>ç–ç•¥**: ä¸²è¡Œå¤„ç<E2809E>†ï¼Œä¸<C3A4>ä¼šè§¦å<C2A6>‘é™<C3A9>æµ?
+**当前策略**: 串行处理，不会触发限流

 ### 成本估算
- DeepSeek: ~$0.001/æ¬?Ã— 199 = **$0.20**
- Qwen: ~$0.001/æ¬?Ã— 199 = **$0.20**
- **æ€»è®¡**: **$0.40** / æ¬¡å®Œæ•´æµ‹è¯?
+- DeepSeek: ~$0.001/次 × 199 = **$0.20**
+- Qwen: ~$0.001/次 × 199 = **$0.20**
+- **总计**: **$0.40** / 次完整测试

 ---

 ## 💡 优化建议

-### çŸæœŸä¼˜åŒ–ï¼ˆWeek 2 - Day 4-5ï¼?
-1. **å¹¶å<EFBFBD>‘æŽ§åˆ¶**: æ”¹ä¸º3ä¸ªå¹¶å<C2B6>‘ï¼ˆ33åˆ†é’Ÿ â†?11åˆ†é’Ÿï¼?
-2. **è¿›åº¦æ˜¾ç¤º**: å‰<C3A5>ç«¯è½®è¯¢æ˜¾ç¤ºè¿›åº¦ç™¾åˆ†æ¯?
-3. **é”™è¯¯é‡<EFBFBD>è¯•**: å¤±è´¥çš„æ–‡çŒ®è‡ªåŠ¨é‡<C3A9>è¯?æ¬?
+### 短期优化（Week 2 - Day 4-5）
+1. **并发控制**: 改为3个并发（33分钟 → 11分钟）
+2. **进度显示**: 前端轮询显示进度百分比
+3. **错误重试**: 失败的文献自动重试1次

-### ä¸æœŸä¼˜åŒ–ï¼ˆWeek 3ï¼?
+### 中期优化（Week 3）
 1. **消息队列**: 使用Bull Queue异步处理
-2. **æ‰¹é‡<EFBFBD>ä¼˜åŒ–**: ä½¿ç”¨æ‰¹é‡<C3A9>APIæŽ¥å<C2A5>£ï¼ˆå¦‚æžœæœ‰ï¼?
-3. **ç¼“å˜æœºåˆ¶**: ç›¸å<C2B8>Œæ–‡çŒ®ä¸<C3A4>é‡<C3A9>å¤<C3A5>ç›é€?
+2. **批量优化**: 使用批量API接口（如果有）
+3. **缓存机制**: 相同文献不重复筛选

 ---

 ## 📁 相关文件

-### ä¿®æ”¹çš„æ–‡ä»?
- `backend/src/modules/asl/services/screeningService.ts` â?
+### 修改的文件
+- `backend/src/modules/asl/services/screeningService.ts` ⭐

 ### 依赖的文件（已存在）
 - `backend/src/modules/asl/services/llmScreeningService.ts`
@@ -348,30 +348,30 @@ QWEN_API_KEY=sk-xxxxx

 ## 🎉 成果总结

-### å·²å®žçŽ?
-âœ?çœŸå®žLLMè°ƒç”¨æ›¿æ<C2BF>¢Mockæ•°æ<C2B0>®  
-âœ?ä»Žé¡¹ç›®è¯»å<C2BB>–PICOSæ ‡å‡†  
-âœ?å<>Œæ¨¡åž‹å¹¶è¡Œç›é€? 
-âœ?å†²çª<C3A7>æ£€æµ‹ä¸Žæ ‡è®°  
-âœ?å®Œæ•´çš„æ—¥å¿—è¿½è¸? 
-âœ?é”™è¯¯å¤„ç<E2809E>†æœºåˆ¶  
+### 已实现
+✅ 真实LLM调用替换Mock数据  
+✅ 从项目读取PICOS标准  
+✅ 双模型并行筛选  
+✅ 冲突检测与标记  
+✅ 完整的日志追踪  
+✅ 错误处理机制  

-### å¾…ä¼˜åŒ?
-âš ï¸<EFBFBD> å¤„ç<E2809E>†æ—¶é—´è¾ƒé•¿ï¼?0-60åˆ†é’Ÿï¼? 
-âš ï¸<EFBFBD> ä¸²è¡Œå¤„ç<E2809E>†ï¼ˆå<CB86>¯æ”¹ä¸ºå¹¶å<C2B6>‘ï¼? 
-âš ï¸<EFBFBD> å‰<C3A5>ç«¯è¿›åº¦æ˜¾ç¤ºï¼ˆéœ€ä¼˜åŒ–è½®è¯¢é¢‘çŽ‡ï¼? 
+### 待优化
+⚠️ 处理时间较长（30-60分钟）  
+⚠️ 串行处理（可改为并发）  
+⚠️ 前端进度显示（需优化轮询频率）  

 ---

-## ðŸ”— å<>‚è€ƒæ–‡æ¡?
+## 🔗 参考文档

- [Promptè®¾è®¡ä¸Žæµ‹è¯•å®Œæˆ<EFBFBD>æŠ¥å‘Š](./2025-11-18-Promptè®¾è®¡ä¸Žæµ‹è¯•å®Œæˆ<C3A6>æŠ¥å‘?md)
+- [Prompt设计与测试完成报告](./2025-11-18-Prompt设计与测试完成报告.md)
 - [卒中数据泛化测试报告](./2025-11-18-卒中数据泛化测试报告.md)
- [ä»»åŠ¡åˆ†è§£](../04-å¼€å<E282AC>‘è®¡åˆ?03-ä»»åŠ¡åˆ†è§£.md)
+- [任务分解](../04-开发计划/03-任务分解.md)

 ---

-**æŠ¥å‘Šäº?*: AI Assistant  
+**报告人**: AI Assistant  
 **日期**: 2025-11-21  
 **版本**: v1.0.0