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:
2026-03-01 22:49:49 +08:00
parent 0b29fe88b5
commit 2030ebe28f
50 changed files with 8687 additions and 1492 deletions

View File

@@ -3,8 +3,14 @@
> **文档版本:** v3.1
> **创建日期:** 2026-01-01
> **维护者:** IIT Manager开发团队
> **最后更新:** 2026-03-01 **质控引擎 V3.1 架构升级计划定稿(五级数据结构 + 多维报告)**
> **最后更新:** 2026-03-01 **GCP 业务报表 + AI 工作流水增强 + 多项 Bug 修复完成!**
> **重大里程碑:**
> - **2026-03-01GCP 业务端报表全量完成!** 4 张 GCP 标准报表D1 筛选入选/D2 完整性/D3D4 质疑跟踪/D6 方案偏离)后端 API + 前端组件 + ReportsPage 五 Tab 重构
> - **2026-03-01AI 工作流水时间线增强!** 实际规则数显示33 条而非 1 条)+ 中文事件名 + 可展开问题详情表格 + severity 映射修复
> - **2026-03-01业务端一键全量质控** DashboardPage 新增按钮 + 自动刷新报告缓存 + 事件级通过率修复
> - **2026-03-01多项关键 Bug 修复!** dimension_code→rule_category / D1 仅显示 1 人→14 人 / 时区 UTC→北京时间 / 通过率 271%→正确值
> - **2026-03-01B4 定时质控灵活配置完成!** 项目级 cron → pg-boss dispatcher 每分钟匹配 → QcExecutor.executeBatch → DailyQcOrchestrator
> - **2026-03-01V3.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 + 自研 RAGpgvector+ LLM Tool Use
### 当前状态
- **开发阶段****V3.0 P0 + P1 已完成 → 正在规划 V3.1 质控引擎架构升级**
- **开发阶段****V3.1 质控引擎 + GCP 业务报表 + AI 时间线增强 + Bug 修复 → 待部署验证**
- **GCP 业务报表 + Bug 修复已完成**2026-03-01
- 4 张 GCP 标准报表后端 APIiitQcCockpitServicegetEligibilityReport/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 筛选入选表getEligibilityReportrecord_summary 全量 + qc_field_status D1 叠加)
- D2 数据录入率与缺失率getCompletenessReportrecord_summary 聚合统计)
- D3/D4 数据质疑跟踪表getEqueryReportqc_field_status severity 分布)
- D6 方案偏离表getDeviationReportqc_field_status D6 维度)
-**前端 4 个报表组件**EligibilityTable / CompletenessTable / EqueryLogTable / DeviationLogTable
-**ReportsPage 五 Tab 重构**(执行摘要 LLM + 4 张报表独立 Tab
-**AI 工作流水时间线增强**
- SkillRunner 输出 totalRules33 条真实规则数替代 1 条 skill 数)
- iitQcCockpitController severity 映射修复critical→red / warning→yellow
- AiStreamPage 可展开 Collapse 详情表格(规则名/字段/描述/严重性/实际值)
- 中文事件名显示eventLabel+ 状态标签中文化(通过/严重/警告)
-**业务端一键全量质控**DashboardPage SyncOutlined 按钮 + batchQualityCheck API 调用)
-**报告缓存自动刷新**iitBatchController 批量 QC 后调用 QcReportService.refreshReport
-**Bug 修复**
- dimension_code→rule_categoryiitQcCockpitService 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) ⭐⭐⭐⭐⭐