EasyAI AI Gateway

独立的 AI 网关中台脚手架，用于把现有 integration-platform 的平台管理、模型路由、计费预估、队列执行、Chat / 生图 / 生视频等生成能力逐步从 easyai-server-main 拆成可独立运行的项目。

技术选型

• 后端：Go + PostgreSQL，复用 Agent memory 的 easyai-pgvector，保留 server-main 的 JWT / API Key 授权语义。
• 前端：React + TypeScript + TSX，UI 体系按 shadcn-ui / Radix / Tailwind 方向沉淀，先提供运维控制台骨架。
• Monorepo：Nx 负责任务编排，Go 使用 go.work 管理模块。
• 集成：完成后由 easyai-server-main 通过内部 HTTP SDK 直连本服务，前端经网关访问本服务。

目录

apps/
  api/        Go HTTP API, auth middleware, PG store, migrations
  web/        React TSX admin console
packages/
  contracts/ Shared TypeScript DTO contracts
docs/
  design.md  Detailed architecture and migration design

本地启动

cp .env.example .env
pnpm install
pnpm dev

服务默认地址：

• API: http://localhost:8088
• Web: http://localhost:5178
• PostgreSQL: 默认使用宿主机 localhost:5432 上的 postgres 容器，并使用独立库 easyai_ai_gateway

默认 EasyAI 部署里，easyai-pgvector 在容器网络内的连接串是：

AI_GATEWAY_DATABASE_URL=postgresql://easyai:easyai2025@easyai-pgvector:5432/easyai_ai_gateway?schema=public

宿主机直跑时需要使用宿主机可访问的 Postgres 地址。如果 easyai-pgvector 将 5432 映射到了本机，可使用：

AI_GATEWAY_DATABASE_URL=postgresql://easyai:easyai2025@localhost:5432/easyai_ai_gateway?sslmode=disable

如果现有 easyai-pgvector 没有把 5432 映射到宿主机，就需要补端口映射，或者把 AI Gateway 后端容器化后接入同一个 easyai Docker network。

迁移原则

1. 新服务先并行运行，不直接删除 easyai-server-main 内现有模块。
2. 授权先复用 server-main 的 JWT secret、claim、角色权限模型。
3. OpenAPI sk-* 校验、文件上传、扣费结算仍由 server-main 承担。
4. 网关服务负责基准模型库、平台模型路由、TPM/RPM/并发限流、任务队列、三方平台执行、任务进度推送。
5. 切流时优先让 server-main 的 OpenaiService 变成薄门面，内部调用本服务。

详细设计见 docs/design.md。