Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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%)
This commit is contained in:
HaHafeng
2026-01-14 19:15:01 +08:00
parent 3d35e9c58b
commit 1b53ab9d52
386 changed files with 52096 additions and 65238 deletions
Download Patch File Download Diff File Expand all files Collapse all files

124
docs/03-业务模块/IIT Manager Agent/00-系统设计/IIT Manager Agent V4 完整产品需求文档.md
View File

@@ -1,106 +1,90 @@
# **IIT Manager Agent V4 完整产品需求文档 (全量集成版)**
# **IIT Manager Agent V4 摰峕㟲鈭批<EFBFBD><EFBFBD><EFBFBD>瘙<EFBFBD><EFBFBD>獢?(<28>券<EFBFBD><E588B8><EFBFBD><EFBFBD><EFBFBD>?**
## **1\. 撘閗<E69298>**
### **1.1 憿寧𤌍<E5AFA7>峕艶**
在研究者发起的临床试验（IIT）中，数据质量的核心痛点在于“过程失控”。传统的 EDC 系统（如 REDCap）是静态的记录工具。IIT Manager Agent V4 旨在通过“自研逻辑编排 \+ Dify 知识库赋能”，构建一个具有主动意识、实时质控、多端协同的数字科研团队。
<EFBFBD>函<EFBFBD>蝛嗉<EFBFBD><EFBFBD><EFBFBD>韏瑞<EFBFBD>銝游<EFBFBD>霂閖<EFBFBD>嚗㇆IT嚗劐葉嚗峕㺭<EFBFBD>株捶<EFBFBD>讐<EFBFBD><EFBFBD>詨<EFBFBD><EFBFBD>𤤿<EFBFBD><EFBFBD>其<EFBFBD><EFBFBD>𡏭<EFBFBD>蝔见仃<EFBFBD>把<EFBFBD>腈<EFBFBD><EFBFBD><EFBFBD>蝏毺<EFBFBD> EDC 蝟餌<E89D9F>嚗<EFBFBD><E59A97> REDCap嚗㗇糓<E39787>蹱<EFBFBD><E8B9B1><EFBFBD>霈啣<E99C88>撌亙<E6928C><E4BA99><EFBFBD>IT Manager Agent V4 <20>典銁<E585B8>朞<EFBFBD><E69C9E>𡏭䌊<F0A18FAD>娪<EFBFBD>餉<EFBFBD>蝻𡝗<E89DBB> \+ Dify <20>亥<EFBFBD>摨栞<E691A8><E6A09E>賤<EFBFBD>嘅<EFBFBD><E59885><EFBFBD>遣銝<E981A3>銝芸<E98A9D><E88AB8>劐蜓<E58A90>冽<EFBFBD>霂<EFBFBD><E99C82><EFBFBD><EFBFBD><EFBFBD>嗉捶<E59789>扼<EFBFBD><E689BC><EFBFBD>蝡臬<E89DA1><E887AC>𣬚<EFBFBD><F0A3AC9A>啣<EFBFBD>蝘𤑳<E89D98><F0A491B3>ａ<EFBFBD><EFBD81>?
### **1.2 <20>詨<EFBFBD><E8A9A8>格<EFBFBD>**
* **主动任务化**：将 Protocol（方案）转化为主动驱动的任务流，而非被动的数据填报。
* **医疗级合规**：通过“影子状态”机制，确保 AI 建议在进入真理源（REDCap）前经过人类确权。
* **规模化品牌**：通过“企微中枢 \+ 小程序落地”解决 100+ 项目同时运行时的品牌归属感与触达效率。
* **銝餃𢆡隞餃𦛚<EFBFBD>?*嚗𡁜<E59A97> Protocol嚗<6C>䲮獢<E4B2AE><E78DA2>頧砍<E9A0A7>銝箔蜓<E7AE94>券店<E588B8>函<EFBFBD>隞餃𦛚瘚<F0A69B9A><E7989A><EFBFBD>屸<EFBFBD>鋡怠𢆡<E680A0><F0A286A1>㺭<EFBFBD>桀‵<E6A180>乓<EFBFBD>?
* **<EFBFBD>餌<EFBFBD>蝥批<EFBFBD>閫?*嚗𡁻<E59A97>朞<EFBFBD><E69C9E>𨅯蔣摮鞟𠶖<E99E9F><F0A0B696><EFBFBD>脲㦤<E884B2>塚<EFBFBD>蝖桐<E89D96> AI 撱箄悅<E7AE84>刻<EFBFBD><E588BB>亦<EFBFBD><E4BAA6><EFBFBD><EFBFBD>嚗㇌EDCap嚗匧<E59A97>蝏讛<E89D8F>鈭箇掩蝖格<E89D96><E6A0BC>?
* **閫<EFBFBD>芋<EFBFBD>硋<EFBFBD><EFBFBD>?*嚗𡁻<E59A97>朞<EFBFBD><E69C9E>靝<EFBFBD>敺桐葉<E6A190>?\+ 撠讐<E692A0>摨讛氜<E8AE9B>售<EFBFBD>肽圾<E882BD>?100+ 憿寧𤌍<E5AFA7>峕𧒄餈鞱<E9A488><E99EB1>嗥<EFBFBD><E597A5><EFBFBD><EFBFBD>敶鍦<E695B6><E98DA6>煺<EFBFBD>閫西噢<E8A5BF><E599A2><EFBFBD><EFBFBD>?
## **2\. 鈭批<E988AD><E689B9>颱<EFBFBD><E9A2B1>嗆<EFBFBD>嚗𡁜<E59A97><F0A1819C>毺<EFBFBD><E6AFBA>?\+ 憭㚚<E686AD>霈斤䰻**
## **2\. 产品总体架构：原生编排 \+ 外部认知**
蝟餌<EFBFBD><EFBFBD>曉<EFBFBD>鈭<EFBFBD><EFBFBD><EFBFBD>?Agent 獢<>沲嚗屸<E59A97><E5B1B8>沔*\*<2A>𨅯之<F0A885AF>睲<EFBFBD><E79DB2>曆髡擐<E9ABA1><E69390>𩄼*\*<2A><>氖<EFBFBD><E6B096>沲<EFBFBD><E6B2B2><EFBFBD>
系统放弃了黑盒 Agent 框架，采用\*\*“大脑与图书馆”\*\*分离的架构：
* **逻辑大脑 (Node.js \+ pg-boss)**：位于后端，负责状态机流转、影子数据处理、权限校验及异构系统调度。
* **知识图书馆 (Dify RAG)**：负责非结构化文档（方案、指南、手册）的解析与向量检索，作为 AI 的认知增强。
## **3\. 终端与角色矩阵 (Endpoint & Role Matrix)**
系统通过“基础角色 \+ 扩展权限”模式，实现跨终端的紧密协作。
* **<2A>餉<EFBFBD>憭扯<E686AD> (Node.js \+ pg-boss)**嚗帋<E59A97>鈭𤾸<E988AD>蝡荔<E89DA1>韐蠘提<E8A098>嗆<EFBFBD><E59786>㦤瘚<E3A6A4>蓮<EFBFBD><E893AE>蔣摮鞉㺭<E99E89>桀<EFBFBD><E6A180><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>鞉嵗撉<E5B597><E69289>撘<EFBFBD><E69298>蝟餌<E89D9F>靚<EFBFBD>漲<EFBFBD>?
* **<2A>亥<EFBFBD><E4BAA5>曆髡擐?(Dify RAG)**嚗朞<E59A97>韐<EFBFBD><E99F90>蝏𤘪<E89D8F><F0A498AA>𡝗<EFBFBD>獢<EFBFBD><E78DA2><EFBFBD>寞<EFBFBD><E5AF9E><EFBFBD><EFBFBD><EFBFBD>𨰜<EFBFBD><F0A8B09C><EFBFBD><EFBFBD>䕘<EFBFBD><E49598><EFBFBD>圾<EFBFBD>𣂷<EFBFBD><F0A382B7>煾<EFBFBD>璉<EFBFBD>蝝ｇ<E89D9D>雿靝蛹 AI <20><>恕<EFBFBD>亙<EFBFBD>撘箝<E69298>?
## **3\. 蝏<>垢銝舘<E98A9D><E88898>脩畆<E884A9>?(Endpoint & Role Matrix)**
蝟餌<EFBFBD><EFBFBD>朞<EFBFBD><EFBFBD>𨅯抅蝖<EFBFBD>閫坿𠧧 \+ <20>拙<EFBFBD><E68B99><EFBFBD><EFBFBD><EFBFBD>脲芋撘𧶏<E69298>摰䂿緵頝函<E9A09D>蝡舐<E89DA1>蝝批<E89D9D><E689B9>譍<EFBFBD><E8AD8D>?
| 閫坿𠧧 | <20>詨<EFBFBD>霂㗇<E99C82> | <20>刻<EFBFBD>蝏<EFBFBD>垢 | <20>詨<EFBFBD>鈭支<E988AD><E694AF>餉<EFBFBD> |
| :---- | :---- | :---- | :---- |
| **项目负责人 (PI)** | 宏观进度、合规审批、学术报表 | **企业微信 (通知) \+ 微信小程序 (查看)** | 接收企微通知，在小程序查看品牌化报表并审批 |
| **协调员 (CRC)** | 录入数据、复核建议、管理随访 | **REDCap (录入) \+ PC Workbench (复核)** | 尊重 REDCap 录入习惯，在工作站处理 AI 质疑 |
| **患者 (受试者)** | 访视提醒、依从性引导、医学咨询 | **个人微信 (H5/小程序)** | 接收由 Agent 以 CRC 名义发送的企微消息 |
| **系统管理员** | 项目初始化、规则配置、RAG 维护 | **PC 端 (Admin Portal)** | 数字化方案、配置字段映射、管理多租户 |
| **憿寧𤌍韐蠘提鈭?(PI)** | 摰讛<EFBFBD>餈𥕦漲<EFBFBD><EFBFBD><EFBFBD>閫<EFBFBD>恣<EFBFBD>嫘<EFBFBD><EFBFBD>郎<EFBFBD>舀𥁒銵?| **隡<><E99AA1>敺桐縑 (<28>𡁶䰻) \+ 敺桐縑撠讐<E692A0>摨?(<28>亦<EFBFBD>)** | <20>交𤣰隡<F0A4A3B0>凝<EFBFBD>𡁶䰻嚗<E4B0BB>銁撠讐<E692A0>摨𤩺䰻<F0A4A9BA>见<EFBFBD><E8A781><EFBFBD><EFBFBD><EFBFBD>亥”撟嗅恣<E59785>?|
| **<EFBFBD>讛<EFBFBD><EFBFBD>?(CRC)** | 敶訫<EFBFBD><EFBFBD>唳旿<EFBFBD><EFBFBD><EFBFBD><EFBFBD>詨遣霈柴<EFBFBD><EFBFBD>恣<EFBFBD><EFBFBD><EFBFBD>霈?| **REDCap (敶訫<EFBFBD>) \+ PC Workbench (憭齿瓲)** | 撠𢠃<EFBFBD> REDCap 敶訫<EFBFBD>銋䭾<EFBFBD>嚗<EFBFBD>銁撌乩<EFBFBD>蝡坔<EFBFBD><EFBFBD>?AI 韐函<E99F90> |
| **<EFBFBD><EFBFBD><EFBFBD>?(<28>𡑒<EFBFBD><F0A19192>?** | 霈輯<EFBFBD><EFBFBD>鞾<EFBFBD><EFBFBD><EFBFBD><EFBFBD>隞擧<EFBFBD>批<EFBFBD>撖潦<EFBFBD><EFBFBD>龫摮血倮霂?| **銝芯犖敺桐縑 (H5/撠讐<E692A0>摨?** | <EFBFBD>交𤣰<EFBFBD>?Agent 隞?CRC <EFBFBD>滢<EFBFBD><EFBFBD>煾<EFBFBD><EFBFBD><EFBFBD>隡<EFBFBD>凝瘨<EFBFBD><EFBFBD> |
| **蝟餌<EFBFBD>蝞∠<EFBFBD><EFBFBD>?* | 憿寧𤌍<E5AFA7>嘥<EFBFBD><E598A5>硔<EFBFBD><E7A194><EFBFBD><EFBFBD>䠷<EFBFBD>蝵柴<E89DB5><E69FB4>AG 蝏湔擪 | **PC 蝡?(Admin Portal)** | <EFBFBD>啣<EFBFBD><EFBFBD>𡝗䲮獢<EFBFBD><EFBFBD><EFBFBD><EFBFBD>蝵桀<EFBFBD>畾菜<EFBFBD>撠<EFBFBD><EFBFBD><EFBFBD>恣<EFBFBD><EFBFBD><EFBFBD>蝘<EFBFBD><EFBFBD> |
## **4\. 核心功能模块与 Agent 矩阵**
## **4\. <EFBFBD>詨<EFBFBD><EFBFBD>蠘<EFBFBD>璅∪<EFBFBD>銝?Agent <EFBFBD>拚猐**
### **4.1 <20>唳旿韐冽綉 Agent (銝亥馬<E4BAA5><E9A6AC><EFBFBD>撖笔<E69296>)**
* **逻辑**：通过 Webhook 监听 REDCap 录入 \-\> 调用 Dify 检索方案规则 \-\> 发现逻辑冲突 \-\> 生成影子质疑 (Pending Action)。
* **参数**：Temperature \= 0，追求极致确定性。
* **<EFBFBD>餉<EFBFBD>**嚗𡁻<E59A97>朞<EFBFBD> Webhook <EFBFBD>穃𨯬 REDCap 敶訫<EFBFBD> \-\> 靚<EFBFBD>鍂 Dify 璉<EFBFBD>蝝Ｘ䲮獢<EFBFBD><EFBFBD><EFBFBD>?\-\> <20>𤑳緵<F0A491B3>餉<EFBFBD><E9A489>脩<EFBFBD> \-\> <20><><EFBFBD>敶勗<E695B6>韐函<E99F90> (Pending Action)<EFBFBD>?
* **<EFBFBD><EFBFBD>㺭**嚗関emperature \= 0嚗諹蕭瘙<EFBFBD><EFBFBD><EFBFBD>渡＆摰𡁏<EFBFBD>扼<EFBFBD>?
### **4.2 隞餃𦛚撽勗𢆡撘閙<E69298> (<28>啣<EFBFBD><E595A3><EFBFBD>泿摰?**
### **4.2 任务驱动引擎 (数字指挥官)**
* **<2A>餉<EFBFBD>**嚗𡁏覔<F0A1818F>桅★<E6A185>桀<EFBFBD>憪见<E686AA>摰帋<E691B0><E5B88B>?Visit Schedule 霈∠<E99C88>霈輯<E99C88>蝒?\-\> 閫血<E996AB> pg-boss 撱嗆𧒄隞餃𦛚 \-\> <20>芸𢆡<E88AB8>煾<EFBFBD><E785BE>凝靽⊥<E99DBD><E28AA5>鉝<EFBFBD>?
### **4.3 <20><><EFBFBD><EFBFBD><EFBFBD>霈?Agent (皜拇<E79A9C><E68B87><EFBFBD><EFBFBD>靚<EFBFBD><E99D9A>)**
* **逻辑**：根据项目初始化定义的 Visit Schedule 计算访视窗 \-\> 触发 pg-boss 延时任务 \-\> 自动发送微信提醒。
* **<EFBFBD>餉<EFBFBD>**嚗𡁜抅鈭?RAG <20>亥<EFBFBD>摨枏<E691A8>憭齿<E686AD><E9BDBF><EFBFBD>倮霂?\-\> 霂<><E99C82> SAE 憌𡡞埯 \-\> <20>芸𢆡<E88AB8>鞾<EFBFBD> CRC 隞见<E99A9E><E8A781>亦恣<E4BAA6>?
* **<2A><>㺭**嚗関emperature \= 0.7嚗䔶<EFBFBD><EFBFBD><EFBFBD>龫摮虫艇靚函<EFBFBD><EFBFBD>峕𧒄<EFBFBD>瑟<EFBFBD>鈭脣<EFBFBD><EFBFBD>䜘<EFBFBD>?
### **4.4 瘙<>𥁒 Agent (<28>箄<EFBFBD>瘙<EFBFBD>𥁒<EFBFBD>?**
### **4.3 患者随访 Agent (温暖的协调员)**
* **<2A>餉<EFBFBD>**嚗朞䌊<E69C9E>冽<EFBFBD><E586BD>?REDCap 餈𥕦漲<F0A595A6>唳旿 \-\> <20><><EFBFBD><EFBFBD>箄<EFBFBD><E7AE84>亥”<E4BAA5>厩阮 \-\> <20>券<EFBFBD><E588B8>秐 PI 敺桐縑蝖株恕<E6A0AA>?
## **5\. <20>滢<EFBFBD>颲寧<E9A2B2>嚗𡁜<E59A97>頧典僎銵<E5838E><E98AB5><EFBFBD>?*
* **逻辑**：基于 RAG 知识库回复患者咨询 \-\> 识别 SAE 风险 \-\> 自动提醒 CRC 介入接管。
* **参数**：Temperature \= 0.7，保持医学严谨的同时具有亲和力。
### **4.4 汇报 Agent (智能汇报者)**
* **逻辑**：自动汇总 REDCap 进度数据 \-\> 生成智能报表草稿 \-\> 推送至 PI 微信确认。
## **5\. 操作边界：双轨并行原则**
为了降低推广阻力，系统明确划分了 REDCap 与 Workbench 的操作边界：
* **REDCap 原生录入**：
* **场景**：手动、少量、常规的临床数据录入。
* **AI 表现**：后台静默质控，仅通过 EM 插件在页面顶端显示微提醒。
* **AI Workbench**：
* **场景**：化验单 OCR 批量采集、AI 建议的深度复核（同屏对比证据链）、多中心映射配置。
* **AI 表现**：作为主要处理界面，展示推理过程与原文引用。
銝箔<EFBFBD><EFBFBD>滢<EFBFBD><EFBFBD>典嘀<EFBFBD>餃<EFBFBD>嚗𣬚頂蝏<EFBFBD><EFBFBD>蝖桀<EFBFBD><EFBFBD><EFBFBD><EFBFBD> REDCap 銝?Workbench <20><><EFBFBD>雿𡏭器<F0A18FAD>䕘<EFBFBD>
* **REDCap <20>毺<EFBFBD>敶訫<E695B6>**嚗?
* **<2A>箸艶**嚗𡁏<E59A97><F0A1818F>具<EFBFBD><E585B7><EFBFBD><EFBFBD>譌<EFBFBD><E8AD8C>虜閫<E8999C><E996AB>銝游<E98A9D><E6B8B8>唳旿敶訫<E695B6><E8A8AB>?
* **AI 銵函緵**嚗𡁜<E59A97><F0A1819C>圈<EFBFBD>暺䁅捶<E48185>改<EFBFBD>隞<EFBFBD><E99A9E>朞<EFBFBD> EM <20>雴辣<E99BB4>券△<E588B8>ａ▲蝡舀遬蝷箏凝<E7AE8F>鞾<EFBFBD><E99EBE>?
* **AI Workbench**嚗?
* **<2A>箸艶**嚗𡁜<E59A97>撉<EFBFBD><E69289> OCR <20>寥<EFBFBD><E5AFA5><EFBFBD><EFBFBD><EFBFBD><EFBFBD>I 撱箄悅<E7AE84><E68285>楛摨血<E691A8><E8A180>賂<EFBFBD><E8B382><EFBFBD><EFBFBD>撖寞<E69296>霂<EFBFBD>旿<EFBFBD>橘<EFBFBD><E6A998><EFBFBD><EFBFBD>銝剖<E98A9D><E58996>惩<EFBFBD><E683A9>滨蔭<E6BBA8>?
* **AI 銵函緵**嚗帋<E59A97>銝箔蜓閬<E89C93><E996AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ｇ<EFBFBD>撅閧內<E996A7>函<EFBFBD>餈<EFBFBD><E9A488>銝𤾸<E98A9D><F0A4BEB8><EFBFBD><EFBFBD><EFBFBD>具<EFBFBD>?
## **6\. <20>詨<EFBFBD><E8A9A8>箏<EFBFBD>嚗𡁜蔣摮鞟𠶖<E99E9F><F0A0B696>㦤 (Shadow State)**
所有 AI 建议必须经过以下生命周期，严禁 AI 直接修改 REDCap 数据：
1. **PROPOSED (影子建议)**：Agent 发现问题，记录于 pending\_actions 表，包含引用页码及推理逻辑。
2. **APPROVED (人类确权)**：CRC 在 Workbench 点击“确认”或 PI 在小程序点击“审批”。
3. **EXECUTED (正式执行)**：系统通过 EDC Adapter 调用 API 回写至 REDCap，并生成审计日志。
<EFBFBD><EFBFBD><EFBFBD>?AI 撱箄悅敹<E68285>◆蝏讛<E89D8F>隞乩<E99A9E><E4B9A9>笔𦶢<E7AC94>冽<EFBFBD>嚗䔶艇蝳?AI <20>湔𦻖靽格㺿 REDCap <EFBFBD>唳旿嚗?
1. **PROPOSED (敶勗<E695B6>撱箄悅)**嚗鋫gent <20>𤑳緵<F0A491B3>桅<EFBFBD>嚗諹扇敶蓥<E695B6> pending\_actions 銵剁<E98AB5><E58981><EFBFBD>鉄撘閧鍂憿萇<E686BF><E89087>𦠜綫<F0A6A09C><E7B6AB><EFBFBD>餉<EFBFBD><E9A489>?
2. **APPROVED (鈭箇掩蝖格<EFBFBD>)**嚗鋴RC <20>?Workbench <20>孵稬<E5ADB5>𦦵＆霈手<E99C88>脲<EFBFBD> PI <20>典<EFBFBD>蝔见<E89D94><E8A781>孵稬<E5ADB5>𨅯恣<F0A885AF>嫖<EFBFBD>腈<EFBFBD>?
3. **EXECUTED (甇<><E79487><EFBFBD>扯<EFBFBD>)**嚗𡁶頂蝏罸<E89D8F>朞<EFBFBD> EDC Adapter 靚<>鍂 API <20>𧼮<EFBFBD><F0A7BCAE>?REDCap嚗<70>僎<EFBFBD><E5838E><EFBFBD>摰∟恣<E2889F>亙<EFBFBD><E4BA99>?
## **7\. 閫<>芋<EFBFBD>㚚<EFBFBD>蝵脖<E89DB5>敺桐縑<E6A190><E7B891><EFBFBD><EFBFBD>寞<EFBFBD>**
针对“100 个项目、47 家医院”的规模化场景：
<EFBFBD><EFBFBD>笆<EFBFBD>?00 銝芷★<E88AB7>柴<EFBFBD>?7 摰嗅龫<E59785>Ｔ<EFBFBD>萘<EFBFBD>閫<EFBFBD>芋<EFBFBD>硋㦤<E7A18B>荔<EFBFBD>
### **7.1 <20>𡁶䰻銝剜攟 (隡<><E99AA1>敺桐縑)**
* 使用壹证循统一认证的企微主体作为“推送管道”。
* 针对每个研究项目创建“自建应用”，应用名可设置为“XX 项目研究组”，降低商业感。
### **7.2 品牌落地 (小程序)**
* PI/CRC 从企微卡片跳转至微信小程序。
* **动态渲染**：小程序根据 project\_id 自动加载对应医院的 Logo、主题色和项目名称，给足 PI“学术归属感”。
* 雿輻鍂憯寡<EFBFBD>敺芰<EFBFBD>銝<EFBFBD>霈方<EFBFBD><EFBFBD><EFBFBD><EFBFBD>敺桐蜓雿㮖<EFBFBD>銝算<EFBFBD>𨀣綫<EFBFBD><EFBFBD>恣<EFBFBD>𣏾<EFBFBD>腈<EFBFBD>?
* <EFBFBD><EFBFBD>笆瘥譍葵<EFBFBD>𠉛弦憿寧𤌍<EFBFBD>𥕦遣<EFBFBD>𡏭䌊撱箏<EFBFBD><EFBFBD>兩<EFBFBD>嘅<EFBFBD>摨𠉛鍂<EFBFBD>滚虾霈曄蔭銝算<EFBFBD>𤤴X 憿寧𤌍<E5AFA7>𠉛弦蝏<E5BCA6><E89D8F>嘅<EFBFBD><E59885>滢<EFBFBD><E6BBA2><EFBFBD><EFBFBD><EFBFBD>麄<EFBFBD>?
### **7.2 <20><><EFBFBD><EFBFBD>賢𧑐 (撠讐<E692A0>摨?**
* PI/CRC 隞𦒘<E99A9E>敺桀㨃<E6A180><E3A883>歲頧祈秐敺桐縑撠讐<E692A0>摨譌<E691A8>?
* **<2A>冽<EFBFBD><E586BD>葡<EFBFBD>?*嚗𡁜<E59A97>蝔见<E89D94><E8A781>寞旿 project\_id <20>芸𢆡<E88AB8>㰘蝸撖孵<E69296><E5ADB5>駁堺<E9A781>?Logo<67><6F>蜓憸䁅𠧧<E48185>屸★<E5B1B8>桀<EFBFBD>蝘堆<E89D98>蝏躰雲 PI<50>𨅯郎<F0A885AF>臬<EFBFBD>撅墧<E69285><E5A2A7>腈<EFBFBD>?
## **8\. <20><><EFBFBD>臬<EFBFBD>摨找<E691A8>摰匧<E691B0><E58CA7><EFBFBD><EFBFBD>**
### **8.1 <20>箇<EFBFBD>霈暹鴌**
* **数据库**：Postgres-Only 架构，利用 iit\_schema 实现物理隔离。
* **集成层**：REDCap External Module (EM) 侧挂插件 \+ Node.js REST API 适配器。
### **8.2 安全与 GxP**
* **Token 安全**：所有 REDCap API Token 使用 AES-256-GCM 高强度加密存储。
* **脱敏引擎**：上下文进入 LLM 前，本地网关执行 PII（个人身份信息）自动脱敏。
* **审计链**：记录从 AI 推理原文到人类点击确权的全链路 TraceID。
* **<EFBFBD>唳旿摨?*嚗䥪ostgres-Only <EFBFBD>嗆<EFBFBD>嚗<EFBFBD>⏚<EFBFBD>?iit\_schema 摰䂿緵<EFBFBD>拍<EFBFBD><EFBFBD>𠉛氖<EFBFBD>?
* **<EFBFBD><EFBFBD><EFBFBD>撅?*嚗鑹EDCap External Module (EM) 靘扳<EFBFBD><EFBFBD>雴辣 \+ Node.js REST API <EFBFBD><EFBFBD><EFBFBD><EFBFBD>具<EFBFBD>?
### **8.2 摰匧<E691B0>銝?GxP**
* **Token 摰匧<E691B0>**嚗𡁏<E59A97><F0A1818F>?REDCap API Token 雿輻鍂 AES-256-GCM 擃睃撩摨血<E691A8>撖<EFBFBD><E69296><EFBFBD>具<EFBFBD>?
* **<2A>望<EFBFBD>撘閙<E69298>**嚗帋<E59A97>銝𧢲<E98A9D>餈𥕦<E9A488> LLM <20>㵪<EFBFBD><E3B5AA>砍𧑐蝵穃<E89DB5><E7A983>扯<EFBFBD> PII嚗<49>葵鈭箄澈隞賭縑<E8B3AD>荔<EFBFBD><E88D94>芸𢆡<E88AB8>望<EFBFBD><E69C9B>?
* **摰∟恣<E2889F>?*嚗朞扇敶蓥<E695B6> AI <20>函<EFBFBD><E587BD><EFBFBD><EFBFBD><EFBFBD>唬犖蝐餌<E89D90><E9A48C>餌＆<E9A48C><EFBC86><EFBFBD><EFBFBD>券曎頝?TraceID<49>?
## **9\. 摰墧鴌<E5A2A7>嗆挾霈∪<E99C88>**
* **Phase 1 (连接)**：打通 REDCap Webhook 与 Node.js，上线微信周报确认功能。
* **Phase 2 (协同)**：上线 PC Workbench 核心组件，实现质控影子建议的闭环。
* **Phase 3 (增强)**：集成 Python 微服务的 OCR/DC 模块，开启智能化数据采集。
* **Phase 4 (生态)**：完成 100+ 项目规模化配置方案，预研 AI 原生 SmartEDC。
**文档版本**：V4.0 Final | **更新日期**：2025-12-30 | **作者**：产品架构团队
* **Phase 1 (餈墧𦻖)**嚗𡁏<E59A97><F0A1818F>?REDCap Webhook 銝?Node.js嚗䔶<EFBFBD>蝥踹凝靽∪𪂹<EFBFBD>亦＆霈文<EFBFBD><EFBFBD>賬<EFBFBD>?
* **Phase 2 (<EFBFBD>誩<EFBFBD>)**嚗帋<E59A97>蝥?PC Workbench <EFBFBD>詨<EFBFBD>蝏<EFBFBD>辣嚗<EFBFBD><EFBFBD><EFBFBD>啗捶<EFBFBD>批蔣摮𣂼遣霈桃<EFBFBD><EFBFBD>剔㴓<EFBFBD>?
* **Phase 3 (憓𧼮撩)**嚗𡁻<E59A97><F0A181BB>?Python 敺格<EFBFBD><EFBFBD>∠<EFBFBD> OCR/DC 璅∪<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>舀惣<EFBFBD>賢<EFBFBD><EFBFBD>唳旿<EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
* **Phase 4 (<EFBFBD><EFBFBD><EFBFBD>?**嚗𡁜<E59A97><F0A1819C>?100+ 憿寧𤌍閫<F0A48C8D>芋<EFBFBD>㚚<EFBFBD>蝵格䲮獢<E4B2AE><E78DA2>憸<EFBFBD><E686B8> AI <EFBFBD>毺<EFBFBD> SmartEDC<EFBFBD>?
**<2A><>﹝<EFBFBD><EFB99D>𧋦**嚗间4.0 Final | **<EFBFBD>湔鰵<EFBFBD>交<EFBFBD>**嚗?025-12-30 | **雿𡏭<E99BBF>?*嚗帋漣<E5B88B><E6BCA3>沲<EFBFBD><E6B2B2>𣪧<EFBFBD>

112
docs/03-业务模块/IIT Manager Agent/00-系统设计/IIT Manager Agent 技术架构白皮书.md
View File

@@ -1,83 +1,73 @@
# **IIT Manager Agent <20><><EFBFBD>舀沲<E88880><E6B2B2>蒾<EFBFBD>桐髡 (V3.0 <20>煺漣蝥扳沲<E689B3><E6B2B2><EFBFBD>)**
## **1\. 架构愿景：逻辑回归中心，知识驱动未来**
## **1\. <EFBFBD>嗆<EFBFBD><EFBFBD>踵艶嚗𡁻<EFBFBD>餉<EFBFBD><EFBFBD>𧼮<EFBFBD>銝剖<EFBFBD>嚗𣬚䰻霂<EFBFBD>店<EFBFBD>冽𧊋<EFBFBD>?*
本架构旨在解决临床研究中 AI 落地最核心的三个矛盾：**“AI 的不可控性”与“医疗的严谨性”**、**“异构系统的碎片化”与“管理的一体化”**、**“数据隐私”与“模型效能”**。
* **原生编排 (Native Orchestration)**：将核心逻辑与状态机（State Machine）保留在 **Node.js (Fastify) \+ pg-boss** 中。不迷信外部 Agent 框架，确保 SOP 流程在代码级可定义、可测试、可审计。
* **薄认知、厚逻辑**：将 **Dify** 定位于高性能的 **RAG Service**。利用其成熟的文档解析与召回管线，而将决策权、权限控制和事务一致性收回到自研后端。
## **2\. “四层三中心”架构设计**
<EFBFBD>祆沲<EFBFBD><EFBFBD>秄<EFBFBD>刻圾<EFBFBD>喃葩摨羓<EFBFBD>蝛嗡葉 AI <20>賢𧑐<E8B3A2><F0A79190><EFBFBD>詨<EFBFBD><E8A9A8><EFBFBD><EFBFBD>銝芰<E98A9D><E88AB0>橘<EFBFBD>**<2A>𦯷I <20><><EFBFBD><EFBFBD>舀綉<E88880>把<EFBFBD>苷<EFBFBD><E88BB7>𨅯龫<F0A885AF>㛖<EFBFBD>銝亥馬<E4BAA5>把<EFBFBD>?*<2A>?*<2A>𨅯<EFBFBD><F0A885AF><EFBFBD>頂蝏毺<E89D8F>蝣𡒊<E89DA3><F0A1928A>砽<EFBFBD>苷<EFBFBD><E88BB7>𦦵恣<F0A6A6B5><E681A3><EFBFBD>銝<EFBFBD>雿枏<E99BBF><E69E8F>?*<2A>?*<2A>𨀣㺭<F0A880A3>桅<EFBFBD>蝘<EFBFBD><E89D98>苷<EFBFBD><E88BB7>𨀣芋<F0A880A3>𧢲<EFBFBD><F0A7A2B2>賤<EFBFBD>?*<2A>?
* **<2A>毺<EFBFBD>蝻𡝗<E89DBB> (Native Orchestration)**嚗𡁜<E59A97><F0A1819C>詨<EFBFBD><E8A9A8>餉<EFBFBD>銝𡒊𠶖<F0A1928A><F0A0B696>㦤嚗𠄎tate Machine嚗劐<E59A97><E58A90>坔銁 **Node.js (Fastify) \+ pg-boss** 銝准<E98A9D><E58786><EFBFBD>餈瑚縑憭㚚<E686AD> Agent 獢<>沲嚗𣬚＆靽?SOP 瘚<><E7989A><EFBFBD>其誨<E585B6><E8AAA8>漣<EFBFBD>臬<EFBFBD>銋剹<E98A8B><E589B9>虾瘚贝<E7989A><E8B49D><EFBFBD>虾摰∟恣<E2889F>?
* **<2A><>恕<EFBFBD>乓<EFBFBD><E4B993><EFBFBD><EFBFBD>餉<EFBFBD>**嚗𡁜<E59A97> **Dify** 摰帋<E691B0>鈭𡡞<E988AD><F0A1A19E>扯<EFBFBD><E689AF>?**RAG Service**<2A><>⏚<EFBFBD>典<EFBFBD><E585B8>鞟<EFBFBD><E99E9F><EFBFBD><EFBFBD>獢<EFBFBD>圾<EFBFBD>𣂷<EFBFBD><F0A382B7>砍<EFBFBD>蝞∠瑪嚗諹<E59A97><E8ABB9><EFBFBD><EFBFBD>喟<EFBFBD><E5969F><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>鞉綉<E99E89>嗅<EFBFBD>鈭见𦛚銝<F0A69B9A><E98A9D>湔<EFBFBD>扳𤣰<E689B3>𧼮<EFBFBD><F0A7BCAE>芰<EFBFBD><E88AB0>𡒊垢<F0A1928A>?
## **2\. <20>𨅯<EFBFBD>撅<EFBFBD><E69285>銝剖<E98A9D><E58996>脲沲<E884B2><E6B2B2>挽霈?*
### **2.1 <20>嗆<EFBFBD><E59786><EFBFBD><EFBFBD> (Layered Architecture)**
1. **交互层 (Interaction Layer)**：
* **微信/企微终端**：PI 接收周报、患者 AI 咨询及任务提醒。
* **Agent Workbench (基于 Ant Design X)**：CRC 处理 AI 建议、执行质控确认的“驾驶舱”。
2. **逻辑与智能体层 (Logic & Agent Layer)**：
* **Agent Orchestrator**：基于 Node.js 的中央编排器，驱动 pg-boss 任务流。
* **Shadow State 机制**：AI 建议在被人类确认前，仅以“影子数据”形式存在。
3. **连接适配层 (Connectivity Layer)**：
* **EDC Adapter**：非侵入式对接 REDCap (REST API / Webhooks)。
* **Dify RAG Adapter**：封装多知识库检索 API，执行向量检索。
* **Python Execution Service**：执行 OCR、医学 NER 及复杂统计算法（如 MICE）。
4. **基础设施层 (Infrastructure)**：
* **Postgres-Only 中枢**：统一管理任务队列、应用缓存及业务数据（iit\_schema）。
1. **鈭支<EFBFBD>撅?(Interaction Layer)**嚗?
* **敺桐縑/隡<>凝蝏<E5879D>垢**嚗䥪I <20>交𤣰<E4BAA4>冽𥁒<E586BD><F0A58192><EFBFBD><EFBFBD>?AI <20>刻砭<E588BB>𠹺遙<F0A0B9BA>⊥<EFBFBD><E28AA5>鉝<EFBFBD>?
* **Agent Workbench (<EFBFBD>箔<EFBFBD> Ant Design X)**嚗鋴RC 憭<EFBFBD><EFBFBD> AI 撱箄悅<EFBFBD><EFBFBD><EFBFBD>銵諹捶<EFBFBD>抒＆霈斤<EFBFBD><EFBFBD>𣈯忠撽嗉<EFBFBD><EFBFBD>腈<EFBFBD>?
2. **<EFBFBD>餉<EFBFBD>銝擧惣<EFBFBD>賭<EFBFBD>撅?(Logic & Agent Layer)**嚗?
* **Agent Orchestrator**嚗𡁜抅鈭?Node.js <EFBFBD><EFBFBD>葉憭桃<EFBFBD><EFBFBD>鍦膥嚗屸店<EFBFBD>?pg-boss 隞餃𦛚瘚<EFBFBD><EFBFBD>?
* **Shadow State <EFBFBD>箏<EFBFBD>**嚗鋫I 撱箄悅<E7AE84>刻◤鈭箇掩蝖株恕<E6A0AA>㵪<EFBFBD>隞<EFBFBD>誑<EFBFBD>𨅯蔣摮鞉㺭<E99E89>栽<EFBFBD>嘥耦撘誩<E69298><E8AAA9>具<EFBFBD>?
3. **餈墧𦻖<EFBFBD><EFBFBD><EFBFBD>撅?(Connectivity Layer)**嚗?
* **EDC Adapter**嚗𡁻<EFBFBD>靘萄<EFBFBD>撘誩笆<EFBFBD>?REDCap (REST API / Webhooks)<EFBFBD>?
* **Dify RAG Adapter**嚗𡁜<EFBFBD>鋆<EFBFBD><EFBFBD><EFBFBD>亥<EFBFBD>摨𤘪<EFBFBD>蝝?API嚗峕<E59A97>銵<EFBFBD><E98AB5><EFBFBD>𤩺<EFBFBD>蝝Ｕ<E89D9D>?
* **Python Execution Service**嚗𡁏<EFBFBD>銵?OCR<43><52>龫摮?NER <20>𠰴<EFBFBD><F0A0B0B4><EFBFBD><EFBFBD>霈∠<E99C88>瘜𤏪<E7989C>憒?MICE嚗剹<E59A97>?
4. **<EFBFBD>箇<EFBFBD>霈暹鴌撅?(Infrastructure)**嚗?
* **Postgres-Only 銝剜攟**嚗𡁶<E59A97>銝<EFBFBD>蝞∠<E89D9E>隞餃𦛚<E9A483>笔<EFBFBD><E7AC94><EFBFBD><EFBFBD><EFBFBD>函<EFBFBD>摮睃<E691AE>銝𡁜𦛚<F0A1819C>唳旿嚗ǎit\_schema嚗剹<EFBFBD>?
### **2.2 銝匧之銝剖<E98A9D> (System Centers)**
* **真理中心 (REDCap)**：临床数据的唯一合法来源。
* **状态中心 (RDS Postgres)**：管理 Agent 状态、审计日志、用户映射。
* **知识中心 (Dify / PGVector)**：存储数字化方案及医学知识库。
* **<EFBFBD>毺<EFBFBD>銝剖<EFBFBD> (REDCap)**嚗帋葩摨𦠜㺭<EFBFBD>桃<EFBFBD><EFBFBD>臭<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>交<EFBFBD><EFBFBD>?
* **<EFBFBD>嗆<EFBFBD><EFBFBD>葉敹?(RDS Postgres)**嚗𡁶恣<EFBFBD>?Agent <EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD><EFBFBD>恣霈⊥𠯫敹𨰜<EFBFBD><EFBFBD>鍂<EFBFBD>瑟<EFBFBD>撠<EFBFBD><EFBFBD>?
* **<EFBFBD>亥<EFBFBD>銝剖<EFBFBD> (Dify / PGVector)**嚗𡁜<EFBFBD><EFBFBD>冽㺭摮堒<EFBFBD><EFBFBD>寞<EFBFBD><EFBFBD>𠰴龫摮衣䰻霂<EFBFBD><EFBFBD><EFBFBD>?
## **3\. <20>詨<EFBFBD><E8A9A8><EFBFBD><EFBFBD>舀㦤<E88880>嗆楛摨西圾<E8A5BF>?*
## **3\. 核心技术机制深度解析**
### **3.1 敶勗<E695B6><E58B97>嗆<EFBFBD>?(Shadow State) 銝𦒘犖<F0A69298>粹𡡒<E7B2B9>?*
### **3.1 影子状态 (Shadow State) 与人机闭环**
銝箄<EFBFBD><EFBFBD>?AI 撟餉<E6929F>撣行䔉<E8A18C><E49489>㺭<EFBFBD>桅<EFBFBD>霂荔<E99C82>撘訫<E69298><E8A8AB>𨅯蔣摮鞟𠶖<E99E9F><F0A0B696><EFBFBD>嘅<EFBFBD>
为规避 AI 幻觉带来的数据错误，引入“影子状态”：
1. **AI <20><><EFBFBD>撱箄悅**嚗鋫gent 鈭抒<E988AD><E68A92><EFBFBD><EFBFBD><EFBFBD>𨅯<EFBFBD><F0A885AF>?iit\_schema.pending\_actions<6E>?
2. **霂<>旿<EFBFBD>暹滲皞?*嚗𡁜銁 Workbench 銝哨<E98A9D>AI 撱箄悅敹<E68285>◆銝?Dify 餈𥪜<E9A488><F0A5AA9C><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>畾蛛<E795BE>憿萇<E686BF>/<2F>鞉<EFBFBD>嚗匧撩蝏穃<E89D8F><E7A983>?
3. **鈭箇掩蝖格<E89D96>**嚗鋴RC/PI 蝖株恕<E6A0AA>𠬍<EFBFBD>閫血<E996AB>鈭见𦛚<E8A781>?
4. **甇<><E79487><EFBFBD>坔<EFBFBD>**嚗朞<E59A97><E69C9E>?EDC Adapter 撠<>㺭<EFBFBD>桀<EFBFBD><E6A180>?REDCap嚗<70>僎霈啣<E99C88><E595A3>𦯷I-ID \+ Human-ID<49>萘<EFBFBD><E89098>屸<EFBFBD>蝑曉<E89D91><E69B89>?
### **3.2 <20>箔<EFBFBD> Dify <20><><EFBFBD><EFBFBD>亥<EFBFBD>摨?RAG 蝞∠瑪**
1. **AI 生成建议**：Agent 产生的结果存入 iit\_schema.pending\_actions。
2. **证据链溯源**：在 Workbench 中，AI 建议必须与 Dify 返回的原文片段（页码/坐标）强绑定。
3. **人类确权**：CRC/PI 确认后，触发事务。
4. **正式写入**：调用 EDC Adapter 将数据写入 REDCap，并记录“AI-ID \+ Human-ID”的双重签名。
### **3.2 基于 Dify 的多知识库 RAG 管线**
* **多源检索**：针对同一决策，Agent 同时检索“研究方案”、“临床指南”和“历史质控记录”。
* **混合召回**：利用 Dify 的向量检索 \+ 全文检索 \+ Rerank 机制，确保上下文（Context）的极端准确。
* **脱敏安全**：在 Node.js 调用 Dify 接口前，利用 LLM Gateway 执行 PII (个人身份信息) 的本地化扫描与屏蔽。
### **3.3 跨体系身份映射 (Identity Mapping)**
* 建立加密存储的 User-EDC-Credential 体系。
* Agent 的每一个动作都通过 API 代理模拟真实用户的 REDCap 权限，确保数据访问的合规性（Audit Trail 符合 21 CFR Part 11）。
* **憭𡁏<EFBFBD>璉<EFBFBD>蝝?*嚗𡁻<E59A97>撖孵<E69296>銝<EFBFBD><E98A9D>喟<EFBFBD>嚗淾gent <20>峕𧒄璉<F0A79284>蝝Ｔ<E89D9D>𦦵<EFBFBD>蝛嗆䲮獢<E4B2AE><E78DA2>腈<EFBFBD><E88588><EFBFBD>靝葩摨𦠜<E691A8><F0A6A09C>轁<EFBFBD>嘥<EFBFBD><E598A5>𨅯<EFBFBD><F0A885AF>脰捶<E884B0>扯扇敶𨰝<E695B6>腈<EFBFBD>?
* **瘛瑕<EFBFBD><EFBFBD>砍<EFBFBD>**嚗𡁜⏚<F0A1819C>?Dify <20><><EFBFBD><EFBFBD>𤩺<EFBFBD>蝝?\+ <20>冽<EFBFBD>璉<EFBFBD>蝝?\+ Rerank <20>箏<EFBFBD>嚗𣬚＆靽苷<E99DBD>銝𧢲<E98A9D>嚗㇃ontext嚗厩<E59A97><E58EA9><EFBFBD>垢<EFBFBD><E59EA2>＆<EFBFBD>?
* **<EFBFBD>望<EFBFBD>摰匧<EFBFBD>**嚗𡁜銁 Node.js 靚<>鍂 Dify <20>亙藁<E4BA99>㵪<EFBFBD><E3B5AA>拍鍂 LLM Gateway <20>扯<EFBFBD> PII (銝芯犖頨思遢靽⊥<E99DBD>) <20><>𧋦<EFBFBD>啣<EFBFBD><E595A3>急<EFBFBD>銝𤾸<E98A9D><F0A4BEB8>賬<EFBFBD>?
### **3.3 頝其<E9A09D>蝟餉澈隞賣<E99A9E>撠?(Identity Mapping)**
* 撱箇<E692B1><E7AE87>惩<EFBFBD>摮睃<E691AE><E79D83>?User-EDC-Credential 雿梶頂<E6A2B6>?
* Agent <20><><EFBFBD>銝<EFBFBD>銝芸𢆡雿𣈯<E99BBF><F0A388AF>朞<EFBFBD> API 隞<><E99A9E>璅⊥<E79285><E28AA5>笔<EFBFBD><E7AC94>冽<EFBFBD><E586BD>?REDCap <20><><EFBFBD>嚗𣬚＆靽脲㺭<E884B2>株挪<E6A0AA>桃<EFBFBD><E6A183><EFBFBD><EFBFBD><EFBFBD>改<EFBFBD>Audit Trail 蝚血<E89D9A> 21 CFR Part 11嚗剹<E59A97>?
## **4\. <20>函蔡銝擧<E98A9D>扯<EFBFBD>隡睃<E99AA1>蝑𣇉裦**
### **4.1 混合云部署蓝图**
### **4.1 瘛瑕<EFBFBD>鈭煾<EFBFBD>蝵脰<EFBFBD><EFBFBD>?*
* **AI 控制平面 (SAE)**：Node.js 后端与 Python 微服务运行在 Serverless 环境，根据任务负载弹性伸缩。
* **数据底座 (ECS \+ RDS)**：REDCap 运行在 ECS，通过阿里云 VPC 内网与 SAE 通信，降低延迟且数据不出内网。
* **Dify 节点**：独立容器部署，仅作为 RAG 接口对内提供服务。
* **AI <EFBFBD>批<EFBFBD>撟喲𢒰 (SAE)**嚗鐭ode.js <EFBFBD>𡒊垢銝?Python 敺格<EFBFBD><EFBFBD>∟<EFBFBD>銵<EFBFBD>銁 Serverless <EFBFBD>臬<EFBFBD>嚗峕覔<EFBFBD>桐遙<EFBFBD>∟<EFBFBD>頧賢撕<EFBFBD>找撓蝻押<EFBFBD>?
* **<EFBFBD>唳旿摨訫漣 (ECS \+ RDS)**嚗鑹EDCap 餈鞱<EFBFBD><EFBFBD>?ECS嚗屸<E59A97>朞<EFBFBD><E69C9E>輸<EFBFBD>鈭?VPC <20><><EFBFBD>銝?SAE <20>帋縑嚗屸<E59A97>雿𤾸辣餈煺<E9A488><E785BA>唳旿銝滚枂<E6BB9A><E69E82><EFBFBD><EFBFBD>?
* **Dify <EFBFBD><EFBFBD><EFBFBD>**嚗𡁶𡠺蝡见捆<E8A781>券<EFBFBD>蝵莎<E89DB5>隞<EFBFBD><E99A9E>銝?RAG <20>亙藁撖孵<E69296><E5ADB5>𣂷<EFBFBD><F0A382B7>滚𦛚<E6BB9A>?
### **4.2 隞餃𦛚<E9A483>舫<EFBFBD><E888AB>?*
### **4.2 任务可靠性**
* 利用 pg-boss 的指数退避重试机制处理 Webhook 丢失或 REDCap 接口超时。
* 支持长达 24 小时的长任务监控（如患者体征趋势分析）。
## **5\. 风险评估与对冲**
* <20>拍鍂 pg-boss <20><><EFBFBD><EFBFBD>圈<EFBFBD><E59C88><EFBFBD>輸<EFBFBD>霂閙㦤<E99699>嗅<EFBFBD><E59785>?Webhook 銝Ｗ仃<EFBCB7>?REDCap <20>亙藁頞<E89781>𧒄<EFBFBD>?
* <20>舀<EFBFBD><E88880>輯噢 24 撠𤩺𧒄<F0A4A9BA><F0A79284>鵭隞餃𦛚<E9A483>烐綉嚗<E7B689><E59A97><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>敺<EFBFBD><E695BA><EFBFBD>踹<EFBFBD><E8B8B9>琜<EFBFBD><E7909C>?
## **5\. 憌𡡞埯霂<E59FAF>摯銝𤾸笆<F0A4BEB8>?*
| 瞏𨅯銁憌𡡞埯 | 摨𥪜笆蝑𣇉裦 |
| :---- | :---- |
| **逻辑代码膨胀** | 采用“微引擎化”设计，将质控规则参数化并存储在 JSONB 字段中。 |
| **Dify 接口延迟** | 对常用 RAG 背景信息在 app\_cache 中进行短时缓存。 |
| **未来扩展性需求** | 预留状态机接口，逻辑同构设计支持未来向 LangGraph 的平滑迁移。 |
| **<EFBFBD>餉<EFBFBD>隞<EFBFBD><EFBFBD><EFBFBD>刻<EFBFBD>** | <EFBFBD><EFBFBD>鍂<EFBFBD>𨅯凝撘閙<EFBFBD><EFBFBD>砽<EFBFBD>肽挽霈∴<EFBFBD>撠<EFBFBD>捶<EFBFBD>扯<EFBFBD><EFBFBD>坔<EFBFBD><EFBFBD>啣<EFBFBD>撟嗅<EFBFBD><EFBFBD>典銁 JSONB 摮埈挾銝准<E98A9D>?|
| **Dify <EFBFBD>亙藁撱嗉<EFBFBD>** | 撖孵虜<EFBFBD>?RAG <20>峕艶靽⊥<E99DBD><E28AA5>?app\_cache 銝剛<E98A9D>銵𣬚<E98AB5><F0A3AC9A>嗥<EFBFBD>摮塩<E691AE>?|
| **<EFBFBD>芣䔉<EFBFBD>拙<EFBFBD><EFBFBD>折<EFBFBD>瘙?* | 憸<><E686B8><EFBFBD>嗆<EFBFBD><E59786>㦤<EFBFBD>亙藁嚗屸<E59A97>餉<EFBFBD><E9A489>峕<EFBFBD>霈曇恣<E69B87>舀<EFBFBD><E88880>芣䔉<E88AA3>?LangGraph <20><>像皛𤏸<E79A9B>蝘颯<E89D98>?|
## **6\. 实施路线图 (Milestones)**
## **6\. 摰墧鴌頝舐瑪<EFBFBD>?(Milestones)**
1. **Phase 1: 连接与感知**：打通 REDCap 读写适配器，上线微信端智能周报。
2. **Phase 2: 工作站与协同**：完成 Agent Workbench 开发，实现“质控建议-人类确认”的影子闭环。
3. **Phase 3: 全自动采集**：开启多模态 OCR 提取，结合 RAG 知识库实现数据的一键同步。
4. **Phase 4: 智能化演进**：探索基于多智能体对抗（Critic Loop）的深度质控，并预研 SmartEDC 原型。
**文档版本**：V3.0 | **最后更新**：2025-12-30 | **维护者**：架构组
1. **Phase 1: 餈墧𦻖銝擧<EFBFBD><EFBFBD>?*嚗𡁏<E59A97><F0A1818F>?REDCap 霂餃<E99C82><E9A483><EFBFBD><EFBFBD><EFBFBD>剁<EFBFBD>銝羓瑪敺桐縑蝡舀惣<E88880>賢𪂹<E8B3A2>乓<EFBFBD>?
2. **Phase 2: 撌乩<EFBFBD>蝡嗘<EFBFBD><EFBFBD>誩<EFBFBD>**嚗𡁜<E59A97><F0A1819C>?Agent Workbench 撘<><E69298>𡢅<EFBFBD>摰䂿緵<E482BF>𡏭捶<F0A18FAD>批遣霈?鈭箇掩蝖株恕<E6A0AA>萘<EFBFBD>敶勗<E695B6><E58B97>剔㴓<E58994>?
3. **Phase 3: <EFBFBD>刻䌊<EFBFBD>券<EFBFBD><EFBFBD>?*嚗𡁜<E59A97><F0A1819C>臬<EFBFBD>璅⊥<E79285>?OCR <20>𣂼<EFBFBD>嚗𣬚<E59A97><F0A3AC9A>?RAG <20>亥<EFBFBD>摨枏<E691A8><E69E8F>唳㺭<E594B3>桃<EFBFBD>銝<EFBFBD><E98A9D>桀<EFBFBD>甇乓<E79487>?
4. **Phase 4: <EFBFBD>箄<EFBFBD><EFBFBD>𡝗<EFBFBD>餈?*嚗𡁏䔝蝝Ｗ抅鈭𤾸<E988AD><F0A4BEB8>箄<EFBFBD>雿枏笆<E69E8F>梹<EFBFBD>Critic Loop嚗厩<E59A97>瘛勗漲韐冽綉嚗<E7B689>僎憸<E5838E><E686B8> SmartEDC <EFBFBD>笔<EFBFBD><EFBFBD>?
**<2A><>﹝<EFBFBD><EFB99D>𧋦**嚗间3.0 | **<EFBFBD><EFBFBD><EFBFBD>擧凒<EFBFBD>?*嚗?025-12-30 | **蝏湔擪<E6B994>?*嚗𡁏沲<F0A1818F><E6B2B2><EFBFBD>

98
docs/03-业务模块/IIT Manager Agent/00-系统设计/IIT Manager Agent 项目实施战略与 MVP 路线图.md
View File

@@ -1,72 +1,62 @@
# **IIT Manager Agent 项目实施战略与 MVP 路线图**
# **IIT Manager Agent 椤圭洰瀹炴柦鎴樼暐涓?MVP 璺<>嚎鍥?*
## **1\. 核心战略：以“感知”驱动“信任”**
在 Phase 1，我们不急于实现“全自动数据搬运”，因为“写”的合规风险和技术门槛最高。我们应优先实现\*\*“智能感知与主动预警”\*\*。
## **1\. 鏍稿績鎴樼暐锛氫互鈥滄劅鐭モ€濋┍鍔ㄢ€滀俊浠烩€?*
鍦?Phase 1锛屾垜浠<E59E9C>笉鎬ヤ簬瀹炵幇鈥滃叏鑷<E58F8F>姩鏁版嵁鎼<E5B581>繍鈥濓紝鍥犱负鈥滃啓鈥濈殑鍚堣<E98D9A>椋庨櫓鍜屾妧鏈<E5A6A7>棬妲涙渶楂樸€傛垜浠<E59E9C>簲浼樺厛瀹炵幇\*\*鈥滄櫤鑳芥劅鐭ヤ笌涓诲姩棰勮<E6A3B0>鈥漒*\*銆?
**MVP 鐨勫畾涔夛細**
能够实时监听 REDCap 录入，利用 Dify RAG 发现逻辑偏差，并推送到 PI 的微信端进行预警。
鑳藉<EFBFBD>瀹炴椂鐩戝惉 REDCap 褰曞叆锛屽埄鐢?Dify RAG 鍙戠幇閫昏緫鍋忓樊锛屽苟鎺ㄩ€佸埌 PI 鐨勫井淇＄<E6B787>杩涜<E69DA9>棰勮<E6A3B0>銆?
## **2\. 涓夊ぇ閲岀▼纰?(Milestones)**
## **2\. 三大里程碑 (Milestones)**
### **閲岀▼纰?1锛氶€氳矾鎼<E79FBE>缓锛堚€滆矾瑕侀€氣€濓級**
### **里程碑 1：通路搭建（“路要通”）**
* **鐩<>爣**锛氬缓绔?REDCap \-\> Node.js \-\> 寰<>俊鐨勯棴鐜<E6A3B4>€?
* **鍏抽敭浠诲姟**锛?
* **鐜<><E9909C>鍒濆<E98D92>鍖?*锛歋AE 閮ㄧ讲鍚庣<E98D9A>锛孯DS 鍒濆<E98D92>鍖?iit\_schema銆?
* **EDC 閫傞厤鍣?*锛氬畬鎴?REDCap External Module (EM) 鍩虹<E98DA9>寮€鍙戯紝瀹炵幇淇濆瓨璁板綍鏃剁殑 Webhook 瑙﹀彂銆?
* **寰<>俊鑱旈€?*锛氬畬鎴愪紒涓氬井淇″簲鐢ㄥ垱寤轰笌娑堟伅鎺ㄩ€佹帴鍙ｅ<E98D99>鎺ャ€?
### **閲岀▼纰?2锛氭櫤鑳芥敞鍏ワ紙鈥滆剳瑕佺伒鈥濓級**
* **目标**：建立 REDCap \-\> Node.js \-\> 微信的闭环。
* **关键任务**：
* **环境初始化**：SAE 部署后端，RDS 初始化 iit\_schema。
* **EDC 适配器**：完成 REDCap External Module (EM) 基础开发，实现保存记录时的 Webhook 触发。
* **微信联通**：完成企业微信应用创建与消息推送接口对接。
### **里程碑 2：智能注入（“脑要灵”）**
* **目标**：实现 AI 对临床方案的深度理解。
* **关键任务**：
* **Dify 知识库**：上传 1-2 份标准临床协议，调试 RAG 检索参数。
* **Prompt 调优**：编写并测试“数据质控 Agent”提示词，确保其输出符合我们的 JSON 协议。
* **影子生成**：实现后端自动生成 PendingAction 记录。
### **里程碑 3：闭环协同（“活要细”）**
* **目标**：上线 PC Workbench 和 PI 小程序，实现人机确认。
* **关键任务**：
* **Workbench 骨架**：基于 Ant Design X 实现任务列表与证据对比区。
* **PI 小程序**：实现品牌化报表展示与移动端一键审批。
* **回写闭环**：实现 APPROVED 状态后的 REDCap API 自动回写。
* **鐩<EFBFBD>爣**锛氬疄鐜?AI 瀵逛复搴婃柟妗堢殑娣卞害鐞嗚В銆?
* **鍏抽敭浠诲姟**锛?
* **Dify 鐭ヨ瘑搴?*锛氫笂浼?1-2 浠芥爣鍑嗕复搴婂崗璁<E5B497>紝璋冭瘯 RAG 妫€绱㈠弬鏁般€?
* **Prompt 璋冧紭**锛氱紪鍐欏苟娴嬭瘯鈥滄暟鎹<E69A9F>川鎺?Agent鈥濇彁绀鸿瘝锛岀‘淇濆叾杈撳嚭绗﹀悎鎴戜滑鐨?JSON 鍗忚<E98D97>銆?
* **褰卞瓙鐢熸垚**锛氬疄鐜板悗绔<E68297>嚜鍔ㄧ敓鎴?PendingAction 璁板綍銆?
### **閲岀▼纰?3锛氶棴鐜<E6A3B4>崗鍚岋紙鈥滄椿瑕佺粏鈥濓級**
* **鐩<>爣**锛氫笂绾?PC Workbench 鍜?PI 灏忕▼搴忥紝瀹炵幇浜烘満纭<E6BA80><E7BAAD>銆?
* **鍏抽敭浠诲姟**锛?
* **Workbench 楠ㄦ灦**锛氬熀浜?Ant Design X 瀹炵幇浠诲姟鍒楄〃涓庤瘉鎹<E79889><E98EB9>姣斿尯銆?
* **PI 灏忕▼搴?*锛氬疄鐜板搧鐗屽寲鎶ヨ〃灞曠ず涓庣Щ鍔ㄧ<E98D94>涓€閿<E282AC><E996BF>鎵广€?
* **鍥炲啓闂<E59593>幆**锛氬疄鐜?APPROVED 鐘舵€佸悗鐨?REDCap API 鑷<>姩鍥炲啓銆?
## **3\. 褰撳墠鏈€閲嶈<E996B2>鐨勬妧鏈<E5A6A7>敾鍧氱偣 (Technical Hard Rocks)**
### **3.1 REDCap EM 的非侵入式“侧挂” (P0)**
### **3.1 REDCap EM 鐨勯潪渚靛叆寮忊€滀晶鎸傗€?(P0)**
* **挑战**：如何在不破坏医院既有 REDCap 环境的前提下，稳定地把数据“钩”出来。
* **对策**：利用 REDCap 官方的 External Module 框架，只做数据转发，不做业务处理。
* **鎸戞垬**锛氬<E9949B>浣曞湪涓嶇牬鍧忓尰闄㈡棦鏈?REDCap 鐜<><E9909C>鐨勫墠鎻愪笅锛岀ǔ瀹氬湴鎶婃暟鎹<E69A9F>€滈挬鈥濆嚭鏉ャ€?
* **瀵圭瓥**锛氬埄鐢?REDCap 瀹樻柟鐨?External Module 妗嗘灦锛屽彧鍋氭暟鎹<EFBFBD>浆鍙戯紝涓嶅仛涓氬姟澶勭悊銆?
### **3.2 璇佹嵁閾剧殑鈥滅簿鍑嗗畾浣嶁€?(P0)**
### **3.2 证据链的“精准定位” (P0)**
* **挑战**：Dify 返回的文字片段如何转化成前端 PDF 预览的高亮坐标。
* **对策**：在 Dify 侧配置支持返回 metadata（含页码），前端实现一个轻量级的 PDF.js 高亮层。
### **3.3 任务引擎的“长周期调度” (P1)**
* **挑战**：临床研究持续数月甚至数年，如何保证任务不丢失、不重复。
* **对策**：利用 pg-boss 的持久化队列，结合 Postgres 事务保证状态一致性。
* **鎸戞垬**锛欴ify 杩斿洖鐨勬枃瀛楃墖娈靛<E5A888>浣曡浆鍖栨垚鍓嶇<E98D93> PDF 棰勮<E6A3B0>鐨勯珮浜<E78FAE>潗鏍囥€?
* **瀵圭瓥**锛氬湪 Dify 渚ч厤缃<E58EA4>敮鎸佽繑鍥?metadata锛堝惈椤电爜锛夛紝鍓嶇<E98D93>瀹炵幇涓€涓<E282AC>交閲忕骇鐨?PDF.js 楂樹寒灞傘€?
### **3.3 浠诲姟寮曟搸鐨勨€滈暱鍛ㄦ湡璋冨害鈥?(P1)**
* **鎸戞垬**锛氫复搴婄爺绌舵寔缁<E5AF94>暟鏈堢敋鑷虫暟骞达紝濡備綍淇濊瘉浠诲姟涓嶄涪澶便€佷笉閲嶅<E996B2>銆?
* **瀵圭瓥**锛氬埄鐢?pg-boss 鐨勬寔涔呭寲闃熷垪锛岀粨鍚?Postgres 浜嬪姟淇濊瘉鐘舵€佷竴鑷存€с€?
## **4\. MVP 鐗堟湰鍔熻兘娓呭崟 (Scope for MVP)**
涓轰簡璁╃敤鎴峰揩閫熻<EFBFBD>鍒颁笢瑗匡紝MVP 寤鸿<E5AFA4>浠呭寘鍚<E5AF98>互涓嬪姛鑳斤細
1. **项目初始化**：手动输入 5 个关键变量映射（暂不做全量自动映射）。
2. **实时质控预警**：针对“年龄、性别、核心入排标准”进行 AI 检查。
3. **微信消息推送**：当录入违背方案时，PI 收到企微卡片。
4. **PC 简易工作站**：查看违背详情和 AI 给出的证据片段。
1. **椤圭洰鍒濆<EFBFBD>鍖?*锛氭墜鍔ㄨ緭鍏?5 涓<>叧閿<E58FA7>彉閲忔槧灏勶紙鏆備笉鍋氬叏閲忚嚜鍔ㄦ槧灏勶級銆?
2. **瀹炴椂璐ㄦ帶棰勮<EFBFBD>**锛氶拡瀵光€滃勾榫勩€佹€у埆銆佹牳蹇冨叆鎺掓爣鍑嗏€濊繘琛?AI 妫€鏌ャ€?
3. **寰<EFBFBD>俊娑堟伅鎺ㄩ€?*锛氬綋褰曞叆杩濊儗鏂规<E98F82>鏃讹紝PI 鏀跺埌浼佸井鍗＄墖銆?
4. **PC 绠€鏄撳伐浣滅珯**锛氭煡鐪嬭繚鑳岃<E991B3>鎯呭拰 AI 缁欏嚭鐨勮瘉鎹<E79889>墖娈点€?
## **5\. 寤鸿<E5AFA4>鐨勮<E990A8>鍔ㄩ『搴?(Next Steps)**
## **5\. 建议的行动顺序 (Next Steps)**
1. **立刻执行 (Day 1-3)**：
* 注册并认证企业微信开发者主体。
* 在阿里云 SAE 搭建第一个 Node.js Hello World，并调通企业微信推送 API。
2. **同步推进 (Day 1-7)**：
* 由一位前端工程师基于我们的 HTML 原生开始搭建 React 版本的 Workbench 骨架。
* 由一位后端工程师开始编写 REDCap EM 插件的 PHP 代码。
**当前阶段**：Ready to Code | **目标日期**：2 周内完成 MVP 演示闭环
1. **绔嬪埢鎵ц<E98EB5> (Day 1-3)**锛?
* 娉ㄥ唽骞惰<E9AA9E>璇佷紒涓氬井淇″紑鍙戣€呬富浣撱€?
* 鍦ㄩ樋閲屼簯 SAE 鎼<>缓绗<E7BC93>竴涓?Node.js Hello World锛屽苟璋冮€氫紒涓氬井淇℃帹閫?API銆?
2. **鍚屾<E98D9A>鎺ㄨ繘 (Day 1-7)**锛?
* 鐢变竴浣嶅墠绔<EFBFBD>伐绋嬪笀鍩轰簬鎴戜滑鐨?HTML 鍘熺敓寮€濮嬫惌寤?React 鐗堟湰鐨?Workbench 楠ㄦ灦銆?
* 鐢变竴浣嶅悗绔<E68297>伐绋嬪笀寮€濮嬬紪鍐?REDCap EM 鎻掍欢鐨?PHP 浠ｇ爜銆?
**褰撳墠闃舵<E99783>**锛歊eady to Code | **鐩<>爣鏃ユ湡**锛? 鍛ㄥ唴瀹屾垚 MVP 婕旂ず闂<E3819A>幆