Files
moyi-model-intelligence-hub/docs/09-java-control-plane-node.md
T

74 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 地址。