Admin 首期范围与接口依据
基于固定 new-api 接口确定页面、动作与开发边界
版本：PRD v0.3 / 2026-09-12。以下是基于现有接口形成的产品范围基线草案，供本轮原型和实现使用；首发具体配置与商业数值仍需按待定项确认。接口依据为固定提交 385d2dfd10d821b25c8a6766bd16eea248cb1652，不代表 OceanWay 已运行。
范围分级
- 首期复用：已有操作与需求基本对应，仍需字段、权限和运行验收。
- 首期适配：主体接口存在，需要聚合、字段裁剪、单位或边界调整。
- 首期补齐：属于产品核心要求，缺口不能因上游没有而删掉。
- 按配置启用／待产品选择：不先承诺所有登录、支付、套餐或 Playground 方案。
- 外部网关：仅导航与职责说明，不作为 OceanWay 后台页面开发。
页面与操作清单
| 操作 ID | 页面／操作 | 范围 | 需求 |
|---|---|---|---|
| CA-A01 | 运营总览：用量统计与异常定位入口 | 首期适配 | ADM-01 |
| CA-A02 | 客户管理：搜索、创建和读取客户 | 首期复用 | ADM-02 |
| CA-A03 | 客户管理：资料编辑与启停账户 | 首期适配 | ADM-02 |
| CA-A04 | 客户详情：企业属性、协议价绑定与有效期 | 首期补齐 | ADM-02/05 |
| CA-A05 | 客户详情：查看该客户消费及订阅线索 | 首期适配 | ADM-02/08 |
| CA-A06 | 销售模型目录：客户模型元数据编辑、查询 | 首期适配 | ADM-04 |
| CA-A07 | 销售模型目录：同步预览与采用范围 | 按配置启用 | ADM-04 |
| CA-A08 | 客户价格：读取、编辑和预览基础价格 | 首期适配 | ADM-05 |
| CA-A09 | 客户价格：企业覆盖、有效期和价格版本 | 首期补齐 | ADM-05 |
| CA-A10 | 充值订单：查询订单及支付异常线索 | 首期复用 | ADM-06 |
| CA-A11 | 充值订单：有支付证据的补单 | 首期补齐 | ADM-06 |
| CA-A12 | 积分处理：加减积分与调整记录 | 首期补齐 | ADM-06 |
| CA-A13 | 充值商品：人民币金额、积分权益与适用客户 | 首期补齐 | ADM-07 |
| CA-A14 | 周期订阅：套餐编辑、上下架与分配 | 待产品选择 | ADM-07 |
| CA-A15 | 调用与任务：按请求和任务定位异常 | 首期适配 | ADM-08 |
| CA-A16 | 调用与任务：跨产品关联与费用核对 | 首期补齐 | ADM-08 |
| CA-A17 | 成员权限：当前能力和受控授权 | 首期适配 | ADM-10 |
| CA-A18 | 操作审计：查询操作、对象和结果 | 首期复用 | ADM-11 |
| CA-A19 | 平台设置：站点、认证、支付能力 | 首期适配 | ADM-12 |
| CA-A20 | 供应管理入口：跳转独立网关后台 | 外部网关 | ADM-03/09/12 |
接口依据与产品验收
CA-A01 · 用量统计与异常定位入口
页面：运营总览。范围：首期适配。需求：ADM-01。
接口依据：CORE-USAGE-001 GET /api/data/；CORE-USAGE-002 GET /api/data/flow；CORE-USAGE-011 GET /api/log/stat。
产品要求与验收：只展示真实支持指标；供应成本、毛利、支付成功率和全站失败率无聚合依据时不展示。
CA-A02 · 搜索、创建和读取客户
页面：客户管理。范围：首期复用。需求：ADM-02。
接口依据：CORE-USER-002 GET /api/user/；CORE-USER-011 GET /api/user/search；CORE-USER-003 POST /api/user/；CORE-USER-006 GET /api/user/:id。
产品要求与验收：客户类型不等于后台角色；列表与详情定位确定 user_id，禁止串用户。
CA-A03 · 资料编辑与启停账户
页面：客户管理。范围：首期适配。需求：ADM-02。
接口依据：CORE-USER-004 PUT /api/user/；CORE-USER-010 POST /api/user/manage。
产品要求与验收：资料与状态分开；后端限制目标角色，禁用后会话和 API Key 拒绝行为必须实测。
CA-A04 · 企业属性、协议价绑定与有效期
页面：客户详情。范围：首期补齐。需求：ADM-02/05。
接口依据：CORE-USER-006 GET /api/user/:id；OW-02 GET /api/oceanway/admin/pricing/accounts/:id；OW-03 PUT /api/oceanway/admin/pricing/accounts/:id。
产品要求与验收：绑定账户级价格方案，未覆盖模型按明确回退规则；不创建企业成员或复制供应渠道。
CA-A05 · 查看该客户消费及订阅线索
页面：客户详情。范围：首期适配。需求：ADM-02/08。
接口依据：CORE-USAGE-005 GET /api/data/users；CORE-USAGE-006 GET /api/log/；CORE-BILL-028 GET /api/subscription/admin/users/:id/subscriptions。
产品要求与验收：仅在端点确能锁定该用户时聚合；订单和任务缺 user_id 精确筛选时显示待补，不能嵌入全站数据。
CA-A06 · 客户模型元数据编辑、查询
页面：销售模型目录。范围：首期适配。需求：ADM-04。
接口依据：CORE-MODEL-002 GET /api/models/；CORE-MODEL-003 POST /api/models/；CORE-MODEL-004 PUT /api/models/；CORE-MODEL-006 GET /api/models/:id；CORE-MODEL-009 GET /api/models/search。
产品要求与验收：维护客户展示、模型标识与能力；渠道凭据和供应路由不在此编辑。
CA-A07 · 同步预览与采用范围
页面：销售模型目录。范围：按配置启用。需求：ADM-04。
接口依据：CORE-MODEL-011 GET /api/models/sync_upstream/preview；CORE-MODEL-010 POST /api/models/sync_upstream。
产品要求与验收：来源与权限验证后逐项选择采用；不覆盖平台展示内容或宣称等同供应可用性。
CA-A08 · 读取、编辑和预览基础价格
页面：客户价格。范围：首期适配。需求：ADM-05。
接口依据：CORE-BILL-003 GET /api/option/model_pricing；CORE-BILL-004 PATCH /api/option/model_pricing；CORE-BILL-006 POST /api/option/model_pricing/preview；CORE-BILL-002 GET /api/group/。
产品要求与验收：原接口是 Root 配置能力；对齐单位和示例调用，不因价格页可见就给普通运营 Root。
CA-A09 · 企业覆盖、有效期和价格版本
页面：客户价格。范围：首期补齐。需求：ADM-05。
接口依据：OW-02 GET /api/oceanway/admin/pricing/accounts/:id；OW-03 PUT /api/oceanway/admin/pricing/accounts/:id；OW-01 GET /api/oceanway/pricing/self。
产品要求与验收：同账户、模型、规格的预览与 Console 一致；新旧版本及在途调用选价可追溯，具体优惠叠加待定。
CA-A10 · 查询订单及支付异常线索
页面：充值订单。范围：首期复用。需求：ADM-06。
接口依据：CORE-BILL-051 GET /api/user/topup。
产品要求与验收：已有列表为 keyword/分页；客户、时间、支付状态等精确过滤未确认前不绘制成已接入筛选。
CA-A11 · 有支付证据的补单
页面：充值订单。范围：首期补齐。需求：ADM-06。
接口依据：CORE-BILL-053 POST /api/user/topup/complete。
产品要求与验收：trade_no 为现有输入；补理由、持久去重和操作结果查询，响应丢失后核对，非通用退款。
CA-A12 · 加减积分与调整记录
页面：积分处理。范围：首期补齐。需求：ADM-06。
接口依据：CORE-USER-010 POST /api/user/manage；CORE-ADMIN-002 GET /api/audit。
产品要求与验收：现有 add_quota 等能力需适配操作理由、业务 ID 和查询；禁止把覆盖余额伪装成增减，重复请求不得重复加款。
CA-A13 · 人民币金额、积分权益与适用客户
页面：充值商品。范围：首期补齐。需求：ADM-07。
接口依据：CORE-ADMIN-013 GET /api/option/；CORE-ADMIN-014 PUT /api/option/；CORE-BILL-054 GET /api/user/topup/info。
产品要求与验收：配置接口可复用但缺完整商品版本协议；充值商品和周期订阅分开，套餐数值未定。
CA-A14 · 套餐编辑、上下架与分配
页面：周期订阅。范围：待产品选择。需求：ADM-07。
接口依据：CORE-BILL-021 GET /api/subscription/admin/plans；CORE-BILL-022 POST /api/subscription/admin/plans；CORE-BILL-024 PUT /api/subscription/admin/plans/:id；CORE-BILL-023 PATCH /api/subscription/admin/plans/:id；CORE-BILL-029 POST /api/subscription/admin/users/:id/subscriptions；CORE-BILL-027 POST /api/subscription/admin/user_subscriptions/:id/invalidate。
产品要求与验收：停售与已有订阅失效不同；人民币改造、规则和客户展示一致后启用，不把退款/批量重置纳入默认动作。
CA-A15 · 按请求和任务定位异常
页面：调用与任务。范围：首期适配。需求：ADM-08。
接口依据：CORE-USAGE-006 GET /api/log/；CORE-USAGE-011 GET /api/log/stat；CORE-USAGE-014 GET /api/task；CORE-USAGE-015 GET /api/task/:task_id/artifacts。
产品要求与验收：旧 log/search 不使用；后台没有 user_id 任务过滤时不承诺；结果授权与渠道脱敏按身份。
CA-A16 · 跨产品关联与费用核对
页面：调用与任务。范围：首期补齐。需求：ADM-08。
接口依据：OW-05 GET /api/oceanway/operations/:id；OW-06 POST /api/oceanway/admin/reconciliations/:id/resolve。
产品要求与验收：费用修复提案与普通查询分开；未完成幂等、授权和证据协议前不提供一键修复/退款。
CA-A17 · 当前能力和受控授权
页面：成员权限。范围：首期适配。需求：ADM-10。
接口依据：CORE-ADMIN-004 GET /api/authz/catalog；CORE-USER-013 GET /api/user/self；CORE-USER-004 PUT /api/user/；CORE-USER-010 POST /api/user/manage。
产品要求与验收：三位维护人员用独立账号；现有 Admin/Root 按实际后端授权，不虚构已隔离的客服/财务角色。
CA-A18 · 查询操作、对象和结果
页面：操作审计。范围：首期复用。需求：ADM-11。
接口依据：CORE-ADMIN-002 GET /api/audit。
产品要求与验收：audit.read 与 Root 记录边界保持；查询脱敏，审计覆盖逐操作验证。
CA-A19 · 站点、认证、支付能力
页面：平台设置。范围：首期适配。需求：ADM-12。
接口依据：CORE-ADMIN-013 GET /api/option/；CORE-ADMIN-014 PUT /api/option/；CORE-ADMIN-027 GET /api/status。
产品要求与验收：仅平台客户侧配置白名单，Root 可写；不开放全部 Option 原始键，不夹带供应配置。
CA-A20 · 跳转独立网关后台
页面：供应管理入口。范围：外部网关。需求：ADM-03/09/12。
数据来源：已登记的网关后台地址；普通导航不依赖业务 API。
产品要求与验收：不在 OceanWay 调用渠道/插件写接口；网关独立登录与授权，跳转不携带供应凭据；普通链接不等于已实现单点登录。
页面交付标准
页面上的列表、数字、筛选、按钮和状态必须能对应到本表中的操作 ID，再对应到 API 需求 ID。声明为后端已有的字段必须有真实 DTO 与示例；复用项不能仅凭有路由就通过验收。扩展项需注明模拟状态，缺口关闭后再接入。页面覆盖加载、空态、无权限、业务失败、网络未知、成功回读。
全局身份前置
Admin 与全部 OceanWay 产品共享 AUTH-G01 登录状态。已登录客户无后台权限时明确拒绝，不要求建立另一套账号或反复登录；员工以同一身份校验后台权限。CA-A20 指向内部供应网关，其隔离维护边界另行保留。