# Java Control Plane 节点一:基础控制面 ## 节点目标 把前端原型依赖的核心控制面接口迁移到 Java 21 / Spring Boot,并让本地 Docker Compose 可以使用同一套数据库迁移脚本启动: - 邀请码注册、账号密码登录、会话 Cookie、退出登录; - 当前用户、管理员用户列表、邀请码管理、审计记录; - 供应商和模型目录读取; - 项目创建与查询; - API Key 创建、明文一次性返回、撤销和模型权限配置; - 最小 OpenAI 兼容 `GET /v1/models` 与 `POST /v1/chat/completions` Mock 接口。 ## 已落地接口 | 接口 | 权限 | 用途 | | --- | --- | --- | | `POST /api/auth/login` | 公开 | 账号密码登录 | | `POST /api/auth/register` | 公开 | 邀请码注册 | | `GET /api/auth/me` | 登录用户 | 当前会话用户 | | `POST /api/auth/logout` | 登录用户 | 撤销当前会话 | | `GET /api/models` | 登录用户 | 用户端模型广场目录 | | `GET/POST /api/projects` | 登录用户 | 工作区/项目基础管理 | | `GET/POST /api/keys` | 登录用户 | API Key 管理 | | `POST /api/keys/{id}/models` | Key 所属用户 | 修改模型权限 | | `POST /api/keys/{id}/revoke` | Key 所属用户 | 撤销 API Key | | `GET/POST /api/admin/providers` | 管理员 | 供应商目录管理 | | `GET/POST /api/admin/models` | 管理员 | 模型目录管理 | | `GET/POST /api/admin/invitations` | 管理员 | 邀请码管理 | | `GET /api/admin/users` | 管理员 | 用户列表 | | `GET /api/admin/audit` | 管理员 | 审计记录 | | `GET /v1/models` | 平台 API Key | 返回该 Key 有权限的模型 | | `POST /v1/chat/completions` | 平台 API Key | Mock 同步聊天调用 | ## 数据库迁移 - `V1__auth.sql`:用户、邀请码、会话、审计; - `V2__catalog_and_keys.sql`:供应商、模型目录、API Key; - `V3__projects.sql`:项目和 Key 项目归属; - `V4__catalog_channels.sql`:供应商凭证元数据、模型来源分组、价格和并发字段; - `V5__usage_events.sql`:用量事件基础表; - `V6__seed_catalog.sql`:本地首批模型目录初始数据,可由管理员继续增删改造。 Java 版本沿用现有 TypeScript 服务的表命名,便于后续迁移 RDS;供应商密钥当前只返回掩码并预留密文列,真实调用接入前需要补齐 KMS/RAM 或 AES-GCM 密钥管理。 ## 本地启动 ```powershell cd infra/moyi Copy-Item .env.example .env docker compose build docker compose up -d Invoke-WebRequest http://localhost:8080/health ``` 默认开发管理员来自 `.env`:`ADMIN_ACCOUNT=adimin`,首次启动时由 Java 服务创建。生产环境必须替换管理员密码、密码 Pepper、数据库密码和 Redis 密码。 ## 验收边界 本节点完成的是“控制面基础闭环”,不是生产网关完成版: - 数据已写入 PostgreSQL,Redis 连接配置已预留,但限流、队列和分布式幂等尚未接入; - `/v1/chat/completions` 目前返回 Java Mock,不会自动调用 DeepSeek、Kimi 或 GLM; - Seedance、Tripo/VAST 的异步任务和 OSS 结果存储尚未迁移到 Java; - 价格、额度扣减、计费账单和并发排队仍沿用下一节点计划; - Docker 镜像需要在具备 Maven 和 Docker daemon 的环境中构建验证。 ## 下一节点 1. 把模型供应商适配器迁移为 Java HTTP 客户端,先接入一个同步模型; 2. 接入 Redis 限流、并发计数、幂等键和异步任务状态; 3. 接入 Tripo/Seedance 异步任务与 OSS 私有对象; 4. 用 RDS、Redis、OSS 的测试资源完成云上验收,再切换前端的 Java API 地址。