Summary: - Fix pg-boss queue conflict (duplicate key violation on queue_pkey) - Add global error listener to prevent process crash - Reduce connection pool from 10 to 4 - Add graceful shutdown handling (SIGTERM/SIGINT) - Fix researchWorker recursive call bug in catch block - Make screeningWorker idempotent using upsert Security Standards (v1.1): - Prohibit recursive retry in Worker catch blocks - Prohibit payload bloat (only store fileKey/ID in job.data) - Require Worker idempotency (upsert + unique constraint) - Recommend task-specific expireInSeconds settings - Document graceful shutdown pattern New Features: - PKB signed URL endpoint for document preview/download - pg_bigm installation guide for Docker - Dockerfile.postgres-with-extensions for pgvector + pg_bigm Documentation: - Update Postgres-Only async task processing guide (v1.1) - Add troubleshooting SQL queries - Update safety checklist Tested: Local verification passed
存储服务
模块定位: 平台基础层
优先级: P1
状态: ⏳ 待设计
📋 模块概述
存储服务负责统一管理平台的文件存储,支持:
- 文件上传、下载、删除
- 对象存储(OSS/S3)
- 本地文件系统(单机版)
- 文件权限控制
🎯 核心功能
1. 文件上传
- 支持多种文件格式
- 文件大小限制
- 文件类型验证
2. 对象存储
- 云端:MinIO/阿里云OSS
- 单机版:本地文件系统
3. 文件访问控制
- 临时访问URL(签名URL)
- 权限验证
📂 文档结构
02-存储服务/
├── 00-需求分析/
│ └── README.md
├── 01-设计文档/
│ └── README.md
└── README.md # ✅ 当前文档
最后更新: 2025-11-06
维护人: 技术架构师