Files
AIclinicalresearch/docs/03-业务模块/IIT Manager Agent/02-技术设计/IIT Manager Agent 多端交互流程与权限设计 (V1.0).md
HaHafeng 1b53ab9d52 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

76 lines
4.7 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# **IIT Manager Agent 螟夂ォッ莠、莠呈オ∫ィ倶ク取揀髯占ョセ隶?(V1.0)**
## **1\. 譬ク蠢<EFBDB8>ァ定牡螳壻ケ我ク守サ育ォッ遏ゥ髦?*
邉サ扈滄€夊ソ<EFBFBD>€懷渕遑€隗定牡 \+ 謇ゥ螻墓揀髯絶€晄ィ。蠑擾シ梧髪謖∝黒荳ュ蠢<EFBDAD>ク主、壻クュ蠢<EFBDAD>。ケ逶ョ逧<EFBDAE><E980A7>豢サ驟咲スョ縲?
| 隗定牡莉」遐<EFBDA3> | 隗定牡蜷咲ァー | 譬ク蠢<EFBDB8>雍」 | 荳サ隕∫サ育ォッ | 譬ク蠢<EFBDB8>揀髯<E68F80> |
| :---- | :---- | :---- | :---- | :---- |
| **SYS\_ADMIN** | 邉サ扈溽ョ。逅<EFBDA1><E98085>?| 蟷ウ蜿ー蛻晏ァ句喧縲∝、夂ァ滓姐邂。逅<EFBDA1>€ify 遏・隸<EFBDA5>コ鍋サエ謚?| PC 遶?(Admin Portal) | 蜈ィ螻€驟咲スョ縲∬オ<E288AC>コ仙<EFBDBA>驟?|
| **PROJECT\_PI** | 鬘ケ逶ョ雍溯エ」莠?(PI) | 鬘ケ逶ョ霑帛コヲ逶第而縲<E8808C>㍾螟ァ蛛冗ヲサ蜀ウ遲悶€∵匱閭ス謚・陦ィ譟・逵?| 蠕ョ菫。遶?(莨∝セョ騾夂衍+蟆冗ィ句コ? | 蠖ア蟄千憾諤∵怙扈亥ョ。謇ケ縲∝ッシ蜃コ謚・陦?|
| **CRC\_OPERATOR** | 蜊剰ー<E589B0><EFBDB0>?(CRC) | 謨ー謐ョ蠖募<E8A096>縲、I 蟒コ隶ョ螟肴<E89E9F>ク縲∵ぅ閠<E38185>囂隶ソ謇ァ陦?| REDCap (蠖募<E8A096>) \+ PC Workbench | 雍ィ逍大、<E5A4A7>炊縲∵焚謐ョ驥<EFBDAE>寔縲∵ぅ閠<E38185>コ貞<EFBDBA>?|
| **SUBJECT\_PATIENT** | 謔」閠?(蜿苓ッ戊€? | 謗・謾カ謠宣<E8ACA0>縲∝暢隸「遲皮桝縲、E/髫剰ョソ荳頑冠 | 荳ェ莠コ蠕ョ菫。 (H5/蟆冗ィ句コ? | 莉サ蜉。蜿埼ヲ医€<E58CBB>琉遲泌暢隸?|
| **SUB\_I / CO\_PI** | 蟄蝉クュ蠢<EFBDAD>エ溯エ」莠コ | 蛻<>クュ蠢<EFBDAD>焚謐ョ譟・逵九€∵悽荳ュ蠢<EFBDAD>オ∫ィ句ョ。謇ケ | 蠕ョ菫。遶?| 莉<>剞譛ャ荳ュ蠢<EFBDAD>噪謨ー謐ョ譚<EFBDAE>剞 |
## **2\. 霍ィ扈育ォッ譬ク蠢<EFBDB8>コ、莠呈オ∫ィ?(User Journeys)**
### **2.1 譎コ閭ス雍ィ謗ァ荳主スア蟄仙<E89F84>遲匁オ<E58C81> (譬ク蠢<EFBDB8>溜邇ッ)**
隸・豬∫ィ倶ス鍋鴫莠<EFBFBD>€彝EDCap 蠖募<E8A096> \-\> AI 蜿醍鴫 \-\> Workbench 螟肴<E89E9F>ク \-\> 蝗槫<E89D97> REDCap窶晉噪騾サ霎代€?
1. **謨ー謐ョ莠ァ逕<EFBDA7>**<EFBFBD>咾RC 蝨?**REDCap 蜴溽函逡碁擇**謠蝉コ、蜿苓ッ戊€?V1 隶ソ隗<EFBDBF>焚謐ョ縲?
2. **逶大成荳取耳逅?*<2A>哢ode.js 謗・謾カ Webhook<6F>碁ゥア蜉?**QC Agent**<>畑 Dify RAG 譽€邏?Protocol<6F>悟書邇ー騾サ霎醍泝逶セ縲?
3. **蠖ア蟄千函謌<E587BD>**<EFBFBD>夂ウサ扈溷惠 **Postgres (iit\_schema)** 荳ュ逕滓<E98095>€譚。迥カ諤∽クコ PROPOSED 逧<>スア蟄占ョー蠖輔€?
4. **蜊ウ譌カ謠宣<E8ACA0>**<EFBFBD>?
* **PC 遶?*<2A>咾RC 逧?Workbench 莉サ蜉。蜊。迚<EFBDA1>ョ樊慮譖エ譁ー縲?
* **蠕ョ菫。遶?*<2A>夊凶荳コ荳・驥崎ソ晁レ<E69981><EFBFBD>蜉ィ扈?PI/CRC 謗ィ騾∽シ∝セョ騾夂衍縲?
5. **螟肴<E89E9F>ク蜀ウ遲<EFBDB3>**<EFBFBD>咾RC 逋サ蠖<EFBDBB> **PC Workbench**<EFBFBD>梧衍逵玖ッ∵紺體セ蟇ケ豈斐€?
6. **豁」蠑乗鴬陦<E9B4AC>**<EFBFBD>咾RC 轤ケ蜃サ窶懃。ョ隶、蟷カ譖エ譁ー窶晢シ檎ウサ扈溯ー<E6BAAF>畑 REDCap API 蟆<>ソョ豁」蛟シ謌冶エィ逍醍憾諤∝<E8ABA4>蝗?**REDCap**<2A>悟スア蟄占ョー蠖慕憾諤∬スャ荳?EXECUTED縲?
### **2.2 莉サ蜉。鬩ア蜉ィ荳取ぅ閠<E38185>コ貞勘豬<E58B98>**
隸・豬∫ィ倶ス鍋鴫莠<EFBFBD>€應ササ蜉。蠑墓<EFBFBD>?\-\> 莨∝セョ隗ヲ霎セ \-\> AI 遏・隸<EFBDA5>コ灘屓螟坂€晉噪騾サ霎代€?
1. **莉サ蜉。隗ヲ蜿<EFBDA6>**<EFBFBD>壻ササ蜉。蠑墓梼譽€豬句芦謔」閠?P001 譏取律髴€蝗櫁ョソ<EFBDAE>檎憾諤∝序荳?DUE\_SOON縲?
2. **豸域<E8B1B8>謗ィ騾?*<2A>夂ウサ扈滄€夊ソ<E5A48A>**莨∽ク壼セョ菫。 API**<EFBFBD>御サ・ CRC 霄ォ莉ス蜷第ぅ閠<E38185>セョ菫。蜿鷹€∵署驢偵€?
3. **謔」閠<EFBDA3>ソス髣?*<2A>壽ぅ閠<E38185>惠蠕ョ菫。蝗槫、搾シ壺€<C280>莉雁、ゥ髴€隕∝●闕ッ蜷暦シ溪€€?
4. **AI 螟<>**<EFBFBD>?*Counseling Agent** 蝓コ莠<EFBDBA> Dify 遏・隸<EFBDA5>コ鍋函謌仙屓遲碑拷遞ソ縲?
5. **莠コ蟾・莉句<E88E89>**<EFBFBD>?
* 闍・荳コ邂€蜊慕ァ第勸<E7ACAC>窟gent 逶エ謗・蝗槫、阪€?
* 闍・豸牙所逕ィ闕ッ謖<EFBDAF>ッシ<EFBDAF>梧署驢<E7BDB2> CRC 蝨ィ莨∝セョ萓ァ霎ケ譬冗。ョ隶、隸・闕臥ィソ蜷主<E89CB7>蜿鷹€€?
### **2.3 PI 螳剰ァらョ。逅<EFBDA1>オ?*
1. **蜻ィ譛滓ア<E6BB93>**<EFBFBD>?*Reporting Agent** 豈丞捉逕滓<E98095>扈溯ョ。謚・陦ィ縲?
2. **蜩∫煙蛹門ア慕、?*<2A>啀I 謾カ蛻ー莨∝セョ騾夂衍<E5A482>檎せ蜃サ霍ウ霓ャ閾ウ**蟆冗ィ句コ?*縲?
3. **螟夂ァ滓姐騾る<E9A8BE>**<EFBFBD>壼ー冗ィ句コ乗<EFBFBD>ケ謐ョ鬘ケ逶ョ ID 閾ェ蜉ィ蜉<EFBDA8>霓ス \[蛹怜現荳蛾劼\] 遲牙刀迚悟<E8BF9A><EFBFBD><EFBFBD> Logo縲?
4. **遘サ蜉ィ蜀ウ遲<EFBDB3>**<EFBFBD>啀I 蝨ィ蟆冗ィ句コ丞<EFBDBA>蟇ケ CRC 謠蝉コ、逧<EFBDA4>桝髫セ髣ョ鬚倩ソ幄。瑚ソ懃ィ区音遉コ縲?
## **3\. 扈育ォッ蜉溯<E89C89>霎ケ逡悟<E980A1><EFBFBD> (Function Boundary)**
| 蜉溯<E89C89>讓。蝮<EFBDA1> | PC 邂。逅<EFBDA1>遭髣ィ謌?| PC Agent Workbench | 蠕ョ菫。蟆冗ィ句コ?H5 | 莨∽ク壼セョ菫。騾夂衍 |
| :---- | :---- | :---- | :---- | :---- |
| **鬘ケ逶ョ蛻晏ァ句<EFBDA7>?* | 100% (荳贋シ<E8B48B>譁ケ譯<EFBDB9>) | 0% | 0% | 0% |
| **蟄玲ョオ譏<EFBDB5><EFBFBD><E89F86>鄂ョ** | 100% | 0% | 0% | 0% |
| **謨ー謐ョ雍ィ謗ァ螳。譬ク** | 0% | 100% (豺ア蠎ヲ豈泌ッケ) | 20% (邏ァ諤・遑ョ隶? | 0% (莉<><E88E89>蜿? |
| **譎コ閭ス驥<EFBDBD>寔(OCR)** | 0% | 100% | 0% | 0% |
| **霑帛コヲ/鬟朱勦謚・陦ィ** | 20% | 50% | 100% (邊セ鄒主庄隗<E5BA84><E99A97>? | 10% (蜊。迚<EFBDA1>遭隕<E981AD>) |
| **謔」閠<EFBDA3>イ滄€夊ョー蠖?* | 0% | 100% (蠖呈。」) | 0% | 100% (螳樊慮莠、莠<EFBDA4>) |
## **4\. 譚<>剞荳主ョ牙<EFBDAE>讓。蝙?(Access Control)**
### **4.1 RBAC 譚<>剞隶セ隶。**
邉サ扈滄㊦逕ィ窶懷粥閭ス譚<EFBFBD><EFBFBD>?\+ 謨ー謐ョ闌<EFBDAE>峩窶晏曙驥肴<E9A9A5>。鬪鯉シ<E9AF89>
* **蜉溯<E89C89><EFBFBD>剞 (Permission)**<2A><EFBFBD>螳夊<E89EB3>蜷ヲ轤ケ蜃サ窶懃。ョ隶、蝗槫<E89D97>窶昴€€懷ッシ蜃コ謚・陦ィ窶昴€?
* **謨ー謐ョ闌<EFBDAE>峩 (Scope)**<2A>?
* GLOBAL<41>壼庄逵区園譛我クュ蠢<EFBDAD>焚謐ョ<E8AC90>磯。ケ逶ョ PI<50>€?
* SITE\_ONLY<4C>壻サ<E5A3BB>剞譛ャ荳ュ蠢<EFBDAD>シ亥ュ蝉クュ蠢<EFBDAD> PI/CRC<52>€?
* PATIENT\_ONLY<4C>壻サ<E5A3BB>剞譛ャ莠コ<E88EA0>亥女隸戊€<E6888A>シ峨€?
### **4.2 蠑よ桷邉サ扈溯コォ莉ス譏<EFBDBD><EFBFBD> (Auth Bridge)**
* **REDCap Token 謇倡ョ。**<2A>壽ッ丈ク?CRC/PI 逧<>エヲ謌キ荳句刈蟇<E58888>ュ伜お蜈?REDCap API Token縲?
* **莨∝セョ OpenID 扈大ョ<E5A4A7>**<2A>壼惠 iit\_schema.user\_mapping 荳ュ蟒コ遶?SystemUserID \<-\> WeComID 逧<>丐蟆<E4B890>シ檎。ョ菫晄カ域<EFBDB6>邊セ蜃<EFBDBE>耳騾√€?
## **5\. 謇ゥ螻墓€ァ隶セ隶?(Future Roles)**
蟇ケ莠<EFBFBD> **Co-PI** 謌?**Sub-I** 遲芽ァ定牡<E5AE9A>檎ウサ扈滓髪謖∝<E8AC96>?iit\_projects.roles 陦ィ荳ュ蜉ィ諤∵キサ蜉<EFBDBB><EFBFBD>剞譬<E5899E>ュセ<EFBDAD><EFBDBE>
* can\_approve\_shadow\_state: 襍倶コ亥ョ。謇ケ譚<EFBDB9>€?
* can\_view\_audit\_trail: 襍倶コ亥ョ。隶。譟・逵区揀縲?
* can\_manage\_patients: 襍倶コ域ぅ閠<E38185>ョ。逅<EFBDA1>揀縲?
**迚域悽隸エ譏<EFBDB4>**<2A>啖1.0 蝓コ遑€迚?| **迥カ諤?*<2A>壼セ<E5A3BC><EFBFBD>ョ。