feat: migrate java control plane foundation

This commit is contained in:
wlx committed 2026-09-07 16:54:43 +08:00
1 parent 1615401185
commit 9da175c040
24 files changed
+1555 -12

No files matched your search

+7 -5
View File
@@ -25,10 +25,10 @@ Java 服务使用环境变量读取数据库、Redis、OSS 和供应商配置。
1. Java 工程启动、健康检查和基础配置。
2. PostgreSQL Flyway 迁移:用户、邀请码、会话、工作区、供应商、模型、Key、用量、审计。
3. Redis 会话与限流:替换内存 session、登录限流和幂等键。
4. 认证接口迁移:保持 `/api/auth/*` 返回结构兼容。
5. 模型目录和供应商来源迁移:保持 `/api/models`、`/api/admin/providers`、`/api/admin/models` 兼容。
6. API Key、模型权限、统一 `/v1/*` 调用和供应商适配迁移。
3. 认证接口迁移:保持 `/api/auth/*` 返回结构兼容。
4. 模型目录、项目、Key、模型权限和最小 `/v1/*` Mock 接口迁移(当前节点已完成)。
5. Redis 会话/限流、并发计数、幂等键和任务队列。
6. 同步供应商适配:先接入一个真实文本/多模态模型,再扩展其他厂商。
7. 异步任务、队列、OSS 结果文件和 Webhook 迁移。
8. 监控、备份、压测、灰度和回滚验证。
@@ -36,7 +36,7 @@ Java 服务使用环境变量读取数据库、Redis、OSS 和供应商配置。
### 现在必须提供
本阶段只需要确认部署边界,不需要把真实密码或 API Key 发到聊天中:
本阶段只需要确认部署边界,不需要把真实密码或 API Key 发到聊天中。若使用托管 RDS、Redis、OSS,应用容器只保存连接配置,不在服务器本地运行这些基础设施:
- 云服务器是否使用现有服务器;操作系统、CPU/内存/磁盘、CPU 架构和 Docker / Compose 版本。
- 计划使用的域名、DNS 管理方式、是否已有 Nginx/Caddy、HTTPS 证书和备案状态。
@@ -44,6 +44,8 @@ Java 服务使用环境变量读取数据库、Redis、OSS 和供应商配置。
- 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 和限额。
+73
View File
@@ -0,0 +1,73 @@
# 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 地址。