fix(aia,ssa,asl,infra): harden SSE transport and stabilize attachment context

Deliver SSE protocol hardening for SAE/HTTP2 paths, add graceful shutdown health behavior, and improve SSA retry UX for transient stream failures. For AIA, persist attachment extraction results in database with cache read-through fallback, plus production cache safety guard to prevent memory-cache drift in multi-instance deployments; also restore ASL SR page scrolling behavior. Made-with: Cursor
2026-03-09 18:45:12 +08:00
parent 50657dd81f
commit 5c5fec52c1
27 changed files with 807 additions and 100 deletions
--- a/docs/05-部署文档/0309部署/01-数据库部署完成总结.md
+++ b/docs/05-部署文档/0309部署/01-数据库部署完成总结.md
@@ -0,0 +1,182 @@
+# 2026年3月9日部署完成总结
+
+> **部署日期**：2026-03-09  
+> **部署范围**：数据库迁移（4项） + 种子数据（3项） + R统计引擎 + Node.js后端 + 前端Nginx  
+> **部署状态**：✅ 全部完成  
+> **文档日期**：2026-03-09
+
+---
+
+## 部署成果一览
+
+### 服务版本对比
+
+| 服务 | 部署前 | 部署后 | 变更类型 |
+|------|--------|--------|---------|
+| PostgreSQL（RDS） | 20/24 迁移 | **24/24 迁移** | 4 个 Prisma 迁移 + 3 个种子脚本 |
+| R统计引擎 | v1.0.1 | **v1.0.2** | 新增 execute-code + 错误处理 + AST 预检 |
+| Node.js后端 | v2.8 | **v2.9** | 13 项后端变更（RVW/SSA/IIT/认证） |
+| 前端Nginx | v2.5 | **v2.6** | 10 项前端变更（ASL/RVW/SSA/IIT/心跳） |
+| Python微服务 | v1.2 | v1.2（不变） | 无变更 |
+
+### 内网地址变更
+
+| 服务 | 部署前地址 | 部署后地址 | 状态 |
+|------|-----------|-----------|------|
+| R统计引擎 | `172.17.173.101:8080` | `172.17.197.22:8080` | ✅ 已变更 |
+| Node.js后端 | `172.17.173.106:3001` | `172.17.173.108:3001` | ✅ 已变更 |
+| 前端Nginx | `172.17.173.107:80` | `172.17.197.23:80` | ✅ 已变更 |
+| Python微服务 | `172.17.173.102:8000` | `172.17.173.102:8000` | 不变 |
+
+---
+
+## 一、数据库部署
+
+### 1.1 部署前准备
+
+| 项目 | 值 |
+|------|---|
+| 备份方式 | `pg_dump --format=custom` via Docker 容器 |
+| 备份文件 | `backup_before_0309_deploy.dump` |
+| 文件大小 | 46.9 MB |
+| 备份时间 | 2026-03-09 08:05 |
+
+### 1.2 Prisma 迁移（4 项）
+
+使用 `npx prisma migrate deploy`（生产命令）执行。
+
+| 序号 | 迁移名称 | 对应清单 | 变更内容 | 结果 |
+|------|---------|---------|---------|------|
+| 1 | `20260307_add_error_details_to_review_task` | DB-3 | `rvw_schema.review_tasks` 新增 `error_details` JSONB 列 | ✅ |
+| 2 | `20260308_add_iit_equery_open_dedupe_guard` | DB-6 | 历史重复 open eQuery 收敛为 `auto_closed` + 部分唯一索引 | ✅ |
+| 3 | `20260308_default_agent_mode` | DB-4 | `ssa_sessions.execution_mode` 默认值改为 `agent` + 21 条旧数据更新 | ✅ |
+| 4 | `20260309_add_token_version_to_platform_users` | DB-7 | `platform_schema.users` 新增 `token_version` INTEGER 列（默认 0） | ✅ |
+
+### 1.3 种子数据（3 项）
+
+| 序号 | 脚本 | 对应清单 | 内容 | 结果 |
+|------|------|---------|------|------|
+| 1 | `npx tsx scripts/seed-modules.js` | DB-1 | upsert 11 个 modules（新增 ASL_SR） | ✅ |
+| 2 | `npx tsx scripts/migrate-rvw-prompts.ts` | DB-2 | upsert 4 个 RVW Prompt（新增 DATA_VALIDATION + CLINICAL） | ✅ |
+| 3 | `npx tsx prisma/seed-ssa-agent-prompts.ts` | DB-5 | upsert 2 个 SSA Agent Prompt（PLANNER + CODER） | ✅ |
+
+### 1.4 数据库最终状态
+
+| 项目 | 值 |
+|------|---|
+| Prisma 迁移 | 24/24 ✅（本地与 RDS 完全同步） |
+| Schema 数 | 16 |
+| modules 模块数 | 11（含 ASL_SR） |
+| RVW Prompt 模板 | 4（含 DATA_VALIDATION + CLINICAL） |
+| SSA Agent Prompt | 2（PLANNER + CODER） |
+
+---
+
+## 二、R 统计引擎更新（v1.0.1 → v1.0.2）
+
+| 项目 | 值 |
+|------|---|
+| ACR 仓库 | `ssa-r-statistics` |
+| 镜像版本 | v1.0.1 → **v1.0.2** |
+| Digest | `sha256:7c24b688ee7e5e1e61d6f2821902ab825efc5a4113d0f99f92d9c63deebcd79d` |
+| 内网地址 | `http://172.17.197.22:8080` |
+
+变更内容（3 项）：
+- ✅ R-1：新增 POST `/api/v1/execute-code` 端点（Agent 通道任意 R 代码执行）
+- ✅ R-2：Agent 结构化错误处理增强（20+ 模式匹配 + format_agent_error）
+- ✅ R-3：AST 语法预检（parse() 前置于 eval()）
+
+---
+
+## 三、Node.js 后端更新（v2.8 → v2.9）
+
+| 项目 | 值 |
+|------|---|
+| ACR 仓库 | `backend-service` |
+| 镜像版本 | v2.8 → **v2.9** |
+| Digest | `sha256:b28b14e4f7aec66102e7e039d6d910c1e957c7903329d1ba6b4ac20ebbd078f9` |
+| 内网地址 | `http://172.17.173.108:3001` |
+
+变更内容（13 项）：
+- ✅ BE-1：Deep Research V2.0 历史列表 + 删除接口 + getTask 鉴权修复
+- ✅ BE-2：SR 相关路由增加 `requireModule('ASL_SR')` 中间件
+- ✅ BE-3：Unifuncs DeepSearch API S2 → S3（新增 `language: "zh"`）
+- ✅ BE-4：RVW 数据验证增加 LLM 核查通道
+- ✅ BE-5：RVW 新增临床专业评估维度（ClinicalAssessmentSkill）
+- ✅ BE-6：RVW 稳定性增强（Promise.allSettled + partial_completed）
+- ✅ BE-7：DataForensicsSkill LLM 核查独立 60s 超时
+- ✅ BE-8：SSA Agent 通道体验优化（方案 B + 10 项 Bug 修复）
+- ✅ BE-9：Phase 5A CoderAgent 防错护栏（4 项改动）
+- ✅ BE-10：SSA Agent Prompt 接入运营管理端（三级容灾）
+- ✅ BE-11：IIT eQuery 幂等写入 + 去重工具脚本
+- ✅ BE-12：IIT 事件名称友好化 + AI 对话证据块补齐
+- ✅ BE-13：认证链路改造为数据库强一致互踢（tokenVersion）
+
+---
+
+## 四、前端 Nginx 更新（v2.5 → v2.6）
+
+| 项目 | 值 |
+|------|---|
+| ACR 仓库 | `ai-clinical_frontend-nginx` |
+| 镜像版本 | v2.5 → **v2.6** |
+| Digest | `sha256:da4c9fcfe135b25bcac5143e3f919d8a3a205f53d8b0e930e32f6b8325d2cb70` |
+| 内网地址 | `http://172.17.197.23:80` |
+
+变更内容（10 项）：
+- ✅ FE-1：ASL 左侧导航栏重构为互斥手风琴
+- ✅ FE-2：Deep Research 历史记录功能
+- ✅ FE-3：Panel B SR 工具导航权限控制
+- ✅ FE-4：RVW 数据验证报告增加 LLM 核查结果展示
+- ✅ FE-5：RVW 新增临床专业评估 Tab + Agent 选择项
+- ✅ FE-6：RVW 前端支持 partial_completed 状态
+- ✅ FE-7：SSA Agent 通道体验优化（方案 B + 动态 UI）
+- ✅ FE-8：SSA 默认 Agent 模式 + 查看代码修复 + 分析历史卡片
+- ✅ FE-9：IIT D1 筛选入选表规则名称友好显示
+- ✅ FE-10：全局会话心跳（10s）提升互踢感知时效
+
+---
+
+## 五、环境变量联动更新
+
+| 服务 | 环境变量 | 旧值 | 新值 |
+|------|---------|------|------|
+| nodejs-backend-test | `R_SERVICE_URL` | `http://172.17.173.101:8080` | `http://172.17.197.22:8080` |
+| frontend-nginx-service | `BACKEND_SERVICE_HOST` | `172.17.173.106` | `172.17.173.108` |
+
+> CLB 负载均衡器由阿里云自动更新，无需手动操作。
+
+---
+
+## 六、当前系统配置速查
+
+### 服务内网地址
+
+```
+R统计引擎: http://172.17.197.22:8080   (更新)
+Python:    http://172.17.173.102:8000  (不变)
+后端:      http://172.17.173.108:3001  (更新)
+前端:      http://172.17.197.23:80     (更新)
+```
+
+### ACR 镜像版本
+
+| 仓库 | 版本 |
+|------|-----|
+| `ssa-r-statistics` | **v1.0.2** |
+| `python-extraction` | v1.2 |
+| `backend-service` | **v2.9** |
+| `ai-clinical_frontend-nginx` | **v2.6** |
+
+### 公网访问
+
+```
+CLB:  http://8.140.53.236/
+域名: https://iit.xunzhengyixue.com/
+```
+
+---
+
+> **文档版本**：v2.0  
+> **最后更新**：2026-03-09  
+> **维护人员**：开发团队