Files
AIclinicalresearch/tests/QUICKSTART_快速开始.md
HaHafeng bdfca32305 docs(iit): REDCap对接技术方案完成与模块状态更新
- 新增《REDCap对接技术方案与实施指南》(1070行)
  - 确定DET+REST API技术方案(不使用External Module)
  - 完整RedcapAdapter/WebhookController/SyncManager代码设计
  - Day 2详细实施步骤与验收标准
- 更新《IIT Manager Agent模块当前状态与开发指南》
  - 记录REDCap本地环境部署完成(15.8.0)
  - 记录对接方案确定过程与技术决策
  - 更新Day 2工作计划(6个阶段详细清单)
  - 整体进度18%(Day 1完成+REDCap环境就绪)
- REDCap环境准备完成
  - 测试项目test0102(PID 16)创建成功
  - DET功能源码验证通过
  - 本地Docker环境稳定运行

技术方案:
- 实时触发: Data Entry Trigger (0秒延迟)
- 数据拉取: REST API exportRecords (增量同步)
- 轮询补充: pg-boss定时任务 (每30分钟)
- 可靠性: Webhook幂等性 + 轮询补充机制
2026-01-02 14:30:38 +08:00

1.8 KiB
Raw Blame History

🚀 快速开始 - 1分钟运行测试

Windows用户

方法1双击运行最简单

  1. 双击 run_tests.bat
  2. 等待测试完成

方法2命令行

cd AIclinicalresearch\tests
run_tests.bat

Linux/Mac用户

cd AIclinicalresearch/tests
chmod +x run_tests.sh
./run_tests.sh

⚠️ 前提条件

必须先启动Python服务

# 打开新终端
cd AIclinicalresearch/extraction_service
python main.py

看到这行表示启动成功:

INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8001

📊 预期结果

全部通过

总测试数: 18
✅ 通过: 18
❌ 失败: 0
通过率: 100.0%

🎉 所有测试通过!

⚠️ 部分失败

  • 查看红色错误信息
  • 检查失败的具体测试
  • 查看Python服务日志

🎯 测试内容

  • 6种简单填补方法均值、中位数、众数、固定值、前向填充、后向填充
  • MICE多重插补单列、多列
  • 边界情况100%缺失、0%缺失、特殊字符)
  • 各种数据类型(数值、分类、混合)
  • 性能测试1000行数据

💡 提示

  • 第一次运行会自动安装依赖pandas, numpy, requests
  • 测试时间约 45-60 秒
  • 测试数据自动生成,无需手动准备
  • 颜色输出:绿色=通过,红色=失败,黄色=警告

🆘 遇到问题?

问题1无法连接到服务

解决确保Python服务在运行python main.py

问题2依赖安装失败

解决:手动安装 pip install pandas numpy requests

问题3测试失败

解决:查看错误信息,检查代码逻辑


准备好了吗?启动服务,运行测试! 🚀