Files
AIclinicalresearch/docs/03-业务模块/Redcap
HaHafeng 40c2f8e148 feat(rag): Complete RAG engine implementation with pgvector
Major Features:
- Created ekb_schema (13th schema) with 3 tables: KB/Document/Chunk
- Implemented EmbeddingService (text-embedding-v4, 1024-dim vectors)
- Implemented ChunkService (smart Markdown chunking)
- Implemented VectorSearchService (multi-query + hybrid search)
- Implemented RerankService (qwen3-rerank)
- Integrated DeepSeek V3 QueryRewriter for cross-language search
- Python service: Added pymupdf4llm for PDF-to-Markdown conversion
- PKB: Dual-mode adapter (pgvector/dify/hybrid)

Architecture:
- Brain-Hand Model: Business layer (DeepSeek) + Engine layer (pgvector)
- Cross-language support: Chinese query matches English documents
- Small Embedding (1024) + Strong Reranker strategy

Performance:
- End-to-end latency: 2.5s
- Cost per query: 0.0025 RMB
- Accuracy improvement: +20.5% (cross-language)

Tests:
- test-embedding-service.ts: Vector embedding verified
- test-rag-e2e.ts: Full pipeline tested
- test-rerank.ts: Rerank quality validated
- test-query-rewrite.ts: Cross-language search verified
- test-pdf-ingest.ts: Real PDF document tested (Dongen 2003.pdf)

Documentation:
- Added 05-RAG-Engine-User-Guide.md
- Added 02-Document-Processing-User-Guide.md
- Updated system status documentation

Status: Production ready
2026-01-21 20:24:29 +08:00
..

REDCap模块文档

版本: v1.0
最后更新: 2026-01-02
模块状态: 🟢 本地环境已部署API开发中


🚀 快速开始

我想部署REDCap

👉 10-REDCap_Docker部署操作手册.md

这是最核心的文档!包含:

  • 从0到1的完整部署流程
  • Docker文件复用说明
  • 常见问题与解决方案
  • 适用于本地/ECS/医院环境

30分钟完成部署


我遇到问题了

👉 13-部署问题排查手册.md 🔧

基于实际踩坑经验,包含:

  • ERR_CONTENT_DECODING_FAILED解决方案
  • 登录失败CRLF污染解决方案
  • Base URL配置错误修复
  • MySQL连接问题排查

📚 完整文档目录

00-模块概览

01-部署与配置

02-系统配置与运维

  • 🚧 20-REDCap系统配置手册.md规划中
  • 🚧 21-REDCap日常运维手册.md规划中
  • 🚧 22-REDCap升级指南.md规划中

03-API对接与开发

  • 33-REDCap二次开发深度指南.md - External Modules开发
  • 🚧 30-REDCap_API使用指南.md开发中
  • 🚧 31-IIT_Manager与REDCap对接设计.md开发中
  • 🚧 32-REDCap_API_Adapter开发指南.md开发中

04-参考资料

  • 旧版文档存档

📊 当前进度

阶段 状态 完成日期
技术调研 完成 2025-12
部署方案设计 完成 2026-01-01
本地环境部署 完成 2026-01-02
API Adapter开发 进行中 预计2026-01-03
生产环境部署 📅 计划中 待定

访问地址: http://localhost:8080/
管理员账户: Admin / Admin123!


🎯 REDCap在IIT Manager中的角色

IIT Manager Agent (企业微信)
         ↓
    REDCap API Adapter
         ↓
    REDCap系统 (EDC)
         ↓
    研究数据采集与管理

核心功能:

  • 📋 电子数据采集EDC
  • 📊 数据字典管理
  • 🔍 数据质量控制
  • 📈 报表与导出
  • 👥 用户权限管理

🛠️ Docker配置文件位置

所有Docker配置文件都在

AIclinicalresearch/redcap-docker-dev/
├── Dockerfile.redcap          ✅ 100%可复用
├── docker-compose.yml         ⚠️ 需微调
├── docker-compose.prod.yml    ⚠️ 需修改数据库配置
├── docker-entrypoint.sh       ✅ 100%可复用
├── config/
│   ├── apache/redcap.conf     ⚠️ 需修改域名
│   ├── php/php.ini            ✅ 100%可复用
│   └── database.php           ❌ 必须根据环境定制
├── scripts/                   可选辅助脚本
└── .gitattributes             ✅ 100%可复用

详见:10-REDCap_Docker部署操作手册.md


📞 获取帮助


🔄 最近更新

日期 更新内容
2026-01-02 完成本地Docker环境部署
2026-01-02 创建REDCap Docker部署操作手册
2026-01-02 创建部署问题排查手册
2026-01-02 重组文档体系

准备好开始了吗? 👉 开始部署