2026-09-07 16:54:43 +08:00
|
|
|
|
# Java Control Plane 节点一:基础控制面
|
|
|
|
|
|
|
|
|
|
|
|
## 节点目标
|
|
|
|
|
|
|
|
|
|
|
|
把前端原型依赖的核心控制面接口迁移到 Java 21 / Spring Boot,并让本地 Docker Compose 可以使用同一套数据库迁移脚本启动:
|
|
|
|
|
|
|
|
|
|
|
|
- 邀请码注册、账号密码登录、会话 Cookie、退出登录;
|
|
|
|
|
|
- 当前用户、管理员用户列表、邀请码管理、审计记录;
|
|
|
|
|
|
- 供应商和模型目录读取;
|
|
|
|
|
|
- 项目创建与查询;
|
|
|
|
|
|
- API Key 创建、明文一次性返回、撤销和模型权限配置;
|
2026-09-07 17:04:23 +08:00
|
|
|
|
- 最小 OpenAI 兼容 `GET /v1/models` 与 `POST /v1/chat/completions` 接口;DeepSeek、Kimi、GLM 配置服务端 Key 后走真实上游,未配置时保留 Mock。
|
2026-09-07 16:54:43 +08:00
|
|
|
|
|
|
|
|
|
|
## 已落地接口
|
|
|
|
|
|
|
|
|
|
|
|
| 接口 | 权限 | 用途 |
|
|
|
|
|
|
| --- | --- | --- |
|
|
|
|
|
|
| `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 有权限的模型 |
|
2026-09-07 17:04:23 +08:00
|
|
|
|
| `POST /v1/chat/completions` | 平台 API Key | 同步聊天调用(已配置供应商 Key 时转发真实上游) |
|
2026-09-07 16:54:43 +08:00
|
|
|
|
|
|
|
|
|
|
## 数据库迁移
|
|
|
|
|
|
|
|
|
|
|
|
- `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`:本地首批模型目录初始数据,可由管理员继续增删改造。
|
|
|
|
|
|
|
2026-09-07 17:23:18 +08:00
|
|
|
|
Java 版本沿用现有 TypeScript 服务的表命名,便于后续迁移 RDS;供应商密钥只返回掩码,数据库保存 AES-GCM 密文,主密钥由 `CREDENTIAL_ENCRYPTION_KEY` 注入。生产环境应进一步使用 KMS/RAM 托管该主密钥。
|
2026-09-07 16:54:43 +08:00
|
|
|
|
|
|
|
|
|
|
## 本地启动
|
|
|
|
|
|
|
|
|
|
|
|
```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 密码。
|
|
|
|
|
|
|
|
|
|
|
|
## 验收边界
|
|
|
|
|
|
|
2026-09-07 17:04:23 +08:00
|
|
|
|
本节点完成的是“控制面基础闭环 + 同步供应商转发”,不是生产网关完成版:
|
2026-09-07 16:54:43 +08:00
|
|
|
|
|
|
|
|
|
|
- 数据已写入 PostgreSQL,Redis 连接配置已预留,但限流、队列和分布式幂等尚未接入;
|
2026-09-07 17:23:18 +08:00
|
|
|
|
- `/v1/chat/completions` 已支持 DeepSeek、Kimi、GLM 的 OpenAI 兼容转发;管理员在目录中新增带凭证的兼容供应商后,也可按模型绑定动态渠道;未配置 Key 时返回 Mock,流式响应暂未开放;
|
2026-09-07 16:54:43 +08:00
|
|
|
|
- Seedance、Tripo/VAST 的异步任务和 OSS 结果存储尚未迁移到 Java;
|
|
|
|
|
|
- 价格、额度扣减、计费账单和并发排队仍沿用下一节点计划;
|
|
|
|
|
|
- Docker 镜像需要在具备 Maven 和 Docker daemon 的环境中构建验证。
|
|
|
|
|
|
|
|
|
|
|
|
## 下一节点
|
|
|
|
|
|
|
2026-09-07 17:04:23 +08:00
|
|
|
|
1. 为真实同步转发补充超时、重试、熔断、响应脱敏和用量事件记录;
|
2026-09-07 16:54:43 +08:00
|
|
|
|
2. 接入 Redis 限流、并发计数、幂等键和异步任务状态;
|
|
|
|
|
|
3. 接入 Tripo/Seedance 异步任务与 OSS 私有对象;
|
|
|
|
|
|
4. 用 RDS、Redis、OSS 的测试资源完成云上验收,再切换前端的 Java API 地址。
|