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

+22
View File
@@ -0,0 +1,22 @@
# ADR-0001:部署仓库与业务源码分离
- 状态:已接受
- 日期:2026-08-05
## 决策
建立独立的 `ai-soulmate-local-deployment` Git 仓库,保存部署编排、环境模板、版本清单、硬件基线、迁移工具和容量报告。三个业务源码仓库继续独立演进,本仓库通过提交 SHA 和容器镜像 digest 锁定可复现版本。
## 原因
- 保留各系统现有历史、权限和发布节奏;
- 客户部署只需要一个明确入口,不需要人工拼接多个仓库配置;
- 同一套业务源码可以同时支持云部署和私有部署,避免复制出不可维护的代码分叉;
- 部署版本可以独立对应某次硬件适配和压测报告。
## 约束
- 通用本地化能力应回到对应源码仓库,通过配置或 provider 开关启用。
- 本仓库不使用 Git submodule;交付优先使用固定 digest 的镜像,开发期才按清单检出源码。
- 密钥、客户数据和大型原始压测日志不进入 Git。
@@ -0,0 +1,24 @@
# ADR-0002:本地对象存储通过兼容层接入
- 状态:待验证
- 日期:2026-08-05
## 背景
平台后端和管理端当前直接依赖阿里 OSS SDK。只替换连接地址不能构成本地部署,必须先解耦 SDK 和业务逻辑。
## 暂定决策
业务代码使用统一对象存储接口,至少实现 Alibaba OSS 与本地 S3 兼容存储两个 provider。具体本地产品不在完成兼容性测试前锁定;优先评估客户已有 S3 服务与许可证清晰、可离线交付的候选方案。
## 准入测试
- 服务端上传/下载/删除、对象存在性和元数据;
- 浏览器预签名 PUT/GET、CORS 和过期行为;
- 分片上传、大文件、中文文件名和内容类型;
- 权限隔离、凭证轮换、审计和容量配额;
- 备份、恢复、升级、磁盘满和异常断电恢复;
- 与现有 OSS URL/对象数据的迁移和回滚。
通过准入测试并确认许可证、运维与备份责任后,再将选定实现加入正式 Compose。