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

feat(ssa): Complete QPER architecture - Query, Planner, Execute, Reflection layers

Browse Source 
Implement the full QPER intelligent analysis pipeline:

- Phase E+: Block-based standardization for all 7 R tools, DynamicReport renderer, Word export enhancement

- Phase Q: LLM intent parsing with dynamic Zod validation against real column names, ClarificationCard component, DataProfile is_id_like tagging

- Phase P: ConfigLoader with Zod schema validation and hot-reload API, DecisionTableService (4-dimension matching), FlowTemplateService with EPV protection, PlannedTrace audit output

- Phase R: ReflectionService with statistical slot injection, sensitivity analysis conflict rules, ConclusionReport with section reveal animation, conclusion caching API, graceful R error classification

End-to-end test: 40/40 passed across two complete analysis scenarios.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
HaHafeng
2026-02-21 18:15:53 +08:00
parent 428a22adf2
commit 371e1c069c
73 changed files with 9242 additions and 706 deletions
Download Patch File Download Diff File Expand all files Collapse all files

58
docs/00-系统总体设计/00-系统当前状态与开发指南.md
View File

@@ -1,11 +1,12 @@
# AIclinicalresearch 系统当前状态与开发指南
> **文档版本：** v5.6
> **文档版本：** v5.7
> **创建日期：** 2025-11-28
> **维护者：** 开发团队
> **最后更新：** 2026-02-20
> **最后更新：** 2026-02-21
> **🎉 重大里程碑：**
> - **🆕 2026-02-20：SSA Phase 2A 前端集成完成！** 多步骤工作流端到端 + V11 UI联调 + Block-based 架构共识
> - **🆕 2026-02-21：SSA QPER 智能化主线闭环完成！** Q→P→E→R 四层架构全部开发完成，端到端 40/40 测试通过
> - **2026-02-20：SSA Phase 2A 前端集成完成！** 多步骤工作流端到端 + V11 UI联调 + Block-based 架构共识
> - **2026-02-19：SSA T 检验端到端测试通过！** 完整流程验证 + 9 个 Bug 修复 + Phase 1 核心完成 85%
> - **2026-02-19：SSA Week 1 开发完成！** R Docker 镜像构建成功 + 后端/前端骨架 + 规范对齐
> - **2026-02-18：SSA MVP 开发计划 v1.5 完成！** Brain-Hand架构 + 统计护栏 + HITL + 专家配置体系
@@ -23,14 +24,13 @@
> - **2026-01-24：Protocol Agent 框架完成！** 可复用Agent框架+5阶段对话流程
> - **2026-01-22：OSS 存储集成完成！** 阿里云 OSS 正式接入平台基础层
>
> **🆕 最新进展（SSA Phase 2A 前端集成完成 2026-02-20）：**
> - ✅ **🎉 多步骤工作流端到端**：数据上传 → 质量报告 → 多步骤规划 → SSE 实时执行 → 结果展示 → 报告/代码导出
> - ✅ **V11 UI 前后端联调**：Gemini 风格对话界面 + 多任务支持 + 单页滚动布局
> - ✅ **Python 数据质量服务集成**：CSV 直传 Python 解析，修复端口/环境变量问题
> - ✅ **意图识别增强**：正则提取变量名 + 变量类型判断 → 智能选择统计方法
> - ✅ **描述性统计完整支持**：专用 DescriptiveResultView 组件 + Word 导出
> - ✅ **6 个前端 Bug 修复**：SAP 误显示、布局混乱、SSE 卡死、结果丢失等
> - ✅ **Block-based 架构共识**：4 种 Block 类型，R → Node.js → 前端全链路标准化
> **🆕 最新进展（SSA QPER 智能化主线闭环 2026-02-21）：**
> - ✅ **🎉 QPER 四层架构主线闭环** — Phase E+/Q/P/R 全部完成（93.5h），端到端 40/40 测试通过
> - ✅ **Q 层 LLM 意图理解** — 自然语言→四维信息提取 + Zod 动态防幻觉 + 追问卡片
> - ✅ **P 层配置化决策表** — JSON 驱动四维匹配 + 流程模板 + PlannedTrace + 热更新 API
> - ✅ **R 层 LLM 论文级结论** — 6 要素结论 + 统计量槽位注入 + Zod 校验 + 敏感性冲突准则
> - ✅ **四层降级体系** — Q→正则, P→硬编码, E→错误分类, R→规则引擎，LLM 不可用时系统不中断
> - ✅ **Block-based 标准化** — 7 个 R 工具输出 report_blocks，前端动态渲染 + Word 导出
>
> **部署状态：** ✅ 生产环境运行中 | 公网地址：http://8.140.53.236/
> **REDCap 状态：** ✅ 生产环境运行中 | 地址：https://redcap.xunzhengyixue.com/
@@ -71,7 +71,7 @@
| **ASL** | AI智能文献 | 文献筛选、Meta分析、证据图谱 | ⭐⭐⭐⭐⭐ | 🎉 **智能检索MVP完成（60%）** - DeepSearch集成 | **P0** |
| **DC** | 数据清洗整理 | ETL + 医学NER（百万行级数据） | ⭐⭐⭐⭐⭐ | ✅ **Tool B完成 + Tool C 99%（异步架构+性能优化-99%+多指标转换+7大功能）** | **P0** |
| **IIT** | IIT Manager Agent | AI驱动IIT研究助手 - 双脑架构+REDCap集成 | ⭐⭐⭐⭐⭐ | 🎉 **事件级质控V3.1完成（设计100%，代码60%）** | **P0** |
| **SSA** | 智能统计分析 | Brain-Hand架构 + 统计护栏 + HITL + 10工具MVP | ⭐⭐⭐⭐⭐ | 🎉 **Phase 2A完成（设计100%，开发95%）** - 多步骤工作流+V11 UI+Block-based架构共识 | **P1** |
| **SSA** | 智能统计分析 | **QPER架构** + LLM意图理解 + 配置化决策表 + LLM论文结论 | ⭐⭐⭐⭐⭐ | 🎉 **QPER主线闭环（E+/Q/P/R 100%）** - 40/40端到端通过，Phase Deploy待启动 | **P1** |
| **ST** | 统计分析工具 | 100+轻量化统计工具 | ⭐⭐⭐⭐ | 📋 规划中 | P2 |
| **RVW** | 稿件审查系统 | 方法学评估 + 🆕数据侦探（L1/L2/L2.5验证）+ Skills架构 + Word导出 | ⭐⭐⭐⭐ | 🚀 **V2.0 Week3完成（85%）** - 统计验证扩展+负号归一化+文件格式提示+用户体验优化 | P1 |
| **ADMIN** | 运营管理端 | Prompt管理、租户管理、用户管理、运营监控、系统知识库 | ⭐⭐⭐⭐⭐ | 🎉 **Phase 4.6完成（88%）** - Prompt知识库集成+动态注入 | **P0** |
@@ -156,23 +156,31 @@
---
## 🚀 当前开发状态（2026-02-20）
## 🚀 当前开发状态（2026-02-21）
### 🎉 最新进展：SSA Phase 2A 前端集成完成 + Block-based 架构共识（2026-02-20）
### 🎉 最新进展：SSA QPER 智能化主线闭环完成（2026-02-21）
#### ✅ SSA Phase 2A 前端集成（2026-02-20）
#### ✅ SSA QPER 四层架构全部完成（2026-02-21）
**核心成就**：
- ✅ **多步骤工作流端到端**：数据上传 → 质量报告 → 多步骤规划 → SSE 实时执行 → 结果 → 导出
- ✅ **V11 UI 前后端联调**：Gemini 风格 + 多任务 + 单页滚动 + Word/R代码导出
- ✅ **Python 数据质量服务**：CSV 直传 Python 解析，双端点支持
- ✅ **意图识别增强**：变量名提取 + 类型判断 → 智能选择统计方法
- ✅ **描述性统计**：专用渲染组件 + Word 导出完整支持
- ✅ **6 个 Bug 修复**：SAP 误显示、布局混乱、SSE 卡死、结果丢失等
**重大里程碑：Q→P→E→R 完整链路闭环，端到端 40/40 测试通过！**
**架构决策**：
- ✅ **Block-based 动态渲染协议**：4 种 Block 类型（markdown/table/image/key_value）
- ✅ **开发计划已制定**：`08-Block-based动态结果渲染开发计划.md`（~2.5 天工时）
| Phase | 核心产出 | 状态 |
|-------|---------|------|
| E+ | 7 个 R 工具 Block-based 标准化输出 + DynamicReport + Word 导出 | ✅ |
| Q | QueryService + LLM Intent + Zod 动态防幻觉 + 追问卡片 | ✅ |
| P | ConfigLoader + DecisionTable + FlowTemplate + PlannedTrace + 热更新 | ✅ |
| R | ReflectionService + 槽位注入 + Zod 校验 + 敏感性冲突准则 + 结论缓存 | ✅ |
**架构亮点**：
- ✅ **四层降级体系**：每层 LLM 失败时自动 fallback，系统不中断
- ✅ **配置化驱动**：决策表/模板/工具注册表为 JSON，`POST /reload` 热更新
- ✅ **统计量槽位注入**：LLM 被剥夺生成数值权限，所有数值来自 R 引擎
**下一步**：Phase Deploy（工具补齐 + 部署）→ Phase Q+（人机协同增强）
**相关文档**：
- 开发计划：`docs/03-业务模块/SSA-智能统计分析/04-开发计划/10-QPER架构开发计划-智能化主线.md`
- 开发总结：`docs/03-业务模块/SSA-智能统计分析/06-开发记录/SSA-QPER架构开发总结-2026-02-21.md`
### 🎉 SSA Week 1 开发完成 + R Docker 构建成功（2026-02-19）