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:
2026-03-08 21:54:35 +08:00
parent ac724266c1
commit a666649fd4
57 changed files with 28637 additions and 316 deletions

View File

@@ -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-08IIT 回归修复收口!** 实时工作流事件名友好化含兜底、D1 不合规条目显示规则名称、AI 对话新增“证据不为空”补齐逻辑
> - **2026-03-02QC 数据一致性修复!** AI 时间线 + 警告详情 统一从 qc_field_statusSSOT读取与热力图数据一致
> - **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 + 自研 RAGpgvector+ LLM Tool Use
### 当前状态
- **开发阶段****V3.2 数据一致性 + 项目隔离 + 管理端重设计 + 中文显示名 → 待部署验证**
- **开发阶段****V3.3 回归修复收口(可读性 + 证据兜底)→ 待部署验证**
- **V3.2 数据一致性 + 项目隔离已完成**2026-03-02
- AI 时间线改为从 qc_field_statusSSOT聚合与风险热力图数据一致
- 新增 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 筛选入选表getEligibilityReportrecord_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-08IIT 回归修复收口(可读性 + AI 证据兜底) ⚙️
**完成内容**
- ✅ AI 实时工作流详情事件名增强:数据库标签 + 规则缓存标签 + 可读兜底
- ✅ D1 受试者逐条判定“不合规条目”改为规则名称优先显示
- ✅ AI 对话“结论有、证据空”补齐逻辑加强(覆盖项目级问句)
- ✅ 文档同步:新增当日开发记录,更新模块状态与待部署清单
**状态结论**
- 代码侧修复已完成并通过静态检查
- 仍需部署后结合线上进程状态完成最终验收
### 2026-01-04Dify知识库集成完成 - 混合检索实现 ✅
**完成内容**