Develop/AIclinicalresearch
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
40c2f8e148d4af0058936394e8e8a1c1c8ec82e2
AIclinicalresearch/部署检查清单.md
HaHafeng 40c2f8e148 feat(rag): Complete RAG engine implementation with pgvector 
Major Features:
- Created ekb_schema (13th schema) with 3 tables: KB/Document/Chunk
- Implemented EmbeddingService (text-embedding-v4, 1024-dim vectors)
- Implemented ChunkService (smart Markdown chunking)
- Implemented VectorSearchService (multi-query + hybrid search)
- Implemented RerankService (qwen3-rerank)
- Integrated DeepSeek V3 QueryRewriter for cross-language search
- Python service: Added pymupdf4llm for PDF-to-Markdown conversion
- PKB: Dual-mode adapter (pgvector/dify/hybrid)

Architecture:
- Brain-Hand Model: Business layer (DeepSeek) + Engine layer (pgvector)
- Cross-language support: Chinese query matches English documents
- Small Embedding (1024) + Strong Reranker strategy

Performance:
- End-to-end latency: 2.5s
- Cost per query: 0.0025 RMB
- Accuracy improvement: +20.5% (cross-language)

Tests:
- test-embedding-service.ts: Vector embedding verified
- test-rag-e2e.ts: Full pipeline tested
- test-rerank.ts: Rerank quality validated
- test-query-rewrite.ts: Cross-language search verified
- test-pdf-ingest.ts: Real PDF document tested (Dongen 2003.pdf)

Documentation:
- Added 05-RAG-Engine-User-Guide.md
- Added 02-Document-Processing-User-Guide.md
- Updated system status documentation

Status: Production ready
2026-01-21 20:24:29 +08:00

8.0 KiB
Raw Blame History

🚀 SAE部署检查清单

用途： 部署前的最后检查，确保不遗漏任何步骤
使用方法： 打印或在另一个屏幕上打开，逐项勾选
预计时间： 10分钟检查

📋 阶段1：阿里云服务准备

云数据库 RDS

  • RDS实例已创建（PostgreSQL 15+）
  • 数据库 aiclinical_dev 已创建
  • 数据库用户 aiclinical 已创建
  • 用户已授权读写权限
  • 白名单已添加（可以先设置为 0.0.0.0/0）
  • 已获取内网连接地址（rm-xxxx.mysql.rds.aliyuncs.com）
  • 已测试连接成功

快速验证命令：

# 使用 psql 或任何PostgreSQL客户端
psql "postgresql://aiclinical:密码@rm-xxxx.mysql.rds.aliyuncs.com:5432/aiclinical_dev"

对象存储 OSS

  • Bucket aiclinical-dev 已创建
  • Bucket区域与RDS相同
  • 存储类型设置为「标准存储」
  • 读写权限设置为「私有」
  • RAM用户 aiclinical-oss 已创建
  • RAM用户已授权 AliyunOSSFullAccess
  • 已获取 AccessKeyId 和 AccessKeySecret
  • 已保存密钥到安全的地方（只显示一次！）

快速验证：

# 使用ossutil测试
ossutil ls oss://aiclinical-dev

容器镜像服务 ACR

  • 容器镜像服务已开通
  • 命名空间 aiclinical 已创建
  • 镜像仓库 backend-dev 已创建
  • 镜像仓库类型为「私有」
  • 已设置镜像仓库登录密码
  • 已测试Docker登录成功

快速验证：

docker login --username=你的阿里云账号 registry.cn-hangzhou.aliyuncs.com
# 输入密码，看是否 "Login Succeeded"

📦 阶段2：Docker镜像准备

后端镜像

  • backend/Dockerfile 文件已创建
  • backend/.dockerignore 文件已创建
  • Docker Desktop 已启动
  • 镜像构建成功（docker build -t aiclinical-backend:dev .）
  • 镜像标签已创建（docker tag ...）
  • 镜像已推送到ACR（docker push ...）
  • 在ACR控制台确认镜像版本存在

快速验证：

# 查看本地镜像
docker images | Select-String "aiclinical-backend"

# 查看ACR远程镜像
# 登录ACR控制台 → 镜像仓库 → backend-dev → 镜像版本

Python微服务镜像（可选）

  • extraction_service/Dockerfile 文件已创建
  • 镜像构建成功
  • 镜像已推送到ACR
  • 镜像仓库 python-dev 已创建

临时方案： 如果Python服务还在本地运行，可以先跳过，等后端部署成功后再处理

⚙️ 阶段3：环境变量准备

必填变量（缺一不可）

  • NODE_ENV=development
  • DATABASE_URL=postgresql://...（替换为真实RDS地址）
  • OSS_REGION=oss-cn-hangzhou
  • OSS_BUCKET=aiclinical-dev
  • OSS_ACCESS_KEY_ID=你的ID
  • OSS_ACCESS_KEY_SECRET=你的Secret
  • DEEPSEEK_API_KEY=你的Key（或其他LLM API Key）
  • JWT_SECRET=随机字符串32位以上

推荐配置

  • CACHE_TYPE=memory（初期不用Redis）
  • QUEUE_TYPE=memory
  • LOG_LEVEL=debug（开发环境）
  • CORS_ORIGIN=*（开发环境）

特殊字符检查

  • 所有密码和密钥不包含 @ # $ % & 空格
  • DATABASE_URL中的密码已正确转义（如果有特殊字符）
  • JWT_SECRET是随机生成的（不要用默认值！）

快速验证：

# 复制 .env.sae.example 内容到文本编辑器
# 逐行替换所有"你的XXX"
# 确认没有遗漏

🚀 阶段4：SAE应用创建

基本配置

  • 应用名称：aiclinical-backend-dev
  • VPC 与 RDS 在同一个VPC
  • 镜像地址：registry.cn-hangzhou.aliyuncs.com/aiclinical/backend-dev:v1.0.0
  • 端口：3001
  • 实例规格：1核2GB
  • 实例数：1（固定）

网络配置

  • 已勾选「公网访问」
  • 公网SLB已自动创建
  • 端口映射：3001 → 3001

健康检查

  • 检查方式：HTTP
  • 检查路径：/health
  • 端口：3001
  • 初始延迟：30秒
  • 检查间隔：10秒
  • 超时时间：3秒

环境变量

  • 所有必填环境变量已配置
  • 环境变量值已替换为真实值
  • 数据库URL格式正确
  • OSS密钥正确
  • JWT_SECRET已修改

✅ 阶段5：部署验证

部署状态

  • SAE应用状态显示「运行中」
  • 健康检查显示「通过」
  • 实时日志无ERROR
  • 日志显示「✅ 数据库连接成功」
  • 日志显示「📦 使用阿里云 OSS 存储」或「📁 使用本地文件存储」

接口测试

  • /health 接口返回 200
  • 返回JSON包含 {"status":"ok"}
  • 返回JSON包含 "database":"connected"

测试命令：

# 替换为你的SAE公网地址
curl http://你的SAE地址:3001/health

# 或在浏览器访问

数据库验证

  • 数据库Schema已创建
  • 必要的表已创建（prisma_migrations等）
  • 测试数据可以插入

验证SQL：

-- 连接到RDS
\c aiclinical_dev

-- 查看Schema
SELECT schema_name FROM information_schema.schemata;

-- 查看表
\dt platform_schema.*
\dt aia_schema.*

OSS验证

  • 测试文件上传成功
  • 在OSS控制台能看到上传的文件
  • 文件可以正常下载

🌐 阶段6：前端部署

构建准备

  • frontend-v2/vite.config.ts 已配置正确的后端地址
  • 环境变量 VITE_API_BASE_URL 已设置
  • 依赖已安装（npm install）
  • 构建成功（npm run build）
  • dist/ 目录生成

OSS上传

  • 前端文件已上传到OSS
  • 文件路径正确（可以放在 frontend/ 目录下）
  • index.html 设置为默认首页
  • 静态网站托管已开启

访问验证

  • 前端URL可以访问
  • 页面正常显示（无404）
  • 前端可以连接后端API
  • 登录功能正常
  • 文件上传功能正常

快速验证：

访问：http://aiclinical-dev.oss-cn-hangzhou.aliyuncs.com/
或：https://aiclinical-dev.oss-cn-hangzhou.aliyuncs.com/（如果配置了CDN）

📊 阶段7：监控配置（可选）

SAE监控

  • 应用监控已开启
  • CPU使用率图表正常
  • 内存使用率图表正常
  • QPS图表正常

日志查询

  • 实时日志可查看
  • 历史日志可查询
  • 日志级别设置正确

告警配置（可选）

  • CPU告警（>80%）
  • 内存告警（>80%）
  • 错误率告警（>5%）

🎉 完成！

最终验证清单

  • 后端健康检查通过
  • 前端页面可访问
  • 前后端通信正常
  • 数据库读写正常
  • OSS文件上传下载正常
  • 日志记录正常
  • 无ERROR日志

重要信息记录

请将以下信息保存到安全的地方（推荐使用密码管理器）：

【部署信息】

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

RDS连接：
- 地址：_______________
- 数据库：aiclinical_dev
- 用户名：aiclinical
- 密码：_______________

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

镜像仓库：
- 命名空间：aiclinical
- 仓库：backend-dev
- 最新版本：_______________
- 登录密码：_______________

部署时间：_______________
部署人：_______________

🆘 遇到问题？

快速排查步骤

  1. 查看实时日志

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

  2. 检查环境变量

    • SAE控制台 → 应用详情 → 环境变量
    • 确认所有变量正确

  3. 测试网络连通性

    • 后端能否连接RDS
    • 后端能否连接OSS
    • 前端能否连接后端

  4. 查看详细文档

    • docs/05-部署文档/02-SAE部署完全指南(产品经理版).md
    • 里面有详细的问题排查方法

版本： v1.0
最后更新： 2025-12-11
维护者： 技术架构师

Reference in New Issue View Git Blame Copy Permalink