# 待部署变更清单

> **用途**: 开发过程中实时记录所有待部署的变更，下次部署时按此清单逐项执行  
> **维护规则**: 每次修改 Schema / 新增依赖 / 改配置时，**立即**在此文档追加记录  
> **Cursor Rule**: `.cursor/rules/deployment-change-tracking.mdc` 会自动提醒  
> **最后清零**: 2026-03-16（0316 部署完成后清零）  
> **本次变更**: 无（当前待部署清单已清零）

---

## 当前待部署变更

> ⚠️ 下次部署前，逐项检查此清单。部署完成后将已部署项移到「历史」区域并清零。

### 数据库变更

| # | 变更内容 | 迁移文件 | 优先级 | 备注 |
|---|---------|---------|--------|------|
| — | *暂无* | | | |

### 后端变更 (Node.js)

| # | 变更内容 | 涉及文件 | 需要操作 | 备注 |
|---|---------|---------|---------|------|
| — | *暂无* | | | |

### 前端变更

| # | 变更内容 | 涉及文件 | 需要操作 | 备注 |
|---|---------|---------|---------|------|
| — | *暂无* | | | |

### Python 微服务变更

| # | 变更内容 | 涉及文件 | 需要操作 | 备注 |
|---|---------|---------|---------|------|
| — | *暂无* | | | |

### R 统计引擎变更

| # | 变更内容 | 涉及文件 | 需要操作 | 备注 |
|---|---------|---------|---------|------|
| — | *暂无* | | | |

### 环境变量 / 配置变更

| # | 变更内容 | 服务 | 变量名 | 备注 |
|---|---------|------|--------|------|
| — | *暂无* | | | |

### 基础设施变更

| # | 变更内容 | 范围 | 备注 |
|---|---------|------|------|
| — | *暂无* | | |

---

## 上线后快速验收（运维执行）

> 目标：确认 `review.xunzhengyixue.com` 已真正接入 RVW 租户审稿链路，而非仅页面可访问。

1. **前端深链验证（无缓存）**
   - 隐身窗口访问：`https://review.xunzhengyixue.com/{tenantCode}/login`
   - 登录后应进入：`https://review.xunzhengyixue.com/{tenantCode}/rvw`
   - 直接刷新 `/{tenantCode}/rvw` 不应 404（验证 Nginx SPA 回退生效）

2. **API 代理验证**
   - 在浏览器 Network 确认 `/api/v1/auth/*`、`/api/rvw/*` 均返回后端响应（非前端静态 200 HTML）
   - 若返回 HTML 或 404，优先检查 ingress/Nginx `/api` 反代优先级

3. **租户权限验证（业务可用性）**
   - 运营端确认目标租户已开通 `RVW` 模块（`tenant_modules`）
   - 运营端确认用户已分配到该租户（`tenant_members`）
   - 若登录后提示“暂无访问智能审稿模块权限”，先查租户模块与用户模块覆盖关系

4. **验证码链路验证**
   - `验证码发送成功 + 倒计时启动 + 登录成功` 需完整通过
   - 弱网场景若偶发失败，先排查网络/网关，再看后端日志；前端已增加“发送中”防重入保护

5. **中英稿约语言链路验证（新增）**
   - 在任务发起弹窗中确认“稿约基线语言”默认值与租户语言一致（中文期刊默认中文，英文期刊默认英文）
   - 手动切换语言后执行审稿，确认稿约模块按所选语言输出，且任务状态不出现解析失败导致的 `partial_completed`

6. **JSON 解析稳态验证（新增）**
   - 分别用中文/英文稿件各执行至少 3 次“稿约规范性 + 方法学”组合，确认无 `无法从LLM响应中解析JSON` / `section repair invalid`
   - 如出现兜底修复日志（warn）但任务完成，可判定为“已自动恢复”；若连续失败，再排查模型配额/网络超时/提示词内容

---

## 记录模板

开发时发现需要部署的变更，复制下方模板追加到对应区域：

```markdown
<!-- 数据库变更 -->
| DB-N | 简述变更 | `迁移文件名` | 高/中/低 | 备注 |

<!-- 后端变更 -->
| BE-N | 简述变更 | `file.ts` | 重新构建镜像 | 备注 |

<!-- 前端变更 -->
| FE-N | 简述变更 | `Component.tsx` | 重新构建镜像 | 备注 |

<!-- Python 变更 -->
| PY-N | 简述变更 | `requirements-prod.txt` | 重新构建镜像 | 备注 |

<!-- R 变更 -->
| R-N | 简述变更 | `tool.R` | 重新构建镜像 | 备注 |

<!-- 环境变量 -->
| ENV-N | 简述变更 | nodejs-backend-test | `VAR_NAME=value` | 备注 |
```

---

## 历史（已部署，仅供追溯）

### 0316 部署已清零项

| # | 变更内容 | 部署日期 | 结果 |
|---|---------|---------|------|
| DB | DB-1~DB-4 全量完成（SSA 分步审计字段 + RVW 租户配置 + review_tasks.tenant_id 回填 + JOURNAL/MVP 字段） | 2026-03-16 | ✅ |
| BE | 后端 v2.11 → v2.12（含 BE-10 JSON 解析稳态加固与观测日志） | 2026-03-16 | ✅ |
| FE | 前端 v2.8 → v2.9（含 FE-9 稿约基线语言任务级选择） | 2026-03-16 | ✅ |
| PY | Python 提取服务镜像构建并推送 v1.3（与 RVW LLM-only 路径配套） | 2026-03-16 | ✅ |
| R | R 统计引擎镜像构建并推送 v1.0.6（语法+安全预检） | 2026-03-16 | ✅ |
| ENV | nodejs-backend-test 新增 `RVW_FORENSICS_RULES_ENABLED=false` | 2026-03-16 | ✅ |
| ENV | frontend-nginx-service: `BACKEND_SERVICE_HOST` 更新为 `172.17.197.30` | 2026-03-16 | ✅ |
| INF | `review.xunzhengyixue.com` 链路发布：深链回退 + `/api` 反代优先级 + 租户路由可用 | 2026-03-16 | ✅ |

### 0310 部署已清零项

| # | 变更内容 | 部署日期 | 结果 |
|---|---------|---------|------|
| DB | 新增 `user_permissions` 表（`20260309_add_user_permissions_table`） | 2026-03-10 | ✅ |
| DB | Seed 权限 `ops:user-ops` | 2026-03-10 | ✅ |
| BE | 后端 v2.10 → v2.11（用户直授权限、运营埋点与看板、AIA 附件与 RVW 提速等） | 2026-03-10 | ✅ |
| FE | 前端 v2.7 → v2.8（运营端权限入口、用户运营权限开关、看板增强、AIA/RVW 体验优化） | 2026-03-10 | ✅ |
| ENV | frontend-nginx-service: `BACKEND_SERVICE_HOST` → `172.17.173.110` | 2026-03-10 | ✅ |

### 0309 二次部署已清零项

| # | 变更内容 | 部署日期 | 结果 |
|---|---------|---------|------|
| DB | AIA 新增 `attachments` 持久化表（`20260309_add_aia_attachments_persistence`） | 2026-03-09 | ✅ |
| R | v1.0.2 → v1.0.5（包诊断接口、构建期缺包校验、错误映射修复、`%||%` 修复） | 2026-03-09 | ✅ |
| BE | v2.9 → v2.10（SSE/优雅停机/AIA附件/短信能力等变更） | 2026-03-09 | ✅ |
| FE | v2.6 → v2.7（SSE 代理与友好重试体验优化） | 2026-03-09 | ✅ |
| ENV | nodejs-backend-test: `R_SERVICE_URL` → `http://172.17.197.26:8080` | 2026-03-09 | ✅ |
| ENV | frontend-nginx-service: `BACKEND_SERVICE_HOST` → `172.17.173.109` | 2026-03-09 | ✅ |

### 0309 部署已清零项

| # | 变更内容 | 部署日期 | 结果 |
|---|---------|---------|------|
| DB | 4 个 Prisma 迁移（error_details + eQuery 去重 + agent 默认 + token_version） | 2026-03-09 | ✅ |
| DB | 3 个种子脚本（modules ASL_SR + RVW Prompt×2 + SSA Agent Prompt×2） | 2026-03-09 | ✅ |
| R | R 统计引擎 v1.0.1 → v1.0.2（execute-code + 错误处理 + AST 预检，3 项变更） | 2026-03-09 | ✅ |
| BE | Node.js v2.8 → v2.9（Deep Research V2 + RVW 4维 + SSA Agent + IIT 幂等 + 认证互踢，13 项变更） | 2026-03-09 | ✅ |
| FE | 前端 v2.5 → v2.6（ASL 手风琴 + RVW 4Tab + SSA Agent UI + 全局心跳，10 项变更） | 2026-03-09 | ✅ |
| ENV | nodejs-backend-test: R_SERVICE_URL → http://172.17.197.22:8080 | 2026-03-09 | ✅ |
| ENV | frontend-nginx-service: BACKEND_SERVICE_HOST → 172.17.173.108 | 2026-03-09 | ✅ |

### 0305 部署已清零项

| # | 变更内容 | 部署日期 | 结果 |
|---|---------|---------|------|
| DB | modules 表 seed 更新（新增 RM、AIA_PROTOCOL，IIT→CRA质控） | 2026-03-05 | ✅ |
| BE | Node.js v2.4 → v2.6（登录踢人 + 权限体系 + SSA双通道 + 批量导入，9 项变更） | 2026-03-05 | ✅ |
| FE | 前端 v2.0 → v2.3（ASL/AIA/PKB UI优化 + 权限适配 + 批量导入重构，11 项变更） | 2026-03-05 | ✅ |
| ENV | frontend-nginx-service: BACKEND_SERVICE_HOST → 172.17.197.36 | 2026-03-05 | ✅ |
| DB | SSA 双通道：ssa_sessions 新增 execution_mode + ssa_agent_executions 表 | 2026-03-05 | ✅ 热修 |
| BE | Node.js v2.6 → v2.7（bug 修复，基于测试反馈） | 2026-03-05 | ✅ 二次部署 |
| FE | 前端 v2.3 → v2.4（bug 修复，基于测试反馈） | 2026-03-05 | ✅ 二次部署 |
| ENV | frontend-nginx-service: BACKEND_SERVICE_HOST → 172.17.197.37 | 2026-03-05 | ✅ 二次部署 |
| BE | Node.js v2.7 → v2.8（bug 修复） | 2026-03-05 | ✅ 三次部署 |
| FE | 前端 v2.4 → v2.5（bug 修复） | 2026-03-05 | ✅ 三次部署 |
| ENV | frontend-nginx-service: BACKEND_SERVICE_HOST → 172.17.173.106 | 2026-03-05 | ✅ 三次部署 |

### 0302 部署已清零项

| # | 变更内容 | 部署日期 | 结果 |
|---|---------|---------|------|
| DB | 6 个 Prisma 迁移（SSA 类型对齐 + IIT RBAC + is_demo + V3.1 QC 三批） | 2026-03-02 | ✅ |
| DB | 新建 qc_field_status、qc_event_status 2 张表（84 → 86） | 2026-03-02 | ✅ |
| BE | Node.js v2.3 → v2.4（IIT V3.1 QC引擎全面升级，27 项变更） | 2026-03-02 | ✅ |
| FE | 前端 v1.9 → v2.0（GCP 报表 + V3.1 前端，17 项变更） | 2026-03-02 | ✅ |
| ENV | frontend-nginx-service: BACKEND_SERVICE_HOST → 172.17.197.32 | 2026-03-02 | ✅ |

### 0227 部署已清零项

| # | 变更内容 | 部署日期 | 结果 |
|---|---------|---------|------|
| DB | 5 个业务迁移 + 1 个 drift patch | 2026-02-27 | ✅ |
| DB | SSA data_profile 列补充 | 2026-02-27 | ✅ 线上热修 |
| DB | RVW review_tasks 8 列补充 | 2026-02-27 | ✅ 线上热修 |
| BE | Node.js v1.7 → v2.2（SSA/ASL/RVW/IIT 全模块更新） | 2026-02-27 | ✅ |
| BE | Dockerfile 增加 JSON 配置文件拷贝 | 2026-02-27 | ✅ |
| FE | 前端 v1.3 → v1.8（react-markdown, nginx 配置更新） | 2026-02-27 | ✅ |
| PY | Python v1.1 → v1.2（新增 scipy） | 2026-02-27 | ✅ |
| R | R 统计引擎 v1.0.1 全新部署 | 2026-02-27 | ✅ |
| ENV | nodejs-backend-test: R_STATISTICS_SERVICE_URL 等 | 2026-02-27 | ✅ |
| ENV | frontend-nginx-service: BACKEND_SERVICE_HOST 更新 | 2026-02-27 | ✅ |