文档
03 平台02 platform02_需求与工作包

PLAT-02-033 待定决策与阻断

已确定的配置原则、开发验证事项与上架前输入

运营配置需求补充:运营配置需求已进一步明确,见统一运营后台 PRD v0.7:不固定档数,管理员可调整价格、积分、多类媒体权益和存储。具体商品值继续是运营填值,不作为后台设计前置;仍须定稿的视频秒数计量、容量组合、团队容量归属和旧容量过渡列在该稿 §12;同时增加促销叠加、券预算、首购去重、返利基数及退款政策的可配置规则评审,实际活动金额与排期不作为后台需求前置。 新增执行计划的局部决策条件 D01~D08明确影响工作包,包含新旧产品代际、员工委托及容量等规则;不将整份架构复盘当作已批准新 ADR。

本页整理平台启动所需输入,与决策索引保持一致。已确定:单平台、官方 new-api 硬分叉、共享 Cookie、唯一钱包、文本 uumi/视频媒体网关、产品作用域授权、两前端迁入。下表未决事项不能被开发者静默转成商业规则。

编号事项当前状态/建议最迟决定点未决定的影响
PD-01官方基线和工具链2026-10-02 已固定官方 rc.41 / 2035a82aeb5414253a728bd937d4b8f97aa99b9b;Go 1.26.3、Bun 1.4.0;证据在平台 docs/baseline.mdT-01无可复验源码和运行环境
PD-02正式域名、子域与白名单2026-10-02 用户确定首域 oceanway.tech;域/入口/白名单配置化,后续支持 oceanway.ai 等受控主域及免重输密码SSO;子域与跨主域交接待定T-04 生产配置前无法验收正式 SSO 与返回地址
PD-03Cookie/会话、产品凭据、撤销上限2026-10-02 用户确定同浏览器各平台统一登录/任意站退出全局撤销;首期身份不缓存,下一受保护请求即时核验。同步 A/后台 B 已验证,正式凭据格式/角色/轮换与多主域交接仍待定T-04 契约定稿前不能定稿身份与后台授权
PD-04积分比例、最小单位、舍入、预扣超额初始40元=100积分,后台可调;内部单位/精度/舍入与原生超额计费映射由开发核对和PG验证T-05 数据与契约验证前配置值不阻断编码;映射未验收不能真实入账
PD-05一期个人标准价格;企业方案二期复用new-api计费方式与价格/倍率配置,初始模型倍率1;一期只实现个人标准模型销售价与独立充值/订阅权益,企业基础/覆盖方案及客户协议价绑定二期。开发核对字段语义与快照,实际模型价格后台填写T-06 上架前可先开发配置与夹具;未配置或未验证模型不能上架
PD-06支付渠道、套餐、退款及迟到通知政策支付相关内容均配置化,复用原生配置/渠道;首期充值及优惠周/月订阅;管理员控制退款,无客户线上退款T-09 验收/对应渠道启用前套餐与商户填值不阻断编码;人民币订单、统一入账、幂等通知须验收
PD-07赠送/订阅/营销/Playground周/月订阅与Playground既定范围保留;2026-10-07活动积分/限时媒体次数及多资源订阅已确认纳入PL-020/T-12,具体策略见PD-15/16;其余未确认营销及官网CMS仍后置T-07~T-09、T-12 对应功能开放前能力可按确定边界设计实现;未配置/未验套餐不上架,不隐式扩大其他营销
PD-08缺用量、部分成功、长期未知的收费与核对异常消费按new-api原生计费规则;开发核对用量估算/超额与持久恢复;未知不重做、幂等和人工核对约束保留T-05/06 异常验收前原生规则选择已定;技术兼容性和恢复仍须验证
PD-09视频与图片/音频开放范围T-02 已取得视频正常提交/轮询/失败退款/重启及丢响应重发缺口;图片一条夹具候选、音频未验证;真实 uumi/网关未验收T-03 范围结论、T-06 开放前未验收能力关闭,相关产品上线受阻
PD-10结果复制、存储责任、链接与记录保留产品长期素材归产品;具体期限/复制未定T-06 结果接口及 T-10 前不能承诺结果持续可取
PD-11性能容量、恢复目标、扫描/告警、负责人待测试环境实测与配置T-10 发布前没有量化运维验收门槛
PD-12老客户全量数据/权益、购买力、旧价保护与凭据迁移2026-10-07确认必须承接旧sub2api用户数据与权益;已实现显式定点/有理数批次策略与旧价兼容接口;真实兑换系数、模型待遇范围/期限和CNY返利存量、身份/TOTP与源切点仍须显式核对,测试比例不作客户政策,7/30天窗口不补满T-12隔离演练及实际客户切换前不阻断审计/设计与隔离实现;未完成逐用户/单位/窗口对账及回退阻断真实切换
PD-13客户Key无分组、全部开放模型共用Key2026-10-05用户确认D-KEY-ALL-MODELS,替代2026-10-03 Key组/授权绑定与逐Key模型白名单;用户组仅账户归属,按模型标准价计费,PL-003/018及AC-03/13同步T-04~T-09改造与首发前现有组门槛/模型限制仍待代码、契约及历史兼容处理;真实隔离PG与两端验证未执行,见G-14
PD-14两端前端来源2026-10-03用户确认客户使用已设计的 oceanway-console;管理端可基于官方 new-api 原版改造,旧 oceanway-admin 保留功能/工作流参照T-07/T-08逐页改接与验收原Console布局/Key和原生Admin布局/组目录已落地并分项验证;完整页面仍需迁入,不恢复旧 BFF

处理方式

PD-15 订阅与限时权益未用量、到期及退款政策(2026-10-07本轮策略已确定):用户按提出的逻辑要求继续完成,采用限时未用资源到期失效、不自动结转或入普通余额;已合法开始的原任务保留原grant/窗口占用,UNKNOWN不自动释放、不重新生成。可信成功按原分配核销;明确失败或获准全额使用退款回原资源、原grant/原窗口,已到期库存返还进入已过期,不补当前新周期。同模板续期从原到期点接续,旧grant与旧窗口不重置。完整细则与本地验收边界见多资源权益。真实支付退款、部分现金退款及已领取邀请返利的原交易处理仍独立核对;不可由通用使用退款自动扩大政策。

技术方案先做隔离验证并提出有证据的选择;商业输入通过已授权的后台配置能力填写。2026-10-02用户明确支付与计费均可配置、复用new-api;套餐价格、充值档位、商户凭据和倍率的具体值不再作为编码前置条件。开发先完成配置权限、校验、未配置禁用、订单/价格快照及夹具验证,实际填值仅影响对应功能上架和真实联调。

原生存在配置字段不等于已满足平台资金约束。审计已确认订阅管理强制USD、周期重置是权益刷新而非钱包发积分;由开发完成人民币适配和统一记账衔接,不再向用户重复索取技术字段选择。

决定后记录选项、原因、影响的需求/接口/迁移、日期及证据,更新这里和对应唯一模块规范。建议方案标为建议,验证配置标为测试配置;不得把测试兑换比例、模拟模型或旧版本接口写成正式承诺。

若待定项影响当前编码,任务状态写明具体阻断与可独立推进部分。只要求文档建设时保留待定清单,不为每个未来事项立即向用户反复索取批准。

2026-10-07 多资源策略与旧单位核对

PD-16 多资源抵扣、叠加、次数计量与余额回退(2026-10-07本轮策略已确定):先匹配有效范围,再跨积分/次数按较早到期及稳定资源标识排序,可分摊到多个匹配grant;同订阅每个周/月窗口共同校验,不合并为两份资产。“仅使用权益”禁止普通钱包,允许回退时保存明确钱包最高支出,不因不足扩大原授权。图片/视频按可信成功输出张数/条数计量,部分成功只核销确认成功部分,未知保留原分配;模型/尺寸/时长/画质/声音和产品范围快照限制福利,不能扩大Key模型许可。Key额度按整体调用的原标准价等值独立记量,实际钱包支出另记。完整规则与同原operation事务、并发及恢复的本地验收见多资源权益,未验真实供给仍关闭。

PD-12的扩展要求:旧字段名中的USD不作为真实美元换算依据;先核原商业单位与消费购买力,再冻结有依据的换算/旧价保护版本。旧已到账钱包的充值赠金不得同时生成为新grant;旧独立现金返利保留原币种和待审核/待生效/可提现/已处理等原事实,不自动改为本期邀请积分。旧订阅7天/30天并行窗口保全其锚点、各窗已用和原期限,不能直接改自然周/月或迁移时重置满额。运行版本/schema与本地有漂移时按实际快照分别归档,不能用本地目录名代替线上证据。

PD-15/16为本轮用户继续实现授权下的现行策略,PD-12实际转换与旧客户完整运营恢复仍属切换前输入;源码/线上审计或隔离测试不构成真实客户兑换政策批准。PL-020/T-12已本地实现并按列明范围隔离验收,正式迁移、真实供给/商户和完整运营承接仍未完成。

2026-10-10 商业商品结构与构建默认

D-COMMERCIAL-SHARED-USAGE已确定通用充值+有限共享用量订阅+按需专项商品,产品功能资格分别定义;完整流程和首期默认见整体方案。新增PL-021.R08~12沿T-05/07/08/09/12/13执行。具体价格、额度和商户输入不阻断本地编码,只决定具名商品可售及真实联调。

已列明首期构建默认:简单30天有限额度,API及获准产品共池;专项本域/跨域显式授权;同族单当前档、续期接续、下期换档;人工现金案件与可信外部凭证,无自动渠道退款。资源的先到期、原窗口返还和UNKNOWN保留继续按PD-15/16,不因编辑器简化改变旧权益。

仍需在对应商品发布或能力开放前提供:实际现金售价与资源数量/成本数据、专项模型/规格及可信供给、退款金额和已使用/赠送/返利的具名核算政策、真实商户与域名/凭据。功能会员需实际功能定义与访问控制;自动续费、即时补差及复杂折算保留后续。原PD-10/11/12的结果留存、运维和旧客户购买力门槛保持。

On this page