Files
AIclinicalresearch/backend
HaHafeng decff0bb1f docs(deploy): Complete full system deployment to Aliyun SAE
Summary:
- Successfully deployed complete system to Aliyun SAE (2025-12-25)
- All services running: Python microservice + Node.js backend + Frontend Nginx + CLB
- Public access available at http://8.140.53.236/

Major Achievements:
1. Python microservice deployed (v1.0, internal IP: 172.17.173.66:8000)
2. Node.js backend deployed (v1.3, internal IP: 172.17.173.73:3001)
   - Fixed 4 critical issues: bash path, config directory, pino-pretty, ES Module
3. Frontend Nginx deployed (v1.0, internal IP: 172.17.173.72:80)
4. CLB load balancer configured (public IP: 8.140.53.236)

New Documentation (9 docs):
- 11-Node.js backend SAE deployment config checklist (21 env vars)
- 12-Node.js backend SAE deployment operation manual
- 13-Node.js backend image fix record (config directory)
- 14-Node.js backend pino-pretty fix
- 15-Node.js backend deployment success summary
- 16-Frontend Nginx deployment success summary
- 17-Complete deployment practical manual 2025 edition (1800 lines)
- 18-Deployment documentation usage guide
- 19-Daily update quick operation manual (670 lines)

Key Fixes:
- Environment variable name correction: EXTRACTION_SERVICE_URL (not PYTHON_SERVICE_URL)
- Dockerfile fix: added COPY config ./config
- Logger configuration: conditional pino-pretty for dev only
- Health check fix: ES Module compatibility (require -> import)

Updated Files:
- System status document updated with full deployment info
- Deployment progress overview updated with latest IPs
- All 3 Docker services' Dockerfiles and configs refined

Verification:
- All health checks passed
- Tool C 7 features working correctly
- Literature screening module functional
- Response time < 1 second

BREAKING CHANGE: Node.js backend internal IP changed from 172.17.173.71 to 172.17.173.73

Closes #deployment-milestone
2025-12-25 21:24:37 +08:00
..
2025-10-12 09:51:11 +08:00

AI临床研究平台 - 后端服务

🏠 导航


快速开始

1. 环境要求

  • Node.js >= 18
  • PostgreSQL 15+
  • Redis 7+

2. 安装依赖

npm install

3. 配置环境变量

复制.env.example.env并配置:

cp .env.example .env

4. 初始化数据库

# 生成Prisma Client
npm run prisma:generate

# 执行数据库迁移
npm run prisma:migrate

# 可选打开Prisma Studio查看数据
npm run prisma:studio

5. 启动开发服务器

npm run dev

服务器将在 http://localhost:3001 启动

6. 验证服务

访问以下端点验证服务是否正常:

项目结构

backend/
├── prisma/
│   └── schema.prisma          # 数据库模型定义
├── src/
│   ├── config/
│   │   ├── env.ts             # 环境变量配置
│   │   └── database.ts        # 数据库连接
│   ├── controllers/           # 控制器层
│   ├── services/              # 业务逻辑层
│   ├── routes/                # 路由定义
│   ├── types/                 # TypeScript类型定义
│   ├── utils/                 # 工具函数
│   └── index.ts               # 应用入口
├── .env                       # 环境变量不提交到Git
├── .env.example               # 环境变量模板
├── package.json               # 项目配置
└── tsconfig.json              # TypeScript配置

NPM Scripts

  • npm run dev - 启动开发服务器hot reload
  • npm run build - 构建生产版本
  • npm run start - 启动生产服务器
  • npm run prisma:generate - 生成Prisma Client
  • npm run prisma:migrate - 执行数据库迁移
  • npm run prisma:studio - 打开Prisma Studio

数据库设计

详见:../docs/01-设计文档/数据库设计文档.md

API文档

详见:../docs/01-设计文档/API设计规范.md

技术栈

  • 框架: Fastify
  • ORM: Prisma
  • 数据库: PostgreSQL
  • 缓存: Redis
  • 语言: TypeScript
  • 日志: Pino

Day 5 完成情况

初始化后端项目Node.js + TypeScript 配置Fastify框架 配置Prisma ORM 创建数据库表(执行迁移) 数据库连接测试通过

所有核心功能已完成!🎉