# 本地部署改造路线 ## 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。