前置说明 全局
0.1 双小程序架构
详见 01-全局通用规则.html §1.2 小程序矩阵。
| 终端 | 名称 | 默认城市 | 城市切换 | 说明 |
|---|---|---|---|---|
| 小程序 1 | 卓越悦学 | 广州 | 可切换（按配置） | 主力小程序，覆盖广州及其他城市 |
| 小程序 2 | 卓越优学 | 深圳 | 不可切换（锁定深圳） | 深圳专属，因资金监管要求独立 |
两个小程序共享同一套后端服务和用户体系，仅 openID 不同，基于外部通行证（手机号）打通。
0.2 用户体系架构
- 同一家长在两个小程序中产生不同 openID，通过 unionId 统一映射到同一个家长 memberid
- 家长与学员为 N:M 多对多关系
- 可能存在家长未绑定任何学员的情况（新用户）
0.3 登录与绑定学员时序图
源文件：diagrams/login-bindstudent-sequence.puml
登录 3个页面
模块说明：登录模块负责用户身份认证全流程。用户触发需登录操作后进入登录页，通过微信一键授权获取手机号，完成通行证匹配与绑定。
入口：游客态触发加购/下单/进入购物车等操作时拦截跳转 | 页面组成：登录页 → 手机号授权弹窗 → 协议页（用户协议/隐私协议/儿童隐私协议）
1.1 登录页
界面结构
- 顶部：品牌 Logo + 品牌名称
- 中部：「微信快捷登录」按钮（主按钮）
- 底部：勾选框 + 协议链接文案（“已阅读并同意《用户协议》《隐私协议》《儿童隐私协议》”）
数据规则
登录页无需接口数据，纯静态页。
状态说明
| 状态 | 表现 |
|---|---|
| 未登录（默认） | 展示登录页全部元素 |
| 已登录 | 不应进入此页面（路由守卫跳转回来源页） |
交互规则
| 操作 | 响应 |
|---|---|
| 点击「微信快捷登录」 | 判断是否已勾选协议：未勾选 → Toast"请先阅读并同意协议"；已勾选 → 调用微信 getPhoneNumber，进入 1.2 |
| 手机号授权成功 | 见 1.2 |
| 登录成功后 | 判断是否已绑定学员：是 → 返回来源页；否 → 跳转 2.A（添加学员页） |
| 点击协议文字 | 跳转 1.3（协议页），根据点击的协议名称传参展示对应内容（用户协议 / 隐私协议 / 儿童隐私协议） |
| 物理返回 | 返回上一页（游客态继续浏览） |
异常与兜底
| 场景 | 处理 |
|---|---|
| 登录接口报错 | Toast 提示（后端下发 message，前端不硬编码文案），保持当前页 |
| 网络异常 | 展示全局网络异常页（见 01 §6.1） |
配置项清单
— 无后台配置项。
1.2 手机号授权弹窗
微信原生 UI 弹窗（非自定义页面），由
wx.getPhoneNumber 触发。界面结构
- 顶部：小程序名称 + 图标
- 标题："申请获取并验证你的手机号"
- 用途标签："登录"
- 手机号列表：展示用户微信绑定的手机号（可能有多个）
- 底部按钮：「不允许」
- 底部链接："管理号码"
数据规则
| 字段 | 来源 | 说明 |
|---|---|---|
| 手机号列表 | 微信账号绑定 | 微信侧维护，非我方控制 |
| 选中手机号 | 用户点选 | 用户选择的手机号作为登录凭证 |
交互规则
| 操作 | 响应 |
|---|---|
| 点击某个手机号 | 授权成功 → 前端获取加密手机号数据 → 调用通行证登录接口 |
| 点击「不允许」 | 授权拒绝 → Toast"需要手机号才能登录"，停留登录页 |
| 多手机号场景 | 用户选哪个号就用哪个号去匹配通行证 |
状态说明
| 状态 | 表现 |
|---|---|
| 单手机号 | 仅展示一个手机号选项 |
| 多手机号 | 展示多个手机号供用户选择 |
异常与兜底
| 场景 | 处理 |
|---|---|
| getPhoneNumber 接口失败 | Toast 提示（后端下发 message，前端不硬编码文案） |
| 用户多次拒绝授权 | 微信可能不再弹出，需引导用户到小程序设置中重新授权 |
配置项清单
— 无后台配置项（微信原生能力）。
1.3 协议页
界面结构
- 标题栏：根据传参动态显示「用户协议」/「隐私协议」/「儿童隐私协议」
- 正文区：富文本滚动展示协议内容
三份协议共用同一个页面模板，通过参数区分加载不同内容。
数据规则
| 字段 | 来源 | 说明 |
|---|---|---|
| 协议类型 | 页面传参 | 枚举：user_agreement / privacy / children_privacy |
| 协议内容 | 前端写死 | 三份协议正文硬编码在前端，无后台管理能力 |
状态说明
不区分登录态，始终可访问。
交互规则
| 操作 | 响应 |
|---|---|
| 滚动 | 正常滚动浏览 |
| 返回 | 返回登录页 |
异常与兄底
| 场景 | 处理 |
|---|---|
| 富文本加载失败 | 展示“内容加载失败”提示 + 重试按钮 |
配置项清单
— 无后台配置项（协议内容当前为前端写死）。
跨端登录 无UI·静默逻辑
模块说明：用户在小程序之间跳转、或小程序内打开 H5 页面时的登录补全逻辑。全程用户无感知，无额外 UI 交互。
账号打通机制：外部通行证系统统一手机号（不依赖 unionId） | 场景组成：跨小程序跳转 + H5 登录
核心前提：两个小程序使用同一套外部通行证系统（以手机号为唯一标识匹配用户），并共享同一套后端服务与用户体系。该前提是跨端静默登录可行的技术基础。
跨端登录规则
🔗
无独立 UI 页面
后台静默处理，用户无感知
本模块描述用户在小程序之间跳转、或小程序内打开 H5 页面时的登录补全逻辑。账号打通基于外部通行证统一手机号。
场景一：跨小程序跳转（新小程序未登录）
| 项目 | 说明 |
|---|---|
| 触发条件 | 用户从 A 小程序跳转到 B 小程序，B 当前无登录态 |
| 处理逻辑 | 自动静默登录（通过外部通行证统一手机号打通账号体系），登录后自动选中与 A 小程序一致的学员 |
| 用户感知 | 无感知，无登录页、无弹窗、无 Toast |
| 核心约束 | 登录账号 + 选中学员必须与来源小程序一致 |
场景二：跨小程序跳转（新小程序已登录且账号不一致）
| 项目 | 说明 |
|---|---|
| 触发条件 | 用户从 A 小程序跳转到 B 小程序，B 已登录但账号与 A 不一致 |
| 处理逻辑 | 用来源小程序(A)的登录态覆盖目标小程序(B)，B 自动切换为 A 的当前账号 |
| 用户感知 | B 小程序自动切换账号，页面数据刷新为来源账号对应数据 |
| 核心约束 | 跳转时目标小程序账号必须与来源小程序保持一致（适用于网报→拼团场景） |
场景三：小程序内打开 H5 页面
| 项目 | 说明 |
|---|---|
| 触发条件 | 小程序内通过 WebView 打开 H5 页面 |
| 处理逻辑 | 自动静默登录 H5，登录账号与选中学员必须与小程序当前一致 |
| 用户感知 | 无感知，H5 直接展示已登录态内容 |
| 核心约束 | 账号一致性为强制要求，不允许 H5 与小程序登录不同账号 |
| 实现方式 | 小程序通过 URL 参数或 JS Bridge 将 token + 学员信息传递给 H5 |
| 适用 H5 入口 | 入学诊断、调课、转班、转介绍（均通过此机制实现与小程序登录态同步） |
技术实现要点
- 跨小程序账号打通基于外部通行证系统统一手机号（通行证以手机号为唯一标识匹配用户，不依赖 unionId 是否已绑定）
- 两个小程序共享同一套后端服务和用户体系，同一手机号即为同一用户
- 跳转时携带加密的来源信息（当前登录 token + 选中学员 memberId）
- 目标小程序启动时检测来源参数，识别为跨端跳转场景后执行静默登录流程
- H5 登录通过小程序 WebView 的 URL query 或 postMessage 传递凭证
Token 传递与会话共享机制
| 跳转类型 | Token 传递方式 | 说明 |
|---|---|---|
| 小程序 ↔ 小程序 | 通过 URL 参数携带加密 Token | 来源端将登录态加密后写入跳转 URL 的 query；目标端解析后自动登录，无需用户再次授权 |
| 小程序 → H5 | 通过 cookie 同域共享 Session | H5 与小程序后端处于同一主域，借助 cookie 复用已建立的会话；如不同域则降级为 URL query 携带加密 Token |
跨小程序学员上下文传递
- 跨小程序跳转时，当前选中的学员信息（学员 memberId 等关键标识）随登录态一并传递给目标应用
- 目标端完成静默登录后，自动切换到该学员，确保来源端与目标端的"当前学员"完全一致
- 若目标端未绑定该学员（极端情况），按场景一/场景二的兜底逻辑处理，并以来源端账号为准
绑定学员 双Tab + 子页面
模块说明：登录成功后若未绑定学员，引导家长添加学员信息。支持两种方式：填表创建新学员，或通过手机号+姓名+验证码绑定已有学员。
入口：① 新用户登录后无学员自动跳入 ② 我的学员页点击「添加学员」 | 页面组成：添加新学员(Tab 1) + 添加已有学员(Tab 2) + 子页面(选择年级/选择城市/在读学校)
学员上限：单个家长账号最多绑定 5 个学员（与首页多孩切换上限对齐），上限统计包含 TMS 绑定的学员。达到上限后，「添加学员」入口置灰，绑定接口报错时 Toast 提示（后端下发 message，前端不硬编码文案）。历史已绑定超过 5 个学员的存量数据不做处理，维持现状（2026-07-28 测试评审确认）。
无学员状态规则（2026-07-26 修订）：登录后账号下未绑定任何学员时，自动跳入本模块（添加学员页）引导完成首个学员绑定（与 1.2「登录成功后」跳转规则一致）；首页/我的等页面的引导添加学员提示与入口（提示文案示意："添加孩子信息，获取个性化学习推荐"）仅作异常兜底（自动跳转未生效时的手动入口），不锁定城市切换。
学员管理 P0 能力清单
| 能力 | 优先级 | 说明 |
|---|---|---|
| 小程序绑定学生（短信验证码） | P0 | 小程序端完成学生绑定流程，通过短信验证码方式进行身份验证（流程与异常兜底详见 2.B） |
| 学员信息编辑 | P0 | 支持学员头像、生日、性别、年级等信息编辑 |
| 学校列表 | P0 | 在读学校、目标学校选择，需实现字母索引快速定位 |
| 绑定新学员 | P0 | 支持在小程序端绑定新的学员账号（见 2.A / 2.B） |
| 学员列表 | P0 | 展示已绑定的学员列表，支持切换 |
期数说明（2026-08-04 口径确认）：「小程序绑定学生（短信验证码）」即 2.B 添加已有学员流程，属网报小程序自身绑定能力，归属一期；「TMS 分享学生绑定小程序码（区分优学/悦学）」与「绑定学生后跳转至对应小程序」归属二期（改动汇总 2.1 / 9.1 / 6.3）。
2.A 添加新学员（Tab 1）
本模块为双Tab页面，支持「添加新学员」和「添加已有学员」两种方式。
入口：① 新用户登录成功后无学员自动跳入；② 我的学员页点击「添加学员」。
入口：① 新用户登录成功后无学员自动跳入；② 我的学员页点击「添加学员」。
界面结构
- Tab栏：「添加新学员」(当前) | 添加已有学员
- 表单：学员姓名（必填）、性别（必填）、在读年级（必填，跳转 2.A-1）、所在城市（必填，跳转 2.A-2）
- 底部：「确认」按钮
数据规则
| 字段 | 来源 | 说明 |
|---|---|---|
| 年级选项 | 后台配置（年级枚举） | 固定选项列表，按学段分组 |
| 城市选项 | 后台配置（城市枚举） | 已开通城市列表 |
交互规则
| 操作 | 响应 |
|---|---|
| 点击「确认」 | 表单校验 → 创建学员 → 成功后：新用户入口跳转首页 / 我的学员入口返回我的学员页并刷新 |
| 切换到「添加已有学员」Tab | 切换至 2.B 表单 |
| 物理返回 | 新用户入口：[待确认] 是否允许跳过；我的学员入口：返回我的学员页 |
异常与兜底
| 场景 | 处理 |
|---|---|
| 创建学员接口失败 | Toast 提示（后端下发 message，前端不硬编码文案） |
| 城市/年级选项加载失败 | Toast 提示 + 重试 |
| 表单校验不通过 | 对应字段标红提示 |
配置项清单
| 配置项 | 说明 |
|---|---|
| 城市枚举列表 | 后台维护已开通城市 |
| 年级枚举列表 | 后台维护年级选项，含学段分组 |
2.A-1 选择年级
调用方：2.A 表单中点击"年级"字段
界面结构
- 标题栏：「选择年级」
- 年级列表：分组展示（小学 / 初中 / 高中），单选
交互规则
| 操作 | 响应 |
|---|---|
| 点击年级选项 | 选中并返回上一页，填入所选年级 |
状态说明
| 状态 | 表现 |
|---|---|
| 有当前年级 | 对应选项高亮 |
| 无选中 | 无高亮（新建学员场景） |
2.A-2 选择城市
调用方：2.A 表单中点击"城市"字段
界面结构
- 标题栏：「选择城市」
- 城市列表：展示已开通城市
交互规则
| 操作 | 响应 |
|---|---|
| 点击城市选项 | 选中并返回上一页，填入所选城市 |
状态说明
| 状态 | 表现 |
|---|---|
| 有当前城市 | 对应选项高亮 |
| 无选中 | 无高亮（新建学员场景） |
2.A-3 在读学校（选择学校）
调用方：学员相关表单中学校字段（在读学校 / 目标学校）点击调起，对应 P0 能力清单「学校列表」项
界面结构
- 标题栏：「在读学校」
- 搜索框：占位「请输入学校名称」，输入后右侧出现 × 清除按钮
- 学校列表：按首字母分组（G/H/M/Y/# 等），右侧字母索引条快速定位（P0 能力清单「字母索引」要求）
- 兜底项「其他」：置于 # 分组末尾
- 搜索结果态：匹配关键词橙色高亮（如「广东」华侨中学）
交互规则
| 操作 | 响应 |
|---|---|
| 点击学校行 | 选中（右侧对勾标记）并返回上一页，回填所选学校 |
| 搜索框输入关键词 | 列表切换为搜索结果（关键词高亮）；触发时机（实时/提交）待评审确认 |
状态说明
| 状态 | 表现 |
|---|---|
| 已有在读学校 | 对应行显示橙色对勾 |
来源：网报3.0升级设计稿-20260804（一期学员绑定流程用图）。待评审补全：① 具体调用表单（2.A 添加新学员表单是否含学校字段、或学员信息编辑页调起）设计稿未标注；② 搜索无结果时的空态与引导设计稿未提供；③ 目标学校是否复用本页（仅标题不同）待确认；④ 搜索触发时机（实时过滤/提交触发）无依据；⑤ × 清除后的恢复行为无依据；⑥ 字母索引条点击定位的交互细节无依据（仅「需实现字母索引」为 P0 清单原文）；⑦ 无选中时的展示状态无依据；⑧「其他」项选中后的回填行为无依据。以上 ④~⑧ 经 2026-08-05 事实核查自规则表中移除，评审确认后写回。
2.B 添加已有学员（Tab 2）
界面结构
- Tab栏：添加新学员 | 「添加已有学员」(当前)
- 表单：手机（必填，学员已绑定手机号）、姓名（必填，学员真实姓名）、验证码（必填，6位）
- 「获取验证码」按钮（验证码输入框右侧）
- 底部：「提交」按钮
- 底部文案："获取个性化学习推荐，保存孩子成长记录"
数据规则
| 字段 | 来源 | 说明 |
|---|---|---|
| 手机号 | 用户输入 | 11位，学员在业务系统中已绑定的手机号 |
| 姓名 | 用户输入 | 学员真实姓名，与手机号联合匹配 |
| 验证码 | 短信下发 | 6位数字，发送至学员手机号 |
| 验证码有效期 | 后端配置 | 默认 5 分钟 |
| 获取验证码冷却 | 前端控制 | 60秒倒计时 |
交互规则
| 操作 | 响应 |
|---|---|
| 点击「获取验证码」 | 校验手机号格式 → 发送验证码 → 按钮 60s 倒计时 |
| 点击「提交」 | 校验全部字段 → 绑定已有学员接口 → 成功后：新用户入口跳转首页 / 我的学员入口返回我的学员页 |
| 切换到「添加新学员」Tab | 切换至 2.A 表单 |
| 物理返回 | 同 2.A |
状态说明
| 状态 | 表现 |
|---|---|
| 正常 | 空表单，填写后提交 |
| 已达上限（最多 5 个） | 不应进入此页（入口已置灰） |
| 获取验证码倒计时 | 「获取验证码」置灰显示剩余秒数 |
异常与兜底
| 场景 | 处理 |
|---|---|
| 手机号+姓名未匹配到学员 | Toast 提示（后端下发 message，前端不硬编码文案） |
| 验证码错误/过期 | Toast 提示（后端下发 message，前端不硬编码文案） |
| 发送验证码失败 | Toast 提示（后端下发 message，前端不硬编码文案） |
| 验证码获取次数过多 | 弹出安全验证组件（网易易盾），通过验证后方可继续获取验证码。注：仅生产环境触发此限制（源码 captcha/index.js 有据） |
| 绑定接口失败 | Toast 提示（后端下发 message，前端不硬编码文案） |
| 学员已达上限 | Toast 提示（后端下发 message，前端不硬编码文案） |
| 该学员已被当前家长绑定 | Toast"该学员已绑定"（源码有据） |
2026-07-26 修订：本流程即「网报支持小程序绑定学生」（短信验证码验证），异常兜底场景清单以改动汇总 2.1 为准（发送失败/验证码错误过期/学员达上限）；具体 Toast 文案由后端 message 下发，前端不硬编码（2026-08-05 源码核查：portal-vue 绑定流程沿用后端 message 机制，原 PRD 所写文案非源码原文，已移除）。2026-08-04 口径确认：本流程为网报小程序自身绑定能力，归属一期（原「归属二期」标注作废）；「TMS 分享学生绑定小程序码」与「绑定学生后跳转至对应小程序」归属二期。
2.C 新用户绑定学员流程（网报3.0升级设计稿-20260804 新版）
1
2
3
4
5
新版设计稿与既有环节对照
| 新版图 | 对应环节 | 说明 |
|---|---|---|
| 1新用户-添加新学员 | 2.A 添加新学员（Tab 1） | 3.0 新版表单（姓名/性别/年级/城市） |
| 2新用户-完善信息-年级选择 | 2.A-1 选择年级 | 新用户完善信息语境下的年级选择 |
| 3选择地区 | 2.A-2 选择城市 | 同「选择城市」页，3.0 新版叫「选择地区」 |
| 4添加已有学员 | 2.B 添加已有学员（Tab 2） | 3.0 新版表单（手机号/姓名/验证码） |
| 5验证码填写 | 2.B 验证码交互态 | 获取验证码后填写 6 位数字，60s 倒计时 |
来源：网报3.0升级设计稿-20260804。业务规则（字段/校验/上限 5 个/短信验证码/异常兜底）以 2.A / 2.A-1 / 2.A-2 / 2.B 既有规则为准，本组图为 3.0 视觉新版对照，功能结构一致。
全部学员页 学员管理
模块说明：全部学员页展示当前家长绑定的所有学员，支持切换当前学员、解绑学员、添加新学员。当前学员以金色卡片突出展示，其他学员以列表形式排列。
入口：个人中心（三期/05-我的）顶部用户区点击 | 展示形式：全屏新页面（带返回箭头）
4.1 全部学员页
4.1 界面结构
- 导航栏：左侧返回箭头 + 标题"全部学员"
- 当前学员卡片（金色背景）：头像 + 姓名 + "城市 | 年级" + 右上角设置⚙图标 + 底部学员编号"NO: XXXX" + 复制按钮
- "其他学员"标题
- 其他学员列表：每行 — 头像 + 姓名 + "城市 | 年级" + 「点击切换」按钮（橙色边框）
- 底部：「+ 添加学员」按钮 + "温馨提示：最多关联5名学员"
4.1 数据规则
| 维度 | 说明 |
|---|---|
| 来源 | 后台接口（会员库），返回当前家长绑定的所有学员列表 |
| 字段 | 学员ID、姓名、头像(URL)、城市、年级、学员编号 |
| 数量限制 | 最多关联 5 名学员 |
| 排序 | 当前选中学员置顶（金色卡片），其余按绑定时间排序 |
| 刷新时机 | 进入页面时拉取最新数据 |
4.1 状态说明
| 场景 | 表现 |
|---|---|
| 仅1名学员 | 只展示当前学员卡片，无"其他学员"区块，底部仍有"+ 添加学员" |
| 已达5名上限 | 「+ 添加学员」按钮置灰，点击 Toast 提示（后端下发 message，前端不硬编码文案）（置灰 + Toast 口径 2026-07-28 测试评审确认） |
| 无学员（新注册） | 不应进入此页面（登录后强制进入绑定学员流程） |
4.1 交互规则
| 操作 | 响应 |
|---|---|
| 点击设置⚙图标 | 跳转当前学员信息编辑页（修改头像/姓名/年级等） |
| 点击「复制」 | 复制学员编号到剪贴板，Toast提示"已复制" |
| 点击「点击切换」 | 切换当前学员为该学员，刷新页面（该学员变为金色卡片），同时首页/选课页数据联动刷新 |
| 左滑其他学员行 | 露出红色删除按钮（垃圾桶图标） |
| 点击删除按钮 | 弹窗确认"确认解除关联？解绑后，可使用该学员已绑定的手机号和姓名重新绑定"（取消/确定） |
| 确认解绑 | 调用解绑接口，成功后从列表移除该学员 |
| 点击「+ 添加学员」 | 跳转添加学员页（复用绑定学员流程） |
| 点击返回 | 返回个人中心页 |
当前学员（金色卡片）不可左滑删除，只能通过切换为其他学员后再解绑。
4.1 异常与兜底
| 场景 | 处理 |
|---|---|
| 学员列表接口失败 | 展示全局网络异常页（含重试按钮） |
| 解绑接口失败 | Toast 提示（后端下发 message，前端不硬编码文案） |
| 切换学员接口失败 | Toast 提示（后端下发 message，前端不硬编码文案），保持当前状态 |
| 头像加载失败 | 显示性别对应的默认头像（男生/女生各一套默认头像） |
4.1 配置项清单
| 配置项 | 说明 |
|---|---|
| 最大学员数 | 前端硬编码 5（上限变更需前端发版） |
| 默认头像 | 前端内置男生/女生默认头像资源 |