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-业务模块/Redcap/00-模块概览/02-REDCap对接总体方案.md
+++ b/docs/03-业务模块/Redcap/00-模块概览/02-REDCap对接总体方案.md
@@ -1,153 +1,153 @@
 # REDCap与AIclinicalresearch平台对接总体方案

-> **譁<EFBFBD>｡｣迚域悽<EFBFBD>?* v1.0  
-> **蛻帛ｻｺ譌･譛滂ｼ?* 2025-12-30  
+> **文档版本：** v1.0  
+> **创建日期：** 2025-12-30  
 > **最后更新：** 2025-12-30  
-> **譁<EFBFBD>｡｣迥ｶ諤<EFBFBD>ｼ<EFBFBD>** 隗<><E99A97>荳? 
+> **文档状态：** 规划中  
 > **作者：** 技术架构师

 ---

 ## 📋 文档说明

-譛ｬ譁<EFBFBD>｡｣螳壻ｹ嘘EDCap<EFBFBD>?5.8.0<EFBFBD>我ｸ主｣ｹ隸∝ｾｪAI遘醍<EFBFBD>泌ｹｳ蜿ｰ逧?*螳梧紛蟇ｹ謗･譁ｹ譯<EFBDB9>**<2A>悟桁諡ｬ<E8ABA1><EFBDAC>
+本文档定义REDCap（15.8.0）与壹证循AI科研平台的**完整对接方案**，包括：
 1. 对接架构设计
-2. External Module蠑蜿第婿譯?
+2. External Module开发方案
 3. API集成方案
-4. 謨ｰ謐ｮ豬∬ｮｾ隶?
+4. 数据流设计
 5. 开发计划与实施步骤

-**蜑咲ｽｮ譚｡莉ｶ<EFBFBD>?*
- 笨?蟾ｲ闔ｷ蠕由EDCap螳俶婿謗域揀
- 笨?諡･譛嘘EDCap 15.8.0貅蝉ｻ｣遐?
- 笨?諡･譛右xternal Module Framework譁<EFBFBD>｡｣
+**前置条件：**
+- ✅ 已获得REDCap官方授权
+- ✅ 拥有REDCap 15.8.0源代码
+- ✅ 拥有External Module Framework文档

-**逶ｸ蜈ｳ譁<EFBFBD>｡｣<EFBFBD>?*
- [REDCap 莠梧ｬ｡蠑蜿第ｷｱ蠎ｦ謖<EFBFBD>漉](./REDCap%20莠梧ｬ｡蠑蜿第ｷｱ蠎ｦ謖<EFBDA6><E8AC96>?md)
+**相关文档：**
+- [REDCap 二次开发深度指南](./REDCap%20二次开发深度指南.md)
 - [系统架构分层设计](../../00-系统总体设计/01-系统架构分层设计.md)

 ---

-## <EFBFBD>識 蟇ｹ謗･逶ｮ譬<EFBDAE>ｸ惹ｻｷ蛟?
+## 🎯 对接目标与价值

 ### 核心目标

-**蟆<EFBFBD>EDCap逧<EFBFBD>ｼｺ螟ｧEDC閭ｽ蜉帑ｸ拶I遘醍<EFBFBD>泌ｹｳ蜿ｰ逧БI蠅槫ｼ蜉溯<EFBFBD>豺ｱ蠎ｦ陞榊<EFBFBD>?*
+**将REDCap的强大EDC能力与AI科研平台的AI增值功能深度融合**

 ```
 REDCap (数据采集)  +  AIclinicalresearch (AI能力)
-    竊?                          竊?
-荳ｴ蠎頑焚謐ｮ蠖募<EFBFBD>              AI譎ｺ閭ｽ螟<EFBFBD>炊縲∝<EFBFBD>譫舌∵ｴ槫ｯ?
-    竊?                          竊?
+    ↓                           ↓
+临床数据录入              AI智能处理、分析、洞察
+    ↓                           ↓
        完整的AI驱动临床研究闭环
 ```

-### 荳壼苅莉ｷ蛟?
+### 业务价值

-| 蜉溯<EFBFBD>讓｡蝮<EFBFBD> | REDCap蝓ｺ遑閭ｽ蜉<EFBFBD> | AI蟷ｳ蜿ｰ蠅槫ｼ閭ｽ蜉?| 蜊丞酔莉ｷ蛟?|
+| 功能模块 | REDCap基础能力 | AI平台增值能力 | 协同价值 |
 |---------|--------------|--------------|---------|
-| **謨ｰ謐ｮ驥<EFBFBD>寔** | 笨?陦ｨ蜊戊ｮｾ隶｡縲∵焚謐ｮ蠖募<E8A096>縲<EFBFBD>ｪ瑚ｯ?| <20>氏 AI霎<49>勧蠖募<E8A096>縲∵匱閭ｽ雍ｨ謗?| 謠仙合蠖募<E8A096>謨育紫50% |
+| **数据采集** | ✅ 表单设计、数据录入、验证 | 🎁 AI辅助录入、智能质控 | 提升录入效率50% |
 | **数据清洗** | ⚠️ 手动查询、导出Excel | 🎁 DC模块自动清洗、NER提取 | 减少数据处理时间80% |
-| **扈溯ｮ｡蛻<EFBFBD>梵** | 笞<EFBFBD><EFBFBD><EFBFBD> 髴蟇ｼ蜃ｺ蛻ｰR/SPSS | <EFBFBD>氏 SSA讓｡蝮嶺ｸ髞ｮ蛻<EFBFBD>梵縲∝庄隗<EFBFBD>喧 | 髯堺ｽ守ｻ溯ｮ｡髣ｨ讒幢ｼ悟<EFBDBC>譫宣溷ｺｦ謠仙合10蛟?|
-| **譁<EFBFBD>鍵謾ｯ謖<EFBFBD>** | 笶?譌?| <20>氏 ASL讓｡蝮玲匱閭ｽ譁<EFBDBD>鍵遲幃?| 邉ｻ扈溯ｯ<E6BAAF>ｻｷ謨育紫謠仙合5蛟?|
-| **AI髣ｮ遲<EFBFBD>** | 笶?譌?| <20>氏 AIA讓｡蝮<EFBDA1>10+譎ｺ閭ｽ菴楢ｾ<E6A5A2><EFBDBE>?| 蜈ｨ豬∫ｨ帰I霎<49>勧 |
-| **遏･隸<EFBFBD>ｺ?* | 笶?譌?| <20>氏 PKB讓｡蝮由AG髣ｮ遲<EFBDAE> | 鬘ｹ逶ｮ遏･隸<EFBDA5>ｲ画ｷ |
+| **统计分析** | ⚠️ 需导出到R/SPSS | 🎁 SSA模块一键分析、可视化 | 降低统计门槛，分析速度提升10倍 |
+| **文献支持** | ❌ 无 | 🎁 ASL模块智能文献筛选 | 系统评价效率提升5倍 |
+| **AI问答** | ❌ 无 | 🎁 AIA模块10+智能体辅助 | 全流程AI辅助 |
+| **知识库** | ❌ 无 | 🎁 PKB模块RAG问答 | 项目知识沉淀 |

 ---

-## <EFBFBD>女<EFBFBD>?蟇ｹ謗･譫ｶ譫<EFBDB6>ｮｾ隶｡
+## 🏗️ 对接架构设计

 ### 整体架构

 ```
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏?                  逕ｨ謌ｷ螻ゑｼ育<EFBFBD>皮ｩｶ莠ｺ蜻<EFBFBD>/蛹ｻ逕滂ｼ?                          笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-                              竊?
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏?                     蜑咲ｫｯ螻慕､ｺ螻?                                  笏?
-笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?             笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?  笏?
-笏? 笏? REDCap Web UI 笏?             笏?AIclinicalresearch      笏?  笏?
-笏? 笏? (蜴溽函逡碁擇)     笏や淀笏笏笏笏笏笏笏笏笏笏笏笏笆ｺ笏<EFBDBA> Frontend (React)        笏?  笏?
-笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?             笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?  笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-                              竊?
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏?                    髮<EFBFBD><EFBFBD>螻ゑｼ域<EFBFBD>ｸ蠢<EFBFBD>ｼ?                                笏?
-笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?   笏?
-笏? 笏? REDCap External Module: "AI Research Assistant"       笏?   笏?
-笏? 笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏  笏?   笏?
-笏? 笏? 笏懌楳笏 謨ｰ謐ｮ蜷梧ｭ･譛榊苅 (Data Sync Service)                   笏?   笏?
-笏? 笏? 笏懌楳笏 AI蜉溯<E89C89>闖懷黒 (AI Menu Links)                        笏?   笏?
-笏? 笏? 笏懌楳笏 Hooks螟<EFBFBD>炊蝎?(Hook Handlers)                       笏?   笏?
-笏? 笏? 笏披楳笏 API莉｣逅<EFBDA3>ｱ?(API Proxy)                             笏?   笏?
-笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?   笏?
-笏?                             竊?                                 笏?
-笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?   笏?
-笏? 笏? AIclinicalresearch Backend RESTful API                笏?   笏?
-笏? 笏? /api/v1/redcap/*                                       笏?   笏?
-笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?   笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-                              竊?
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏?                 荳壼苅螟<EFBFBD>炊螻ゑｼ<EFBFBD>I閭ｽ蜉幢ｼ?                             笏?
-笏? 笏娯楳笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏?           笏?
-笏? 笏?DC   笏? 笏?SSA  笏? 笏?ASL  笏? 笏?AIA  笏? 笏?PKB  笏? ...       笏?
-笏? 笏よ焚謐? 笏? 笏らｻ溯ｮ? 笏? 笏よ枚迪? 笏? 笏る琉遲? 笏? 笏ら衍隸<E8A18D>ｺ凪<EFBDBA>?           笏?
-笏? 笏よｸ<E38288>ｴ? 笏? 笏ょ<E7AC8F>譫? 笏? 笏らｭ幃? 笏? 笏?     笏? 笏?     笏?           笏?
-笏? 笏披楳笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏?           笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-                              竊?
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏?                   謨ｰ謐ｮ蟄伜お螻?                                    笏?
-笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?        笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?           笏?
-笏? 笏? REDCap MySQL    笏?        笏? AI Platform     笏?           笏?
-笏? 笏? (荳ｴ蠎頑焚謐ｮ)       笏や淀笏笏笏笏笏笏笏笆ｺ笏<EFBDBA>  PostgreSQL      笏?           笏?
-笏? 笏? - 謔｣閠<EFBDA3>焚謐?      笏? 蜷梧ｭ･   笏? (蛻<>梵扈捺棡)       笏?           笏?
-笏? 笏? - 陦ｨ蜊募<E89C8A>謨ｰ謐?    笏?        笏? - 貂<EFBFBD>ｴ怜錘謨ｰ謐?    笏?           笏?
-笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?        笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?           笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+┌─────────────────────────────────────────────────────────────────┐
+│                   用户层（研究人员/医生）                           │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│                      前端展示层                                   │
+│  ┌────────────────┐              ┌─────────────────────────┐   │
+│  │  REDCap Web UI │              │ AIclinicalresearch      │   │
+│  │  (原生界面)     │◄────────────►│ Frontend (React)        │   │
+│  └────────────────┘              └─────────────────────────┘   │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│                     集成层（核心）                                 │
+│  ┌────────────────────────────────────────────────────────┐    │
+│  │  REDCap External Module: "AI Research Assistant"       │    │
+│  │  ─────────────────────────────────────────────────────  │    │
+│  │  ├── 数据同步服务 (Data Sync Service)                   │    │
+│  │  ├── AI功能菜单 (AI Menu Links)                        │    │
+│  │  ├── Hooks处理器 (Hook Handlers)                       │    │
+│  │  └── API代理层 (API Proxy)                             │    │
+│  └────────────────────────────────────────────────────────┘    │
+│                              ↕                                  │
+│  ┌────────────────────────────────────────────────────────┐    │
+│  │  AIclinicalresearch Backend RESTful API                │    │
+│  │  /api/v1/redcap/*                                       │    │
+│  └────────────────────────────────────────────────────────┘    │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│                  业务处理层（AI能力）                              │
+│  ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐            │
+│  │ DC   │  │ SSA  │  │ ASL  │  │ AIA  │  │ PKB  │  ...       │
+│  │数据  │  │统计  │  │文献  │  │问答  │  │知识库│            │
+│  │清洗  │  │分析  │  │筛选  │  │      │  │      │            │
+│  └──────┘  └──────┘  └──────┘  └──────┘  └──────┘            │
+└─────────────────────────────────────────────────────────────────┘
+                              ↓
+┌─────────────────────────────────────────────────────────────────┐
+│                    数据存储层                                     │
+│  ┌──────────────────┐         ┌──────────────────┐            │
+│  │  REDCap MySQL    │         │  AI Platform     │            │
+│  │  (临床数据)       │◄───────►│  PostgreSQL      │            │
+│  │  - 患者数据       │  同步   │  (分析结果)       │            │
+│  │  - 表单元数据     │         │  - 清洗后数据     │            │
+│  └──────────────────┘         └──────────────────┘            │
+└─────────────────────────────────────────────────────────────────┘
 ```

 ### 核心对接模式

-謌台ｻｬ驥<EFBFBD>畑**蜿悟髄蟇ｹ謗･**遲也払<E4B99F>?
+我们采用**双向对接**策略：

-#### 讓｡蠑就<EFBFBD>啌EDCap 竊?AI蟷ｳ蜿ｰ<E89CBF>域焚謐ｮ謗ｨ騾<EFBDA8>ｼ<EFBFBD>
+#### 模式A：REDCap → AI平台（数据推送）

 ```
 用户在REDCap录入数据
-         竊?
+         ↓
   redcap_save_record Hook触发
-         竊?
+         ↓
 External Module推送数据到AI平台API
-         竊?
-AI蟷ｳ蜿ｰ螟<EFBFBD>炊<EFBFBD>域ｸ<EFBFBD>ｴ?蛻<>梵/AI螟<49>炊<EFBFBD>?
-         竊?
+         ↓
+AI平台处理（清洗/分析/AI处理）
+         ↓
    结果返回REDCap存储
 ```

-#### 讓｡蠑州<EFBFBD>哂I蟷ｳ蜿ｰ 竊?REDCap<61>域焚謐ｮ諡牙叙<E78999><E58F99>
+#### 模式B：AI平台 → REDCap（数据拉取）

 ```
 用户在AI平台发起分析
-         竊?
+         ↓
 AI平台调用REDCap API获取数据
-         竊?
+         ↓
 AI平台执行分析（DC/SSA/AIA等）
-         竊?
+         ↓
 结果展示在AI平台前端
-         竊?
+         ↓
 （可选）结果回写REDCap
 ```

 ---

-## <EFBFBD>肌 謚譛ｯ譁ｹ譯郁ｯｦ隗?
+## 🔧 技术方案详解

-### 譁ｹ譯<EFBFBD>1<EFBFBD>啌EDCap External Module蠑蜿?
+### 方案1：REDCap External Module开发

-#### 讓｡蝮怜多蜷堺ｸ守ｻ捺<EFBFBD>?
+#### 模块命名与结构

 ```
 模块名称: ai_research_assistant
@@ -157,21 +157,21 @@ AI平台执行分析（DC/SSA/AIA等）
 目录结构:
 ai_research_assistant_v1.0.0/
 ├── config.json                    # 模块配置
-笏懌楳笏 AiResearchAssistantModule.php  # 荳ｻ騾ｻ霎醍ｱ?
+├── AiResearchAssistantModule.php  # 主逻辑类
 ├── README.md                      # 说明文档
 ├── LICENSE                        # MIT许可
-笏懌楳笏 pages/                         # 閾ｪ螳壻ｹ蛾｡ｵ髱?
-笏?  笏懌楳笏 dashboard.php             # AI蜉溯<EFBFBD>莉ｪ陦ｨ逶?
-笏?  笏懌楳笏 data_sync.php             # 謨ｰ謐ｮ蜷梧ｭ･邂｡逅<EFBFBD>
-笏?  笏懌楳笏 analysis_center.php       # 蛻<EFBFBD>梵荳ｭ蠢<EFBFBD>
-笏?  笏披楳笏 settings.php              # 讓｡蝮苓ｮｾ鄂ｮ
+├── pages/                         # 自定义页面
+│   ├── dashboard.php             # AI功能仪表盘
+│   ├── data_sync.php             # 数据同步管理
+│   ├── analysis_center.php       # 分析中心
+│   └── settings.php              # 模块设置
 ├── js/                           # JavaScript文件
-笏?  笏懌楳笏 dashboard.js
-笏?  笏披楳笏 data_sync.js
+│   ├── dashboard.js
+│   └── data_sync.js
 ├── css/                          # 样式文件
-笏?  笏披楳笏 style.css
-笏披楳笏 services/                     # 譛榊苅邀?
-    笏懌楳笏 ApiClient.php             # AI蟷ｳ蜿ｰAPI螳｢謌ｷ遶?
+│   └── style.css
+└── services/                     # 服务类
+    ├── ApiClient.php             # AI平台API客户端
    ├── DataMapper.php            # 数据映射转换
    └── SyncService.php           # 同步服务
 ```
@@ -181,7 +181,7 @@ ai_research_assistant_v1.0.0/
 ```json
 {
  "name": "AI Research Assistant",
-  "description": "螢ｹ隸∝ｾｪAI遘醍<EFBFBD>泌ｹｳ蜿ｰ髮<EFBFBD><EFBFBD>讓｡蝮<EFBFBD> - 謠蝉ｾ帶焚謐ｮ譎ｺ閭ｽ貂<EFBDBD>ｴ励∫ｻ溯ｮ｡蛻<EFBDA1>梵縲∵枚迪ｮ謾ｯ謖∫ｭ陰I蠅槫ｼ蜉溯<E89C89>?,
+  "description": "壹证循AI科研平台集成模块 - 提供数据智能清洗、统计分析、文献支持等AI增值功能",
  "authors": [
    {
      "name": "壹证循科技",
@@ -284,7 +284,7 @@ ai_research_assistant_v1.0.0/
 }
 ```

-#### 荳ｻ騾ｻ霎醍ｱｻ<EFBFBD><EFBFBD>iResearchAssistantModule.php<EFBFBD>?
+#### 主逻辑类（AiResearchAssistantModule.php）

 ```php
 <?php
@@ -295,11 +295,11 @@ use REDCap;

 class AiResearchAssistantModule extends AbstractExternalModule {
    
-    // API螳｢謌ｷ遶ｯ螳樔ｾ?
+    // API客户端实例
    private $apiClient;
    
    /**
-     * 譫<EFBFBD><EFBFBD>蜃ｽ謨?- 蛻晏ｧ句喧API螳｢謌ｷ遶?
+     * 构造函数 - 初始化API客户端
     */
    public function __construct() {
        parent::__construct();
@@ -311,7 +311,7 @@ class AiResearchAssistantModule extends AbstractExternalModule {
    }
    
    /**
-     * Hook: 謨ｰ謐ｮ菫晏ｭ俶慮隗ｦ蜿?
+     * Hook: 数据保存时触发
     * 核心功能：实时推送数据到AI平台
     */
    public function redcap_save_record(
@@ -324,7 +324,7 @@ class AiResearchAssistantModule extends AbstractExternalModule {
        $response_id, 
        $repeat_instance
    ) {
-        // 譽譟･譏ｯ蜷ｦ蜷ｯ逕ｨ螳樊慮蜷梧ｭ?
+        // 检查是否启用实时同步
        $syncMode = $this->getProjectSetting('sync_mode');
        if ($syncMode !== 'realtime') {
            return;
@@ -355,7 +355,7 @@ class AiResearchAssistantModule extends AbstractExternalModule {
                'ai_platform_response' => $result
            ]);
            
-            // 螯よ棡蜷ｯ逕ｨ莠<EFBFBD>I謨ｰ謐ｮ貂<EFBFBD>ｴ暦ｼ瑚ｧｦ蜿第ｸ<EFBFBD>ｴ嶺ｻｻ蜉?
+            // 如果启用了AI数据清洗，触发清洗任务
            if ($this->getProjectSetting('enable_dc_module')) {
                $this->triggerDataCleaning($project_id, $record);
            }
@@ -384,8 +384,8 @@ class AiResearchAssistantModule extends AbstractExternalModule {
    }
    
    /**
-     * Hook: 謨ｰ謐ｮ蟇ｼ蜃ｺ蜑?
-     * 蜉溯<EFBFBD><EFBFBD>壼庄莉･豺ｻ蜉<EFBFBD>AI蛻<EFBFBD>梵扈捺棡蟄玲ｮｵ蛻ｰ蟇ｼ蜃?
+     * Hook: 数据导出前
+     * 功能：可以添加AI分析结果字段到导出
     */
    public function redcap_custom_verify_username($username) {
        // 验证逻辑
@@ -399,10 +399,10 @@ class AiResearchAssistantModule extends AbstractExternalModule {
        
        foreach ($projects as $project_id) {
            try {
-                // 闔ｷ蜿夜｡ｹ逶ｮ謇譛画焚謐?
+                // 获取项目所有数据
                $data = REDCap::getData($project_id, 'array');
                
-                // 謇ｹ驥乗耳騾?
+                // 批量推送
                $result = $this->apiClient->post('/api/v1/redcap/batch-sync', [
                    'project_id' => $project_id,
                    'data' => $data,
@@ -457,7 +457,7 @@ class AiResearchAssistantModule extends AbstractExternalModule {
    }
    
    /**
-     * 闔ｷ蜿門星逕ｨ讓｡蝮礼噪鬘ｹ逶ｮ蛻苓｡?
+     * 获取启用模块的项目列表
     */
    private function getEnabledProjects() {
        $sql = "SELECT project_id FROM redcap_external_modules 
@@ -480,7 +480,7 @@ class AiResearchAssistantModule extends AbstractExternalModule {

 ---

-### 譁ｹ譯<EFBFBD>2<EFBFBD>哂I蟷ｳ蜿ｰBackend API蠑蜿?
+### 方案2：AI平台Backend API开发

 #### 新增REDCap专用模块

@@ -488,18 +488,18 @@ class AiResearchAssistantModule extends AbstractExternalModule {
 // backend/src/modules/redcap/ 目录结构
 backend/src/modules/redcap/
 ├── controllers/
-笏?  笏懌楳笏 RedcapController.ts        // 荳ｻ謗ｧ蛻ｶ蝎ｨ
-笏?  笏懌楳笏 SyncController.ts          // 謨ｰ謐ｮ蜷梧ｭ･謗ｧ蛻ｶ蝎?
-笏?  笏披楳笏 WebhookController.ts       // Webhook謗ｧ蛻ｶ蝎?
+│   ├── RedcapController.ts        // 主控制器
+│   ├── SyncController.ts          // 数据同步控制器
+│   └── WebhookController.ts       // Webhook控制器
 ├── services/
-笏?  笏懌楳笏 RedcapApiClient.ts         // REDCap API螳｢謌ｷ遶?
-笏?  笏懌楳笏 DataTransformService.ts    // 謨ｰ謐ｮ霓ｬ謐｢譛榊苅
-笏?  笏懌楳笏 SyncService.ts             // 蜷梧ｭ･譛榊苅
-笏?  笏披楳笏 ProjectMappingService.ts   // 鬘ｹ逶ｮ譏<EFBFBD>蟆<EFBFBD>恪蜉｡
+│   ├── RedcapApiClient.ts         // REDCap API客户端
+│   ├── DataTransformService.ts    // 数据转换服务
+│   ├── SyncService.ts             // 同步服务
+│   └── ProjectMappingService.ts   // 项目映射服务
 ├── models/
-笏?  笏披楳笏 redcap.prisma              // Prisma Schema
+│   └── redcap.prisma              // Prisma Schema
 ├── routes/
-笏?  笏披楳笏 redcap.routes.ts           // 霍ｯ逕ｱ螳壻ｹ<EFBFBD>
+│   └── redcap.routes.ts           // 路由定义
 └── types/
    └── redcap.types.ts            // TypeScript类型定义
 ```
@@ -516,7 +516,7 @@ datasource redcap_schema {
  schemas  = ["redcap_schema"]
 }

-// REDCap鬘ｹ逶ｮ譏<EFBFBD>蟆<EFBFBD>｡?
+// REDCap项目映射表
 model RedcapProject {
  id                String   @id @default(cuid())
  redcapProjectId   Int      @unique         // REDCap项目ID
@@ -533,7 +533,7 @@ model RedcapProject {
  syncMode          String   @default("realtime") // realtime, scheduled, manual
  lastSyncAt        DateTime?
  
-  // 蜈<EFBFBD>焚謐?
+  // 元数据
  projectName       String
  projectDescription String? @db.Text
  
@@ -548,7 +548,7 @@ model RedcapProject {
  @@schema("redcap_schema")
 }

-// REDCap蜷梧ｭ･隶ｰ蠖戊｡?
+// REDCap同步记录表
 model RedcapSyncRecord {
  id              String   @id @default(cuid())
  projectId       String
@@ -558,13 +558,13 @@ model RedcapSyncRecord {
  eventId         String?  // REDCap事件ID
  instrument      String?  // 表单名称
  
-  // 蜷梧ｭ･迥ｶ諤?
+  // 同步状态
  status          String   // pending, syncing, success, failed
  direction       String   // redcap_to_ai, ai_to_redcap
  
  // 数据快照
  redcapData      Json     // REDCap原始数据
-  aiPlatformData  Json?    // AI蟷ｳ蜿ｰ螟<EFBFBD>炊蜷取焚謐?
+  aiPlatformData  Json?    // AI平台处理后数据
  
  // 错误信息
  errorMessage    String?  @db.Text
@@ -578,7 +578,7 @@ model RedcapSyncRecord {
  @@index([status])
 }

-// REDCap蟄玲ｮｵ譏<EFBFBD>蟆<EFBFBD>｡?
+// REDCap字段映射表
 model RedcapFieldMapping {
  id              String   @id @default(cuid())
  projectId       String
@@ -591,11 +591,11 @@ model RedcapFieldMapping {
  
  // AI平台字段映射
  aiPlatformField String?  // 映射到AI平台的字段名
-  transformRule   Json?    // 霓ｬ謐｢隗<EFBFBD><EFBFBD><EFBFBD><EFBFBD>SON<EFBFBD>?
+  transformRule   Json?    // 转换规则（JSON）
  
  // 映射配置
  isRequired      Boolean  @default(false)
-  isIdentifier    Boolean  @default(false)  // 譏ｯ蜷ｦ荳ｺ荳ｻ髞ｮ蟄玲ｮ?
+  isIdentifier    Boolean  @default(false)  // 是否为主键字段
  
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt
@@ -650,17 +650,17 @@ export async function redcapRoutes(fastify: FastifyInstance) {
  
  // ========== 数据同步 ==========
  
-  // 謇句勘隗ｦ蜿大酔豁･<EFBFBD><EFBFBD>EDCap 竊?AI蟷ｳ蜿ｰ<E89CBF>?
+  // 手动触发同步（REDCap → AI平台）
  fastify.post('/api/v1/redcap/sync/import/:projectId', 
    syncController.importFromRedcap
  );
  
-  // 謗ｨ騾∵焚謐ｮ蛻ｰREDCap<EFBFBD><EFBFBD>I蟷ｳ蜿ｰ 竊?REDCap<EFBFBD>?
+  // 推送数据到REDCap（AI平台 → REDCap）
  fastify.post('/api/v1/redcap/sync/export/:projectId', 
    syncController.exportToRedcap
  );
  
-  // 譟･隸｢蜷梧ｭ･迥ｶ諤?
+  // 查询同步状态
  fastify.get('/api/v1/redcap/sync/status/:projectId', 
    syncController.getSyncStatus
  );
@@ -672,7 +672,7 @@ export async function redcapRoutes(fastify: FastifyInstance) {
  
  // ========== Webhook接收 ==========
  
-  // REDCap External Module謗ｨ騾∵焚謐ｮ<EFBFBD>亥ｮ樊慮蜷梧ｭ･<EFBFBD>?
+  // REDCap External Module推送数据（实时同步）
  fastify.post('/api/v1/redcap/webhook/records', 
    webhookController.receiveRecordUpdate
  );
@@ -684,7 +684,7 @@ export async function redcapRoutes(fastify: FastifyInstance) {
  
  // ========== 字段映射管理 ==========
  
-  // 闔ｷ蜿乏EDCap鬘ｹ逶ｮ蜈<EFBFBD>焚謐ｮ<EFBFBD>亥ｭ玲ｮｵ蛻苓｡ｨ<EFBFBD>?
+  // 获取REDCap项目元数据（字段列表）
  fastify.get('/api/v1/redcap/projects/:id/metadata', 
    redcapController.getProjectMetadata
  );
@@ -701,12 +701,12 @@ export async function redcapRoutes(fastify: FastifyInstance) {
  
  // ========== AI功能集成 ==========
  
-  // 隗ｦ蜿第焚謐ｮ貂<EFBFBD>ｴ暦ｼ<EFBFBD>C讓｡蝮暦ｼ?
+  // 触发数据清洗（DC模块）
  fastify.post('/api/v1/redcap/dc/clean', 
    redcapController.triggerDataCleaning
  );
  
-  // 隗ｦ蜿醍ｻ溯ｮ｡蛻<EFBFBD>梵<EFBFBD><EFBFBD>SA讓｡蝮暦ｼ?
+  // 触发统计分析（SSA模块）
  fastify.post('/api/v1/redcap/ssa/analyze', 
    redcapController.triggerStatisticalAnalysis
  );
@@ -750,7 +750,7 @@ export class SyncController {
      if (!project) {
        return res.status(404).send({ 
          success: false, 
-          error: '鬘ｹ逶ｮ荳榊ｭ伜<EFBFBD>? 
+          error: '项目不存在' 
        });
      }
      
@@ -777,8 +777,8 @@ export class SyncController {
        project.fieldMappings
      );
      
-      // 4. 蟄伜お蛻ｰAI蟷ｳ蜿ｰ謨ｰ謐ｮ蠎?
-      // 譬ｹ謐ｮ鬘ｹ逶ｮ驟咲ｽｮ<EFBFBD>梧耳騾∝芦DC/SSA/ASL遲画ｨ｡蝮?
+      // 4. 存储到AI平台数据库
+      // 根据项目配置，推送到DC/SSA/ASL等模块
      if (project.dcProjectId) {
        await this.importToDCModule(project.dcProjectId, transformedData);
      }
@@ -848,74 +848,74 @@ export class SyncController {

 ---

-## <EFBFBD>投 謨ｰ謐ｮ豬∬ｮｾ隶?
+## 📊 数据流设计

-### 謨ｰ謐ｮ豬?<3F>啌EDCap 竊?AI蟷ｳ蜿ｰ<E89CBF>亥ｮ樊慮蜷梧ｭ･<EFBDAD><EFBDA5>
+### 数据流1：REDCap → AI平台（实时同步）

 ```
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏? Step 1: 逕ｨ謌ｷ蝨ｨREDCap蠖募<EFBFBD>謨ｰ謐ｮ                             笏?
-笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏  笏?
-笏? 遐皮ｩｶ莠ｺ蜻伜惠REDCap陦ｨ蜊穂ｸｭ蠖募<E8A096>謔｣閠<EFBDA3>焚謐?                       笏?
-笏? 萓句ｦゑｼ壽ぅ閠<E38185>D縲∝ｹｴ鮴<EFBDB4>∵ｧ蛻ｫ縲∬ｯ頑妙縲∵｣鬪檎ｻ捺棡遲<E6A3A1>                 笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-                       竊?
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏? Step 2: REDCap隗ｦ蜿喪edcap_save_record Hook              笏?
-笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏  笏?
-笏? External Module謐戊執菫晏ｭ倅ｺ倶ｻｶ                              笏?
-笏? 闔ｷ蜿厄ｼ嗔roject_id, record, instrument, event_id         笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-                       竊?
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏? Step 3: 謨ｰ謐ｮ闔ｷ蜿紋ｸ取丐蟆?                                  笏?
-笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏  笏?
-笏? 1. 隹<EFBFBD>畑REDCap::getData()闔ｷ蜿門ｮ梧紛隶ｰ蠖<EFBFBD>                     笏?
-笏? 2. DataMapper霓ｬ謐｢REDCap EAV譬ｼ蠑鞘<EFBFBD>AI蟷ｳ蜿ｰ譬<EFBFBD>㊥譬ｼ蠑<EFBFBD>           笏?
-笏? 3. 蠎皮畑蟄玲ｮｵ譏<EFBFBD>蟆<EFBFBD>ｧ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>edcap_field_mappings陦ｨ<EFBFBD><EFBFBD>           笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-                       竊?
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏? Step 4: HTTP POST謗ｨ騾∝芦AI蟷ｳ蜿ｰAPI                        笏?
-笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏  笏?
-笏? URL: https://ai.yizx.com/api/v1/redcap/webhook/records 笏?
-笏? Payload: {                                             笏?
-笏?   project_id: 123,                                     笏?
-笏?   record_id: "PAT001",                                 笏?
-笏?   data: {...},                                         笏?
-笏?   timestamp: 1735542000                                笏?
-笏? }                                                      笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-                       竊?
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏? Step 5: AI蟷ｳ蜿ｰ謗･謾ｶ蟷ｶ螟<EFBFBD><EFBFBD>?                                笏?
-笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏  笏?
-笏? 1. WebhookController鬪瑚ｯ∬ｯｷ豎らｭｾ蜷<EFBFBD>                         笏?
-笏? 2. 蟄伜お蜴溷ｧ区焚謐ｮ蛻ｰredcap_sync_records陦?                  笏?
-笏? 3. 蠑よｭ･隗ｦ蜿羨I螟<EFBFBD>炊莉ｻ蜉｡<EFBFBD><EFBFBD>C/SSA讓｡蝮暦ｼ?                      笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-                       竊?
-笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
-笏? Step 6: AI螟<EFBFBD>炊荳守ｻ捺棡霑泌<EFBFBD>?                                笏?
-笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏  笏?
-笏? 1. DC讓｡蝮暦ｼ壽焚謐ｮ貂<EFBFBD>ｴ励¨ER謠仙叙縲∫ｼｺ螟ｱ蛟ｼ螟<EFBFBD><EFBFBD>?                 笏?
-笏? 2. SSA讓｡蝮暦ｼ夊<EFBFBD>蜉ｨ扈溯ｮ｡蛻<EFBFBD>梵縲∫函謌仙庄隗<EFBFBD>喧蝗ｾ陦ｨ                  笏?
-笏? 3. 扈捺棡蟄伜お蛻ｰAI蟷ｳ蜿ｰ謨ｰ謐ｮ蠎?                               笏?
-笏? 4. <EFBFBD>亥庄騾会ｼ牙屓蜀咏ｻ捺棡蛻ｰREDCap<EFBFBD>磯夊ｿ②PI<EFBFBD>?                   笏?
-笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+┌─────────────────────────────────────────────────────────┐
+│  Step 1: 用户在REDCap录入数据                             │
+│  ─────────────────────────────────────────────────────  │
+│  研究人员在REDCap表单中录入患者数据                        │
+│  例如：患者ID、年龄、性别、诊断、检验结果等                 │
+└─────────────────────────────────────────────────────────┘
+                       ↓
+┌─────────────────────────────────────────────────────────┐
+│  Step 2: REDCap触发redcap_save_record Hook              │
+│  ─────────────────────────────────────────────────────  │
+│  External Module捕获保存事件                              │
+│  获取：project_id, record, instrument, event_id         │
+└─────────────────────────────────────────────────────────┘
+                       ↓
+┌─────────────────────────────────────────────────────────┐
+│  Step 3: 数据获取与映射                                   │
+│  ─────────────────────────────────────────────────────  │
+│  1. 调用REDCap::getData()获取完整记录                     │
+│  2. DataMapper转换REDCap EAV格式→AI平台标准格式           │
+│  3. 应用字段映射规则（redcap_field_mappings表）           │
+└─────────────────────────────────────────────────────────┘
+                       ↓
+┌─────────────────────────────────────────────────────────┐
+│  Step 4: HTTP POST推送到AI平台API                        │
+│  ─────────────────────────────────────────────────────  │
+│  URL: https://ai.yizx.com/api/v1/redcap/webhook/records │
+│  Payload: {                                             │
+│    project_id: 123,                                     │
+│    record_id: "PAT001",                                 │
+│    data: {...},                                         │
+│    timestamp: 1735542000                                │
+│  }                                                      │
+└─────────────────────────────────────────────────────────┘
+                       ↓
+┌─────────────────────────────────────────────────────────┐
+│  Step 5: AI平台接收并处理                                 │
+│  ─────────────────────────────────────────────────────  │
+│  1. WebhookController验证请求签名                         │
+│  2. 存储原始数据到redcap_sync_records表                   │
+│  3. 异步触发AI处理任务（DC/SSA模块）                       │
+└─────────────────────────────────────────────────────────┘
+                       ↓
+┌─────────────────────────────────────────────────────────┐
+│  Step 6: AI处理与结果返回                                 │
+│  ─────────────────────────────────────────────────────  │
+│  1. DC模块：数据清洗、NER提取、缺失值处理                  │
+│  2. SSA模块：自动统计分析、生成可视化图表                  │
+│  3. 结果存储到AI平台数据库                                │
+│  4. （可选）回写结果到REDCap（通过API）                    │
+└─────────────────────────────────────────────────────────┘
 ```

-### 謨ｰ謐ｮ豬?<3F>哂I蟷ｳ蜿ｰ 竊?REDCap<61>亥<EFBFBD>譫千ｻ捺棡蝗槫<E89D97><E6A7AB><EFBFBD>
+### 数据流2：AI平台 → REDCap（分析结果回写）

 ```
 AI平台完成分析
-     竊?
-逕滓<EFBFBD>蛻<EFBFBD>梵扈捺棡<EFBFBD><EFBFBD>SON<EFBFBD>?
-     竊?
+     ↓
+生成分析结果（JSON）
+     ↓
 调用REDCap API: importRecords
-     竊?
-REDCap蟄伜お扈捺棡蛻ｰ迚ｹ螳壼ｭ玲ｮ?
-     竊?
+     ↓
+REDCap存储结果到特定字段
+     ↓
 研究人员在REDCap中查看AI分析结果
 ```

@@ -925,34 +925,34 @@ REDCap存储结果到特定字

 ### Phase 1: 基础对接（Week 1-2）✅ 优先级P0

-**逶ｮ譬<EFBFBD>**<EFBFBD>壼ｻｺ遶騎EDCap荳拶I蟷ｳ蜿ｰ逧<EFBFBD>渕譛ｬ霑樊<EFBFBD>?
+**目标**：建立REDCap与AI平台的基本连接

 #### Week 1: External Module骨架

-**莉ｻ蜉｡貂<EFBFBD>黒**<EFBFBD>?
+**任务清单**：
 - [ ] 创建External Module目录结构
 - [ ] 编写config.json配置文件
- [ ] 螳樒鴫AiResearchAssistantModule.php蝓ｺ遑邀?
+- [ ] 实现AiResearchAssistantModule.php基础类
 - [ ] 实现redcap_save_record Hook（基础版）
 - [ ] 开发ApiClient.php（HTTP客户端）
- [ ] 豬玖ｯ包ｼ啌EDCap菫晏ｭ俶焚謐ｮ竊呈遠蜊ｰ譌･蠢?
+- [ ] 测试：REDCap保存数据→打印日志

-**莠､莉倡<EFBFBD>?*<2A>?
+**交付物**：
 - `ai_research_assistant_v1.0.0/` 完整目录
 - 可在REDCap中启用的External Module
 - 基础日志记录功能

 #### Week 2: AI平台API端点

-**莉ｻ蜉｡貂<EFBFBD>黒**<EFBFBD>?
+**任务清单**：
 - [ ] 创建redcap_schema数据库Schema
- [ ] 螳樒鴫Prisma讓｡蝙具ｼ<EFBFBD>edcapProject遲?荳ｪ陦ｨ<E999A6>?
+- [ ] 实现Prisma模型（RedcapProject等3个表）
 - [ ] 开发WebhookController接收数据
 - [ ] 实现数据转换服务DataTransformService
- [ ] 蠑蜿鷹｡ｹ逶ｮ邂｡逅<EFBFBD>PI<EFBFBD><EFBFBD>RUD<EFBFBD>?
- [ ] 豬玖ｯ包ｼ啌EDCap謗ｨ騾≫<EFBFBD>AI蟷ｳ蜿ｰ謗･謾ｶ竊貞ｭ伜<EFBFBD>?
+- [ ] 开发项目管理API（CRUD）
+- [ ] 测试：REDCap推送→AI平台接收→存储

-**莠､莉倡<EFBFBD>?*<2A>?
+**交付物**：
 - `/api/v1/redcap/*` API端点
 - PostgreSQL redcap_schema创建
 - Postman测试集合
@@ -965,102 +965,102 @@ REDCap存储结果到特定字

 #### Week 3: 字段映射系统

-**莉ｻ蜉｡貂<EFBFBD>黒**<EFBFBD>?
- [ ] 蠑蜿大ｭ玲ｮｵ譏<EFBFBD>蟆<EFBFBD>ｮ｡逅<EFBFBD>I<EFBFBD>亥燕遶ｯReact<EFBFBD>?
+**任务清单**：
+- [ ] 开发字段映射管理UI（前端React）
 - [ ] 实现REDCap元数据获取API
- [ ] 蠑蜿大ｭ玲ｮｵ譏<EFBFBD>蟆<EFBFBD><EFBFBD>鄂ｮ逡碁<EFBFBD>?
- [ ] 螳樒鴫譏<EFBFBD>蟆<EFBFBD>ｧ<EFBFBD><EFBFBD>蠑墓梼<EFBFBD><EFBFBD>ataMapper<EFBFBD>?
+- [ ] 开发字段映射配置界面
+- [ ] 实现映射规则引擎（DataMapper）
 - [ ] 支持复杂转换（如：单位转换、编码映射）
 - [ ] 测试：映射配置→数据转换验证

-**莠､莉倡<EFBFBD>?*<2A>?
+**交付物**：
 - 字段映射UI页面
 - 映射规则引擎
 - 配置文档

 #### Week 4: 双向同步

-**莉ｻ蜉｡貂<EFBFBD>黒**<EFBFBD>?
- [ ] 螳樒鴫謇ｹ驥乗焚謐ｮ蟇ｼ蜈･<EFBFBD><EFBFBD>EDCap 竊?AI<41>?
- [ ] 螳樒鴫蛻<EFBFBD>梵扈捺棡蝗槫<EFBFBD><EFBFBD><EFBFBD>I 竊?REDCap<EFBFBD>?
+**任务清单**：
+- [ ] 实现批量数据导入（REDCap → AI）
+- [ ] 实现分析结果回写（AI → REDCap）
 - [ ] 开发Cron定时同步任务
- [ ] 螳樒鴫蜷梧ｭ･迥ｶ諤∫尅謗ｧ逡碁<EFBFBD>?
- [ ] 髞呵ｯｯ螟<EFBFBD>炊荳朱㍾隸墓惻蛻?
- [ ] 豬玖ｯ包ｼ壼ｮ梧紛蜷梧ｭ･豬∫ｨ?
+- [ ] 实现同步状态监控界面
+- [ ] 错误处理与重试机制
+- [ ] 测试：完整同步流程

-**莠､莉倡<EFBFBD>?*<2A>?
+**交付物**：
 - 双向同步功能
 - 同步监控Dashboard
 - 错误处理机制

 ---

-### Phase 3: AI蜉溯<EFBFBD>髮<EFBFBD><EFBFBD><EFBFBD><EFBFBD>eek 5-6<>解沁?莨伜<E88EA8>郤ｧP1
+### Phase 3: AI功能集成（Week 5-6）🎁 优先级P1

 **目标**：集成DC、SSA、AIA等AI模块

 #### Week 5: DC模块集成

-**莉ｻ蜉｡貂<EFBFBD>黒**<EFBFBD>?
+**任务清单**：
 - [ ] REDCap数据→DC模块自动清洗
 - [ ] 清洗结果→REDCap回写
- [ ] 蝨ｨREDCap荳ｭ螻慕､ｺ貂<EFBFBD>ｴ玲冠蜻?
+- [ ] 在REDCap中展示清洗报告
 - [ ] 支持手动触发清洗
- [ ] 豬玖ｯ包ｼ壼ｽ募<EFBFBD>竊呈ｸ<EFBFBD>ｴ冷<EFBFBD>譟･逵狗ｻ捺<EFBFBD>?
+- [ ] 测试：录入→清洗→查看结果

-**莠､莉倡<EFBFBD>?*<2A>?
+**交付物**：
 - DC集成API
 - REDCap清洗报告页面

 #### Week 6: SSA模块集成

-**莉ｻ蜉｡貂<EFBFBD>黒**<EFBFBD>?
+**任务清单**：
 - [ ] REDCap数据→SSA模块自动分析
- [ ] 謾ｯ謖∽ｸ牙､ｧ蛻<EFBFBD>梵霍ｯ蠕<EFBFBD>ｼ磯弌蛻?鬚<>ｵ<EFBFBD>/RCT<EFBFBD>?
- [ ] 蝨ｨREDCap荳ｭ蠏悟<EFBFBD>扈溯ｮ｡謚･蜻?
- [ ] 蜿ｯ隗<EFBFBD>喧蝗ｾ陦ｨ螻慕､?
- [ ] 豬玖ｯ包ｼ壽焚謐ｮ蠖募<EFBFBD>竊定<EFBFBD>蜉ｨ蛻<EFBFBD>梵竊呈冠蜻顔函謌?
+- [ ] 支持三大分析路径（队列/预测/RCT）
+- [ ] 在REDCap中嵌入统计报告
+- [ ] 可视化图表展示
+- [ ] 测试：数据录入→自动分析→报告生成

-**莠､莉倡<EFBFBD>?*<2A>?
+**交付物**：
 - SSA集成API
 - 统计报告嵌入页面

 ---

-### Phase 4: 鬮倡ｺｧ蜉溯<EFBFBD><EFBFBD><EFBFBD>eek 7-8<>解沍?莨伜<E88EA8>郤ｧP2
+### Phase 4: 高级功能（Week 7-8）🌟 优先级P2

-**逶ｮ譬<EFBFBD>**<EFBFBD>哂I霎<EFBFBD>勧蠖募<EFBFBD>縲∵匱閭ｽ雍ｨ謗ｧ遲牙｢槫ｼ蜉溯<EFBFBD>?
+**目标**：AI辅助录入、智能质控等增值功能

 #### Week 7: AI辅助录入

-**莉ｻ蜉｡貂<EFBFBD>黒**<EFBFBD>?
- [ ] 蠑蜿第匱閭ｽ閾ｪ蜉ｨ螳梧<EFBFBD><EFBFBD>亥渕莠主紙蜿ｲ謨ｰ謐ｮ<EFBFBD>?
- [ ] 蠑ょｸｸ蛟ｼ鬚<EFBFBD>ｭｦ<EFBFBD>亥ｮ樊慮AI蛻､譁ｭ<EFBFBD>?
- [ ] 蟄玲ｮｵ蜈ｳ閨疲耳闕撰ｼ<EFBFBD>I鬚<EFBFBD>ｵ具ｼ?
+**任务清单**：
+- [ ] 开发智能自动完成（基于历史数据）
+- [ ] 异常值预警（实时AI判断）
+- [ ] 字段关联推荐（AI预测）
 - [ ] 录入效率提升统计
- [ ] 豬玖ｯ包ｼ壼ｽ募<EFBFBD>菴馴ｪ御ｼ伜喧鬪瑚ｯ?
+- [ ] 测试：录入体验优化验证

-**莠､莉倡<EFBFBD>?*<2A>?
+**交付物**：
 - AI辅助录入JS插件
 - 智能质控规则引擎

-#### Week 8: 扈ｼ蜷域ｵ玖ｯ穂ｸ惹ｼ伜<EFBFBD>?
+#### Week 8: 综合测试与优化

-**莉ｻ蜉｡貂<EFBFBD>黒**<EFBFBD>?
- [ ] 諤ｧ閭ｽ豬玖ｯ包ｼ?00荳<30>擅隶ｰ蠖募酔豁･<E8B181>?
+**任务清单**：
+- [ ] 性能测试（100万条记录同步）
 - [ ] 安全测试（API认证、数据加密）
- [ ] 逕ｨ謌ｷ鬪梧噺豬玖ｯ包ｼ<EFBFBD>AT<EFBFBD>?
- [ ] 譁<EFBFBD>｡｣郛門<EFBFBD><EFBFBD>育畑謌ｷ謇句<EFBFBD>?蠑蜿第枚譯｣<E8ADAF><EFBDA3>
- [ ] 驛ｨ鄂ｲ蛻ｰ逕滉ｺｧ邇ｯ蠅?
+- [ ] 用户验收测试（UAT）
+- [ ] 文档编写（用户手册+开发文档）
+- [ ] 部署到生产环境

-**莠､莉倡<EFBFBD>?*<2A>?
+**交付物**：
 - 性能测试报告
 - 完整文档
 - 生产环境部署

 ---

-## <EFBFBD>白 螳牙<E89EB3>諤ｧ隶ｾ隶?
+## 🔒 安全性设计

 ### API认证机制

@@ -1097,7 +1097,7 @@ function verifySignature(req) {

 - REDCap API Token：使用AES-256加密存储
 - 传输加密：强制HTTPS
- 謨乗─蟄玲ｮｵ<EFBFBD>壽髪謖∝ｭ玲ｮｵ郤ｧ蜉<EFBFBD>蟇<EFBFBD>ｼ<EFBFBD>HI謨ｰ謐ｮ<EFBFBD>?
+- 敏感字段：支持字段级加密（PHI数据）

 ### 权限控制

@@ -1122,73 +1122,73 @@ interface UserPermission {

 ## 📚 技术栈总结

-| 螻らｺｧ | REDCap萓?| AI蟷ｳ蜿ｰ萓?|
+| 层级 | REDCap侧 | AI平台侧 |
 |------|---------|---------|
 | **编程语言** | PHP 7.4+ | TypeScript/Node.js 22 |
 | **框架** | REDCap EM Framework v16 | Fastify v4 |
-| **謨ｰ謐ｮ蠎?* | MySQL 5.7+ | PostgreSQL 15 |
-| **謨ｰ謐ｮ讓｡蝙<EFBFBD>** | EAV讓｡蝙<EFBFBD> | 蜈ｳ邉ｻ蝙?JSONB |
+| **数据库** | MySQL 5.7+ | PostgreSQL 15 |
+| **数据模型** | EAV模型 | 关系型+JSONB |
 | **前端** | jQuery + Bootstrap 5 | React 19 + Ant Design 6 |
 | **API** | REDCap RESTful API | Fastify RESTful API |
 | **认证** | API Token | HMAC-SHA256签名 |
-| **譌･蠢<EFBFBD>** | REDCap譌･蠢苓｡?| Winston + SLS |
+| **日志** | REDCap日志表 | Winston + SLS |
 | **任务队列** | REDCap Cron | pg-boss (Postgres-Only) |

 ---

-## <EFBFBD>統 荳倶ｸ豁･陦悟<E999A6>?
+## 📝 下一步行动

 ### 立即行动（本周）

-1. **遑ｮ隶､髴豎?*<2A>?
+1. **确认需求**：
   - [ ] 确认优先级（DC优先？还是SSA优先？）
   - [ ] 确认部署形态（云端SaaS？还是私有化部署？）
   - [ ] 确认REDCap服务器信息（URL、版本、访问权限）

-2. **邇ｯ蠅<EFBFBD>㊥螟<EFBFBD>**<EFBFBD>?
-   - [ ] 謳ｭ蟒ｺREDCap豬玖ｯ慕識蠅<EFBFBD>ｼ井ｽｿ逕ｨDocker<EFBFBD>?
-   - [ ] 蛻帛ｻｺ豬玖ｯ暮｡ｹ逶ｮ蜥梧ｵ玖ｯ墓焚謐?
+2. **环境准备**：
+   - [ ] 搭建REDCap测试环境（使用Docker）
+   - [ ] 创建测试项目和测试数据
   - [ ] 配置AI平台测试API

-3. **蜷ｯ蜉ｨ蠑蜿?*<2A>?
+3. **启动开发**：
   - [ ] 创建External Module目录
   - [ ] 初始化Git仓库
   - [ ] 编写config.json

-### 謚譛ｯ鬚<EFBFBD><EFBFBD>?
+### 技术预研

 1. **REDCap API深入测试**
 2. **External Module Hook机制验证**
 3. **大数据量同步性能测试**
-4. **遘ｻ蜉ｨ遶ｯ<EFBFBD><EFBFBD>EDCap Mobile App<EFBFBD>蛾寔謌仙庄陦梧?*
+4. **移动端（REDCap Mobile App）集成可行性**

 ---

 ## 🎯 成功标准

-**MVP迚域悽<EFBFBD><EFBFBD>hase 1-2螳梧<EFBFBD><EFBFBD>?*<2A>?
- 笨?REDCap謨ｰ謐ｮ閭ｽ謗ｨ騾∝芦AI蟷ｳ蜿ｰ
- 笨?AI蟷ｳ蜿ｰ閭ｽ謗･謾ｶ蟷ｶ蟄伜お謨ｰ謐ｮ
- 笨?蟄玲ｮｵ譏<EFBDB5>蟆<EFBFBD><E89F86>鄂ｮ蜉溯<E89C89>蜿ｯ逕ｨ
- 笨?蝓ｺ遑蜷梧ｭ･逶第而蜿ｯ逕ｨ
+**MVP版本（Phase 1-2完成）**：
+- ✅ REDCap数据能推送到AI平台
+- ✅ AI平台能接收并存储数据
+- ✅ 字段映射配置功能可用
+- ✅ 基础同步监控可用

-**譬<EFBFBD>㊥迚域悽<EFBFBD><EFBFBD>hase 3螳梧<E89EB3><E6A2A7>?*<2A>?
- 笨?DC讓｡蝮鈴寔謌仙ｮ梧<EFBDAE><E6A2A7>郁<EFBFBD>蜉ｨ貂<EFBDA8>ｴ暦ｼ<E69AA6>
- 笨?SSA讓｡蝮鈴寔謌仙ｮ梧<EFBFBD><EFBFBD>郁<EFBFBD>蜉ｨ蛻<EFBFBD>梵<EFBFBD><EFBFBD>
- 笨?蛻<>梵扈捺棡蜿ｯ蝨ｨREDCap荳ｭ譟･逵?
- 笨?逕ｨ謌ｷ菴馴ｪ梧ｵ∫腐
+**标准版本（Phase 3完成）**：
+- ✅ DC模块集成完成（自动清洗）
+- ✅ SSA模块集成完成（自动分析）
+- ✅ 分析结果可在REDCap中查看
+- ✅ 用户体验流畅

-**莨∽ｸ夂沿譛ｬ<EFBFBD><EFBFBD>hase 4螳梧<E89EB3><E6A2A7>?*<2A>?
- 笨?AI霎<49>勧蠖募<E8A096>謠仙合謨育紫50%+
- 笨?譎ｺ閭ｽ雍ｨ謗ｧ蜃丞ｰ鷹漠隸ｯ邇?0%+
- 笨?謾ｯ謖<EFBDAF>100荳?隶ｰ蠖募酔豁･
- 笨?螳牙<E89EB3>蜷郁ｧ<E98381>ｼ育ｬｦ蜷<EFBDA6>DA 21 CFR Part 11<EFBFBD>?
+**企业版本（Phase 4完成）**：
+- ✅ AI辅助录入提升效率50%+
+- ✅ 智能质控减少错误率80%+
+- ✅ 支持100万+记录同步
+- ✅ 安全合规（符合FDA 21 CFR Part 11）

 ---

 **文档版本**：v1.0  
-**譛蜷取峩譁?*<2A>?025-12-30  
-**荳区ｬ｡譖ｴ譁ｰ**<EFBFBD>啀hase 1蜷ｯ蜉ｨ蜷取峩譁ｰ蠑蜿題ｿ帛ｺ?
+**最后更新**：2025-12-30  
+**下次更新**：Phase 1启动后更新开发进度

 ---