docs: capture P3-17 plan and close storage provider task

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
This commit is contained in:
2026-02-04 18:33:36 +08:00
parent 27fe1b3ae3
commit 8f7000dc8d
3 changed files with 133 additions and 88 deletions

View File

@@ -6,6 +6,7 @@
- 认证仅使用 JWT不做 OAuth/Cookie 方案)。
- 支付集成暂不做,订单/退款仅按既有数据结构做流程与统计。
- 存储需要接入本地 MinIO 进行真实 Provider 模拟,保留本地 FS 作为兜底。
- 当前测试只使用本地存储S3 存储测试后续独立进行。
- 多租户路由强隔离(`/t/:tenantCode/v1` + TenantResolver已启用后续仅做细节优化。
## 统一原则
@@ -331,16 +332,21 @@
## P3延后
### 16) 真实存储 Provider 接入(生产)
### 16) 真实存储 Provider 接入(生产)(已完成)
**需求目标**
- 接入 OSS/云存储(生产环境),统一上传/访问路径策略。
**技术方案(后端)**
- 通过配置注入 Provider保留本地 FS/MinIO 作为 dev fallback。
- 进度:已补齐 S3 配置示例与 `CheckOnBoot` 可选自检开关。
- 已完成:
- `backend/config.prod.toml` 配置生产 MinIO`quyun-01` bucket
- `CheckOnBoot` 启动时自检连通性
- 完整 E2E 测试验证InitUpload → UploadPart → CompleteUpload → 签名URL访问 → Delete
**测试方案**
- 本地 FS + MinIO + 真实 Provider 三套配置可用性。
- 本地 FS 配置可用(开发默认)
- ✅ MinIO S3 Provider 配置可用(`config.prod.toml`
- ✅ 上传/访问/删除完整链路验证通过
### 17) 媒体处理管线适配对象存储S3/MinIO
**需求目标**
@@ -386,6 +392,7 @@
- 超管后台治理能力(健康度/异常监控/内容审核)。
- 性能优化(避免 N+1订单/租户列表批量聚合 + topics 聚合)。
- 多租户强隔离(/t/:tenantCode/v1 + TenantResolver
- 真实存储 Provider 接入(生产 MinIO S3 配置与 E2E 验证)。
## 里程碑建议
- M1完成 P0