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

156
docs/03-业务模块/Redcap/00-模块概览/00-REDCap模块文档导航.md
View File

@@ -1,75 +1,75 @@
# REDCap妯″潡鏂囨。瀵艰埅
**鏈€鍚庢洿鏂帮細** 2026-01-02
**模块类型：** 第三方系统集成与二次开发
**妯″潡绫诲瀷锛?* 绗<>笁鏂圭郴缁熼泦鎴愪笌浜屾<E6B59C>寮€鍙?
**褰撳墠鐘舵€侊細** 鏈<>湴Docker鐜<72><E9909C>宸查儴缃诧紝API Adapter寮€鍙戜腑
---
## 馃摎 鏂囨。浣撶郴璇存槑
REDCap是一个成熟的第三方EDC（电子数据采集）系统，本模块的工作重点是：
1. **部署与配置**：在不同环境（开发/生产/医院）部署REDCap
REDCap鏄<EFBFBD>竴涓<EFBFBD>垚鐔熺殑绗<EFBFBD>笁鏂笶DC锛堢數瀛愭暟鎹<EFBFBD>噰闆嗭級绯荤粺锛屾湰妯″潡鐨勫伐浣滈噸鐐规槸锛?
1. **閮ㄧ讲涓庨厤缃?*锛氬湪涓嶅悓鐜<E68293><E9909C>锛堝紑鍙?鐢熶骇/鍖婚櫌锛夐儴缃睷EDCap
2. **API瀵规帴**锛氶€氳繃REDCap API涓嶪IT Manager Agent闆嗘垚
3. **运维管理**：日常维护、备份、升级
3. **杩愮淮绠＄悊**锛氭棩甯哥淮鎶ゃ€佸<E282AC>浠姐€佸崌绾?
因此，文档架构与自研模块（ASL、DC）不同，更侧重部署与集成。
鍥犳<EFBFBD>锛屾枃妗ｆ灦鏋勪笌鑷<EFBFBD>爺妯″潡锛圓SL銆丏C锛変笉鍚岋紝鏇翠晶閲嶉儴缃蹭笌闆嗘垚銆?
---
## 馃摉 鏂囨。鐩<E38082>綍
### 1️⃣ **系统概览与决策**
### 1锔忊儯 **绯荤粺姒傝<E5A792>涓庡喅绛?*
#### [01-REDCap绯荤粺浠嬬粛涓庨€夊瀷璇存槑.md](./01-REDCap绯荤粺浠嬬粛涓庨€夊瀷璇存槑.md)
- REDCap鏄<70>粈涔堬紵
- 为什么选择REDCap？
- REDCap的核心功能
- 涓轰粈涔堥€夋嫨REDCap锛?
- REDCap鐨勬牳蹇冨姛鑳?
- REDCap鍦↖IT Manager涓<72>殑瑙掕壊
#### [02-REDCap对接总体方案.md](./02-REDCap对接总体方案.md) ✅
- 技术架构设计
#### [02-REDCap瀵规帴鎬讳綋鏂规<EFBFBD>.md](./02-REDCap瀵规帴鎬讳綋鏂规<EFBFBD>.md) 鉁?
- 鎶€鏈<EFBFBD>灦鏋勮<EFBFBD>璁?
- API瀵规帴鏂规<E98F82>
- 鏁版嵁娴佽浆鏂规<E98F82>
- 安全性设计
- 瀹夊叏鎬ц<EFBFBD>璁?
#### [03-REDCap对接风险评估与技术挑战分析.md](./03-REDCap对接风险评估与技术挑战分析.md) ✅
- 技术风险评估
#### [03-REDCap瀵规帴椋庨櫓璇勪及涓庢妧鏈<EFBFBD>寫鎴樺垎鏋?md](./03-REDCap瀵规帴椋庨櫓璇勪及涓庢妧鏈<E5A6A7>寫鎴樺垎鏋?md) 鉁?
- 鎶€鏈<EFBFBD><EFBFBD>闄╄瘎浼?
- 瀹炴柦闅惧害鍒嗘瀽
- 鏇夸唬鏂规<E98F82>瀵规瘮
- 最终决策建议
- 鏈€缁堝喅绛栧缓璁?
#### [04-生产环境部署决策报告_ECS_vs_SAE.md](./04-生产环境部署决策报告_ECS_vs_SAE.md) ✅
#### [04-鐢熶骇鐜<EFBFBD><EFBFBD>閮ㄧ讲鍐崇瓥鎶ュ憡_ECS_vs_SAE.md](./04-鐢熶骇鐜<EFBFBD><EFBFBD>閮ㄧ讲鍐崇瓥鎶ュ憡_ECS_vs_SAE.md) 鉁?
- ECS vs SAE娣卞害瀵规瘮
- 鎴愭湰鍒嗘瀽
- 技术可行性
- 鎶€鏈<EFBFBD>彲琛屾€?
- 鏈€缁堥€夊瀷锛欵CS
---
### 2️⃣ **部署与配置**
### 2锔忊儯 **閮ㄧ讲涓庨厤缃?*
#### [10-本地开发环境部署完全指南.md](./10-本地开发环境部署完全指南.md) ⭐
- **快速开始**（适合首次部署）
#### [10-鏈<EFBFBD>湴寮€鍙戠幆澧冮儴缃插畬鍏ㄦ寚鍗?md](./10-鏈<>湴寮€鍙戠幆澧冮儴缃插畬鍏ㄦ寚鍗?md) 猸?
- **蹇<EFBFBD>€熷紑濮?*锛堥€傚悎棣栨<E6A3A3>閮ㄧ讲锛?
- Docker鐜<72><E9909C>鍑嗗<E98D91>
- 一键部署脚本使用
- 初始化配置
- 涓€閿<EFBFBD>儴缃茶剼鏈<EFBFBD>娇鐢?
- 鍒濆<EFBFBD>鍖栭厤缃?
- 楠岃瘉娴嬭瘯
- **鍏抽敭鍙傝€冩枃妗ｏ紒**
#### [11-生产环境部署完全指南_阿里云ECS.md](./11-生产环境部署完全指南_阿里云ECS.md) ⭐
- **ECS服务器配置**
- Docker镜像构建与推送
#### [11-鐢熶骇鐜<EFBFBD><EFBFBD>閮ㄧ讲瀹屽叏鎸囧崡_闃块噷浜慐CS.md](./11-鐢熶骇鐜<E9AA87><E9909C>閮ㄧ讲瀹屽叏鎸囧崡_闃块噷浜慐CS.md) 猸?
- **ECS鏈嶅姟鍣ㄩ厤缃?*
- Docker闀滃儚鏋勫缓涓庢帹閫?
- RDS MySQL閰嶇疆
- 鍩熷悕涓嶴SL璇佷功
- 安全组与防火墙
- 生产环境检查清单
- **生产部署必读！**
- 瀹夊叏缁勪笌闃茬伀澧?
- 鐢熶骇鐜<EFBFBD><EFBFBD>妫€鏌ユ竻鍗?
- **鐢熶骇閮ㄧ讲蹇呰<EFBFBD>锛?*
#### [12-医院私有化部署指南.md](./12-医院私有化部署指南.md) 🏥
- 医院服务器环境要求
#### [12-鍖婚櫌绉佹湁鍖栭儴缃叉寚鍗?md](./12-鍖婚櫌绉佹湁鍖栭儴缃叉寚鍗?md) 馃彞
- 鍖婚櫌鏈嶅姟鍣ㄧ幆澧冭<EFBFBD>姹?
- 鍐呯綉閮ㄧ讲鏂规<E98F82>
- 数据安全与合规
- 鏁版嵁瀹夊叏涓庡悎瑙?
- 鎶€鏈<E282AC>敮鎸佷笌鍩硅<E98DA9>
#### [13-閮ㄧ讲闂<E8AEB2><E99782>鎺掓煡鎵嬪唽.md](./13-閮ㄧ讲闂<E8AEB2><E99782>鎺掓煡鎵嬪唽.md) 馃敡
@@ -80,31 +80,31 @@ REDCap是一个成熟的第三方EDC（电子数据采集）系统，本模块
---
### 3️⃣ **配置与管理**
### 3锔忊儯 **閰嶇疆涓庣<E6B693>鐞?*
#### [20-REDCap绯荤粺閰嶇疆鎵嬪唽.md](./20-REDCap绯荤粺閰嶇疆鎵嬪唽.md)
- 基础配置（Base URL、邮件服务等）
- 用户与权限管理
- 项目创建与配置
- 鍩虹<EFBFBD>閰嶇疆锛圔ase URL銆侀偖浠舵湇鍔＄瓑锛?
- 鐢ㄦ埛涓庢潈闄愮<EFBFBD>鐞?
- 椤圭洰鍒涘缓涓庨厤缃?
- 鏁版嵁瀛楀吀璁捐<E79281>
- 琛ㄥ崟璁捐<E79281>
#### [21-REDCap鏃ュ父杩愮淮鎵嬪唽.md](./21-REDCap鏃ュ父杩愮淮鎵嬪唽.md)
- 鏃ュ父缁存姢浠诲姟
- 备份与恢复
- 澶囦唤涓庢仮澶?
- 鎬ц兘鐩戞帶
- 鏃ュ織绠＄悊
- 鏁呴殰澶勭悊娴佺▼
#### [22-REDCap鍗囩骇鎸囧崡.md](./22-REDCap鍗囩骇鎸囧崡.md)
- 鐗堟湰鍗囩骇娴佺▼
- 数据库迁移
- 兼容性测试
- 鏁版嵁搴撹縼绉?
- 鍏煎<EFBFBD>鎬ф祴璇?
- 鍥炴粴鏂规<E98F82>
---
### 4️⃣ **API对接与开发**
### 4锔忊儯 **API瀵规帴涓庡紑鍙?*
#### [30-REDCap_API浣跨敤鎸囧崡.md](./30-REDCap_API浣跨敤鎸囧崡.md)
- REDCap API姒傝堪
@@ -118,21 +118,21 @@ REDCap是一个成熟的第三方EDC（电子数据采集）系统，本模块
- 鎺ュ彛璁捐<E79281>
- 閿欒<E996BF>澶勭悊
#### [32-REDCap_API_Adapter开发指南.md](./32-REDCap_API_Adapter开发指南.md)
#### [32-REDCap_API_Adapter寮€鍙戞寚鍗?md](./32-REDCap_API_Adapter寮€鍙戞寚鍗?md)
- Adapter鏋舵瀯璁捐<E79281>
- 浠ｇ爜缁撴瀯
- 开发规范
- 寮€鍙戣<EFBFBD>鑼?
- 娴嬭瘯鏂规<E98F82>
#### [33-REDCap二次开发深度指南.md](./33-REDCap二次开发深度指南.md) ✅
- External Modules开发
#### [33-REDCap浜屾<EFBFBD>寮€鍙戞繁搴︽寚鍗?md](./33-REDCap浜屾<EFBFBD>寮€鍙戞繁搴︽寚鍗?md) 鉁?
- External Modules寮€鍙?
- Hooks鏈哄埗
- 插件开发
- 最佳实践
- 鎻掍欢寮€鍙?
- 鏈€浣冲疄璺?
---
### 5️⃣ **参考资料**
### 5锔忊儯 **鍙傝€冭祫鏂?*
#### [40-REDCap瀹樻柟璧勬簮绱㈠紩.md](./40-REDCap瀹樻柟璧勬簮绱㈠紩.md)
- 瀹樻柟鏂囨。閾炬帴
@@ -148,46 +148,46 @@ REDCap是一个成熟的第三方EDC（电子数据采集）系统，本模块
---
## 🎯 快速入口
## 馃幆 蹇<>€熷叆鍙?
### 鎴戞兂閮ㄧ讲REDCap
- **本地开发测试** → [10-本地开发环境部署完全指南.md](./10-本地开发环境部署完全指南.md)
- **阿里云生产环境** → [11-生产环境部署完全指南_阿里云ECS.md](./11-生产环境部署完全指南_阿里云ECS.md)
- **医院私有化** → [12-医院私有化部署指南.md](./12-医院私有化部署指南.md)
- **鏈<EFBFBD>湴寮€鍙戞祴璇?* 鈫?[10-鏈<>湴寮€鍙戠幆澧冮儴缃插畬鍏ㄦ寚鍗?md](./10-鏈<>湴寮€鍙戠幆澧冮儴缃插畬鍏ㄦ寚鍗?md)
- **闃块噷浜戠敓浜х幆澧?* 鈫?[11-鐢熶骇鐜<E9AA87><E9909C>閮ㄧ讲瀹屽叏鎸囧崡_闃块噷浜慐CS.md](./11-鐢熶骇鐜<E9AA87><E9909C>閮ㄧ讲瀹屽叏鎸囧崡_闃块噷浜慐CS.md)
- **鍖婚櫌绉佹湁鍖?* 鈫?[12-鍖婚櫌绉佹湁鍖栭儴缃叉寚鍗?md](./12-鍖婚櫌绉佹湁鍖栭儴缃叉寚鍗?md)
### 我遇到部署问题
- **问题排查** → [13-部署问题排查手册.md](./13-部署问题排查手册.md)
- **历史问题记录** → [13-部署问题排查手册.md](./13-部署问题排查手册.md)
### 鎴戦亣鍒伴儴缃查棶棰?
- **闂<EFBFBD><EFBFBD>鎺掓煡** 鈫?[13-閮ㄧ讲闂<EFBFBD><EFBFBD>鎺掓煡鎵嬪唽.md](./13-閮ㄧ讲闂<E8AEB2><E99782>鎺掓煡鎵嬪唽.md)
- **鍘嗗彶闂<EFBFBD><EFBFBD>璁板綍** 鈫?[13-閮ㄧ讲闂<EFBFBD><EFBFBD>鎺掓煡鎵嬪唽.md](./13-閮ㄧ讲闂<E8AEB2><E99782>鎺掓煡鎵嬪唽.md)
### 我要进行API开发
- **了解API** → [30-REDCap_API使用指南.md](./30-REDCap_API使用指南.md)
- **对接设计** → [31-IIT_Manager与REDCap对接设计.md](./31-IIT_Manager与REDCap对接设计.md)
- **开发Adapter** → [32-REDCap_API_Adapter开发指南.md](./32-REDCap_API_Adapter开发指南.md)
### 鎴戣<EFBFBD>杩涜<EFBFBD>API寮€鍙?
- **浜嗚ВAPI** 鈫?[30-REDCap_API浣跨敤鎸囧崡.md](./30-REDCap_API浣跨敤鎸囧崡.md)
- **瀵规帴璁捐<EFBFBD>** 鈫?[31-IIT_Manager涓嶳EDCap瀵规帴璁捐<EFBFBD>.md](./31-IIT_Manager涓嶳EDCap瀵规帴璁捐<EFBFBD>.md)
- **寮€鍙慉dapter** 鈫?[32-REDCap_API_Adapter寮€鍙戞寚鍗?md](./32-REDCap_API_Adapter寮€鍙戞寚鍗?md)
### 鎴戣<E98EB4>鏃ュ父杩愮淮
- **系统配置** → [20-REDCap系统配置手册.md](./20-REDCap系统配置手册.md)
- **日常维护** → [21-REDCap日常运维手册.md](./21-REDCap日常运维手册.md)
- **版本升级** → [22-REDCap升级指南.md](./22-REDCap升级指南.md)
- **绯荤粺閰嶇疆** 鈫?[20-REDCap绯荤粺閰嶇疆鎵嬪唽.md](./20-REDCap绯荤粺閰嶇疆鎵嬪唽.md)
- **鏃ュ父缁存姢** 鈫?[21-REDCap鏃ュ父杩愮淮鎵嬪唽.md](./21-REDCap鏃ュ父杩愮淮鎵嬪唽.md)
- **鐗堟湰鍗囩骇** 鈫?[22-REDCap鍗囩骇鎸囧崡.md](./22-REDCap鍗囩骇鎸囧崡.md)
---
## 📊 模块当前状态
## 馃搳 妯″潡褰撳墠鐘舵€?
| 阶段 | 状态 | 完成时间 | 备注 |
| 闃舵<EFBFBD> | 鐘舵€?| 瀹屾垚鏃堕棿 | 澶囨敞 |
|------|------|----------|------|
| 技术调研 | ✅ 完成 | 2025-12 | 完成风险评估与方案设计 |
| 部署方案设计 | ✅ 完成 | 2026-01-01 | 确定Docker+ECS方案 |
| 本地环境部署 | ✅ 完成 | 2026-01-02 | REDCap 15.8.0运行正常 |
| API Adapter开发 | ⏳ 进行中 | 预计2026-01-03 | Day 2任务 |
| 生产环境部署 | 📅 计划中 | 待定 | 等待API Adapter完成 |
| 鎶€鏈<EFBFBD>皟鐮?| 鉁?瀹屾垚 | 2025-12 | 瀹屾垚椋庨櫓璇勪及涓庢柟妗堣<E5A697>璁?|
| 閮ㄧ讲鏂规<EFBFBD>璁捐<EFBFBD> | 鉁?瀹屾垚 | 2026-01-01 | 纭<EFBFBD>畾Docker+ECS鏂规<EFBFBD> |
| 鏈<EFBFBD>湴鐜<EFBFBD><EFBFBD>閮ㄧ讲 | 鉁?瀹屾垚 | 2026-01-02 | REDCap 15.8.0杩愯<EFBFBD>姝ｅ父 |
| API Adapter寮€鍙?| 鈴?杩涜<E69DA9>涓?| 棰勮<E6A3B0>2026-01-03 | Day 2浠诲姟 |
| 鐢熶骇鐜<EFBFBD><EFBFBD>閮ㄧ讲 | 馃搮 璁″垝涓?| 寰呭畾 | 绛夊緟API Adapter瀹屾垚 |
---
## 馃攧 鏂囨。鏇存柊璁板綍
| 日期 | 更新内容 | 更新人 |
| 鏃ユ湡 | 鏇存柊鍐呭<E98D90> | 鏇存柊浜?|
|------|----------|--------|
| 2026-01-02 | 创建文档体系，完成本地部署 | AI Assistant |
| 2026-01-02 | 鍒涘缓鏂囨。浣撶郴锛屽畬鎴愭湰鍦伴儴缃?| AI Assistant |
| 2025-12-XX | 瀹屾垚鎶€鏈<E282AC>柟妗堜笌椋庨櫓璇勪及鏂囨。 | AI Assistant |
---
@@ -195,25 +195,25 @@ REDCap是一个成熟的第三方EDC（电子数据采集）系统，本模块
## 馃摑 鏂囨。缂栧啓瑙勮寖
### 鍥炬爣浣跨敤瑙勮寖
- ⭐ 核心必读文档
- ✅ 已完成
- ⏳ 进行中
- 📅 计划中
- 猸?鏍稿績蹇呰<E8B987>鏂囨。
- 鉁?宸插畬鎴?
- 鈴?杩涜<E69DA9>涓?
- 馃搮 璁″垝涓?
- 馃敡 鏁呴殰鎺掓煡
- 馃彞 鍖婚櫌涓撶敤
- 💡 技巧提示
- 馃挕 鎶€宸ф彁绀?
- 鈿狅笍 閲嶈<E996B2>璀﹀憡
### 鏂囨。鍛藉悕瑙勮寖
- 按数字分类：01-09系统概览，10-19部署，20-29配置，30-39开发，40-49参考
- 使用下划线分隔多个单词（而非空格）
- 重要文档加"完全指南"/"手册"/"指南"后缀
- 鎸夋暟瀛楀垎绫伙細01-09绯荤粺姒傝<E5A792>锛?0-19閮ㄧ讲锛?0-29閰嶇疆锛?0-39寮€鍙戯紝40-49鍙傝€?
- 浣跨敤涓嬪垝绾垮垎闅斿<EFBFBD>涓<EFBFBD>崟璇嶏紙鑰岄潪绌烘牸锛?
- 閲嶈<EFBFBD>鏂囨。鍔?瀹屽叏鎸囧崡"/"鎵嬪唽"/"鎸囧崡"鍚庣紑
---
## 馃啒 鑾峰彇甯<E5BD87>姪
- **技术问题**：查看 [13-部署问题排查手册.md](./13-部署问题排查手册.md)
- **鎶€鏈<EFBFBD>棶棰?*锛氭煡鐪?[13-閮ㄧ讲闂<E8AEB2><E99782>鎺掓煡鎵嬪唽.md](./13-閮ㄧ讲闂<E8AEB2><E99782>鎺掓煡鎵嬪唽.md)
- **REDCap瀹樻柟**锛歨ttps://projectredcap.org/
- **Docker问题**：查看 `redcap-docker-dev/README.md`
- **Docker闂<EFBFBD><EFBFBD>**锛氭煡鐪?`redcap-docker-dev/README.md`