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

368
docs/08-项目管理/03-每周计划/2025-11-18-AI助手工作交接.md
View File

@@ -1,55 +1,55 @@
# AI助手工作交接文档
> **浜ゆ帴鏃ユ湡锛?* 2025-11-18
> **鍓嶄换AI锛?* Claude (Session 2025-11-17~11-18)
> **鍚庝换AI锛?* 寰呮帴鎵?
> **椤圭洰鐘舵€侊細** 骞冲彴鍩虹<E98DA9>璁炬柦瀹屾垚锛孉SL妯″潡寮€鍙戝氨缁?
> **浜ゆ帴鍘熷洜锛?* 涓婁笅鏂囬暱搴﹂檺鍒讹紝鍑嗗<E98D91>寮€濮婣SL妯″潡寮€鍙?
> **交接日期：** 2025-11-18
> **前任AI：** Claude (Session 2025-11-17~11-18)
> **后任AI：** 待接手
> **项目状态：** 平台基础设施完成，ASL模块开发就绪
> **交接原因：** 上下文长度限制，准备开始ASL模块开发
---
## 馃搵 椤圭洰姒傝<E5A792>锛?0绉掞級
## 📋 项目概览（10秒）
**椤圭洰鍚嶇О锛?* AIclinicalresearch - 鍖诲<EFBFBD>绉戠爺AI骞冲彴
**褰撳墠浠诲姟锛?* 寮€鍙慉SL锛圓I鏅鸿兘鏂囩尞锛夋ā鍧?
**绗<EFBFBD>竴鍔熻兘锛?* 鏍囬<E98F8D>鎽樿<E98EBD>鍒濈瓫锛圗xcel瀵煎叆 鈫?AI鍙屾ā鍨嬬瓫閫?鈫?浜哄伐澶嶆牳 鈫?瀵煎嚭锛?
**褰撳墠鐘舵€侊細** 鎵€鏈変緷璧栧氨缁<E6B0A8>紝鍙<E7B49D>珛鍗冲紑濮嬪紑鍙?鉁?
**项目名称：** AIclinicalresearch - 医学科研AI平台
**当前任务：** 开发ASL（AI智能文献）模块
**第一功能：** 标题摘要初筛（Excel导入 → AI双模型筛选 → 人工复核 → 导出）
**当前状态：** 所有依赖就绪，可立即开始开发 ✅
---
## 鉁?宸插畬鎴愮殑宸ヤ綔锛?025-11-17~11-18锛?
## ✅ 已完成的工作（2025-11-17~11-18）
### 2025-11-17：平台基础设施实施
**瀹屾垚鍐呭<EFBFBD>锛?* 8涓<38>牳蹇冩ā鍧楋紝2,532琛屾柊浠ｇ爜锛?2涓<32>柊鏂囦欢
**完成内容：** 8个核心模块，2,532行新代码，22个新文件
| # | 妯″潡 | 鍔熻兘 | 娴嬭瘯鐘舵€?|
| # | 模块 | 功能 | 测试状态 |
|---|------|------|---------|
| 1 | 瀛樺偍鏈嶅姟 | 鏂囦欢涓婁紶涓嬭浇锛堟湰鍦?OSS鍒囨崲锛?| 鉁?100% |
| 2 | 鏃ュ織绯荤粺 | 缁撴瀯鍖朖SON鏃ュ織 | 鉁?100% |
| 3 | 缂撳瓨鏈嶅姟 | 鍐呭瓨/Redis缂撳瓨 | 鉁?100% |
| 4 | 寮傛<EFBFBD>浠诲姟 | 闀挎椂闂翠换鍔￠槦鍒?| 鉁?100% |
| 5 | 鍋ュ悍妫€鏌?| SAE鍋ュ悍妫€鏌ョ<E98F8C>鐐?| 鉁?100% |
| 6 | 鐩戞帶鎸囨爣 | 鎬ц兘鐩戞帶 | 鉁?100% |
| 7 | 鏁版嵁搴撹繛鎺ユ睜 | Prisma杩炴帴姹犱紭鍖?| 鉁?100% |
| 8 | 鐜<EFBFBD><EFBFBD>閰嶇疆 | 缁熶竴閰嶇疆绠＄悊 | 鉁?100% |
| 1 | 存储服务 | 文件上传下载（本地/OSS切换） | ✅ 100% |
| 2 | 日志系统 | 结构化JSON日志 | ✅ 100% |
| 3 | 缓存服务 | 内存/Redis缓存 | ✅ 100% |
| 4 | 异步任务 | 长时间任务队列 | ✅ 100% |
| 5 | 健康检查 | SAE健康检查端点 | ✅ 100% |
| 6 | 监控指标 | 性能监控 | ✅ 100% |
| 7 | 数据库连接池 | Prisma连接池优化 | ✅ 100% |
| 8 | 环境配置 | 统一配置管理 | ✅ 100% |
**鍏抽敭鏂囦欢锛?*
**关键文件：**
- `backend/src/common/storage/` - 存储服务
- `backend/src/common/logging/` - 日志系统
- `backend/src/common/cache/` - 缓存服务
- `backend/src/common/jobs/` - 异步任务
- `backend/src/common/health/` - 鍋ュ悍妫€鏌?
- `backend/src/common/health/` - 健康检查
- `backend/src/common/monitoring/` - 监控指标
- `backend/src/config/database.ts` - 鏁版嵁搴撻厤缃?
- `backend/src/config/database.ts` - 数据库配置
- `backend/src/config/env.ts` - 环境配置
**娴嬭瘯楠岃瘉锛?*
**测试验证：**
- 测试脚本：`backend/src/scripts/test-platform-infrastructure.ts`
- 测试API：`GET http://localhost:3001/test/platform`
- 娴嬭瘯缁撴灉锛欰LL_PASSED锛?00%锛?
- 测试结果：ALL_PASSED（100%）
**鏂囨。杈撳嚭锛?*
**文档输出：**
- `docs/09-架构实施/04-平台基础设施规划.md` - 详细设计方案
- `docs/08-项目管理/03-每周计划/2025-11-17-平台基础设施实施完成报告.md`
- `docs/08-项目管理/03-每周计划/2025-11-17-平台基础设施验证报告.md`
@@ -58,112 +58,112 @@
### 2025-11-18：CloseAI集成与性能优化
**瀹屾垚鍐呭<EFBFBD>锛?* GPT-4o + Claude-4.5 闆嗘垚锛屾€ц兘浼樺寲25鍊?
**完成内容：** GPT-4o + Claude-4.5 集成，性能优化25倍
| 宸ヤ綔椤?| 鐘舵€?| 鎴愭灉 |
| 工作项 | 状态 | 成果 |
|--------|------|------|
| 鍒涘缓CloseAI鏍稿績閫傞厤鍣?| 鉁?| `CloseAIAdapter.ts` |
| 鍒涘缓GPT鍜孋laude灏佽<EFBFBD> | 鉁?| `GPT5Adapter.ts` + `ClaudeAdapter.ts` |
| 鏇存柊绫诲瀷瀹氫箟鍜屽伐鍘傜被 | 鉁?| `types.ts` + `LLMFactory.ts` |
| 鍒涘缓娴嬭瘯鑴氭湰 | 鉁?| `test-closeai.ts` |
| 鎬ц兘浼樺寲 | 鉁?| gpt-5-pro(50绉? 鈫?gpt-4o(1.5绉? |
| 娴嬭瘯楠岃瘉 | 鉁?| 鎵€鏈夋祴璇曢€氳繃锛?涓<>祴璇曪級 |
| 创建CloseAI核心适配器 | ✅ | `CloseAIAdapter.ts` |
| 创建GPT和Claude封装 | ✅ | `GPT5Adapter.ts` + `ClaudeAdapter.ts` |
| 更新类型定义和工厂类 | ✅ | `types.ts` + `LLMFactory.ts` |
| 创建测试脚本 | ✅ | `test-closeai.ts` |
| 性能优化 | ✅ | gpt-5-pro(50秒) → gpt-4o(1.5秒) |
| 测试验证 | ✅ | 所有测试通过（4个测试） |
**鎬ц兘鎻愬崌锛?*
- GPT鍝嶅簲鏃堕棿锛?0绉?鈫?1.5绉掞紙**25鍊嶆彁鍗?*锛夆瓙
- 鍙屾ā鍨嬬瓫閫夛細51绉?鈫?4.8绉掞紙**10鍊嶆彁鍗?*锛夆瓙
- 娴佸紡璋冪敤锛?7绉?鈫?1.1绉掞紙**52鍊嶆彁鍗?*锛夆瓙
**性能提升：**
- GPT响应时间：50秒 → 1.5秒（**25倍提升**）⭐
- 双模型筛选：51秒 → 4.8秒（**10倍提升**）⭐
- 流式调用：57秒 → 1.1秒（**52倍提升**）⭐
**鍙<EFBFBD>敤鐨凩LM妯″瀷锛?涓<>級锛?*
**可用的LLM模型（5个）：**
| 模型 | 响应时间 | 成本 | 适用场景 |
|------|---------|------|---------|
| DeepSeek-V3 | 13绉?| 鏈€浣?| 蹇<>€熷垵绛?|
| **GPT-4o** | **1.5绉?* 猸?| 閫備腑 | 楂樿川閲忕瓫閫夛紙鎺ㄨ崘锛?|
| Claude-4.5 | 2.8绉?| 閫備腑 | 绗<>笁鏂逛徊瑁?|
| Qwen3-72B | 10绉?| 浣?| 涓<>枃鐞嗚В |
| Qwen-Long | 15绉?| 浣?| 瓒呴暱涓婁笅鏂?|
| DeepSeek-V3 | 13秒 | 最低 | 快速初筛 |
| **GPT-4o** | **1.5秒** ⭐ | 适中 | 高质量筛选（推荐） |
| Claude-4.5 | 2.8秒 | 适中 | 第三方仲裁 |
| Qwen3-72B | 10秒 | 低 | 中文理解 |
| Qwen-Long | 15秒 | 低 | 超长上下文 |
**推荐筛选策略：**
```
DeepSeek锛堢粡娴庯級+ GPT-4o锛堣川閲忥級鈫?4.8绉?鈫?涓€鑷村垯閲囩撼 鈫?涓嶄竴鑷村垯澶嶆牳
DeepSeek（经济）+ GPT-4o（质量）→ 4.8秒 → 一致则采纳 → 不一致则复核
```
**鍏抽敭鏂囦欢锛?*
- `backend/src/common/llm/adapters/CloseAIAdapter.ts` - 鏍稿績閫傞厤鍣?
**关键文件：**
- `backend/src/common/llm/adapters/CloseAIAdapter.ts` - 核心适配器
- `backend/src/common/llm/adapters/GPT5Adapter.ts` - GPT-4o封装
- `backend/src/common/llm/adapters/ClaudeAdapter.ts` - Claude封装
- `backend/src/scripts/test-closeai.ts` - 测试脚本
**鏂囨。杈撳嚭锛?*
- 鏇存柊 `docs/00-绯荤粺鎬讳綋璁捐<EFBFBD>/00-绯荤粺褰撳墠鐘舵€佷笌寮€鍙戞寚鍗?md` - 娣诲姞LLM妯″瀷鏀<E780B7>寔璇︽儏
**文档输出：**
- 更新 `docs/00-系统总体设计/00-系统当前状态与开发指南.md` - 添加LLM模型支持详情
---
### 2025-11-18锛氭枃妗ｄ綋绯诲畬鍠?
### 2025-11-18：文档体系完善
**瀹屾垚鍐呭<EFBFBD>锛?* 鍒涘缓鏂扮殑鏍稿績鏂囨。锛屽畬鍠凙I瀵规帴鏂囨。
**完成内容：** 创建新的核心文档，完善AI对接文档
| 鏂囨。 | 鐢ㄩ€?| 鐘舵€?|
| 文档 | 用途 | 状态 |
|------|------|------|
| **00-绯荤粺褰撳墠鐘舵€佷笌寮€鍙戞寚鍗?md** | 绯荤粺鐪熷疄鐘舵€?鏍稿績瑙勮寖 | 鉁?鏂板缓 |
| **START-HERE-FOR-NEW-AI.md** | 鏂癆I 2鍒嗛挓蹇<EFBFBD>€熷惎鍔?| 鉁?鏂板缓 |
| **[AI瀵规帴] ASL妯″潡蹇<EFBFBD>€熶笂涓嬫枃.md** | ASL寮€鍙戝揩閫熶笂鎵?| 鉁?鏇存柊 |
| **00-系统当前状态与开发指南.md** | 系统真实状态+核心规范 | ✅ 新建 |
| **START-HERE-FOR-NEW-AI.md** | 新AI 2分钟快速启动 | ✅ 新建 |
| **[AI对接] ASL模块快速上下文.md** | ASL开发快速上手 | ✅ 更新 |
---
## 馃幆 涓嬩竴姝ヤ换鍔★紙缁欐柊AI锛?
## 🎯 下一步任务（给新AI）
### 任务：开发ASL模块 - 标题摘要初筛功能
**寮€鍙戝懆鏈燂細** 4鍛?
**绗<EFBFBD>竴姝ワ細** 瀹氫箟鏁版嵁搴揝chema锛?灏忔椂锛?
**浜や粯鐩<EFBFBD>爣锛?* Excel瀵煎叆 鈫?AI鍙屾ā鍨嬬瓫閫?鈫?浜哄伐澶嶆牳 鈫?瀵煎嚭缁撴灉
**开发周期：** 4周
**第一步：** 定义数据库Schema（2小时）
**交付目标：** Excel导入 → AI双模型筛选 → 人工复核 → 导出结果
**璇︾粏浠诲姟娓呭崟锛?* `docs/03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/04-寮€鍙戣<E98D99>鍒?03-浠诲姟鍒嗚В.md`锛?0+涓<>换鍔★級
**详细任务清单：** `docs/03-业务模块/ASL-AI智能文献/04-开发计划/03-任务分解.md`（80+个任务）
---
## 📚 给新AI的必读清单（按顺序）
### 馃敟 棣栨<E6A3A3>鍚<EFBFBD>姩蹇呰<E8B987>锛?鍒嗛挓锛?
**馃搫 `START-HERE-FOR-NEW-AI.md`**锛堥」鐩<EFBFBD>牴鐩<EFBFBD>綍锛?
### 🔥 首次启动必读（2分钟）
**📄 `START-HERE-FOR-NEW-AI.md`**（项目根目录）
- 10秒速读项目概况
- 已完成工作总结
- 绗<EFBFBD>竴姝ユ搷浣滄寚鍗?
- 第一步操作指南
- 核心代码示例
- 禁止操作清单
### 猸?绯荤粺鍏ㄨ矊锛?0鍒嗛挓锛?
**馃搫 `docs/00-绯荤粺鎬讳綋璁捐<EFBFBD>/00-绯荤粺褰撳墠鐘舵€佷笌寮€鍙戞寚鍗?md`**
- **Part 1.3锛氬悗绔<EFBFBD>灦鏋?- 骞冲彴鍩虹<E98DA9>璁炬柦**锛堝繀璇伙級
### ⭐ 系统全貌（20分钟）
**📄 `docs/00-系统总体设计/00-系统当前状态与开发指南.md`**
- **Part 1.3：后端架构 - 平台基础设施**（必读）
- 8个模块的使用方法
- 详细代码示例
- **Part 2.3锛氫簯鍘熺敓寮€鍙戣<EFBFBD>鑼?*锛堝繀椤婚伒瀹堬級
- **Part 2.3：云原生开发规范**（必须遵守）
- DO/DON'T清单
- 禁止操作列表
- **LLM模型支持**（必读）
- 5个模型的调用方式
- 性能测试结果
### 猸?ASL寮€鍙戞寚鍗楋紙15鍒嗛挓锛?
### ⭐ ASL开发指南（15分钟）
**📄 `docs/03-业务模块/ASL-AI智能文献/[AI对接] ASL模块快速上下文.md`**
- 💬 给新AI的一段话
- 褰撳墠鐘舵€佽<EFBFBD>鎯?
- 当前状态详情
- 必读文档清单
- 蹇<EFBFBD>€熼棶绛?
- 快速问答
- 立即开始的步骤
### 猸?璇︾粏寮€鍙戣<E98D99>鍒掞紙20鍒嗛挓锛?
**馃搫 `docs/03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/04-寮€鍙戣<E98D99>鍒?02-鏍囬<E98F8D>鎽樿<E98EBD>鍒濈瓫寮€鍙戣<E98D99>鍒?md`**
- Week 1 Day 1锛氬畬鏁寸殑Prisma Schema浠ｇ爜锛堝彲鐩存帴澶嶅埗锛?
- 姣忓ぉ鐨勮<EFBFBD>缁嗗紑鍙戜换鍔?
- LLM绛涢€夋湇鍔′唬鐮佺ず渚?
### ⭐ 详细开发计划（20分钟）
**📄 `docs/03-业务模块/ASL-AI智能文献/04-开发计划/02-标题摘要初筛开发计划.md`**
- Week 1 Day 1：完整的Prisma Schema代码（可直接复制）
- 每天的详细开发任务
- LLM筛选服务代码示例
### 馃搵 浠诲姟鍒嗚В娓呭崟锛?5鍒嗛挓锛?
**馃搫 `docs/03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/04-寮€鍙戣<E98D99>鍒?03-浠诲姟鍒嗚В.md`**
- 80+涓<EFBFBD><EFBFBD>缁嗕换鍔?
- 姣忎釜浠诲姟鐨勯獙鏀舵爣鍑?
### 📋 任务分解清单（15分钟）
**📄 `docs/03-业务模块/ASL-AI智能文献/04-开发计划/03-任务分解.md`**
- 80+个详细任务
- 每个任务的验收标准
- 第一个任务：T1.1.1 设计Prisma Schema
---
@@ -173,26 +173,26 @@ DeepSeek（经济）+ GPT-4o（质量）
### 文件路径
```bash
# 椤圭洰鏍圭洰褰?
# 项目根目录
D:\MyCursor\AIclinicalresearch\
# 核心文档
START-HERE-FOR-NEW-AI.md # 2鍒嗛挓蹇<EFBFBD>€熷惎鍔?猸?
START-HERE-FOR-NEW-AI.md # 2分钟快速启动 ⭐
docs/00-系统总体设计/
鈹斺攢鈹€ 00-绯荤粺褰撳墠鐘舵€佷笌寮€鍙戞寚鍗?md # 绯荤粺鍏ㄨ矊 猸愨瓙猸?
└── 00-系统当前状态与开发指南.md # 系统全貌 ⭐⭐⭐
# ASL寮€鍙戞枃妗?
# ASL开发文档
docs/03-业务模块/ASL-AI智能文献/
鈹溾攢鈹€ [AI瀵规帴] ASL妯″潡蹇<EFBFBD>€熶笂涓嬫枃.md # ASL蹇<EFBFBD>€熶笂鎵?猸愨瓙
鈹斺攢鈹€ 04-寮€鍙戣<E98D99>鍒?
鈹溾攢鈹€ 02-鏍囬<E98F8D>鎽樿<E98EBD>鍒濈瓫寮€鍙戣<E98D99>鍒?md # 璇︾粏璁″垝+浠ｇ爜 猸愨瓙猸?
├── [AI对接] ASL模块快速上下文.md # ASL快速上手 ⭐⭐
└── 04-开发计划/
├── 02-标题摘要初筛开发计划.md # 详细计划+代码 ⭐⭐⭐
└── 03-任务分解.md # 80+任务清单 ⭐⭐
# 平台基础设施
backend/src/common/ # 8个模块（storage/logging/cache/jobs等）
backend/src/common/llm/adapters/ # 5涓狶LM妯″瀷閫傞厤鍣?
backend/src/common/llm/adapters/ # 5个LLM模型适配器
# ASL寮€鍙戜綅缃?
# ASL开发位置
backend/src/modules/asl/ # 后端代码（空目录，待开发）
frontend-v2/src/modules/asl/ # 前端代码（占位，待开发）
backend/prisma/schema.prisma # 数据库Schema（待添加ASL表）
@@ -219,61 +219,61 @@ backend/prisma/schema.prisma # 数据库Schema（待添加ASL表
## ⚠️ 重要提醒（必须遵守）
### 鏍稿績鍘熷垯锛?鏉★級
### 核心原则（5条）
1. 鉁?**澶嶇敤骞冲彴鍩虹<E98DA9>璁炬柦** - storage/logger/cache/jobQueue
2. 鉁?**闆朵唬鐮佺幆澧冨垏鎹?* - 鐜<><E9909C>鍙橀噺鎺у埗
3. 鉁?**Schema闅旂<EFBFBD>** - 鎵€鏈夎〃 `@@schema("asl_schema")`
4. 鉁?**浜戝師鐢熶紭鍏?* - 鏃犵姸鎬併€佸紓姝ヤ换鍔°€佸唴瀛樿В鏋?
5. 鉁?**鎵归噺Git鎻愪氦** - 涓€澶╃粨鏉熷悗缁熶竴鎻愪氦
1. ✅ **复用平台基础设施** - storage/logger/cache/jobQueue
2. ✅ **零代码环境切换** - 环境变量控制
3. ✅ **Schema隔离** - 所有表 `@@schema("asl_schema")`
4. ✅ **云原生优先** - 无状态、异步任务、内存解析
5. ✅ **批量Git提交** - 一天结束后统一提交
### 禁止的操作（10条）
1. 鉂?棰戠箒Git鎻愪氦
2. 鉂?鏈<>湴鏂囦欢瀛樺偍锛坄fs.writeFileSync`锛?
3. 鉂?閲嶅<E996B2>瀹炵幇骞冲彴鏈嶅姟
4. 鉂?鍚屾<E98D9A>澶勭悊闀夸换鍔?
5. 鉂?纭<>紪鐮侀厤缃?
6. 鉂?鍒涘缓鏂癙risma瀹炰緥
7. 鉂?浣跨敤any绫诲瀷
8. 鉂?璺⊿chema鏌ヨ<EFBFBD>
9. 鉂?鎻愪氦鏈<E6B0A6>祴璇曚唬鐮?
10. 鉂?寮哄埗鎺ㄩ€佸埌master
1. ❌ 频繁Git提交
2. ❌ 本地文件存储（`fs.writeFileSync`）
3. ❌ 重复实现平台服务
4. ❌ 同步处理长任务
5. ❌ 硬编码配置
6. ❌ 创建新Prisma实例
7. ❌ 使用any类型
8. ❌ 跨Schema查询
9. ❌ 提交未测试代码
10. ❌ 强制推送到master
**璇︾粏璇存槑锛?* `docs/00-绯荤粺鎬讳綋璁捐<EFBFBD>/00-绯荤粺褰撳墠鐘舵€佷笌寮€鍙戞寚鍗?md` Part 3
**详细说明：** `docs/00-系统总体设计/00-系统当前状态与开发指南.md` Part 3
---
## 馃殌 鏂癆I鍚<49>姩娴佺▼锛?姝ワ級
## 🚀 新AI启动流程（3步）
### Step 1: 闃呰<EFBFBD>鍚<EFBFBD>姩鏂囨。锛?鍒嗛挓锛夆瓙
### Step 1: 阅读启动文档（2分钟）⭐
```bash
打开：START-HERE-FOR-NEW-AI.md
```
### Step 2: 闃呰<EFBFBD>绯荤粺鍏ㄨ矊锛?0鍒嗛挓锛夆瓙猸愨瓙
### Step 2: 阅读系统全貌（20分钟）⭐⭐⭐
```bash
鎵撳紑锛歞ocs/00-绯荤粺鎬讳綋璁捐<EFBFBD>/00-绯荤粺褰撳墠鐘舵€佷笌寮€鍙戞寚鍗?md
閲嶇偣闃呰<EFBFBD>锛?
打开：docs/00-系统总体设计/00-系统当前状态与开发指南.md
重点阅读：
- Part 1.3：平台基础设施（必读）
- LLM模型支持章节（必读）
- Part 2.3锛氫簯鍘熺敓寮€鍙戣<EFBFBD>鑼冿紙蹇呴』閬靛畧锛?
- Part 2.3：云原生开发规范（必须遵守）
- Part 3：重要原则与禁忌（必须遵守）
```
### Step 3: 鏌ョ湅ASL寮€鍙戣<EFBFBD>鍒掞紙15鍒嗛挓锛夆瓙猸?
### Step 3: 查看ASL开发计划（15分钟）⭐⭐
```bash
鎵撳紑锛歞ocs/03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/04-寮€鍙戣<E98D99>鍒?02-鏍囬<E98F8D>鎽樿<E98EBD>鍒濈瓫寮€鍙戣<E98D99>鍒?md
閲嶇偣鏌ョ湅锛?
打开：docs/03-业务模块/ASL-AI智能文献/04-开发计划/02-标题摘要初筛开发计划.md
重点查看：
- Week 1 Day 1：Prisma Schema代码（第299-402行）
- 浜戝師鐢熷紑鍙戞敞鎰忎簨椤癸紙绗?7-162琛岋級
- 云原生开发注意事项（第77-162行）
```
### Step 4: 寮€濮嬬<EFBFBD>涓€涓<EFBFBD>换鍔★紙2灏忔椂锛?
### Step 4: 开始第一个任务（2小时）
```bash
任务ID：T1.1.1 - 设计Prisma Schema
文件位置：backend/prisma/schema.prisma
鍙傝€冧唬鐮侊細02-鏍囬<E98F8D>鎽樿<E98EBD>鍒濈瓫寮€鍙戣<E98D99>鍒?md Week 1 Day 1
参考代码：02-标题摘要初筛开发计划.md Week 1 Day 1
```
---
@@ -294,9 +294,9 @@ const buffer = await storage.download('literature/123.pdf')
// 删除文件
await storage.delete('literature/123.pdf')
// 鐜<EFBFBD><EFBFBD>鍒囨崲锛堥浂浠ｇ爜锛?
// 鏈<EFBFBD>湴锛歋TORAGE_TYPE=local 鈫?瀛樺偍鍒?backend/uploads/
// 浜戠<EFBFBD>锛歋TORAGE_TYPE=oss 鈫?瀛樺偍鍒伴樋閲屼簯OSS
// 环境切换（零代码）
// 本地：STORAGE_TYPE=local → 存储到 backend/uploads/
// 云端：STORAGE_TYPE=oss → 存储到阿里云OSS
```
### 2. 日志系统（必须使用）
@@ -312,9 +312,9 @@ logger.error('Database error', { error: err.message })
const aslLogger = logger.child({ module: 'ASL', projectId: 456 })
aslLogger.info('Screening started', { count: 100 })
// 杈撳嚭鏍煎紡锛?
// 鏈<EFBFBD>湴锛氬僵鑹插彲璇绘牸寮?
// 鐢熶骇锛欽SON鏍煎紡锛堥樋閲屼簯SLS瑙ｆ瀽锛?
// 输出格式：
// 本地：彩色可读格式
// 生产：JSON格式（阿里云SLS解析）
```
### 3. 缓存服务（推荐使用）
@@ -340,16 +340,16 @@ return cached
```typescript
import { jobQueue } from '@/common/jobs'
// 鍒涘缓寮傛<EFBFBD>浠诲姟锛堢珛鍗宠繑鍥烇紝閬垮厤瓒呮椂锛?
// 创建异步任务（立即返回，避免超时）
const job = await jobQueue.push('asl:screening', {
projectId: 123,
literatureIds: [1, 2, 3, ..., 1000] // 大量数据
})
// 杩斿洖浠诲姟ID缁欏墠绔?
// 返回任务ID给前端
res.send({ jobId: job.id, status: 'processing' })
// 鍓嶇<EFBFBD>杞<EFBFBD><EFBFBD>浠诲姟鐘舵€?
// 前端轮询任务状态
const status = await jobQueue.getJob(job.id)
// { status: 'processing', progress: 45 }
```
@@ -359,18 +359,18 @@ const status = await jobQueue.getJob(job.id)
```typescript
import { LLMFactory } from '@/common/llm/adapters'
// 骞惰<EFBFBD>璋冪敤涓や釜妯″瀷锛?.8绉掑畬鎴愶級
// 并行调用两个模型（4.8秒完成）
const [deepseekResult, gpt4oResult] = await Promise.all([
LLMFactory.getAdapter('deepseek-v3').chat(messages),
LLMFactory.getAdapter('gpt-5').chat(messages) // 实际使用 gpt-4o
])
// 鍒ゆ柇涓€鑷存€?
// 判断一致性
if (deepseekResult.decision === gpt4oResult.decision) {
// 鍏辫瘑搴﹂珮锛岀洿鎺ラ噰绾?
// 共识度高，直接采纳
return { decision: deepseekResult.decision, consensus: 'high' }
} else {
// 涓嶄竴鑷达紝鍚<EFBFBD>敤Claude浠茶<EFBFBD>鎴栦汉宸ュ<EFBFBD>鏍?
// 不一致，启用Claude仲裁或人工复核
const claudeResult = await LLMFactory.getAdapter('claude-4.5').chat(messages)
return { decision: claudeResult.decision, consensus: 'medium', needReview: true }
}
@@ -380,19 +380,19 @@ if (deepseekResult.decision === gpt4oResult.decision) {
## 📊 代码统计
**骞冲彴鍩虹<EFBFBD>璁炬柦锛?025-11-17锛夛細**
- 鏂板<EFBFBD>鏂囦欢锛?2涓?
- 鏂板<EFBFBD>浠ｇ爜锛?,532琛?
**平台基础设施（2025-11-17）：**
- 新增文件：22个
- 新增代码：2,532行
- 测试覆盖率：100%
**CloseAI闆嗘垚锛?025-11-18锛夛細**
- 鏂板<EFBFBD>鏂囦欢锛?涓?
- 鏂板<EFBFBD>浠ｇ爜锛殈500琛?
- 娴嬭瘯閫氳繃锛?/4
**CloseAI集成（2025-11-18）：**
- 新增文件：4个
- 新增代码：~500行
- 测试通过：4/4
**鎬昏<EFBFBD>锛堜袱澶╁伐浣滐級锛?*
- 鏂板<EFBFBD>鏂囦欢锛?6涓?
- 鏂板<EFBFBD>浠ｇ爜锛殈3,000琛?
**总计（两天工作）：**
- 新增文件：26个
- 新增代码：~3,000行
- 测试状态：全部通过
---
@@ -400,36 +400,36 @@ if (deepseekResult.decision === gpt4oResult.decision) {
## 🔄 Git提交记录
**最后一次提交：** 2025-11-18
**鎻愪氦鍐呭<EFBFBD>锛?* 骞冲彴鍩虹<E98DA9>璁炬柦瀹炴柦瀹屾垚
**鎻愪氦绫诲瀷锛?* feat(platform): 瀹屾垚骞冲彴鍩虹<EFBFBD>璁炬柦8涓<EFBFBD>ā鍧?
**提交内容：** 平台基础设施实施完成
**提交类型：** feat(platform): 完成平台基础设施8个模块
**鈿狅笍 娉ㄦ剰锛?*
**⚠️ 注意：**
- CloseAI集成代码尚未提交到Git
- 绛堿SL妯″潡寮€鍙戜竴璧锋彁浜わ紙閬靛惊鎵归噺鎻愪氦鍘熷垯锛?
- 等ASL模块开发一起提交（遵循批量提交原则）
- 用户要求：一天工作结束后统一提交
---
## 馃幆 鏂癆I鐨勭<E990A8>涓€涓<E282AC>换鍔?
## 🎯 新AI的第一个任务
### 任务ID：T1.1.1 - 设计Prisma Schema
**浠诲姟鎻忚堪锛?* 鍦?`backend/prisma/schema.prisma` 涓<EFBFBD>畾涔?涓狝SL妯″瀷
**任务描述：** 在 `backend/prisma/schema.prisma` 中定义4个ASL模型
**鎵€闇€鏃堕棿锛?* 2灏忔椂
**所需时间：** 2小时
**鍙傝€冧唬鐮侊細** `docs/03-涓氬姟妯″潡/ASL-AI鏅鸿兘鏂囩尞/04-寮€鍙戣<E98D99>鍒?02-鏍囬<E98F8D>鎽樿<E98EBD>鍒濈瓫寮€鍙戣<E98D99>鍒?md` 绗?99-402琛?
**参考代码：** `docs/03-业务模块/ASL-AI智能文献/04-开发计划/02-标题摘要初筛开发计划.md` 第299-402行
**楠屾敹鏍囧噯锛?*
- [ ] 4涓<EFBFBD>ā鍨嬪畾涔夊畬鎴愶紙AslScreeningProject, AslLiterature, AslScreeningResult, AslScreeningTask锛?
**验收标准：**
- [ ] 4个模型定义完成（AslScreeningProject, AslLiterature, AslScreeningResult, AslScreeningTask）
- [ ] 每个模型包含 `@@schema("asl_schema")`
- [ ] 涓嶶ser妯″瀷鐨勫叧鑱斿畾涔?
- [ ] 鍖呭惈OSS鐩稿叧瀛楁<EFBFBD>锛坧dfUrl, pdfOssKey, pdfFileSize锛?
- [ ] 与User模型的关联定义
- [ ] 包含OSS相关字段（pdfUrl, pdfOssKey, pdfFileSize）
- [ ] 迁移成功：`npx prisma migrate dev`
- [ ] 客户端生成：`npx prisma generate`
- [ ] 类型检查通过
**鎵ц<EFBFBD>鍛戒护锛?*
**执行命令：**
```bash
cd backend
npx prisma migrate dev --name add_asl_screening_tables
@@ -440,7 +440,7 @@ npx prisma generate
## 💡 常见问题预判
**Q1锛氬墠鍚庣<EFBFBD>鏈嶅姟濡備綍鍚<EFBFBD>姩锛?*
**Q1：前后端服务如何启动？**
```bash
# 后端
cd backend
@@ -451,99 +451,99 @@ cd frontend-v2
npm run dev # http://localhost:5173
```
**Q2锛氬<EFBFBD>浣曟祴璇曞钩鍙板熀纭€璁炬柦锛?*
**Q2：如何测试平台基础设施？**
```bash
# 访问测试API
curl http://localhost:3001/test/platform
# 鎴栬繍琛屾祴璇曡剼鏈?
# 或运行测试脚本
cd backend
npx tsx src/scripts/test-platform-infrastructure.ts
```
**Q3锛氬<EFBFBD>浣曟祴璇旵loseAI闆嗘垚锛?*
**Q3：如何测试CloseAI集成？**
```bash
cd backend
npx tsx src/scripts/test-closeai.ts
# 棰勬湡锛?涓<>祴璇曞叏閮ㄩ€氳繃锛屾€昏€楁椂<10绉?
# 预期：4个测试全部通过，总耗时<10秒
```
**Q4锛氭暟鎹<EFBFBD>簱濡備綍杩炴帴锛?*
**Q4：数据库如何连接？**
```bash
# .env 鏂囦欢宸查厤缃?
# .env 文件已配置
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/ai_clinical
# Prisma Studio锛堟煡鐪嬫暟鎹<EFBFBD>簱锛?
# Prisma Studio（查看数据库）
cd backend
npx prisma studio
```
**Q5：如何查看日志？**
```bash
# 鍚庣<EFBFBD>鎺у埗鍙颁細杈撳嚭缁撴瀯鍖栨棩蹇?
# 鏈<EFBFBD>湴锛氬僵鑹插彲璇绘牸寮?
# 后端控制台会输出结构化日志
# 本地：彩色可读格式
# 生产：JSON格式
```
---
## 馃搶 寮€鍙戞敞鎰忎簨椤?
## 📌 开发注意事项
### 浜戝師鐢熷紑鍙戣<EFBFBD>姹傦紙蹇呴』閬靛畧锛?
### 云原生开发要求（必须遵守）
1. 鉁?Excel蹇呴』鍐呭瓨瑙ｆ瀽锛堜笉钀界洏锛?
1. ✅ Excel必须内存解析（不落盘）
```typescript
const workbook = xlsx.read(buffer, { type: 'buffer' })
```
2. 鉁?LLM鎵归噺浠诲姟蹇呴』寮傛<EFBFBD>澶勭悊
2. ✅ LLM批量任务必须异步处理
```typescript
const job = await jobQueue.push('asl:screening', data)
```
3. 鉁?鏂囦欢涓婁紶浣跨敤瀛樺偍鏈嶅姟
3. ✅ 文件上传使用存储服务
```typescript
await storage.upload('literature/file.pdf', buffer)
```
4. 鉁?浣跨敤鍏ㄥ眬Prisma瀹炰緥
4. ✅ 使用全局Prisma实例
```typescript
import { prisma } from '@/config/database'
```
5. 鉁?缁撴瀯鍖栨棩蹇楄緭鍑?
5. ✅ 结构化日志输出
```typescript
logger.info('Operation', { userId, action })
```
### Git提交要求（必须遵守）
1. 鉁?涓€澶╁伐浣滅粨鏉熷悗缁熶竴鎻愪氦锛堜笉瑕侀<E79195>绻佹彁浜わ級
2. 鉁?蹇呴』娴嬭瘯楠岃瘉鍚庢墠鑳芥彁浜?
3. 鉁?Commit Message鏍煎紡锛歚feat(asl): 鎻忚堪`
1. ✅ 一天工作结束后统一提交（不要频繁提交）
2. ✅ 必须测试验证后才能提交
3. ✅ Commit Message格式：`feat(asl): 描述`
---
## 🎉 交接完成
**鍓嶄换AI宸ヤ綔鎴愭灉锛?*
- 鉁?骞冲彴鍩虹<E98DA9>璁炬柦锛?涓<>ā鍧楋級
- 鉁?CloseAI闆嗘垚锛圙PT-4o + Claude锛?
- 鉁?鎬ц兘浼樺寲锛?5鍊嶆彁鍗囷級
- 鉁?瀹屾暣鏂囨。浣撶郴
**前任AI工作成果：**
- ✅ 平台基础设施（8个模块）
- ✅ CloseAI集成（GPT-4o + Claude）
- ✅ 性能优化（25倍提升）
- ✅ 完整文档体系
**鍚庝换AI宸ヤ綔璧风偣锛?*
- 馃殌 鎵€鏈変緷璧栧氨缁?
**后任AI工作起点：**
- 🚀 所有依赖就绪
- 🚀 5个LLM模型可用
- 🚀 平台服务完整
- 🚀 详细文档指导
- 馃殌 绗<>竴涓<E7ABB4>换鍔℃槑纭?
- 🚀 第一个任务明确
**绁濆紑鍙戦『鍒╋紒浠?T1.1.1 寮€濮嬪惂锛?* 馃殌
**祝开发顺利！从 T1.1.1 开始吧！** 🚀
---
**鏂囨。璺<EFBFBD>緞锛?* `AIclinicalresearch/docs/08-椤圭洰绠＄悊/03-姣忓懆璁″垝/2025-11-18-AI鍔╂墜宸ヤ綔浜ゆ帴.md`
**文档路径：** `AIclinicalresearch/docs/08-项目管理/03-每周计划/2025-11-18-AI助手工作交接.md`
**最后更新：** 2025-11-18
**维护者：** AI助手