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

4.7 KiB
Raw Blame History

IIT Manager Agent 螟夂ォッ莠、莠呈オ∫ィ倶ク取揀髯占ョセ隶?(V1.0)

*1. 譬ク蠢<EFBDB8>ァ定牡螳壻ケ我ク守サ育ォッ遏ゥ髦?

邉サ扈滄€夊ソ<EFBFBD>€懷渕遑€隗定牡 + 謇ゥ螻墓揀髯絶€晄ィ。蠑擾シ梧髪謖∝黒荳ュ蠢<EFBDAD>ク主、壻クュ蠢<EFBDAD>。ケ逶ョ逧<EFBDAE><E980A7>豢サ驟咲スョ縲?

隗定牡莉」遐<EFBFBD> 隗定牡蜷咲ァー 譬ク蠢<EFBFBD>雍」 荳サ隕∫サ育ォッ 譬ク蠢<EFBFBD>揀髯<EFBFBD>
SYS_ADMIN 邉サ扈溽ョ。逅<EFBFBD><EFBFBD>? 蟷ウ蜿ー蛻晏ァ句喧縲∝、夂ァ滓姐邂。逅<EFBFBD>€ify 遏・隸<EFBDA5>コ鍋サエ謚? PC 遶?(Admin Portal) 蜈ィ螻€驟咲スョ縲∬オ<EFBFBD>コ仙<EFBFBD>驟?
PROJECT_PI 鬘ケ逶ョ雍溯エ」莠?(PI) 鬘ケ逶ョ霑帛コヲ逶第而縲<EFBFBD>㍾螟ァ蛛冗ヲサ蜀ウ遲悶€∵匱閭ス謚・陦ィ譟・逵? 蠕ョ菫。遶?(莨∝セョ騾夂衍+蟆冗ィ句コ? 蠖ア蟄千憾諤∵怙扈亥ョ。謇ケ縲∝ッシ蜃コ謚・陦?
CRC_OPERATOR 蜊剰ー<EFBFBD><EFBFBD>?(CRC) 謨ー謐ョ蠖募<EFBFBD>縲、I 蟒コ隶ョ螟肴<E89E9F>ク縲∵ぅ閠<E38185>囂隶ソ謇ァ陦? REDCap (蠖募<E8A096>) + PC Workbench 雍ィ逍大、<EFBFBD>炊縲∵焚謐ョ驥<EFBFBD>寔縲∵ぅ閠<EFBFBD>コ貞<EFBFBD>?
SUBJECT_PATIENT 謔」閠?(蜿苓ッ戊€? 謗・謾カ謠宣<EFBFBD>縲∝暢隸「遲皮桝縲、E/髫剰ョソ荳頑冠 荳ェ莠コ蠕ョ菫。 (H5/蟆冗ィ句コ? 莉サ蜉。蜿埼ヲ医€<EFBFBD>琉遲泌暢隸?
SUB_I / CO_PI 蟄蝉クュ蠢<EFBFBD>エ溯エ」莠コ <EFBFBD>クュ蠢<EFBFBD>焚謐ョ譟・逵九€∵悽荳ュ蠢<EFBFBD>オ∫ィ句ョ。謇ケ 蠕ョ菫。遶? <EFBFBD>剞譛ャ荳ュ蠢<EFBFBD>噪謨ー謐ョ譚<EFBFBD>

2. 霍ィ扈育ォッ譬ク蠢<EFBDB8>コ、莠呈オ∫ィ?(User Journeys)

2.1 譎コ閭ス雍ィ謗ァ荳主スア蟄仙<E89F84>遲匁オ<E58C81> (譬ク蠢<EFBDB8>溜邇ッ)

隸・豬∫ィ倶ス鍋鴫莠<EFBFBD>€彝EDCap 蠖募<E8A096> -> AI 蜿醍鴫 -> Workbench 螟肴<E89E9F>ク -> 蝗槫<E89D97> REDCap窶晉噪騾サ霎代€?

  1. 謨ー謐ョ莠ァ逕<EFBFBD><EFBFBD>咾RC 蝨?REDCap 蜴溽函逡碁擇謠蝉コ、蜿苓ッ戊€?V1 隶ソ隗<EFBDBF>焚謐ョ縲?
  2. **逶大成荳取耳逅?*<2A>哢ode.js 謗・謾カ Webhook<6F>碁ゥア蜉?QC Agent<>畑 Dify RAG 譽€邏?Protocol<6F>悟書邇ー騾サ霎醍泝逶セ縲?
  3. 蠖ア蟄千函謌<EFBFBD><EFBFBD>夂ウサ扈溷惠 Postgres (iit_schema) 荳ュ逕滓<E98095>€譚。迥カ諤∽クコ PROPOSED 逧<>スア蟄占ョー蠖輔€?
  4. 蜊ウ譌カ謠宣<EFBFBD><EFBFBD>?
    • **PC 遶?*<2A>咾RC 逧?Workbench 莉サ蜉。蜊。迚<EFBDA1>ョ樊慮譖エ譁ー縲?
    • **蠕ョ菫。遶?*<2A>夊凶荳コ荳・驥崎ソ晁レ<E69981><EFBFBD>蜉ィ扈?PI/CRC 謗ィ騾∽シ∝セョ騾夂衍縲?
  5. 螟肴<EFBFBD>ク蜀ウ遲<EFBFBD><EFBFBD>咾RC 逋サ蠖<EFBDBB> PC Workbench<EFBFBD>梧衍逵玖ッ∵紺體セ蟇ケ豈斐€?
  6. 豁」蠑乗鴬陦<EFBFBD><EFBFBD>咾RC 轤ケ蜃サ窶懃。ョ隶、蟷カ譖エ譁ー窶晢シ檎ウサ扈溯ー<E6BAAF>畑 REDCap API 蟆<>ソョ豁」蛟シ謌冶エィ逍醍憾諤∝<E8ABA4>蝗?REDCap<EFBFBD>悟スア蟄占ョー蠖慕憾諤∬スャ荳?EXECUTED縲?

2.2 莉サ蜉。鬩ア蜉ィ荳取ぅ閠<E38185>コ貞勘豬<E58B98>

隸・豬∫ィ倶ス鍋鴫莠<EFBFBD>€應ササ蜉。蠑墓<EFBFBD>?-> 莨∝セョ隗ヲ霎セ -> AI 遏・隸<EFBDA5>コ灘屓螟坂€晉噪騾サ霎代€?

  1. 莉サ蜉。隗ヲ蜿<EFBFBD><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. 莠コ蟾・莉句<EFBFBD><EFBFBD>?
    • 闍・荳コ邂€蜊慕ァ第勸<EFBFBD>窟gent 逶エ謗・蝗槫、阪€?
    • 闍・豸牙所逕ィ闕ッ謖<EFBFBD>ッシ<EFBFBD>梧署驢<EFBFBD> CRC 蝨ィ莨∝セョ萓ァ霎ケ譬冗。ョ隶、隸・闕臥ィソ蜷主<E89CB7>蜿鷹€€?

*2.3 PI 螳剰ァらョ。逅<EFBDA1>オ?

  1. 蜻ィ譛滓ア<EFBFBD><EFBFBD>?Reporting Agent* 豈丞捉逕滓<E98095>扈溯ョ。謚・陦ィ縲?
  2. 蜩∫煙蛹門ア慕、?*<2A>啀I 謾カ蛻ー莨∝セョ騾夂衍<E5A482>檎せ蜃サ霍ウ霓ャ閾ウ蟆冗ィ句コ?*縲?
  3. 螟夂ァ滓姐騾る<EFBFBD><EFBFBD>壼ー冗ィ句コ乗<EFBFBD>ケ謐ョ鬘ケ逶ョ ID 閾ェ蜉ィ蜉<EFBDA8>霓ス [蛹怜現荳蛾劼] 遲牙刀迚悟<E8BF9A><EFBFBD><EFBFBD> Logo縲?
  4. 遘サ蜉ィ蜀ウ遲<EFBFBD><EFBFBD>啀I 蝨ィ蟆冗ィ句コ丞<EFBDBA>蟇ケ CRC 謠蝉コ、逧<EFBDA4>桝髫セ髣ョ鬚倩ソ幄。瑚ソ懃ィ区音遉コ縲?

3. 扈育ォッ蜉溯<E89C89>霎ケ逡悟<E980A1><EFBFBD> (Function Boundary)

蜉溯<EFBFBD>讓。蝮<EFBFBD> PC 邂。逅<EFBDA1>遭髣ィ謌? PC Agent Workbench 蠕ョ菫。蟆冗ィ句コ?H5 莨∽ク壼セョ菫。騾夂衍
*鬘ケ逶ョ蛻晏ァ句<EFBFBD>? 100% (荳贋シ<E8B48B>譁ケ譯<EFBDB9>) 0% 0% 0%
蟄玲ョオ譏<EFBFBD><EFBFBD><EFBFBD>鄂ョ 100% 0% 0% 0%
謨ー謐ョ雍ィ謗ァ螳。譬ク 0% 100% (豺ア蠎ヲ豈泌ッケ) 20% (邏ァ諤・遑ョ隶? 0% (莉<><E88E89>蜿?
譎コ閭ス驥<EFBFBD>寔(OCR) 0% 100% 0% 0%
霑帛コヲ/鬟朱勦謚・陦ィ 20% 50% 100% (邊セ鄒主庄隗<E5BA84><E99A97>? 10% (蜊。迚<EFBDA1>遭隕<E981AD>)
*謔」閠<EFBFBD>イ滄€夊ョー蠖? 0% 100% (蠖呈。」) 0% 100% (螳樊慮莠、莠<EFBDA4>)

4. 譚<>剞荳主ョ牙<EFBDAE>讓。蝙?(Access Control)

4.1 RBAC 譚<>剞隶セ隶。

邉サ扈滄㊦逕ィ窶懷粥閭ス譚<EFBFBD><EFBFBD>?+ 謨ー謐ョ闌<EFBDAE>峩窶晏曙驥肴<E9A9A5>。鬪鯉シ<E9AF89>

  • 蜉溯<EFBFBD><EFBFBD>剞 (Permission)<EFBFBD><EFBFBD>螳夊<EFBFBD>蜷ヲ轤ケ蜃サ窶懃。ョ隶、蝗槫<EFBFBD>窶昴€€懷ッシ蜃コ謚・陦ィ窶昴€?
  • 謨ー謐ョ闌<EFBFBD>峩 (Scope)<EFBFBD>?
    • GLOBAL<EFBFBD>壼庄逵区園譛我クュ蠢<EFBFBD>焚謐ョ<EFBFBD>磯。ケ逶ョ PI<50>€?
    • SITE_ONLY<EFBFBD>壻サ<EFBFBD>剞譛ャ荳ュ蠢<EFBFBD>シ亥ュ蝉クュ蠢<EFBFBD> PI/CRC<52>€?
    • PATIENT_ONLY<EFBFBD>壻サ<EFBFBD>剞譛ャ莠コ<EFBFBD>亥女隸戊€<EFBFBD>シ峨€?

4.2 蠑よ桷邉サ扈溯コォ莉ス譏<EFBDBD><EFBFBD> (Auth Bridge)

  • REDCap Token 謇倡ョ。<EFBFBD>壽ッ丈ク?CRC/PI 逧<>エヲ謌キ荳句刈蟇<E58888>ュ伜お蜈?REDCap API Token縲?
  • 莨∝セョ OpenID 扈大ョ<E5A4A7><EFBFBD>壼惠 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>揀縲? 迚域悽隸エ譏<EFBFBD><EFBFBD>啖1.0 蝓コ遑€迚?| **迥カ諤?*<2A>壼セ<E5A3BC><EFBFBD>ョ。