模块说明:分段收费指把一个班级的学费拆成多个"段次"分批收取,降低家长一次性缴费门槛。业务上存在两种来源的分段:产品分段(存量已实现能力)与分校(顾问)分段(本次二期新增,即原"手工分段/顾问分段"叫法)。
需求背景:广州追随欠费率约 50%,需要分段收费能力承接一次性缴费困难的家长。 | 涉及页面:06 课程详情、07 购物车与下单、08 我的订单与优惠券、TMS 后台
| 维度 | 产品分段(存量) | 分校(顾问)分段 |
|---|---|---|
| 分段来源 | TMS 系统管理员配置:课程分段;顾问无法操作是否分段 | TMS 系统管理员配置:分校分段;顾问在 TMS 同步购物车时选择是否分段 |
| 配置方 | TMS 系统管理员 | TMS 系统管理员 |
| 分段维度 | 符合条件的课程,课程下的班级按讲次划分 | 符合条件的分校:分校下班级按讲次划分(每段起止讲次) |
| 购物车缴费范围 | 展示全部段次;未到缴费时间的段次不可缴 | 展示全部段次,只缴当前可缴费的首个段次(序号最小的可缴段) |
| 到缴费时间后行为(唯一差异点) | 必须全部段次一起缴费 | 仍只缴一段,后续段次到「订单 - 待补缴」继续缴 |
| 资料费归段 | 默认合入首段;首段已完全过期时合入实际可缴的首个段次 | 默认合入首段;首段已完全过期时合入实际可缴的首个段次 |
| 待补缴侧行为 | 已到缴费时间的段次一次性合并缴 | 与产品分段一致(详见 §六) |
| 展示位置 | 课程分段会在课程详情显示,分校(顾问)分段只在购物车显示 | |
业务规则/待确认/分段收费待确认.md模块说明:分校(顾问)分段的段次不由课程产品决定,而由 TMS 后台按城市分校维度配置,顾问在推送购物车时决定该笔是否走分段。
配置方:TMS 系统管理员 | 章节组成:配置维度 → 同步购物车 → 网报端识别优先级 → 段次数据来源
| 配置项 | 说明 |
|---|---|
| 配置粒度 | 按「城市 + 分校」配置(如广州某分校"春秋4讲"、寒暑"全讲") |
| 分段数 | 该分校下班级拆成几段 |
| 每段起止讲次 | 每段覆盖第几讲到第几讲(后台配置维度,不在 C 端展示) |
| 段次开始缴费时间 | 每段从哪一天起可缴费,决定段次状态流转与待补缴按钮可点性 |
| 个性化分段 | 分校未配置分段时,可针对指定推送客户单独配置分段缴费 |
| 字段 | 来源 | 规则 |
|---|---|---|
| classPaySegments | 商品接口 / getClassPaySegment | 段次数组,2 种来源:产品(课程)分段 / 手动分段-TMS |
| good.segmentSource | 商品接口 | product / manual_tms,默认 product |
| 分校(顾问)分段段次生成 | TMS 分校分段配置 | 按"城市+分校"配置生成,配置维度含分段数、每段起止讲次、段次开始缴费时间 |
| segmentName | 接口返回 | 按「学期 + 段序号」拼接(§一 2) |
| classMaterialFee | 商品接口 | 学习资料费,归段规则见 §五 3 |
模块说明:段次状态由接口字段 segmentStatus 返回,购物车(07)与订单(08)共用同一套值定义,本节为唯一权威定义。
关键字段:segmentStatus | 引用方:07 购物车段次行、08 订单待补缴 segmentLabelObj
| 值 | 状态 | 含义 | C 端表现 |
|---|---|---|---|
| 0 | 已结课 / 已缴 | 该段次已完成(购物车语义为已结课,订单语义为已缴) | 段名 + 状态文字 + 金额,整行灰显 |
| 1 | 现缴 | 当前可缴费的段次 | 段名加粗 + "现缴" + 金额橙色,参与勾选与合计 |
| 2 | 待缴 | 后续尚未到缴费时间的段次 | 段名 + "待缴" + 金额,整行浅灰,不可勾选 |
| 3 | 已过期 | 该段次讲次已过,家长已无法购买 | 置灰展示,不可勾选、不可缴费、不参与金额计算 |
段名 + 状态文字 + 金额,右对齐金额| 概念 | 层级 | 影响范围 |
|---|---|---|
| 段次「已过期」(segmentStatus=3) | 段次级 | 仅该段不可买,班级仍在正常商品区,其余段次照常可缴 |
| 段次「已结课」(segmentStatus=0) | 段次级 | 该段已上完,灰显不可缴 |
| 班级「服务已结课」 | 班级级 | 整个商品归入底部失效区,判定清单见 07 §四 失效判定 |
模块说明:课程详情页在班级存在分段配置时提供「分段缴费明细」入口,供家长在加购前了解分几段、每段多少钱。界面结构详见 06-课程详情 §1.3,规则以本节为准。本节仅适用于产品分段(即课程分段);分校(顾问)分段不在课程详情展示,只在购物车展示(§一 展示位置)。
入口:课程详情页「查看分段缴费明细」 | 适用范围:仅产品分段(课程分段)
| 维度 | 说明 |
|---|---|
| 来源 | getClassPaySegment 接口返回 classPaySegments 数组 |
| 展示字段 | segmentName(段名)、payPrice(缴费金额);startDate / endDate 与起止讲次不在 C 端展示 |
| 排序 | 按段序号正序 |
| 入口显隐 | classPaySegments 为空 → 不显示分段入口,按整课价格展示 |
模块说明:购物车是分段收费的核心缴费场景。分校(顾问)分段在此展示全部段次但只缴当前可缴的首个段次,这是与产品分段的唯一差异点。
入口:底部 Tab「购物车」/ TMS 同步购物车(分段支付) | 章节组成:界面结构 → 缴费范围 → 资料费归段 → 段次失效 → 异常兜底 → 深圳分主体场景
段名 + 状态文字 + 金额(如"春季1段 现缴 ¥700"、"春季2段 待缴 ¥700")模块说明:首段缴费完成后,剩余段次进入「我的 - 订单 - 待补缴」继续缴。待补缴侧口径与产品分段一致:已到缴费时间的段次一次性合并缴,与购物车侧"只缴一段"不同。
入口:我的 - 订单 - 待补缴 Tab | 章节组成:首段支付完成后 → 卡片界面结构 → 补缴范围规则 → 数据规则
段名 + 状态文字 + 金额(如"秋季1段 已缴 ¥500"灰显、"秋季2段 待缴 ¥100")| 场景 | 可缴范围 |
|---|---|
| 多个段次同时到达可缴费时间 | 一次性合并缴(不拆单)。示例:二段、三段都到期 → 合并缴两段 |
| 仅部分段次到期 | 只缴已到期段次。示例:仅二段到期 → 只缴二段 |
| 无段次到期 | 按钮置灰,显示最近一段的「补缴时间 MM-DD」 |
| 字段 | 说明 |
|---|---|
| segmentLabelObj | 段次状态文案映射,值定义以 §三 段次状态机 为准 |
| 补缴入口 | 复用 continuePay 接口,跳 07 收银台走补缴结算 |
| 补缴时间文案 | 取该段次「开始缴费时间」,格式 MM-DD |
模块说明:分段商品在数据缺失、班级不可插班、段次全部过期、接口异常四类场景下的兜底表现,以及插班计价的待确认项。
失效区判定与 07 §四 联动 | 章节组成:已明确兜底规则 → 插班场景(待确认)
| 场景 | 处理 |
|---|---|
| 分段数据缺失 | 按整课价格展示,不显示段次明细与分段入口 |
| 班级不可插班 | 开课后整班失效,归入购物车底部失效区 |
| 段次全部过期 | 移入失效区(已无可缴段次,等同不可购买) |
| 接口异常 | 维持上次数据 + toast 提示,不阻断非分段商品的正常结算 |
上述三条涉及"按剩余讲次计价"能力,与现有按段整价收费的模型不同,确认前不落开发。跟踪见 §九。
模块说明:分段收费涉及的全部配置项汇总,供开发与运营核对配置入口与默认值。
配置方:TMS 系统管理员 | 配置维度详见 §二 TMS 分段配置
| 配置项 | 说明 | 默认值 / 配置方 |
|---|---|---|
| 分段来源标识 | good.segmentSource: product / manual_tms | product |
| 城市+分校分段配置 | TMS 后台按地区配置(如寒暑全讲 / 春秋4讲) | 按地区配置 |
| TMS 分校分段配置维度 | 分段数 / 每段起止讲次 / 段次开始缴费时间 | 按城市分校配置 |
| 个性化分段开关 | 分校未配置分段时,是否允许对指定推送客户单独配置分段 | TMS 基础信息 |
| 是否允许购买过去时间讲次 | 录播等场景下已过讲次是否仍可购买,影响"已过期"判定 | 待确认 |
模块说明:本文档中尚未定稿、不作为开发依据的事项集中登记处,确认后回写正文并补修订记录。
跟踪文件:业务规则/待确认/分段收费待确认.md | 状态:全部待确认
| # | 事项 | 状态 |
|---|---|---|
| 1 | 插班场景三条计价规则(§七 2)—— 语雀原文标注"需确认" | 待确认 |
| 2 | 是否允许购买过去时间讲次(录播场景),影响"已过期"段次是否真的不可买 | 待确认 |
| 3 | 文档冲突:业务规则/来源资料/需求清单/网报Sprint需求清单.md 分校(顾问)分段仍标「暂缓/待确认」,与本文档二期口径不一致 | 待确认 |
| 4 | 「个性化分段」的定位:识别优先级已确认为「课程分段 → 分校分段」两级(§二 3),个性化分段不在该链路中。但 TMS 侧仍存在个性化分段配置(§二 1 / §二 2 推送信息 / §八)。需确认:个性化分段是 TMS 内部实现细节(网报无感知),还是应作为第三级优先级 | 待确认 |
| 5 | 分校(顾问)分段在待补缴侧的展示:§一 确认"分校(顾问)分段只在购物车显示"(相对课程详情而言);§六 待补缴仍覆盖分校(顾问)分段。需确认"只在购物车"是否仅指 C 端选购环节,不含订单侧待补缴 | 待确认 |
业务规则/待确认/分段收费待确认.md。上述事项确认后再回写本文档与 Sprint 清单。| 修订项 | 修订内容 | 期数 | 依据来源 | 日期 |
|---|---|---|---|---|
| 流程注清理 | 删除「原待确认清单 N 已闭环」「用户裁定归属/承载/迁入」等闭环与归属性流程注,保留裁定结果内容与来源依据注 | 二期 | 用户裁定 2026-08-06 | 2026-08-06 |
| 红框标注校准 | 按 PIL 图像测量 + 读图目检校准 1 处部件级红框位置:修正弹窗/toast/列表区域框错位,叠加弹窗图(输错 1/2)改框整组弹窗区,同页面不同状态截图确认沿用同参数 | 二期 | PIL 测量校准 2026-08-05 | 2026-08-05 |
| 图组布局规则统一 | 依 00 V1.10 新布局规则:同层级多图(同图不同状态/图+弹窗/同流程步骤)一律横排,每张统一 280px 宽(uniform),容器横向滚动查看(细滚动条常显 + 右侧渐变提示防漏看);本页 1 个图组统一改造(其中 1 组竖排改横排),half/third 混宽与多图竖排旧规则废止 | 二期 | 用户裁定 2026-08-05 | 2026-08-05 |
| 业务规则库接入 | 分段类型、段次状态、缴费范围与资料费归段等跨页口径改为引用 WB-SEGMENT-001,本页保留本版界面与验收说明;未确认内容继续留在待确认专题 | 跨期 | 业务规则库首批提取 | 2026-08-05 |
| 待裁定回写 | §五 6 段次行日期小字裁定:= 产品分段开放缴费日期(对应 §二 1 段次开始缴费时间配置),且购物车全部通用(不限深圳分主体场景);与 §一 2「不展示起止日期」不冲突(单段开放缴费日 ≠ 课程起止日期)(原待确认清单 7 闭环) | 二期 | 用户裁定 2026-08-05 | 2026-08-05 |
| 模块首版 | 分段收费独立成模块,作为唯一权威源:两种分段对照(§一)、TMS 分段配置(§二)、段次状态机含 3=已过期(§三)、课程详情侧展示(§四)、购物车只缴当前可缴首段(§五)、待补缴多段合并缴(§六)、插班三条标注待确认(§七);06/07/08/00 的分段业务规则收敛至本文档并改为引用 | 二期 | 语雀《分段收费》2026-07-30 | 2026-07-30 |
| 段次行展示口径修正 | 依据语雀贴图核对:段次行仅段名 + 状态文字 + 金额,不展示起止日期、不展示起止讲次(起止讲次仅为 TMS 后台配置维度);状态以文字后缀展示而非徽标;修正前述"分校(顾问)分段显示起止讲次"的错误表述 | 二期 | 语雀《分段收费》贴图 | 2026-07-30 |
| 待补缴界面补充 | 依据语雀贴图补充:订单状态"等待补缴";金额行四段式(原价/优惠/已缴/待缴);按钮两态——已到期「立即补缴」橙色可点、未到期「补缴时间 MM-DD」灰色禁用 | 二期 | 语雀《分段收费》贴图 | 2026-07-30 |
| 配置主体与分段维度校准 | 业务批注确认(14 条):两种分段均由 TMS 系统管理员配置——课程分段(顾问无法操作是否分段)/ 分校分段(顾问同步购物车时可选是否分段);两种分段均按讲次划分,产品分段原"按日期划分(startDate/endDate)"表述有误已修正;分段维度口径改为"符合条件的课程/分校,其下班级按讲次划分";模块说明"按地区维度"改为"按城市分校维度"(§一 1、§二) | 二期 | 业务批注 2026-07-30 | 2026-07-30 |
| 识别优先级反转 | 网报端识别优先级由「分校分段 → 个性化分段」修正为「课程分段 → 分校(顾问)分段」;段次来源由 3 种收敛为 2 种(产品/课程分段、手动分段-TMS),移除 manual_wb(手动分段-网报);个性化分段脱离优先级链,定位列入待确认(§二 3、§二 4、§九 4) | 二期 | 业务批注 2026-07-30 | 2026-07-30 |
| 展示位置与适用范围收敛 | 课程分段在课程详情显示,分校(顾问)分段只在购物车显示;§四 分段缴费明细弹窗标注仅适用产品分段,同步在 06 §1.3 补"适用范围"说明;资料费归段口径两种分段统一为"默认合入首段,首段已完全过期时合入实际可缴的首个段次"(§一 1、§四、06 §1.3) | 二期 | 业务批注 2026-07-30 | 2026-07-30 |
| 段次全部过期改入失效区 | 「段次全部过期」处理由"不可勾选但不移入失效区"改为移入底部失效区(已无可缴段次,等同不可购买);同步修正 §三 易错点 note 与 §五 5 异常兜底;07 §四 失效判定清单由 4 类扩为 5 类(新增"⑤ 分段商品全部段次已过期"),并注明与"未到缴费时间不入失效区"的区别(§三、§五、§七、07 §四) | 二期 | 业务批注 2026-07-30 | 2026-07-30 |
| 文档格式与存量对齐 | 修正本文档章节范式与 06/07/08 不一致的问题:§一~§九 全部补齐 section-title 的 badge 计数徽标(如"8个维度"/"4种状态"/"5类规则"),模块说明由正文首段抽出为独立说明区(标题下 global-section + 底边框 + 灰字副行"入口/章节组成"),与存量页面完全一致;§五 §六 原缺模块说明区一并补齐 | 二期 | 格式核对 2026-07-30 | 2026-07-30 |
| 矛盾检查修订 | 全量矛盾检查修复:§五 失效清单衔接第⑤类「分段商品全部段次已过期」(与 07 §四 一致);§六 操作按钮两态修正为三态(orderCanRePay===3「立即补缴」可点 / ===4「未开放补缴」禁用 / 其他「补缴时间 MM-DD」禁用);「手工分段/顾问分段」叫法全文统一为「分校(顾问)分段」(§一 模块说明保留原叫法过渡注) | 二期 | 全量矛盾检查 | 2026-07-30 |
| 网报3.0设计稿合入 | §五 新增「6. 深圳分主体(课包)场景」:课包分组(不同课包需分开结算哦)+ 跨课包勾选 toast「请分开结算哦」(引 07 §二)+ 段次行灰色日期小字(疑似段次开始缴费时间,字段语义待确认)+ 勾选热区加大批注;左栏新增设计稿图「深圳-分主体支付&顾问分段」与语雀图竖排并列;badge 由 5 类规则改 6 类 | 二期 | 网报3.0升级设计稿-20260804 | 2026-08-05 |