Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(deploy): Complete 0302 deployment documentation for IIT V3.1 QC engine upgrade

Browse Source 
Summary:
- Create 0302 deployment summary (6 DB migrations + backend v2.4 + frontend v2.0)
- Update SAE status record with new IPs (172.17.197.32), versions, and history
- Update daily operations manual with incremented version numbers (backend v2.5, frontend v2.1)
- Clear pending deployment checklist and archive to history section
- Fix stale schema table counts (iit_schema 5->22, ssa_schema 0->11)

Deployment details:
- Database: 6 Prisma migrations applied (84->86 tables, 442 columns verified identical)
- Backend: v2.3->v2.4 (27 changes, IIT V3.1 QC engine + GCP report APIs)
- Frontend: v1.9->v2.0 (17 changes, GCP 5-tab reports + V3.1 dashboard)
- Both services deployed to SAE at 172.17.197.32

Made-with: Cursor
This commit is contained in:
HaHafeng
2026-03-02 08:36:56 +08:00
parent 2030ebe28f
commit 72928d3116
5 changed files with 262 additions and 98 deletions
Download Patch File Download Diff File Expand all files Collapse all files

108
docs/05-部署文档/00-阿里云SAE最新真实状态记录.md
View File

@@ -1,7 +1,7 @@
# 🚀 AI临床研究平台 - 阿里云SAE最新真实状态记录
> **文档用途**：记录阿里云SAE服务器最新真实状态 + 每次部署记录
> **最后更新**：2026-02-28
> **最后更新**：2026-03-02
> **维护人员**：开发团队
> **说明**：本文档准确记录SAE上所有应用的当前状态，包括内网地址、镜像版本、用户名密码等关键资源信息
@@ -11,10 +11,10 @@
| 服务名称 | 部署状态 | 镜像版本 | 部署位置 | 最后更新时间 |
|---------|---------|---------|---------|-------------|
| **PostgreSQL数据库** | ✅ 运行中 | PostgreSQL 15 + 插件 | RDS | 2026-02-27 |
| **前端Nginx服务** | ✅ 运行中 | **v1.9** | SAE | 2026-02-28 |
| **PostgreSQL数据库** | ✅ 运行中 | PostgreSQL 15 + 插件 | RDS | 2026-03-02 |
| **前端Nginx服务** | ✅ 运行中 | **v2.0** | SAE | 2026-03-02 |
| **Python微服务** | ✅ 运行中 | **v1.2** | SAE | 2026-02-27 |
| **Node.js后端** | ✅ 运行中 | **v2.3** | SAE | 2026-02-28 |
| **Node.js后端** | ✅ 运行中 | **v2.4** | SAE | 2026-03-02 |
| **R统计引擎** | ✅ 运行中 | **v1.0.1** | SAE | 2026-02-27 |
| **Dify AI服务** | ⚠️ 已废弃 | - | - | 使用pgvector替代 |
@@ -37,8 +37,8 @@
|---------|---------|---------|---------|
| **python-extraction** | **v1.2** | ~1.1GB | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/python-extraction:v1.2` |
| **ssa-r-statistics** | **v1.0.1** | ~1.8GB | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/ssa-r-statistics:v1.0.1` |
| **ai-clinical_frontend-nginx** | **v1.9** | ~50MB | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/ai-clinical_frontend-nginx:v1.3` |
| **backend-service** | **v2.3** | ~838MB | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v1.7` |
| **ai-clinical_frontend-nginx** | **v2.0** | ~50MB | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/ai-clinical_frontend-nginx:v2.0` |
| **backend-service** | **v2.4** | ~838MB | `crpi-cd5ij4pjt65mweeo-vpc.cn-beijing.personal.cr.aliyuncs.com/ai-clinical/backend-service:v2.4` |
---
@@ -91,7 +91,7 @@ postgresql://airesearch:Xibahe%40fengzhibo117@pgm-2zex1m2y3r23hdn5.pg.rds.aliyun
| 数据库 | 环境 | Schema数量 | 表数量 | 插件 | 用途 |
|--------|------|-----------|-------|------|------|
| `ai_clinical_research_test` | 测试环境（当前） | 16 | **84** | pg_bigm, pgvector | SAE测试环境 |
| `ai_clinical_research_test` | 测试环境（当前） | 16 | **86** | pg_bigm, pgvector | SAE测试环境 |
| `ai_clinical_research` | 生产环境（备用） | 11 | ~34 | pg_bigm, pgvector | 未来正式上线 |
**Schema架构**（16个业务Schema - 测试数据库）：
@@ -103,14 +103,14 @@ postgresql://airesearch:Xibahe%40fengzhibo117@pgm-2zex1m2y3r23hdn5.pg.rds.aliyun
| `asl_schema` | 系统文献筛查 | 7 | 项目、文献、筛查记录 |
| `pkb_schema` | 个人知识库 | 5 | 知识库、文档、批处理 |
| `dc_schema` | 数据清洗 | 6 | 工具A/B/C数据处理 |
| `iit_schema` | IIT Manager Agent | 5 | IIT项目、审计日志 |
| `iit_schema` | IIT Manager Agent | 22 | IIT项目管理、QC质控引擎、审计日志 |
| `agent_schema` | Agent框架 | 6 | Agent定义、会话、追踪 |
| `ekb_schema` | 企业知识库 | 3 | 知识库、文档、向量 |
| `capability_schema` | 通用能力 | 2 | Prompt模板、版本 |
| `protocol_schema` | 方案设计 | 2 | 研究方案生成 |
| `admin_schema` | 系统管理 | 2 | 操作日志 |
| `rvw_schema` | 文献回顾 | 1 | 审查任务 |
| `ssa_schema` | 智能统计分析 | 0 | 预留 |
| `ssa_schema` | 智能统计分析 | 11 | 工作流、分析结果、报告生成 |
| `st_schema` | 统计工具 | 0 | 预留 |
| `common_schema` | 公共模块 | 0 | 预留 |
| `public` | 兼容旧数据 | 2 | 旧表兼容 |
@@ -129,8 +129,8 @@ postgresql://airesearch:Xibahe%40fengzhibo117@pgm-2zex1m2y3r23hdn5.pg.rds.aliyun
|---------|------|------|-------|------|---------|---------|
| **r-statistics-test** | ✅ 运行中 | 1核2GB | 1 | 8080 | `http://172.17.173.101:8080` | **v1.0.1** |
| **python-extraction-test** | ✅ 运行中 | **2核4GB** | 1 | 8000 | `http://172.17.173.102:8000` | **v1.2** |
| **nodejs-backend-test** | ✅ 运行中 | **2核4GB** | 1 | 3001 | `http://172.17.197.28:3001` | **v2.2** |
| **frontend-nginx-service** | ✅ 运行中 | 0.5核1GB | 1 | 80 | `http://172.17.197.29:80` | **v1.8** |
| **nodejs-backend-test** | ✅ 运行中 | **2核4GB** | 1 | 3001 | `http://172.17.197.32:3001` | **v2.4** |
| **frontend-nginx-service** | ✅ 运行中 | 0.5核1GB | 1 | 80 | `http://172.17.197.32:80` | **v2.0** |
**环境变量配置**：
@@ -191,7 +191,7 @@ LEGACY_MYSQL_DATABASE=xzyx_online
**前端Nginx（frontend-nginx-service）**：
```bash
BACKEND_SERVICE_HOST=172.17.197.30
BACKEND_SERVICE_HOST=172.17.197.32
BACKEND_SERVICE_PORT=3001
```
@@ -259,26 +259,27 @@ TEMP_DIR=/tmp/extraction_service
### 3.2 前端Nginx服务
**当前部署版本**：v1.9
**当前部署版本**：v2.0
**镜像信息**：
- **仓库名称**：`ai-clinical_frontend-nginx`
- **镜像版本**：`v1.9` ✅（当前部署版本）
- **镜像版本**：`v2.0` ✅（当前部署版本）
- **镜像大小**：约50MB
- **基础镜像**：`nginx:alpine`
- **构建时间**：2026-02-28
- **镜像摘要**：sha256:ff3c19152f5f5944d4be187d7bc5af986fd00b69501effbd0d53a6f8b064228a
- **构建时间**：2026-03-02
- **镜像摘要**：sha256:ad24ccde2c1cdf59c07af16a429ce6298ac42d28cd9df73276ab8b653e018d38
**部署状态**：
- ✅ 已成功部署到SAE（2026-02-28）
- ✅ 服务运行正常（内网地址：http://172.17.197.31:80）
- ✅ 已成功部署到SAE（2026-03-02）
- ✅ 服务运行正常（内网地址：http://172.17.197.32:80）
- ✅ 企业微信域名验证文件已部署（WW_verify_YnhsQBwI0ARnNoG0.txt）
**v1.9版本更新内容**：
- ✅ 新增旧系统集成前端模块（Legacy iframe嵌入）
- ✅ 新增 ASL 图表生成器 / Meta分析引擎
- ✅ 新增 IIT AI对话页
- ⚠️ 部署后内网地址变更：172.17.197.29 → 172.17.197.31
**v2.0版本更新内容**：
- ✅ IIT V3.1 Dashboard 健康度评分 + D1-D7 维度条 + 热力图
- ✅ GCP 报表重构为 5 Tab（执行摘要 + D1/D2/D3D4/D6 四张报表）
- ✅ 新增 GCP 组件：EligibilityTable / CompletenessTable / EqueryLogTable / DeviationLogTable
- ✅ 管理端 QcDetailDrawer / RiskHeatmap / 方案偏离弹窗升级
- ⚠️ 部署后内网地址变更：172.17.197.31 → 172.17.197.32
**Git文件结构**：
```
@@ -295,16 +296,16 @@ AIclinicalresearch/frontend-v2/
### 3.3 Node.js后端服务
**当前部署版本**：v2.3
**当前部署版本**：v2.4
**镜像信息**：
- **仓库名称**：`backend-service`
- **镜像版本**：`v2.3` ✅（已部署）
- **镜像版本**：`v2.4` ✅（已部署）
- **镜像大小**：~838MB
- **基础镜像**：`node:alpine`
- **构建时间**：2026-02-28
- **构建时间**：2026-03-02
- **构建策略**：改进版方案B（本地编译+Docker打包）
- **镜像摘要**：sha256:6e25d13cc7e1b228638a30eda35bd4aa70e0f7d52283cf66a2ffb21bee4ea288
- **镜像摘要**：sha256:7848b1b590c138a629fcf9036204e8a2663fc653d2347f22b2928df2874a4233
**技术架构**：
- **Node.js版本**：22.x
@@ -315,8 +316,8 @@ AIclinicalresearch/frontend-v2/
- **缓存系统**：PostgreSQL（替代Redis）
**部署状态**：
- ✅ 已成功部署到SAE（2026-02-28）
- ✅ 服务运行正常（内网地址：http://172.17.197.30:3001）
- ✅ 已成功部署到SAE（2026-03-02）
- ✅ 服务运行正常（内网地址：http://172.17.197.32:3001）
- ✅ 健康检查通过
**Git文件结构**：
@@ -366,6 +367,51 @@ AIclinicalresearch/extraction_service/
## 🔄 四、部署历史记录
### 2026-03-02（0302部署 - 数据库迁移6个 + IIT V3.1 QC引擎全面升级）
#### 部署概览
- **部署时间**：2026-03-02
- **部署范围**：数据库迁移（6个） + Node.js后端 + 前端Nginx 全量更新
- **主要变更**：IIT V3.1 QC引擎架构全面升级、GCP报表、D1-D7七维分类体系
#### 数据库迁移（6个）
- ✅ SSA 表类型精度对齐 + 清理重复 FK
- ✅ Phase 2: user_mappings/projects RBAC + UserRole 加 IIT_OPERATOR
- ✅ IIT projects 加 is_demo 标记
- ✅ **新建 qc_field_status 五级坐标表** + qc_logs/equery 加 instance_id
- ✅ **新建 qc_event_status 事件聚合表** + record_summary 加 13 列
- ✅ qc_project_stats 加健康度评分 9 列
- ✅ RDS 表数量：84 → **86**（新增 qc_field_status、qc_event_status）
- ✅ 本地 vs RDS 模式对比：iit_schema + ssa_schema **442 列完全一致**
#### Node.js后端更新（v2.3 → v2.4）
- ✅ IIT V3.1 QC 引擎：QcExecutor / QcAggregator / CompletenessEngine / ProtocolDeviationEngine / HealthScoreEngine
- ✅ D1-D7 七维分类体系 + 五级坐标标准化
- ✅ GCP 报表 API：D1 筛选入选 / D2 完整性 / D3D4 eQuery 生命周期 / D6 方案偏离
- ✅ 项目级 cronExpression 调度器重构
- ✅ 镜像构建推送：`backend-service:v2.4`（digest: sha256:7848b1b5...）
- ✅ SAE部署成功，内网地址变更：`172.17.197.30` → `172.17.197.32`
#### 前端Nginx更新（v1.9 → v2.0）
- ✅ Dashboard 健康度评分 + D1-D7 维度条 + 热力图 record×event 矩阵
- ✅ GCP 报表重构为 5 Tab（执行摘要 + D1/D2/D3D4/D6）
- ✅ 新增 GCP 组件：EligibilityTable / CompletenessTable / EqueryLogTable / DeviationLogTable
- ✅ 管理端 QcDetailDrawer / RiskHeatmap / 方案偏离弹窗升级
- ✅ 镜像构建推送：`ai-clinical_frontend-nginx:v2.0`（digest: sha256:ad24ccde...）
- ✅ SAE部署成功，内网地址变更：`172.17.197.31` → `172.17.197.32`
#### 环境变量同步
- ✅ `frontend-nginx-service` 的 `BACKEND_SERVICE_HOST` 更新为 `172.17.197.32`
- ℹ️ CLB 由阿里云自动更新，无需手动操作
#### 文档产出
- ✅ `0302部署/01-部署完成总结.md`
- ✅ `00-阿里云SAE最新真实状态记录.md`（更新）
- ✅ `01-日常更新操作手册.md`（更新）
- ✅ `03-待部署变更清单.md`（清零移入历史）
---
### 2026-02-28（0228部署 - Node.js后端 + 前端更新 - 旧系统集成上线）
#### 部署概览
@@ -591,5 +637,5 @@ AIclinicalresearch/extraction_service/
---
> **提示**：本文档记录SAE服务器的最新真实状态，每次部署后必须更新！
> **最后更新**：2026-02-28
> **当前版本**：前端v1.9 | 后端v2.3 | Python v1.2 | R统计v1.0.1 | PostgreSQL 15
> **最后更新**：2026-03-02
> **当前版本**：前端v2.0 | 后端v2.4 | Python v1.2 | R统计v1.0.1 | PostgreSQL 15