一、服务详情主页 核心转化页
模块说明：课程（班次）详情页是用户从首页推荐/选课列表/班级列表/搜索/分享等入口进入后，完成"了解 → 加购"关键转化动作的核心页面。页面信息层级深、字段多、状态分支复杂。
入口：选课列表点击课程卡 / 首页推荐 / 分享卡片 / 购物车"班级失效→重选" | 页面组成：服务详情主页 → 服务大纲子页 → 老师详情子页 → 5个弹窗
1.1 服务详情主页（已登录有数据）
1.1 界面结构（从上到下）
- 沉浸式头部 Banner：橙色主题图延伸至顶部状态栏，支持 image + video 混合轮播（swiper），右下角角标"1/N"
- 顶部控制按钮（随滚动从透明→白色背景）：左侧返回按钮、中间"服务详情"标题（滚动后显示）、右侧分享按钮 + 购物车角标
- 滑动 Tab（吸顶）：服务 / 指导 / 大纲 / 详情 四个锚点，点击自动滚动、滚动自动高亮
- 折扣倒计时区：折扣价 + 原价划线 + "距离恢复原价还剩 HH:MM:SS"
- 班级主体信息：类型标签（在线/线下/双师/AI，不同颜色）+ 班级名 + 副标题（后台配置，展示在班级名下方）+ 简介 + 难度
- 基础信息：地点（校区或省市）+ 时间段次 + 课次数
- 价格区：当前价 ¥ + "分段缴费 ▼"按钮（若有分段）+ 报名热度标签（已满/剩N名额/热报）+ 右侧"查看同类班级 ›"
- 特色介绍：其他费用（学习资料 ¥）+ 优惠标签列表
- 诊断提示（按城市/学期/年级/学科/产品判断）：① 不需要诊断→隐藏；② 录取班型与课程班型匹配→隐藏；③ 录取班型不匹配→黄色横条"根据诊断结果，励学XX有更好的学习效果 查看 ›"（跳选课页，默认选中录取班型）；④ 诊断未通过→"暂无推荐班型，建议您查看个辅相关课程"（跳个辅咨询列表）；⑤ 无分层结果→直接展示诊断入口
- 授课老师：老师头像列表（按角色排序：指导/辅导），最多展示 1 授课 + 1 辅导老师（按排课讲次数最多取，相同则取前面讲次），点击跳老师详情子页
- 服务大纲：适合对象 + 培养目标 + 课时列表（展示前3条 + "查看全部"）；已上完课的讲次大纲置灰
- 课程服务：根据班级对应"课程类型"展示课程服务内容（2026-07-26 修订：本期隐藏，9月版本不实现）
- 学员评价：展示前1条评价（头像+姓名+星级+标签+内容），点击"全部评价"进入评价列表子页（2026-07-26 修订：本期隐藏，9月版本不实现）
- 服务详情：富文本图片数组展示；空时显示默认占位图
- 底部 Footer（吸底）：客服图标 + 主操作按钮（加购/关注/诊断等）+ 顾问入口
2026-07-26 修订：学员评价、课程服务两个区块本期隐藏（9月版本不实现，后续版本再放开）；文中相关数据规则/异常兜底/评价列表子页描述保留作为后续版本依据。「查看同类班级」（同主体相似课程推荐）确认保留，规则不变。
1.1 数据规则
| 维度 | 说明 |
|---|---|
| 来源 | 班级详情主接口 getClassDetail(classId) + 实时数据 getClassData(classId) |
| 头部媒体 | getCourseIntroMedia 接口返回 image + video 混合列表，支持轮播 |
| 价格逻辑 | 折扣期走 discountPrice；否则 actualPrice（已开课/未开课不同）+ classMaterialFee |
| 分段缴费 | getClassPaySegment 接口返回段次数组（段名/起止日/价格），学习资料费注入第1段 |
| 老师列表 | getTeacher 接口返回，按 teacherRoleId 升序排列 |
| 大纲数据 | getLecture 接口（EES 系统），返回适合对象/培养目标/课时列表 |
| 副标题 | 后台配置的课程副标题，展示在班级名下方 |
| 优惠标签 | getDiscountTagInfo 接口返回当前班级可用优惠标签列表 |
| 课程服务 | 按 classType 返回对应课程服务内容 |
| 评价数据 | getCommentList 接口，按星级降序→同星级按更新时间降序；匿名→默认头像+"卓越学员"；非匿名→学员头像+姓名 |
| 购物车角标 | getCartQuantity 接口实时获取商品数量，>0 显示红点 |
| 刷新时机 | 每次进入页面（onShow）重新请求班级详情 + 实时数据 |
1.1 状态说明
| 状态 | 表现 |
|---|---|
| 已登录有数据 | 完整展示所有区块，底部主按钮根据状态机显示对应文案 |
| 未登录 | 详情正常浏览（不需登录），点加购时拦截跳登录页 |
| 折扣期 | 显示折扣倒计时区（折扣价+原价+倒计时）；小于48小时→"x时x分x秒"；大于48小时→"x天x时x分x秒"；开课后不再享有网报价；倒计时结束自动刷新恢复原价。开课后不显示优惠信息（展示层规则，2026-07-28 测试评审确认；折扣仅为展示用途，实际支付以用户真实可享优惠策略为准，开课后是否允许享受优惠由 TMS 后台配置） |
| 预售未开始 | 底部显示预售倒计时，主按钮文案"加入购物车"（实际为预约）。展示格式：>2天→"01.25 09:30开抢"；<2天→"即将开始，01.25 09:30开抢"；当天未到时→"即将开始，今日 09:30开抢"；提前2小时→倒计时"距开抢剩 HH:MM:SS"。已到开售时间则不展示 |
| 已下架 | 整个 footer 替换为"服务已经下架啦~要不要瞧瞧别的~"提示文案 |
| 名额已满 | 主按钮变为"关注名额"，已关注后变"已关注"（灰色禁用） |
| 报名热度 | 价格区旁展示热度标签：剩余名额 > 5 → "热报中"（红色）；剩余名额 1~5 → "剩N名额"（橙色）；名额=0 → "已满班"（灰色）（2026-07-26 确认，与选课页班次卡片口径一致；2026-07-28 测试评审确认：=0 档文案统一为"已满班"） |
新旧生折后价为旧有行为（2026-07-30 测试沟通 15.2，非本次改动）：旧生时间未到时，前端有其他诊断逻辑提前拦截，未走新旧生折后价判断；何龙确认需前端查看交互，周秋团介入确认为旧有行为。
1.1 交互规则
| 操作 | 响应 |
|---|---|
| 滑动/点击 Tab | 点击Tab自动滚动到对应区域；滚动到对应区域Tab自动高亮 |
| 点击"分段缴费 ▼" | 弹出分段缴费弹窗（模块1.3） |
| 点击优惠标签 | 弹出优惠详情弹窗（模块1.4） |
| 点击老师头像/名字 | 跳转老师详情子页（模块1.6） |
| 点击"查看全部"大纲 | 跳转服务大纲子页（模块1.5） |
| 点击分享按钮 | 触发 onShareAppMessage 分享小程序卡片（title=班级名，path 携带 classId）；分享无需登录（2026-07-26 确认） |
| 点击"查看同类班级" | 跳转同课程班级列表，带入当前课程、城市、年级和班级，当前班级置顶；候选与排序口径见 WB-REC-001 |
| 点击主按钮（加购） | 按状态机决策（详见模块1.2），成功后飞入动画 + toast"选择服务成功" |
| 点击客服图标 | 跳转企微/在线客服 IM 页面 |
| 点击顾问入口 | 跳转顾问详情页（复用首页顾问规则） |
| 点击购物车角标 | 跳转购物车页面 |
1.1 异常与兜底
| 场景 | 处理 |
|---|---|
| 班级详情接口失败 | 显示骨架图，提供重试按钮 |
| 头部媒体缺省 | 有视频+图片：列表页展示视频，详情页视频+图片；仅有视频或图片：列表页+详情页都展示；都没有：详情页展示缺省图，列表页不展示 |
| 老师列表为空 | 隐藏"授课老师"区块 |
| 大纲数据为空 | 显示讲次序号，不显示具体内容 |
| 富文本详情为空 | 显示默认占位图 |
| 购物车角标接口失败 | 不显示角标数（静默降级） |
| 服务降级 | 评价/优惠/详情 3 个区块可通过 moduleCode 独立隐藏 |
| 老师头像兜底 | 遵循 01 §4.4 三档规则：未排老师 → 不显示（老师列表不展示该老师条目，与左侧「老师列表为空隐藏区块」一致）；已排老师未上传头像 → 按性别显示默认头像；已上传 → 显示上传头像。细化口径：无性别/兼职 → 品牌头像；兼职老师名显示"卓越老师"且不可点击 |
| 评价数据为空 | 隐藏"学员评价"区块 |
| 抢报倒计时服务降级 | 使用客户端本地时间兜底计算 |
1.1 配置项清单
| 配置项 | 维度 | 说明 |
|---|---|---|
| 头部媒体 | 课程 | 后台配置图片/视频列表，支持混合轮播 |
| 班级类型标签 | 班级 | 在线/线下/双师/AI，后台字段 classType 决定 |
| 分段缴费 | 班级 | 后台配置段次（2 种来源：产品分段 / 分校（顾问）分段） |
| 优惠标签 | 课程 | 后台配置折扣规则，接口返回可用标签 |
| 服务降级开关 | 全局 | class_comment / class_discount / class_course_detail 三个 moduleCode |
| 预售/抢报时间 | 班级 | 后台配置开售时间，前端根据服务端时间计算倒计时 |
| 副标题 | 课程 | 后台配置课程副标题，展示在班级名下方 |
| 课程服务 | 班级 | 按 classType 返回对应课程服务内容 |
| 顾问入口 | 城市 | 企微链接由后台配置（复用首页顾问规则） |
1.1 补充设计稿：配置化 Tab 与限时价倒计时（2026-08-05 批）
界面说明
- 配置化 Tab：主页「服务 / 指导 / 大纲 / 详情」Tab 按后台配置显示对应内容区块，配置后滑动显示对应 tab（对应 1.1 界面结构 li 3；设计稿：配置后滑动显示对应tab）
- 限时价倒计时样式：折扣期价格区展示限时价 + 倒计时样式（对应 1.1 状态说明「折扣期」行：<48 小时→"x时x分x秒"，>48 小时→"x天x时x分x秒"）
来源：2026-08-04 批设计稿（网报3.0升级设计稿-20260804）。图示为既有规则的视觉依据，无规则变更。
1.1 切换学员入口（2026-08-05 批设计稿新增）
界面结构
- 切换学员入口：底部 footer 区新增「切换学员」入口（显示当前学员名），入口显示受「根据配置显示内容」控制
- 切换学员弹层：点击入口弹出学员选择列表（当前绑定学员列表，同 02 我的学员）
交互规则
| 操作 | 响应 |
|---|---|
| 点击切换学员 | 弹出学员选择弹层，选择后切换当前学员 |
| 切换后 | 页面按新学员的诊断结果 / 年级 / 新旧生状态重新执行按钮状态机（§1.2）与诊断提示（§1.1 li 9）判断 |
来源：2026-08-04 批设计稿新增能力；旧版 portal-vue 源码无此功能（源码 grep 无「切换学员」）。详细规则（入口显示配置项 / 弹层字段 / 切换后刷新范围）待评审确认，见待确认清单。
二、底部按钮状态机 8+种状态
1.2 主按钮状态映射
1.2 界面结构
底部 Footer 固定吸底，从左到右依次为：客服图标 → 主操作按钮（占满剩余宽度）→ 顾问图标。主按钮根据以下状态机展示不同文案和交互行为。
1.2 数据规则（状态映射表）
| 优先级 | 判断条件 | 按钮文案 | 可点击 | 动作 |
|---|---|---|---|---|
| 1a | 班级已下架（classDisabled / classOffShelf） | —（整个footer替换为"服务已经下架啦~要不要瞧瞧别的~"） | 否 | 无 |
| 1b | 班级已作废（classInvalid） | —（整个footer替换为"服务已经作废啦~要不要瞧瞧别的~"） | 否 | 无 |
| 2 | 名额=0 且已登录 | "关注名额" / 已关注则"已关注" | 是/灰禁 | 调用 setAttention 接口 |
| 3 | 需咨询登记（classCanNetReg=2）且可登记 | "咨询登记" | 是 | 调用 addRecordConsult 接口 |
| 4 | 已登记 | "已登记" | 否（灰禁） | 无 |
| 5 | 未登录 且需咨询登记 | "咨询登记" | 是 | 先跳登录，登录后返回继续 |
| 6 | 需诊断（未登录或无学员或 examStatus=2） | "诊断后选择服务" | 是 | 跳转 TES 诊断系统 |
| 7 | 预售未到开售时间 | "加入购物车"（实际为预约） | 是 | 执行加购流程 |
| 8 | 其他默认（正常可购买） | "加入购物车" | 是 | 执行加购流程（onJoinCart） |
判断按优先级从高到低执行，命中即停止。防重复提交：加购/咨询登记/诊断三个按钮需 disabled + Loading 状态锁。
1.2 状态说明（加购错误码）
| 错误码 | 含义 | 处理方式 |
|---|---|---|
| 200 | 加购成功 | 飞入动画 + toast"选择服务成功" + 刷新购物车角标 |
| 5001 | 同班型/时段冲突（可替换） | 弹课程冲突替换弹窗，确认后删除原班级再加购新班级 |
| 5002 | 课程冲突（不可替换） | 弹冲突展示弹窗，仅告知不可操作 |
| 5003 | 时间冲突 | toast 提示冲突信息 |
| 5004 | 学位不足 | toast 提示学位信息 |
| 5005 | 年级不匹配 | toast 提示年级要求 |
| 其他 | 通用错误 | toast 接口返回的错误消息 |
1.2 交互规则
| 操作 | 响应 |
|---|---|
| 未登录点加购 | 拦截跳转登录页，登录后自动返回当前详情页 |
| 已登录无学员点加购 | 跳转添加学员页（02-登录与学员管理） |
| 面授已开课插班加购 | 不弹窗，直接加购剩余讲次，价格展示剩余讲次学费（不需要删除线展示原价） |
| 在线课已开课插班加购（classOpenedNeedFullFee=false） | 弹选段/续报弹窗（"全报"→全部讲次+学费原价 / "续报"→剩余讲次+剩余价），选后执行加购 |
| 已结课班级点加购 | toast"抱歉，该班级结课了，请看看其他班级" |
| 加购成功 | 飞入购物车动画 + 刷新角标 + 神策埋点 AddToOrderList |
1.2 异常与兜底
| 场景 | 处理 |
|---|---|
| 加购接口超时 | 解除 Loading 锁，toast"网络异常，请重试" |
| 冲突替换确认后失败 | toast 错误信息，保持原购物车状态不变 |
| 关注名额接口失败 | Toast 提示（后端下发 message，前端不硬编码文案） |
| 咨询登记接口失败 | Toast 提示（后端下发 message，前端不硬编码文案） |
1.2 配置项清单
| 配置项 | 说明 |
|---|---|
| classCanNetReg | 后台配置，=2 时走咨询登记分支而非直接加购 |
| classIsNoTestForNew | 后台配置，=true 时新生免诊断直接加购 |
| classOpenedNeedFullFee | TMS"开课后是否收全额"配置：=true 时已开课也需全费（不弹续报选择，加购全部讲次+学费原价）；=false 时弹选段/续报弹窗（全报/续报） |
| 预售开售时间 | 后台配置 negRegDate，前端根据服务端时间差计算倒计时 |
| 网报报名截止时间 | TMS 存在网报报名截止时间配置项（2026-07-31 测试沟通 15.6，张鑫发现、吴源华确认）；对应加购校验文案「已超过报名截止时间」（详见 07-购物车） |
1.2 预售 4 态设计稿（2026-08-05 批）
.png)
1
2
3
4
预售状态 ↔ 设计稿对照
| 时间档 | 展示格式（既有规则） | 设计稿 |
|---|---|---|
| 1>2 天 | "01.25 09:30开抢" | 预选课＞2天允许先做诊断（2026-08-05 用户裁定，原待确认清单 5-① 已闭环） |
| 2<2 天 | "即将开始，01.25 09:30开抢" | 预选课＜2天 |
| 3当天未到时 | "即将开始，今日 09:30开抢" | 预选课 当天 |
| 4提前 2 小时 | 倒计时"距开抢剩 HH:MM:SS" | 预选课 前2h |
来源：2026-08-04 批设计稿；展示格式规则沿用 1.1 状态说明「预售未开始」行（旧版源码 judgeFormat 行为），设计稿为 4 档格式的视觉依据。
1.2 下架 / 满班 / 加购提示设计稿（2026-08-05 批）
状态 ↔ 设计稿对照
| 状态 | 对应规则 | 设计稿 |
|---|---|---|
| 已下架 | 1.2 状态映射 1a：footer 替换为"服务已经下架啦~要不要瞧瞧别的~" | 课程详情-下架 |
| 名额已满 | 1.2 状态映射 2：主按钮"关注名额" / 已关注后"已关注"（灰禁） | 课程详情-满班 |
| 重复加购 / 已结课 | 1.2 交互规则：已结课点加购 toast"抱歉，该班级结课了，请看看其他班级"；重复加购等提示 | 课程详情-重复加购／已结课等提示 |
2026-08-04 测试沟通（15.7）口径待确认：李湘截图对比发现课程下架后小程序主按钮无变化，与 H5 行为一致。与状态映射 1a「整个 footer 替换为下架提示文案」（旧版源码 classDetails.vue：classDisabled / classOffShelf 行为）存在解读差异——「无变化」指主按钮维持原样，还是与 H5 下架提示样式一致无差异，待确认后修订（见待确认清单）。
三、分段缴费弹窗 底部半屏
1.3 分段缴费明细
1.3 界面结构
- 适用范围：本弹窗仅适用于产品分段（课程分段）；分校（顾问）分段不在课程详情展示，只在购物车展示，详见 09 §一 展示位置
- 弹窗标题："缴费明细" + 右上角关闭 ✕
- 段次列表：每段一行，仅显示段名 + 缴费金额（不显示起止日期，不显示起止讲次）；段名统一按「学期 + 段序号」拼接（如"春季1段""春季2段"）
- 第1段特殊：包含学习资料费（classMaterialFee），单独标注
- 合计区：底部显示总金额
1.3 数据规则
| 维度 | 说明 |
|---|---|
| 来源 | getClassPaySegment 接口返回 classPaySegments 数组 |
| 字段 | 每段包含：segmentName（段名）、startDate（起始日）、endDate（截止日）、payPrice（缴费价格）；其中 startDate / endDate 不在 C 端展示 |
| 资料费注入 | 第1段的 payPrice 自动加上 classMaterialFee（首段已过期时的归段规则见 09 §五） |
| 段次来源 | 2 种：产品分段（课程后台配置）/ 分校（顾问）分段（TMS 按城市分校配置） |
| 展示条件 | classPaySegments 数组非空时才显示"分段缴费 ▼"入口按钮 |
分段收费完整规则（段名口径 / 段次状态机 / 两种分段对照 / 资料费归段）详见 09-分段收费（该文档为分段收费唯一权威源），本节仅保留弹窗界面结构与取数字段。
1.3 状态说明
| 状态 | 表现 |
|---|---|
| 有分段数据 | 主页价格区显示"分段缴费 ▼"按钮，点击弹此弹窗 |
| 无分段数据 | "分段缴费 ▼"按钮不展示，价格区仅显示总价 |
1.3 交互规则
| 操作 | 响应 |
|---|---|
| 点击"分段缴费 ▼" | 从底部弹出半屏弹窗展示明细 |
| 点击 ✕ / 蒙层 | 关闭弹窗 |
此弹窗仅供用户查看信息，不提供操作按钮（不可选择段次）。段次选择在购物车/确认订单环节完成。
1.3 配置项清单
| 配置项 | 说明 |
|---|---|
| 分段缴费段次 | 后台配置（支持产品分段 + 顾问手动分段两种来源） |
| 学习资料费 | 后台配置 classMaterialFee，自动合入第1段显示 |
四、弹窗组（优惠详情 + 课程冲突替换） 3个弹窗
1.4 优惠详情弹窗 + 选段/续报弹窗 + 课程冲突替换弹窗
1.4 界面结构
A. 优惠详情弹窗
- 触发：点击主页"优惠标签"区域
- 内容：列出当前班级可享受的所有优惠规则（courseDiscountTags 详情）
- 底部：若有多科联报优惠，显示"多科联报 ›"跳转入口
B. 选段/续报弹窗
- 触发：在线课程且已开课且非全费要求时，点加购按钮触发
- 内容：展示"全报"vs"续报"选项对比（课次数/价格）
- 操作："全报"→ 加购全部段次；"续报"→ 加购剩余段次
C. 课程冲突替换弹窗
- 触发：加购接口返回错误码 5001 或 5002
- 内容：新班级 vs 原冲突班级的对比卡片（老师/地点/时间）
- 5001（可替换）：底部显示"确认替换"按钮，确认后删除原班级 + 加购新班级
- 5002（不可替换）：仅展示冲突信息，无操作按钮
1.4 数据规则
| 弹窗 | 数据来源 | 关键字段 |
|---|---|---|
| 优惠详情 | getDiscountTagInfo 接口 | 优惠类型/折扣金额/适用条件/有效期 |
| 选段/续报 | classNum / classPrice / classLeftNum / classLeftPrice | 全报总课次&总价 vs 续报剩余课次&剩余价 |
| 课程冲突 | 加购接口 response.data | 新班级信息 + 冲突原班级信息（老师/地点/时间） |
1.4 交互规则
| 操作 | 响应 |
|---|---|
| 优惠弹窗 - 点"多科联报" | 跳转多科联报页面（展示同时段多科优惠组合） |
| 选段弹窗 - 选"全报" | 执行加购（isFull=true） |
| 选段弹窗 - 选"续报" | 执行加购（isFull=false，只购买剩余段次） |
| 冲突弹窗 - 确认替换（5001） | 先调 deleteItem 删除原班级，再调 addItem 加购新班级 |
| 冲突弹窗 - 关闭（5002） | 关闭弹窗，不做任何操作 |
| 所有弹窗 - 点蒙层/✕ | 关闭弹窗 |
1.4 异常与兜底
| 场景 | 处理 |
|---|---|
| 冲突替换 - 删除原班级失败 | toast 错误信息，不执行后续加购，弹窗保持 |
| 冲突替换 - 删除成功但加购新班级失败 | toast 错误信息（后端下发 message）；需向用户传达原班级已移除的状态（具体文案以后端下发为准） |
| 优惠标签接口失败 | 隐藏优惠标签区域，不影响页面主体功能 |
1.4 配置项清单
| 配置项 | 说明 |
|---|---|
| 优惠规则 | 后台配置，接口返回 courseDiscountTags |
| 多科联报 | 后台配置科目组合优惠，前端通过优惠弹窗入口跳转 |
| classOpenedNeedFullFee | =true 时不弹选段弹窗，直接全费加购 |
1.4 优惠详情页设计稿（2026-08-05 批）
界面说明
- 对应 1.4「A. 优惠详情弹窗」规则：列出当前班级可享受的所有优惠规则（courseDiscountTags 详情）
- 设计稿呈现优惠详情完整页/弹层样式：优惠类型、折扣金额、适用条件、有效期逐项展示
- 底部若有多科联报优惠，显示"多科联报 ›"跳转入口
来源：2026-08-04 批设计稿；规则无变更，本图为此前的视觉空缺补充。
1.4 在线课选段/续报弹窗设计稿（2026-08-05 批）
.png)
界面说明
- 对应 1.4「B. 选段/续报弹窗」规则：在线课程且已开课且 classOpenedNeedFullFee=false 时，点加购触发
- 设计稿呈现"全报" vs "续报"选项对比（课次数 / 价格）两种状态
- "全报"→ 加购全部段次（isFull=true）；"续报"→ 加购剩余段次（isFull=false，剩余价）
来源：2026-08-04 批设计稿；规则沿用旧版源码选段/续报弹窗行为（底料 05-class-detail §4.1），无变更。
1.4 冲突弹窗组设计稿（2026-08-05 批）
界面说明
- 对应 1.4「C. 课程冲突替换弹窗」规则：加购接口返回 5001（可替换）/ 5002（不可替换）时触发
- 与已购课程冲突弹窗：新班级与已购冲突班级的对比展示
- 加购冲突弹窗（多个滑动）：存在多个冲突班级时，冲突卡片支持横向滑动查看
- 立即报名按钮-冲突弹窗：从「立即报名」入口触发加购时的冲突弹窗样式（「立即报名」入口是否为本期新增按钮态待确认，见待确认清单）
来源：2026-08-04 批设计稿；5001/5002 冲突规则沿用旧版源码行为（底料 05-class-detail §4.1），无变更。
五、服务大纲子页 EES数据
1.5 服务大纲完整展示
1.5 界面结构
- 顶部导航：返回 ← + 标题"服务大纲"
- 适合对象：文本描述目标学员画像
- 培养目标：文本描述课程培养方向
- 大纲列表：完整课时列表（FoldPage 折叠组件），每条包含章节号 / 标题 / 知识点，支持展开/收起
1.5 数据规则
| 维度 | 说明 |
|---|---|
| 来源 | getLecture(classId) 接口（EES 系统） |
| 字段 | syllabusObj：适合对象(suitableFor) / 培养目标(target) / 课时列表(lectures[]) |
| 与主页区别 | 主页仅展示前3条 + "查看全部"；此子页展示全量课时列表 |
| 数据共享 | 与主页使用同一接口同一数据源，子页进入时不重复请求（从缓存取） |
1.5 交互规则
| 操作 | 响应 |
|---|---|
| 点击课时标题 | 展开/收起该课时的知识点详情（FoldPage 折叠动画） |
| 点击返回 | 返回课程详情主页 |
1.5 异常与兜底
| 场景 | 处理 |
|---|---|
| 大纲数据为空 | 不应进入此页面（主页无"查看全部"入口时不可达） |
| 接口失败 | 展示加载失败占位 + 重试按钮（占位文案以后端/设计确认为准） |
1.5 配置项清单
| 配置项 | 说明 |
|---|---|
| outlineDisplayType | 网报后台字段，控制课程大纲显示：0=隐藏 / 1=显示（2026-08-04 测试沟通 15.7，吴源华发现并抓包确认 API 返回数据） |
2026-08-04 测试沟通（15.7）登记：① 周秋团表示将隐藏课程详情页下面的箭头（具体所指箭头位置——大纲展开箭头或页面底部其他箭头——待确认）；② 李湘反馈页面跳转有问题（8/4 11:25），需找人查看（问题单跟进，未闭环）。
设计稿「课程大纲-部分可报名」呈现大纲讲次附带报名状态标识的样式，讲次级报名状态的具体规则（哪些讲次可报名/置灰口径）待评审确认。
— 大纲数据来源为 EES 系统（getLecture），前端无其他独立配置项。
六、老师详情子页 教师信息
1.6 老师详情展示
.png)
1.6 界面结构
- 顶部 Banner：教师大图（背景图）
- 教师信息卡：姓名 + 头衔（如"李文 / 小学数学授课老师"）
- 标签胶囊：学历 / 专业 / 教学风格标签（如：本科 / 光电信息科学 / 严肃活泼 / 认真负责）
- 简介：富文本教师简介
- 评价概况：评价分数 + 学员好评摘要（2026-07-26 修订：本期隐藏，9月版本不实现）
- 名下班级列表：该教师负责的班级列表（可点击跳转对应班级详情）
2026-07-26 修订：老师详情子页本期仅展示老师介绍相关内容（Banner/信息卡/标签/简介/名下班级），评价概况与评价列表区块隐藏（9月版本不实现）。
设计稿说明（2026-08-05 批）：左图即快照分享设计稿中的指导员详情页（老师详情与指导员详情同构：Banner / 信息卡 / 标签 / 简介 / 名下班级）；「无照片-男 / 无照片-女」对应下方异常与兜底「头像未维护→按性别显示默认头像」规则的视觉依据。
老师详情原生改造：图「点击联想推荐-进入老师详情.png」为 3.0 设计稿老师详情原生页「介绍」tab（老师信息 + 标签 + 老师课程列表，课程卡片含校区/日期段次/剩余名额/指导价）。排期依据：20260917网报三期功能梳理.xlsx 二期计划表「指导员详情：个人信息 / 介绍 / 评价 / 脱敏（头像-姓名）/ 课程」（P1）——与用户口径一致（二期）。评价区块按本页 2026-07-26 修订隐藏；脱敏规则见下方数据规则。
1.6 数据规则
| 维度 | 说明 |
|---|---|
| 来源 | getTeacherDetail(teacherId) + getCommentSummary + getClasses |
| 入参 | teacherId + madId（路由 query 传入） |
| 评价列表 | teacherDetails.getList(teacherId) 分页获取 |
| 名下班级 | teacherDetails.getClasses(teacherId, ...) 获取教师负责班级 |
1.6 交互规则
| 操作 | 响应 |
|---|---|
| 点击名下班级 | 跳转该班级的课程详情页 |
| 点击分享 | 触发 onShareAppMessage 分享给微信好友；分享无需登录（2026-07-26 确认） |
| 点击返回 | 返回课程详情主页 |
分享参数：title="姓名 - 学科授课老师"，path 携带 teacherId + shareUserId（用于归因统计）。
1.6 异常与兜底
| 场景 | 处理 |
|---|---|
| 教师详情接口失败 | 展示"加载失败"占位 + 重试按钮 |
| 教师无评价数据 | 隐藏评价概况区块 |
| 教师无名下班级 | 隐藏名下班级列表区块 |
| 头像加载失败/未维护 | 按性别显示默认头像；无性别/兼职老师→品牌头像 |
| 兼职老师 | 姓名统一显示"卓越老师"，不可点击进入详情页（在 m1 老师区块处理）；待排老师不显示（m1 老师列表不展示该老师条目） |
1.6 配置项清单
| 配置项 | 说明 |
|---|---|
| 教师信息 | 后台维护，接口返回全量字段 |
| 分享图片 | 使用教师头像作为分享卡片封面 |
七、骨架图（加载态） 首次加载
1.7 骨架图
1.7 界面结构
- 头部区：大面积矩形占位（模拟 Banner 区域）
- Tab 区：4个圆角矩形占位条
- 信息区：标签占位 + 标题占位条 + 多行短条占位
- 价格区：短条占位（模拟价格数字）
- 老师区：圆形占位 + 右侧短条
- 底部：按钮占位条
1.7 触发场景
| 场景 | 表现 |
|---|---|
| 首次进入详情页 | 展示完整骨架图，班级详情接口返回后替换为实际内容 |
| 网络极慢（>3s） | 骨架图持续展示，不做超时中断 |
1.7 配置项清单
— 前端固定实现，无后台配置。骨架图为纯 CSS 动画占位。
八、数据流程图 Mermaid
1.8 加购主流程（详情页 → 校验 → 加入购物车）
flowchart TD
Start[用户在详情页点主按钮] --> Btn{按钮状态机决策}
Btn -- 已下架/已作废 --> Disabled[禁用态 footer替换为提示文案]
Btn -- 关注名额 --> Att[调用关注接口]
Btn -- 咨询登记 --> Reg[调用咨询登记接口]
Btn -- 诊断后选择 --> Diag[跳转TES诊断系统]
Btn -- 加入购物车 --> CheckLogin{已登录?}
CheckLogin -- 否 --> Login[跳转登录页]
Login --> CheckLogin
CheckLogin -- 是 --> CheckChild{已绑学员?}
CheckChild -- 否 --> AddStu[跳转添加学员页]
AddStu --> CheckChild
CheckChild -- 是 --> CheckEnded{已结课?}
CheckEnded -- 是 --> ToastEnded[toast已结课请看其他]
CheckEnded -- 否 --> CheckExam{诊断状态}
CheckExam -- 未诊断 --> Diag
CheckExam -- 无需/达标 --> CheckOnline{在线课且已开课?}
CheckOnline -- 否 --> AddItem[调用加购接口]
CheckOnline -- 是 --> CheckFull{需全费?}
CheckFull -- 是 --> AddItem
CheckFull -- 否 --> ChooseType[弹选段/续报弹窗]
ChooseType --> AddItem
AddItem --> Resp{响应码}
Resp -- 200成功 --> Success[飞入动画+toast成功+刷新角标]
Resp -- 5001可替换 --> Replace[弹课程冲突替换弹窗]
Replace -- 确认替换 --> Delete[删除原班级]
Delete --> AddItem
Resp -- 5002不可替换 --> Conflict[弹冲突展示仅查看]
Resp -- 其他错误 --> ToastErr[toast错误消息]
九、修订记录（V2.0 / 2026-08-06）
| 修订项 | 修订内容 | 期数 | 依据来源 | 日期 |
|---|---|---|---|---|
| 流程注清理 | 删除「原待确认清单 N 已闭环」「用户裁定归属/承载/迁入」等闭环与归属性流程注，保留裁定结果内容与来源依据注 | 二期 | 用户裁定 2026-08-06 | 2026-08-06 |
| 红框标注校准 | 按 PIL 图像测量 + 读图目检校准 18 处部件级红框位置：修正弹窗/toast/列表区域框错位，叠加弹窗图（输错 1/2）改框整组弹窗区，同页面不同状态截图确认沿用同参数 | 二期 | PIL 测量校准 2026-08-05 | 2026-08-05 |
| §1.2 预售 4 态图序号标注 | 预售 4 态图新增序号徽标（1＞2天/2＜2天/3当天/4前2h），右栏「时间档」列同步加 step-tag 序号对应（依 05 §3.2 用户裁定模式推广） | 二期 | 用户裁定 2026-08-05 | 2026-08-05 |
| 图组布局规则统一 | 依 00 V1.10 新布局规则：同层级多图（同图不同状态/图+弹窗/同流程步骤）一律横排，每张统一 280px 宽（uniform），容器横向滚动查看（细滚动条常显 + 右侧渐变提示防漏看）；本页 10 个图组统一改造（其中 2 组竖排改横排），half/third 混宽与多图竖排旧规则废止 | 二期 | 用户裁定 2026-08-05 | 2026-08-05 |
| 异常兜底事实核查清理 | portal-vue 源码 grep 验证：§1.2 关注/咨询登记、§1.4 冲突替换、§1.5 大纲接口失败的杜撰文案（操作失败请重试/登记失败请重试/原班级已移除请重新加购/加载失败请重试）改通用表述「后端下发 message」，行为与场景保留；加购超时「网络异常，请重试」对齐 01 §6.1 不动；骨架图/媒体缺省/moduleCode 降级等源码梳理项不动 | 二期 | portal-vue 源码核查 2026-08-05 | 2026-08-05 |
| 业务规则库接入 | 课程/班级状态引用 WB-COURSE-001，加购与冲突引用 WB-CART-001，同类班级推荐引用 WB-REC-001，分段引用 WB-SEGMENT-001 | 跨期 | 业务规则库首批提取 | 2026-08-05 |
| 待裁定回写 | ① 预售对照表「预选课＞2天」裁定为允许先做诊断（原待确认清单 5-① 闭环）；② §1.6 登记老师详情原生改造：新增图「点击联想推荐-进入老师详情.png」（介绍 tab：老师信息+标签+老师课程列表），排期依据 excel 二期计划表「指导员详情 5 行（个人信息/介绍/评价/脱敏/课程）P1」，与用户口径一致（原待确认清单 9 闭环） | 二期 | 用户裁定 2026-08-05 + excel二期计划表 + 网报3.0升级设计稿-20260804 | 2026-08-05 |
| 学员评价隐藏 | 课程详情页学员评价区块及评价列表子页本期隐藏（9月版本不实现），相关规则保留作后续版本依据 | 一期 | 改动汇总 + 2026-07-26确认 | 2026-07-26 |
| 课程服务隐藏 | 课程服务区块本期隐藏（9月版本不实现） | 一期 | 改动汇总 + 2026-07-26确认 | 2026-07-26 |
| 老师详情子页 | 本期仅展示老师介绍相关内容，评价概况与评价列表隐藏 | 一期 | 改动汇总 + 2026-07-26确认 | 2026-07-26 |
| 分享免登录 | 课程详情页与老师详情子页分享无需登录 | 三期 | 改动汇总 + 2026-07-26确认 | 2026-07-26 |
| 分享条目收敛 | 分享统一归属三期：上行「分享免登录」条目承载页移至 三期/12-分享（分享快照/兜底/H5 分享规则统一见该页；本行保留作登记） | 三期 | 2026-08-04 口径确认 | 2026-08-04 |
| 学位展示规则 | 剩余名额>5显示"热报中"，≤5显示"剩N名额"，=0显示"已满"，与选课页口径一致 | 二期 | 2026-07-26确认 | 2026-07-26 |
| 同主体相似课程推荐 | 「查看同类班级」入口及排序规则确认保留，不变更 | 一期 | 2026-07-26 确认 | 2026-07-26 |
| 开课后优惠展示 | 补充展示层规则：开课后不显示优惠信息；折扣仅为展示用途，实际支付以真实可享优惠策略为准，开课后是否允许享受优惠由 TMS 后台配置（§1 状态说明） | 一期 | 2026-07-28 测试评审会 | 2026-07-28 |
| 分段段名口径 | 分段缴费明细段名统一按「学期 + 段序号」展示（如"春季1段""春季2段"），原示例"寒假段"作废（§1.3） | 二期 | 语雀《分段收费》2026-07-30 | 2026-07-30 |
| 分段规则收敛至 09 | 分段收费独立成模块 09-分段收费 作为唯一权威源；本文档 §1.3 仅保留弹窗界面结构与取数字段，业务规则改为引用；段次行改为仅展示段名 + 缴费金额，删除"起止日期"展示（依据语雀贴图核对，startDate / endDate 保留为接口字段但不在 C 端展示） | 二期 | 语雀《分段收费》2026-07-30 | 2026-07-30 |
| 分段缴费明细适用范围 | §1.3 新增"适用范围"说明：本弹窗仅适用于产品分段（课程分段），分校（顾问）分段不在课程详情展示、只在购物车展示（§1.3 界面结构） | 二期 | 业务批注 2026-07-30 | 2026-07-30 |
| 矛盾检查修订 | 全量矛盾检查修复：段次来源收敛为 2 种「产品分段 / 分校（顾问）分段」（§1.2/§1.3）；「预约购课」统一为「加入购物车（实际为预约）」（§1.2）；09 引用去锚点改指整页（唯一权威源）；「顾问分段（手工分段）」叫法统一为「分校（顾问）分段」（2 处） | 二期 | 全量矛盾检查 | 2026-07-30 |
| 大纲与头像兜底口径 | 大纲数据为空处理由「隐藏"服务大纲"区块」改为「显示讲次序号，不显示具体内容」（§1.1）；待排老师口径统一为「不显示」（老师列表不展示该老师条目），老师详情子页头像兜底同步去掉「待排老师」场景（§1.1/§1.6） | 一期 | 业务批注 | 2026-07-30 |
| 2026-08-04 批设计稿合入 | 合入设计稿 21 张：§1.1 新增配置化 Tab / 限时价倒计时 / 切换学员入口（设计稿新增能力，旧版源码无，详细规则待评审）；§1.2 新增预售 4 态 / 下架 / 满班 / 重复加购提示设计稿；§1.3 分段弹窗新图并排；§1.4 弹窗组占位替换为真实设计稿 8 张（优惠 2 / 在线课选段续报 2 / 冲突组 3 / 优惠详情 1）；§1.5 大纲占位替换为 2 图；§1.6 老师详情占位替换为指导员详情 4 图（含无照片男/女头像兜底）；§1.7 骨架图换新版（?v=20260805） | 二期 | 网报3.0升级设计稿-20260804 | 2026-08-05 |
| 大纲 outlineDisplayType 配置 | §1.5 配置项新增：网报后台字段 outlineDisplayType 控制大纲显示（0=隐藏 / 1=显示），抓包确认 API 返回；同步登记「课程详情页下面的箭头将隐藏」（具体箭头位置待确认）与李湘反馈的页面跳转问题（未闭环） | 二期 | 企微讨论记录 15.7（2026-08-04） | 2026-08-05 |
| TMS 网报报名截止时间配置 | §1.2 配置项新增：TMS 存在网报报名截止时间配置项，对应加购校验文案「已超过报名截止时间」 | 二期 | 企微讨论记录 15.6（2026-07-31） | 2026-08-05 |
| 新旧生折后价注记 | §1.1 状态说明补充：新旧生折后价逻辑为旧有行为（非本次改动）；旧生时间未到时前端有其他诊断逻辑提前拦截 | 二期 | 企微讨论记录 15.2（2026-07-30） | 2026-08-05 |
| 老师头像显示规则对齐 | §1.1「老师头像兜底」按 01 §4.4 全局三档口径改写：未排老师不显示（不占位）/ 已排未上传按性别默认 / 已上传显示上传头像；保留无性别与兼职→品牌头像、兼职显示"卓越老师"不可点击等细化口径并标注与 01 关系 | 二期 | 用户口径澄清（2026-08-05） | 2026-08-05 |