Files
ai-soulmate-local-deployment/README.md
T

67 lines
3.6 KiB
Markdown

# AI SoulMate 本地部署与硬件适配
## 从这里开始
先阅读 [Ubuntu 22.04 本地部署运行手册](docs/DEPLOYMENT-RUNBOOK.md)、[后端本地部署](docs/BACKEND-DEPLOYMENT.md)、[平台前端本地部署](docs/FRONTEND-DEPLOYMENT.md)、[管理端本地部署](docs/ADMIN-DEPLOYMENT.md)、[样机硬件评估报告](docs/POC-HARDWARE-BASELINE.md) 和 [源码版本核对](docs/SOURCE-RECONCILIATION.md)。当前可以启动 PostgreSQL、Redis、MinIO、平台后端、平台前端和 AI SoulMate 管理端;统一网关仍在后续阶段。
本仓库是 AI SoulMate 私有化部署的编排与留档仓库,用于固定源码版本、记录硬件基线、建设部署配置并沉淀压测结果。业务源码仍保留在各自仓库中,不复制源码、不改写原有 Git 历史。
## 当前结论
- 当前 HP ZCentral 4R 样机适合做单机适配、功能跑通和容量边界测试,不作为生产高可用样板。
- 第一阶段在中心服务器部署平台后端、平台前端、AI SoulMate 管理端、PostgreSQL、Redis、本地对象存储和统一网关。
- Tripo 暂时继续走外部 API,因此这是“业务数据和基础设施本地化”,不是完全离线部署。
- 农场端 `ai-soulmate-client` 暂不部署到中心服务器,后续放到靠近打印机的工作站。
- 网关能力是必需的,但现有 `nginx-server` 的公网域名和固定路由不能原样交付,需要在本仓库形成私有部署配置。
## 仓库边界
| 内容 | 保存位置 |
| --- | --- |
| Python/Vue 平台源码 | `ai-soulmate-server` |
| 农场端 Spring Boot/Vue 源码 | `ai-soulmate-client` |
| 管理端源码 | `mlkj-admin` |
| 部署编排、版本锁定、脚本和文档 | 本仓库 |
| 小型压测报告和容量结论 | `results/reports/` |
| 大型原始日志 | `results/raw/`,默认不进入 Git |
| 密钥、证书和真实密码 | 不进入 Git |
## 目录
- `docs/`:架构、改造路线、样机基线和压测方案。
- `docs/CROSS-COMPUTER-HANDOFF.md`:换电脑继续工作的状态、重建 Git 和接管清单。
- `decisions/`:影响交付方式的架构决策。
- `inventory/`:参与部署的源码版本清单。
- `compose/`:基础设施、平台后端和平台前端 Compose 编排。
- `scripts/`:硬件与运行状态采集脚本。
- `benchmark/`:压测场景和单次运行元数据模板。
- `results/`:压测报告与不入库的原始数据。
## 推荐执行顺序
1. 固化样机硬件、网络、系统和源码版本基线。
2. 完成后端对象存储适配、生产镜像和单机 Compose。
3. 完成平台前端、管理端 AI-only 模式和统一网关。
4. 在样机上完成联网 POC,验证 Tripo 出站访问和全业务链路。
5. 先测本地链路容量,再单独测包含 Tripo 的端到端体验。
6. 增加农场工作站,验证任务下发、断线恢复和打印机适配。
7. 根据重复压测数据形成不同客户硬件档位,不凭 CPU/内存规格直接承诺并发量。
详细任务见 [改造路线](docs/IMPLEMENTATION-ROADMAP.md)。
## 样机首次采集
在 Ubuntu 样机上执行:
```bash
./scripts/collect-host-facts.sh > results/raw/host-facts-$(date +%Y%m%d-%H%M%S).txt
```
采集结果不包含 IP、MAC、磁盘序列号和机器 UUID。原始文件默认不入 Git;评审后将脱敏结论写入 `results/reports/`。
## 版本规则
- 每次可复现部署必须记录三个源码提交、容器镜像 digest、配置版本和数据库迁移版本。
- 建议用 `poc-YYYYMMDD.N`、`rc-X.Y.Z`、`release-X.Y.Z` 标记部署仓库版本。
- 本仓库只保存示例变量名;真实值由现场 `.env`、密钥文件或客户密钥系统提供。