# 2026年3月5日部署完成总结

> **部署日期**：2026-03-05  
> **部署范围**：数据库数据更新（1项） + Node.js后端 + 前端Nginx + R统计引擎待部署  
> **部署状态**：✅ 后端/前端已完成  
> **文档日期**：2026-03-05

---

## 部署成果一览

### 服务版本对比

| 服务 | 部署前 | 部署后 | 变更类型 |
|------|--------|--------|---------|
| PostgreSQL（RDS） | 86 表 | 86 表（数据更新） | modules 表 seed 更新 |
| Node.js后端 | v2.4 | **v2.6** | 登录踢人 + 权限体系 + SSA双通道 |
| 前端Nginx | v2.0 | **v2.3** | UI优化 + 权限适配 + 批量导入重构 |

### 内网地址变更

| 服务 | 部署前地址 | 部署后地址 | 状态 |
|------|-----------|-----------|------|
| Node.js后端 | `172.17.197.32:3001` | `172.17.197.36:3001` | ✅ 已变更 |
| 前端Nginx | `172.17.197.32:80` | `172.17.173.104:80` | ✅ 已变更 |

---

## 一、数据库更新

### 1.1 DB-1：modules 表数据更新

通过 `node scripts/seed-modules.js` 连接 RDS 外网执行（upsert 幂等操作）：

| 操作 | 模块代码 | 名称 | 说明 |
|------|---------|------|------|
| 新增 | `RM` | 研究管理 | 排序 9 |
| 新增 | `AIA_PROTOCOL` | 全流程研究方案制定 | 排序 100 |
| 更新 | `IIT` | CRA质控 | 原名 IIT Manager |

执行结果：modules 表共 10 个模块，全部上线 ✅

### 1.2 未执行项

| 项目 | 原因 |
|------|------|
| DB-2：RVW Prompt 更新 | 用户指定不执行 |
| DB-3：SSA 双通道表结构 | 待后续部署 |

---

## 二、Node.js后端更新（v2.4 → v2.6）

### 2.1 主要变更（9 项）

| 类别 | 变更内容 |
|------|---------|
| 登录安全 | 同一手机号登录踢人机制（JWT tokenVersion + 缓存校验） |
| 权限体系 | `/me/modules` API 尊重 user_modules 精细化配置 |
| 权限体系 | 用户模块配置校验放宽（模块代码存在即可，不限租户订阅） |
| 权限体系 | user_modules 独立生效（如 AIA_PROTOCOL 可单独配给用户） |
| 模块名称 | getModuleName 补充 RM、AIA_PROTOCOL、IIT→CRA质控 |
| RVW | 稿约 Prompt 源文件期刊名称修正 |
| Seed | 内部租户补充 RM、AIA_PROTOCOL 模块 |
| SSA | 双通道架构：Agent 模式 4 服务 + ChatHandler 分流 |
| 用户管理 | 批量导入增加 autoInheritModules + 模块校验 |

### 2.2 镜像信息

| 项目 | 值 |
|------|---|
| ACR 仓库 | `backend-service` |
| 镜像版本 | v2.4 → **v2.6** |
| Digest | `sha256:17dc3b3b6171bad891b0d366a22e1b52d79db7fc9caccedf816a7feab4cea449` |
| 内网地址 | `http://172.17.197.36:3001` |

---

## 三、前端Nginx更新（v2.0 → v2.3）

### 3.1 主要变更（11 项）

| 类别 | 变更内容 |
|------|---------|
| ASL | 隐藏数据源/年限/篇数 + 去掉研究方案生成/文献管理 + 默认进入智能文献检索 |
| AIA | 删除「已接入DeepSeek」和搜索框 + Protocol Agent 按权限动态显示 |
| AIA | 数据评价与预处理/智能统计分析链接修正 |
| 首页 | 重定向到 `/ai-qa`，不再显示模块卡片首页 |
| PKB | 创建知识库时隐藏科室选择，默认 General |
| 安全 | 被踢出时提示「账号已在其他设备登录」 |
| 运营端 | 用户模块权限弹窗显示所有模块（含未订阅标注） |
| 运营端 | 批量导入用户重构为 4 步流程 + 自动继承租户模块 |

### 3.2 镜像信息

| 项目 | 值 |
|------|---|
| ACR 仓库 | `ai-clinical_frontend-nginx` |
| 镜像版本 | v2.0 → **v2.3** |
| Digest | `sha256:db031053d8ac50d8f2ce39a8406534743d974a5506b7d4af5a944dd145ce8589` |
| 内网地址 | `http://172.17.173.104:80` |

---

## 四、环境变量联动更新

| 服务 | 环境变量 | 旧值 | 新值 |
|------|---------|------|------|
| frontend-nginx-service | `BACKEND_SERVICE_HOST` | `172.17.197.32` | `172.17.197.36` |

> CLB 负载均衡器由阿里云自动更新，无需手动操作。

---

## 五、待后续部署项

| 项目 | 说明 |
|------|------|
| DB-3 | SSA 双通道表结构（ssa_sessions + ssa_agent_executions） |
| R-1 | R 统计引擎新增 execute-code 端点（需重构 R 镜像） |

---

## 六、当前系统配置速查

### 服务内网地址

```
R统计引擎: http://172.17.173.101:8080  (不变)
Python:    http://172.17.173.102:8000  (不变)
后端:      http://172.17.197.36:3001   (更新)
前端:      http://172.17.173.104:80    (更新)
```

### ACR 镜像版本

| 仓库 | 版本 |
|------|-----|
| `ssa-r-statistics` | v1.0.1 |
| `python-extraction` | v1.2 |
| `backend-service` | **v2.6** |
| `ai-clinical_frontend-nginx` | **v2.3** |

### 公网访问

```
CLB:  http://8.140.53.236/
域名: https://iit.xunzhengyixue.com/
```

---

---

## 七、二次热修部署（同日）

### 7.1 触发原因

- SSA 智能统计分析上传文件报错：`The column execution_mode does not exist in the current database`
- 前端/后端其他 bug 修复（基于测试反馈）

### 7.2 数据库热修

| 操作 | 内容 | 状态 |
|------|------|------|
| ALTER TABLE | `ssa_sessions` 新增 `execution_mode` 列（默认 `'qper'`） | ✅ |
| CREATE TABLE | `ssa_agent_executions` 表 + 索引 + 外键 | ✅ |
| INSERT | Prisma 迁移记录同步注册 | ✅ |

### 7.3 镜像重构与部署

| 服务 | 版本变化 | 镜像 Digest | IP 变化 |
|------|---------|-------------|---------|
| Node.js 后端 | v2.6 → **v2.7** | `sha256:bfb7d3e6ce39...` | `172.17.197.36` → `172.17.197.37` |
| 前端 Nginx | v2.3 → **v2.4** | `sha256:03fab06fb1a2...` | `172.17.173.104` → `172.17.173.105` |

### 7.4 最终系统配置

```
后端:      http://172.17.197.37:3001
前端:      http://172.17.173.105:80
R统计引擎: http://172.17.173.101:8080
Python:    http://172.17.173.102:8000
```

| ACR 仓库 | 最终版本 |
|----------|---------|
| `backend-service` | **v2.7** |
| `ai-clinical_frontend-nginx` | **v2.4** |
| `ssa-r-statistics` | v1.0.1 |
| `python-extraction` | v1.2 |

---

> **文档版本**：v1.1  
> **最后更新**：2026-03-05  
> **维护人员**：开发团队