chore: initialize local deployment baseline
This commit is contained in:
commit
9e2196d69f
30 files changed
+1436
No files matched your search
@@ -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。
|
||||
|
||||
Reference in new issue
Block a user