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

docs(deploy): Update deployment documentation for Node.js backend

Browse Source 
Summary:
- Created Node.js backend Docker image build guide
- Updated deployment progress overview with backend status
- Updated system status documentation

Backend build achievements:
- Fixed 200+ TypeScript compilation errors (200+ to 0)
- Completed Prisma reverse sync (32 models from RDS)
- Manually added 30+ Prisma relation fields
- Successfully built Docker image (838MB)
- Pushed image to ACR (v1.0 + latest tags)

Documentation updates:
- Added 10-Node.js后端-Docker镜像构建手册.md
- Updated 00-部署进度总览.md with backend deployment status
- Updated 00-系统当前状态与开发指南.md with latest progress
- Fixed date format (2024 -> 2025)

Next steps:
- Deploy Node.js backend to SAE
- Configure environment variables
- Test end-to-end functionality

Status: Backend Docker image ready for SAE deployment
This commit is contained in:
HaHafeng
2025-12-25 08:21:21 +08:00
parent ef967d7d7c
commit 691dc2bc98
112 changed files with 986 additions and 57 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
docs/00-系统总体设计/00-系统当前状态与开发指南.md
View File

@@ -1,10 +1,10 @@
# AIclinicalresearch 系统当前状态与开发指南
> **文档版本：** v2.1
> **文档版本：** v2.2
> **创建日期：** 2025-11-28
> **维护者：** 开发团队
> **最后更新：** 2024-12-24
> **重大进展：** 🚀 **阿里云生产环境部署启动** - PostgreSQL数据迁移完成、前端Nginx与Python微服务镜像已推送ACR
> **最后更新：** 2025-12-24
> **重大进展：** 🚀 **后端核心服务镜像构建完成** - Node.js后端镜像已推送ACR（修复200+TS错误，补全30+Prisma关系）
> **文档目的：** 快速了解系统当前状态，为新AI助手提供上下文
---
@@ -97,14 +97,16 @@
- 10个Schema隔离（platform/aia/pkb/asl/dc/ssa/st/rvw/admin/common）
**云原生部署**：
- 阿里云 SAE (Serverless 应用引擎)
- 阿里云 SAE (Serverless 应用引擎) ✅ 已部署Python微服务
- 阿里云 ACR (容器镜像服务) ✅ 已推送3个镜像（Frontend、Backend、Python）
- 阿里云 RDS (PostgreSQL 15) ✅ 已迁移数据
- RDS PostgreSQL 15 + OSS (对象存储) + NAT网关
- ACR (容器镜像服务 - 个人版免费)
- **部署状态**：🚀 **进行中**（PostgreSQL✅、Python微服务✅、前端镜像✅、Node.js后端⏳）
---
## 🚀 当前开发状态（2024-12-24）
## 🚀 当前开发状态（2025-12-24）
### ✅ 已完成模块
@@ -256,7 +258,7 @@
---
## 🚀 阿里云生产环境部署状态（2024-12-24）
## 🚀 阿里云生产环境部署状态（2025-12-24）
### ✅ 已完成部署
@@ -276,7 +278,7 @@
- **数据迁移**: ✅ 完成（90MB SQL文件，约12秒导入）
- **Schema验证**: ✅ 11个Schema全部迁移成功
- **数据验证**: ✅ 用户3条、项目2条、文献1204条
- **部署时间**: 2024-12-24
- **部署时间**: 2025-12-24
- ✅ **OSS对象存储**
- Bucket: `ai-clinical-research`
@@ -290,23 +292,37 @@
- ✅ **Registry**: `crpi-cd5ij4pjt65mweeo.cn-beijing.personal.cr.aliyuncs.com`
- ✅ **已推送镜像**:
- **前端Nginx**: `ai-clinical_frontend-nginx:v1.0`（约50MB）
- 构建时间: 2024-12-24
- 构建时间: 2025-12-24
- 基础镜像: `nginx:alpine`
- 功能: React SPA + Nginx反向代理 + 动态环境变量
- 配置文件: `frontend-v2/Dockerfile`, `nginx.conf`, `.dockerignore`
- **Python微服务**: `python-extraction:v1.0`（1.12GB）
- 构建时间: 2024-12-24
- 构建时间: 2025-12-24
- 基础镜像: `python:3-slim`
- 功能: PDF提取（PyMuPDF）+ 数据清洗（pandas/numpy/polars）
- 特性: 移除Nougat（减小1.5GB）、使用阿里云Debian源
- 配置文件: `extraction_service/Dockerfile`, `requirements-prod.txt`, `.dockerignore`
- **Node.js后端**: `backend-service:v1.0`（838MB，压缩后~186MB）✨ 新增！
- 构建时间: 2025-12-24（约5分钟）
- 基础镜像: `node:alpine`
- 构建策略: 改进版方案B（本地编译+Docker打包）
- 技术突破: 修复200+TypeScript错误、手动补全30+Prisma关系字段
- 架构特性: Postgres-Only（pg-boss队列+PostgreSQL缓存）
- 配置文件: `backend/Dockerfile`, `backend/.dockerignore`, `backend/prisma/schema.prisma`
### 🚧 进行中
#### 4. SAE应用部署
- ⏳ **Python微服务**: 镜像已推送，待部署到SAE
- 目标规格: 1核2GB
- ✅ **Python微服务**: 已成功部署到SAE轻量版
- 应用名称: `python-extraction-test`
- 规格: 1核2GB
- 内网地址: `http://172.17.173.66:8000`
- 状态: 运行中 ✅
- ⏳ **Node.js后端**: 镜像已推送，待部署到SAE
- 目标规格: 1核2GB（测试环境）
- 端口: 8000
- 健康检查: `/api/health`
@@ -471,24 +487,34 @@ AIclinicalresearch/
| **2025-11-26~27** | DC Day 2-3 | ✅ DC工具B健康检查+模板管理 |
| **2025-11-28** | DC Day 4-8 | ✅ DC Tool C MVP + UX重大改进完成 |
| **2025-12-13** | 架构优化 | ✅ Postgres-Only架构改造完成 |
| **2024-12-24** | **部署启动** 🚀 | ✅ PostgreSQL数据迁移 + 前端/Python镜像推送ACR |
| **当前** | 部署进行中 | 🚧 SAE应用部署 + Node.js后端构建 |
| **2025-12-24 上午** | **部署启动** 🚀 | ✅ PostgreSQL数据迁移 + 前端/Python镜像推送ACR |
| **2025-12-24 下午** | **后端镜像构建** 🎉 | ✅ Node.js后端镜像构建成功（修复200+TS错误） |
| **当前** | 部署进行中 | 🚧 SAE应用部署（Python已完成，Node.js待部署） |
---
## 🎯 下一步计划
### 🔥 最高优先级（1-2天）- 部署到生产环境
1. **Python微服务部署到SAE**
- 创建SAE应用
- 配置环境变量
- 健康检查验证
- 获取内网地址
### 🔥 最高优先级（当前）- 部署到生产环境
1. ✅ **Python微服务部署到SAE** - 已完成
- ✅ 创建SAE应用（轻量版）
- ✅ 配置环境变量（OSS、数据库）
- ✅ 健康检查验证
- ✅ 获取内网地址：`http://172.17.173.66:8000`
2. **Node.js后端Docker镜像构建**
- 创建Dockerfile
- 配置数据库连接（RDS内网地址）
- 构建并推送到ACR
2. ✅ **Node.js后端Docker镜像构建** - 已完成
- ✅ Prisma反向同步（32个模型）
- ✅ 手动补全Prisma关系字段（30+个）
- ✅ 修复TypeScript编译错误（200+ → 0）
- ✅ 创建Dockerfile（改进版方案B）
- ✅ 构建并推送到ACR（838MB镜像）
3. ⏳ **Node.js后端部署到SAE** - 待执行
- [ ] 创建SAE应用（1核2GB，测试环境）
- [ ] 配置ACR镜像拉取认证
- [ ] 配置环境变量（数据库、Python服务、OSS、LLM API）
- [ ] 健康检查验证
- [ ] 获取内网地址
3. **Node.js后端部署到SAE**
- 创建SAE应用（2核4GB）
@@ -624,8 +650,8 @@ npm run dev # http://localhost:3000
### 部署完成度
- ✅ **基础设施**：VPC（100%）、NAT网关（100%）、安全组（100%）
- ✅ **数据存储**：RDS PostgreSQL（100%）、OSS（100%）
- ✅ **容器镜像**：前端Nginx（100%）、Python微服务（100%）
- 🚧 **SAE应用**：Python微服务（待部署）、Node.js后端（镜像待构建）、前端Nginx（待部署）
- ✅ **容器镜像**：前端Nginx（100%）、Python微服务（100%）、Node.js后端（100%）✨ 新增！
- ✅ **SAE应用**：Python微服务（100%，已运行）、Node.js后端（镜像已推送，待部署）、前端Nginx（待部署）
- 📋 **验证测试**：全链路测试（待进行）
### 测试覆盖率
@@ -756,7 +782,7 @@ if (items.length >= 50) {
---
**文档版本**：v2.1
**最后更新**：2024-12-24
**最后更新**：2025-12-24
**下次更新**：SAE应用部署完成 或 全链路验证测试完成
---