Files
ai-soulmate-local-deployment/docs/IMPLEMENTATION-ROADMAP.md
T

68 lines
3.1 KiB
Markdown

# 本地部署改造路线
## P0:冻结基线
- [x] 记录现有三个源码仓库提交。
- [x] 记录样机 CPU、内存、磁盘、操作系统和网络状态。
- [ ] 为四个源码仓库建立本地部署开发分支和对应需求清单。
- [ ] 确认数据库版本、现有数据量、OSS 对象量和允许停机窗口。
验收:任何一次测试都能关联到硬件、源码、配置和数据集版本。
## P1:平台后端与对象存储解耦
- [ ] 将阿里 OSS 调用收敛为对象存储接口。
- [ ] 实现 Alibaba OSS 与本地 S3 兼容存储两个 provider。
- [ ] 验证预签名上传/下载、分片上传、CORS、文件元数据和清理任务。
- [ ] 将 Tripo 封装为 provider,保留外部 API,并为未来私有端点预留配置。
- [ ] 移除生产 Compose 中的源码 bind mount,构建不可变镜像。
验收:切换存储 provider 不需要修改业务代码;对象迁移后原有 URL 使用场景可回归。
## P2:管理端 AI-only 模式
- [ ] 增加 `ai-soulmate-only` 配置或 profile。
- [ ] 非 AI SoulMate 数据源和模块在该模式下不初始化。
- [ ] 管理端对象存储改用同一 provider/兼容接口。
- [ ] 清理默认账号、测试数据和固定密码。
验收:只配置 AI SoulMate 数据库即可启动管理端并完成核心管理功能。
## P3:可交付单机编排
- [ ] 编排网关、前后端、管理端、PostgreSQL、Redis 和对象存储。
- [ ] 所有镜像固定版本或 digest,服务带健康检查与资源限制。
- [ ] 提供初始化、升级、回滚、备份、恢复和日志收集脚本。
- [ ] 将持久化目录与容器生命周期分离,定义磁盘容量告警。
- [ ] 默认只开放 `22`(受限管理)和 `443`(业务)端口。
验收:在干净 Ubuntu 22.04 主机上按文档可重复安装、重启和恢复。
## P4:样机 POC
- [ ] 激活有线网络并分配固定地址,校准 NTP,验证 DNS 与 Tripo 出站访问。
- [ ] 导入脱敏数据库和对象样本,执行数据库迁移。
- [ ] 回归登录、模型生成、上传下载、订单/任务和管理端流程。
- [ ] 完成一次备份恢复演练和宿主机重启演练。
验收:核心业务链路跑通,重启无数据丢失,备份能够在空环境恢复。
## P5:农场工作站接入
- [ ] 将前端改为生产构建,不使用 Vite 开发服务器。
- [ ] 每台设备使用独立身份和可撤销凭证,替换全局客户端令牌。
- [ ] 实现任务幂等、断线续传、失败重试和本地队列上限。
- [ ] 验证 Moonraker/打印机协议、升级和远程诊断。
验收:中心短暂断网后任务不重复、不丢失,恢复后状态最终一致。
## P6:容量测试与客户档位
- [ ] 先测本地只读、写入、文件和混合负载。
- [ ] 再测包含 Tripo 的端到端链路,并剥离外部等待时间。
- [ ] 分别测试当前 32GB 和内存升级后的配置。
- [ ] 将稳定并发、瓶颈、资源余量和推荐参数写入版本化报告。
验收:每个客户硬件档位都由可复现的测试数据支撑,并明确适用业务模型与 SLA。