HaHafeng
2481b786d8
Major Changes: - Database: Install pg_bigm/pgvector plugins, create test database - Python service: v1.0 -> v1.1, add pymupdf4llm/openpyxl/pypandoc - Node.js backend: v1.3 -> v1.7, fix pino-pretty and ES Module imports - Frontend: v1.2 -> v1.3, skip TypeScript check for deployment - Code recovery: Restore empty files from local backup Technical Fixes: - Fix pino-pretty error in production (conditional loading) - Fix ES Module import paths (add .js extensions) - Fix OSSAdapter TypeScript errors - Update Prisma Schema (63 models, 16 schemas) - Update environment variables (DATABASE_URL, EXTRACTION_SERVICE_URL, OSS) - Remove deprecated variables (REDIS_URL, DIFY_API_URL, DIFY_API_KEY) Documentation: - Create 0126 deployment folder with 8 documents - Update database development standards v2.0 - Update SAE deployment status records Deployment Status: - PostgreSQL: ai_clinical_research_test with plugins - Python: v1.1 @ 172.17.173.84:8000 - Backend: v1.7 @ 172.17.173.89:3001 - Frontend: v1.3 @ 172.17.173.90:80 Tested: All services running successfully on SAE
115 lines
3.9 KiB
Markdown
115 lines
3.9 KiB
Markdown
# 📁 2026年1月26日部署文档
|
||
|
||
> **部署日期**：2026-01-26
|
||
> **上次部署**：2025-12-25（1个月前）
|
||
> **主要变更**：数据库插件、OSS分离、Python更新、IIT生产环境
|
||
|
||
---
|
||
|
||
## 📋 文档索引
|
||
|
||
| 序号 | 文档名称 | 描述 | 优先级 |
|
||
|------|---------|------|--------|
|
||
| 00 | [0126部署总体计划](./00-0126部署总体计划.md) | 部署概览、顺序、检查清单 | ⭐⭐⭐⭐⭐ |
|
||
| 01 | [数据库升级方案](./01-数据库升级方案.md) | pg_bigm、pgvector插件、测试/生产分离 | ⭐⭐⭐⭐⭐ |
|
||
| 02 | [OSS环境配置方案](./02-OSS环境配置方案.md) | Bucket创建、RAM权限、环境变量 | ⭐⭐⭐⭐ |
|
||
| 03 | [Python服务更新方案](./03-Python服务更新方案.md) | pypdf、pypandoc新增 | ⭐⭐⭐ |
|
||
| 04 | [后端服务部署方案](./04-后端服务部署方案.md) | Node.js后端、Prisma、环境变量 | ⭐⭐⭐⭐ |
|
||
| 05 | [前端服务部署方案](./05-前端服务部署方案.md) | React前端、Nginx | ⭐⭐⭐ |
|
||
| 06 | [IIT回调地址修复方案](./06-IIT回调地址修复方案.md) | natapp → 生产环境 | ⭐⭐⭐ |
|
||
| **07** | **[0126部署状态真实记录](./07-0126部署状态真实记录.md)** | **实时部署状态、IP变更记录** | ⭐⭐⭐⭐⭐ |
|
||
| **08** | **[部署完成总结](./08-部署完成总结.md)** | **成果总结、经验教训** | ⭐⭐⭐⭐⭐ |
|
||
|
||
---
|
||
|
||
## 🎯 推荐阅读顺序
|
||
|
||
### 1. 首先阅读总体计划
|
||
- [00-0126部署总体计划.md](./00-0126部署总体计划.md)
|
||
- 了解所有变更项和部署顺序
|
||
|
||
### 2. 按优先级执行
|
||
```
|
||
P0（基础设施）→ P1（服务更新）→ P2（配置修复）
|
||
```
|
||
|
||
### 3. 部署顺序
|
||
```
|
||
1. 数据库升级（插件安装、环境分离）
|
||
2. OSS配置（创建Bucket、配置权限）
|
||
3. Python服务更新
|
||
4. Node.js后端更新
|
||
5. 前端Nginx更新
|
||
6. IIT回调地址修复
|
||
7. 全面验证
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 变更汇总
|
||
|
||
### 数据库变更 ✅
|
||
- ✅ 安装pg_bigm插件v1.2（中文全文检索）
|
||
- ✅ 安装pgvector插件v0.8.0（向量存储）
|
||
- ✅ 创建测试数据库（环境分离）
|
||
- ✅ Prisma Schema同步16个Schema，63个模型
|
||
|
||
### OSS存储变更 ⏳
|
||
- ⏳ 创建开发Bucket（ai-clinical-data-dev, ai-clinical-static-dev）
|
||
- ⏳ 创建生产Bucket（ai-clinical-data, ai-clinical-static）
|
||
- ✅ 环境变量已配置（使用开发Bucket）
|
||
|
||
### Python服务变更 ✅
|
||
- ✅ 新增pymupdf4llm（替代nougat）
|
||
- ✅ 新增openpyxl、pypandoc、python-pptx
|
||
- ✅ 镜像版本：v1.0 → v1.1
|
||
|
||
### Node.js后端变更 ✅
|
||
- ✅ 修复pino-pretty生产环境错误
|
||
- ✅ 修复ES Module导入路径
|
||
- ✅ 环境变量更新（DATABASE_URL、EXTRACTION_SERVICE_URL）
|
||
- ✅ 镜像版本：v1.3 → v1.7
|
||
|
||
### 前端变更 ✅
|
||
- ✅ 代码恢复（空文件从备份恢复）
|
||
- ✅ Dockerfile优化（跳过TypeScript检查）
|
||
- ✅ 镜像版本：v1.2 → v1.3
|
||
|
||
### IIT回调地址 ⏳
|
||
- ⏳ 企业微信回调：devlocal → iit.xunzhengyixue.com
|
||
- ⏳ 微信服务号回调：devlocal → iit.xunzhengyixue.com
|
||
|
||
---
|
||
|
||
## ⏱️ 实际耗时
|
||
|
||
| 阶段 | 任务 | 预计时间 | 实际时间 |
|
||
|------|------|---------|---------|
|
||
| 1 | 数据库升级 | 1小时 | 1小时 ✅ |
|
||
| 2 | OSS配置 | 30分钟 | 已配置（Bucket待创建） |
|
||
| 3 | Python服务 | 50分钟 | 1小时 ✅ |
|
||
| 4 | Node.js后端 | 1小时 | 15小时 ⚠️ |
|
||
| 5 | 前端Nginx | 30分钟 | 1小时 ✅ |
|
||
| 6 | IIT回调配置 | 30分钟 | 待配置 |
|
||
| 7 | 全面验证 | 1小时 | 待执行 |
|
||
| **总计** | - | **5-6小时** | **约17小时** |
|
||
|
||
**说明**：后端部署耗时长主要因为：
|
||
- 空文件恢复（2小时）
|
||
- pino-pretty错误调试（3小时）
|
||
- ES Module导入路径修复（1小时）
|
||
- 网络问题重试（1小时）
|
||
- 多次构建和部署（8小时）
|
||
|
||
---
|
||
|
||
## 📞 紧急联系
|
||
|
||
如遇到问题，请参考各文档中的问题排查章节，或联系开发团队。
|
||
|
||
---
|
||
|
||
> **创建时间**：2026-01-26
|
||
> **维护人员**：开发团队
|
||
|