# Java 后端与容器化部署基线 ## 一、技术决策 MOYI 后端从当前 TypeScript Control Plane 迁移到 Java 21 + Spring Boot。迁移采用并行替换:先保持现有 API 契约和前端不变,再按认证、目录、Key、路由、队列和任务顺序迁移接口。旧实现只有在 Java 版本完成同等接口、数据迁移和 UAT 后才下线。 目标组件: | 组件 | 责任 | 第一版部署方式 | |---|---|---| | Vue + Nginx | 用户端和管理端静态页面、同源反向代理 | `frontend` 容器 | | Java Control Plane | 认证、目录、Key、路由、计量和管理 API | `moyi-api` 容器 | | PostgreSQL | 业务数据和审计数据持久化 | `postgres` 容器或云数据库 | | Redis | 会话、限流、并发计数、幂等和任务队列 | `redis` 容器或云 Redis | | OSS | 图片、视频、3D 文件和用户上传文件 | 云 OSS,不放进应用镜像 | | Otari / Provider Adapter | 网关、模型上游和供应商适配 | 独立服务,按联调需要接入 | ## 二、容器边界 前端使用生产构建,不在生产运行 Vite dev server。Nginx 将 `/api/` 和 `/v1/` 代理到 Java 服务,浏览器只访问一个域名,因此不需要把数据库、Redis、供应商 Key 暴露给前端。 Java 服务使用环境变量读取数据库、Redis、OSS 和供应商配置。数据库密码、Redis 密码、管理员密码、OSS Secret 和供应商 API Key 不进入镜像、前端静态资源或 Git 仓库。 ## 三、迁移节点 1. Java 工程启动、健康检查和基础配置。 2. PostgreSQL Flyway 迁移:用户、邀请码、会话、工作区、供应商、模型、Key、用量、审计。 3. 认证接口迁移:保持 `/api/auth/*` 返回结构兼容。 4. 模型目录、项目、Key、模型权限和最小 `/v1/*` Mock 接口迁移(当前节点已完成)。 5. Redis 会话/限流、并发计数、幂等键和任务队列。 6. 同步供应商适配:先接入一个真实文本/多模态模型,再扩展其他厂商。 7. 异步任务、队列、OSS 结果文件和 Webhook 迁移。 8. 监控、备份、压测、灰度和回滚验证。 ## 四、云环境信息清单 ### 现在必须提供 本阶段只需要确认部署边界,不需要把真实密码或 API Key 发到聊天中。若使用托管 RDS、Redis、OSS,应用容器只保存连接配置,不在服务器本地运行这些基础设施: - 云服务器是否使用现有服务器;操作系统、CPU/内存/磁盘、CPU 架构和 Docker / Compose 版本。 - 计划使用的域名、DNS 管理方式、是否已有 Nginx/Caddy、HTTPS 证书和备案状态。 - PostgreSQL 使用云数据库还是 Docker;版本、内网地址、端口、数据库名、账号和网络白名单。 - Redis 使用云 Redis 还是 Docker;版本、内网地址、端口、是否 TLS、ACL 用户和网络白名单。 - OSS 使用哪家云厂商;Region、Endpoint、Bucket、内网访问 Endpoint、对象公开/私有策略和生命周期规则。 本地依赖使用 `docker-compose.yml`;云上托管依赖使用 `docker-compose.cloud.yml` 和 `.env.cloud.example`。 ### 开始真实联调前需要提供 - DeepSeek、Kimi、GLM、Seedance、Tripo/VAST 以及其他中转渠道的测试环境 Key、Base URL、模型 ID 和限额。 - 测试域名、回调/Webhook 地址、允许访问的 IP、日志和数据留存要求。 - 4—5 名内部测试用户、3—4 个项目的验收场景和预计并发。 - 额度、价格、失败扣费、退款、任务文件保留和超限策略。 ### 生产开放前再确认 - 生产域名、证书自动续期、备份周期、恢复目标、监控告警和应急联系人。 - 云数据库/Redis/OSS 的高可用、备份、跨可用区和访问审计方案。 - 供应商授权、数据出境/地区限制、隐私政策、用户协议、内容安全和日志脱敏边界。 - 发布审批、镜像签名或 digest、漏洞扫描、灰度发布和回滚方案。 ## 五、密钥交付方式 不要把 PostgreSQL 密码、Redis 密码、OSS AccessKey Secret 或模型 API Key 直接粘贴到聊天或 Git。建议由你在服务器上创建 `infra/moyi/.env`,或使用云厂商 Secrets Manager / KMS 注入;我只需要变量名、网络连通性和脱敏后的连接信息来完成配置和验证。