Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
179afa2c6bbe35330336644f480ab1fda19f3b4a
AIclinicalresearch/快速部署到SAE.md
HaHafeng 179afa2c6b feat(rvw): Complete RVW module development Phase 1-3 
Summary:
- Migrate backend to modules/rvw with v2 API routes (/api/v2/rvw)
- Add new database fields: selectedAgents, editorialScore, methodologyStatus, picoExtract, isArchived
- Create frontend module in frontend-v2/src/modules/rvw
- Implement Dashboard with task list, filtering, batch operations
- Implement ReportDetail with dual tabs (editorial/methodology)
- Implement AgentModal for intelligent agent selection
- Register RVW module in moduleRegistry.ts
- Add navigation entry in TopNavigation
- Update documentation for RVW module status (v3.0)
- Update system status document (v2.9)

Features:
- User can select agents: editorial, methodology, or both
- Support batch task execution
- Task status filtering
- Replace console.log with logger service
- Maintain v1 API backward compatibility

Tested: Frontend and backend verified locally
Status: 85% complete (Phase 1-3 done)
2026-01-07 22:39:08 +08:00

6.8 KiB
Raw Blame History

🚀 快速部署到SAE - 5分钟上手

适合人群： 零部署经验的产品经理
预计时间： 2-3小时（包含等待）
难度等级： ⭐⭐ 简单

📚 完整文档清单

我已经为您准备了3份详细文档，请按顺序阅读：

1️⃣ 详细部署指南（必读）

文件： docs/05-部署文档/02-SAE部署完全指南(产品经理版).md

内容：

  • ✅ 需不需要购买Redis的答案
  • ✅ 傻瓜式部署步骤（7个大步骤）
  • ✅ 每一步都有截图和说明
  • ✅ 常见问题解决方案
  • ✅ 成本估算和优化建议

阅读时间： 20-30分钟

2️⃣ 环境变量配置指南（必读）

文件： docs/07-运维文档/03-SAE环境变量配置指南.md

内容：

  • ✅ 所有环境变量的详细说明
  • ✅ 如何正确填写每一个配置项
  • ✅ 配置检查清单
  • ✅ 常见错误和解决方法

阅读时间： 10-15分钟

3️⃣ 部署检查清单（打印/对照）

文件： 部署检查清单.md

内容：

  • ✅ 7个阶段的检查项
  • ✅ 每个步骤都有复选框
  • ✅ 快速验证命令
  • ✅ 重要信息记录模板

使用方法： 打印出来或在另一个屏幕打开，边部署边勾选

🎯 三步快速开始

Step 1: 准备工具（5分钟）

  1. 安装Docker Desktop

  2. 确认阿里云服务已购买

    • ✅ SAE (Serverless应用引擎)
    • ✅ RDS PostgreSQL
    • ✅ OSS (对象存储)

Step 2: 构建和推送镜像（15分钟）

打开PowerShell，执行：

# 1. 进入项目目录
cd D:\MyCursor\AIclinicalresearch

# 2. 使用自动化脚本部署
.\deploy-to-sae.ps1 -Version "v1.0.0"

# 脚本会自动完成：
# - 构建Docker镜像
# - 推送到阿里云容器镜像服务

如果提示需要登录阿里云：

docker login --username=你的阿里云账号 registry.cn-hangzhou.aliyuncs.com
# 输入密码（在阿里云容器镜像服务设置的密码）

Step 3: 在SAE控制台完成部署（30分钟）

  1. 登录阿里云控制台

  2. 创建应用

    • 应用名称：aiclinical-backend-dev
    • 镜像：选择刚才推送的镜像
    • 实例规格：1核2GB

  3. 配置环境变量

    • 参考：docs/07-运维文档/03-SAE环境变量配置指南.md
    • 逐行复制配置（注意替换真实值）

  4. 验证部署

    • 访问：http://你的SAE地址:3001/health
    • 看到 {"status":"ok"} 就成功了！

❓ 核心问题快速解答

Q1: 需要购买Redis吗？

答案：初期不需要！

  • ✅ 开发测试环境：使用内存缓存（CACHE_TYPE=memory）
  • ✅ 用户<100人：内存缓存足够
  • ⚠️ 用户100-1000人：建议购买Redis（¥200/月）
  • ✅ 用户>1000人：必须使用Redis

配置方法：

# 初期配置
CACHE_TYPE=memory

# 未来需要时改为
CACHE_TYPE=redis
REDIS_HOST=r-xxxx.redis.rds.aliyuncs.com
REDIS_PASSWORD=你的密码

Q2: Python微服务怎么部署？

三个方案：

方案A：暂不部署（推荐初期）

  • 先部署Node.js后端
  • Python服务继续在本地运行
  • 环境变量：EXTRACTION_SERVICE_URL=http://你的本地公网IP:8000
  • 或使用ngrok等内网穿透工具

方案B：也部署到SAE（推荐正式上线）

  • 创建 extraction_service/Dockerfile
  • 推送镜像到ACR
  • 在SAE创建新应用 aiclinical-python-dev
  • 配置SAE内网通信

方案C：使用阿里云FC（函数计算）

  • 成本最低
  • 按调用次数付费
  • 需要改造代码

Q3: 前端怎么部署？

两个方案：

方案A：OSS静态托管（推荐初期）

# 1. 构建前端
cd frontend-v2
npm run build

# 2. 上传到OSS
# 在OSS控制台手动上传dist目录所有文件

# 3. 配置静态网站托管
# OSS控制台 → 基础设置 → 静态页面

方案B：SAE部署（推荐正式）

  • 使用Nginx容器
  • 创建Dockerfile for frontend
  • 部署到SAE独立应用

Q4: 部署失败怎么办？

3个排查步骤：

  1. 查看日志

    SAE控制台 → 应用详情 → 实时日志
找红色ERROR关键词

  2. 检查环境变量

    SAE控制台 → 配置管理 → 环境变量
确认DATABASE_URL、OSS密钥等配置正确

  3. 查看详细文档

    docs/05-部署文档/02-SAE部署完全指南(产品经理版).md
→ 第8章：常见问题解决

📊 部署成功标志

✅ 后端部署成功

访问：http://你的SAE地址:3001/health

预期返回：

{
  "status": "ok",
  "database": "connected",
  "storage": "oss",
  "cache": "memory",
  "timestamp": "2025-12-11T10:30:00.000Z"
}

✅ 数据库连接成功

日志中显示：

✅ [Config] Environment validation passed
✅ [Database] 数据库连接成功
📦 [Storage] 使用阿里云 OSS 存储

✅ OSS存储正常

测试方法：

  1. 访问后端API上传文件
  2. 在OSS控制台能看到文件
  3. 文件可以正常下载

💰 成本估算

开发测试环境（当前配置）

服务 规格 月费 说明
SAE 1C2G × 1实例 ¥150 按量付费
RDS 2C4G 通用版 ¥300 可包年优惠
OSS 100GB存储 ¥10 按实际使用
Redis - ¥0 不购买
合计 ¥460/月

正式生产环境（用户>1000）

服务 规格 月费
SAE 2C4G × 3实例 ¥600
RDS 4C8G 通用版 ¥600
OSS 500GB + 50GB流量 ¥70
Redis 2GB标准版 ¥200
合计 ¥1470/月

🎉 恭喜！

如果您已经完成部署，恭喜您！

记得保存重要信息：

【部署信息】

后端地址：http://_______________:3001
前端地址：http://_______________

RDS地址：_______________
RDS密码：_______________

OSS Bucket：aiclinical-dev
OSS AccessKeyId：_______________
OSS AccessKeySecret：_______________

部署时间：_______________

📞 需要帮助？

  1. 查看详细文档

    • docs/05-部署文档/02-SAE部署完全指南(产品经理版).md

  2. 查看环境变量配置

    • docs/07-运维文档/03-SAE环境变量配置指南.md

  3. 使用检查清单

    • 部署检查清单.md

  4. 查看云原生架构设计

    • docs/09-架构实施/03-云原生部署架构指南.md

版本： v1.0
创建日期： 2025-12-11
维护者： 技术架构师
下次更新： 根据实际部署反馈优化

Reference in New Issue View Git Blame Copy Permalink