02 决策（ADR）
ADR-0015 Console与Admin职责和界面
来源：原
overview/decisions.mdx（已归档至 08_归档/02_重构前文档），按主题整理，原文保留；验收证据与进度段落已移至 PROC-02-002。
决策摘要
Admin 为唯一管理入口，产品级管理留在产品；Console 是客户后台，接入文档独立建设；界面基于 shadcn/ui；管理端与客户端同等重点。
原决定
| 编号 | 决定 |
|---|---|
| D-ADMIN-SPLIT | Admin 是唯一管理入口，原生实现平台级管理（用户、钱包、价格、模型、订单、员工权限）；产品级管理（作品治理、提示词、生成记录等）留在各产品自己的管理页，从 Admin 跳转进入 |
| D-SITE-CONTENT-ADMIN | 官网内容在 Admin 中调整，可以是 Admin 的一个部分，也可以发展成运营中台；该事项后置，首发不做 |
| D-FRONTEND-SOURCE | 2026-10-03 用户确认：用户端以已设计的 oceanway-console 为前端来源，保留设计与可用交互；管理端可基于官方 new-api 原有前端改造。旧 oceanway-admin 作为功能/工作流参照，不强制其界面迁入；两端接平台唯一会话、账务和接口，不恢复旧 BFF |
| D-CONSOLE-DEVELOPER-MERGE | 公开模型、价格和登录后的客户管理保留在 Console；文档与教程的归属由2026-10-04的D-API-DOCS-SEPARATE调整 |
| D-API-DOCS-SEPARATE | 2026-10-04用户要求Console不再内置接入文档，后续建设独立、详细完整的接入文档站；当前移除文档页面与入口，旧地址兼容跳转至Playground；文档站域名、上线及完整内容另行实施 |
| D-ADMIN-PHASE1-BOUNDARY | Console 是客户自己的后台，不是员工后台；媒体网关的供应管理后台独立使用，不接入 Admin |
| D-ADMIN-ADJUSTMENT-SIMPLE | 2026-10-06用户要求账户资金的积分调整无需凭证编号和原因；表单/确认/结果只保留所选用户、方向及积分等必要信息，服务端自动留操作者/原请求/调整审计，旧显式字段与回执兼容；补单和退款继续核对原交易证据，权限/幂等/唯一记账不变 |
| D-UI-SHADCN | 界面基于 shadcn/ui，沿用 OceanWay 品牌风格 |
2026-10-04 平台管理端与客户端同等重点
用户指出上一版核心PRD对管理端定义不足，补充D-PLATFORM-PRODUCT-DRIVEN-DOCS：Admin作为独立产品主线，完整定义员工职责、运营/用户/授权/销售/财务/订阅/异常/审计/配置工作流及独立验收；不能仅靠客户回读、原生接口存在或几张配置页宣布完成。总PRD增加23条管理端子行为，设计及AC-10专项同步，既有业务边界/任务状态保持。
2026-10-07 D-USAGE-ANALYSIS 使用分析独立入口
用户确认记录页只呈现记录内容；消耗积分、次数等聚合统计移至独立“使用分析”页面。使用分析以每日消耗、调用次数两张图表为主体，合计置于图内，周期直接切换，详细筛选收进图标面板。沿平台本人使用记录与每日聚合只读接口，保持相同时间/模型/Key/调用方式/状态条件和UTC创建时间口径；费用只统计已结算，不将待确认任务视为零费用。新增Console侧栏入口，不改变产品归属、资金路径或任务恢复权限。关联PL-012.R01、UI-C07/C11/C13、T-07。