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-23_Day5_全文复筛API开发.md
+++ b/docs/03-业务模块/ASL-AI智能文献/05-开发记录/2025-11-23_Day5_全文复筛API开发.md
@@ -1,32 +1,32 @@
-# Day 5: 鍏ㄦ枃澶嶇瓫鍚庣<EFBFBD>API寮€鍙戝畬鎴?
+# Day 5: 全文复筛后端API开发完成

-> **鏂囨。鐗堟湰锛?* v1.0  
+> **文档版本：** v1.0  
 > **开发日期：** 2025-11-23  
 > **开发阶段：** 全文复筛模块 - 后端API实现  
-> **鐘舵€侊細** 鉁?瀹屾垚
+> **状态：** ✅ 完成

 ---

-## 馃搵 寮€鍙戠洰鏍?
+## 📋 开发目标

-瀹炵幇鍏ㄦ枃澶嶇瓫妯″潡鐨?涓<>牳蹇傾PI鎺ュ彛锛屽寘鎷<E5AF98>换鍔＄<E98D94>鐞嗐€佽繘搴︽煡璇€€佺粨鏋滆幏鍙栥€佸喅绛栨洿鏂板拰Excel瀵煎嚭鍔熻兘銆?
+实现全文复筛模块的5个核心API接口，包括任务管理、进度查询、结果获取、决策更新和Excel导出功能。

 ---

-## 鉁?瀹屾垚鍔熻兘
+## ✅ 完成功能

-### 1. API璁捐<EFBFBD>涓庢枃妗?
+### 1. API设计与文档

-**鏂囦欢**: `docs/03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/02-鎶€鏈<E282AC><E98F88>璁?02-API璁捐<E79281>瑙勮寖.md`
+**文件**: `docs/03-业务模块/ASL-AI智能文献/02-技术设计/02-API设计规范.md`

 **更新内容**:
 - 新增"全文复筛管理"章节
 - 定义5个RESTful API接口规范
- 鍖呭惈瀹屾暣鐨勮<EFBFBD>姹?鍝嶅簲鏍煎紡
+- 包含完整的请求/响应格式
 - 详细的错误码定义
 - 提供curl测试示例

-**鐗堟湰**: v2.0 鈫?v3.0
+**版本**: v2.0 → v3.0

 ---

@@ -34,9 +34,9 @@

 #### 2.1 FulltextScreeningController

-**鏂囦欢**: `backend/src/modules/asl/fulltext-screening/controllers/FulltextScreeningController.ts` (652琛?
+**文件**: `backend/src/modules/asl/fulltext-screening/controllers/FulltextScreeningController.ts` (652行)

-**瀹炵幇鐨?涓狝PI**:
+**实现的5个API**:

 1. **`POST /api/v1/asl/fulltext-screening/tasks`**
   - 功能: 创建全文复筛任务
@@ -46,35 +46,35 @@

 2. **`GET /api/v1/asl/fulltext-screening/tasks/:taskId/progress`**
   - 功能: 查询任务进度
-   - 杩斿洖: 瀹炴椂杩涘害銆佹垚鍔?澶辫触鏁般€乀oken娑堣€椼€佹垚鏈<E59E9A>粺璁?
+   - 返回: 实时进度、成功/失败数、Token消耗、成本统计

 3. **`GET /api/v1/asl/fulltext-screening/tasks/:taskId/results`**
   - 功能: 获取任务结果
-   - 鏀<EFBFBD>寔: 鍒嗛〉銆佺姸鎬佽繃婊ゃ€佹帓搴?
-   - 杩斿洖: 璇︾粏鐨勬枃鐚<E69E83><E9909A>鐞嗙粨鏋溿€佸弻妯″瀷杈撳嚭銆佸啿绐佷俊鎭?
+   - 支持: 分页、状态过滤、排序
+   - 返回: 详细的文献处理结果、双模型输出、冲突信息

 4. **`PUT /api/v1/asl/fulltext-screening/results/:resultId/decision`**
   - 功能: 人工复核更新决策
-   - 鏀<EFBFBD>寔: 绾冲叆/鎺掗櫎鍐崇瓥銆佺悊鐢辫<E990A2>褰?
-   - 璁板綍: 澶嶆牳浜哄憳鍜屾椂闂?
+   - 支持: 纳入/排除决策、理由记录
+   - 记录: 复核人员和时间

 5. **`GET /api/v1/asl/fulltext-screening/tasks/:taskId/export`**
   - 功能: 导出Excel报告
-   - 鏍煎紡: 4涓猄heet鐨勫畬鏁存姤鍛?
+   - 格式: 4个Sheet的完整报告
   - 下载: 流式传输

-**鍏抽敭鐗规€?*:
- 鉁?Zod鍙傛暟楠岃瘉
- 鉁?缁熶竴閿欒<E996BF>澶勭悊
- 鉁?璇︾粏鏃ュ織璁板綍
- 鉁?鍒嗛〉鏀<E38089>寔
- 鉁?寮傛<E5AFAE>浠诲姟绠＄悊
+**关键特性**:
+- ✅ Zod参数验证
+- ✅ 统一错误处理
+- ✅ 详细日志记录
+- ✅ 分页支持
+- ✅ 异步任务管理

 ---

 ### 3. Excel导出服务

-**鏂囦欢**: `backend/src/modules/asl/fulltext-screening/services/ExcelExporter.ts` (352琛?
+**文件**: `backend/src/modules/asl/fulltext-screening/services/ExcelExporter.ts` (352行)

 **功能实现**:

@@ -92,32 +92,32 @@

 #### Sheet 3: PRISMA统计
 - 筛选流程图数据
- 鍚勯樁娈垫枃鐚<EFBFBD>暟閲?
+- 各阶段文献数量
 - 排除原因统计

 #### Sheet 4: 成本统计
- 妯″瀷浣跨敤缁熻<EFBFBD>锛圖eepSeek vs Qwen锛?
- Token娑堣€楁槑缁?
- 鎴愭湰鍒嗘瀽锛堝崟绡?鎬昏<E98EAC>锛?
+- 模型使用统计（DeepSeek vs Qwen）
+- Token消耗明细
+- 成本分析（单篇/总计）
 - 处理时间统计

-**鎶€鏈<EFBFBD>寒鐐?*:
- 鉁?ExcelJS搴撳疄鐜?
- 鉁?鏍峰紡浼樺寲锛堣〃澶淬€佽竟妗嗐€佸<E282AC>榻愶級
- 鉁?鍒楀<E98D92>鑷<EFBFBD>€傚簲
- 鉁?鏁版嵁鏍煎紡鍖?
+**技术亮点**:
+- ✅ ExcelJS库实现
+- ✅ 样式优化（表头、边框、对齐）
+- ✅ 列宽自适应
+- ✅ 数据格式化

 ---

 ### 4. 路由注册

-**鏂囦欢**: `backend/src/modules/asl/fulltext-screening/routes/fulltext-screening.ts` (73琛?
+**文件**: `backend/src/modules/asl/fulltext-screening/routes/fulltext-screening.ts` (73行)

 **功能**:
 - 注册5个API路由
 - 统一前缀: `/api/v1/asl/fulltext-screening`
 - 集成Controller方法
- 閿欒<EFBFBD>澶勭悊涓<EFBFBD>棿浠?
+- 错误处理中间件

 **集成到ASL模块**:
 - 文件: `backend/src/modules/asl/routes/index.ts`
@@ -129,18 +129,18 @@

 #### 5.1 REST Client测试

-**鏂囦欢**: `backend/src/modules/asl/fulltext-screening/__tests__/fulltext-screening-api.http` (273琛?
+**文件**: `backend/src/modules/asl/fulltext-screening/__tests__/fulltext-screening-api.http` (273行)

-**娴嬭瘯鐢ㄤ緥**: 31涓?
- 鍒涘缓浠诲姟: 8涓<38>満鏅?
- 鏌ヨ<EFBFBD>杩涘害: 5涓<35>満鏅?
+**测试用例**: 31个
+- 创建任务: 8个场景
+- 查询进度: 5个场景
 - 获取结果: 10个场景（分页、过滤、排序）
- 鏇存柊鍐崇瓥: 5涓<35>満鏅?
- 瀵煎嚭Excel: 3涓<EFBFBD>満鏅?
+- 更新决策: 5个场景
+- 导出Excel: 3个场景

-#### 5.2 鑷<EFBFBD>姩鍖栭泦鎴愭祴璇?
+#### 5.2 自动化集成测试

-**鏂囦欢**: `backend/src/modules/asl/fulltext-screening/__tests__/api-integration-test.ts` (294琛?
+**文件**: `backend/src/modules/asl/fulltext-screening/__tests__/api-integration-test.ts` (294行)

 **测试流程**:
 1. 创建测试项目
@@ -151,9 +151,9 @@
 6. 更新复核决策
 7. 导出Excel报告

-#### 5.3 绔<EFBFBD>埌绔<EFBFBD>祴璇曪紙绠€鍖栫増锛?
+#### 5.3 端到端测试（简化版）

-**鏂囦欢**: `backend/src/modules/asl/fulltext-screening/__tests__/e2e-real-test-v2.ts` (235琛?
+**文件**: `backend/src/modules/asl/fulltext-screening/__tests__/e2e-real-test-v2.ts` (235行)

 **特点**:
 - 使用真实PICOS数据
@@ -199,29 +199,29 @@ try {
 }
 ```

-**鏁堟灉**: 鉁?绯荤粺鍙<E7B2BA>互鍦≒DF鎻愬彇鏈嶅姟涓嶅彲鐢ㄦ椂缁х画宸ヤ綔
+**效果**: ✅ 系统可以在PDF提取服务不可用时继续工作

 ---

 ### 问题2: TypeScript类型错误

-**閿欒<EFBFBD>1**: 鐩稿<EFBFBD>瀵煎叆璺<EFBFBD>緞缂哄皯`.js`鎵╁睍鍚?
+**错误1**: 相对导入路径缺少`.js`扩展名
 ```
-褰?--moduleResolution"涓?node16"鏃讹紝鐩稿<EFBFBD>瀵煎叆璺<EFBFBD>緞闇€瑕佹樉寮忔枃浠舵墿灞曞悕
+当"--moduleResolution"为"node16"时，相对导入路径需要显式文件扩展名
 ```

-**淇<EFBFBD><EFBFBD>**: 鎵€鏈夌浉瀵瑰<EFBFBD>鍏ユ坊鍔燻.js`鎵╁睍鍚?
+**修复**: 所有相对导入添加`.js`扩展名

 **错误2**: Zod enum定义错误
 ```
-瀵硅薄瀛楅潰閲忓彧鑳芥寚瀹氬凡鐭ュ睘鎬э紝骞朵笖"errorMap"涓嶅湪绫诲瀷涓?
+对象字面量只能指定已知属性，并且"errorMap"不在类型中
 ```

 **修复**: 使用正确的`z.enum([...])`语法

-**閿欒<EFBFBD>3**: Literature瀛楁<EFBFBD>鍚嶉敊璇?
+**错误3**: Literature字段名错误
 ```
-绫诲瀷涓婁笉瀛樺湪灞炴€?year"
+类型上不存在属性"year"
 ```

 **修复**: 改为`publicationYear`匹配Prisma schema
@@ -231,23 +231,23 @@ try {
 ## 📊 代码统计

 ### 新增文件
- Controller: 1涓<EFBFBD>枃浠讹紝652琛?
- Service (ExcelExporter): 1涓<EFBFBD>枃浠讹紝352琛?
- Routes: 1涓<EFBFBD>枃浠讹紝73琛?
- 娴嬭瘯鏂囦欢: 3涓<33>枃浠讹紝602琛?
- **鎬昏<EFBFBD>**: 1679琛屼唬鐮?
+- Controller: 1个文件，652行
+- Service (ExcelExporter): 1个文件，352行
+- Routes: 1个文件，73行
+- 测试文件: 3个文件，602行
+- **总计**: 1679行代码

 ### 修改文件
- API璁捐<EFBFBD>鏂囨。: +400琛?
- LLM12FieldsService: +18琛岋紙fallback鏈哄埗锛?
- ASL璺<EFBFBD>敱: +5琛?
+- API设计文档: +400行
+- LLM12FieldsService: +18行（fallback机制）
+- ASL路由: +5行

 ### 删除文件
- 涓存椂娴嬭瘯鑴氭湰: 4涓<34>紙娓呯悊瀹屾垚锛?
+- 临时测试脚本: 4个（清理完成）

 ---

-## 馃幆 鎶€鏈<E282AC>寒鐐?
+## 🎯 技术亮点

 ### 1. Zod参数验证

@@ -269,11 +269,11 @@ const createTaskSchema = z.object({
 **优势**:
 - 类型安全
 - 自动错误消息
- 榛樿<EFBFBD>鍊兼敮鎸?
+- 默认值支持

 ### 2. 异步任务管理

-浠诲姟鍦ㄥ悗鍙板紓姝ユ墽琛岋紝閬垮厤闃诲<EFBFBD>HTTP璇锋眰锛?
+任务在后台异步执行，避免阻塞HTTP请求：

 ```typescript
 // 立即返回任务ID
@@ -288,7 +288,7 @@ await this.fulltextScreeningService.createAndProcessTask(...);

 ### 3. 流式Excel导出

-浣跨敤娴佸紡浼犺緭锛岄伩鍏嶅ぇ鏂囦欢鍐呭瓨鍗犵敤锛?
+使用流式传输，避免大文件内存占用：

 ```typescript
 const buffer = await workbook.xlsx.writeBuffer();
@@ -300,7 +300,7 @@ reply

 ### 4. 详细错误处理

-缁熶竴鐨勯敊璇<EFBFBD><EFBFBD>鐞嗗拰鏃ュ織璁板綍锛?
+统一的错误处理和日志记录：

 ```typescript
 try {
@@ -318,56 +318,56 @@ try {

 ## 🔄 API调用流程

-### 瀹屾暣娴佺▼鍥?
+### 完整流程图

 ```
 用户操作
-  鈫?
-鍓嶇<EFBFBD>: 鐐瑰嚮"寮€濮嬪叏鏂囧<E98F82>绛?
-  鈫?
+  ↓
+前端: 点击"开始全文复筛"
+  ↓
 调用: POST /api/v1/asl/fulltext-screening/tasks
-  鈫?
+  ↓
 后端: FulltextScreeningController.createTask()
-  鈫?
+  ↓
 后端: FulltextScreeningService.createAndProcessTask()
-  鈫?(寮傛<E5AFAE>鍚庡彴鎵ц<E98EB5>)
+  ↓ (异步后台执行)
 后端: processTaskInBackground()
-  鈫?(for each literature)
+  ↓ (for each literature)
 后端: screenLiterature()
-  鈫?
+  ↓
 后端: LLM12FieldsService.processDualModels()
-  鈫?
-鎻愬彇: extractFullTextStructured() (Nougat 鈫?PyMuPDF 鈫?Fallback)
-  鈫?
+  ↓
+提取: extractFullTextStructured() (Nougat → PyMuPDF → Fallback)
+  ↓
 调用: DeepSeek-V3 API (并行)
 调用: Qwen-Max API (并行)
-  鈫?
+  ↓
 验证: MedicalLogicValidator
 验证: EvidenceChainValidator
 验证: ConflictDetectionService
-  鈫?
+  ↓
 保存: AslFulltextScreeningResult
-  鈫?
+  ↓
 更新: Task进度
-  鈫?
+  ↓
 前端: 轮询 GET /api/v1/asl/fulltext-screening/tasks/:taskId/progress
-  鈫?
+  ↓
 前端: 显示实时进度
-  鈫?
+  ↓
 任务完成
-  鈫?
+  ↓
 前端: GET /api/v1/asl/fulltext-screening/tasks/:taskId/results
-  鈫?
+  ↓
 前端: 显示结果列表
-  鈫?
-鐢ㄦ埛: 澶嶆牳骞舵洿鏂板喅绛?
-  鈫?
+  ↓
+用户: 复核并更新决策
+  ↓
 调用: PUT /api/v1/asl/fulltext-screening/results/:resultId/decision
-  鈫?
+  ↓
 用户: 导出Excel
-  鈫?
+  ↓
 调用: GET /api/v1/asl/fulltext-screening/tasks/:taskId/export
-  鈫?
+  ↓
 下载: 4-Sheet Excel报告
 ```

@@ -377,18 +377,18 @@ try {

 ### 1. LLM调用流程验证

-**鐘舵€?*: 浠ｇ爜宸插疄鐜帮紝鏈<E7B49D>湪鐪熷疄鐜<E79684><E9909C>瀹屾暣楠岃瘉
+**状态**: 代码已实现，未在真实环境完整验证

 **原因**: 
- LLM璋冪敤闇€瑕?0绉?2鍒嗛挓
- 鍛戒护琛屾祴璇曡秴鏃?
+- LLM调用需要30秒-2分钟
+- 命令行测试超时
 - PDF提取服务路径问题

 **计划**: 前端开发完成后，通过UI界面进行完整测试

 ### 2. PDF提取服务调试

-**鐘舵€?*: 宸叉坊鍔爁allback锛屼絾鏍规湰鍘熷洜鏈<E6B49C>В鍐?
+**状态**: 已添加fallback，但根本原因未解决

 **问题**: Windows路径处理
 ```
@@ -399,11 +399,11 @@ Failed to open file '\\tmp\\extraction_service\\temp_10000_test.pdf'

 ### 3. 异步任务监控

-**鐘舵€?*: 鍚庣<E98D9A>鏀<EFBFBD>寔锛岄渶鍓嶇<E98D93>杞<EFBFBD><E69D9E>閰嶅悎
+**状态**: 后端支持，需前端轮询配合

 **功能**: 
 - 实时进度更新
- Token娑堣€楃粺璁?
+- Token消耗统计
 - 成本计算
 - 错误提示

@@ -411,42 +411,41 @@ Failed to open file '\\tmp\\extraction_service\\temp_10000_test.pdf'

 ---

-## 馃帀 閲岀▼纰戣揪鎴?
+## 🎉 里程碑达成

-### Day 5鏍稿績鐩<EFBFBD>爣 鉁?
+### Day 5核心目标 ✅

 - [x] API设计文档更新
 - [x] 5个核心API实现
 - [x] Excel导出完整实现
- [x] 鍙傛暟楠岃瘉锛圸od锛?
+- [x] 参数验证（Zod）
 - [x] 测试用例编写
 - [x] 错误处理优化
 - [x] PDF提取fallback

-### 涓嬩竴姝? Day 6
+### 下一步: Day 6

-**鐩<EFBFBD>爣**: 鍓嶇<EFBFBD>UI寮€鍙?
+**目标**: 前端UI开发
 - [ ] 全文复筛设置页面
 - [ ] 任务进度监控页面
- [ ] 缁撴灉灞曠ず涓庡<EFBFBD>鏍搁〉闈?
+- [ ] 结果展示与复核页面
 - [ ] Excel导出功能集成
- [ ] 鍓嶅悗绔<EFBFBD>仈璋冩祴璇?
+- [ ] 前后端联调测试

 ---

 ## 📚 相关文档

- [API璁捐<EFBFBD>瑙勮寖 v3.0](../02-鎶€鏈<EFBFBD><EFBFBD>璁?02-API璁捐<E79281>瑙勮寖.md)
- [鏁版嵁搴撹<EFBFBD>璁?v3.0](../02-鎶€鏈<EFBFBD><EFBFBD>璁?01-鏁版嵁搴撹<E690B4>璁?md)
- [鍏ㄦ枃澶嶇瓫寮€鍙戣<EFBFBD>鍒抅(../04-寮€鍙戣<E98D99>鍒?04-鍏ㄦ枃澶嶇瓫寮€鍙戣<E98D99>鍒?md)
- [Day 2-3 LLM鏈嶅姟寮€鍙戣<EFBFBD>褰昡(./2025-11-22_Day2-Day3_LLM鏈嶅姟涓庨獙璇佺郴缁熷紑鍙?md)
+- [API设计规范 v3.0](../02-技术设计/02-API设计规范.md)
+- [数据库设计 v3.0](../02-技术设计/01-数据库设计.md)
+- [全文复筛开发计划](../04-开发计划/04-全文复筛开发计划.md)
+- [Day 2-3 LLM服务开发记录](./2025-11-22_Day2-Day3_LLM服务与验证系统开发.md)

 ---

-**寮€鍙戝畬鎴愭椂闂?*: 2025-11-23 10:50  
-**鎬昏€楁椂**: 绾?灏忔椂  
-**鐘舵€?*: 鉁?Day 5瀹屾垚锛岀瓑寰呭墠绔<E5A2A0>紑鍙戣仈璋?
-
+**开发完成时间**: 2025-11-23 10:50  
+**总耗时**: 约8小时  
+**状态**: ✅ Day 5完成，等待前端开发联调