PLAT-02-015 Console
客户后台的页面范围、对应接口与前端迁移
产品行为以核心PRD为入口，逐页规格见页面与两端流程，全状态交互见交互规则。本页继续维护Console模块边界及迁移背景。
Console 是所有登录用户的客户后台，也是开发者的公开入口。它不是员工后台，员工使用 Admin。
两部分内容
- 公开部分（无需登录）：探索模型、公开价目表、充值与订阅套餐展示。
- 登录后：账户、API Key、充值与订单、所有产品的积分余额和使用记录、安全设置。
PL-021扩展全域客户视图：本人使用、生成、消费、人民币实付/实退、全部产品订阅/权益和活动参与可在Console查询，按实际使用产品、商品运营归属与购买入口分别筛选。产品子站保留本域视图，Console不是唯一可查看本域情况的界面；两处读取同一交易/权益与原记录，详细创作内容留在产品授权入口。规则与信息结构见全域记录与产品运营，Platform商业/业务事件和三产品outbox已有具名联合分项；产品自身UI、创作保存恢复、完整经营视图及完整T-13/AC-16仍开放，见实施任务。
2026-10-04用户调整文档归属：接入文档与教程后续在独立、详细完整的文档站建设，Console不内置文档阅读器，也不展示未上线文档站的入口。旧/console/docs与/docs书签兼容进入Playground，不渲染旧接入文档；模型调试与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（不弹确认）；无分组与模型白名单，一个有效Key调用全部已开放模型（PL-003/018） | /api/token/*、POST /api/token/:id/key | 是 |
| 探索模型与价目表 | 模型介绍、分类、搜索、公开标准价；登录后可按账户获准模型筛选，不提供本人价格页签或报价历史 | /api/pricing、/api/user/models | 是 |
| 使用记录 | 所有产品的扣费记录，可按产品、模型、时间筛选；每笔能看到价格依据和计量单位 | /api/log/self，需新增“来源产品”字段及非模型扣费记录 | 是 |
余额与流水；/console/wallet | 余额、有效资源、本人订阅状态/用量/历史、资金流水及去funding充值/购买入口 | 正式平台钱包/资源/本人订阅/流水契约，见平台仓库OpenAPI | 是 |
充值与订阅；/console/funding | 充值与可售订阅购买、下单、本人购买订单、原单付款续接及支付结果 | 原生候选 /api/user/topup/info、/api/user/pay、/api/user/topup/self；正式平台契约见平台仓库 | 是；支付/商品按实际启用与验收范围开放 |
| 兑换码 | 兑换 | POST /api/user/topup | 按配置启用 |
| 套餐与权益 | funding展示与购买优惠周/月订阅，wallet查看本人状态/用量/历史 | 原生 /api/subscription/* 为候选，正式契约见平台仓库 | 首期配置与统一记账已确定；人民币购买/周期权益验收后上架 |
| 任务记录 | 本人的视频等异步任务及结果 | /api/task/self为候选，正式组合需审计 | 已启用任务类型须提供；未验收能力关闭，完整任务页仍待复核 |
| 账户设置 | 资料、密码、邮箱、通知偏好 | /api/user/self、/api/user/setting | 是 |
| 安全设置 | 设备会话、撤销会话、本人审计；2FA、Passkey、第三方绑定 | /api/user/sessions、/api/user/2fa/*、/api/user/passkey | 会话首发；2FA 等按配置 |
| Playground | 选择获准Key/模型并真实调用；原操作查询与费用核对 | 以平台正式OpenAPI及实际路由为准 | 2026-10-04已确认纳入本批，分项验收不代表所有模型/真实供给通过 |
2026-10-12现行入口责任按充值订单与支付结果规格：购买/下单/订单/支付结果在funding，wallet不承载这些流程；旧wallet原单链接兼容进入funding同一原单。378制品已部署并完成列明入口/原单验收，平台 docs/verification/T-09/funding-wallet-separation-20261012/README.md 记录本地与实机边界；新商户ReturnURL仅夹具验证，本轮没有新增真实付款或回调。旧候选接口和此前截图不定义页面职责。
所有页面都要处理加载中、空数据、无权限、业务失败、网络结果未知和成功后回读等状态。
2026-10-03 用户明确冻结概念不进入客户 Console。总览只保留余额、实际消费和调用数；钱包显示余额、累计充值与实际消费，记录/详情/当前页 CSV不展示冻结、预留及内部 quota。调用未确认时保留准确状态和费用未确认提示，不显示为零消费或诱导重新生成。后台记账与 Admin 原始状态保持不变；具体展示与恢复边界见钱包与计费。
前端从哪里来
Console 前端基于现有仓库 products/oceanway-console 迁入平台仓库：
- 保留：React 页面、组件和设计实现。它本来就参考 new-api 的接口编写，大部分调用的是
/api/user/*、/api/token/*、/api/pricing等原版接口。 - 去掉：
server/下的 BFF 层（Node 中间层和它自己的会话库）。迁入后前端直接调用平台。 - 需要改接：原来调用
/api/oceanway/*的部分（账单、用量、跨站交接等），改为调用平台对应的原版接口或新增接口。具体清单在第 1 阶段验证时整理。用户已取消的持久模型报价、本人价格及历史不迁入。
2026-10-03 当前工作树已迁入总览、模型、快速开始、接入文档、充值订阅、Key、记录、钱包、账户及安全十页原结构和列明交互，直接接当前平台接口。页面与服务是否可用分别登记：原参考媒体不代表平台已开放调用；未配置在线充值和未启用订阅方案保持明确状态，购买与周期权益仍待完成。实际源对应、桌面/手机截图及验证范围见实施任务与验收记录，T-07不因此整项结项。
迁移完成后，oceanway-console 仓库归档。
待定事项
- Playground已确认并纳入本批；具体模型/协议/真实供给开放仍须对应配置与验收。
- 首发启用的支付方式。
- 周/月订阅的实际上架套餐、权益及支付配置；具体填值不阻断配置功能开发，未验收购买保持关闭。