feat(iit): Complete V3.1 QC engine + GCP business reports + AI timeline + bug fixes
V3.1 QC Engine: - QcExecutor unified entry + D1-D7 dimension engines + three-level aggregation - HealthScoreEngine + CompletenessEngine + ProtocolDeviationEngine + QcAggregator - B4 flexible cron scheduling (project-level cronExpression + pg-boss dispatcher) - Prisma migrations for qc_field_status, event_status, project_stats GCP Business Reports (Phase A - 4 reports): - D1 Eligibility: record_summary full list + qc_field_status D1 overlay - D2 Completeness: data entry rate and missing rate aggregation - D3/D4 Query Tracking: severity distribution from qc_field_status - D6 Protocol Deviation: D6 dimension filtering - 4 frontend table components + ReportsPage 5-tab restructure AI Timeline Enhancement: - SkillRunner outputs totalRules (33 actual rules vs 1 skill) - iitQcCockpitController severity mapping fix (critical->red, warning->yellow) - AiStreamPage expandable issue detail table with Chinese labels - Event label localization (eventLabel from backend) Business-side One-click Batch QC: - DashboardPage batch QC button with SyncOutlined icon - Auto-refresh QcReport cache after batch execution Bug Fixes: - dimension_code -> rule_category in 4 SQL queries - D1 eligibility data source: record_summary full + qc_field_status overlay - Timezone UTC -> Asia/Shanghai (QcReportService toBeijingTime helper) - Pass rate calculation: passed/totalEvents instead of passed/totalRecords Docs: - Update IIT module status with GCP reports and bug fix milestones - Update system status doc v6.6 with IIT progress Tested: Backend compiles, frontend linter clean, batch QC verified Made-with: Cursor
This commit is contained in:
@@ -3,8 +3,14 @@
|
||||
> **文档版本:** v3.1
|
||||
> **创建日期:** 2026-01-01
|
||||
> **维护者:** IIT Manager开发团队
|
||||
> **最后更新:** 2026-03-01 **质控引擎 V3.1 架构升级计划定稿(五级数据结构 + 多维报告)**
|
||||
> **最后更新:** 2026-03-01 **GCP 业务报表 + AI 工作流水增强 + 多项 Bug 修复完成!**
|
||||
> **重大里程碑:**
|
||||
> - **2026-03-01:GCP 业务端报表全量完成!** 4 张 GCP 标准报表(D1 筛选入选/D2 完整性/D3D4 质疑跟踪/D6 方案偏离)后端 API + 前端组件 + ReportsPage 五 Tab 重构
|
||||
> - **2026-03-01:AI 工作流水时间线增强!** 实际规则数显示(33 条而非 1 条)+ 中文事件名 + 可展开问题详情表格 + severity 映射修复
|
||||
> - **2026-03-01:业务端一键全量质控!** DashboardPage 新增按钮 + 自动刷新报告缓存 + 事件级通过率修复
|
||||
> - **2026-03-01:多项关键 Bug 修复!** dimension_code→rule_category / D1 仅显示 1 人→14 人 / 时区 UTC→北京时间 / 通过率 271%→正确值
|
||||
> - **2026-03-01:B4 定时质控灵活配置完成!** 项目级 cron → pg-boss dispatcher 每分钟匹配 → QcExecutor.executeBatch → DailyQcOrchestrator
|
||||
> - **2026-03-01:V3.1 质控引擎全量完成!** 17 项任务全部实现:QcExecutor 统一入口 → D1-D7 全维度 → 三级聚合 → HealthScore → 前端驾驶舱 → 端到端测试
|
||||
> - **2026-03-01:质控引擎 V3.1 架构设计完成!** 五级数据结构(CDISC ODM)+ D1-D7 多维报告 + 三批次落地计划
|
||||
> - **2026-03-01:架构团队评审完成!** 采纳 InstanceID/规则分类/状态冒泡/LLM 三不原则,暂缓 SDV/自动映射/GCP 全量报表
|
||||
> - **2026-02-26:前端架构调整完成!** 运营管理端恢复 IIT 项目管理 + 业务端精简为日常使用 + Web AI 对话页面上线
|
||||
@@ -55,7 +61,26 @@ CRA Agent 是一个**替代 CRA 岗位的自主 AI Agent**,而非辅助 CRA
|
||||
- AI能力:DeepSeek/Qwen + 自研 RAG(pgvector)+ LLM Tool Use
|
||||
|
||||
### 当前状态
|
||||
- **开发阶段**:**V3.0 P0 + P1 已完成 → 正在规划 V3.1 质控引擎架构升级**
|
||||
- **开发阶段**:**V3.1 质控引擎 + GCP 业务报表 + AI 时间线增强 + Bug 修复 → 待部署验证**
|
||||
- **GCP 业务报表 + Bug 修复已完成**(2026-03-01):
|
||||
- 4 张 GCP 标准报表后端 API(iitQcCockpitService:getEligibilityReport/getCompletenessReport/getEqueryReport/getDeviationReport)
|
||||
- 4 个前端报表组件(EligibilityTable/CompletenessTable/EqueryLogTable/DeviationLogTable)
|
||||
- ReportsPage 五 Tab 重构(执行摘要 + 4 张报表)
|
||||
- AI 工作流水时间线增强(SkillRunner 真实规则数 + iitQcCockpitController severity 映射 + AiStreamPage 可展开详情表格)
|
||||
- 业务端一键全量质控按钮(DashboardPage + 报告缓存自动刷新)
|
||||
- Bug 修复:dimension_code→rule_category / D1 数据源→record_summary 全量 + qc_field_status 叠加 / 时区 UTC→Asia/Shanghai / 通过率 passed/totalEvents
|
||||
- **B4 已完成**(2026-03-01):
|
||||
- 项目级 cronExpression 持久化(后端 UpdateProjectInput + Prisma update)
|
||||
- 全局 dispatcher 调度器(pg-boss 每分钟轮询 → 匹配 cronExpression → 派发 iit_scheduled_qc)
|
||||
- iit_scheduled_qc Worker V3.1 升级(QcExecutor.executeBatch + DailyQcOrchestrator)
|
||||
- 前端管理端 cron 配置 UI 增强(6 个预设 + 自定义输入 + cronEnabled/cronExpression 类型修复)
|
||||
- 动态生效:保存项目配置后 refreshProjectCronSchedule() 即时反映
|
||||
- **V3.1 已完成**(2026-03-01):
|
||||
- P1: 后端集成(QcExecutor 统一入口 + D2/D6 维度引擎 + HealthScore 聚合)
|
||||
- P2: 报告升级(QcReportService 数据源切换 + dimension_summary/event_overview XML)
|
||||
- P3: API + 服务(新增 3 端点 + CockpitService 升级 + ToolsService 升级)
|
||||
- P4: 前端(DashboardPage 健康度+维度条 + 热力图 record×event + ReportsPage 维度/事件 Tab)
|
||||
- P5: 端到端测试脚本 + 部署清单
|
||||
- **V3.0 已完成**:
|
||||
- P0 自驱动质控流水线 + P1 对话层 Tool Use 改造 + E2E 54/54 通过
|
||||
- QC 系统深度修复(null tolerance + baseline merge + record-level pass rate + LLM 报告修正)
|
||||
@@ -82,10 +107,31 @@ CRA Agent 是一个**替代 CRA 岗位的自主 AI Agent**,而非辅助 CRA
|
||||
- ✅ **端到端测试通过**(REDCap → Node.js → 企业微信)
|
||||
- ✅ ~~AI对话集成完成(ChatService + SessionMemory)~~ → 已替换为 ChatOrchestrator
|
||||
|
||||
#### ✅ 已完成功能(GCP 业务报表 + AI 时间线 + Bug 修复 - 2026-03-01)
|
||||
- ✅ **GCP 标准报表(阶段 A 4 张)**:
|
||||
- D1 筛选入选表(getEligibilityReport:record_summary 全量 + qc_field_status D1 叠加)
|
||||
- D2 数据录入率与缺失率(getCompletenessReport:record_summary 聚合统计)
|
||||
- D3/D4 数据质疑跟踪表(getEqueryReport:qc_field_status severity 分布)
|
||||
- D6 方案偏离表(getDeviationReport:qc_field_status D6 维度)
|
||||
- ✅ **前端 4 个报表组件**(EligibilityTable / CompletenessTable / EqueryLogTable / DeviationLogTable)
|
||||
- ✅ **ReportsPage 五 Tab 重构**(执行摘要 LLM + 4 张报表独立 Tab)
|
||||
- ✅ **AI 工作流水时间线增强**:
|
||||
- SkillRunner 输出 totalRules(33 条真实规则数替代 1 条 skill 数)
|
||||
- iitQcCockpitController severity 映射修复(critical→red / warning→yellow)
|
||||
- AiStreamPage 可展开 Collapse 详情表格(规则名/字段/描述/严重性/实际值)
|
||||
- 中文事件名显示(eventLabel)+ 状态标签中文化(通过/严重/警告)
|
||||
- ✅ **业务端一键全量质控**(DashboardPage SyncOutlined 按钮 + batchQualityCheck API 调用)
|
||||
- ✅ **报告缓存自动刷新**(iitBatchController 批量 QC 后调用 QcReportService.refreshReport)
|
||||
- ✅ **Bug 修复**:
|
||||
- dimension_code→rule_category(iitQcCockpitService 4 处 SQL)
|
||||
- D1 筛选入选仅 1 人→14 人(数据源从 qc_field_status 改为 record_summary 全量)
|
||||
- 时区 UTC→北京时间(QcReportService toBeijingTime + buildLlmXmlReport Asia/Shanghai)
|
||||
- 通过率 271%→正确值(iitBatchController passed/totalEvents 替代 passed/totalRecords)
|
||||
|
||||
#### ✅ 已完成功能(P0 自驱动质控流水线 - 2026-02-26)
|
||||
- ✅ **变量清单导入**(REDCap Data Dictionary → iit_field_metadata)
|
||||
- ✅ **规则配置增强**(4 类规则 + AI 辅助建议 + 变量关联)
|
||||
- ✅ **定时质控调度**(pg-boss cron + DailyQcOrchestrator)
|
||||
- ✅ **定时质控调度**(pg-boss cron dispatcher + 项目级 cronExpression + DailyQcOrchestrator)
|
||||
- ✅ **eQuery 闭环**(open → responded → ai_reviewing → resolved/reopened)
|
||||
- ✅ **重大事件归档**(SAE + 方案偏离自动归档 iit_critical_events)
|
||||
- ✅ **统一驾驶舱**(健康分 + 趋势图 + 风险热力图 + 核心指标卡片)
|
||||
@@ -908,8 +954,8 @@ npx ts-node src/modules/iit-manager/test-wechat-push.ts
|
||||
---
|
||||
|
||||
> **提示**:本文档反映IIT Manager Agent模块的最新真实状态,每个里程碑完成后必须更新!
|
||||
> **最后更新**:2026-02-25
|
||||
> **当前进度**:V3.0 开发计划已定稿 | 下一步:P0-1 ChatOrchestrator + ToolsService 重构
|
||||
> **最后更新**:2026-03-01
|
||||
> **当前进度**:V3.1 QC Engine 完成 | GCP 业务报表 4 张全量完成 | AI Timeline 增强 | 一键全量质控 | 多项 Bug 修复 | Phase 2: LLM 执行摘要待开发
|
||||
> **核心文档**:
|
||||
> - [CRA Agent V3.0 开发计划](./04-开发计划/V3.0全新开发计划/V3.0全新开发计划.md) ⭐⭐⭐⭐⭐
|
||||
> - [统一数字 CRA 质控平台 PRD](./04-开发计划/V3.0全新开发计划/统一数字%20CRA%20质控平台产品需求文档(PRD).md) ⭐⭐⭐⭐⭐
|
||||
|
||||
Reference in New Issue
Block a user