PLAT-02-007 支付、订阅与消费整体方案
通用充值、共享用量订阅、产品专项商品与两端完整流程及代码构建顺序
运营配置需求补充：商品、价格与资源继续由管理员配置。统一运营后台 PRD v0.7补充完整的档位增删、多权益编辑、视频秒数、可配置存储及客户订阅调整要求；固定三档不是系统限制，30 天为编辑默认。本文原单快照、统一消费与续购规则保持；营销、促销／券、活动任务／返利已在该 PRD／FS 中形成新需求及完整流程；本页旧有后置安排不作为拒绝设计这些能力的依据，新增规则定稿前不视为生产开放。
整理日期：2026-10-10。用户已认可“通用充值＋有限共享用量订阅＋按需产品专项套餐，产品功能权益分别定义”，并要求按此构建代码。本页将该方向组织成管理端、用户侧与开发的共同入口。关联PL-005/006/009/011/017/019/020/021，T-05/07/08/09/11/12/13，AC-05/06/08/09/10/14/15/16。
本轮交付为完整方案、规则同步、代码差距与构建任务，业务代码尚未按新方案完成。 商品价格、额度、专项模型、活动值由有权限管理员配置，不以示例作真实商品。首期构建默认与已确认方向分别注明；现有订单和权益继续按原快照，不批量改写。
本页维护端到端产品组织和构建索引。全域记录与产品运营维护商品归属、范围与购买关系；钱包与计费维护收款、资金、价格和恢复；多资源权益维护分配、计量、周期、到期与原资源返还；管理端规格和页面规格维护页面行为。下文引用这些规则，接口字段和技术枚举须在平台仓库正式契约定稿。
1. 用户究竟购买什么
| 商品 | 用户购买理由 | 交付对象 | 首期安排 |
|---|---|---|---|
| 通用充值 | 偶尔用、集中项目用，预算长期灵活 | 一次入普通钱包的通用积分；明确赠送部分来源 | 主线，跨API及获准产品使用 |
| 通用用量订阅 | 持续使用，以期限约束换取更优惠的额度 | 一份跨产品共享的限期额度；不增加普通钱包余额 | 主线，先少量档位；编辑默认30天，有限额度 |
| 产品专项资源包 | 为明确模型、规格或某种制作需求购买资源组合 | 限定范围的积分、图片张数、视频条数等库存 | 有明确差异时加入；一次资源包不伪装为周期会员 |
| 产品功能会员 | 为产品的实际付费功能、协作或服务能力付费 | 具名功能访问权；算力部分另列 | 保留领域边界，已有功能与访问控制通过验收后再卖 |
| 活动与邀请奖励 | 按已发布资格获得福利 | 普通积分或独立限时/限定资源 | 沿既有活动权威，展示来源、范围及期限 |
“通用”表示已发布的可使用范围，“订阅”表示有期限的购买关系，“资源”表示可以消费的数量，“功能会员”表示产品访问资格。一次购买可以交付多个资源，但每个资源独立说明。全部开放模型仍遵循现行目录与Key许可，会员不作为模型解锁条件。
首批通用套餐以用量区分档位。产品套餐不能只更换产品名称重复出售相同通用积分；需要清楚的资源组合或功能差异。无订阅用户仍可充值并调用开放模型，追加充值不应强制购买订阅。
2. 四种归属与一个权威
商品的运营归属、这次购买的入口、交付资源的消费范围、实际发生消费的产品分别记录，细则见产品运营§2。平台通用商品归Platform；Studio运营的商品可在获准Console入口销售，原归属保持Studio；从Studio充值获得的普通钱包积分仍为OceanWay通用余额。
Platform保存身份、商品、订单、支付事实、订阅覆盖段、资源、消费与审计。产品保存项目、素材、工作流与业务任务。产品运营通过受限平台接口维护本域商品和活动，产品消费调用同一个记账服务。
API是否可使用某份资源由发布范围决定；首期通用用量套餐默认包括API与获准创作产品。资源数量在这些入口共同消耗，每个入口不另获一份完整额度。后续新增产品或范围变化须具名发布，历史已购范围按原规则核对，不能以入口字符串推断。
3. 积分、售价、成本和优惠
人民币是实付金额；积分是平台消费单位；次数按其实际单位计量。订阅周期剩余和图片/视频次数不能折成普通钱包余额，也不能与人民币混成一个“总资产”。
| 配置 | 决定什么 | 与其他配置的关系 |
|---|---|---|
| 充值换算R | 新充值现金与通用积分的兑换 | 当前目标100积分/元；内部quota及旧余额不因改R自动重估 |
| 模型标准价 | 同模型、规格和实际用量应扣的积分 | 复用当前官方参考、F/R/S与明确模型组规则；订阅不另改模型单价 |
| 充值优惠 | 实付现金、基础积分、赠送积分或资源 | 订单记录每个组成，不能把同一赠送同时入钱包与grant |
| 订阅售价与额度 | 期限内固定现金可以购买多少共享用量 | 现金直接购买周期权益，不再按R补一遍普通余额 |
| 专项包 | 指定模型/规格/单位下购买的资源量 | 标准价仍留在原消费快照，实际覆盖资源另记 |
| 活动奖励 | 资格事件满足后额外获授资源 | 按活动版本去重，原邀请两类奖励政策保留 |
修改R会同时影响新充值待遇和新模型积分价，可能改变旧余额面对新价的购买力；“旧余额数值不变”不代表购买力不变。管理端需呈现影响并保护原订单/原操作，旧客户转换另按PD-12，不通过修改R完成隐式资产迁移。
商品试算分别显示：现金实付、获得资源、期限和范围、相对充值的用量优势、典型使用结构以及满额消耗的成本。实际供应采购价与官方USD参考价是不同数据，未取得采购成本时显示成本未核实，不显示保证盈利。先按额度100%使用及高成本模型组合评估，未用完资源不作为确保盈利的前提。
首期用量优惠通过商品售价/数量表达；不新增会员模型折扣、优惠券或任意折上折。充值赠送、订阅额度和活动奖励各自留来源，允许并存不等于同一触发事件重复奖励。
4. 订阅购买、续购、换档和到期
首期构建默认详见多资源权益§8。新通用套餐默认“30天套餐”，直接展示起止时刻和有效期，避免把固定30天写成自然月。7/30天并行上限保留为高级配置及原已购能力；新简单套餐不强制填写两套上限。
| 用户动作或事件 | 可观察结果 |
|---|---|
| 首次付款并确认履约 | 从成功交付可用时刻起算30天，看到真实订阅、覆盖段、资源、起止与原订单；未履约时不虚构可用额度 |
| 当前有效期内买同档 | 接续已确认覆盖段，显示本期和待生效段；当前已用量保持 |
| 本期额度耗尽 | 可充值补量或购买明确立即生效的专项包；续期商品继续从原到期接续，购买页提前说明 |
| 买同商品族不同档 | 首期统一追加到全部保留已付段末尾换档；展示准确生效时刻，不填中间退款空档、不移动已付未来段，不进行即时补差 |
| 买其他产品专项包 | 与通用订阅独立并存；只在各自范围内消费，不重复计算共同额度 |
| 暂停商品销售或改价 | 新购买受新规则限制，已付原单与既有资源按原快照恢复 |
| 周期切换或到期 | 新周期按原锚点建立；未使用限时量失效，在途原任务保留原分配；错过排期的交付故障进入原案件补时/退款核对，不无声消耗不可用天数 |
| 用户不再续购 | 到期后停止授予该段权益；普通充值余额继续可用 |
首期仍为用户主动支付。周期额度刷新、续期推荐与未来覆盖段均不表示签约自动扣款。即时升降级、按比例折算、自动续费、无限量套餐及客户自助现金退款后置；对应入口不得使用已支持的文案。
5. 订单、收款、履约分开查询
购买前明确商品版本、实付金额、交付资源、消费范围、有效期、生效时点、续购语义及销售状态。用户提交一次原请求，服务端校验归属、资格、支付方式与发布快照后创建原订单，精确保存人民币分值。
支付页跳转成功、二维码已生成或浏览器返回均不证明收款。可信签名通知或查单核对商户、原订单、渠道交易号、币种和实付金额。可信收款事实持久保存，再由同一平台持久履约任务一次发放；履约失败不能把已收款显示为未支付。
| 维度 | 展示状态与恢复 |
|---|---|
| 支付 | 待支付、支付待核对、已收款、可信未收款关闭；未知只查原单 |
| 履约 | 未履约、处理中、已履约、待恢复；已收款待恢复需明确展示与员工处理入口 |
| 退款 | 无退款、核算/处理中、外部结果待核对、现金已退待账务、完成或明确失败；与支付和履约独立 |
迟到付款按渠道可信原事实处理：已有效收款原单按原快照履约一次；若已有退回或冲突事实，进入原单核对，不静默丢失付款或重复发资源。本地页面超时和到期倒计时不能自行证明渠道已关闭。
重复通知、并发查单、重复补单与Worker重启都复用原单、原支付事实和唯一履约身份。渠道查付与补单不能替换为手动加积分。实现细则见钱包与计费最新商业整理段。
6. 每次消费如何使用资源
沿PD-16：核验身份、Key、产品、目录、规格和价格 → 匹配有效范围 → 跨资源按先到期及稳定ID排序 → 在明确钱包上限内一次预留 → 执行 → 按可信实际结果结算。普通钱包为获准后备来源。“仅使用权益”不足拒绝；允许钱包回退时只在原最高支出内消费。
用户提交前看到标准估价、可用资源、预计覆盖、最高钱包支出和范围不足原因。预检只读且有有效性边界；真正预留时在资金事务中复审，不能因预检成功保证并发之后仍有额度。API通过持久计费偏好/请求预算表达授权，产品入口不能替用户扩大钱包支出上限。
同订阅周/月限制约束同一用量，剩余取所有适用窗口、库存及有效期共同允许值；不同单位、范围和周期不相加。Key按整个调用的原标准价等值核预算，实际钱包部分独立记录。
图片按可信成功张数、视频按可信成功条数核销相应次数。部分成功仅核销确认部分；缺结果或缺用量保留原操作待核对。跨次数与积分分摊需要可核验的输出项和价格维度，次数覆盖完整输出项，不能简单把1次换成任意积分。先到期在单位守恒的可行方案内执行，具体正向/反向到期例和原输出绑定见多资源权益§8。当前实现只有次数整单覆盖或积分/钱包分配，同到期还插入范围专一性优先，与PD-16存在差距，按T-12补齐，旧测试不能作为降低要求的依据。
消费记录展示原标准价依据、实际用量、资源覆盖和普通钱包支出，不能把这几个数字相加形成总消费。模型成功但产品素材保存失败仍保留原消费，保存恢复只读取原结果。
7. 售后动作的区别
| 动作 | 处理对象 | 用户结果 |
|---|---|---|
| 消费释放/冲销 | 原operation与原allocation | 明确未执行、失败或获准使用退款回原钱包/原grant/原窗口；限时资源不复活 |
| 商品现金退款 | 原支付订单及关联权益、赠送、返利 | 独立保存可退金额、核算、外部实退与资源处理结果，不能用加积分冒充退钱 |
| 权益发放/回收 | 具名用户资源与原来源 | 获授或未占用资源撤销有可查回执；已执行和待核对占用不能随意删除 |
| 普通积分调整 | 通用钱包 | 按现行用户确认，只填方向与数量，保留后台自动审计；不创建付款证明 |
| 停售/到期/不续购 | 商品新售许可或原覆盖期限 | 已购历史仍可查，既有权益按原规则处理，不隐式现金退款 |
首期现金售后由获准财务处理：引用原订单，人工核算并保存金额及资源方案，登记可核验外部退款凭证，再幂等完成原账务处理。总退款不超过原实收减已退及在途退款；资金、权限和并发必须验收。渠道自动退款及客户自助退款后置。
已消费订阅、混合充值赠送、邀请返利和部分现金退款没有统一的“剩余积分÷当前R”公式；须原订单组成与已使用事实核算。缺乏可信归因时进入待核对，不以现有账户余额猜测原商品未用量。系统不能自动确定尚未配置的退款折算政策。
8. 管理端：从经营决策进入配置
| 工作区 | 管理员先看到什么 | 常用动作与结果 |
|---|---|---|
| 支付与充值规则 UI-A01 | 国内渠道的可用性、公共回调、商户就绪缺口；充值档位的现金/积分/赠送 | 配置、校验、保存与回读；秘密脱敏，换算指向唯一价格政策入口 |
| 商品/订阅管理 UI-A10 | 商品类型、归属、现金售价、期限、交付资源、范围和售卖状态 | 建草稿→选择类型→配置资源→核对用户待遇/续购/成本→发布；订阅记录显示真实已购覆盖段 |
| 订单 UI-A09 | 原商品、用户、入口、实收、支付/履约/退款分别状态 | 查付、获准补单、恢复履约、售后核算和原结果核对；不混入无关商品编辑 |
| 用户详情 UI-A11 | 通用余额、全部获准订阅覆盖段、赠送/专项资源、原窗口与原来源 | 个人发放/回收、积分调整、联查订单与消费；各动作独立授权 |
| 消费与异常 UI-A12 | 原调用、资源分配、账务、执行、保存和异常原因 | 查原任务、恢复原账务、获准冲销；不能新建付费模型任务 |
| 活动 UI-A16 | 发布规则、资格、预算、参与/领取/真实发放 | 编辑和发布活动、核对奖励，保留全域邀请归因；个人通用发放留用户详情 |
| 经营分析 UI-A13/A17 | 人民币实收/实退、商品归属、入口、实际消费产品、核销与采购成本 | 同口径明细、图表和导出；未核实成本单列，不把买入积分当模型消费 |
商品编辑先选择商业类型，按类型收敛字段。通用套餐默认简单30天额度；需要并行窗口、范围限定或次数组合时再展开相关配置。管理员直接核对“用户付多少、得到什么、何时能用、能在哪里用、再买会怎样”。
发布前集中展示配置和验收缺口：价格、资源单位、范围、周期、生效/到期、购买规则、支付与供给支持、原单恢复能力。草稿保存与正式可售分别反馈；缺商户或供给时可以保存草稿，不接受真实新购买。
产品工作区只运营自己的商业对象；读取本域用户不自动获得通用充值订单、全域钱包调整、退款、其他产品记录或私密内容权限。Console入口销售Studio商品仍按Studio归属授权。
9. 用户侧：选择、购买、使用和核对
| 页面 | 用户应完成的任务 | 关键反馈 |
|---|---|---|
| 充值与套餐入口 | 选择灵活充值、持续用量订阅或具名专项资源 | 同一价格/商品权威；比较现金、期限、范围、资源、生效和续购；明确未开放原因 |
| 钱包/我的资源 UI-C08 | 知道现在能用什么 | 通用订阅、限时/专项资源、普通余额分别展示；真实全量概览，当前和待生效覆盖段分开 |
| 我的订阅 | 核对本期/后期、到期和原订单 | 使用正式新购买与履约投影，不继续以原生观察列表作为新订阅状态 |
| 订单 | 核对付款和交付 | 明确待支付、已收款待履约、完成及退款；失败与未知不同，刷新查原单 |
| 生成/调用入口 | 决定本次资源和钱包预算 | 标准估价、匹配资源、覆盖和最高钱包支出；仅权益不足拒绝，补量入口保留原上下文 |
| 使用记录 UI-C07/C11 | 理解每次调用与费用 | 原操作、资源来源/核销、钱包支出、实际用量和待核对；关联结果及原产品任务 |
| 使用分析 UI-C13 | 查看时间与产品维度的消费 | 积分、次数、调用、任务、现金分别统计，与明细同条件 |
| 活动中心 UI-C12 | 理解资格、领取和获得什么 | 参与、可领取、发放中、已到账分别状态，不把待领取算可用 |
产品本域钱包直接说明“OceanWay通用余额”；通用额度显示“本产品可用，跨产品共享”。产品套餐与其他来源但本产品可用资源分组，外域历史通过本人Console读取。原资源同时能在多个产品使用时，不在各页面显示成独立库存。
所有页面保留加载、空、失败、未知、未配置、停售、待生效、过期、权限不足和保存冲突状态；手机布局保持付款金额、期限、范围和预算可读。推荐只引导明确商品比较，不自动下单或扣款。记录页与独立分析页的既有分工保持。
10. 当前代码与目标之间的差距
只读审计日期2026-10-10，复用入口位于platform/oceanway-platform。既有隔离测试只证明原列明范围，不作为下列新行为已通过。
| 当前可复用基础 | 新方案需要补齐 |
|---|---|
| 统一钱包、权益grant/window/allocation与原operation | 商业类型、商品族/档位、稳定逻辑订阅与原订单覆盖段；同族新购规则 |
| 多资源模板发布/CAS、人民币订阅订单与原快照履约 | owner、可信销售入口、明确消费范围、商品资格与类型化编辑；专项包独立交付语义 |
| 支付验签、查单、checkout尝试与幂等资金事务 | 持久可信收款事实与可恢复履约分态，订单侧退款状态及原单上限 |
| 管理端真实新购买/履约记录 | 用户侧退出原生观察列表，概览和历史读取同一正式订阅投影 |
| 次数整单覆盖、积分权益＋钱包分配 | 可信输出项下跨次数/积分分摊，以及完整资源消费预检 |
| 原使用全额冲销与用户发放/回收 | 商品现金售后、原来源/赠送/返利关联及人工核算闭环 |
| 可信operation产品来源、本人跨产品消费查询 | 产品作用域运营、强制本域查询、跨产品必要资源投影与可靠业务摘要 |
关键模块：service/platform_payment*.go、platform_official_payment.go、platform_subscription_payments.go、platform_entitlements_subscriptions.go、platform_entitlements_allocations.go、platform_subscription_records.go、platform_customer_entitlement_facts.go、platform_customer_subscriptions.go、platform_sales_pricing_policy.go；两端接线：web/src/features/platform/admin-settings.tsx、subscription-templates.tsx、admin-subscription-workspace.tsx、admin-finance-orders.tsx、wallet-subscription-shop.tsx、wallet-subscriptions.tsx、media-workbench.tsx。接口与迁移先审计真实路由和docs/openapi/platform.json，不按本页名称直接造平行服务。
11. 代码构建与验收顺序
任务权威在实施任务的本轮商业构建段，逐行映射在追踪矩阵。按下列依赖推进，每段同时覆盖后端、正式契约、管理端、用户侧和必要证据。
- 商品与购买规则：补类型、owner/sales_surface、消费范围、商品族/档位、生命周期和兼容迁移；管理端用类型化表单建立可解释商品，用户可以比较真实待遇。
- 可信支付与履约：支付事实、持久履约恢复与分态订单；重复/迟到/冲突/收款后发放失败均沿原单，充值与订阅不重复交付。
- 统一订阅投影与生命周期：用户/管理端同一逻辑订阅和覆盖段；同档续期、下期换档、待生效、过期；保留原快照，周期不是自动扣款。
- 消费预检与引擎差距：同源匹配、原钱包上限、周/月共同约束、可信次数与积分分摊、跨期恢复；Key与钱包分别核对。
- 管理售后与经营核对：原现金订单、人工外部凭证、资源/赠送/返利关联、可退上限、审计及两端回读；未明确折算保持待核对。
- Studio最小闭环及其他产品复用：本域商品/资源/订单/消费、强制scope与可靠业务摘要；全域Console/Admin同时联查，再复用Drama/Commerce。
验收覆盖：多端最后一份共享额度竞争；周够/月不足；零余额有权益；专项范围拒绝；仅权益与钱包上限；同族并发续购/换档；支付重复和金额不符；收款成功但履约故障/重启；改价/停售后原单恢复；部分输出与窗口/到期竞争；原资源冲销；重复现金退款和外部结果未知；跨用户/跨产品对象与导出越权；用户切号、手机、失败/未知回读。
资金、支付、权限与恢复必须真实隔离PostgreSQL及本地协议夹具验证，页面全状态另用实际浏览器取证。文档检查不能证明业务正确；真实商户、收费模型、生产发布和客户迁移仍按各自已有授权与开放门槛。功能会员、自动续费、即时补差、任意优惠叠加及未验真实供给不在本轮首批商品中暗中启用。