Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
AIclinicalresearch/docs/05-部署文档/0126部署/README.md
HaHafeng 2481b786d8 deploy: Complete 0126-27 deployment - database upgrade, services update, code recovery 
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
2026-01-27 08:13:27 +08:00

3.9 KiB
Raw Permalink Blame History

📁 2026年1月26日部署文档

部署日期：2026-01-26
上次部署：2025-12-25（1个月前）
主要变更：数据库插件、OSS分离、Python更新、IIT生产环境

📋 文档索引

序号 文档名称 描述 优先级
00 0126部署总体计划 部署概览、顺序、检查清单 ⭐⭐⭐⭐⭐
01 数据库升级方案 pg_bigm、pgvector插件、测试/生产分离 ⭐⭐⭐⭐⭐
02 OSS环境配置方案 Bucket创建、RAM权限、环境变量 ⭐⭐⭐⭐
03 Python服务更新方案 pypdf、pypandoc新增 ⭐⭐⭐
04 后端服务部署方案 Node.js后端、Prisma、环境变量 ⭐⭐⭐⭐
05 前端服务部署方案 React前端、Nginx ⭐⭐⭐
06 IIT回调地址修复方案 natapp → 生产环境 ⭐⭐⭐
07 0126部署状态真实记录 实时部署状态、IP变更记录 ⭐⭐⭐⭐⭐
08 部署完成总结 成果总结、经验教训 ⭐⭐⭐⭐⭐

🎯 推荐阅读顺序

1. 首先阅读总体计划

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
维护人员：开发团队

Reference in New Issue View Git Blame Copy Permalink