网报小程序 — 分段收费 — 产品需求说明书

版本 V1.6 更新 2026-08-06 归属:二期(M2 · 分段收费,2026-07-30 技术可上线) 全局规则引用:01-全局通用规则.html
本文档为分段收费的唯一权威源。06 课程详情 / 07 购物车与下单 / 08 我的订单与优惠券 仅保留各自的界面结构描述,分段业务规则统一以本文档为准,避免同一口径多处不一致。
一、能力总览与两种分段对照 8个维度

模块说明:分段收费指把一个班级的学费拆成多个"段次"分批收取,降低家长一次性缴费门槛。业务上存在两种来源的分段:产品分段(存量已实现能力)与分校(顾问)分段(本次二期新增,即原"手工分段/顾问分段"叫法)。

需求背景:广州追随欠费率约 50%,需要分段收费能力承接一次性缴费困难的家长。 | 涉及页面:06 课程详情、07 购物车与下单、08 我的订单与优惠券、TMS 后台

1. 两种分段对照

维度产品分段(存量)分校(顾问)分段
分段来源TMS 系统管理员配置:课程分段;顾问无法操作是否分段TMS 系统管理员配置:分校分段;顾问在 TMS 同步购物车时选择是否分段
配置方TMS 系统管理员TMS 系统管理员
分段维度符合条件的课程,课程下的班级按讲次划分符合条件的分校:分校下班级按讲次划分(每段起止讲次)
购物车缴费范围展示全部段次;未到缴费时间的段次不可缴展示全部段次,只缴当前可缴费的首个段次(序号最小的可缴段)
到缴费时间后行为(唯一差异点)必须全部段次一起缴费仍只缴一段,后续段次到「订单 - 待补缴」继续缴
资料费归段默认合入首段;首段已完全过期时合入实际可缴的首个段次默认合入首段;首段已完全过期时合入实际可缴的首个段次
待补缴侧行为已到缴费时间的段次一次性合并缴与产品分段一致(详见 §六)
展示位置课程分段会在课程详情显示,分校(顾问)分段只在购物车显示
权威口径:两种分段的识别优先级、段次状态、缴费范围与资料费归段以 WB-SEGMENT-001 为准;本页详细表格作为当前版本页面表现与验收依据。
范围说明:产品分段为存量已实现能力,本次不改动,在此仅作对照以明确分校(顾问)分段的差异边界。本文档打 徽标的内容为分校(顾问)分段新增部分。

2. 段名口径(两种分段通用)

  • 段名统一按「学期 + 段序号」拼接:如"春季1段""春季2段""秋季1段"
  • 不分段商品直接展示学期名(如"春季"),不带段序号
  • 段次行只展示段名 + 状态 + 金额,不展示起止日期,也不展示起止讲次(起止讲次仅为 TMS 后台配置维度,不出现在 C 端)

3. 关联文档

二、TMS 分段配置 5个配置项

模块说明:分校(顾问)分段的段次不由课程产品决定,而由 TMS 后台按城市分校维度配置,顾问在推送购物车时决定该笔是否走分段。

配置方:TMS 系统管理员  |  章节组成:配置维度 → 同步购物车 → 网报端识别优先级 → 段次数据来源

1. 配置维度

配置项说明
配置粒度按「城市 + 分校」配置(如广州某分校"春秋4讲"、寒暑"全讲")
分段数该分校下班级拆成几段
每段起止讲次每段覆盖第几讲到第几讲(后台配置维度,不在 C 端展示)
段次开始缴费时间每段从哪一天起可缴费,决定段次状态流转与待补缴按钮可点性
个性化分段分校未配置分段时,可针对指定推送客户单独配置分段缴费

2. 同步购物车(分段支付)

  • TMS 新增"同步购物车(分段支付)"操作,将当前学员及班级信息同步至网报购物车,并打上"需分段"标签
  • 推送信息包含:学员信息、班级信息、分段信息(取基础信息中"个性化分段")
  • 顾问在 TMS 待缴费列表同步班级时可选是否分段;不选则按整课一次性缴费

3. 网报端识别优先级

  1. 优先按课程分段为准
  2. 课程未配置时再识别分校(顾问)分段
  3. 两者均无 → 不分段,展示整课价格
优先级为课程分段 → 分校分段两级。TMS 侧的"个性化分段"配置(见本节 1)不在此链路中,其定位待确认(§九 4)。

4. 段次数据来源

字段来源规则
classPaySegments商品接口 / getClassPaySegment段次数组,2 种来源:产品(课程)分段 / 手动分段-TMS
good.segmentSource商品接口product / manual_tms,默认 product
分校(顾问)分段段次生成TMS 分校分段配置按"城市+分校"配置生成,配置维度含分段数、每段起止讲次、段次开始缴费时间
segmentName接口返回按「学期 + 段序号」拼接(§一 2)
classMaterialFee商品接口学习资料费,归段规则见 §五 3
TMS 分段配置页的字段与校验规则暂未纳入本文档(缺原型与字段清单),本节仅锁定配置维度。
三、段次状态机 4种状态

模块说明:段次状态由接口字段 segmentStatus 返回,购物车(07)与订单(08)共用同一套值定义,本节为唯一权威定义。

关键字段:segmentStatus  |  引用方:07 购物车段次行、08 订单待补缴 segmentLabelObj

1. 状态值定义

值状态含义C 端表现
0已结课 / 已缴该段次已完成(购物车语义为已结课,订单语义为已缴)段名 + 状态文字 + 金额,整行灰显
1现缴当前可缴费的段次段名加粗 + "现缴" + 金额橙色,参与勾选与合计
2待缴后续尚未到缴费时间的段次段名 + "待缴" + 金额,整行浅灰,不可勾选
3已过期该段次讲次已过,家长已无法购买置灰展示,不可勾选、不可缴费、不参与金额计算

2. 状态展示形态

  • 状态以段名后的文字后缀展示("现缴""待缴""已缴""已过期"),不使用徽标/色块
  • 段次行结构固定为:段名 + 状态文字 + 金额,右对齐金额
  • 不可缴段次(待缴 / 已缴 / 已过期)整行降灰,仅现缴段为正常色

3. 与班级级状态的区别

概念层级影响范围
段次「已过期」(segmentStatus=3)段次级仅该段不可买,班级仍在正常商品区,其余段次照常可缴
段次「已结课」(segmentStatus=0)段次级该段已上完,灰显不可缴
班级「服务已结课」班级级整个商品归入底部失效区,判定清单见 07 §四 失效判定
易错点:单个段次"已过期"≠ 班级失效。只要还存在可缴段次,商品就留在正常商品区,已过期段次仅置灰;全部段次都已过期时该商品已无可缴段次,移入失效区(§七)。此外命中 07 §四 的班级级失效判定(班级下架 / 已截止报名 / 已结课 / 已满班 / 分段商品全部段次已过期)同样移入失效区。
四、课程详情侧展示 — 分段缴费明细弹窗 5个字段

模块说明:课程详情页在班级存在分段配置时提供「分段缴费明细」入口,供家长在加购前了解分几段、每段多少钱。界面结构详见 06-课程详情 §1.3,规则以本节为准。本节仅适用于产品分段(即课程分段);分校(顾问)分段不在课程详情展示,只在购物车展示(§一 展示位置)。

入口:课程详情页「查看分段缴费明细」  |  适用范围:仅产品分段(课程分段)

1. 界面结构

  • 弹窗标题:分段缴费明细
  • 段次列表:每段一行,仅显示段名 + 缴费金额(不显示起止日期,不显示起止讲次)
  • 段名:按「学期 + 段序号」,如"春季1段""春季2段"
  • 资料费:合入的段次单独标注学习资料费(classMaterialFee)
  • 合计区:底部显示总金额

2. 数据规则

维度说明
来源getClassPaySegment 接口返回 classPaySegments 数组
展示字段segmentName(段名)、payPrice(缴费金额);startDate / endDate 与起止讲次不在 C 端展示
排序按段序号正序
入口显隐classPaySegments 为空 → 不显示分段入口,按整课价格展示

3. 异常与兜底

  • 接口失败 → 不显示分段入口,不阻断加购主流程
  • 段次金额之和与整课价格不一致 → 以接口返回的合计为准,前端不做二次计算
五、购物车侧规则 6类规则

模块说明:购物车是分段收费的核心缴费场景。分校(顾问)分段在此展示全部段次但只缴当前可缴的首个段次,这是与产品分段的唯一差异点。

入口:底部 Tab「购物车」/ TMS 同步购物车(分段支付)  |  章节组成:界面结构 → 缴费范围 → 资料费归段 → 段次失效 → 异常兜底 → 深圳分主体场景

购物车分段展示(顾问/系统推荐课程 分校(顾问)分段)
深圳分主体(课包)场景下的分校(顾问)分段(2026-08-05 批设计稿)

1. 界面结构

  • 不分段商品:班级信息下一行展示"学期名 + 开课日期 + 金额"(如"春季 / 2026-03-08 / ¥700")
  • 分段商品:展示全部段次,每段一行 段名 + 状态文字 + 金额(如"春季1段 现缴 ¥700"、"春季2段 待缴 ¥700")
  • 分段信息默认全部展开,无折叠交互
  • 不可缴段次整行降灰(待缴 / 已缴 / 已过期),仅现缴段为正常色

2. 缴费范围(核心规则)

  • 只缴当前可缴费的首个段次:即段序号最小、状态为"现缴"的段次;其余段次仅展示不参与缴费
  • 即使后续段次已到缴费时间,购物车仍只缴一段——这是分校(顾问)分段与产品分段的唯一差异点(产品分段到缴费时间后必须全部段次一起缴)
  • 合计金额:只累加可缴段次金额;已过期 / 待缴 / 已缴段次不参与合计
  • 勾选粒度为商品级(勾选该班级即缴其当前可缴段),家长无法自选缴哪一段

3. 资料费归段

  • classMaterialFee 默认合入首段
  • 首段已完全过期时,合入实际可缴的首个段次(如首段过期、实际从第二段起缴,则资料费合入第二段)
  • 资料费只合入一次,后续段次不再重复计入

4. 段次失效与班级失效

  • 段次「已过期」不导致商品失效,商品留在正常商品区(见 §三 3)
  • 班级级失效判定清单(班级下架 / 服务已截止报名 / 服务已结课 / 服务已满班 / 分段商品全部段次已过期)沿用购物车通用逻辑,详见 07 §四 编辑/删除/失效,本文档不重复定义
  • 「服务未到缴费时间」不归入失效区,留正常商品区置灰,倒计时到点自动可选(同上引用)

5. 异常与兜底

  • 分段数据缺失 → 显示整课价格,不展示段次明细
  • 全部段次均为"已过期" → 该商品无可缴段次,移入底部失效区(§七),家长需通过插班逻辑处理(见 §七 2)
  • queryPre 返回金额与前端累加不一致 → 以 queryPre 为准

6. 深圳分主体(课包)场景(2026-08-05 批设计稿)

  • 课包分组:深圳分主体(不同财务主体)商品按「课包1 / 课包2…」分组,组头带分组勾选框 + 灰字提示「不同课包需分开结算哦」(分组规则见 07 §二 分主体分组,financeId / financeDisplayName)
  • 跨课包勾选拦截:勾选另一课包商品时 toast「请分开结算哦」,当前课包勾选状态不受影响
  • 分主体与分段叠加:课包内分段商品的段次展示与缴费规则不变——展示全部段次、只缴当前可缴首段(§五 1 / 2)
  • 段次行日期小字(已裁定):段名 + 状态行下方展示灰色日期小字(格式 YYYY/MM/DD,如"2段 现缴 / 2026/07/08")——2026-08-05 用户裁定:该小字为产品分段的开放缴费日期(对应 §二 1 配置维度"段次开始缴费时间"),且购物车全部通用(不限深圳分主体场景,凡购物车分段商品段次行均展示)。与 §一 2「不展示起止日期」不冲突:此处展示的是单段「开放缴费日」,非课程起止日期。
  • 勾选热区:设计稿红字批注「前端:点击热区范围大点」——勾选点击热区范围加大
来源:网报3.0升级设计稿-20260804(深圳-分主体支付&顾问分段)。核心规则不变:分主体仅影响分组与结算拦截,分校(顾问)分段「只缴当前可缴首段」不受影响。
六、支付与待补缴 4类规则

模块说明:首段缴费完成后,剩余段次进入「我的 - 订单 - 待补缴」继续缴。待补缴侧口径与产品分段一致:已到缴费时间的段次一次性合并缴,与购物车侧"只缴一段"不同。

入口:我的 - 订单 - 待补缴 Tab  |  章节组成:首段支付完成后 → 卡片界面结构 → 补缴范围规则 → 数据规则

我的-订单-待补缴(分校(顾问)分段+产品分段)

1. 首段支付完成后

  • 支付结果页提示后续段次待缴;分校(顾问)分段首段缴完后进入「我的 - 订单 - 待补缴」继续缴后续段次
  • 订单状态置为「等待补缴」,卡片右上角显示该状态文字

2. 待补缴卡片界面结构

  • Tab:待支付 / 待补缴 / 已完成
  • 段次列表:每段一行 段名 + 状态文字 + 金额(如"秋季1段 已缴 ¥500"灰显、"秋季2段 待缴 ¥100")
  • 金额行(四段式):原价 ¥X   优惠 ¥X   已缴 ¥X   待缴 ¥X(待缴金额橙色强调)
  • 操作按钮三态(判定字段 orderCanRePay,口径与 08 待补缴列表一致):
    • orderCanRePay===3(已到缴费时间) → 「立即补缴」橙色实心可点
    • orderCanRePay===4 → 「未开放补缴」灰色禁用
    • 其他(未到缴费时间) → 「补缴时间 MM-DD」灰色禁用,文案带该段开始缴费日期(toPayTime)

3. 补缴范围规则(与购物车侧不同)

场景可缴范围
多个段次同时到达可缴费时间一次性合并缴(不拆单)。示例:二段、三段都到期 → 合并缴两段
仅部分段次到期只缴已到期段次。示例:仅二段到期 → 只缴二段
无段次到期按钮置灰,显示最近一段的「补缴时间 MM-DD」
与购物车侧的差异:购物车侧分校(顾问)分段始终只缴一段;待补缴侧与产品分段口径一致,已到期段次合并缴。两侧规则不同是有意设计,不要相互套用。

4. 数据规则

字段说明
segmentLabelObj段次状态文案映射,值定义以 §三 段次状态机 为准
补缴入口复用 continuePay 接口,跳 07 收银台走补缴结算
补缴时间文案取该段次「开始缴费时间」,格式 MM-DD
界面结构详见 08-我的订单与优惠券 待补缴 Tab;补缴规则以本节为准。
七、异常与兜底 4条兜底

模块说明:分段商品在数据缺失、班级不可插班、段次全部过期、接口异常四类场景下的兜底表现,以及插班计价的待确认项。

失效区判定与 07 §四 联动  |  章节组成:已明确兜底规则 → 插班场景(待确认)

1. 已明确的兜底规则

场景处理
分段数据缺失按整课价格展示,不显示段次明细与分段入口
班级不可插班开课后整班失效,归入购物车底部失效区
段次全部过期移入失效区(已无可缴段次,等同不可购买)
接口异常维持上次数据 + toast 提示,不阻断非分段商品的正常结算

2. 插班场景(待确认)

以下三条为语雀《分段收费》原文标注"需确认"的内容,尚未定稿,不作为开发依据。
  1. 段次已过期 → 购买下一个可服务段次
  2. 段次未过期 → 购买当前段次剩余讲次
  3. 段次未过期且配置为可购买全讲 → 购买该段全部讲次

上述三条涉及"按剩余讲次计价"能力,与现有按段整价收费的模型不同,确认前不落开发。跟踪见 §九。

八、配置项清单 5个配置项

模块说明:分段收费涉及的全部配置项汇总,供开发与运营核对配置入口与默认值。

配置方:TMS 系统管理员  |  配置维度详见 §二 TMS 分段配置

配置项说明默认值 / 配置方
分段来源标识good.segmentSource: product / manual_tmsproduct
城市+分校分段配置TMS 后台按地区配置(如寒暑全讲 / 春秋4讲)按地区配置
TMS 分校分段配置维度分段数 / 每段起止讲次 / 段次开始缴费时间按城市分校配置
个性化分段开关分校未配置分段时,是否允许对指定推送客户单独配置分段TMS 基础信息
是否允许购买过去时间讲次录播等场景下已过讲次是否仍可购买,影响"已过期"判定待确认
九、待确认事项 5项待确认

模块说明:本文档中尚未定稿、不作为开发依据的事项集中登记处,确认后回写正文并补修订记录。

跟踪文件:业务规则/待确认/分段收费待确认.md  |  状态:全部待确认

#事项状态
1插班场景三条计价规则(§七 2)—— 语雀原文标注"需确认"待确认
2是否允许购买过去时间讲次(录播场景),影响"已过期"段次是否真的不可买待确认
3文档冲突:业务规则/来源资料/需求清单/网报Sprint需求清单.md 分校(顾问)分段仍标「暂缓/待确认」,与本文档二期口径不一致待确认
4「个性化分段」的定位:识别优先级已确认为「课程分段 → 分校分段」两级(§二 3),个性化分段不在该链路中。但 TMS 侧仍存在个性化分段配置(§二 1 / §二 2 推送信息 / §八)。需确认:个性化分段是 TMS 内部实现细节(网报无感知),还是应作为第三级优先级待确认
5分校(顾问)分段在待补缴侧的展示:§一 确认"分校(顾问)分段只在购物车显示"(相对课程详情而言);§六 待补缴仍覆盖分校(顾问)分段。需确认"只在购物车"是否仅指 C 端选购环节,不含订单侧待补缴待确认
完整背景、语雀原文引用与跟踪记录见 业务规则/待确认/分段收费待确认.md。上述事项确认后再回写本文档与 Sprint 清单。
十、修订记录(V1.6 / 2026-08-06)
修订项修订内容期数依据来源日期
流程注清理删除「原待确认清单 N 已闭环」「用户裁定归属/承载/迁入」等闭环与归属性流程注,保留裁定结果内容与来源依据注二期用户裁定 2026-08-062026-08-06
红框标注校准按 PIL 图像测量 + 读图目检校准 1 处部件级红框位置:修正弹窗/toast/列表区域框错位,叠加弹窗图(输错 1/2)改框整组弹窗区,同页面不同状态截图确认沿用同参数二期PIL 测量校准 2026-08-052026-08-05
图组布局规则统一依 00 V1.10 新布局规则:同层级多图(同图不同状态/图+弹窗/同流程步骤)一律横排,每张统一 280px 宽(uniform),容器横向滚动查看(细滚动条常显 + 右侧渐变提示防漏看);本页 1 个图组统一改造(其中 1 组竖排改横排),half/third 混宽与多图竖排旧规则废止二期用户裁定 2026-08-052026-08-05
业务规则库接入分段类型、段次状态、缴费范围与资料费归段等跨页口径改为引用 WB-SEGMENT-001,本页保留本版界面与验收说明;未确认内容继续留在待确认专题跨期业务规则库首批提取2026-08-05
待裁定回写§五 6 段次行日期小字裁定:= 产品分段开放缴费日期(对应 §二 1 段次开始缴费时间配置),且购物车全部通用(不限深圳分主体场景);与 §一 2「不展示起止日期」不冲突(单段开放缴费日 ≠ 课程起止日期)(原待确认清单 7 闭环)二期用户裁定 2026-08-052026-08-05
模块首版分段收费独立成模块,作为唯一权威源:两种分段对照(§一)、TMS 分段配置(§二)、段次状态机含 3=已过期(§三)、课程详情侧展示(§四)、购物车只缴当前可缴首段(§五)、待补缴多段合并缴(§六)、插班三条标注待确认(§七);06/07/08/00 的分段业务规则收敛至本文档并改为引用二期语雀《分段收费》2026-07-302026-07-30
段次行展示口径修正依据语雀贴图核对:段次行仅段名 + 状态文字 + 金额,不展示起止日期、不展示起止讲次(起止讲次仅为 TMS 后台配置维度);状态以文字后缀展示而非徽标;修正前述"分校(顾问)分段显示起止讲次"的错误表述二期语雀《分段收费》贴图2026-07-30
待补缴界面补充依据语雀贴图补充:订单状态"等待补缴";金额行四段式(原价/优惠/已缴/待缴);按钮两态——已到期「立即补缴」橙色可点、未到期「补缴时间 MM-DD」灰色禁用二期语雀《分段收费》贴图2026-07-30
配置主体与分段维度校准业务批注确认(14 条):两种分段均由 TMS 系统管理员配置——课程分段(顾问无法操作是否分段)/ 分校分段(顾问同步购物车时可选是否分段);两种分段均按讲次划分,产品分段原"按日期划分(startDate/endDate)"表述有误已修正;分段维度口径改为"符合条件的课程/分校,其下班级按讲次划分";模块说明"按地区维度"改为"按城市分校维度"(§一 1、§二)二期业务批注 2026-07-302026-07-30
识别优先级反转网报端识别优先级由「分校分段 → 个性化分段」修正为「课程分段 → 分校(顾问)分段」;段次来源由 3 种收敛为 2 种(产品/课程分段、手动分段-TMS),移除 manual_wb(手动分段-网报);个性化分段脱离优先级链,定位列入待确认(§二 3、§二 4、§九 4)二期业务批注 2026-07-302026-07-30
展示位置与适用范围收敛课程分段在课程详情显示,分校(顾问)分段只在购物车显示;§四 分段缴费明细弹窗标注仅适用产品分段,同步在 06 §1.3 补"适用范围"说明;资料费归段口径两种分段统一为"默认合入首段,首段已完全过期时合入实际可缴的首个段次"(§一 1、§四、06 §1.3)二期业务批注 2026-07-302026-07-30
段次全部过期改入失效区「段次全部过期」处理由"不可勾选但不移入失效区"改为移入底部失效区(已无可缴段次,等同不可购买);同步修正 §三 易错点 note 与 §五 5 异常兜底;07 §四 失效判定清单由 4 类扩为 5 类(新增"⑤ 分段商品全部段次已过期"),并注明与"未到缴费时间不入失效区"的区别(§三、§五、§七、07 §四)二期业务批注 2026-07-302026-07-30
文档格式与存量对齐修正本文档章节范式与 06/07/08 不一致的问题:§一~§九 全部补齐 section-title 的 badge 计数徽标(如"8个维度"/"4种状态"/"5类规则"),模块说明由正文首段抽出为独立说明区(标题下 global-section + 底边框 + 灰字副行"入口/章节组成"),与存量页面完全一致;§五 §六 原缺模块说明区一并补齐二期格式核对 2026-07-302026-07-30
矛盾检查修订全量矛盾检查修复:§五 失效清单衔接第⑤类「分段商品全部段次已过期」(与 07 §四 一致);§六 操作按钮两态修正为三态(orderCanRePay===3「立即补缴」可点 / ===4「未开放补缴」禁用 / 其他「补缴时间 MM-DD」禁用);「手工分段/顾问分段」叫法全文统一为「分校(顾问)分段」(§一 模块说明保留原叫法过渡注)二期全量矛盾检查2026-07-30
网报3.0设计稿合入§五 新增「6. 深圳分主体(课包)场景」:课包分组(不同课包需分开结算哦)+ 跨课包勾选 toast「请分开结算哦」(引 07 §二)+ 段次行灰色日期小字(疑似段次开始缴费时间,字段语义待确认)+ 勾选热区加大批注;左栏新增设计稿图「深圳-分主体支付&顾问分段」与语雀图竖排并列;badge 由 5 类规则改 6 类二期网报3.0升级设计稿-202608042026-08-05