feat(iit): harden QC pipeline consistency and release artifacts
Implement IIT quality workflow hardening across eQuery deduplication, guard metadata validation, timeline/readability improvements, and chat evidence fallbacks, then synchronize release and development documentation for deployment handoff. Includes migration/scripts for open eQuery dedupe guards, orchestration/status semantics, report/tool readability fixes, and updated module status plus deployment checklist. Made-with: Cursor
This commit is contained in:
@@ -1,10 +1,11 @@
|
||||
# IIT Manager Agent模块 - 当前状态与开发指南
|
||||
|
||||
> **文档版本:** v3.2
|
||||
> **文档版本:** v3.3
|
||||
> **创建日期:** 2026-01-01
|
||||
> **维护者:** IIT Manager开发团队
|
||||
> **最后更新:** 2026-03-02 **数据一致性修复 + 项目隔离 + 管理端配置流重设计 + 中文显示名!**
|
||||
> **最后更新:** 2026-03-08 **IIT 回归修复收口(事件名中文化、D1 规则名友好显示、AI 证据兜底)**
|
||||
> **重大里程碑:**
|
||||
> - **2026-03-08:IIT 回归修复收口!** 实时工作流事件名友好化(含兜底)、D1 不合规条目显示规则名称、AI 对话新增“证据不为空”补齐逻辑
|
||||
> - **2026-03-02:QC 数据一致性修复!** AI 时间线 + 警告详情 统一从 qc_field_status(SSOT)读取,与热力图数据一致
|
||||
> - **2026-03-02:字段/事件中文显示名!** LEFT JOIN field_metadata + qc_event_status,消除 REDCap 技术标识符
|
||||
> - **2026-03-02:警告详情可查看!** 新增 field-issues 分页 API + ReportsPage 严重问题/警告数字可点击弹出详情 Modal
|
||||
@@ -66,7 +67,7 @@ CRA Agent 是一个**替代 CRA 岗位的自主 AI Agent**,而非辅助 CRA
|
||||
- AI能力:DeepSeek/Qwen + 自研 RAG(pgvector)+ LLM Tool Use
|
||||
|
||||
### 当前状态
|
||||
- **开发阶段**:**V3.2 数据一致性 + 项目隔离 + 管理端重设计 + 中文显示名 → 待部署验证**
|
||||
- **开发阶段**:**V3.3 回归修复收口(可读性 + 证据兜底)→ 待部署验证**
|
||||
- **V3.2 数据一致性 + 项目隔离已完成**(2026-03-02):
|
||||
- AI 时间线改为从 qc_field_status(SSOT)聚合,与风险热力图数据一致
|
||||
- 新增 field-issues 分页查询 API(支持按维度/严重程度/受试者筛选)
|
||||
@@ -152,6 +153,18 @@ CRA Agent 是一个**替代 CRA 岗位的自主 AI Agent**,而非辅助 CRA
|
||||
- iitBatchController 执行 QcExecutor.executeBatch 后调用 DailyQcOrchestrator.orchestrate
|
||||
- 返回 equeriesCreated 计数
|
||||
|
||||
#### ✅ 已完成功能(V3.3 回归修复收口 - 2026-03-08)
|
||||
- ✅ **AI 实时工作流事件名友好化补强**:
|
||||
- `getTimeline` 增加事件标签聚合映射(`qc_event_status` + `cachedRules.eventLabels`)
|
||||
- 无标签时采用 `访视(eventId)` 兜底,避免裸露技术 ID
|
||||
- ✅ **D1 筛选入选表“不合规条目”友好显示**:
|
||||
- 前端由 `ruleId` 改为优先显示 `ruleName`
|
||||
- ✅ **AI 对话“证据为空”结构性兜底**:
|
||||
- 对话编排层改为“只要回答中出现 `证据:` 且无条目,即强制补齐”
|
||||
- 新增项目级 summary 证据抽取(健康度、总受试者、严重/警告问题数、通过率)
|
||||
- ⚠️ **当前风险提示**:
|
||||
- 用户反馈“问题仍在”,需在线上运行态做最终复核(可能涉及服务未重启或旧进程实例)
|
||||
|
||||
#### ✅ 已完成功能(GCP 业务报表 + AI 时间线 + Bug 修复 - 2026-03-01)
|
||||
- ✅ **GCP 标准报表(阶段 A 4 张)**:
|
||||
- D1 筛选入选表(getEligibilityReport:record_summary 全量 + qc_field_status D1 叠加)
|
||||
@@ -796,11 +809,24 @@ npx ts-node src/modules/iit-manager/test-wechat-push.ts
|
||||
### 9.4 开发记录文档
|
||||
|
||||
- [V1.1更新完成报告](./06-开发记录/V1.1更新完成报告.md) - 技术方案更新记录
|
||||
- [2026-03-08-IIT-CRA-回归修复与发布收口记录](./06-开发记录/2026-03-08-IIT-CRA-回归修复与发布收口记录.md) - 今日收口与发布前状态
|
||||
|
||||
---
|
||||
|
||||
## 🔄 十、更新日志
|
||||
|
||||
### 2026-03-08:IIT 回归修复收口(可读性 + AI 证据兜底) ⚙️
|
||||
|
||||
**完成内容**:
|
||||
- ✅ AI 实时工作流详情事件名增强:数据库标签 + 规则缓存标签 + 可读兜底
|
||||
- ✅ D1 受试者逐条判定“不合规条目”改为规则名称优先显示
|
||||
- ✅ AI 对话“结论有、证据空”补齐逻辑加强(覆盖项目级问句)
|
||||
- ✅ 文档同步:新增当日开发记录,更新模块状态与待部署清单
|
||||
|
||||
**状态结论**:
|
||||
- 代码侧修复已完成并通过静态检查
|
||||
- 仍需部署后结合线上进程状态完成最终验收
|
||||
|
||||
### 2026-01-04:Dify知识库集成完成 - 混合检索实现 ✅
|
||||
|
||||
**完成内容**:
|
||||
|
||||
Reference in New Issue
Block a user