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

334
docs/09-架构实施/后端架构增量演进方案.md
View File

@@ -1,126 +1,126 @@
# 后端架构增量演进方案
> **<EFBFBD><EFBFBD>𧋦嚗?* V1.0
> **<EFBFBD>𥕦遣<EFBFBD>交<EFBFBD>嚗?* 2025-11-14
> **蝑𣇉裦嚗?* <20>唳唂撟嗅<E6929F>嚗<EFBFBD><E59A97><EFBFBD>𤩺<EFBFBD>餈?
> **<EFBFBD>笔<EFBFBD>嚗?* <20>園<EFBFBD><E59C92>拇㺿<E68B87>𩤃<EFBFBD><F0A9A483>唳芋<E594B3>埈鰵<E59F88>嗆<EFBFBD>
> **版本：** V1.0
> **创建日期：** 2025-11-14
> **策略：** 新旧并存，增量演进
> **原则：** 零风险改造，新模块新架构
---
## 🎯 核心策略
### "蝏墧<EFBFBD><EFBFBD><EFBFBD>芋撘?嚗𠄎trangler Fig Pattern嚗?
### "绞杀者模式"（Strangler Fig Pattern）
**銝齿㺿<EFBFBD>䭾唂隞<EFBFBD><EFBFBD>嚗峕鰵<EFBFBD>蠘<EFBFBD><EFBFBD>唳沲<EFBFBD>?*
**不改造旧代码，新功能新架构**
```
<EFBFBD>𢞖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? AI銝游<EFBFBD><EFBFBD>𠉛弦撟喳蝱 - Backend <EFBFBD>?
<EFBFBD>鎿<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? <EFBFBD>?
<EFBFBD>? <20>𢞖<EFBFBD><F0A29E96><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? <20>𢞖<EFBFBD><F0A29E96><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? <20>?
<EFBFBD>? <20>? <20>唳<EFBFBD>璅∪<E79285> <EFBFBD>? <EFBFBD>? <20>唳芋<E594B3>? <20>? <20>?
<EFBFBD>? <20>? (<28>扳沲<E689B3>? <EFBFBD>? <EFBFBD>? (<EFBFBD>唳沲<EFBFBD>? <EFBFBD>? <20>?
<EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? <20>?
<EFBFBD>? <20>?<3F>?AIA <EFBFBD>? <20>?<3F>?ASL (<EFBFBD>? <EFBFBD>? <20>?
<EFBFBD>? <20>?<3F>?PKB <EFBFBD>? <EFBFBD>?<3F>?<3F>芣䔉璅∪<E79285>... <EFBFBD>? <20>?
<EFBFBD>? <20>?<3F>?RVW <EFBFBD>? <EFBFBD>? <EFBFBD>? <20>?
<EFBFBD>? <20>婙<EFBFBD><E5A999><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? <20>婙<EFBFBD><E5A999><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? <20>?
<EFBFBD>? <EFBFBD>? <EFBFBD>? <EFBFBD>?
<EFBFBD>? 撟喲唍蝏𤘪<EFBFBD> platform/common/modules <EFBFBD>?
<EFBFBD>? 靽脲<EFBFBD>銝滚<EFBFBD> <EFBFBD><EFBFBD><EFBFBD><EFBFBD>碶<EFBFBD>撅<EFBFBD>沲<EFBFBD>? <EFBFBD>?
<EFBFBD>婙<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
┌─────────────────────────────────────────────────────┐
│ AI临床研究平台 - Backend │
├─────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────────┐ │
│ │ 现有模块 │ │ 新模块 │ │
│ │ (旧架构) │ │ (新架构) │ │
│ ├──────────────┤ ├──────────────────┤ │
│ │ • AIA │ │ • ASL (新) │ │
│ │ • PKB │ │ • 未来模块... │ │
│ │ • RVW │ │ │ │
│ └──────────────┘ └──────────────────┘ │
│ ↓ ↓ │
│ 平铺结构 platform/common/modules │
│ 保持不变 标准化三层架构 │
└─────────────────────────────────────────────────────┘
```
---
## <EFBFBD><EFBFBD> <20>啁<EFBFBD><E59581>桀<EFBFBD>蝏𤘪<E89D8F>嚗<EFBFBD>僎摮条<E691AE>嚗?
## 📁 新的目录结构（并存版）
```
backend/
├── src/
<EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD> index.ts # 銝餃<EFBFBD><EFBFBD><EFBFBD><EFBFBD>瘜典<EFBFBD><EFBFBD><EFBFBD><EFBFBD>㗇芋<EFBFBD>梹<EFBFBD>
<EFBFBD>? <20>?
<EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD> config/ # <EFBFBD>𣂼<EFBFBD><EFBFBD>具<EFBFBD>煾<EFBFBD>蝵桀<EFBFBD>
<EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> env.ts
<EFBFBD>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> database.ts
<EFBFBD>? <20>?
<EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD> legacy/ # <EFBFBD>璛 <20>唳<EFBFBD>隞<EFBFBD><E99A9E>嚗<EFBFBD>唂<EFBFBD>嗆<EFBFBD>嚗?
<EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> routes/
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> agents.ts # AIA 頝舐眏
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> conversations.ts
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> chatRoutes.ts
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> projects.ts
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> knowledgeBases.ts # PKB 頝舐眏
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> batchRoutes.ts
<EFBFBD>? <20>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> reviewRoutes.ts # RVW 頝舐眏
<EFBFBD>? <20>? <20>?
<EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> controllers/
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> agentController.ts
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> conversationController.ts
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> chatController.ts
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> knowledgeBaseController.ts
<EFBFBD>? <20>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> reviewController.ts
<EFBFBD>? <20>? <20>?
<EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> services/
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> agentService.ts
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> conversationService.ts
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> knowledgeBaseService.ts
<EFBFBD>? <20>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> reviewService.ts
<EFBFBD>? <20>? <20>?
<EFBFBD>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> templates/
<EFBFBD>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> clinicalResearch.ts
<EFBFBD>? <20>?
<EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD> common/ # <EFBFBD>𣂼<EFBFBD><EFBFBD>具<EFBFBD>煾<EFBFBD>𡁶鍂<EFBFBD>賢<EFBFBD>撅?
<EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> llm/ # LLM <EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
<EFBFBD>? <20>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> adapters/
<EFBFBD>? <20>? <20>? <EFBFBD>鎿<EFBFBD><EFBFBD><EFBFBD> DeepSeekAdapter.ts
<EFBFBD>? <20>? <20>? <EFBFBD>鎿<EFBFBD><EFBFBD><EFBFBD> QwenAdapter.ts
<EFBFBD>? <20>? <20>? <EFBFBD>鎿<EFBFBD><EFBFBD><EFBFBD> LLMFactory.ts
<EFBFBD>? <20>? <20>? <EFBFBD>婙<EFBFBD><EFBFBD><EFBFBD> types.ts
<EFBFBD>? <20>? <20>?
<EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> rag/ # RAG <EFBFBD>賢<EFBFBD>
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> DifyClient.ts
<EFBFBD>? <20>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> types.ts
<EFBFBD>? <20>? <20>?
<EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> document/ # <EFBFBD><EFBFBD>﹝憭<EFBFBD><EFBFBD>
<EFBFBD>? <20>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> ExtractionClient.ts
<EFBFBD>? <20>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> TokenService.ts
<EFBFBD>? <20>? <20>?
<EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> middleware/ # 銝剝𡢿隞?
<EFBFBD>? <20>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> validateProject.ts
<EFBFBD>? <20>? <20>?
<EFBFBD>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> utils/ # 撌亙<EFBFBD><EFBFBD>賣㺭
<EFBFBD>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> jsonParser.ts
<EFBFBD>? <20>?
<EFBFBD>? <20>婙<EFBFBD><E5A999><EFBFBD> modules/ # <EFBFBD><EFBFBD> <20>唳沲<E594B3><E6B2B2>芋<EFBFBD>梹<EFBFBD><E6A2B9><EFBFBD><EFBFBD><EFBFBD>吔<EFBFBD>
<EFBFBD>? <EFBFBD>?
<EFBFBD>? <EFBFBD>鎿<EFBFBD><EFBFBD><EFBFBD> asl/ # 潃?AI<41>箄<EFBFBD><E7AE84><EFBFBD>讃嚗<E8AE83>鰵璅∪<E79285>嚗?
<EFBFBD>? <EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD> index.ts # 璅∪<EFBFBD>撖澆枂
<EFBFBD>? <EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD> routes/
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> index.ts # 頝舐眏蝏煺<EFBFBD>撖澆枂
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> projects.ts # 憿寧𤌍蝞∠<EFBFBD>
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> screening.ts # <EFBFBD><EFBFBD>讃蝑偦<EFBFBD>?
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> extraction.ts # <EFBFBD>唳旿<EFBFBD>𣂼<EFBFBD>
<EFBFBD>? <EFBFBD>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> analysis.ts # 蝏澆<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
<EFBFBD>? <20>? <20>?
<EFBFBD>? <EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD> controllers/
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> projectController.ts
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> screeningController.ts
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> extractionController.ts
<EFBFBD>? <EFBFBD>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> analysisController.ts
<EFBFBD>? <20>? <20>?
<EFBFBD>? <EFBFBD>? <20>鎿<EFBFBD><E98EBF><EFBFBD> services/
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> projectService.ts
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> screeningService.ts
<EFBFBD>? <EFBFBD>? <20>? <20>鎿<EFBFBD><E98EBF><EFBFBD> extractionService.ts
<EFBFBD>? <EFBFBD>? <20>? <20>婙<EFBFBD><E5A999><EFBFBD> analysisService.ts
<EFBFBD>? <20>? <20>?
<EFBFBD>? <EFBFBD>? <20>婙<EFBFBD><E5A999><EFBFBD> types/ # 璅∪<EFBFBD>蝐餃<EFBFBD>摰帋<EFBFBD>
<EFBFBD>? <EFBFBD>? <EFBFBD>婙<EFBFBD><EFBFBD><EFBFBD> index.ts
<EFBFBD>? <EFBFBD>?
<EFBFBD>? <EFBFBD>婙<EFBFBD><EFBFBD><EFBFBD> [<5B>芣䔉璅∪<E79285>]/ # <EFBFBD>芣䔉<EFBFBD><EFBFBD>鰵璅∪<EFBFBD><EFBFBD>賣<EFBFBD>甇斤<EFBFBD><EFBFBD>?
<EFBFBD>?
│ ├── index.ts # 主入口（注册所有模块）
│ │
│ ├── config/ # 【共用】配置层
│ │ ├── env.ts
│ │ └── database.ts
│ │
│ ├── legacy/ # 🔸 现有代码（旧架构）
│ │ ├── routes/
│ │ │ ├── agents.ts # AIA 路由
│ │ │ ├── conversations.ts
│ │ │ ├── chatRoutes.ts
│ │ │ ├── projects.ts
│ │ │ ├── knowledgeBases.ts # PKB 路由
│ │ │ ├── batchRoutes.ts
│ │ │ └── reviewRoutes.ts # RVW 路由
│ │ │
│ │ ├── controllers/
│ │ │ ├── agentController.ts
│ │ │ ├── conversationController.ts
│ │ │ ├── chatController.ts
│ │ │ ├── knowledgeBaseController.ts
│ │ │ └── reviewController.ts
│ │ │
│ │ ├── services/
│ │ │ ├── agentService.ts
│ │ │ ├── conversationService.ts
│ │ │ ├── knowledgeBaseService.ts
│ │ │ └── reviewService.ts
│ │ │
│ │ └── templates/
│ │ └── clinicalResearch.ts
│ │
│ ├── common/ # 【共用】通用能力层
│ │ ├── llm/ # LLM 适配器
│ │ │ └── adapters/
│ │ │ ├── DeepSeekAdapter.ts
│ │ │ ├── QwenAdapter.ts
│ │ │ ├── LLMFactory.ts
│ │ │ └── types.ts
│ │ │
│ │ ├── rag/ # RAG 能力
│ │ │ ├── DifyClient.ts
│ │ │ └── types.ts
│ │ │
│ │ ├── document/ # 文档处理
│ │ │ ├── ExtractionClient.ts
│ │ │ └── TokenService.ts
│ │ │
│ │ ├── middleware/ # 中间件
│ │ │ └── validateProject.ts
│ │ │
│ │ └── utils/ # 工具函数
│ │ └── jsonParser.ts
│ │
│ └── modules/ # 🌟 新架构模块（标准化）
│ │
│ ├── asl/ # ⭐ AI智能文献（新模块）
│ │ ├── index.ts # 模块导出
│ │ ├── routes/
│ │ │ ├── index.ts # 路由统一导出
│ │ │ ├── projects.ts # 项目管理
│ │ │ ├── screening.ts # 文献筛选
│ │ │ ├── extraction.ts # 数据提取
│ │ │ └── analysis.ts # 综合分析
│ │ │
│ │ ├── controllers/
│ │ │ ├── projectController.ts
│ │ │ ├── screeningController.ts
│ │ │ ├── extractionController.ts
│ │ │ └── analysisController.ts
│ │ │
│ │ ├── services/
│ │ │ ├── projectService.ts
│ │ │ ├── screeningService.ts
│ │ │ ├── extractionService.ts
│ │ │ └── analysisService.ts
│ │ │
│ │ └── types/ # 模块类型定义
│ │ └── index.ts
│ │
│ └── [未来模块]/ # 未来的新模块都按此结构
│
├── package.json
├── tsconfig.json # TypeScript 配置
└── .env
@@ -128,14 +128,14 @@ backend/
---
## <EFBFBD><EFBFBD> 銝餃<E98A9D><E9A483><EFBFBD><EFBFBD>隞塚<E99A9E>index.ts嚗?
## 🔄 主入口文件（index.ts）
```typescript
/**
* AI临床研究平台 - 统一入口
*
* <EFBFBD>嗆<EFBFBD>瞍磰<EFBFBD>蝑𣇉裦嚗𡁏鰵<EFBFBD>批僎摮?
* - Legacy 璅∪<EFBFBD>嚗帋<EFBFBD><EFBFBD><EFBFBD>緵<EFBFBD>厩<EFBFBD><EFBFBD>?
* 架构演进策略：新旧并存
* - Legacy 模块：保持现有结构
* - New 模块：采用标准化三层架构
*/
@@ -159,7 +159,7 @@ import reviewRoutes from './legacy/routes/reviewRoutes.js';
// ============================================
// 【新架构】标准化模块
// ============================================
import { aslRoutes } from './modules/asl/routes/index.js'; // ASL 璅∪<EFBFBD>嚗<EFBFBD>鰵嚗?
import { aslRoutes } from './modules/asl/routes/index.js'; // ASL 模块（新）
const fastify = Fastify({ logger: true });
@@ -167,7 +167,7 @@ const fastify = Fastify({ logger: true });
await fastify.register(cors, { origin: true });
await fastify.register(multipart, { limits: { fileSize: 10 * 1024 * 1024 } });
// <EFBFBD>亙熒璉<EFBFBD><EFBFBD>?
// 健康检查
fastify.get('/health', async () => ({
status: 'ok',
architecture: 'hybrid', // 混合架构
@@ -178,7 +178,7 @@ fastify.get('/health', async () => ({
}));
// ============================================
// 瘜典<EFBFBD> Legacy 璅∪<EFBFBD>頝舐眏嚗<EFBFBD>唂<EFBFBD>嗆<EFBFBD>嚗?
// 注册 Legacy 模块路由（旧架构）
// ============================================
console.log('\n📦 加载 Legacy 模块...');
await fastify.register(projectRoutes, { prefix: '/api/v1/aia' });
@@ -188,16 +188,16 @@ await fastify.register(chatRoutes, { prefix: '/api/v1/aia' });
await fastify.register(knowledgeBaseRoutes, { prefix: '/api/v1/pkb' });
await fastify.register(batchRoutes, { prefix: '/api/v1/pkb' });
await fastify.register(reviewRoutes, { prefix: '/api/v1/rvw' });
console.log('<EFBFBD>?Legacy 璅∪<EFBFBD><EFBFBD>㰘蝸摰峕<EFBFBD>嚗㇁IA, PKB, RVW嚗?);
console.log('✅ Legacy 模块加载完成（AIA, PKB, RVW）');
// ============================================
// 瘜典<E7989C><E585B8>唳沲<E594B3><E6B2B2>芋<EFBFBD>𡑒楝<F0A19192>?
// 注册新架构模块路由
// ============================================
console.log('\n<EFBFBD><EFBFBD> <EFBFBD>㰘蝸<EFBFBD>唳沲<EFBFBD><EFBFBD>芋<EFBFBD>?..');
console.log('\n🌟 加载新架构模块...');
await fastify.register(aslRoutes, { prefix: '/api/v1/asl' });
console.log('<EFBFBD>?<EFBFBD>唳沲<EFBFBD><EFBFBD>芋<EFBFBD>堒<EFBFBD>頧賢<EFBFBD><EFBFBD>琜<EFBFBD>ASL嚗?);
console.log('✅ 新架构模块加载完成（ASL）');
// <EFBFBD>臬𢆡<EFBFBD>滚𦛚<EFBFBD>?
// 启动服务器
async function start() {
try {
validateEnv();
@@ -205,16 +205,16 @@ async function start() {
await fastify.listen({ port: config.port, host: config.host });
console.log('\n' + '='.repeat(60));
console.log('<EFBFBD><EFBFBD> AI銝游<EFBFBD><EFBFBD>𠉛弦撟喳蝱<EFBFBD>臬𢆡<EFBFBD>𣂼<EFBFBD>嚗?);
console.log('🚀 AI临床研究平台启动成功！');
console.log('='.repeat(60));
console.log(`📍 服务地址: http://${config.host}:${config.port}`);
console.log('\n📦 模块架构:');
console.log(' 🔸 Legacy 架构: AIA, PKB, RVW (稳定运行)');
console.log(' <EFBFBD><EFBFBD> <EFBFBD>唳沲<EFBFBD>? ASL (<EFBFBD><EFBFBD><EFBFBD><EFBFBD>𡝗芋<EFBFBD>?');
console.log(' 🌟 新架构: ASL (标准化模块)');
console.log('='.repeat(60) + '\n');
} catch (error) {
console.error('<EFBFBD>?<EFBFBD>臬𢆡憭梯揖:', error);
console.error('❌ 启动失败:', error);
await prisma.$disconnect();
process.exit(1);
}
@@ -225,16 +225,16 @@ start();
---
## <EFBFBD><EFBFBD> <20>唳芋<E594B3>堒<EFBFBD><E5A092>烐<EFBFBD><E78390>梹<EFBFBD>ASL 銝箔<E98A9D>嚗?
## 🌟 新模块开发指南（ASL 为例）
### 1. 创建模块骨架
```bash
# 銝<EFBFBD>甈⊥<EFBFBD>批<EFBFBD>撱箸<EFBFBD><EFBFBD>厩𤌍敶?
# 一次性创建所有目录
mkdir -p backend/src/modules/asl/{routes,controllers,services,types}
```
### 2. <EFBFBD>𥕦遣璅∪<EFBFBD>撖澆枂嚗ǎndex.ts嚗?
### 2. 创建模块导出（index.ts）
```typescript
// backend/src/modules/asl/index.ts
@@ -265,7 +265,7 @@ export async function aslRoutes(fastify: FastifyInstance) {
await fastify.register(extractionRoutes); // /extraction
await fastify.register(analysisRoutes); // /analysis
console.log('<EFBFBD>?ASL 璅∪<EFBFBD>頝舐眏瘜典<EFBFBD>摰峕<EFBFBD>');
console.log('✅ ASL 模块路由注册完成');
}
```
@@ -288,7 +288,7 @@ export class ProjectController {
console.error('获取项目列表失败:', error);
return reply.status(500).send({
success: false,
message: error instanceof Error ? error.message : '<EFBFBD>滚𦛚<EFBFBD>券<EFBFBD>霂?
message: error instanceof Error ? error.message : '服务器错误'
});
}
}
@@ -317,7 +317,7 @@ export const projectController = new ProjectController();
}
```
**雿輻鍂蝷箔<EFBFBD>嚗?*
**使用示例：**
```typescript
// 新模块中导入通用能力
@@ -331,120 +331,120 @@ import { agentService } from '../services/agentService.js';
---
## <EFBFBD><EFBFBD> 摰墧鴌甇仿炊嚗<E7828A>妟憌𡡞埯嚗?
## 📋 实施步骤（零风险）
### 蝚?1 甇伐<E79487><E4BC90><EFBFBD>辣<EFBFBD>滨<EFBFBD>嚗?<3F><><EFBFBD>嚗争<E59A97>
### 第 1 步：文件重组（5分钟）⭐
```bash
# 1. 创建 legacy 目录
mkdir backend/src/legacy
# 2. 蝘餃𢆡<EFBFBD>唳<EFBFBD>隞<EFBFBD><EFBFBD><EFBFBD>?legacy嚗<79><E59A97><EFBFBD><EFBFBD>㮾撖寡楝敺<E6A59D><E695BA><EFBFBD>矋<EFBFBD>
# 2. 移动现有代码到 legacy（保持相对路径不变）
mv backend/src/routes backend/src/legacy/
mv backend/src/controllers backend/src/legacy/
mv backend/src/services backend/src/legacy/
mv backend/src/templates backend/src/legacy/
# 3. <EFBFBD>𥕦遣<EFBFBD>唳沲<EFBFBD><EFBFBD>𤌍敶?
# 3. 创建新架构目录
mkdir -p backend/src/modules/asl/{routes,controllers,services,types}
```
**撉諹<EFBFBD>嚗?* <20>𣳇<EFBFBD>靽格㺿隞颱<E99A9E>隞<EFBFBD><E99A9E>嚗<EFBFBD>蘨<EFBFBD>舐宏<E88890>函𤌍敶蓥<E695B6>蝵?
**验证：** 无需修改任何代码，只是移动目录位置
---
### 蝚?2 甇伐<E79487><E4BC90>湔鰵銝餃<E98A9D><E9A483><EFBFBD><EFBFBD>5<EFBFBD><35><EFBFBD>嚗?
### 第 2 步：更新主入口（5分钟）
<EFBFBD>芯耨<EFBFBD>?`src/index.ts` <EFBFBD><EFBFBD>紡<EFBFBD>亥楝敺<EFBFBD><EFBFBD>
只修改 `src/index.ts` 的导入路径：
```typescript
// 旧：from './routes/agents.js'
// 新：from './legacy/routes/agents.js'
```
**撉諹<EFBFBD>嚗?* `npm run dev` <EFBFBD>滚𦛚<EFBFBD>冽迤撣詨鍳<EFBFBD>?
**验证：** `npm run dev` 服务器正常启动
---
### 蝚?3 甇伐<E79487><E4BC90>滨蔭 TSConfig嚗?<3F><><EFBFBD>嚗?
### 第 3 步：配置 TSConfig（2分钟）
瘛餃<EFBFBD>頝臬<EFBFBD><EFBFBD>怠<EFBFBD><EFBFBD>滨蔭<EFBFBD>?
添加路径别名配置。
**撉諹<EFBFBD>嚗?* IDE <20>質<EFBFBD><E8B3AA>?`@legacy/*`, `@modules/*` 蝑㕑楝敺?
**验证：** IDE 能识别 `@legacy/*`, `@modules/*` 等路径
---
### 蝚?4 甇伐<E79487>撘<EFBFBD><E69298>?ASL 璅∪<E79285>嚗<EFBFBD>鰵<EFBFBD>蠘<EFBFBD>嚗?
### 第 4 步：开发 ASL 模块（新功能）
<EFBFBD>㗇鰵<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD><EFBFBD>撘<EFBFBD><EFBFBD>𡢅<EFBFBD>摰<EFBFBD><EFBFBD>銝滚蔣<EFBFBD>滨緵<EFBFBD>㗇芋<EFBFBD>𨰜<EFBFBD>?
按新架构标准开发，完全不影响现有模块。
---
## <EFBFBD>?<3F>寞<EFBFBD>隡睃飵
## ✅ 方案优势
### 1. **<EFBFBD>園<EFBFBD><EFBFBD>拇㺿<EFBFBD>?*
- <EFBFBD>?<3F>唳<EFBFBD>隞<EFBFBD><E99A9E><EFBFBD>芰宏<E88AB0>函𤌍敶𤏪<E695B6>銝滢耨<E6BBA2>孵<EFBFBD>摰?
- <EFBFBD>?<3F>芣㺿銝<E3BABF>銝芣<E98A9D>隞嗥<E99A9E>撖澆<E69296>頝臬<E9A09D>
- <EFBFBD>?<3F>舫<EFBFBD><E888AB>嗅<EFBFBD>皛?
### 1. **零风险改造**
- ✅ 现有代码只移动目录，不修改内容
- ✅ 只改一个文件的导入路径
- ✅ 可随时回滚
### 2. **皜<EFBFBD>苊<EFBFBD><EFBFBD>沲<EFBFBD><EFBFBD>器<EFBFBD>?*
### 2. **清晰的架构边界**
```
legacy/ <EFBFBD>?<3F>找誨<E689BE><E8AAA8><EFBFBD><EFBFBD>𡒊＆<F0A1928A><EFBC86><EFBFBD>
modules/ <EFBFBD>?<3F>唬誨<E594AC><E8AAA8><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
legacy/ ← 旧代码，明确标识
modules/ ← 新代码，标准化
```
### 3. **新模块新架构**
- <EFBFBD>?ASL <EFBFBD>湔𦻖<EFBFBD>㗇<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
- <EFBFBD>?<3F>𣂷蛹<F0A382B7>芣䔉璅∪<E79285><E288AA><EFBFBD><EFBFBD><EFBFBD>?
- <EFBFBD>?銝滚<E98A9D><E6BB9A>找誨<E689BE><E8AAA8>漲<EFBFBD>?
- ✅ ASL 直接按标准实施
- ✅ 成为未来模块的范本
- ✅ 不受旧代码约束
### 4. **平滑演进路径**
```
<EFBFBD>啣銁嚗?銝芣唂璅∪<E79285> + 0銝芣鰵璅∪<E79285>
<EFBFBD>芣䔉嚗?銝芣唂璅∪<E79285> + 1銝芣鰵璅∪<E79285>嚗㇁SL嚗?
<EFBFBD>渲<EFBFBD>嚗?銝芣唂璅∪<E79285> + N銝芣鰵璅∪<E79285>
现在：7个旧模块 + 0个新模块
未来：7个旧模块 + 1个新模块（ASL）
更远：7个旧模块 + N个新模块
最终：按需逐步迁移旧模块（可选）
```
---
## <EFBFBD>㴓 瞍磰<E79E8D><E7A3B0>園𡢿頧?
## 🎯 演进时间轴
| 阶段 | 时间 | 工作内容 | 风险 |
|------|------|---------|------|
| **今天** | 15分钟 | 重组目录+更新入口 | 极低 |
| **Week 3** | - | 撘<EFBFBD><EFBFBD>?ASL 璅∪<E79285>嚗<EFBFBD>鰵<EFBFBD>嗆<EFBFBD>嚗?| <20>𩤃<EFBFBD><F0A9A483>啣<EFBFBD><E595A3>踝<EFBFBD> |
| **Week 4+** | - | 蝏抒賒撘<EFBFBD><EFBFBD>烐鰵璅∪<EFBFBD> | <EFBFBD>?|
| **Week 3** | - | 开发 ASL 模块（新架构） | 无（新功能） |
| **Week 4+** | - | 继续开发新模块 | 无 |
| **未来** | 按需 | 逐步迁移旧模块（可选） | 可控 |
---
## <EFBFBD><EFBFBD> 撘<><E69298>𤏸<EFBFBD><F0A48FB8>?
## 📝 开发规范
### Legacy 模块规范
- <EFBFBD>𩤃<EFBFBD> **銝滢蜓<E6BBA2>其耨<E585B6>?*嚗屸膄<E5B1B8>硺耨憭嵖ug
- ⚠️ **不主动修改**，除非修复bug
- ⚠️ 保持现有结构不变
- ⚠️ 可以引用 `common/` 层的能力
### <EFBFBD>唳芋<EFBFBD>𡑒<EFBFBD><EFBFBD>?
- <EFBFBD>?敹<>◆<EFBFBD>㗇<EFBFBD><E39787><EFBFBD><EFBFBD>撅<EFBFBD>沲<EFBFBD>?
- <EFBFBD>?敹<>◆雿輻鍂頝臬<E9A09D><E887AC>怠<EFBFBD>
- <EFBFBD>?敹<>◆<EFBFBD>祉<EFBFBD><E7A589>舫<EFBFBD>蝵?
- <EFBFBD>?敹<>◆<EFBFBD>匧<EFBFBD><E58CA7>渡<EFBFBD>蝐餃<E89D90>摰帋<E691B0>
### 新模块规范
- ✅ 必须按标准三层架构
- ✅ 必须使用路径别名
- ✅ 必须独立可部署
- ✅ 必须有完整的类型定义
---
## <EFBFBD><EFBFBD> 銝衤<E98A9D>甇亥<E79487><E4BAA5>?
## 🚀 下一步行动
1. **隞𠰴予嚗?5<><35><EFBFBD>嚗?*嚗𡁏<E59A97>銵𣬚洵1-3甇伐<E79487>摰峕<E691B0><E5B395>桀<EFBFBD><E6A180>滨<EFBFBD>
2. **<EFBFBD>𤾸予**嚗𡁜<E59A97>憪?ASL 璅∪<E79285>撘<EFBFBD><E69298>𡢅<EFBFBD><F0A1A285>唳沲<E594B3><E6B2B2><EFBFBD>
1. **今天（15分钟）**：执行第1-3步，完成目录重组
2. **明天**：开始 ASL 模块开发（新架构）
3. **Week 3**：ASL 模块上线
4. **<EFBFBD>芣䔉**嚗𡁏鰵璅∪<E79285><E288AA><EFBFBD>賒<EFBFBD>㗇<EFBFBD><E39787><EFBFBD><EFBFBD><EFBFBD>?
4. **未来**：新模块持续按标准开发
---
**最后更新：** 2025-11-14
**蝏湔擪<EFBFBD><EFBFBD><EFBFBD>** 撘<><E69298>穃𣪧<E7A983>?
**维护者：** 开发团队