feat(aia): Complete AIA V2.0 with universal streaming capabilities

Major Changes: - Add StreamingService with OpenAI Compatible format - Upgrade Chat component V2 with Ant Design X integration - Implement AIA module with 12 intelligent agents - Update API routes to unified /api/v1 prefix - Update system documentation Backend (~1300 lines): - common/streaming: OpenAI Compatible adapter - modules/aia: 12 agents, conversation service, streaming integration - Update route versions (RVW, PKB to v1) Frontend (~3500 lines): - modules/aia: AgentHub + ChatWorkspace (100% prototype restoration) - shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook - Update API endpoints to v1 Documentation: - AIA module status guide - Universal capabilities catalog - System overview updates - All module documentation sync Tested: Stream response verified, authentication working Status: AIA V2.0 core completed (85%)
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions
--- a/Agent/04-开发计划/REDCap对接技术方案与实施指南.md
+++ b/Agent/04-开发计划/REDCap对接技术方案与实施指南.md
@@ -1,69 +1,69 @@
 # REDCap蟇ｹ謗･謚譛ｯ譁ｹ譯井ｸ主ｮ樊命謖<E591BD>漉

-**版本：** V1.0  
-**创建日期：** 2026-01-02  
-**适用阶段：** IIT Manager Agent MVP - Day 2  
-**文档性质：** 核心技术基石  
-**重要程度：** ⭐⭐⭐⭐⭐
+**迚域悽<EFBFBD>?* V1.0  
+**蛻帛ｻｺ譌･譛滂ｼ?* 2026-01-02  
+**騾ら畑髦ｶ谿ｵ<EFBFBD>?* IIT Manager Agent MVP - Day 2  
+**譁<EFBFBD>｡｣諤ｧ雍ｨ<EFBFBD>?* 譬ｸ蠢<EFBDB8>橿譛ｯ蝓ｺ遏? 
+**驥崎ｦ∫ｨ句ｺｦ<EFBFBD>?* 箝絶ｭ絶ｭ絶ｭ絶ｭ?

 ---

 ## <20>搭 譁<>｡｣逶ｮ譬<EFBDAE>

-本文档是IIT Manager Agent与REDCap集成的**权威技术指南**，明确：
-1. ✅ REDCap对接方式的技术选型
-2. ✅ Data Entry Trigger (DET) 的验证与配置
-3. ✅ REST API的使用方法
-4. ✅ 实时质控的完整架构
-5. ✅ Day 2的开发实施步骤
+譛ｬ譁<EFBFBD>｡｣譏ｯIIT Manager Agent荳山EDCap髮<EFBFBD><EFBFBD>逧?*譚<>ｨ∵橿譛ｯ謖<EFBDAF><E8AC96>?*<2A>梧<EFBFBD>遑ｮ<E98191><EFBDAE>
+1. 笨?REDCap蟇ｹ謗･譁ｹ蠑冗噪謚譛ｯ騾牙梛
+2. 笨?Data Entry Trigger (DET) 逧<EFBFBD>ｪ瑚ｯ∽ｸ朱<EFBFBD>鄂ｮ
+3. 笨?REST API逧<EFBFBD>ｽｿ逕ｨ譁ｹ豕?
+4. 笨?螳樊慮雍ｨ謗ｧ逧<EFBDA7>ｮ梧紛譫ｶ譫?
+5. 笨?Day 2逧<EFBFBD>ｼ蜿大ｮ樊命豁･鬪?

 ---

-## 🎯 核心结论（Executive Summary）
+## <EFBFBD>識 譬ｸ蠢<EFBDB8>ｻ楢ｮｺ<EFBDAE><EFBDBA>xecutive Summary<EFBFBD>?

-### ✅ **技术选型：DET（实时触发） + REST API（数据读写）**
+### 笨?**謚譛ｯ騾牙梛<E78999>咼ET<45>亥ｮ樊慮隗ｦ蜿托ｼ<E68998> + REST API<50>域焚謐ｮ隸ｻ蜀呻ｼ<E591BB>**

 **荳埼㊦逕ｨ<E98095><EFBDA8>** External Module (EM)  
-**原因：** EM需要PHP开发、侵入REDCap源码、维护成本高、不适合外部系统集成
+**蜴溷屏<EFBFBD>?* EM髴隕￣HP蠑蜿代∽ｾｵ蜈･REDCap貅千<E8B285>√∫ｻｴ謚､謌先悽鬮倥∽ｸ埼ょ粋螟夜Κ邉ｻ扈滄寔謌<E5AF94>

-**采用方案：**
+**驥<EFBFBD>畑譁ｹ譯茨ｼ?*

-| 组件 | 技术 | 用途 | 实时性 |
+| 扈<EFBFBD>ｻｶ | 謚譛?| 逕ｨ騾?| 螳樊慮諤?|
 |------|-----|------|--------|
-| **Data Entry Trigger** | REDCap原生功能 | 数据保存时实时通知 | 0秒延迟 |
+| **Data Entry Trigger** | REDCap蜴溽函蜉溯<EFBFBD> | 謨ｰ謐ｮ菫晏ｭ俶慮螳樊慮騾夂衍 | 0遘貞ｻｶ霑?|
 | **REST API (Export)** | HTTP + JSON | 諡牙叙謨ｰ謐ｮ縲∝<E7B8B2>謨ｰ謐ｮ | 謖蛾怙隹<E68099>畑 |
-| **REST API (Import)** | HTTP + JSON | 回写质控意见（Phase 2） | 按需调用 |
+| **REST API (Import)** | HTTP + JSON | 蝗槫<EFBFBD>雍ｨ謗ｧ諢剰ｧ<EFBFBD>ｼ<EFBFBD>hase 2<>?| 謖蛾怙隹<E68099>畑 |
 | **霓ｮ隸｢譛ｺ蛻ｶ** | pg-boss螳壽慮莉ｻ蜉｡ | 陦･蜈<EFBDA5>ET驕玲ｼ乗焚謐ｮ | 30蛻<30>帖 |

 ---

-## 🔍 技术调研结果
+## <EFBFBD>剥 謚譛ｯ隹<EFBDAF><E99AB9>皮ｻ捺<EFBDBB>?

-### 调研1：REDCap提供的对接方式
+### 隹<EFBFBD><EFBFBD><EFBFBD>1<EFBFBD>啌EDCap謠蝉ｾ帷噪蟇ｹ謗･譁ｹ蠑?

-**调研来源：**
+**隹<EFBFBD><EFBFBD>疲擂貅撰ｼ?*
 - REDCap 15.8.0貅千<EFBFBD><EFBFBD>
 - External Module Framework螳俶婿譁<E5A9BF>｡｣
- REDCap二次开发深度指南
+- REDCap莠梧ｬ｡蠑蜿第ｷｱ蠎ｦ謖<EFBFBD><EFBFBD>?

 **蜿醍鴫逧<E9B4AB>ｯｹ謗･譁ｹ蠑擾ｼ<E693BE>**

 | 譁ｹ蠑<EFBDB9> | 謚譛ｯ譬<EFBDAF> | 騾ら畑蝨ｺ譎ｯ | 謌台ｻｬ譏ｯ蜷ｦ騾ら畑 |
 |------|--------|---------|-------------|
-| **External Module** | PHP + Hook | REDCap内部功能扩展、UI定制 | ❌ 不适用 |
-| **REST API** | HTTP + JSON | 外部系统集成、数据同步 | ✅ **适用** |
-| **Data Entry Trigger** | Webhook | 实时通知外部系统 | ✅ **适用** |
+| **External Module** | PHP + Hook | REDCap蜀<EFBFBD>Κ蜉溯<EFBFBD>謇ｩ螻輔ゞI螳壼宛 | 笶?荳埼ら畑 |
+| **REST API** | HTTP + JSON | 螟夜Κ邉ｻ扈滄寔謌舌∵焚謐ｮ蜷梧ｭ?| 笨?**騾ら畑** |
+| **Data Entry Trigger** | Webhook | 螳樊慮騾夂衍螟夜Κ邉ｻ扈<EFBFBD> | 笨?**騾ら畑** |

 ### 隹<><E99AB9><EFBFBD>2<EFBFBD>咼ata Entry Trigger (DET) 鬪瑚ｯ<E7919A>

-**源码位置：**
+**貅千<EFBFBD>∽ｽ咲ｽｮ<EFBFBD>?*
 ```
 /var/www/html/redcap/redcap_v15.8.0/Classes/DataEntry.php
 /var/www/html/redcap/redcap_v15.8.0/ProjectSetup/index.php
 /var/www/html/redcap/redcap_v15.8.0/ControlCenter/modules_settings.php
 ```

-**关键代码：**
+**蜈ｳ髞ｮ莉｣遐<EFBFBD>ｼ?*
 ```php
 // DataEntry.php 譬ｸ蠢<EFBDB8>ｮ樒鴫
 global $data_entry_trigger_url, $data_entry_trigger_enabled;
@@ -74,88 +74,88 @@ if (!$data_entry_trigger_enabled || $data_entry_trigger_url == '') {
 $full_url = $pre_url . $data_entry_trigger_url;
 ```

-**验证结论：** ✅ DET是REDCap原生功能，真实存在且广泛使用
+**鬪瑚ｯ∫ｻ楢ｮｺ<EFBFBD>?* 笨?DET譏ｯREDCap蜴溽函蜉溯<EFBFBD><EFBFBD>檎悄螳槫ｭ伜惠荳泌ｹｿ豕帑ｽｿ逕ｨ

 ---

-## 🏗️ 完整架构设计
+## <EFBFBD>女<EFBFBD>?螳梧紛譫ｶ譫<EFBDB6>ｮｾ隶｡

-### 架构图
+### 譫ｶ譫<EFBFBD><EFBFBD>?

 ```
-┌─────────────────────────────────────────────────────┐
-│  1. CRC 在 REDCap 中保存记录                         │
-│     - 录入患者数据                                   │
-│     - 点击"Save"按钮                                 │
-└──────────────────┬──────────────────────────────────┘
-                   ↓ 立即触发（REDCap DET，0秒延迟）
-┌─────────────────────────────────────────────────────┐
-│  2. REDCap Data Entry Trigger (DET)                 │
-│     POST → https://iit.xunzhengyixue.com/           │
-│              api/v1/iit/webhooks/redcap             │
-│     Payload:                                         │
-│       - project_id: 16                               │
-│       - record: 101                                  │
-│       - instrument: demographics                     │
-│       - redcap_event_name: baseline_arm_1            │
-└──────────────────┬──────────────────────────────────┘
-                   ↓ 1秒内
-┌─────────────────────────────────────────────────────┐
-│  3. Node.js Webhook接收器                           │
-│     - 验证请求来源（可选）                           │
-│     - 立即返回200 OK（<100ms，不阻塞REDCap）        │
-│     - 异步调用质控流程（setImmediate）               │
-└──────────────────┬──────────────────────────────────┘
-                   ↓ 异步处理
-┌─────────────────────────────────────────────────────┐
-│  4. REDCap REST API - exportRecords                 │
-│     - 使用API Token认证                             │
-│     - 拉取指定record_id的完整数据                   │
-│     - 包含所有字段值、元数据                         │
-└──────────────────┬──────────────────────────────────┘
-                   ↓
-┌─────────────────────────────────────────────────────┐
-│  5. 推送到质控队列                                   │
-│     - jobQueue.send('iit:quality-check', record)    │
-│     - 异步处理，不影响实时响应                       │
-└──────────────────┬──────────────────────────────────┘
-                   ↓ 由QualityCheckAgent处理（Day 6）
-┌─────────────────────────────────────────────────────┐
-│  6. AI质控分析                                       │
-│     - 规则引擎验证                                   │
-│     - AI推理检测异常                                 │
-│     - 生成质控报告                                   │
-└──────────────────┬──────────────────────────────────┘
-                   ↓ 3-5秒内
-┌─────────────────────────────────────────────────────┐
-│  7. 多渠道反馈                                       │
-│     A. 企业微信推送给CRC（实时通知）                 │
-│     B. REDCap API importQueries（写回质疑）          │
-│     C. IIT Manager前端显示（待办事项）               │
-└─────────────────────────────────────────────────────┘
+笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+笏? 1. CRC 蝨?REDCap 荳ｭ菫晏ｭ倩ｮｰ蠖?                        笏?
+笏?    - 蠖募<EFBFBD>謔｣閠<EFBFBD>焚謐?                                  笏?
+笏?    - 轤ｹ蜃ｻ"Save"謖蛾聴                                 笏?
+笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+                   竊?遶句叉隗ｦ蜿托ｼ<E68998>EDCap DET<45>?遘貞ｻｶ霑滂ｼ<E6BB82>
+笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+笏? 2. REDCap Data Entry Trigger (DET)                 笏?
+笏?    POST 竊?https://iit.xunzhengyixue.com/           笏?
+笏?             api/v1/iit/webhooks/redcap             笏?
+笏?    Payload:                                         笏?
+笏?      - project_id: 16                               笏?
+笏?      - record: 101                                  笏?
+笏?      - instrument: demographics                     笏?
+笏?      - redcap_event_name: baseline_arm_1            笏?
+笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+                   竊?1遘貞<E98198>
+笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+笏? 3. Node.js Webhook謗･謾ｶ蝎?                          笏?
+笏?    - 鬪瑚ｯ∬ｯｷ豎よ擂貅撰ｼ亥庄騾会ｼ<EFBFBD>                           笏?
+笏?    - 遶句叉霑泌屓200 OK<EFBFBD>?100ms<EFBFBD>御ｸ埼仆蝪朿EDCap<EFBFBD>?       笏?
+笏?    - 蠑よｭ･隹<EFBFBD>畑雍ｨ謗ｧ豬∫ｨ具ｼ<EFBFBD>etImmediate<EFBFBD>?              笏?
+笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+                   竊?蠑よｭ･螟<EFBDA5>炊
+笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+笏? 4. REDCap REST API - exportRecords                 笏?
+笏?    - 菴ｿ逕ｨAPI Token隶､隸<EFBFBD>                             笏?
+笏?    - 諡牙叙謖<EFBFBD>ｮ嗷ecord_id逧<EFBFBD>ｮ梧紛謨ｰ謐?                  笏?
+笏?    - 蛹<EFBFBD>性謇譛牙ｭ玲ｮｵ蛟ｼ縲∝<EFBFBD>謨ｰ謐ｮ                         笏?
+笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+                   竊?
+笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+笏? 5. 謗ｨ騾∝芦雍ｨ謗ｧ髦溷<EFBFBD>                                   笏?
+笏?    - jobQueue.send('iit:quality-check', record)    笏?
+笏?    - 蠑よｭ･螟<EFBFBD>炊<EFBFBD>御ｸ榊ｽｱ蜩榊ｮ樊慮蜩榊ｺ<EFBFBD>                       笏?
+笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+                   竊?逕ｱQualityCheckAgent螟<EFBFBD>炊<EFBFBD><EFBFBD>ay 6<EFBFBD>?
+笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+笏? 6. AI雍ｨ謗ｧ蛻<EFBFBD>梵                                       笏?
+笏?    - 隗<EFBFBD><EFBFBD>蠑墓梼鬪瑚ｯ<EFBFBD>                                   笏?
+笏?    - AI謗ｨ逅<EFBFBD>｣豬句ｼょｸ?                                笏?
+笏?    - 逕滓<EFBFBD>雍ｨ謗ｧ謚･蜻<EFBFBD>                                   笏?
+笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+                   竊?3-5遘貞<EFBFBD>
+笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+笏? 7. 螟壽ｸ<EFBFBD>驕灘渚鬥?                                      笏?
+笏?    A. 莨∽ｸ壼ｾｮ菫｡謗ｨ騾∫ｻ僂RC<EFBFBD>亥ｮ樊慮騾夂衍<EFBFBD>?                笏?
+笏?    B. REDCap API importQueries<EFBFBD>亥<EFBFBD>蝗櫁ｴｨ逍托ｼ<EFBFBD>          笏?
+笏?    C. IIT Manager蜑咲ｫｯ譏ｾ遉ｺ<EFBFBD>亥ｾ<EFBFBD>萱莠矩｡ｹ<EFBFBD><EFBFBD>               笏?
+笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?

-┌─────────────────────────────────────────────────────┐
-│  补充：定时轮询机制（每30分钟）                      │
-│     - 防止DET遗漏数据                                │
-│     - 使用dateRangeBegin增量拉取                    │
-│     - 推送到相同的质控队列                           │
-└─────────────────────────────────────────────────────┘
+笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
+笏? 陦･蜈<EFBDA5>ｼ壼ｮ壽慮霓ｮ隸｢譛ｺ蛻ｶ<E89BBB>域ｯ?0蛻<30>帖<EFBFBD>?                     笏?
+笏?    - 髦ｲ豁｢DET驕玲ｼ乗焚謐ｮ                                笏?
+笏?    - 菴ｿ逕ｨdateRangeBegin蠅樣㍼諡牙叙                    笏?
+笏?    - 謗ｨ騾∝芦逶ｸ蜷檎噪雍ｨ謗ｧ髦溷<EFBFBD>?                          笏?
+笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
 ```

-### 实时性对比
+### 螳樊慮諤ｧ蟇ｹ豈?

 | 譁ｹ譯<EFBDB9> | 蟒ｶ霑滓慮髣ｴ | 謌台ｻｬ逧<EFBDAC>画叫 |
 |------|---------|-----------|
-| **纯轮询（每5分钟）** | 最高5分钟 | ❌ 不满足实时性要求 |
-| **纯轮询（每1分钟）** | 最高1分钟 | ⚠️ 资源浪费、延迟仍高 |
-| **DET + API** | 0秒触发 + 3-5秒处理 | ✅ **最优方案** |
-| **DET + 轮询补充** | 实时 + 可靠 | ✅ **最终架构** |
+| **郤ｯ霓ｮ隸｢<EFBFBD>域ｯ?蛻<>帖<EFBFBD>?* | 譛鬮?蛻<>帖 | 笶?荳肴ｻ｡雜ｳ螳樊慮諤ｧ隕∵ｱ?|
+| **郤ｯ霓ｮ隸｢<EFBFBD>域ｯ?蛻<>帖<EFBFBD>?* | 譛鬮?蛻<>帖 | 笞<><E7AC9E><EFBFBD> 襍<>ｺ先ｵｪ雍ｹ縲∝ｻｶ霑滉ｻ埼ｫ?|
+| **DET + API** | 0遘定ｧｦ蜿?+ 3-5遘貞､<E8B29E><EFBDA4>?| 笨?**譛莨俶婿譯?* |
+| **DET + 霓ｮ隸｢陦･蜈<EFBFBD>** | 螳樊慮 + 蜿ｯ髱<EFBDAF> | 笨?**譛扈域楔譫?* |

-**结论：** CRC点击"保存" → 5秒内收到企业微信通知 ✅
+**扈楢ｮｺ<EFBFBD>?* CRC轤ｹ蜃ｻ"菫晏ｭ<E6998F>" 竊?5遘貞<E98198>謾ｶ蛻ｰ莨∽ｸ壼ｾｮ菫｡騾夂衍 笨?

 ---

-## 📦 技术实现详解
+## <EFBFBD>逃 謚譛ｯ螳樒鴫隸ｦ隗?

 ### 1. Data Entry Trigger (DET) 驟咲ｽｮ

@@ -163,9 +163,9 @@ $full_url = $pre_url . $data_entry_trigger_url;

 ```
 1. 逋ｻ蠖紐EDCap<61>喇ttp://localhost:8080/
-2. 使用管理员账户（Admin / Admin123!）
-3. 进入：Control Center → "Additional Customizations"
-4. 找到："Data Entry Trigger" 选项
+2. 菴ｿ逕ｨ邂｡逅<EFBFBD>遭雍ｦ謌ｷ<EFBFBD><EFBFBD>dmin / Admin123!<EFBFBD>?
+3. 霑帛<EFBFBD><EFBFBD>咾ontrol Center 竊?"Additional Customizations"
+4. 謇ｾ蛻ｰ<EFBFBD>?Data Entry Trigger" 騾蛾｡ｹ
 5. 隶ｾ鄂ｮ荳ｺ<E88DB3><EFBDBA>"Enabled"
 6. 菫晏ｭ倬<EFBDAD>鄂ｮ
 ```
@@ -176,10 +176,10 @@ $full_url = $pre_url . $data_entry_trigger_url;

 ```
 1. 霑帛<E99C91>豬玖ｯ暮｡ｹ逶ｮ<E980B6>嗾est0102 (PID 16)
-2. 左侧菜单 → Project Setup
-3. 找到："Additional Customizations"
-4. 展开："Data Entry Trigger URL"
-5. 填入Webhook URL：
+2. 蟾ｦ萓ｧ闖懷黒 竊?Project Setup
+3. 謇ｾ蛻ｰ<EFBFBD>?Additional Customizations"
+4. 螻募ｼ<EFBFBD>?Data Entry Trigger URL"
+5. 蝪ｫ蜈･Webhook URL<EFBFBD>?
   - 蠑蜿醍識蠅<E8AD98>ｼ喇ttp://localhost:3001/api/v1/iit/webhooks/redcap
   - 豬玖ｯ慕識蠅<E8AD98>ｼ喇ttps://backend-dev.xunzhengyixue.com/api/v1/iit/webhooks/redcap
   - 逕滉ｺｧ邇ｯ蠅<EFBDAF>ｼ喇ttps://iit.xunzhengyixue.com/api/v1/iit/webhooks/redcap
@@ -190,22 +190,22 @@ $full_url = $pre_url . $data_entry_trigger_url;

 #### 豁･鬪､3<EFBDA4>夐ｪ瑚ｯ．ET驟咲ｽｮ

-**使用RequestBin/ngrok验证：**
+**菴ｿ逕ｨRequestBin/ngrok鬪瑚ｯ<EFBFBD>ｼ?*

 ```bash
-# 使用ngrok创建临时公网URL（开发测试用）
+# 菴ｿ逕ｨngrok蛻帛ｻｺ荳ｴ譌ｶ蜈ｬ鄂繕RL<EFBFBD>亥ｼ蜿第ｵ玖ｯ慕畑<EFBFBD>?
 ngrok http 3001

 # 蟆<>grok URL驟咲ｽｮ蛻ｰREDCap DET
 # 萓句ｦゑｼ喇ttps://1234-abc-def.ngrok.io/api/v1/iit/webhooks/redcap

-# 在REDCap中保存一条记录
+# 蝨ｨREDCap荳ｭ菫晏ｭ倅ｸ譚｡隶ｰ蠖?
 # 譽譟･ngrok謗ｧ蛻ｶ蜿ｰ譏ｯ蜷ｦ謾ｶ蛻ｰPOST隸ｷ豎<EFBDB7>
 ```

 #### DET逧ПOST Payload譬ｼ蠑<EFBDBC>

-**REDCap发送的请求：**
+**REDCap蜿鷹∫噪隸ｷ豎ゑｼ?*

 ```http
 POST /api/v1/iit/webhooks/redcap HTTP/1.1
@@ -221,7 +221,7 @@ project_id=16
 &redcap_url=http://localhost:8080/
 ```

-**字段说明：**
+**蟄玲ｮｵ隸ｴ譏趣ｼ?*

 | 蟄玲ｮｵ | 邀ｻ蝙<EFBDBB> | 隸ｴ譏<EFBDB4> | 遉ｺ萓<EFBDBA> |
 |------|-----|------|------|
@@ -229,7 +229,7 @@ project_id=16
 | `record` | string | 隶ｰ蠖肘D | "101" |
 | `instrument` | string | 陦ｨ蜊募錐遘ｰ | "demographics" |
 | `redcap_event_name` | string | 莠倶ｻｶ蜷咲ｧｰ<EFBDA7>育ｺｵ蜷醍<E89CB7>皮ｩｶ<EFBDA9><EFBDB6> | "baseline_arm_1" |
-| `[instrument]_complete` | string | 表单完成状态（0/1/2） | "2" |
+| `[instrument]_complete` | string | 陦ｨ蜊募ｮ梧<EFBFBD>迥ｶ諤<EFBFBD>ｼ<EFBFBD>0/1/2<EFBFBD>?| "2" |
 | `redcap_url` | string | REDCap螳樔ｾ偽RL | "http://localhost:8080/" |

 ---
@@ -244,23 +244,23 @@ http://localhost:8080/api/

 #### API隶､隸<EFBDA4>ｼ啜oken

-**生成步骤：**
+**逕滓<EFBFBD>豁･鬪､<EFBFBD>?*
 ```
 1. 逋ｻ蠖紐EDCap
 2. 霑帛<E99C91>鬘ｹ逶ｮ<E980B6>嗾est0102 (PID 16)
-3. 左侧菜单 → "API"
+3. 蟾ｦ萓ｧ闖懷黒 竊?"API"
 4. 轤ｹ蜃ｻ "Generate API Token"
-5. 复制Token（32位字符串）
+5. 螟榊宛Token<EFBFBD>?2菴榊ｭ礼ｬｦ荳ｲ<E88DB3>?
 6. 菫晏ｭ伜芦邇ｯ蠅<EFBDAF>序驥擾ｼ<E693BE>
   REDCAP_API_TOKEN_TEST=YOUR_TOKEN_HERE
 ```

-**Token存储：**
- ✅ 环境变量（推荐）
- ✅ 数据库加密字段（IitProject.redcapApiToken）
- ❌ 不要提交到Git
+**Token蟄伜お<EFBFBD>?*
+- 笨?邇ｯ蠅<EFBDAF>序驥擾ｼ域耳闕撰ｼ<E692B0>
+- 笨?謨ｰ謐ｮ蠎灘刈蟇<E58888>ｭ玲ｮｵ<EFBDAE><EFBDB5>itProject.redcapApiToken<EFBFBD>?
+- 笶?荳崎ｦ∵署莠､蛻ｰGit

-#### API方法1：导出记录 (exportRecords)
+#### API譁ｹ豕<EFBFBD>1<EFBFBD>壼ｯｼ蜃ｺ隶ｰ蠖?(exportRecords)

 **逕ｨ騾費ｼ<E8B2BB>** 諡牙叙謨ｰ謐ｮ<E8AC90>域髪謖∝｢樣㍼蜷梧ｭ･<EFBDAD><EFBDA5>

@@ -277,28 +277,28 @@ curl -X POST http://localhost:8080/api/ \
  -F "dateRangeBegin=2026-01-01 00:00:00"
 ```

-**参数说明：**
+**蜿よ焚隸ｴ譏趣ｼ?*

 | 蜿よ焚 | 蠢<>｡ｫ | 隸ｴ譏<EFBDB4> | 遉ｺ萓<EFBDBA> |
 |------|-----|------|------|
-| `token` | ✅ | API Token | "ABC123..." |
-| `content` | ✅ | 固定值 | "record" |
-| `format` | ✅ | 返回格式 | "json" |
-| `type` | ✅ | 数据结构 | "flat" |
-| `records` | ❌ | 指定记录ID | ["101", "102"] |
-| `fields` | ❌ | 指定字段 | ["age", "gender"] |
-| `dateRangeBegin` | ❌ | 时间过滤（增量同步关键） | "2026-01-01 00:00:00" |
-| `dateRangeEnd` | ❌ | 结束时间 | "2026-01-31 23:59:59" |
+| `token` | 笨?| API Token | "ABC123..." |
+| `content` | 笨?| 蝗ｺ螳壼?| "record" |
+| `format` | 笨?| 霑泌屓譬ｼ蠑<EFBDBC> | "json" |
+| `type` | 笨?| 謨ｰ謐ｮ扈捺桷 | "flat" |
+| `records` | 笶?| 謖<>ｮ夊ｮｰ蠖肘D | ["101", "102"] |
+| `fields` | 笶?| 謖<>ｮ壼ｭ玲ｮｵ | ["age", "gender"] |
+| `dateRangeBegin` | 笶?| 譌ｶ髣ｴ霑<EFBDB4>ｻ､<EFBDBB>亥｢樣㍼蜷梧ｭ･蜈ｳ髞ｮ<E9AB9E><EFBDAE> | "2026-01-01 00:00:00" |
+| `dateRangeEnd` | 笶?| 扈捺據譌ｶ髣ｴ | "2026-01-31 23:59:59" |

-**响应示例：**
+**蜩榊ｺ皮､ｺ萓具ｼ?*

 ```json
 [
  {
    "record_id": "101",
    "redcap_event_name": "baseline_arm_1",
-    "first_name": "张",
-    "last_name": "三",
+    "first_name": "蠑?,
+    "last_name": "荳?,
    "age": "30",
    "gender": "1",
    "demographics_complete": "2"
@@ -308,9 +308,9 @@ curl -X POST http://localhost:8080/api/ \

 #### API譁ｹ豕<EFBDB9>2<EFBFBD>壼ｯｼ蜃ｺ蜈<EFBDBA>焚謐ｮ (exportMetadata)

-**用途：** 获取字段定义、表单结构
+**逕ｨ騾費ｼ<EFBFBD>** 闔ｷ蜿門ｭ玲ｮｵ螳壻ｹ峨∬｡ｨ蜊慕ｻ捺<EFBDBB>?

-**请求示例：**
+**隸ｷ豎ら､ｺ萓具ｼ?*

 ```bash
 curl -X POST http://localhost:8080/api/ \
@@ -319,7 +319,7 @@ curl -X POST http://localhost:8080/api/ \
  -F "format=json"
 ```

-**响应示例：**
+**蜩榊ｺ皮､ｺ萓具ｼ?*

 ```json
 [
@@ -346,11 +346,11 @@ curl -X POST http://localhost:8080/api/ \
 ]
 ```

-#### API方法3：导入记录 (importRecords) - Phase 2
+#### API譁ｹ豕<EFBFBD>3<EFBFBD>壼ｯｼ蜈･隶ｰ蠖?(importRecords) - Phase 2

-**用途：** 回写数据（如质控意见、AI建议）
+**逕ｨ騾費ｼ<EFBFBD>** 蝗槫<E89D97>謨ｰ謐ｮ<E8AC90>亥ｦりｴｨ謗ｧ諢剰ｧ√、I蟒ｺ隶ｮ<E99AB6>?

-**请求示例：**
+**隸ｷ豎ら､ｺ萓具ｼ?*

 ```bash
 curl -X POST http://localhost:8080/api/ \
@@ -368,7 +368,7 @@ curl -X POST http://localhost:8080/api/ \

 #### 3.1 RedcapAdapter<65><72>PI騾る<E9A8BE>蝎ｨ<E89D8E><EFBDA8>

-**文件：** `backend/src/modules/iit-manager/adapters/RedcapAdapter.ts`
+**譁<EFBFBD>ｻｶ<EFBFBD>?* `backend/src/modules/iit-manager/adapters/RedcapAdapter.ts`

 ```typescript
 import axios from 'axios';
@@ -452,7 +452,7 @@ export class RedcapAdapter {
  }

  /**
-   * 导出元数据（字段定义）
+   * 蟇ｼ蜃ｺ蜈<EFBFBD>焚謐ｮ<EFBFBD>亥ｭ玲ｮｵ螳壻ｹ会ｼ?
   */
  async exportMetadata(): Promise<any[]> {
    const formData = new FormData();
@@ -523,7 +523,7 @@ export class RedcapAdapter {

 #### 3.2 WebhookController<65><72>ebhook謗･謾ｶ蝎ｨ<E89D8E><EFBDA8>

-**文件：** `backend/src/modules/iit-manager/controllers/webhookController.ts`
+**譁<EFBFBD>ｻｶ<EFBFBD>?* `backend/src/modules/iit-manager/controllers/webhookController.ts`

 ```typescript
 import { FastifyRequest, FastifyReply } from 'fastify';
@@ -536,7 +536,7 @@ export class WebhookController {
  /**
   * 謗･謾ｶREDCap Data Entry Trigger Webhook
   * 
-   * 性能要求：响应时间 < 100ms（不阻塞REDCap）
+   * 諤ｧ閭ｽ隕∵ｱゑｼ壼桃蠎疲慮髣?< 100ms<6D>井ｸ埼仆蝪朿EDCap<EFBFBD>?
   */
  async handleRedcapWebhook(
    request: FastifyRequest,
@@ -569,7 +569,7 @@ export class WebhookController {
      event: redcap_event_name
    });

-    // 立即返回200（不阻塞REDCap）
+    // 遶句叉霑泌屓200<EFBFBD>井ｸ埼仆蝪朿EDCap<EFBFBD>?
    const responseTime = Date.now() - startTime;
    reply.code(200).send({
      status: 'received',
@@ -577,7 +577,7 @@ export class WebhookController {
      response_time_ms: responseTime
    });

-    // 异步处理（不阻塞HTTP响应）
+    // 蠑よｭ･螟<EFBFBD>炊<EFBFBD>井ｸ埼仆蝪曰TTP蜩榊ｺ費ｼ?
    setImmediate(async () => {
      try {
        await this.processWebhook({
@@ -589,7 +589,7 @@ export class WebhookController {
        });
      } catch (error) {
        logger.error('Webhook processing failed:', error);
-        // 不抛出错误，因为已经返回200了
+        // 荳肴鴨蜃ｺ髞呵ｯｯ<EFBFBD>悟屏荳ｺ蟾ｲ扈剰ｿ泌屓200莠?
      }
    });
  }
@@ -616,7 +616,7 @@ export class WebhookController {
      return;
    }

-    // 2. 幂等性检查（防止重复处理）
+    // 2. 蟷らｭ画ｧ譽譟･<EFBFBD>磯亟豁｢驥榊､榊､<EFBFBD>炊<EFBFBD>?
    const isDuplicate = await this.checkDuplicate(
      project.id,
      record,
@@ -635,7 +635,7 @@ export class WebhookController {
    );

    const records = await adapter.exportRecords({
-      records: [record]  // 只拉取这一条记录
+      records: [record]  // 蜿ｪ諡牙叙霑吩ｸ譚｡隶ｰ蠖?
    });

    if (records.length === 0) {
@@ -699,7 +699,7 @@ export class WebhookController {

 #### 3.3 SyncManager<65>郁ｽｮ隸｢陦･蜈<EFBDA5>ｼ<EFBFBD>

-**文件：** `backend/src/modules/iit-manager/services/SyncManager.ts`
+**譁<EFBFBD>ｻｶ<EFBFBD>?* `backend/src/modules/iit-manager/services/SyncManager.ts`

 ```typescript
 import { prisma } from '@/config/database';
@@ -709,10 +709,10 @@ import { RedcapAdapter } from '../adapters/RedcapAdapter';

 export class SyncManager {
  /**
-   * 初始化同步（注册定时任务）
+   * 蛻晏ｧ句喧蜷梧ｭ･<EFBFBD>域ｳｨ蜀悟ｮ壽慮莉ｻ蜉｡<EFBFBD>?
   */
  async initializeSync(projectId: string, interval: string = '*/30 * * * *'): Promise<void> {
-    // 注册定时任务（每30分钟）
+    // 豕ｨ蜀悟ｮ壽慮莉ｻ蜉｡<EFBFBD>域ｯ<EFBFBD>30蛻<EFBFBD>帖<EFBFBD>?
    await jobQueue.schedule(
      'iit:redcap:poll',
      interval,
@@ -783,7 +783,7 @@ export class SyncManager {
   * 蛛懈ｭ｢蜷梧ｭ･<EFBDAD>亥叙豸亥ｮ壽慮莉ｻ蜉｡<E89C89><EFBDA1>
   */
  async stopSync(projectId: string): Promise<void> {
-    // pg-boss不支持直接取消schedule，需要在Worker中检查项目状态
+    // pg-boss荳肴髪謖∫峩謗･蜿匁ｶ<EFBFBD>chedule<EFBFBD>碁怙隕∝惠Worker荳ｭ譽譟･鬘ｹ逶ｮ迥ｶ諤?
    logger.info(`Sync stopped for project ${projectId}`);
  }
 }
@@ -791,7 +791,7 @@ export class SyncManager {

 #### 3.4 霍ｯ逕ｱ驟咲ｽｮ

-**文件：** `backend/src/modules/iit-manager/routes/index.ts`
+**譁<EFBFBD>ｻｶ<EFBFBD>?* `backend/src/modules/iit-manager/routes/index.ts`

 ```typescript
 import { FastifyInstance } from 'fastify';
@@ -802,12 +802,12 @@ export async function iitManagerRoutes(fastify: FastifyInstance) {
  const webhookController = new WebhookController();
  const syncManager = new SyncManager();

-  // Webhook端点（接收REDCap DET）
+  // Webhook遶ｯ轤ｹ<EFBFBD>域磁謾ｶREDCap DET<EFBFBD>?
  fastify.post('/webhooks/redcap', async (request, reply) => {
    return webhookController.handleRedcapWebhook(request, reply);
  });

-  // 手动触发同步（测试用）
+  // 謇句勘隗ｦ蜿大酔豁･<EFBFBD>域ｵ玖ｯ慕畑<EFBFBD>?
  fastify.post('/projects/:id/sync', async (request, reply) => {
    const { id } = request.params as { id: string };
    await syncManager.handlePoll(id);
@@ -818,7 +818,7 @@ export async function iitManagerRoutes(fastify: FastifyInstance) {

 #### 3.5 Worker豕ｨ蜀<EFBDA8>

-**文件：** `backend/src/modules/iit-manager/index.ts`
+**譁<EFBFBD>ｻｶ<EFBFBD>?* `backend/src/modules/iit-manager/index.ts`

 ```typescript
 import { jobQueue } from '@/common/jobs';
@@ -844,19 +844,19 @@ export async function initializeIITManager() {

 ### 豬玖ｯ<E78E96>1<EFBFBD>夐ｪ瑚ｯ．ET驟咲ｽｮ

-**步骤：**
+**豁･鬪､<EFBFBD>?*
 1. 驟咲ｽｮngrok<6F>啻ngrok http 3001`
 2. 蟆<>grok URL驟咲ｽｮ蛻ｰREDCap DET
-3. 在REDCap中保存一条记录
+3. 蝨ｨREDCap荳ｭ菫晏ｭ倅ｸ譚｡隶ｰ蠖?
 4. 譽譟･ngrok謗ｧ蛻ｶ蜿ｰ譏ｯ蜷ｦ謾ｶ蛻ｰPOST隸ｷ豎<EFBDB7>

-**预期结果：**
- ✅ ngrok收到POST请求
- ✅ Payload包含project_id、record等字段
+**鬚<EFBFBD>悄扈捺棡<EFBFBD>?*
+- 笨?ngrok謾ｶ蛻ｰPOST隸ｷ豎<EFBFBD>
+- 笨?Payload蛹<EFBFBD>性project_id縲〉ecord遲牙ｭ玲ｮ?

 ### 豬玖ｯ<E78E96>2<EFBFBD>夐ｪ瑚ｯ、PI Token

-**测试脚本：** `test-redcap-api.ts`
+**豬玖ｯ戊<EFBFBD>譛ｬ<EFBFBD>?* `test-redcap-api.ts`

 ```typescript
 import { RedcapAdapter } from './adapters/RedcapAdapter';
@@ -871,11 +871,11 @@ async function testRedcapAPI() {
  const records = await adapter.exportRecords();
  console.log('Records:', records);

-  // 测试导出元数据
+  // 豬玖ｯ募ｯｼ蜃ｺ蜈<EFBFBD>焚謐?
  const metadata = await adapter.exportMetadata();
  console.log('Metadata fields:', metadata.length);

-  console.log('✅ REDCap API test passed!');
+  console.log('笨?REDCap API test passed!');
 }

 testRedcapAPI();
@@ -883,7 +883,7 @@ testRedcapAPI();

 ### 豬玖ｯ<E78E96>3<EFBFBD>夂ｫｯ蛻ｰ遶ｯ髮<EFBDAF><E9ABAE>豬玖ｯ<E78E96>

-**测试脚本：** `test-redcap-integration.ts`
+**豬玖ｯ戊<EFBFBD>譛ｬ<EFBFBD>?* `test-redcap-integration.ts`

 ```typescript
 async function testIntegration() {
@@ -898,11 +898,11 @@ async function testIntegration() {
    }
  });

-  // 2. 初始化同步
+  // 2. 蛻晏ｧ句喧蜷梧ｭ?
  const syncManager = new SyncManager();
  await syncManager.initializeSync(project.id);

-  // 3. 手动触发一次轮询
+  // 3. 謇句勘隗ｦ蜿台ｸ谺｡霓ｮ隸?
  await syncManager.handlePoll(project.id);

  // 4. 讓｡諡欷ebhook
@@ -918,7 +918,7 @@ async function testIntegration() {
    {} as any
  );

-  console.log('✅ Integration test passed!');
+  console.log('笨?Integration test passed!');
 }
 ```

@@ -926,18 +926,18 @@ async function testIntegration() {

 ## <20>搭 Day 2螳樊命貂<E591BD>黒

-### 阶段1：环境准备（30分钟）
+### 髦ｶ谿ｵ1<EFBFBD>夂識蠅<EFBFBD>㊥螟<EFBFBD>ｼ<EFBFBD>30蛻<EFBFBD>帖<EFBFBD>?

 - [ ] 蝨ｨREDCap Control Center蜷ｯ逕ｨDET蜉溯<E89C89>
 - [ ] 蝨ｨtest0102鬘ｹ逶ｮ逕滓<E98095>API Token
- [ ] 配置环境变量：
+- [ ] 驟咲ｽｮ邇ｯ蠅<EFBFBD>序驥擾ｼ?
  ```env
  REDCAP_BASE_URL=http://localhost:8080
  REDCAP_API_TOKEN_TEST=YOUR_TOKEN_HERE
  ```
 - [ ] 菴ｿ逕ｨcurl豬玖ｯ柊PI譏ｯ蜷ｦ蜿ｯ逕ｨ

-### 阶段2：开发RedcapAdapter（1.5小时）
+### 髦ｶ谿ｵ2<EFBFBD>壼ｼ蜿然edcapAdapter<EFBFBD>?.5蟆乗慮<EFBFBD>?

 - [ ] 蛻帛ｻｺ譁<EFBDBA>ｻｶ<EFBDBB>啻adapters/RedcapAdapter.ts`
 - [ ] 螳樒鴫 `exportRecords()` 譁ｹ豕<EFBDB9>
@@ -945,15 +945,15 @@ async function testIntegration() {
 - [ ] 螳樒鴫 `formatRedcapDate()` 蟾･蜈ｷ譁ｹ豕<EFBDB9>
 - [ ] 郛門<E9839B>蜊募<E89C8A>豬玖ｯ包ｼ啻RedcapAdapter.test.ts`

-### 阶段3：开发WebhookController（2小时）
+### 髦ｶ谿ｵ3<EFBFBD>壼ｼ蜿糎ebhookController<EFBFBD>?蟆乗慮<E4B997>?

 - [ ] 蛻帛ｻｺ譁<EFBDBA>ｻｶ<EFBDBB>啻controllers/webhookController.ts`
 - [ ] 螳樒鴫 `handleRedcapWebhook()` 譁ｹ豕<EFBDB9>
 - [ ] 螳樒鴫 `processWebhook()` 遘∵怏譁ｹ豕<EFBDB9>
- [ ] 实现 `checkDuplicate()` 幂等性检查
+- [ ] 螳樒鴫 `checkDuplicate()` 蟷らｭ画ｧ譽譟?
 - [ ] 驟咲ｽｮ霍ｯ逕ｱ<E98095>啻POST /api/v1/iit/webhooks/redcap`

-### 阶段4：开发SyncManager（1.5小时）
+### 髦ｶ谿ｵ4<EFBFBD>壼ｼ蜿全yncManager<EFBFBD>?.5蟆乗慮<EFBFBD>?

 - [ ] 蛻帛ｻｺ譁<EFBDBA>ｻｶ<EFBDBB>啻services/SyncManager.ts`
 - [ ] 螳樒鴫 `initializeSync()` 譁ｹ豕<EFBDB9>
@@ -961,19 +961,19 @@ async function testIntegration() {
 - [ ] 螳樒鴫 `stopSync()` 譁ｹ豕<EFBDB9>
 - [ ] 豕ｨ蜀係orker<65>啻iit:redcap:poll`

-### 阶段5：集成测试（1小时）
+### 髦ｶ谿ｵ5<EFBFBD>夐寔謌先ｵ玖ｯ包ｼ<EFBFBD>1蟆乗慮<EFBFBD>?

 - [ ] 驟咲ｽｮngrok/RequestBin豬玖ｯ疋ET
 - [ ] 霑占｡<E58DA0> `test-redcap-api.ts`
 - [ ] 霑占｡<E58DA0> `test-redcap-integration.ts`
- [ ] 验证端到端流程
+- [ ] 鬪瑚ｯ∫ｫｯ蛻ｰ遶ｯ豬∫ｨ?
 - [ ] 隶ｰ蠖墓ｵ玖ｯ慕ｻ捺棡

-### 阶段6：文档更新（30分钟）
+### 髦ｶ谿ｵ6<EFBFBD>壽枚譯｣譖ｴ譁ｰ<EFBFBD><EFBFBD>30蛻<EFBFBD>帖<EFBFBD>?

- [ ] 更新MVP开发任务清单（Day 2完成）
- [ ] 记录API Token和配置信息
- [ ] 更新架构图
+- [ ] 譖ｴ譁ｰMVP蠑蜿台ｻｻ蜉｡貂<EFBDA1>黒<EFBFBD><E9BB92>ay 2螳梧<E89EB3><E6A2A7>?
+- [ ] 隶ｰ蠖柊PI Token蜥碁<EFBFBD>鄂ｮ菫｡諱?
+- [ ] 譖ｴ譁ｰ譫ｶ譫<EFBDB6><E8ADAB>?
 - [ ] 謠蝉ｺ､Git

 ---
@@ -982,48 +982,48 @@ async function testIntegration() {

 ### 1. DET驟咲ｽｮ隕∫せ

-**常见错误：**
- ❌ 忘记在Control Center启用DET全局开关
- ❌ Webhook URL填写错误（多了斜杠、少了路径）
- ❌ 本地开发环境无法接收外网Webhook
+**蟶ｸ隗<EFBFBD>漠隸ｯ<EFBFBD>?*
+- 笶?蠢倩ｮｰ蝨ｨControl Center蜷ｯ逕ｨDET蜈ｨ螻蠑蜈?
+- 笶?Webhook URL蝪ｫ蜀咎漠隸ｯ<EFBFBD>亥､壻ｺ<EFBFBD>万譚<EFBFBD>縲∝ｰ台ｺ<EFBFBD>ｷｯ蠕<EFBFBD>ｼ<EFBFBD>
+- 笶?譛ｬ蝨ｰ蠑蜿醍識蠅<E8AD98>裏豕墓磁謾ｶ螟也ｽ糎ebhook

-**解决方案：**
- ✅ 使用ngrok创建临时公网URL测试
- ✅ 开发环境可先用RequestBin验证Payload格式
- ✅ 生产环境确保URL可访问（防火墙、HTTPS）
+**隗｣蜀ｳ譁ｹ譯茨ｼ?*
+- 笨?菴ｿ逕ｨngrok蛻帛ｻｺ荳ｴ譌ｶ蜈ｬ鄂繕RL豬玖ｯ<E78E96>
+- 笨?蠑蜿醍識蠅<E8AD98>庄蜈育畑RequestBin鬪瑚ｯ￣ayload譬ｼ蠑<EFBFBD>
+- 笨?逕滉ｺｧ邇ｯ蠅<EFBDAF>｡ｮ菫拔RL蜿ｯ隶ｿ髣ｮ<E9ABA3>磯亟轣ｫ蠅吶？TTPS<EFBFBD>?

 ### 2. API Token螳牙<E89EB3>

-**安全实践：**
- ✅ 存储在环境变量或数据库加密字段
- ✅ 定期轮换Token
- ✅ 最小权限原则（只开启需要的权限）
- ❌ 不要提交到Git
- ❌ 不要在日志中打印完整Token
+**螳牙<EFBFBD>螳櫁ｷｵ<EFBFBD>?*
+- 笨?蟄伜お蝨ｨ邇ｯ蠅<EFBDAF>序驥乗<E9A9A5>謨ｰ謐ｮ蠎灘刈蟇<E58888>ｭ玲ｮ?
+- 笨?螳壽悄霓ｮ謐｢Token
+- 笨?譛蟆乗揀髯仙次蛻呻ｼ亥宵蠑蜷ｯ髴隕∫噪譚<E599AA>剞<EFBFBD>?
+- 笶?荳崎ｦ∵署莠､蛻ｰGit
+- 笶?荳崎ｦ∝惠譌･蠢嶺ｸｭ謇灘魂螳梧紛Token

 ### 3. 諤ｧ閭ｽ莨伜喧

-**Webhook响应时间：**
- ✅ 必须 < 100ms（立即返回200）
- ✅ 使用 `setImmediate()` 异步处理
- ❌ 不要在Webhook中执行耗时操作
+**Webhook蜩榊ｺ疲慮髣ｴ<EFBFBD>?*
+- 笨?蠢<>｡ｻ < 100ms<6D>育ｫ句叉霑泌<E99C91>?00<30>?
+- 笨?菴ｿ逕ｨ `setImmediate()` 蠑よｭ･螟<EFBDA5>炊
+- 笶?荳崎ｦ∝惠Webhook荳ｭ謇ｧ陦瑚玲慮謫堺ｽ<E5A0BA>

-**API调用频率：**
- ✅ 增量拉取（使用dateRangeBegin）
- ✅ 指定字段（减少数据量）
- ✅ 合理设置timeout（30秒）
+**API隹<EFBFBD>畑鬚醍紫<EFBFBD>?*
+- 笨?蠅樣㍼諡牙叙<E78999>井ｽｿ逕ｨdateRangeBegin<EFBFBD>?
+- 笨?謖<>ｮ壼ｭ玲ｮｵ<EFBDAE>亥㍼蟆第焚謐ｮ驥擾ｼ?
+- 笨?蜷育炊隶ｾ鄂ｮtimeout<75>?0遘抵ｼ<E68AB5>

 ### 4. 髞呵ｯｯ螟<EFBDAF>炊

-**DET Webhook失败：**
- REDCap会重试3次（间隔1分钟）
+**DET Webhook螟ｱ雍･<EFBFBD>?*
+- REDCap莨夐㍾隸?谺｡<E8B0BA>磯龍髫<E9BE8D>1蛻<31>帖<EFBFBD>?
 - 螯よ棡莉榊､ｱ雍･<E99B8D>軍EDCap莨夊ｮｰ蠖募芦譌･蠢<EFBDA5>
 - 謌台ｻｬ逧<EFBDAC>ｽｮ隸｢譛ｺ蛻ｶ蜿ｯ莉･陦･蜈<EFBDA5>＠貍冗噪謨ｰ謐ｮ

-**API调用失败：**
- 实现重试机制（3次，指数退避）
+**API隹<EFBFBD>畑螟ｱ雍･<EFBFBD>?*
+- 螳樒鴫驥崎ｯ墓惻蛻ｶ<E89BBB>?谺｡<E8B0BA>梧欠謨ｰ騾驕ｿ<E9A995><EFBDBF>
 - 隶ｰ蠖募､ｱ雍･譌･蠢<EFBDA5>
- 告警通知管理员
+- 蜻願ｭｦ騾夂衍邂｡逅<EFBDA1><E98085>?

 ---

@@ -1031,41 +1031,42 @@ async function testIntegration() {

 ### Day 2螳梧<E89EB3>譬<EFBFBD>㊥

- [ ] ✅ REDCap API Token已生成并验证
- [ ] ✅ RedcapAdapter可以拉取测试数据
- [ ] ✅ DET已配置并成功接收Webhook
- [ ] ✅ Webhook可以触发API拉取
- [ ] ✅ 轮询机制可以定时运行
- [ ] ✅ 数据推送到质控队列
- [ ] ✅ 单元测试全部通过
- [ ] ✅ 端到端集成测试通过
+- [ ] 笨?REDCap API Token蟾ｲ逕滓<EFBFBD>蟷ｶ鬪瑚ｯ<EFBFBD>
+- [ ] 笨?RedcapAdapter蜿ｯ莉･諡牙叙豬玖ｯ墓焚謐ｮ
+- [ ] 笨?DET蟾ｲ驟咲ｽｮ蟷ｶ謌仙粥謗･謾ｶWebhook
+- [ ] 笨?Webhook蜿ｯ莉･隗ｦ蜿羨PI諡牙叙
+- [ ] 笨?霓ｮ隸｢譛ｺ蛻ｶ蜿ｯ莉･螳壽慮霑占｡<E58DA0>
+- [ ] 笨?謨ｰ謐ｮ謗ｨ騾∝芦雍ｨ謗ｧ髦溷<E9ABA6>
+- [ ] 笨?蜊募<E89C8A>豬玖ｯ募<EFBDAF>驛ｨ騾夊ｿ<E5A48A>
+- [ ] 笨?遶ｯ蛻ｰ遶ｯ髮<EFBDAF><E9ABAE>豬玖ｯ暮夊ｿ<E5A48A>

 ### 諤ｧ閭ｽ謖<EFBDBD><E8AC96><EFBFBD>

 - [ ] Webhook蜩榊ｺ疲慮髣ｴ < 100ms
- [ ] API调用成功率 > 99%
- [ ] 端到端延迟 < 5秒（DET触发 → 企微通知）
+- [ ] API隹<EFBFBD>畑謌仙粥邇?> 99%
+- [ ] 遶ｯ蛻ｰ遶ｯ蟒ｶ霑?< 5遘抵ｼ<E68AB5>ET隗ｦ蜿<EFBDA6> 竊?莨∝ｾｮ騾夂衍<E5A482>?

 ---

 ## <20>迫 逶ｸ蜈ｳ譁<EFBDB3>｡｣

- **MVP开发任务清单：** `MVP开发任务清单.md`
- **完整技术方案：** `IIT Manager Agent 完整技术开发方案 (V1.1).md`
- **REDCap二次开发指南：** `../../Redcap/03-API对接与开发/33-REDCap二次开发深度指南.md`
- **REDCap部署手册：** `../../Redcap/01-部署与配置/10-REDCap_Docker部署操作手册.md`
+- **MVP蠑蜿台ｻｻ蜉｡貂<EFBFBD>黒<EFBFBD><EFBFBD>** `MVP蠑蜿台ｻｻ蜉｡貂<EFBFBD><EFBFBD>?md`
+- **螳梧紛謚譛ｯ譁ｹ譯茨ｼ<E88CA8>** `IIT Manager Agent 螳梧紛謚譛ｯ蠑蜿第婿譯?(V1.1).md`
+- **REDCap莠梧ｬ｡蠑蜿第欠蜊暦ｼ<EFBFBD>** `../../Redcap/03-API蟇ｹ謗･荳主ｼ蜿?33-REDCap莠梧ｬ｡蠑蜿第ｷｱ蠎ｦ謖<EFBDA6><E8AC96>?md`
+- **REDCap驛ｨ鄂ｲ謇句<EFBFBD><EFBFBD>?* `../../Redcap/01-驛ｨ鄂ｲ荳朱<EFBFBD>鄂?10-REDCap_Docker驛ｨ鄂ｲ謫堺ｽ懈焔蜀<EFBFBD>.md`

 ---

 ## <20>統 譖ｴ譁ｰ譌･蠢<EFBDA5>

-| 日期 | 版本 | 更新内容 | 更新人 |
+| 譌･譛<EFBFBD> | 迚域悽 | 譖ｴ譁ｰ蜀<EFBDB0>ｮｹ | 譖ｴ譁ｰ莠?|
 |------|------|---------|--------|
 | 2026-01-02 | V1.0 | 蛻晏ｧ狗沿譛ｬ<E8AD9B>悟ｮ梧<EFBDAE>謚譛ｯ隹<EFBDAF><E99AB9>泌柱譁ｹ譯郁ｮｾ隶｡ | AI Assistant |

 ---

-**这是IIT Manager Agent的技术基石文档，请妥善保管！** ⭐⭐⭐⭐⭐
+**霑呎弍IIT Manager Agent逧<EFBFBD>橿譛ｯ蝓ｺ遏ｳ譁<EFBFBD>｡｣<EFBFBD>瑚ｯｷ螯･蝟<EFBFBD>ｿ晉ｮ｡<EFBFBD><EFBFBD>** 箝絶ｭ絶ｭ絶ｭ絶ｭ?
+