Admin 首期范围与接口依据

版本：PRD v0.3 / 2026-09-12。以下是基于现有接口形成的产品范围基线草案，供本轮原型和实现使用；首发具体配置与商业数值仍需按待定项确认。接口依据为固定提交 385d2dfd10d821b25c8a6766bd16eea248cb1652，不代表 OceanWay 已运行。

范围分级

2026-09-27 范围说明：本页 CA-A01–20 保留为公共客户商业操作切片；完整管理范围扩展为统一入口、产品空间和 Studio 26 项模块拆分。本页没有覆盖的内容运营、产品配置和资源管理不能据此视为不需要；对应新增接口按责任服务另行设计。

首期复用：已有操作与需求基本对应，仍需字段、权限和运行验收。
首期适配：主体接口存在，需要聚合、字段裁剪、单位或边界调整。
首期补齐：属于产品核心要求，缺口不能因上游没有而删掉。
按配置启用／待产品选择：不先承诺所有登录、支付、套餐或 Playground 方案。
外部网关（首期不接入）：独立后台维护；保留职责说明，不交付统一入口或导航。

页面与操作清单

操作 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。

产品要求与验收：配置接口可复用但缺完整商品版本协议；充值商品和周期订阅分开，套餐数值未定。

接口依据：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。

产品要求与验收：统一管理入口不包含供应后台卡片或导航；供应后台保持独立登录与授权。未来是否整合另行决定，不作为首期退出条件。

页面交付标准

页面上的列表、数字、筛选、按钮和状态必须能对应到本表中的操作 ID，再对应到 API 需求 ID。声明为后端已有的字段必须有真实 DTO 与示例；复用项不能仅凭有路由就通过验收。扩展项需注明模拟状态，缺口关闭后再接入。页面覆盖加载、空态、无权限、业务失败、网络未知、成功回读。

产品详细行为 · 跨端映射与缺口。

全局身份前置

Admin 与全部 OceanWay 产品共享 AUTH-G01 登录状态。已登录客户无后台权限时明确拒绝，不要求建立另一套账号或反复登录；员工以同一身份校验后台权限。CA-A20 首期不实施；供应网关独立维护，不纳入本轮统一管理入口接入。