chore: initialize local deployment baseline

This commit is contained in:
wlx committed 2026-08-05 18:17:58 +08:00
commit 9e2196d69f
30 files changed
+1436

No files matched your search

@@ -0,0 +1,24 @@
# ADR-0002:本地对象存储通过兼容层接入
- 状态:待验证
- 日期:2026-08-05
## 背景
平台后端和管理端当前直接依赖阿里 OSS SDK。只替换连接地址不能构成本地部署,必须先解耦 SDK 和业务逻辑。
## 暂定决策
业务代码使用统一对象存储接口,至少实现 Alibaba OSS 与本地 S3 兼容存储两个 provider。具体本地产品不在完成兼容性测试前锁定;优先评估客户已有 S3 服务与许可证清晰、可离线交付的候选方案。
## 准入测试
- 服务端上传/下载/删除、对象存在性和元数据;
- 浏览器预签名 PUT/GET、CORS 和过期行为;
- 分片上传、大文件、中文文件名和内容类型;
- 权限隔离、凭证轮换、审计和容量配额;
- 备份、恢复、升级、磁盘满和异常断电恢复;
- 与现有 OSS URL/对象数据的迁移和回滚。
通过准入测试并确认许可证、运维与备份责任后,再将选定实现加入正式 Compose。