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%)
1201 lines
39 KiB
Markdown
1201 lines
39 KiB
Markdown
# REDCap荳拶Iclinicalresearch蟷ｳ蜿ｰ蟇ｹ謗･諤ｻ菴捺婿譯<E5A9BF>
|
||
|
||
> **譁<>｡｣迚域悽<E59F9F>?* v1.0
|
||
> **蛻帛ｻｺ譌･譛滂ｼ?* 2025-12-30
|
||
> **譛蜷取峩譁ｰ<E8AD81><EFBDB0>** 2025-12-30
|
||
> **譁<>｡｣迥ｶ諤<EFBDB6>ｼ<EFBFBD>** 隗<><E99A97>荳?
|
||
> **菴懆<E68786>ｼ<EFBFBD>** 謚譛ｯ譫ｶ譫<EFBDB6>ｸ<EFBFBD>
|
||
|
||
---
|
||
|
||
## <20>搭 譁<>｡｣隸ｴ譏<EFBDB4>
|
||
|
||
譛ｬ譁<EFBFBD>｡｣螳壻ｹ嘘EDCap<EFBFBD>?5.8.0<EFBFBD>我ｸ主｣ｹ隸∝ｾｪAI遘醍<EFBFBD>泌ｹｳ蜿ｰ逧?*螳梧紛蟇ｹ謗･譁ｹ譯<EFBDB9>**<2A>悟桁諡ｬ<E8ABA1><EFBDAC>
|
||
1. 蟇ｹ謗･譫ｶ譫<EFBDB6>ｮｾ隶｡
|
||
2. External Module蠑蜿第婿譯?
|
||
3. API髮<49><E9ABAE>譁ｹ譯<EFBDB9>
|
||
4. 謨ｰ謐ｮ豬∬ｮｾ隶?
|
||
5. 蠑蜿題ｮ｡蛻剃ｸ主ｮ樊命豁･鬪､
|
||
|
||
**蜑咲ｽｮ譚｡莉ｶ<E88E89>?*
|
||
- 笨?蟾ｲ闔ｷ蠕由EDCap螳俶婿謗域揀
|
||
- 笨?諡･譛嘘EDCap 15.8.0貅蝉ｻ｣遐?
|
||
- 笨?諡･譛右xternal Module Framework譁<6B>｡｣
|
||
|
||
**逶ｸ蜈ｳ譁<EFBDB3>｡｣<EFBDA1>?*
|
||
- [REDCap 莠梧ｬ｡蠑蜿第ｷｱ蠎ｦ謖<EFBDA6>漉](./REDCap%20莠梧ｬ｡蠑蜿第ｷｱ蠎ｦ謖<EFBDA6><E8AC96>?md)
|
||
- [邉ｻ扈滓楔譫<EFBFBD><EFBFBD>螻りｮｾ隶｡](../../00-邉ｻ扈滓ｻ菴楢ｮｾ隶｡/01-邉ｻ扈滓楔譫<E6A594><E8ADAB>螻りｮｾ隶｡.md)
|
||
|
||
---
|
||
|
||
## <20>識 蟇ｹ謗･逶ｮ譬<EFBDAE>ｸ惹ｻｷ蛟?
|
||
|
||
### 譬ｸ蠢<EFBDB8>岼譬<E5B2BC>
|
||
|
||
**蟆<>EDCap逧<70>ｼｺ螟ｧEDC閭ｽ蜉帑ｸ拶I遘醍<E98198>泌ｹｳ蜿ｰ逧БI蠅槫ｼ蜉溯<E89C89>豺ｱ蠎ｦ陞榊<E9999E>?*
|
||
|
||
```
|
||
REDCap (謨ｰ謐ｮ驥<EFBDAE>寔) + AIclinicalresearch (AI閭ｽ蜉<EFBDBD>)
|
||
竊? 竊?
|
||
荳ｴ蠎頑焚謐ｮ蠖募<EFBFBD> AI譎ｺ閭ｽ螟<EFBDBD>炊縲∝<E7B8B2>譫舌∵ｴ槫ｯ?
|
||
竊? 竊?
|
||
螳梧紛逧БI鬩ｱ蜉ｨ荳ｴ蠎顔<E8A08E>皮ｩｶ髣ｭ邇ｯ
|
||
```
|
||
|
||
### 荳壼苅莉ｷ蛟?
|
||
|
||
| 蜉溯<E89C89>讓｡蝮<EFBDA1> | REDCap蝓ｺ遑閭ｽ蜉<EFBDBD> | AI蟷ｳ蜿ｰ蠅槫ｼ閭ｽ蜉?| 蜊丞酔莉ｷ蛟?|
|
||
|---------|--------------|--------------|---------|
|
||
| **謨ｰ謐ｮ驥<EFBDAE>寔** | 笨?陦ｨ蜊戊ｮｾ隶｡縲∵焚謐ｮ蠖募<E8A096>縲<EFBFBD>ｪ瑚ｯ?| <20>氏 AI霎<49>勧蠖募<E8A096>縲∵匱閭ｽ雍ｨ謗?| 謠仙合蠖募<E8A096>謨育紫50% |
|
||
| **謨ｰ謐ｮ貂<EFBDAE>ｴ<EFBFBD>** | 笞<><E7AC9E><EFBFBD> 謇句勘譟･隸｢縲∝ｯｼ蜃ｺExcel | <20>氏 DC讓｡蝮苓<E89DAE>蜉ｨ貂<EFBDA8>ｴ励¨ER謠仙叙 | 蜃丞ｰ第焚謐ｮ螟<EFBDAE>炊譌ｶ髣ｴ80% |
|
||
| **扈溯ｮ｡蛻<EFBDA1>梵** | 笞<><E7AC9E><EFBFBD> 髴蟇ｼ蜃ｺ蛻ｰR/SPSS | <20>氏 SSA讓｡蝮嶺ｸ髞ｮ蛻<EFBDAE>梵縲∝庄隗<E5BA84>喧 | 髯堺ｽ守ｻ溯ｮ｡髣ｨ讒幢ｼ悟<EFBDBC>譫宣溷ｺｦ謠仙合10蛟?|
|
||
| **譁<>鍵謾ｯ謖<EFBDAF>** | 笶?譌?| <20>氏 ASL讓｡蝮玲匱閭ｽ譁<EFBDBD>鍵遲幃?| 邉ｻ扈溯ｯ<E6BAAF>ｻｷ謨育紫謠仙合5蛟?|
|
||
| **AI髣ｮ遲<EFBDAE>** | 笶?譌?| <20>氏 AIA讓｡蝮<EFBDA1>10+譎ｺ閭ｽ菴楢ｾ<E6A5A2><EFBDBE>?| 蜈ｨ豬∫ｨ帰I霎<49>勧 |
|
||
| **遏･隸<EFBDA5>ｺ?* | 笶?譌?| <20>氏 PKB讓｡蝮由AG髣ｮ遲<EFBDAE> | 鬘ｹ逶ｮ遏･隸<EFBDA5>ｲ画ｷ |
|
||
|
||
---
|
||
|
||
## <20>女<EFBFBD>?蟇ｹ謗･譫ｶ譫<EFBDB6>ｮｾ隶｡
|
||
|
||
### 謨ｴ菴捺楔譫<E6A594>
|
||
|
||
```
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 逕ｨ謌ｷ螻ゑｼ育<EFBDBC>皮ｩｶ莠ｺ蜻<EFBDBA>/蛹ｻ逕滂ｼ? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 蜑咲ｫｯ螻慕､ｺ螻? 笏?
|
||
笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||
笏? 笏? REDCap Web UI 笏? 笏?AIclinicalresearch 笏? 笏?
|
||
笏? 笏? (蜴溽函逡碁擇) 笏や淀笏笏笏笏笏笏笏笏笏笏笏笏笆ｺ笏<EFBDBA> Frontend (React) 笏? 笏?
|
||
笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 髮<><E9ABAE>螻ゑｼ域<EFBDBC>ｸ蠢<EFBDB8>ｼ? 笏?
|
||
笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||
笏? 笏? REDCap External Module: "AI Research Assistant" 笏? 笏?
|
||
笏? 笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏 笏? 笏?
|
||
笏? 笏? 笏懌楳笏 謨ｰ謐ｮ蜷梧ｭ･譛榊苅 (Data Sync Service) 笏? 笏?
|
||
笏? 笏? 笏懌楳笏 AI蜉溯<E89C89>闖懷黒 (AI Menu Links) 笏? 笏?
|
||
笏? 笏? 笏懌楳笏 Hooks螟<73>炊蝎?(Hook Handlers) 笏? 笏?
|
||
笏? 笏? 笏披楳笏 API莉｣逅<EFBDA3>ｱ?(API Proxy) 笏? 笏?
|
||
笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||
笏? 竊? 笏?
|
||
笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||
笏? 笏? AIclinicalresearch Backend RESTful API 笏? 笏?
|
||
笏? 笏? /api/v1/redcap/* 笏? 笏?
|
||
笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 荳壼苅螟<E88B85>炊螻ゑｼ<E38291>I閭ｽ蜉幢ｼ? 笏?
|
||
笏? 笏娯楳笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏? 笏?
|
||
笏? 笏?DC 笏? 笏?SSA 笏? 笏?ASL 笏? 笏?AIA 笏? 笏?PKB 笏? ... 笏?
|
||
笏? 笏よ焚謐? 笏? 笏らｻ溯ｮ? 笏? 笏よ枚迪? 笏? 笏る琉遲? 笏? 笏ら衍隸<E8A18D>ｺ凪<EFBDBA>? 笏?
|
||
笏? 笏よｸ<E38288>ｴ? 笏? 笏ょ<E7AC8F>譫? 笏? 笏らｭ幃? 笏? 笏? 笏? 笏? 笏? 笏?
|
||
笏? 笏披楳笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 謨ｰ謐ｮ蟄伜お螻? 笏?
|
||
笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||
笏? 笏? REDCap MySQL 笏? 笏? AI Platform 笏? 笏?
|
||
笏? 笏? (荳ｴ蠎頑焚謐ｮ) 笏や淀笏笏笏笏笏笏笏笆ｺ笏<EFBDBA> PostgreSQL 笏? 笏?
|
||
笏? 笏? - 謔｣閠<EFBDA3>焚謐? 笏? 蜷梧ｭ･ 笏? (蛻<>梵扈捺棡) 笏? 笏?
|
||
笏? 笏? - 陦ｨ蜊募<E89C8A>謨ｰ謐? 笏? 笏? - 貂<>ｴ怜錘謨ｰ謐? 笏? 笏?
|
||
笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
```
|
||
|
||
### 譬ｸ蠢<EFBDB8>ｯｹ謗･讓｡蠑<EFBDA1>
|
||
|
||
謌台ｻｬ驥<EFBFBD>畑**蜿悟髄蟇ｹ謗･**遲也払<E4B99F>?
|
||
|
||
#### 讓｡蠑就<E8A091>啌EDCap 竊?AI蟷ｳ蜿ｰ<E89CBF>域焚謐ｮ謗ｨ騾<EFBDA8>ｼ<EFBFBD>
|
||
|
||
```
|
||
逕ｨ謌ｷ蝨ｨREDCap蠖募<EFBFBD>謨ｰ謐ｮ
|
||
竊?
|
||
redcap_save_record Hook隗ｦ蜿<EFBDA6>
|
||
竊?
|
||
External Module謗ｨ騾∵焚謐ｮ蛻ｰAI蟷ｳ蜿ｰAPI
|
||
竊?
|
||
AI蟷ｳ蜿ｰ螟<EFBFBD>炊<EFBFBD>域ｸ<EFBFBD>ｴ?蛻<>梵/AI螟<49>炊<EFBFBD>?
|
||
竊?
|
||
扈捺棡霑泌屓REDCap蟄伜お
|
||
```
|
||
|
||
#### 讓｡蠑州<E8A091>哂I蟷ｳ蜿ｰ 竊?REDCap<61>域焚謐ｮ諡牙叙<E78999><E58F99>
|
||
|
||
```
|
||
逕ｨ謌ｷ蝨ｨAI蟷ｳ蜿ｰ蜿題ｵｷ蛻<EFBFBD>梵
|
||
竊?
|
||
AI蟷ｳ蜿ｰ隹<EFBFBD>畑REDCap API闔ｷ蜿匁焚謐ｮ
|
||
竊?
|
||
AI蟷ｳ蜿ｰ謇ｧ陦悟<EFBFBD>譫撰ｼ<EFBFBD>C/SSA/AIA遲会ｼ<E4BC9A>
|
||
竊?
|
||
扈捺棡螻慕､ｺ蝨ｨAI蟷ｳ蜿ｰ蜑咲ｫｯ
|
||
竊?
|
||
<EFBFBD>亥庄騾会ｼ臥ｻ捺棡蝗槫<EFBFBD>REDCap
|
||
```
|
||
|
||
---
|
||
|
||
## <20>肌 謚譛ｯ譁ｹ譯郁ｯｦ隗?
|
||
|
||
### 譁ｹ譯<EFBDB9>1<EFBFBD>啌EDCap External Module蠑蜿?
|
||
|
||
#### 讓｡蝮怜多蜷堺ｸ守ｻ捺<EFBDBB>?
|
||
|
||
```
|
||
讓｡蝮怜錐遘ｰ: ai_research_assistant
|
||
迚域悽: v1.0.0
|
||
螳梧紛逶ｮ蠖<EFBFBD>: <redcap-root>/modules/ai_research_assistant_v1.0.0/
|
||
|
||
逶ｮ蠖慕ｻ捺桷:
|
||
ai_research_assistant_v1.0.0/
|
||
笏懌楳笏 config.json # 讓｡蝮鈴<E89DAE>鄂ｮ
|
||
笏懌楳笏 AiResearchAssistantModule.php # 荳ｻ騾ｻ霎醍ｱ?
|
||
笏懌楳笏 README.md # 隸ｴ譏取枚譯｣
|
||
笏懌楳笏 LICENSE # MIT隶ｸ蜿ｯ
|
||
笏懌楳笏 pages/ # 閾ｪ螳壻ｹ蛾｡ｵ髱?
|
||
笏? 笏懌楳笏 dashboard.php # AI蜉溯<E89C89>莉ｪ陦ｨ逶?
|
||
笏? 笏懌楳笏 data_sync.php # 謨ｰ謐ｮ蜷梧ｭ･邂｡逅<EFBDA1>
|
||
笏? 笏懌楳笏 analysis_center.php # 蛻<>梵荳ｭ蠢<EFBDAD>
|
||
笏? 笏披楳笏 settings.php # 讓｡蝮苓ｮｾ鄂ｮ
|
||
笏懌楳笏 js/ # JavaScript譁<74>ｻｶ
|
||
笏? 笏懌楳笏 dashboard.js
|
||
笏? 笏披楳笏 data_sync.js
|
||
笏懌楳笏 css/ # 譬ｷ蠑乗枚莉ｶ
|
||
笏? 笏披楳笏 style.css
|
||
笏披楳笏 services/ # 譛榊苅邀?
|
||
笏懌楳笏 ApiClient.php # AI蟷ｳ蜿ｰAPI螳｢謌ｷ遶?
|
||
笏懌楳笏 DataMapper.php # 謨ｰ謐ｮ譏<EFBDAE>蟆<EFBFBD>ｽｬ謐｢
|
||
笏披楳笏 SyncService.php # 蜷梧ｭ･譛榊苅
|
||
```
|
||
|
||
#### config.json譬ｸ蠢<EFBDB8><E8A0A2>鄂ｮ
|
||
|
||
```json
|
||
{
|
||
"name": "AI Research Assistant",
|
||
"description": "螢ｹ隸∝ｾｪAI遘醍<E98198>泌ｹｳ蜿ｰ髮<EFBDB0><E9ABAE>讓｡蝮<EFBDA1> - 謠蝉ｾ帶焚謐ｮ譎ｺ閭ｽ貂<EFBDBD>ｴ励∫ｻ溯ｮ｡蛻<EFBDA1>梵縲∵枚迪ｮ謾ｯ謖∫ｭ陰I蠅槫ｼ蜉溯<E89C89>?,
|
||
"authors": [
|
||
{
|
||
"name": "螢ｹ隸∝ｾｪ遘第橿",
|
||
"email": "support@yizx.ai",
|
||
"institution": "螢ｹ隸∝ｾｪ遘第橿"
|
||
}
|
||
],
|
||
"framework-version": 16,
|
||
"permissions": [],
|
||
"links": {
|
||
"project": [
|
||
{
|
||
"name": "<EFBFBD>､<EFBFBD> AI蜉溯<EFBFBD>荳ｭ蠢<EFBFBD>",
|
||
"icon": "fas fa-brain",
|
||
"url": "pages/dashboard.php",
|
||
"show-header-and-footer": true
|
||
},
|
||
{
|
||
"name": "<EFBFBD>売 謨ｰ謐ｮ蜷梧ｭ･",
|
||
"icon": "fas fa-sync-alt",
|
||
"url": "pages/data_sync.php",
|
||
"show-header-and-footer": true
|
||
},
|
||
{
|
||
"name": "<EFBFBD>投 AI蛻<EFBFBD>梵荳ｭ蠢<EFBFBD>",
|
||
"icon": "fas fa-chart-line",
|
||
"url": "pages/analysis_center.php",
|
||
"show-header-and-footer": true
|
||
}
|
||
],
|
||
"control-center": [
|
||
{
|
||
"name": "AI蟷ｳ蜿ｰ驟咲ｽｮ",
|
||
"icon": "fas fa-cog",
|
||
"url": "pages/settings.php"
|
||
}
|
||
]
|
||
},
|
||
"system-settings": [
|
||
{
|
||
"key": "ai_platform_url",
|
||
"name": "AI蟷ｳ蜿ｰ蝨ｰ蝮",
|
||
"type": "text",
|
||
"required": true,
|
||
"default": "https://ai.yizx.com"
|
||
},
|
||
{
|
||
"key": "ai_platform_api_key",
|
||
"name": "API蟇<49>徴",
|
||
"type": "password",
|
||
"required": true
|
||
},
|
||
{
|
||
"key": "enable_auto_sync",
|
||
"name": "蜷ｯ逕ｨ閾ｪ蜉ｨ蜷梧ｭ･",
|
||
"type": "checkbox",
|
||
"default": true
|
||
}
|
||
],
|
||
"project-settings": [
|
||
{
|
||
"key": "sync_mode",
|
||
"name": "蜷梧ｭ･讓｡蠑<EFBDA1>",
|
||
"type": "dropdown",
|
||
"choices": [
|
||
{"value": "manual", "name": "謇句勘蜷梧ｭ･"},
|
||
{"value": "realtime", "name": "螳樊慮蜷梧ｭ･"},
|
||
{"value": "scheduled", "name": "螳壽慮蜷梧ｭ･"}
|
||
],
|
||
"default": "realtime"
|
||
},
|
||
{
|
||
"key": "enable_dc_module",
|
||
"name": "蜷ｯ逕ｨ謨ｰ謐ｮ貂<EFBDAE>ｴ玲ｨ｡蝮<EFBDA1>",
|
||
"type": "checkbox",
|
||
"default": true
|
||
},
|
||
{
|
||
"key": "enable_ssa_module",
|
||
"name": "蜷ｯ逕ｨ扈溯ｮ｡蛻<EFBDA1>梵讓｡蝮<EFBDA1>",
|
||
"type": "checkbox",
|
||
"default": true
|
||
},
|
||
{
|
||
"key": "enable_asl_module",
|
||
"name": "蜷ｯ逕ｨ譎ｺ閭ｽ譁<EFBDBD>鍵讓｡蝮<EFBDA1>",
|
||
"type": "checkbox",
|
||
"default": false
|
||
}
|
||
],
|
||
"crons": [
|
||
{
|
||
"cron_name": "data_sync_cron",
|
||
"cron_description": "螳壽慮蜷梧ｭ･謨ｰ謐ｮ蛻ｰAI蟷ｳ蜿ｰ",
|
||
"method": "syncDataToAIPlatform",
|
||
"cron_frequency": "3600",
|
||
"cron_max_run_time": "600"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
#### 荳ｻ騾ｻ霎醍ｱｻ<EFBDB1><EFBDBB>iResearchAssistantModule.php<68>?
|
||
|
||
```php
|
||
<?php
|
||
namespace YiZhengXun\AiResearchAssistant;
|
||
|
||
use ExternalModules\AbstractExternalModule;
|
||
use REDCap;
|
||
|
||
class AiResearchAssistantModule extends AbstractExternalModule {
|
||
|
||
// API螳｢謌ｷ遶ｯ螳樔ｾ?
|
||
private $apiClient;
|
||
|
||
/**
|
||
* 譫<><EFBFBD>蜃ｽ謨?- 蛻晏ｧ句喧API螳｢謌ｷ遶?
|
||
*/
|
||
public function __construct() {
|
||
parent::__construct();
|
||
require_once __DIR__ . '/services/ApiClient.php';
|
||
$this->apiClient = new ApiClient(
|
||
$this->getSystemSetting('ai_platform_url'),
|
||
$this->getSystemSetting('ai_platform_api_key')
|
||
);
|
||
}
|
||
|
||
/**
|
||
* Hook: 謨ｰ謐ｮ菫晏ｭ俶慮隗ｦ蜿?
|
||
* 譬ｸ蠢<EFBDB8>粥閭ｽ<E996AD>壼ｮ樊慮謗ｨ騾∵焚謐ｮ蛻ｰAI蟷ｳ蜿ｰ
|
||
*/
|
||
public function redcap_save_record(
|
||
$project_id,
|
||
$record,
|
||
$instrument,
|
||
$event_id,
|
||
$group_id,
|
||
$survey_hash,
|
||
$response_id,
|
||
$repeat_instance
|
||
) {
|
||
// 譽譟･譏ｯ蜷ｦ蜷ｯ逕ｨ螳樊慮蜷梧ｭ?
|
||
$syncMode = $this->getProjectSetting('sync_mode');
|
||
if ($syncMode !== 'realtime') {
|
||
return;
|
||
}
|
||
|
||
// 髦ｲ豁｢譌<EFBDA2>髯仙ｾｪ邇ｯ
|
||
static $is_syncing = false;
|
||
if ($is_syncing) return;
|
||
$is_syncing = true;
|
||
|
||
try {
|
||
// 闔ｷ蜿冶ｮｰ蠖墓焚謐ｮ
|
||
$data = REDCap::getData($project_id, 'array', $record);
|
||
|
||
// 霓ｬ謐｢謨ｰ謐ｮ譬ｼ蠑<EFBDBC>
|
||
require_once __DIR__ . '/services/DataMapper.php';
|
||
$mapper = new DataMapper();
|
||
$mappedData = $mapper->redcapToAIPlatform($data, $project_id, $record);
|
||
|
||
// 謗ｨ騾∝芦AI蟷ｳ蜿ｰ
|
||
$result = $this->apiClient->post('/api/v1/redcap/records', $mappedData);
|
||
|
||
// 隶ｰ蠖墓律蠢<E5BE8B>
|
||
$this->log("謨ｰ謐ｮ蜷梧ｭ･謌仙粥", [
|
||
'project_id' => $project_id,
|
||
'record' => $record,
|
||
'instrument' => $instrument,
|
||
'ai_platform_response' => $result
|
||
]);
|
||
|
||
// 螯よ棡蜷ｯ逕ｨ莠<EFBDA8>I謨ｰ謐ｮ貂<EFBDAE>ｴ暦ｼ瑚ｧｦ蜿第ｸ<E7ACAC>ｴ嶺ｻｻ蜉?
|
||
if ($this->getProjectSetting('enable_dc_module')) {
|
||
$this->triggerDataCleaning($project_id, $record);
|
||
}
|
||
|
||
} catch (\Exception $e) {
|
||
// 髞呵ｯｯ螟<EFBDAF>炊
|
||
$this->log("謨ｰ謐ｮ蜷梧ｭ･螟ｱ雍･", [
|
||
'project_id' => $project_id,
|
||
'record' => $record,
|
||
'error' => $e->getMessage()
|
||
]);
|
||
}
|
||
|
||
$is_syncing = false;
|
||
}
|
||
|
||
/**
|
||
* Hook: 豈丈ｸｪ鬘ｵ髱｢鬘ｶ驛ｨ
|
||
* 蜉溯<E89C89><E6BAAF>壽ｳｨ蜈･AI霎<49>勧蠖募<E8A096>逧ЙavaScript
|
||
*/
|
||
public function redcap_every_page_top($project_id) {
|
||
// 莉<>惠謨ｰ謐ｮ蠖募<E8A096>鬘ｵ髱｢逕滓譜
|
||
if (strpos(PAGE, 'DataEntry/index.php') !== false) {
|
||
$this->injectAIAssistant();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Hook: 謨ｰ謐ｮ蟇ｼ蜃ｺ蜑?
|
||
* 蜉溯<E89C89><E6BAAF>壼庄莉･豺ｻ蜉<EFBDBB>AI蛻<49>梵扈捺棡蟄玲ｮｵ蛻ｰ蟇ｼ蜃?
|
||
*/
|
||
public function redcap_custom_verify_username($username) {
|
||
// 鬪瑚ｯ<E7919A>ｻ霎<EFBDBB>
|
||
}
|
||
|
||
/**
|
||
* Cron莉ｻ蜉｡: 螳壽慮蜷梧ｭ･謨ｰ謐ｮ
|
||
*/
|
||
public function syncDataToAIPlatform($cron_info) {
|
||
$projects = $this->getEnabledProjects();
|
||
|
||
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,
|
||
'timestamp' => time()
|
||
]);
|
||
|
||
$this->log("螳壽慮蜷梧ｭ･螳梧<EFBFBD>", [
|
||
'project_id' => $project_id,
|
||
'records_count' => count($data)
|
||
]);
|
||
|
||
} catch (\Exception $e) {
|
||
$this->log("螳壽慮蜷梧ｭ･螟ｱ雍･", [
|
||
'project_id' => $project_id,
|
||
'error' => $e->getMessage()
|
||
]);
|
||
}
|
||
}
|
||
|
||
return "蜷梧ｭ･螳梧<EFBFBD>";
|
||
}
|
||
|
||
/**
|
||
* 隗ｦ蜿羨I謨ｰ謐ｮ貂<EFBDAE>ｴ<EFBFBD>
|
||
*/
|
||
private function triggerDataCleaning($project_id, $record) {
|
||
$result = $this->apiClient->post('/api/v1/redcap/dc/clean', [
|
||
'project_id' => $project_id,
|
||
'record' => $record,
|
||
'auto_mode' => true
|
||
]);
|
||
|
||
return $result;
|
||
}
|
||
|
||
/**
|
||
* 豕ｨ蜈･AI霎<49>勧蠖募<E8A096>JavaScript
|
||
*/
|
||
private function injectAIAssistant() {
|
||
?>
|
||
<script src="<?= $this->getUrl('js/ai_assistant.js') ?>"></script>
|
||
<script>
|
||
const aiConfig = {
|
||
apiUrl: '<?= $this->getSystemSetting('ai_platform_url') ?>',
|
||
projectId: <?= PROJECT_ID ?>,
|
||
enableAutoComplete: true,
|
||
enableSmartValidation: true
|
||
};
|
||
AiAssistant.init(aiConfig);
|
||
</script>
|
||
<?php
|
||
}
|
||
|
||
/**
|
||
* 闔ｷ蜿門星逕ｨ讓｡蝮礼噪鬘ｹ逶ｮ蛻苓｡?
|
||
*/
|
||
private function getEnabledProjects() {
|
||
$sql = "SELECT project_id FROM redcap_external_modules
|
||
WHERE external_module_id = ?
|
||
AND directory_prefix = ?";
|
||
$result = $this->query($sql, [
|
||
$this->getModuleId(),
|
||
$this->PREFIX
|
||
]);
|
||
|
||
$projects = [];
|
||
while ($row = $result->fetch_assoc()) {
|
||
$projects[] = $row['project_id'];
|
||
}
|
||
|
||
return $projects;
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 譁ｹ譯<EFBDB9>2<EFBFBD>哂I蟷ｳ蜿ｰBackend API蠑蜿?
|
||
|
||
#### 譁ｰ蠅朿EDCap荳鍋畑讓｡蝮<EFBDA1>
|
||
|
||
```typescript
|
||
// backend/src/modules/redcap/ 逶ｮ蠖慕ｻ捺桷
|
||
backend/src/modules/redcap/
|
||
笏懌楳笏 controllers/
|
||
笏? 笏懌楳笏 RedcapController.ts // 荳ｻ謗ｧ蛻ｶ蝎ｨ
|
||
笏? 笏懌楳笏 SyncController.ts // 謨ｰ謐ｮ蜷梧ｭ･謗ｧ蛻ｶ蝎?
|
||
笏? 笏披楳笏 WebhookController.ts // Webhook謗ｧ蛻ｶ蝎?
|
||
笏懌楳笏 services/
|
||
笏? 笏懌楳笏 RedcapApiClient.ts // REDCap API螳｢謌ｷ遶?
|
||
笏? 笏懌楳笏 DataTransformService.ts // 謨ｰ謐ｮ霓ｬ謐｢譛榊苅
|
||
笏? 笏懌楳笏 SyncService.ts // 蜷梧ｭ･譛榊苅
|
||
笏? 笏披楳笏 ProjectMappingService.ts // 鬘ｹ逶ｮ譏<EFBDAE>蟆<EFBFBD>恪蜉｡
|
||
笏懌楳笏 models/
|
||
笏? 笏披楳笏 redcap.prisma // Prisma Schema
|
||
笏懌楳笏 routes/
|
||
笏? 笏披楳笏 redcap.routes.ts // 霍ｯ逕ｱ螳壻ｹ<E5A3BB>
|
||
笏披楳笏 types/
|
||
笏披楳笏 redcap.types.ts // TypeScript邀ｻ蝙句ｮ壻ｹ<E5A3BB>
|
||
```
|
||
|
||
#### Prisma Schema隶ｾ隶｡
|
||
|
||
```prisma
|
||
// backend/prisma/schema.prisma
|
||
|
||
// REDCap Schema
|
||
datasource redcap_schema {
|
||
provider = "postgresql"
|
||
url = env("DATABASE_URL")
|
||
schemas = ["redcap_schema"]
|
||
}
|
||
|
||
// REDCap鬘ｹ逶ｮ譏<EFBDAE>蟆<EFBFBD>｡?
|
||
model RedcapProject {
|
||
id String @id @default(cuid())
|
||
redcapProjectId Int @unique // REDCap鬘ｹ逶ｮID
|
||
redcapUrl String // REDCap譛榊苅蝎ｨ蝨ｰ蝮
|
||
redcapApiToken String @db.VarChar(64) // API Token (蜉<>蟇<EFBFBD>ｭ伜お)
|
||
|
||
// 譏<>蟆<EFBFBD><E89F86>邉ｻ
|
||
dcProjectId String? // 蜈ｳ閨皮噪DC鬘ｹ逶ｮID
|
||
ssaProjectId String? // 蜈ｳ閨皮噪SSA鬘ｹ逶ｮID
|
||
aslProjectId String? // 蜈ｳ閨皮噪ASL鬘ｹ逶ｮID
|
||
|
||
// 蜷梧ｭ･驟咲ｽｮ
|
||
syncEnabled Boolean @default(true)
|
||
syncMode String @default("realtime") // realtime, scheduled, manual
|
||
lastSyncAt DateTime?
|
||
|
||
// 蜈<>焚謐?
|
||
projectName String
|
||
projectDescription String? @db.Text
|
||
|
||
createdAt DateTime @default(now())
|
||
updatedAt DateTime @updatedAt
|
||
|
||
// 蜈ｳ閨泌<E996A8>邉ｻ
|
||
syncRecords RedcapSyncRecord[]
|
||
fieldMappings RedcapFieldMapping[]
|
||
|
||
@@map("redcap_projects")
|
||
@@schema("redcap_schema")
|
||
}
|
||
|
||
// REDCap蜷梧ｭ･隶ｰ蠖戊｡?
|
||
model RedcapSyncRecord {
|
||
id String @id @default(cuid())
|
||
projectId String
|
||
project RedcapProject @relation(fields: [projectId], references: [id], onDelete: Cascade)
|
||
|
||
recordId String // REDCap隶ｰ蠖肘D
|
||
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蟷ｳ蜿ｰ螟<EFBDB0>炊蜷取焚謐?
|
||
|
||
// 髞呵ｯｯ菫｡諱ｯ
|
||
errorMessage String? @db.Text
|
||
retryCount Int @default(0)
|
||
|
||
syncedAt DateTime @default(now())
|
||
|
||
@@map("redcap_sync_records")
|
||
@@schema("redcap_schema")
|
||
@@index([projectId, recordId])
|
||
@@index([status])
|
||
}
|
||
|
||
// REDCap蟄玲ｮｵ譏<EFBDB5>蟆<EFBFBD>｡?
|
||
model RedcapFieldMapping {
|
||
id String @id @default(cuid())
|
||
projectId String
|
||
project RedcapProject @relation(fields: [projectId], references: [id], onDelete: Cascade)
|
||
|
||
// REDCap蟄玲ｮｵ菫｡諱ｯ
|
||
redcapFieldName String
|
||
redcapFieldLabel String?
|
||
redcapFieldType String // text, radio, checkbox, dropdown, etc.
|
||
|
||
// AI蟷ｳ蜿ｰ蟄玲ｮｵ譏<EFBDB5>蟆<EFBFBD>
|
||
aiPlatformField String? // 譏<>蟆<EFBFBD>芦AI蟷ｳ蜿ｰ逧<EFBDB0>ｭ玲ｮｵ蜷<EFBDB5>
|
||
transformRule Json? // 霓ｬ謐｢隗<EFBDA2><E99A97><EFBFBD><EFBFBD>SON<4F>?
|
||
|
||
// 譏<>蟆<EFBFBD><E89F86>鄂ｮ
|
||
isRequired Boolean @default(false)
|
||
isIdentifier Boolean @default(false) // 譏ｯ蜷ｦ荳ｺ荳ｻ髞ｮ蟄玲ｮ?
|
||
|
||
createdAt DateTime @default(now())
|
||
updatedAt DateTime @updatedAt
|
||
|
||
@@map("redcap_field_mappings")
|
||
@@schema("redcap_schema")
|
||
@@unique([projectId, redcapFieldName])
|
||
}
|
||
```
|
||
|
||
#### REDCap API霍ｯ逕ｱ螳壻ｹ<E5A3BB>
|
||
|
||
```typescript
|
||
// backend/src/modules/redcap/routes/redcap.routes.ts
|
||
|
||
import { FastifyInstance } from 'fastify';
|
||
import { RedcapController } from '../controllers/RedcapController';
|
||
import { SyncController } from '../controllers/SyncController';
|
||
import { WebhookController } from '../controllers/WebhookController';
|
||
|
||
export async function redcapRoutes(fastify: FastifyInstance) {
|
||
const redcapController = new RedcapController();
|
||
const syncController = new SyncController();
|
||
const webhookController = new WebhookController();
|
||
|
||
// ========== 鬘ｹ逶ｮ邂｡逅<EFBDA1> ==========
|
||
|
||
// 蛻帛ｻｺREDCap鬘ｹ逶ｮ譏<EFBDAE>蟆<EFBFBD>
|
||
fastify.post('/api/v1/redcap/projects',
|
||
redcapController.createProject
|
||
);
|
||
|
||
// 闔ｷ蜿夜｡ｹ逶ｮ蛻苓｡ｨ
|
||
fastify.get('/api/v1/redcap/projects',
|
||
redcapController.listProjects
|
||
);
|
||
|
||
// 闔ｷ蜿夜｡ｹ逶ｮ隸ｦ諠<EFBDA6>
|
||
fastify.get('/api/v1/redcap/projects/:id',
|
||
redcapController.getProject
|
||
);
|
||
|
||
// 譖ｴ譁ｰ鬘ｹ逶ｮ驟咲ｽｮ
|
||
fastify.put('/api/v1/redcap/projects/:id',
|
||
redcapController.updateProject
|
||
);
|
||
|
||
// 蛻<>髯､鬘ｹ逶ｮ譏<EFBDAE>蟆<EFBFBD>
|
||
fastify.delete('/api/v1/redcap/projects/:id',
|
||
redcapController.deleteProject
|
||
);
|
||
|
||
// ========== 謨ｰ謐ｮ蜷梧ｭ･ ==========
|
||
|
||
// 謇句勘隗ｦ蜿大酔豁･<E8B181><EFBDA5>EDCap 竊?AI蟷ｳ蜿ｰ<E89CBF>?
|
||
fastify.post('/api/v1/redcap/sync/import/:projectId',
|
||
syncController.importFromRedcap
|
||
);
|
||
|
||
// 謗ｨ騾∵焚謐ｮ蛻ｰREDCap<61><70>I蟷ｳ蜿ｰ 竊?REDCap<61>?
|
||
fastify.post('/api/v1/redcap/sync/export/:projectId',
|
||
syncController.exportToRedcap
|
||
);
|
||
|
||
// 譟･隸｢蜷梧ｭ･迥ｶ諤?
|
||
fastify.get('/api/v1/redcap/sync/status/:projectId',
|
||
syncController.getSyncStatus
|
||
);
|
||
|
||
// 譟･隸｢蜷梧ｭ･蜴<EFBDA5>彰
|
||
fastify.get('/api/v1/redcap/sync/history/:projectId',
|
||
syncController.getSyncHistory
|
||
);
|
||
|
||
// ========== Webhook謗･謾ｶ ==========
|
||
|
||
// REDCap External Module謗ｨ騾∵焚謐ｮ<E8AC90>亥ｮ樊慮蜷梧ｭ･<EFBDAD>?
|
||
fastify.post('/api/v1/redcap/webhook/records',
|
||
webhookController.receiveRecordUpdate
|
||
);
|
||
|
||
// 謇ｹ驥丞酔豁･<E8B181>亥ｮ壽慮莉ｻ蜉｡<E89C89><EFBDA1>
|
||
fastify.post('/api/v1/redcap/webhook/batch-sync',
|
||
webhookController.receiveBatchSync
|
||
);
|
||
|
||
// ========== 蟄玲ｮｵ譏<EFBDB5>蟆<EFBFBD>ｮ｡逅<EFBDA1> ==========
|
||
|
||
// 闔ｷ蜿乏EDCap鬘ｹ逶ｮ蜈<EFBDAE>焚謐ｮ<E8AC90>亥ｭ玲ｮｵ蛻苓｡ｨ<EFBDA1>?
|
||
fastify.get('/api/v1/redcap/projects/:id/metadata',
|
||
redcapController.getProjectMetadata
|
||
);
|
||
|
||
// 蛻帛ｻｺ/譖ｴ譁ｰ蟄玲ｮｵ譏<EFBDB5>蟆<EFBFBD>
|
||
fastify.post('/api/v1/redcap/projects/:id/field-mappings',
|
||
redcapController.upsertFieldMappings
|
||
);
|
||
|
||
// 闔ｷ蜿門ｭ玲ｮｵ譏<EFBDB5>蟆<EFBFBD>
|
||
fastify.get('/api/v1/redcap/projects/:id/field-mappings',
|
||
redcapController.getFieldMappings
|
||
);
|
||
|
||
// ========== AI蜉溯<E89C89>髮<EFBFBD><E9ABAE> ==========
|
||
|
||
// 隗ｦ蜿第焚謐ｮ貂<EFBDAE>ｴ暦ｼ<E69AA6>C讓｡蝮暦ｼ?
|
||
fastify.post('/api/v1/redcap/dc/clean',
|
||
redcapController.triggerDataCleaning
|
||
);
|
||
|
||
// 隗ｦ蜿醍ｻ溯ｮ｡蛻<EFBDA1>梵<EFBFBD><E6A2B5>SA讓｡蝮暦ｼ?
|
||
fastify.post('/api/v1/redcap/ssa/analyze',
|
||
redcapController.triggerStatisticalAnalysis
|
||
);
|
||
|
||
// 闔ｷ蜿泡I蛻<49>梵扈捺棡
|
||
fastify.get('/api/v1/redcap/analysis/:recordId',
|
||
redcapController.getAnalysisResults
|
||
);
|
||
}
|
||
```
|
||
|
||
#### 譬ｸ蠢イontroller螳樒鴫
|
||
|
||
```typescript
|
||
// backend/src/modules/redcap/controllers/SyncController.ts
|
||
|
||
import { FastifyRequest, FastifyReply } from 'fastify';
|
||
import { prisma } from '@/config/database';
|
||
import { logger } from '@/common/logging';
|
||
import { RedcapApiClient } from '../services/RedcapApiClient';
|
||
import { DataTransformService } from '../services/DataTransformService';
|
||
|
||
export class SyncController {
|
||
|
||
/**
|
||
* 莉山EDCap蟇ｼ蜈･謨ｰ謐ｮ蛻ｰAI蟷ｳ蜿ｰ
|
||
*/
|
||
async importFromRedcap(
|
||
req: FastifyRequest<{ Params: { projectId: string } }>,
|
||
res: FastifyReply
|
||
) {
|
||
const { projectId } = req.params;
|
||
|
||
try {
|
||
// 1. 闔ｷ蜿夜｡ｹ逶ｮ驟咲ｽｮ
|
||
const project = await prisma.redcapProject.findUnique({
|
||
where: { id: projectId },
|
||
include: { fieldMappings: true }
|
||
});
|
||
|
||
if (!project) {
|
||
return res.status(404).send({
|
||
success: false,
|
||
error: '鬘ｹ逶ｮ荳榊ｭ伜<EFBDAD>?
|
||
});
|
||
}
|
||
|
||
// 2. 隹<>畑REDCap API闔ｷ蜿匁焚謐ｮ
|
||
const redcapClient = new RedcapApiClient(
|
||
project.redcapUrl,
|
||
project.redcapApiToken
|
||
);
|
||
|
||
const redcapData = await redcapClient.exportRecords({
|
||
format: 'json',
|
||
type: 'flat'
|
||
});
|
||
|
||
logger.info('莉山EDCap闔ｷ蜿匁焚謐ｮ謌仙粥', {
|
||
projectId,
|
||
recordCount: redcapData.length
|
||
});
|
||
|
||
// 3. 謨ｰ謐ｮ霓ｬ謐｢
|
||
const transformer = new DataTransformService();
|
||
const transformedData = await transformer.redcapToAIPlatform(
|
||
redcapData,
|
||
project.fieldMappings
|
||
);
|
||
|
||
// 4. 蟄伜お蛻ｰAI蟷ｳ蜿ｰ謨ｰ謐ｮ蠎?
|
||
// 譬ｹ謐ｮ鬘ｹ逶ｮ驟咲ｽｮ<EFBDBD>梧耳騾∝芦DC/SSA/ASL遲画ｨ｡蝮?
|
||
if (project.dcProjectId) {
|
||
await this.importToDCModule(project.dcProjectId, transformedData);
|
||
}
|
||
|
||
if (project.ssaProjectId) {
|
||
await this.importToSSAModule(project.ssaProjectId, transformedData);
|
||
}
|
||
|
||
// 5. 隶ｰ蠖募酔豁･蜴<EFBDA5>彰
|
||
await prisma.redcapSyncRecord.create({
|
||
data: {
|
||
projectId,
|
||
recordId: 'batch_import',
|
||
status: 'success',
|
||
direction: 'redcap_to_ai',
|
||
redcapData: redcapData as any,
|
||
aiPlatformData: transformedData as any
|
||
}
|
||
});
|
||
|
||
// 6. 譖ｴ譁ｰ蜷梧ｭ･譌ｶ髣ｴ
|
||
await prisma.redcapProject.update({
|
||
where: { id: projectId },
|
||
data: { lastSyncAt: new Date() }
|
||
});
|
||
|
||
return res.send({
|
||
success: true,
|
||
message: '謨ｰ謐ｮ蟇ｼ蜈･謌仙粥',
|
||
data: {
|
||
recordCount: redcapData.length,
|
||
transformedCount: transformedData.length
|
||
}
|
||
});
|
||
|
||
} catch (error) {
|
||
logger.error('REDCap謨ｰ謐ｮ蟇ｼ蜈･螟ｱ雍･', {
|
||
projectId,
|
||
error: error.message
|
||
});
|
||
|
||
return res.status(500).send({
|
||
success: false,
|
||
error: '謨ｰ謐ｮ蟇ｼ蜈･螟ｱ雍･',
|
||
details: error.message
|
||
});
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 蟇ｼ蜈･蛻ｰDC讓｡蝮<EFBDA1>
|
||
*/
|
||
private async importToDCModule(dcProjectId: string, data: any[]) {
|
||
// 隹<>畑DC讓｡蝮礼噪蟇ｼ蜈･API
|
||
// TODO: 螳樒鴫DC讓｡蝮鈴寔謌宣ｻ霎<EFBDBB>
|
||
}
|
||
|
||
/**
|
||
* 蟇ｼ蜈･蛻ｰSSA讓｡蝮<EFBDA1>
|
||
*/
|
||
private async importToSSAModule(ssaProjectId: string, data: any[]) {
|
||
// 隹<>畑SSA讓｡蝮礼噪蟇ｼ蜈･API
|
||
// TODO: 螳樒鴫SSA讓｡蝮鈴寔謌宣ｻ霎<EFBDBB>
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## <20>投 謨ｰ謐ｮ豬∬ｮｾ隶?
|
||
|
||
### 謨ｰ謐ｮ豬?<3F>啌EDCap 竊?AI蟷ｳ蜿ｰ<E89CBF>亥ｮ樊慮蜷梧ｭ･<EFBDAD><EFBDA5>
|
||
|
||
```
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? Step 1: 逕ｨ謌ｷ蝨ｨREDCap蠖募<E8A096>謨ｰ謐ｮ 笏?
|
||
笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏 笏?
|
||
笏? 遐皮ｩｶ莠ｺ蜻伜惠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. 隹<>畑REDCap::getData()闔ｷ蜿門ｮ梧紛隶ｰ蠖<EFBDB0> 笏?
|
||
笏? 2. DataMapper霓ｬ謐｢REDCap EAV譬ｼ蠑鞘<E8A091>AI蟷ｳ蜿ｰ譬<EFBDB0>㊥譬ｼ蠑<EFBDBC> 笏?
|
||
笏? 3. 蠎皮畑蟄玲ｮｵ譏<EFBDB5>蟆<EFBFBD>ｧ<EFBFBD><EFBDA7><EFBFBD><EFBFBD>edcap_field_mappings陦ｨ<E999A6><EFBDA8> 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? 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蟷ｳ蜿ｰ謗･謾ｶ蟷ｶ螟<EFBDB6><E89E9F>? 笏?
|
||
笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏 笏?
|
||
笏? 1. WebhookController鬪瑚ｯ∬ｯｷ豎らｭｾ蜷<EFBDBE> 笏?
|
||
笏? 2. 蟄伜お蜴溷ｧ区焚謐ｮ蛻ｰredcap_sync_records陦? 笏?
|
||
笏? 3. 蠑よｭ･隗ｦ蜿羨I螟<49>炊莉ｻ蜉｡<E89C89><EFBDA1>C/SSA讓｡蝮暦ｼ? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
竊?
|
||
笏娯楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
笏? Step 6: AI螟<49>炊荳守ｻ捺棡霑泌<E99C91>? 笏?
|
||
笏? 笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏 笏?
|
||
笏? 1. DC讓｡蝮暦ｼ壽焚謐ｮ貂<EFBDAE>ｴ励¨ER謠仙叙縲∫ｼｺ螟ｱ蛟ｼ螟<EFBDBC><E89E9F>? 笏?
|
||
笏? 2. SSA讓｡蝮暦ｼ夊<EFBDBC>蜉ｨ扈溯ｮ｡蛻<EFBDA1>梵縲∫函謌仙庄隗<E5BA84>喧蝗ｾ陦ｨ 笏?
|
||
笏? 3. 扈捺棡蟄伜お蛻ｰAI蟷ｳ蜿ｰ謨ｰ謐ｮ蠎? 笏?
|
||
笏? 4. <20>亥庄騾会ｼ牙屓蜀咏ｻ捺棡蛻ｰREDCap<61>磯夊ｿ②PI<50>? 笏?
|
||
笏披楳笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏笏?
|
||
```
|
||
|
||
### 謨ｰ謐ｮ豬?<3F>哂I蟷ｳ蜿ｰ 竊?REDCap<61>亥<EFBFBD>譫千ｻ捺棡蝗槫<E89D97><E6A7AB><EFBFBD>
|
||
|
||
```
|
||
AI蟷ｳ蜿ｰ螳梧<EFBFBD>蛻<EFBFBD>梵
|
||
竊?
|
||
逕滓<EFBFBD>蛻<EFBFBD>梵扈捺棡<EFBFBD><EFBFBD>SON<EFBFBD>?
|
||
竊?
|
||
隹<EFBFBD>畑REDCap API: importRecords
|
||
竊?
|
||
REDCap蟄伜お扈捺棡蛻ｰ迚ｹ螳壼ｭ玲ｮ?
|
||
竊?
|
||
遐皮ｩｶ莠ｺ蜻伜惠REDCap荳ｭ譟･逵帰I蛻<EFBFBD>梵扈捺棡
|
||
```
|
||
|
||
---
|
||
|
||
## <20>噫 蠑蜿題ｮ｡蛻剃ｸ主ｮ樊命豁･鬪､
|
||
|
||
### Phase 1: 蝓ｺ遑蟇ｹ謗･<E8AC97><EFBDA5>eek 1-2<>俄怛 莨伜<E88EA8>郤ｧP0
|
||
|
||
**逶ｮ譬<EFBDAE>**<EFBFBD>壼ｻｺ遶騎EDCap荳拶I蟷ｳ蜿ｰ逧<EFBFBD>渕譛ｬ霑樊<EFBFBD>?
|
||
|
||
#### Week 1: External Module鬪ｨ譫ｶ
|
||
|
||
**莉ｻ蜉｡貂<EFBDA1>黒**<EFBFBD>?
|
||
- [ ] 蛻帛ｻｺExternal Module逶ｮ蠖慕ｻ捺桷
|
||
- [ ] 郛門<E9839B>config.json驟咲ｽｮ譁<EFBDAE>ｻｶ
|
||
- [ ] 螳樒鴫AiResearchAssistantModule.php蝓ｺ遑邀?
|
||
- [ ] 螳樒鴫redcap_save_record Hook<6F>亥渕遑迚茨ｼ<E88CA8>
|
||
- [ ] 蠑蜿羨piClient.php<68><70>TTP螳｢謌ｷ遶ｯ<E981B6><EFBDAF>
|
||
- [ ] 豬玖ｯ包ｼ啌EDCap菫晏ｭ俶焚謐ｮ竊呈遠蜊ｰ譌･蠢?
|
||
|
||
**莠､莉倡<E88E89>?*<2A>?
|
||
- `ai_research_assistant_v1.0.0/` 螳梧紛逶ｮ蠖<EFBDAE>
|
||
- 蜿ｯ蝨ｨREDCap荳ｭ蜷ｯ逕ｨ逧Еxternal Module
|
||
- 蝓ｺ遑譌･蠢苓ｮｰ蠖募粥閭ｽ
|
||
|
||
#### Week 2: AI蟷ｳ蜿ｰAPI遶ｯ轤ｹ
|
||
|
||
**莉ｻ蜉｡貂<EFBDA1>黒**<EFBFBD>?
|
||
- [ ] 蛻帛ｻｺredcap_schema謨ｰ謐ｮ蠎鉄chema
|
||
- [ ] 螳樒鴫Prisma讓｡蝙具ｼ<E585B7>edcapProject遲?荳ｪ陦ｨ<E999A6>?
|
||
- [ ] 蠑蜿糎ebhookController謗･謾ｶ謨ｰ謐ｮ
|
||
- [ ] 螳樒鴫謨ｰ謐ｮ霓ｬ謐｢譛榊苅DataTransformService
|
||
- [ ] 蠑蜿鷹｡ｹ逶ｮ邂｡逅<EFBDA1>PI<50><49>RUD<55>?
|
||
- [ ] 豬玖ｯ包ｼ啌EDCap謗ｨ騾≫<E9A8BE>AI蟷ｳ蜿ｰ謗･謾ｶ竊貞ｭ伜<EFBDAD>?
|
||
|
||
**莠､莉倡<E88E89>?*<2A>?
|
||
- `/api/v1/redcap/*` API遶ｯ轤ｹ
|
||
- PostgreSQL redcap_schema蛻帛ｻｺ
|
||
- Postman豬玖ｯ暮寔蜷<E5AF94>
|
||
|
||
---
|
||
|
||
### Phase 2: 謨ｰ謐ｮ蜷梧ｭ･荳取丐蟆<E4B890>ｼ<EFBFBD>eek 3-4<>俄ｭ<E4BF84> 莨伜<E88EA8>郤ｧP1
|
||
|
||
**逶ｮ譬<EFBDAE>**<EFBFBD>壼ｮ樒鴫蜿悟髄謨ｰ謐ｮ蜷梧ｭ･蜥悟ｭ玲ｮｵ譎ｺ閭ｽ譏<EFBFBD>蟆<EFBFBD>
|
||
|
||
#### Week 3: 蟄玲ｮｵ譏<EFBDB5>蟆<EFBFBD>ｳｻ扈<EFBDBB>
|
||
|
||
**莉ｻ蜉｡貂<EFBDA1>黒**<EFBFBD>?
|
||
- [ ] 蠑蜿大ｭ玲ｮｵ譏<EFBDB5>蟆<EFBFBD>ｮ｡逅<EFBDA1>I<EFBFBD>亥燕遶ｯReact<63>?
|
||
- [ ] 螳樒鴫REDCap蜈<70>焚謐ｮ闔ｷ蜿泡PI
|
||
- [ ] 蠑蜿大ｭ玲ｮｵ譏<EFBDB5>蟆<EFBFBD><E89F86>鄂ｮ逡碁<E980A1>?
|
||
- [ ] 螳樒鴫譏<E9B4AB>蟆<EFBFBD>ｧ<EFBFBD><EFBDA7>蠑墓梼<E5A293><E6A2BC>ataMapper<65>?
|
||
- [ ] 謾ｯ謖∝､肴揩霓ｬ謐｢<E8AC90>亥ｦゑｼ壼黒菴崎ｽｬ謐｢縲∫ｼ也<EFBDBC>∵丐蟆<E4B890>ｼ<EFBFBD>
|
||
- [ ] 豬玖ｯ包ｼ壽丐蟆<E4B890><E89F86>鄂ｮ竊呈焚謐ｮ霓ｬ謐｢鬪瑚ｯ<E7919A>
|
||
|
||
**莠､莉倡<E88E89>?*<2A>?
|
||
- 蟄玲ｮｵ譏<EFBDB5>蟆ФI鬘ｵ髱｢
|
||
- 譏<>蟆<EFBFBD>ｧ<EFBFBD><EFBDA7>蠑墓梼
|
||
- 驟咲ｽｮ譁<EFBDAE>｡｣
|
||
|
||
#### Week 4: 蜿悟髄蜷梧ｭ･
|
||
|
||
**莉ｻ蜉｡貂<EFBDA1>黒**<EFBFBD>?
|
||
- [ ] 螳樒鴫謇ｹ驥乗焚謐ｮ蟇ｼ蜈･<E89C88><EFBDA5>EDCap 竊?AI<41>?
|
||
- [ ] 螳樒鴫蛻<E9B4AB>梵扈捺棡蝗槫<E89D97><E6A7AB><EFBFBD>I 竊?REDCap<61>?
|
||
- [ ] 蠑蜿舛ron螳壽慮蜷梧ｭ･莉ｻ蜉｡
|
||
- [ ] 螳樒鴫蜷梧ｭ･迥ｶ諤∫尅謗ｧ逡碁<E980A1>?
|
||
- [ ] 髞呵ｯｯ螟<EFBDAF>炊荳朱㍾隸墓惻蛻?
|
||
- [ ] 豬玖ｯ包ｼ壼ｮ梧紛蜷梧ｭ･豬∫ｨ?
|
||
|
||
**莠､莉倡<E88E89>?*<2A>?
|
||
- 蜿悟髄蜷梧ｭ･蜉溯<E89C89>
|
||
- 蜷梧ｭ･逶第而Dashboard
|
||
- 髞呵ｯｯ螟<EFBDAF>炊譛ｺ蛻ｶ
|
||
|
||
---
|
||
|
||
### Phase 3: AI蜉溯<E89C89>髮<EFBFBD><E9ABAE><EFBFBD><EFBFBD>eek 5-6<>解沁?莨伜<E88EA8>郤ｧP1
|
||
|
||
**逶ｮ譬<EFBDAE>**<EFBFBD>夐寔謌織C縲ヾSA縲、IA遲陰I讓｡蝮<EFBFBD>
|
||
|
||
#### Week 5: DC讓｡蝮鈴寔謌<E5AF94>
|
||
|
||
**莉ｻ蜉｡貂<EFBDA1>黒**<EFBFBD>?
|
||
- [ ] REDCap謨ｰ謐ｮ竊奪C讓｡蝮苓<E89DAE>蜉ｨ貂<EFBDA8>ｴ<EFBFBD>
|
||
- [ ] 貂<>ｴ礼ｻ捺棡竊坦EDCap蝗槫<E89D97>
|
||
- [ ] 蝨ｨREDCap荳ｭ螻慕､ｺ貂<EFBDBA>ｴ玲冠蜻?
|
||
- [ ] 謾ｯ謖∵焔蜉ｨ隗ｦ蜿第ｸ<E7ACAC>ｴ<EFBFBD>
|
||
- [ ] 豬玖ｯ包ｼ壼ｽ募<EFBDBD>竊呈ｸ<E59188>ｴ冷<EFBDB4>譟･逵狗ｻ捺<EFBDBB>?
|
||
|
||
**莠､莉倡<E88E89>?*<2A>?
|
||
- DC髮<43><E9ABAE>API
|
||
- REDCap貂<70>ｴ玲冠蜻企｡ｵ髱｢
|
||
|
||
#### Week 6: SSA讓｡蝮鈴寔謌<E5AF94>
|
||
|
||
**莉ｻ蜉｡貂<EFBDA1>黒**<EFBFBD>?
|
||
- [ ] REDCap謨ｰ謐ｮ竊担SA讓｡蝮苓<E89DAE>蜉ｨ蛻<EFBDA8>梵
|
||
- [ ] 謾ｯ謖∽ｸ牙､ｧ蛻<EFBDA7>梵霍ｯ蠕<EFBDAF>ｼ磯弌蛻?鬚<>ｵ<EFBFBD>/RCT<43>?
|
||
- [ ] 蝨ｨREDCap荳ｭ蠏悟<E8A08F>扈溯ｮ｡謚･蜻?
|
||
- [ ] 蜿ｯ隗<EFBDAF>喧蝗ｾ陦ｨ螻慕､?
|
||
- [ ] 豬玖ｯ包ｼ壽焚謐ｮ蠖募<E8A096>竊定<E7AB8A>蜉ｨ蛻<EFBDA8>梵竊呈冠蜻顔函謌?
|
||
|
||
**莠､莉倡<E88E89>?*<2A>?
|
||
- SSA髮<41><E9ABAE>API
|
||
- 扈溯ｮ｡謚･蜻雁ｵ悟<EFBDB5>鬘ｵ髱｢
|
||
|
||
---
|
||
|
||
### Phase 4: 鬮倡ｺｧ蜉溯<E89C89><E6BAAF><EFBFBD>eek 7-8<>解沍?莨伜<E88EA8>郤ｧP2
|
||
|
||
**逶ｮ譬<EFBDAE>**<EFBFBD>哂I霎<EFBFBD>勧蠖募<EFBFBD>縲∵匱閭ｽ雍ｨ謗ｧ遲牙｢槫ｼ蜉溯<EFBFBD>?
|
||
|
||
#### Week 7: AI霎<49>勧蠖募<E8A096>
|
||
|
||
**莉ｻ蜉｡貂<EFBDA1>黒**<EFBFBD>?
|
||
- [ ] 蠑蜿第匱閭ｽ閾ｪ蜉ｨ螳梧<E89EB3><E6A2A7>亥渕莠主紙蜿ｲ謨ｰ謐ｮ<E8AC90>?
|
||
- [ ] 蠑ょｸｸ蛟ｼ鬚<EFBDBC>ｭｦ<EFBDAD>亥ｮ樊慮AI蛻､譁ｭ<E8AD81>?
|
||
- [ ] 蟄玲ｮｵ蜈ｳ閨疲耳闕撰ｼ<E692B0>I鬚<49>ｵ具ｼ?
|
||
- [ ] 蠖募<E8A096>謨育紫謠仙合扈溯ｮ｡
|
||
- [ ] 豬玖ｯ包ｼ壼ｽ募<EFBDBD>菴馴ｪ御ｼ伜喧鬪瑚ｯ?
|
||
|
||
**莠､莉倡<E88E89>?*<2A>?
|
||
- AI霎<49>勧蠖募<E8A096>JS謠剃ｻｶ
|
||
- 譎ｺ閭ｽ雍ｨ謗ｧ隗<EFBDA7><E99A97>蠑墓梼
|
||
|
||
#### Week 8: 扈ｼ蜷域ｵ玖ｯ穂ｸ惹ｼ伜<EFBDBC>?
|
||
|
||
**莉ｻ蜉｡貂<EFBDA1>黒**<EFBFBD>?
|
||
- [ ] 諤ｧ閭ｽ豬玖ｯ包ｼ?00荳<30>擅隶ｰ蠖募酔豁･<E8B181>?
|
||
- [ ] 螳牙<E89EB3>豬玖ｯ包ｼ<E58C85>PI隶､隸√∵焚謐ｮ蜉<EFBDAE>蟇<EFBFBD>ｼ<EFBFBD>
|
||
- [ ] 逕ｨ謌ｷ鬪梧噺豬玖ｯ包ｼ<E58C85>AT<41>?
|
||
- [ ] 譁<>｡｣郛門<E9839B><E99680>育畑謌ｷ謇句<E8AC87>?蠑蜿第枚譯｣<E8ADAF><EFBDA3>
|
||
- [ ] 驛ｨ鄂ｲ蛻ｰ逕滉ｺｧ邇ｯ蠅?
|
||
|
||
**莠､莉倡<E88E89>?*<2A>?
|
||
- 諤ｧ閭ｽ豬玖ｯ墓冠蜻<E586A0>
|
||
- 螳梧紛譁<E7B49B>｡｣
|
||
- 逕滉ｺｧ邇ｯ蠅<EFBDAF>Κ鄂ｲ
|
||
|
||
---
|
||
|
||
## <20>白 螳牙<E89EB3>諤ｧ隶ｾ隶?
|
||
|
||
### API隶､隸∵惻蛻ｶ
|
||
|
||
```typescript
|
||
// 菴ｿ逕ｨHMAC-SHA256遲ｾ蜷埼ｪ瑚ｯ<E7919A>
|
||
|
||
// REDCap External Module蜿鷹∬ｯｷ豎よ慮
|
||
const timestamp = Date.now();
|
||
const signature = crypto
|
||
.createHmac('sha256', apiSecret)
|
||
.update(`${timestamp}${JSON.stringify(payload)}`)
|
||
.digest('hex');
|
||
|
||
// Headers:
|
||
{
|
||
'X-API-Key': apiKey,
|
||
'X-Timestamp': timestamp,
|
||
'X-Signature': signature
|
||
}
|
||
|
||
// AI蟷ｳ蜿ｰ鬪瑚ｯ<E7919A>
|
||
function verifySignature(req) {
|
||
const { timestamp, signature } = req.headers;
|
||
const expectedSignature = crypto
|
||
.createHmac('sha256', apiSecret)
|
||
.update(`${timestamp}${JSON.stringify(req.body)}`)
|
||
.digest('hex');
|
||
|
||
return signature === expectedSignature;
|
||
}
|
||
```
|
||
|
||
### 謨ｰ謐ｮ蜉<EFBDAE>蟇<EFBFBD>
|
||
|
||
- REDCap API Token<65>壻ｽｿ逕ｨAES-256蜉<36>蟇<EFBFBD>ｭ伜お
|
||
- 莨<>霎灘刈蟇<E58888>ｼ壼ｼｺ蛻ｶHTTPS
|
||
- 謨乗─蟄玲ｮｵ<EFBDAE>壽髪謖∝ｭ玲ｮｵ郤ｧ蜉<EFBDA7>蟇<EFBFBD>ｼ<EFBFBD>HI謨ｰ謐ｮ<E8AC90>?
|
||
|
||
### 譚<>剞謗ｧ蛻ｶ
|
||
|
||
```typescript
|
||
// REDCap逕ｨ謌ｷ譚<EFBDB7>剞蜷梧ｭ･蛻ｰAI蟷ｳ蜿ｰ
|
||
interface UserPermission {
|
||
userId: string;
|
||
redcapRights: {
|
||
data_entry: boolean;
|
||
data_export: boolean;
|
||
data_analysis: boolean;
|
||
};
|
||
aiPlatformRights: {
|
||
dc_access: boolean;
|
||
ssa_access: boolean;
|
||
asl_access: boolean;
|
||
};
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## <20>答 謚譛ｯ譬域ｻ扈<EFBDBB>
|
||
|
||
| 螻らｺｧ | REDCap萓?| AI蟷ｳ蜿ｰ萓?|
|
||
|------|---------|---------|
|
||
| **郛也ｨ玖ｯｭ險** | PHP 7.4+ | TypeScript/Node.js 22 |
|
||
| **譯<>楔** | REDCap EM Framework v16 | Fastify v4 |
|
||
| **謨ｰ謐ｮ蠎?* | MySQL 5.7+ | PostgreSQL 15 |
|
||
| **謨ｰ謐ｮ讓｡蝙<EFBDA1>** | EAV讓｡蝙<EFBDA1> | 蜈ｳ邉ｻ蝙?JSONB |
|
||
| **蜑咲ｫｯ** | jQuery + Bootstrap 5 | React 19 + Ant Design 6 |
|
||
| **API** | REDCap RESTful API | Fastify RESTful API |
|
||
| **隶､隸<EFBDA4>** | API Token | HMAC-SHA256遲ｾ蜷<EFBDBE> |
|
||
| **譌･蠢<EFBDA5>** | REDCap譌･蠢苓｡?| Winston + SLS |
|
||
| **莉ｻ蜉｡髦溷<E9ABA6>** | REDCap Cron | pg-boss (Postgres-Only) |
|
||
|
||
---
|
||
|
||
## <20>統 荳倶ｸ豁･陦悟<E999A6>?
|
||
|
||
### 遶句叉陦悟勘<E6829F>域悽蜻ｨ<E89CBB><EFBDA8>
|
||
|
||
1. **遑ｮ隶､髴豎?*<2A>?
|
||
- [ ] 遑ｮ隶､莨伜<E88EA8>郤ｧ<E983A4><EFBDA7>C莨伜<E88EA8><E4BC9C>溯ｿ俶弍SSA莨伜<E88EA8><E4BC9C>滂ｼ<E6BB82>
|
||
- [ ] 遑ｮ隶､驛ｨ鄂ｲ蠖｢諤<EFBDA2>ｼ井ｺ醍ｫｯSaaS<61>溯ｿ俶弍遘∵怏蛹夜Κ鄂ｲ<E98482>滂ｼ<E6BB82>
|
||
- [ ] 遑ｮ隶､REDCap譛榊苅蝎ｨ菫｡諱ｯ<E8ABB1><EFBDAF>RL縲∫沿譛ｬ縲∬ｮｿ髣ｮ譚<EFBDAE>剞<EFBFBD><E5899E>
|
||
|
||
2. **邇ｯ蠅<EFBDAF>㊥螟<E38AA5>**<EFBFBD>?
|
||
- [ ] 謳ｭ蟒ｺREDCap豬玖ｯ慕識蠅<E8AD98>ｼ井ｽｿ逕ｨDocker<65>?
|
||
- [ ] 蛻帛ｻｺ豬玖ｯ暮｡ｹ逶ｮ蜥梧ｵ玖ｯ墓焚謐?
|
||
- [ ] 驟咲ｽｮAI蟷ｳ蜿ｰ豬玖ｯ柊PI
|
||
|
||
3. **蜷ｯ蜉ｨ蠑蜿?*<2A>?
|
||
- [ ] 蛻帛ｻｺExternal Module逶ｮ蠖<EFBDAE>
|
||
- [ ] 蛻晏ｧ句喧Git莉灘ｺ<E78198>
|
||
- [ ] 郛門<E9839B>config.json
|
||
|
||
### 謚譛ｯ鬚<EFBDAF><E9AC9A>?
|
||
|
||
1. **REDCap API豺ｱ蜈･豬玖ｯ<E78E96>**
|
||
2. **External Module Hook譛ｺ蛻ｶ鬪瑚ｯ<E7919A>**
|
||
3. **螟ｧ謨ｰ謐ｮ驥丞酔豁･諤ｧ閭ｽ豬玖ｯ<E78E96>**
|
||
4. **遘ｻ蜉ｨ遶ｯ<E981B6><EFBDAF>EDCap Mobile App<70>蛾寔謌仙庄陦梧?*
|
||
|
||
---
|
||
|
||
## <20>識 謌仙粥譬<E7B2A5>㊥
|
||
|
||
**MVP迚域悽<E59F9F><E682BD>hase 1-2螳梧<E89EB3><E6A2A7>?*<2A>?
|
||
- 笨?REDCap謨ｰ謐ｮ閭ｽ謗ｨ騾∝芦AI蟷ｳ蜿ｰ
|
||
- 笨?AI蟷ｳ蜿ｰ閭ｽ謗･謾ｶ蟷ｶ蟄伜お謨ｰ謐ｮ
|
||
- 笨?蟄玲ｮｵ譏<EFBDB5>蟆<EFBFBD><E89F86>鄂ｮ蜉溯<E89C89>蜿ｯ逕ｨ
|
||
- 笨?蝓ｺ遑蜷梧ｭ･逶第而蜿ｯ逕ｨ
|
||
|
||
**譬<>㊥迚域悽<E59F9F><E682BD>hase 3螳梧<E89EB3><E6A2A7>?*<2A>?
|
||
- 笨?DC讓｡蝮鈴寔謌仙ｮ梧<EFBDAE><E6A2A7>郁<EFBFBD>蜉ｨ貂<EFBDA8>ｴ暦ｼ<E69AA6>
|
||
- 笨?SSA讓｡蝮鈴寔謌仙ｮ梧<EFBDAE><E6A2A7>郁<EFBFBD>蜉ｨ蛻<EFBDA8>梵<EFBFBD><E6A2B5>
|
||
- 笨?蛻<>梵扈捺棡蜿ｯ蝨ｨREDCap荳ｭ譟･逵?
|
||
- 笨?逕ｨ謌ｷ菴馴ｪ梧ｵ∫腐
|
||
|
||
**莨∽ｸ夂沿譛ｬ<E8AD9B><EFBDAC>hase 4螳梧<E89EB3><E6A2A7>?*<2A>?
|
||
- 笨?AI霎<49>勧蠖募<E8A096>謠仙合謨育紫50%+
|
||
- 笨?譎ｺ閭ｽ雍ｨ謗ｧ蜃丞ｰ鷹漠隸ｯ邇?0%+
|
||
- 笨?謾ｯ謖<EFBDAF>100荳?隶ｰ蠖募酔豁･
|
||
- 笨?螳牙<E89EB3>蜷郁ｧ<E98381>ｼ育ｬｦ蜷<EFBDA6>DA 21 CFR Part 11<31>?
|
||
|
||
---
|
||
|
||
**譁<>｡｣迚域悽**<EFBFBD>嘛1.0
|
||
**譛蜷取峩譁?*<2A>?025-12-30
|
||
**荳区ｬ｡譖ｴ譁ｰ**<EFBFBD>啀hase 1蜷ｯ蜉ｨ蜷取峩譁ｰ蠑蜿題ｿ帛ｺ?
|
||
|
||
---
|
||
|
||
**<EFBFBD>噫 蜃<>､<EFBFBD>･ｽ蠑蟋倶ｺ<E580B6>雛<EFBFBD>溯ｮｩ謌台ｻｬ蠑蜷ｯREDCap荳拶I逧<49>檮蜷井ｹ区羅<E58CBA><E7BE85>**
|
||
|
||
|
||
|
||
|
||
|