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。
- 首发启用的支付方式。
- 周期订阅是否首发。