项目概述

gptimage-gateway 是一个多租户图像生成平台，基于 Next.js 16 App Router 与 PostgreSQL 16 构建。它在底层图像生成服务之上封装出完整的租户化产品形态，支持浏览器用户与外部 API 调用方两种使用模式。

核心能力

• 浏览器注册、登录与仪表盘：内置落地页、登录、注册、Dashboard。
• 多工作区切换：同一用户可属于多个 workspace，所有操作在当前选中 workspace 内进行。
• 角色化成员：owner / admin / member 三级权限，覆盖 API Key 创建、撤销、成员管理。
• 租户 API Key：一次性显示、可撤销，适配外部系统集成。
• 额度计费与退款：网关层统一扣减额度，上游失败时自动退款。
• Dashboard Playground 与公开 API 共享同一管线：体验一致。
• 任务与产物持久化：jobs、outputs、usage events 写入 PostgreSQL。
• 参考图编辑：通过 images: [] 标识 text-to-image 或 reference-image 编辑流程。
• 统一请求参数：quality / aspectRatio / resolution / n 标准化处理。

技术栈

• Next.js 16 App Router
• React 19
• TypeScript
• PostgreSQL 16
• pg / bcryptjs / zod
• pnpm