HaHafeng
1b53ab9d52
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%)
1090 lines
30 KiB
Markdown
1090 lines
30 KiB
Markdown
# REDCap蟇ｹ謗･謚譛ｯ譁ｹ譯井ｸ主ｮ樊命謖<E591BD>漉
|
||
|
||
**迚域悽<E59F9F>?* V1.0
|
||
**蛻帛ｻｺ譌･譛滂ｼ?* 2026-01-02
|
||
**騾ら畑髦ｶ谿ｵ<E8B0BF>?* IIT Manager Agent MVP - Day 2
|
||
**譁<>｡｣諤ｧ雍ｨ<E99B8D>?* 譬ｸ蠢<EFBDB8>橿譛ｯ蝓ｺ遏?
|
||
**驥崎ｦ∫ｨ句ｺｦ<EFBDBA>?* 箝絶ｭ絶ｭ絶ｭ絶ｭ?
|
||
|
||
---
|
||
|
||
## <20>搭 譁<>｡｣逶ｮ譬<EFBDAE>
|
||
|
||
譛ｬ譁<EFBFBD>｡｣譏ｯIIT Manager Agent荳山EDCap髮<70><E9ABAE>逧?*譚<>ｨ∵橿譛ｯ謖<EFBDAF><E8AC96>?*<2A>梧<EFBFBD>遑ｮ<E98191><EFBDAE>
|
||
1. 笨?REDCap蟇ｹ謗･譁ｹ蠑冗噪謚譛ｯ騾牙梛
|
||
2. 笨?Data Entry Trigger (DET) 逧<>ｪ瑚ｯ∽ｸ朱<EFBDB8>鄂ｮ
|
||
3. 笨?REST API逧<49>ｽｿ逕ｨ譁ｹ豕?
|
||
4. 笨?螳樊慮雍ｨ謗ｧ逧<EFBDA7>ｮ梧紛譫ｶ譫?
|
||
5. 笨?Day 2逧<32>ｼ蜿大ｮ樊命豁･鬪?
|
||
|
||
---
|
||
|
||
## <20>識 譬ｸ蠢<EFBDB8>ｻ楢ｮｺ<EFBDAE><EFBDBA>xecutive Summary<72>?
|
||
|
||
### 笨?**謚譛ｯ騾牙梛<E78999>咼ET<45>亥ｮ樊慮隗ｦ蜿托ｼ<E68998> + REST API<50>域焚謐ｮ隸ｻ蜀呻ｼ<E591BB>**
|
||
|
||
**荳埼㊦逕ｨ<E98095><EFBDA8>** External Module (EM)
|
||
**蜴溷屏<E6BAB7>?* EM髴隕￣HP蠑蜿代∽ｾｵ蜈･REDCap貅千<E8B285>√∫ｻｴ謚､謌先悽鬮倥∽ｸ埼ょ粋螟夜Κ邉ｻ扈滄寔謌<E5AF94>
|
||
|
||
**驥<>畑譁ｹ譯茨ｼ?*
|
||
|
||
| 扈<>ｻｶ | 謚譛?| 逕ｨ騾?| 螳樊慮諤?|
|
||
|------|-----|------|--------|
|
||
| **Data Entry Trigger** | REDCap蜴溽函蜉溯<E89C89> | 謨ｰ謐ｮ菫晏ｭ俶慮螳樊慮騾夂衍 | 0遘貞ｻｶ霑?|
|
||
| **REST API (Export)** | HTTP + JSON | 諡牙叙謨ｰ謐ｮ縲∝<E7B8B2>謨ｰ謐ｮ | 謖蛾怙隹<E68099>畑 |
|
||
| **REST API (Import)** | HTTP + JSON | 蝗槫<E89D97>雍ｨ謗ｧ諢剰ｧ<E589B0>ｼ<EFBFBD>hase 2<>?| 謖蛾怙隹<E68099>畑 |
|
||
| **霓ｮ隸｢譛ｺ蛻ｶ** | pg-boss螳壽慮莉ｻ蜉｡ | 陦･蜈<EFBDA5>ET驕玲ｼ乗焚謐ｮ | 30蛻<30>帖 |
|
||
|
||
---
|
||
|
||
## <20>剥 謚譛ｯ隹<EFBDAF><E99AB9>皮ｻ捺<EFBDBB>?
|
||
|
||
### 隹<><E99AB9><EFBFBD>1<EFBFBD>啌EDCap謠蝉ｾ帷噪蟇ｹ謗･譁ｹ蠑?
|
||
|
||
**隹<><E99AB9>疲擂貅撰ｼ?*
|
||
- REDCap 15.8.0貅千<EFBFBD><EFBFBD>
|
||
- External Module Framework螳俶婿譁<E5A9BF>｡｣
|
||
- REDCap莠梧ｬ｡蠑蜿第ｷｱ蠎ｦ謖<EFBDA6><E8AC96>?
|
||
|
||
**蜿醍鴫逧<E9B4AB>ｯｹ謗･譁ｹ蠑擾ｼ<E693BE>**
|
||
|
||
| 譁ｹ蠑<EFBDB9> | 謚譛ｯ譬<EFBDAF> | 騾ら畑蝨ｺ譎ｯ | 謌台ｻｬ譏ｯ蜷ｦ騾ら畑 |
|
||
|------|--------|---------|-------------|
|
||
| **External Module** | PHP + Hook | REDCap蜀<70>Κ蜉溯<E89C89>謇ｩ螻輔ゞI螳壼宛 | 笶?荳埼ら畑 |
|
||
| **REST API** | HTTP + JSON | 螟夜Κ邉ｻ扈滄寔謌舌∵焚謐ｮ蜷梧ｭ?| 笨?**騾ら畑** |
|
||
| **Data Entry Trigger** | Webhook | 螳樊慮騾夂衍螟夜Κ邉ｻ扈<EFBDBB> | 笨?**騾ら畑** |
|
||
|
||
### 隹<><E99AB9><EFBFBD>2<EFBFBD>咼ata Entry Trigger (DET) 鬪瑚ｯ<E7919A>
|
||
|
||
**貅千<E8B285>∽ｽ咲ｽｮ<EFBDBD>?*
|
||
```
|
||
/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
|
||
```
|
||
|
||
**蜈ｳ髞ｮ莉｣遐<EFBDA3>ｼ?*
|
||
```php
|
||
// DataEntry.php 譬ｸ蠢<EFBDB8>ｮ樒鴫
|
||
global $data_entry_trigger_url, $data_entry_trigger_enabled;
|
||
if (!$data_entry_trigger_enabled || $data_entry_trigger_url == '') {
|
||
return;
|
||
}
|
||
// 蜿鷹？TTP POST蛻ｰ驟咲ｽｮ逧ФRL
|
||
$full_url = $pre_url . $data_entry_trigger_url;
|
||
```
|
||
|
||
**鬪瑚ｯ∫ｻ楢ｮｺ<EFBDAE>?* 笨?DET譏ｯREDCap蜴溽函蜉溯<E89C89><E6BAAF>檎悄螳槫ｭ伜惠荳泌ｹｿ豕帑ｽｿ逕ｨ
|
||
|
||
---
|
||
|
||
## <20>女<EFBFBD>?螳梧紛譫ｶ譫<EFBDB6>ｮｾ隶｡
|
||
|
||
### 譫ｶ譫<EFBDB6><E8ADAB>?
|
||
|
||
```
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 1. CRC 蝨?REDCap 荳ｭ菫晏ｭ倩ｮｰ蠖? 笏?
|
||
笏? - 蠖募<E8A096>謔｣閠<EFBDA3>焚謐? 笏?
|
||
笏? - 轤ｹ蜃ｻ"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謗･謾ｶ蝎? 笏?
|
||
笏? - 鬪瑚ｯ∬ｯｷ豎よ擂貅撰ｼ亥庄騾会ｼ<E4BC9A> 笏?
|
||
笏? - 遶句叉霑泌屓200 OK<4F>?100ms<6D>御ｸ埼仆蝪朿EDCap<61>? 笏?
|
||
笏? - 蠑よｭ･隹<EFBDA5>畑雍ｨ謗ｧ豬∫ｨ具ｼ<E585B7>etImmediate<74>? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?蠑よｭ･螟<EFBDA5>炊
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 4. REDCap REST API - exportRecords 笏?
|
||
笏? - 菴ｿ逕ｨAPI Token隶､隸<EFBDA4> 笏?
|
||
笏? - 諡牙叙謖<E58F99>ｮ嗷ecord_id逧<64>ｮ梧紛謨ｰ謐? 笏?
|
||
笏? - 蛹<>性謇譛牙ｭ玲ｮｵ蛟ｼ縲∝<E7B8B2>謨ｰ謐ｮ 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 5. 謗ｨ騾∝芦雍ｨ謗ｧ髦溷<E9ABA6> 笏?
|
||
笏? - jobQueue.send('iit:quality-check', record) 笏?
|
||
笏? - 蠑よｭ･螟<EFBDA5>炊<EFBFBD>御ｸ榊ｽｱ蜩榊ｮ樊慮蜩榊ｺ<E6A68A> 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?逕ｱQualityCheckAgent螟<74>炊<EFBFBD><E7828A>ay 6<>?
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 6. AI雍ｨ謗ｧ蛻<EFBDA7>梵 笏?
|
||
笏? - 隗<><E99A97>蠑墓梼鬪瑚ｯ<E7919A> 笏?
|
||
笏? - AI謗ｨ逅<EFBDA8>｣豬句ｼょｸ? 笏?
|
||
笏? - 逕滓<E98095>雍ｨ謗ｧ謚･蜻<EFBDA5> 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏ｬ笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?3-5遘貞<E98198>
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 7. 螟壽ｸ<E5A3BD>驕灘渚鬥? 笏?
|
||
笏? A. 莨∽ｸ壼ｾｮ菫｡謗ｨ騾∫ｻ僂RC<52>亥ｮ樊慮騾夂衍<E5A482>? 笏?
|
||
笏? B. REDCap API importQueries<65>亥<EFBFBD>蝗櫁ｴｨ逍托ｼ<E68998> 笏?
|
||
笏? C. IIT Manager蜑咲ｫｯ譏ｾ遉ｺ<E98189>亥ｾ<E4BAA5>萱莠矩｡ｹ<EFBDA1><EFBDB9> 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 陦･蜈<EFBDA5>ｼ壼ｮ壽慮霓ｮ隸｢譛ｺ蛻ｶ<E89BBB>域ｯ?0蛻<30>帖<EFBFBD>? 笏?
|
||
笏? - 髦ｲ豁｢DET驕玲ｼ乗焚謐ｮ 笏?
|
||
笏? - 菴ｿ逕ｨdateRangeBegin蠅樣㍼諡牙叙 笏?
|
||
笏? - 謗ｨ騾∝芦逶ｸ蜷檎噪雍ｨ謗ｧ髦溷<E9ABA6>? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
```
|
||
|
||
### 螳樊慮諤ｧ蟇ｹ豈?
|
||
|
||
| 譁ｹ譯<EFBDB9> | 蟒ｶ霑滓慮髣ｴ | 謌台ｻｬ逧<EFBDAC>画叫 |
|
||
|------|---------|-----------|
|
||
| **郤ｯ霓ｮ隸｢<E99AB8>域ｯ?蛻<>帖<EFBFBD>?* | 譛鬮?蛻<>帖 | 笶?荳肴ｻ｡雜ｳ螳樊慮諤ｧ隕∵ｱ?|
|
||
| **郤ｯ霓ｮ隸｢<E99AB8>域ｯ?蛻<>帖<EFBFBD>?* | 譛鬮?蛻<>帖 | 笞<><E7AC9E><EFBFBD> 襍<>ｺ先ｵｪ雍ｹ縲∝ｻｶ霑滉ｻ埼ｫ?|
|
||
| **DET + API** | 0遘定ｧｦ蜿?+ 3-5遘貞､<E8B29E><EFBDA4>?| 笨?**譛莨俶婿譯?* |
|
||
| **DET + 霓ｮ隸｢陦･蜈<EFBDA5>** | 螳樊慮 + 蜿ｯ髱<EFBDAF> | 笨?**譛扈域楔譫?* |
|
||
|
||
**扈楢ｮｺ<EFBDAE>?* CRC轤ｹ蜃ｻ"菫晏ｭ<E6998F>" 竊?5遘貞<E98198>謾ｶ蛻ｰ莨∽ｸ壼ｾｮ菫｡騾夂衍 笨?
|
||
|
||
---
|
||
|
||
## <20>逃 謚譛ｯ螳樒鴫隸ｦ隗?
|
||
|
||
### 1. Data Entry Trigger (DET) 驟咲ｽｮ
|
||
|
||
#### 豁･鬪､1<EFBDA4>壼惠Control Center蜷ｯ逕ｨDET
|
||
|
||
```
|
||
1. 逋ｻ蠖紐EDCap<61>喇ttp://localhost:8080/
|
||
2. 菴ｿ逕ｨ邂｡逅<EFBDA1>遭雍ｦ謌ｷ<E8AC8C><EFBDB7>dmin / Admin123!<21>?
|
||
3. 霑帛<E99C91><E5B89B>咾ontrol Center 竊?"Additional Customizations"
|
||
4. 謇ｾ蛻ｰ<E89BBB>?Data Entry Trigger" 騾蛾｡ｹ
|
||
5. 隶ｾ鄂ｮ荳ｺ<E88DB3><EFBDBA>"Enabled"
|
||
6. 菫晏ｭ倬<EFBDAD>鄂ｮ
|
||
```
|
||
|
||
**謨ｰ謐ｮ蠎灘ｭ玲ｮｵ<EFBDAE><EFBDB5>** `redcap_config.data_entry_trigger_enabled = 1`
|
||
|
||
#### 豁･鬪､2<EFBDA4>壼惠鬘ｹ逶ｮ荳ｭ驟咲ｽｮWebhook URL
|
||
|
||
```
|
||
1. 霑帛<E99C91>豬玖ｯ暮｡ｹ逶ｮ<E980B6>嗾est0102 (PID 16)
|
||
2. 蟾ｦ萓ｧ闖懷黒 竊?Project Setup
|
||
3. 謇ｾ蛻ｰ<E89BBB>?Additional Customizations"
|
||
4. 螻募ｼ<EFBDBC>?Data Entry Trigger URL"
|
||
5. 蝪ｫ蜈･Webhook URL<52>?
|
||
- 蠑蜿醍識蠅<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
|
||
6. 菫晏ｭ<E6998F>
|
||
```
|
||
|
||
**謨ｰ謐ｮ蠎灘ｭ玲ｮｵ<EFBDAE><EFBDB5>** `redcap_projects.data_entry_trigger_url`
|
||
|
||
#### 豁･鬪､3<EFBDA4>夐ｪ瑚ｯ．ET驟咲ｽｮ
|
||
|
||
**菴ｿ逕ｨRequestBin/ngrok鬪瑚ｯ<E7919A>ｼ?*
|
||
|
||
```bash
|
||
# 菴ｿ逕ｨngrok蛻帛ｻｺ荳ｴ譌ｶ蜈ｬ鄂繕RL<52>亥ｼ蜿第ｵ玖ｯ慕畑<E68595>?
|
||
ngrok http 3001
|
||
|
||
# 蟆<>grok URL驟咲ｽｮ蛻ｰREDCap DET
|
||
# 萓句ｦゑｼ喇ttps://1234-abc-def.ngrok.io/api/v1/iit/webhooks/redcap
|
||
|
||
# 蝨ｨREDCap荳ｭ菫晏ｭ倅ｸ譚｡隶ｰ蠖?
|
||
# 譽譟･ngrok謗ｧ蛻ｶ蜿ｰ譏ｯ蜷ｦ謾ｶ蛻ｰPOST隸ｷ豎<EFBDB7>
|
||
```
|
||
|
||
#### DET逧ПOST Payload譬ｼ蠑<EFBDBC>
|
||
|
||
**REDCap蜿鷹∫噪隸ｷ豎ゑｼ?*
|
||
|
||
```http
|
||
POST /api/v1/iit/webhooks/redcap HTTP/1.1
|
||
Host: iit.xunzhengyixue.com
|
||
Content-Type: application/x-www-form-urlencoded
|
||
User-Agent: REDCap/15.8.0
|
||
|
||
project_id=16
|
||
&record=101
|
||
&instrument=demographics
|
||
&redcap_event_name=baseline_arm_1
|
||
&demographics_complete=2
|
||
&redcap_url=http://localhost:8080/
|
||
```
|
||
|
||
**蟄玲ｮｵ隸ｴ譏趣ｼ?*
|
||
|
||
| 蟄玲ｮｵ | 邀ｻ蝙<EFBDBB> | 隸ｴ譏<EFBDB4> | 遉ｺ萓<EFBDBA> |
|
||
|------|-----|------|------|
|
||
| `project_id` | string | REDCap鬘ｹ逶ｮID | "16" |
|
||
| `record` | string | 隶ｰ蠖肘D | "101" |
|
||
| `instrument` | string | 陦ｨ蜊募錐遘ｰ | "demographics" |
|
||
| `redcap_event_name` | string | 莠倶ｻｶ蜷咲ｧｰ<EFBDA7>育ｺｵ蜷醍<E89CB7>皮ｩｶ<EFBDA9><EFBDB6> | "baseline_arm_1" |
|
||
| `[instrument]_complete` | string | 陦ｨ蜊募ｮ梧<EFBDAE>迥ｶ諤<EFBDB6>ｼ<EFBFBD>0/1/2<>?| "2" |
|
||
| `redcap_url` | string | REDCap螳樔ｾ偽RL | "http://localhost:8080/" |
|
||
|
||
---
|
||
|
||
### 2. REDCap REST API 菴ｿ逕ｨ
|
||
|
||
#### API遶ｯ轤ｹ
|
||
|
||
```
|
||
http://localhost:8080/api/
|
||
```
|
||
|
||
#### API隶､隸<EFBDA4>ｼ啜oken
|
||
|
||
**逕滓<E98095>豁･鬪､<E9ACAA>?*
|
||
```
|
||
1. 逋ｻ蠖紐EDCap
|
||
2. 霑帛<E99C91>鬘ｹ逶ｮ<E980B6>嗾est0102 (PID 16)
|
||
3. 蟾ｦ萓ｧ闖懷黒 竊?"API"
|
||
4. 轤ｹ蜃ｻ "Generate API Token"
|
||
5. 螟榊宛Token<65>?2菴榊ｭ礼ｬｦ荳ｲ<E88DB3>?
|
||
6. 菫晏ｭ伜芦邇ｯ蠅<EFBDAF>序驥擾ｼ<E693BE>
|
||
REDCAP_API_TOKEN_TEST=YOUR_TOKEN_HERE
|
||
```
|
||
|
||
**Token蟄伜お<E4BC9C>?*
|
||
- 笨?邇ｯ蠅<EFBDAF>序驥擾ｼ域耳闕撰ｼ<E692B0>
|
||
- 笨?謨ｰ謐ｮ蠎灘刈蟇<E58888>ｭ玲ｮｵ<EFBDAE><EFBDB5>itProject.redcapApiToken<65>?
|
||
- 笶?荳崎ｦ∵署莠､蛻ｰGit
|
||
|
||
#### API譁ｹ豕<EFBDB9>1<EFBFBD>壼ｯｼ蜃ｺ隶ｰ蠖?(exportRecords)
|
||
|
||
**逕ｨ騾費ｼ<E8B2BB>** 諡牙叙謨ｰ謐ｮ<E8AC90>域髪謖∝｢樣㍼蜷梧ｭ･<EFBDAD><EFBDA5>
|
||
|
||
**隸ｷ豎ら､ｺ萓具ｼ<E585B7>url<72>会ｼ<E4BC9A>**
|
||
|
||
```bash
|
||
curl -X POST http://localhost:8080/api/ \
|
||
-F "token=YOUR_API_TOKEN" \
|
||
-F "content=record" \
|
||
-F "format=json" \
|
||
-F "type=flat" \
|
||
-F "records[0]=101" \
|
||
-F "records[1]=102" \
|
||
-F "dateRangeBegin=2026-01-01 00:00:00"
|
||
```
|
||
|
||
**蜿よ焚隸ｴ譏趣ｼ?*
|
||
|
||
| 蜿よ焚 | 蠢<>｡ｫ | 隸ｴ譏<EFBDB4> | 遉ｺ萓<EFBDBA> |
|
||
|------|-----|------|------|
|
||
| `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": "荳?,
|
||
"age": "30",
|
||
"gender": "1",
|
||
"demographics_complete": "2"
|
||
}
|
||
]
|
||
```
|
||
|
||
#### API譁ｹ豕<EFBDB9>2<EFBFBD>壼ｯｼ蜃ｺ蜈<EFBDBA>焚謐ｮ (exportMetadata)
|
||
|
||
**逕ｨ騾費ｼ<E8B2BB>** 闔ｷ蜿門ｭ玲ｮｵ螳壻ｹ峨∬｡ｨ蜊慕ｻ捺<EFBDBB>?
|
||
|
||
**隸ｷ豎ら､ｺ萓具ｼ?*
|
||
|
||
```bash
|
||
curl -X POST http://localhost:8080/api/ \
|
||
-F "token=YOUR_API_TOKEN" \
|
||
-F "content=metadata" \
|
||
-F "format=json"
|
||
```
|
||
|
||
**蜩榊ｺ皮､ｺ萓具ｼ?*
|
||
|
||
```json
|
||
[
|
||
{
|
||
"field_name": "age",
|
||
"form_name": "demographics",
|
||
"section_header": "",
|
||
"field_type": "text",
|
||
"field_label": "Age",
|
||
"select_choices_or_calculations": "",
|
||
"field_note": "",
|
||
"text_validation_type_or_show_slider_number": "integer",
|
||
"text_validation_min": "0",
|
||
"text_validation_max": "120",
|
||
"identifier": "",
|
||
"branching_logic": "",
|
||
"required_field": "y",
|
||
"custom_alignment": "",
|
||
"question_number": "",
|
||
"matrix_group_name": "",
|
||
"matrix_ranking": "",
|
||
"field_annotation": ""
|
||
}
|
||
]
|
||
```
|
||
|
||
#### API譁ｹ豕<EFBDB9>3<EFBFBD>壼ｯｼ蜈･隶ｰ蠖?(importRecords) - Phase 2
|
||
|
||
**逕ｨ騾費ｼ<E8B2BB>** 蝗槫<E89D97>謨ｰ謐ｮ<E8AC90>亥ｦりｴｨ謗ｧ諢剰ｧ√、I蟒ｺ隶ｮ<E99AB6>?
|
||
|
||
**隸ｷ豎ら､ｺ萓具ｼ?*
|
||
|
||
```bash
|
||
curl -X POST http://localhost:8080/api/ \
|
||
-F "token=YOUR_API_TOKEN" \
|
||
-F "content=record" \
|
||
-F "format=json" \
|
||
-F "type=flat" \
|
||
-F "overwriteBehavior=normal" \
|
||
-F 'data=[{"record_id":"101","ai_review":"謨ｰ謐ｮ蠑ょｸｸ"}]'
|
||
```
|
||
|
||
---
|
||
|
||
### 3. Node.js螳樒鴫莉｣遐<EFBDA3>
|
||
|
||
#### 3.1 RedcapAdapter<65><72>PI騾る<E9A8BE>蝎ｨ<E89D8E><EFBDA8>
|
||
|
||
**譁<>ｻｶ<EFBDBB>?* `backend/src/modules/iit-manager/adapters/RedcapAdapter.ts`
|
||
|
||
```typescript
|
||
import axios from 'axios';
|
||
import FormData from 'form-data';
|
||
import { logger } from '@/common/logging';
|
||
|
||
export interface RedcapExportOptions {
|
||
records?: string[];
|
||
fields?: string[];
|
||
dateRangeBegin?: Date;
|
||
dateRangeEnd?: Date;
|
||
}
|
||
|
||
export class RedcapAdapter {
|
||
private baseUrl: string;
|
||
private apiToken: string;
|
||
private timeout: number;
|
||
|
||
constructor(baseUrl: string, apiToken: string, timeout = 30000) {
|
||
this.baseUrl = baseUrl.replace(/\/$/, ''); // 遘ｻ髯､譛ｫ蟆ｾ譁懈擒
|
||
this.apiToken = apiToken;
|
||
this.timeout = timeout;
|
||
}
|
||
|
||
/**
|
||
* 蟇ｼ蜃ｺ隶ｰ蠖包ｼ域髪謖∝｢樣㍼蜷梧ｭ･<EFBDAD><EFBDA5>
|
||
*/
|
||
async exportRecords(options: RedcapExportOptions = {}): Promise<any[]> {
|
||
const formData = new FormData();
|
||
formData.append('token', this.apiToken);
|
||
formData.append('content', 'record');
|
||
formData.append('format', 'json');
|
||
formData.append('type', 'flat');
|
||
|
||
// 謖<>ｮ夊ｮｰ蠖肘D
|
||
if (options.records && options.records.length > 0) {
|
||
options.records.forEach((recordId, index) => {
|
||
formData.append(`records[${index}]`, recordId);
|
||
});
|
||
}
|
||
|
||
// 謖<>ｮ壼ｭ玲ｮｵ
|
||
if (options.fields && options.fields.length > 0) {
|
||
options.fields.forEach((field, index) => {
|
||
formData.append(`fields[${index}]`, field);
|
||
});
|
||
}
|
||
|
||
// 譌ｶ髣ｴ霑<EFBDB4>ｻ､<EFBDBB>亥｢樣㍼蜷梧ｭ･蜈ｳ髞ｮ<E9AB9E><EFBDAE>
|
||
if (options.dateRangeBegin) {
|
||
const dateStr = this.formatRedcapDate(options.dateRangeBegin);
|
||
formData.append('dateRangeBegin', dateStr);
|
||
}
|
||
|
||
if (options.dateRangeEnd) {
|
||
const dateStr = this.formatRedcapDate(options.dateRangeEnd);
|
||
formData.append('dateRangeEnd', dateStr);
|
||
}
|
||
|
||
try {
|
||
const response = await axios.post(
|
||
`${this.baseUrl}/api/`,
|
||
formData,
|
||
{
|
||
headers: formData.getHeaders(),
|
||
timeout: this.timeout
|
||
}
|
||
);
|
||
|
||
if (!Array.isArray(response.data)) {
|
||
throw new Error('Invalid response format');
|
||
}
|
||
|
||
logger.info(`REDCap API: Exported ${response.data.length} records`);
|
||
return response.data;
|
||
|
||
} catch (error) {
|
||
logger.error('REDCap API exportRecords failed:', error);
|
||
throw new Error(`REDCap API error: ${error.message}`);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 蟇ｼ蜃ｺ蜈<EFBDBA>焚謐ｮ<E8AC90>亥ｭ玲ｮｵ螳壻ｹ会ｼ?
|
||
*/
|
||
async exportMetadata(): Promise<any[]> {
|
||
const formData = new FormData();
|
||
formData.append('token', this.apiToken);
|
||
formData.append('content', 'metadata');
|
||
formData.append('format', 'json');
|
||
|
||
try {
|
||
const response = await axios.post(
|
||
`${this.baseUrl}/api/`,
|
||
formData,
|
||
{
|
||
headers: formData.getHeaders(),
|
||
timeout: this.timeout
|
||
}
|
||
);
|
||
|
||
logger.info(`REDCap API: Exported ${response.data.length} metadata fields`);
|
||
return response.data;
|
||
|
||
} catch (error) {
|
||
logger.error('REDCap API exportMetadata failed:', error);
|
||
throw new Error(`REDCap API error: ${error.message}`);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 蟇ｼ蜈･隶ｰ蠖包ｼ亥屓蜀呎焚謐ｮ<E8AC90><EFBDAE>- Phase 2
|
||
*/
|
||
async importRecords(records: any[]): Promise<void> {
|
||
const formData = new FormData();
|
||
formData.append('token', this.apiToken);
|
||
formData.append('content', 'record');
|
||
formData.append('format', 'json');
|
||
formData.append('type', 'flat');
|
||
formData.append('overwriteBehavior', 'normal');
|
||
formData.append('data', JSON.stringify(records));
|
||
|
||
try {
|
||
await axios.post(
|
||
`${this.baseUrl}/api/`,
|
||
formData,
|
||
{
|
||
headers: formData.getHeaders(),
|
||
timeout: this.timeout
|
||
}
|
||
);
|
||
|
||
logger.info(`REDCap API: Imported ${records.length} records`);
|
||
|
||
} catch (error) {
|
||
logger.error('REDCap API importRecords failed:', error);
|
||
throw new Error(`REDCap API error: ${error.message}`);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 譬ｼ蠑丞喧譌･譛滉ｸｺREDCap譬ｼ蠑擾ｼ唳YYY-MM-DD HH:MM:SS
|
||
*/
|
||
private formatRedcapDate(date: Date): string {
|
||
return date
|
||
.toISOString()
|
||
.replace('T', ' ')
|
||
.substring(0, 19);
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 3.2 WebhookController<65><72>ebhook謗･謾ｶ蝎ｨ<E89D8E><EFBDA8>
|
||
|
||
**譁<>ｻｶ<EFBDBB>?* `backend/src/modules/iit-manager/controllers/webhookController.ts`
|
||
|
||
```typescript
|
||
import { FastifyRequest, FastifyReply } from 'fastify';
|
||
import { prisma } from '@/config/database';
|
||
import { logger } from '@/common/logging';
|
||
import { jobQueue } from '@/common/jobs';
|
||
import { RedcapAdapter } from '../adapters/RedcapAdapter';
|
||
|
||
export class WebhookController {
|
||
/**
|
||
* 謗･謾ｶREDCap Data Entry Trigger Webhook
|
||
*
|
||
* 諤ｧ閭ｽ隕∵ｱゑｼ壼桃蠎疲慮髣?< 100ms<6D>井ｸ埼仆蝪朿EDCap<61>?
|
||
*/
|
||
async handleRedcapWebhook(
|
||
request: FastifyRequest,
|
||
reply: FastifyReply
|
||
): Promise<void> {
|
||
const startTime = Date.now();
|
||
|
||
// 隗｣譫晋ebhook Payload
|
||
const payload = request.body as Record<string, any>;
|
||
const {
|
||
project_id,
|
||
record,
|
||
instrument,
|
||
redcap_event_name,
|
||
redcap_url
|
||
} = payload;
|
||
|
||
// 蝓ｺ譛ｬ鬪瑚ｯ<E7919A>
|
||
if (!project_id || !record) {
|
||
reply.code(400).send({
|
||
error: 'Missing required fields: project_id, record'
|
||
});
|
||
return;
|
||
}
|
||
|
||
logger.info('REDCap DET webhook received:', {
|
||
project_id,
|
||
record,
|
||
instrument,
|
||
event: redcap_event_name
|
||
});
|
||
|
||
// 遶句叉霑泌屓200<30>井ｸ埼仆蝪朿EDCap<61>?
|
||
const responseTime = Date.now() - startTime;
|
||
reply.code(200).send({
|
||
status: 'received',
|
||
timestamp: new Date().toISOString(),
|
||
response_time_ms: responseTime
|
||
});
|
||
|
||
// 蠑よｭ･螟<EFBDA5>炊<EFBFBD>井ｸ埼仆蝪曰TTP蜩榊ｺ費ｼ?
|
||
setImmediate(async () => {
|
||
try {
|
||
await this.processWebhook({
|
||
project_id,
|
||
record,
|
||
instrument,
|
||
redcap_event_name,
|
||
redcap_url
|
||
});
|
||
} catch (error) {
|
||
logger.error('Webhook processing failed:', error);
|
||
// 荳肴鴨蜃ｺ髞呵ｯｯ<EFBDAF>悟屏荳ｺ蟾ｲ扈剰ｿ泌屓200莠?
|
||
}
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 蠑よｭ･螟<EFBDA5>炊Webhook
|
||
*/
|
||
private async processWebhook(payload: {
|
||
project_id: string;
|
||
record: string;
|
||
instrument: string;
|
||
redcap_event_name?: string;
|
||
redcap_url?: string;
|
||
}): Promise<void> {
|
||
const { project_id, record, instrument } = payload;
|
||
|
||
// 1. 譟･謇ｾ鬘ｹ逶ｮ驟咲ｽｮ
|
||
const project = await prisma.iitProject.findFirst({
|
||
where: { redcapProjectId: project_id }
|
||
});
|
||
|
||
if (!project) {
|
||
logger.warn(`Unknown REDCap project_id: ${project_id}`);
|
||
return;
|
||
}
|
||
|
||
// 2. 蟷らｭ画ｧ譽譟･<E8AD9F>磯亟豁｢驥榊､榊､<E6A68A>炊<EFBFBD>?
|
||
const isDuplicate = await this.checkDuplicate(
|
||
project.id,
|
||
record,
|
||
instrument
|
||
);
|
||
|
||
if (isDuplicate) {
|
||
logger.info(`Duplicate webhook ignored: ${record}`);
|
||
return;
|
||
}
|
||
|
||
// 3. 隹<>畑REDCap API諡牙叙螳梧紛謨ｰ謐ｮ
|
||
const adapter = new RedcapAdapter(
|
||
project.redcapBaseUrl,
|
||
project.redcapApiToken
|
||
);
|
||
|
||
const records = await adapter.exportRecords({
|
||
records: [record] // 蜿ｪ諡牙叙霑吩ｸ譚｡隶ｰ蠖?
|
||
});
|
||
|
||
if (records.length === 0) {
|
||
logger.warn(`No data found for record: ${record}`);
|
||
return;
|
||
}
|
||
|
||
// 4. 謗ｨ騾∝芦雍ｨ謗ｧ髦溷<E9ABA6>
|
||
await jobQueue.send('iit:quality-check', {
|
||
projectId: project.id,
|
||
record: records[0],
|
||
trigger: 'webhook',
|
||
instrument,
|
||
timestamp: new Date().toISOString()
|
||
});
|
||
|
||
logger.info(`Webhook processed successfully: project=${project_id}, record=${record}`);
|
||
|
||
// 5. 隶ｰ蠖募ｮ｡隶｡譌･蠢<EFBDA5>
|
||
await prisma.iitAuditLog.create({
|
||
data: {
|
||
projectId: project.id,
|
||
action: 'WEBHOOK_RECEIVED',
|
||
targetType: 'RECORD',
|
||
targetId: record,
|
||
details: {
|
||
instrument,
|
||
trigger: 'redcap_det'
|
||
}
|
||
}
|
||
});
|
||
}
|
||
|
||
/**
|
||
* 蟷らｭ画ｧ譽譟･<E8AD9F>磯亟豁｢5蛻<35>帖蜀<E5B896>㍾螟榊､<E6A68A>炊逶ｸ蜷瑚ｮｰ蠖包ｼ<E58C85>
|
||
*/
|
||
private async checkDuplicate(
|
||
projectId: string,
|
||
recordId: string,
|
||
instrument: string
|
||
): Promise<boolean> {
|
||
const fiveMinutesAgo = new Date(Date.now() - 5 * 60 * 1000);
|
||
|
||
const recentLog = await prisma.iitAuditLog.findFirst({
|
||
where: {
|
||
projectId,
|
||
action: 'WEBHOOK_RECEIVED',
|
||
targetId: recordId,
|
||
createdAt: { gte: fiveMinutesAgo },
|
||
details: {
|
||
path: ['instrument'],
|
||
equals: instrument
|
||
}
|
||
}
|
||
});
|
||
|
||
return recentLog !== null;
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 3.3 SyncManager<65>郁ｽｮ隸｢陦･蜈<EFBDA5>ｼ<EFBFBD>
|
||
|
||
**譁<>ｻｶ<EFBDBB>?* `backend/src/modules/iit-manager/services/SyncManager.ts`
|
||
|
||
```typescript
|
||
import { prisma } from '@/config/database';
|
||
import { logger } from '@/common/logging';
|
||
import { jobQueue } from '@/common/jobs';
|
||
import { RedcapAdapter } from '../adapters/RedcapAdapter';
|
||
|
||
export class SyncManager {
|
||
/**
|
||
* 蛻晏ｧ句喧蜷梧ｭ･<EFBDAD>域ｳｨ蜀悟ｮ壽慮莉ｻ蜉｡<E89C89>?
|
||
*/
|
||
async initializeSync(projectId: string, interval: string = '*/30 * * * *'): Promise<void> {
|
||
// 豕ｨ蜀悟ｮ壽慮莉ｻ蜉｡<E89C89>域ｯ<E59F9F>30蛻<30>帖<EFBFBD>?
|
||
await jobQueue.schedule(
|
||
'iit:redcap:poll',
|
||
interval,
|
||
{ projectId }
|
||
);
|
||
|
||
logger.info(`Polling sync initialized for project ${projectId}, interval: ${interval}`);
|
||
}
|
||
|
||
/**
|
||
* 螟<>炊霓ｮ隸｢<E99AB8>域級蜿門｢樣㍼謨ｰ謐ｮ<E8AC90><EFBDAE>
|
||
*/
|
||
async handlePoll(projectId: string): Promise<void> {
|
||
logger.info(`Starting poll sync for project ${projectId}`);
|
||
|
||
try {
|
||
// 1. 闔ｷ蜿夜｡ｹ逶ｮ驟咲ｽｮ
|
||
const project = await prisma.iitProject.findUnique({
|
||
where: { id: projectId }
|
||
});
|
||
|
||
if (!project) {
|
||
throw new Error(`Project not found: ${projectId}`);
|
||
}
|
||
|
||
// 2. 闔ｷ蜿紋ｸ頑ｬ｡蜷梧ｭ･譌ｶ髣ｴ
|
||
const lastSyncAt = project.lastSyncAt || new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
|
||
|
||
logger.info(`Last sync: ${lastSyncAt.toISOString()}`);
|
||
|
||
// 3. 諡牙叙蠅樣㍼謨ｰ謐ｮ
|
||
const adapter = new RedcapAdapter(
|
||
project.redcapBaseUrl,
|
||
project.redcapApiToken
|
||
);
|
||
|
||
const records = await adapter.exportRecords({
|
||
dateRangeBegin: lastSyncAt
|
||
});
|
||
|
||
logger.info(`Pulled ${records.length} records from REDCap`);
|
||
|
||
// 4. 謗ｨ騾∝芦雍ｨ謗ｧ髦溷<E9ABA6>
|
||
for (const record of records) {
|
||
await jobQueue.send('iit:quality-check', {
|
||
projectId,
|
||
record,
|
||
trigger: 'polling',
|
||
timestamp: new Date().toISOString()
|
||
});
|
||
}
|
||
|
||
// 5. 譖ｴ譁ｰ蜷梧ｭ･譌ｶ髣ｴ
|
||
await prisma.iitProject.update({
|
||
where: { id: projectId },
|
||
data: { lastSyncAt: new Date() }
|
||
});
|
||
|
||
logger.info(`Poll sync completed for project ${projectId}`);
|
||
|
||
} catch (error) {
|
||
logger.error(`Poll sync failed for project ${projectId}:`, error);
|
||
throw error;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 蛛懈ｭ｢蜷梧ｭ･<EFBDAD>亥叙豸亥ｮ壽慮莉ｻ蜉｡<E89C89><EFBDA1>
|
||
*/
|
||
async stopSync(projectId: string): Promise<void> {
|
||
// pg-boss荳肴髪謖∫峩謗･蜿匁ｶ<E58C81>chedule<6C>碁怙隕∝惠Worker荳ｭ譽譟･鬘ｹ逶ｮ迥ｶ諤?
|
||
logger.info(`Sync stopped for project ${projectId}`);
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 3.4 霍ｯ逕ｱ驟咲ｽｮ
|
||
|
||
**譁<>ｻｶ<EFBDBB>?* `backend/src/modules/iit-manager/routes/index.ts`
|
||
|
||
```typescript
|
||
import { FastifyInstance } from 'fastify';
|
||
import { WebhookController } from '../controllers/webhookController';
|
||
import { SyncManager } from '../services/SyncManager';
|
||
|
||
export async function iitManagerRoutes(fastify: FastifyInstance) {
|
||
const webhookController = new WebhookController();
|
||
const syncManager = new SyncManager();
|
||
|
||
// Webhook遶ｯ轤ｹ<E8BDA4>域磁謾ｶREDCap DET<45>?
|
||
fastify.post('/webhooks/redcap', async (request, reply) => {
|
||
return webhookController.handleRedcapWebhook(request, reply);
|
||
});
|
||
|
||
// 謇句勘隗ｦ蜿大酔豁･<E8B181>域ｵ玖ｯ慕畑<E68595>?
|
||
fastify.post('/projects/:id/sync', async (request, reply) => {
|
||
const { id } = request.params as { id: string };
|
||
await syncManager.handlePoll(id);
|
||
return { status: 'synced' };
|
||
});
|
||
}
|
||
```
|
||
|
||
#### 3.5 Worker豕ｨ蜀<EFBDA8>
|
||
|
||
**譁<>ｻｶ<EFBDBB>?* `backend/src/modules/iit-manager/index.ts`
|
||
|
||
```typescript
|
||
import { jobQueue } from '@/common/jobs';
|
||
import { SyncManager } from './services/SyncManager';
|
||
import { logger } from '@/common/logging';
|
||
|
||
export async function initializeIITManager() {
|
||
const syncManager = new SyncManager();
|
||
|
||
// 豕ｨ蜀瑚ｽｮ隸｢Worker
|
||
await jobQueue.work('iit:redcap:poll', async (job) => {
|
||
const { projectId } = job.data;
|
||
await syncManager.handlePoll(projectId);
|
||
});
|
||
|
||
logger.info('IIT Manager initialized: Poll worker registered');
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## <20>ｧｪ 豬玖ｯ暮ｪ瑚ｯ<E7919A>
|
||
|
||
### 豬玖ｯ<E78E96>1<EFBFBD>夐ｪ瑚ｯ．ET驟咲ｽｮ
|
||
|
||
**豁･鬪､<E9ACAA>?*
|
||
1. 驟咲ｽｮngrok<6F>啻ngrok http 3001`
|
||
2. 蟆<>grok URL驟咲ｽｮ蛻ｰREDCap DET
|
||
3. 蝨ｨREDCap荳ｭ菫晏ｭ倅ｸ譚｡隶ｰ蠖?
|
||
4. 譽譟･ngrok謗ｧ蛻ｶ蜿ｰ譏ｯ蜷ｦ謾ｶ蛻ｰPOST隸ｷ豎<EFBDB7>
|
||
|
||
**鬚<>悄扈捺棡<E68DBA>?*
|
||
- 笨?ngrok謾ｶ蛻ｰPOST隸ｷ豎<EFBDB7>
|
||
- 笨?Payload蛹<64>性project_id縲〉ecord遲牙ｭ玲ｮ?
|
||
|
||
### 豬玖ｯ<E78E96>2<EFBFBD>夐ｪ瑚ｯ、PI Token
|
||
|
||
**豬玖ｯ戊<EFBDAF>譛ｬ<E8AD9B>?* `test-redcap-api.ts`
|
||
|
||
```typescript
|
||
import { RedcapAdapter } from './adapters/RedcapAdapter';
|
||
|
||
async function testRedcapAPI() {
|
||
const adapter = new RedcapAdapter(
|
||
'http://localhost:8080',
|
||
process.env.REDCAP_API_TOKEN_TEST!
|
||
);
|
||
|
||
// 豬玖ｯ募ｯｼ蜃ｺ隶ｰ蠖<EFBDB0>
|
||
const records = await adapter.exportRecords();
|
||
console.log('Records:', records);
|
||
|
||
// 豬玖ｯ募ｯｼ蜃ｺ蜈<EFBDBA>焚謐?
|
||
const metadata = await adapter.exportMetadata();
|
||
console.log('Metadata fields:', metadata.length);
|
||
|
||
console.log('笨?REDCap API test passed!');
|
||
}
|
||
|
||
testRedcapAPI();
|
||
```
|
||
|
||
### 豬玖ｯ<E78E96>3<EFBFBD>夂ｫｯ蛻ｰ遶ｯ髮<EFBDAF><E9ABAE>豬玖ｯ<E78E96>
|
||
|
||
**豬玖ｯ戊<EFBDAF>譛ｬ<E8AD9B>?* `test-redcap-integration.ts`
|
||
|
||
```typescript
|
||
async function testIntegration() {
|
||
// 1. 蛻帛ｻｺ豬玖ｯ暮｡ｹ逶ｮ
|
||
const project = await prisma.iitProject.create({
|
||
data: {
|
||
name: 'test0102',
|
||
redcapBaseUrl: 'http://localhost:8080',
|
||
redcapApiToken: process.env.REDCAP_API_TOKEN_TEST!,
|
||
redcapProjectId: '16',
|
||
status: 'ACTIVE'
|
||
}
|
||
});
|
||
|
||
// 2. 蛻晏ｧ句喧蜷梧ｭ?
|
||
const syncManager = new SyncManager();
|
||
await syncManager.initializeSync(project.id);
|
||
|
||
// 3. 謇句勘隗ｦ蜿台ｸ谺｡霓ｮ隸?
|
||
await syncManager.handlePoll(project.id);
|
||
|
||
// 4. 讓｡諡欷ebhook
|
||
const webhookController = new WebhookController();
|
||
await webhookController.handleRedcapWebhook(
|
||
{
|
||
body: {
|
||
project_id: '16',
|
||
record: '101',
|
||
instrument: 'demographics'
|
||
}
|
||
} as any,
|
||
{} as any
|
||
);
|
||
|
||
console.log('笨?Integration test passed!');
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## <20>搭 Day 2螳樊命貂<E591BD>黒
|
||
|
||
### 髦ｶ谿ｵ1<EFBDB5>夂識蠅<E8AD98>㊥螟<E38AA5>ｼ<EFBFBD>30蛻<30>帖<EFBFBD>?
|
||
|
||
- [ ] 蝨ｨREDCap Control Center蜷ｯ逕ｨDET蜉溯<E89C89>
|
||
- [ ] 蝨ｨtest0102鬘ｹ逶ｮ逕滓<E98095>API Token
|
||
- [ ] 驟咲ｽｮ邇ｯ蠅<EFBDAF>序驥擾ｼ?
|
||
```env
|
||
REDCAP_BASE_URL=http://localhost:8080
|
||
REDCAP_API_TOKEN_TEST=YOUR_TOKEN_HERE
|
||
```
|
||
- [ ] 菴ｿ逕ｨcurl豬玖ｯ柊PI譏ｯ蜷ｦ蜿ｯ逕ｨ
|
||
|
||
### 髦ｶ谿ｵ2<EFBDB5>壼ｼ蜿然edcapAdapter<65>?.5蟆乗慮<EFBFBD>?
|
||
|
||
- [ ] 蛻帛ｻｺ譁<EFBDBA>ｻｶ<EFBDBB>啻adapters/RedcapAdapter.ts`
|
||
- [ ] 螳樒鴫 `exportRecords()` 譁ｹ豕<EFBDB9>
|
||
- [ ] 螳樒鴫 `exportMetadata()` 譁ｹ豕<EFBDB9>
|
||
- [ ] 螳樒鴫 `formatRedcapDate()` 蟾･蜈ｷ譁ｹ豕<EFBDB9>
|
||
- [ ] 郛門<E9839B>蜊募<E89C8A>豬玖ｯ包ｼ啻RedcapAdapter.test.ts`
|
||
|
||
### 髦ｶ谿ｵ3<EFBDB5>壼ｼ蜿糎ebhookController<65>?蟆乗慮<E4B997>?
|
||
|
||
- [ ] 蛻帛ｻｺ譁<EFBDBA>ｻｶ<EFBDBB>啻controllers/webhookController.ts`
|
||
- [ ] 螳樒鴫 `handleRedcapWebhook()` 譁ｹ豕<EFBDB9>
|
||
- [ ] 螳樒鴫 `processWebhook()` 遘∵怏譁ｹ豕<EFBDB9>
|
||
- [ ] 螳樒鴫 `checkDuplicate()` 蟷らｭ画ｧ譽譟?
|
||
- [ ] 驟咲ｽｮ霍ｯ逕ｱ<E98095>啻POST /api/v1/iit/webhooks/redcap`
|
||
|
||
### 髦ｶ谿ｵ4<EFBDB5>壼ｼ蜿全yncManager<65>?.5蟆乗慮<EFBFBD>?
|
||
|
||
- [ ] 蛻帛ｻｺ譁<EFBDBA>ｻｶ<EFBDBB>啻services/SyncManager.ts`
|
||
- [ ] 螳樒鴫 `initializeSync()` 譁ｹ豕<EFBDB9>
|
||
- [ ] 螳樒鴫 `handlePoll()` 譁ｹ豕<EFBDB9>
|
||
- [ ] 螳樒鴫 `stopSync()` 譁ｹ豕<EFBDB9>
|
||
- [ ] 豕ｨ蜀係orker<65>啻iit:redcap:poll`
|
||
|
||
### 髦ｶ谿ｵ5<EFBDB5>夐寔謌先ｵ玖ｯ包ｼ<E58C85>1蟆乗慮<E4B997>?
|
||
|
||
- [ ] 驟咲ｽｮngrok/RequestBin豬玖ｯ疋ET
|
||
- [ ] 霑占｡<E58DA0> `test-redcap-api.ts`
|
||
- [ ] 霑占｡<E58DA0> `test-redcap-integration.ts`
|
||
- [ ] 鬪瑚ｯ∫ｫｯ蛻ｰ遶ｯ豬∫ｨ?
|
||
- [ ] 隶ｰ蠖墓ｵ玖ｯ慕ｻ捺棡
|
||
|
||
### 髦ｶ谿ｵ6<EFBDB5>壽枚譯｣譖ｴ譁ｰ<E8AD81><EFBDB0>30蛻<30>帖<EFBFBD>?
|
||
|
||
- [ ] 譖ｴ譁ｰMVP蠑蜿台ｻｻ蜉｡貂<EFBDA1>黒<EFBFBD><E9BB92>ay 2螳梧<E89EB3><E6A2A7>?
|
||
- [ ] 隶ｰ蠖柊PI Token蜥碁<E89CA5>鄂ｮ菫｡諱?
|
||
- [ ] 譖ｴ譁ｰ譫ｶ譫<EFBDB6><E8ADAB>?
|
||
- [ ] 謠蝉ｺ､Git
|
||
|
||
---
|
||
|
||
## 笞<><E7AC9E><EFBFBD> 蜈ｳ髞ｮ豕ｨ諢丈ｺ矩｡ｹ
|
||
|
||
### 1. DET驟咲ｽｮ隕∫せ
|
||
|
||
**蟶ｸ隗<EFBDB8>漠隸ｯ<E99AB8>?*
|
||
- 笶?蠢倩ｮｰ蝨ｨControl Center蜷ｯ逕ｨDET蜈ｨ螻蠑蜈?
|
||
- 笶?Webhook URL蝪ｫ蜀咎漠隸ｯ<E99AB8>亥､壻ｺ<E5A3BB>万譚<E4B887>縲∝ｰ台ｺ<E58FB0>ｷｯ蠕<EFBDAF>ｼ<EFBFBD>
|
||
- 笶?譛ｬ蝨ｰ蠑蜿醍識蠅<E8AD98>裏豕墓磁謾ｶ螟也ｽ糎ebhook
|
||
|
||
**隗｣蜀ｳ譁ｹ譯茨ｼ?*
|
||
- 笨?菴ｿ逕ｨngrok蛻帛ｻｺ荳ｴ譌ｶ蜈ｬ鄂繕RL豬玖ｯ<E78E96>
|
||
- 笨?蠑蜿醍識蠅<E8AD98>庄蜈育畑RequestBin鬪瑚ｯ￣ayload譬ｼ蠑<EFBDBC>
|
||
- 笨?逕滉ｺｧ邇ｯ蠅<EFBDAF>｡ｮ菫拔RL蜿ｯ隶ｿ髣ｮ<E9ABA3>磯亟轣ｫ蠅吶？TTPS<50>?
|
||
|
||
### 2. API Token螳牙<E89EB3>
|
||
|
||
**螳牙<E89EB3>螳櫁ｷｵ<EFBDB7>?*
|
||
- 笨?蟄伜お蝨ｨ邇ｯ蠅<EFBDAF>序驥乗<E9A9A5>謨ｰ謐ｮ蠎灘刈蟇<E58888>ｭ玲ｮ?
|
||
- 笨?螳壽悄霓ｮ謐｢Token
|
||
- 笨?譛蟆乗揀髯仙次蛻呻ｼ亥宵蠑蜷ｯ髴隕∫噪譚<E599AA>剞<EFBFBD>?
|
||
- 笶?荳崎ｦ∵署莠､蛻ｰGit
|
||
- 笶?荳崎ｦ∝惠譌･蠢嶺ｸｭ謇灘魂螳梧紛Token
|
||
|
||
### 3. 諤ｧ閭ｽ莨伜喧
|
||
|
||
**Webhook蜩榊ｺ疲慮髣ｴ<E9ABA3>?*
|
||
- 笨?蠢<>｡ｻ < 100ms<6D>育ｫ句叉霑泌<E99C91>?00<30>?
|
||
- 笨?菴ｿ逕ｨ `setImmediate()` 蠑よｭ･螟<EFBDA5>炊
|
||
- 笶?荳崎ｦ∝惠Webhook荳ｭ謇ｧ陦瑚玲慮謫堺ｽ<E5A0BA>
|
||
|
||
**API隹<49>畑鬚醍紫<E9868D>?*
|
||
- 笨?蠅樣㍼諡牙叙<E78999>井ｽｿ逕ｨdateRangeBegin<69>?
|
||
- 笨?謖<>ｮ壼ｭ玲ｮｵ<EFBDAE>亥㍼蟆第焚謐ｮ驥擾ｼ?
|
||
- 笨?蜷育炊隶ｾ鄂ｮtimeout<75>?0遘抵ｼ<E68AB5>
|
||
|
||
### 4. 髞呵ｯｯ螟<EFBDAF>炊
|
||
|
||
**DET Webhook螟ｱ雍･<E99B8D>?*
|
||
- REDCap莨夐㍾隸?谺｡<E8B0BA>磯龍髫<E9BE8D>1蛻<31>帖<EFBFBD>?
|
||
- 螯よ棡莉榊､ｱ雍･<E99B8D>軍EDCap莨夊ｮｰ蠖募芦譌･蠢<EFBDA5>
|
||
- 謌台ｻｬ逧<EFBDAC>ｽｮ隸｢譛ｺ蛻ｶ蜿ｯ莉･陦･蜈<EFBDA5>＠貍冗噪謨ｰ謐ｮ
|
||
|
||
**API隹<49>畑螟ｱ雍･<E99B8D>?*
|
||
- 螳樒鴫驥崎ｯ墓惻蛻ｶ<E89BBB>?谺｡<E8B0BA>梧欠謨ｰ騾驕ｿ<E9A995><EFBDBF>
|
||
- 隶ｰ蠖募､ｱ雍･譌･蠢<EFBDA5>
|
||
- 蜻願ｭｦ騾夂衍邂｡逅<EFBDA1><E98085>?
|
||
|
||
---
|
||
|
||
## <20>投 謌仙粥鬪梧噺譬<E599BA>㊥
|
||
|
||
### Day 2螳梧<E89EB3>譬<EFBFBD>㊥
|
||
|
||
- [ ] 笨?REDCap API Token蟾ｲ逕滓<E98095>蟷ｶ鬪瑚ｯ<E7919A>
|
||
- [ ] 笨?RedcapAdapter蜿ｯ莉･諡牙叙豬玖ｯ墓焚謐ｮ
|
||
- [ ] 笨?DET蟾ｲ驟咲ｽｮ蟷ｶ謌仙粥謗･謾ｶWebhook
|
||
- [ ] 笨?Webhook蜿ｯ莉･隗ｦ蜿羨PI諡牙叙
|
||
- [ ] 笨?霓ｮ隸｢譛ｺ蛻ｶ蜿ｯ莉･螳壽慮霑占｡<E58DA0>
|
||
- [ ] 笨?謨ｰ謐ｮ謗ｨ騾∝芦雍ｨ謗ｧ髦溷<E9ABA6>
|
||
- [ ] 笨?蜊募<E89C8A>豬玖ｯ募<EFBDAF>驛ｨ騾夊ｿ<E5A48A>
|
||
- [ ] 笨?遶ｯ蛻ｰ遶ｯ髮<EFBDAF><E9ABAE>豬玖ｯ暮夊ｿ<E5A48A>
|
||
|
||
### 諤ｧ閭ｽ謖<EFBDBD><E8AC96><EFBFBD>
|
||
|
||
- [ ] Webhook蜩榊ｺ疲慮髣ｴ < 100ms
|
||
- [ ] API隹<49>畑謌仙粥邇?> 99%
|
||
- [ ] 遶ｯ蛻ｰ遶ｯ蟒ｶ霑?< 5遘抵ｼ<E68AB5>ET隗ｦ蜿<EFBDA6> 竊?莨∝ｾｮ騾夂衍<E5A482>?
|
||
|
||
---
|
||
|
||
## <20>迫 逶ｸ蜈ｳ譁<EFBDB3>｡｣
|
||
|
||
- **MVP蠑蜿台ｻｻ蜉｡貂<EFBDA1>黒<EFBFBD><E9BB92>** `MVP蠑蜿台ｻｻ蜉｡貂<EFBDA1><E8B282>?md`
|
||
- **螳梧紛謚譛ｯ譁ｹ譯茨ｼ<E88CA8>** `IIT Manager Agent 螳梧紛謚譛ｯ蠑蜿第婿譯?(V1.1).md`
|
||
- **REDCap莠梧ｬ｡蠑蜿第欠蜊暦ｼ<E69AA6>** `../../Redcap/03-API蟇ｹ謗･荳主ｼ蜿?33-REDCap莠梧ｬ｡蠑蜿第ｷｱ蠎ｦ謖<EFBDA6><E8AC96>?md`
|
||
- **REDCap驛ｨ鄂ｲ謇句<E8AC87><E58FA5>?* `../../Redcap/01-驛ｨ鄂ｲ荳朱<E88DB3>鄂?10-REDCap_Docker驛ｨ鄂ｲ謫堺ｽ懈焔蜀<E78494>.md`
|
||
|
||
---
|
||
|
||
## <20>統 譖ｴ譁ｰ譌･蠢<EFBDA5>
|
||
|
||
| 譌･譛<EFBDA5> | 迚域悽 | 譖ｴ譁ｰ蜀<EFBDB0>ｮｹ | 譖ｴ譁ｰ莠?|
|
||
|------|------|---------|--------|
|
||
| 2026-01-02 | V1.0 | 蛻晏ｧ狗沿譛ｬ<E8AD9B>悟ｮ梧<EFBDAE>謚譛ｯ隹<EFBDAF><E99AB9>泌柱譁ｹ譯郁ｮｾ隶｡ | AI Assistant |
|
||
|
||
---
|
||
|
||
**霑呎弍IIT Manager Agent逧<74>橿譛ｯ蝓ｺ遏ｳ譁<EFBDB3>｡｣<EFBDA1>瑚ｯｷ螯･蝟<EFBDA5>ｿ晉ｮ｡<EFBDAE><EFBDA1>** 箝絶ｭ絶ｭ絶ｭ絶ｭ?
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|