feat(platform): Complete Postgres-Only architecture refactoring (Phase 1-7)

Major Changes:
- Implement Platform-Only architecture pattern (unified task management)
- Add PostgresCacheAdapter for unified caching (platform_schema.app_cache)
- Add PgBossQueue for job queue management (platform_schema.job)
- Implement CheckpointService using job.data (generic for all modules)
- Add intelligent threshold-based dual-mode processing (THRESHOLD=50)
- Add task splitting mechanism (auto chunk size recommendation)
- Refactor ASL screening service with smart mode selection
- Refactor DC extraction service with smart mode selection
- Register workers for ASL and DC modules

Technical Highlights:
- All task management data stored in platform_schema.job.data (JSONB)
- Business tables remain clean (no task management fields)
- CheckpointService is generic (shared by all modules)
- Zero code duplication (DRY principle)
- Follows 3-layer architecture principle
- Zero additional cost (no Redis needed, save 8400 CNY/year)

Code Statistics:
- New code: ~1750 lines
- Modified code: ~500 lines
- Test code: ~1800 lines
- Documentation: ~3000 lines

Testing:
- Unit tests: 8/8 passed
- Integration tests: 2/2 passed
- Architecture validation: passed
- Linter errors: 0

Files:
- Platform layer: PostgresCacheAdapter, PgBossQueue, CheckpointService, utils
- ASL module: screeningService, screeningWorker
- DC module: ExtractionController, extractionWorker
- Tests: 11 test files
- Docs: Updated 4 key documents

Status: Phase 1-7 completed, Phase 8-9 pending
This commit is contained in:
2025-12-13 16:10:04 +08:00
parent a3586cdf30
commit fa72beea6c
135 changed files with 17508 additions and 91 deletions

136
deploy-to-sae.ps1 Normal file
View File

@@ -0,0 +1,136 @@
# ===================================================================
# AI临床研究平台 - SAE部署自动化脚本
# ===================================================================
# 用途自动构建Docker镜像并推送到阿里云容器镜像服务
# 使用方法:.\deploy-to-sae.ps1 -Version "v1.0.0"
# 作者:技术架构师
# 日期2025-12-11
# ===================================================================
param(
[Parameter(Mandatory=$true)]
[string]$Version,
[Parameter(Mandatory=$false)]
[string]$Registry = "registry.cn-hangzhou.aliyuncs.com",
[Parameter(Mandatory=$false)]
[string]$Namespace = "aiclinical",
[Parameter(Mandatory=$false)]
[string]$Repository = "backend-dev"
)
# 颜色输出函数
function Write-ColorOutput($ForegroundColor) {
$fc = $host.UI.RawUI.ForegroundColor
$host.UI.RawUI.ForegroundColor = $ForegroundColor
if ($args) {
Write-Output $args
}
$host.UI.RawUI.ForegroundColor = $fc
}
# 标题
Write-ColorOutput Cyan "================================================"
Write-ColorOutput Cyan " AI临床研究平台 - SAE部署脚本"
Write-ColorOutput Cyan "================================================"
Write-Host ""
# 检查Docker是否运行
Write-ColorOutput Yellow "🔍 检查Docker状态..."
try {
docker ps > $null 2>&1
if ($LASTEXITCODE -ne 0) {
Write-ColorOutput Red "❌ Docker未运行请先启动Docker Desktop"
exit 1
}
Write-ColorOutput Green "✅ Docker运行正常"
} catch {
Write-ColorOutput Red "❌ Docker未安装或未运行"
exit 1
}
# 构建镜像
Write-Host ""
Write-ColorOutput Yellow "🔨 开始构建Docker镜像..."
Write-Host "版本: $Version"
Write-Host "目录: backend/"
Write-Host ""
Set-Location backend
$imageName = "aiclinical-backend"
$fullImageName = "${Registry}/${Namespace}/${Repository}:${Version}"
Write-ColorOutput Cyan "执行: docker build -t ${imageName}:${Version} ."
docker build -t "${imageName}:${Version}" .
if ($LASTEXITCODE -ne 0) {
Write-ColorOutput Red "❌ Docker镜像构建失败"
exit 1
}
Write-ColorOutput Green "✅ Docker镜像构建成功"
# 打标签
Write-Host ""
Write-ColorOutput Yellow "🏷️ 为镜像打标签..."
Write-ColorOutput Cyan "执行: docker tag ${imageName}:${Version} ${fullImageName}"
docker tag "${imageName}:${Version}" $fullImageName
if ($LASTEXITCODE -ne 0) {
Write-ColorOutput Red "❌ 打标签失败"
exit 1
}
Write-ColorOutput Green "✅ 标签创建成功"
# 推送镜像
Write-Host ""
Write-ColorOutput Yellow "📤 推送镜像到阿里云..."
Write-Host "目标仓库: $fullImageName"
Write-Host ""
Write-ColorOutput Cyan "提示:如果提示需要登录,请执行以下命令:"
Write-ColorOutput Cyan "docker login --username=<你的阿里云账号> ${Registry}"
Write-Host ""
Write-ColorOutput Cyan "执行: docker push ${fullImageName}"
docker push $fullImageName
if ($LASTEXITCODE -ne 0) {
Write-ColorOutput Red "❌ 镜像推送失败"
Write-ColorOutput Yellow "请检查:"
Write-Host " 1. 是否已登录阿里云容器镜像服务"
Write-Host " 2. 命名空间和仓库名称是否正确"
Write-Host " 3. 网络连接是否正常"
exit 1
}
Write-ColorOutput Green "✅ 镜像推送成功"
# 完成
Write-Host ""
Write-ColorOutput Cyan "================================================"
Write-ColorOutput Green "🎉 部署准备完成!"
Write-ColorOutput Cyan "================================================"
Write-Host ""
Write-Host "镜像信息:"
Write-ColorOutput Cyan " 完整地址: $fullImageName"
Write-ColorOutput Cyan " 版本号: $Version"
Write-Host ""
Write-Host "下一步操作:"
Write-Host " 1. 登录阿里云SAE控制台"
Write-Host " 2. 进入应用 '${Repository}'"
Write-Host " 3. 点击'部署应用'"
Write-Host " 4. 选择镜像版本: $Version"
Write-Host " 5. 点击'确定'开始部署"
Write-Host ""
Write-ColorOutput Cyan "部署文档: docs/05-部署文档/02-SAE部署完全指南(产品经理版).md"
Write-Host ""
Set-Location ..