文档

Console

客户后台的页面范围、对应接口与前端迁移

Console 是所有登录用户的客户后台,也是开发者的公开入口。它不是员工后台,员工使用 Admin。

两部分内容

  • 公开部分(无需登录):探索模型、公开价目表、充值与订阅套餐展示、开发文档与教程。
  • 登录后:账户、API Key、充值与订单、所有产品的积分余额和使用记录、安全设置。

页面范围

“接口”列是此前整理的 new-api 候选路径,不代表所选基线和现有前端已兼容。T-02 按实际源码、鉴权与返回类型逐项审计;全局身份、产品来源和非模型记录等平台能力需要新增或扩展。迁移方法见前端迁移。

页面主要操作接口首发
登录与注册注册、密码登录、找回密码;全局登录后回到原页面/api/user/register、/api/user/login、/api/user/reset;全局登录见身份与权限是
总览余额、消费趋势、最近调用/api/user/self、/api/data/self、/api/log/self/stat是
API Keys列表、搜索、创建、编辑、启停、删除;掩码旁复制完整 Key(不弹确认)/api/token/*、POST /api/token/:id/key是
探索模型与价目表模型介绍、分类、搜索、公开价格;登录后显示本人适用价格/api/pricing、/api/user/models是
使用记录所有产品的扣费记录,可按产品、模型、时间筛选;每笔能看到价格依据和计量单位/api/log/self,需新增“来源产品”字段及非模型扣费记录是
钱包与充值余额、充值、到账记录、支付状态查询/api/user/topup/info、/api/user/pay、/api/user/topup/self是,支付方式待定
兑换码兑换POST /api/user/topup按配置启用
套餐与权益购买与查看订阅/api/subscription/*待定;需先改造为人民币
任务记录本人的视频等异步任务及结果/api/task/self是
账户设置资料、密码、邮箱、通知偏好/api/user/self、/api/user/setting是
安全设置设备会话、撤销会话、本人审计;2FA、Passkey、第三方绑定/api/user/sessions、/api/user/2fa/*、/api/user/passkey会话首发;2FA 等按配置
Playground在线试用模型待定待定:保留,还是引导到 Studio

所有页面都要处理加载中、空数据、无权限、业务失败、网络结果未知和成功后回读等状态。

前端从哪里来

Console 前端基于现有仓库 products/oceanway-console 迁入平台仓库:

  • 保留:React 页面、组件和设计实现。它本来就参考 new-api 的接口编写,大部分调用的是 /api/user/*、/api/token/*、/api/pricing 等原版接口。
  • 去掉:server/ 下的 BFF 层(Node 中间层和它自己的会话库)。迁入后前端直接调用平台。
  • 需要改接:原来调用 /api/oceanway/* 的部分(账单、报价、用量、跨站交接),改为调用平台对应的原版接口或新增接口。具体清单在第 1 阶段验证时整理。

迁移完成后,oceanway-console 仓库归档。

待定事项

  • Playground 保留还是引导到 Studio。
  • 首发启用的支付方式。
  • 周期订阅是否首发。

On this page