01 · 模块定位
家长端服务中心
家长端按前台可落地版本建设，覆盖微信小程序和 H5；范围聚焦家长登录、学员绑定、首页服务、课表请假补课、合同缴费、家校沟通和服务工单。家长端不展示发票申请、发票中心、发票抬头，不支持分期付款，不承接人脸采集授权/撤回授权，不开放线上退费申请，只提供退费咨询和线下办理指引。业务目标
面向家长提供登录绑定、多孩子首页、课表请假补课、合同签署缴费、家校沟通、成长喜报和服务工单等前台服务体验。
使用终端
微信小程序、H5，面向家长独立账号；家长端只承接前台服务体验，不承接发票申请、分期付款、人脸采集授权和线上退费申请。
验收主线
家长端按前台可落地版本建设，覆盖微信小程序和 H5；范围聚焦家长登录、学员绑定、首页服务、课表请假补课、合同缴费、家校沟通和服务工单。家长端不展示发票申请、发票中心、发票抬头，不支持分期付款，不承接人脸采集授权/撤回授权，不开放线上退费申请，只提供退费咨询和线下办理指引。
02 · 范围边界
明确本模块负责什么、依赖什么、不负责什么
边界清晰后，原型、接口和数据库设计才能避免重复建设。模块内范围
- P01 登录方式选择
- P02 手机号验证码登录
- P03 家长首页 / 多孩子聚合看板
- P04 学员绑定 / 监护关系认证
- P05 家庭 / 学员信息详情
- P06 课表与课次服务
- P07 补课申请 / 补课安排
- P08 合同列表
- P09 合同详情
- P10 报价 / 优惠明细
- P11 电子合同签署
- P12 在线缴费 / 收银台
- P13 退费咨询 / 线下办理指引
- P14 家校沟通首页 / 消息列表
- P15 消息详情
- P16 课堂点评详情
- P17 作业批改详情
- P18 测评报告摘要
- P19 服务回访记录
- P20 服务工单列表
- P21 工单提交
- P22 工单详情 / 处理进度
- S01 协议未勾选 / 验证码错误
- S02 多孩子切换抽屉
- S03 到校 / 课消通知
- S04 课次详情抽屉
- S05 请假申请抽屉
- S06 附件预览
- S07 工单关闭 / 转人工确认
- S08 支付成功 / 失败
- S09 监护关系未认证
- S10 合同待签署
- S11 无权限 / 加载失败 / 保存失败
- S12 审批驳回 / 外部接口异常 / 批量部分失败
- S13 成长喜报生成 / 海报预览
上游依赖
- 组织校区与账号权限
- 课程/客户/合同等主数据
- 审批流、消息模板、文件中心
- 必要的第三方接口密钥
下游输出
- 业务状态和待办
- 消息通知和审批记录
- 报表指标和数据快照
- 审计日志和接口回执
03 · 确认口径、后台配置与默认实施规则
家长端服务中心必须承接的已确认规则
本章节来自待决策与澄清清单的收口结果，已经转为本模块 PRD 的正式需求、配置项或默认实施规则。| 分类 | 事项 | 本模块落地要求 | 责任方 |
|---|---|---|---|
| 默认实施规则 | iOS/iPadOS 原生视觉策略 | UI 优先设计原生质感，工程上能用原生控件就用，不能用则跨端降级；不设 Liquid Glass 专项验收。 | 产品/UI/前端 |
| 默认实施规则 | 接口设计说明书组织方式 | 采用单独 HTML 文件集中管理接口协议；模块 PRD 保留模块级接口摘要，避免每个模块重复写通用协议。 | 产品/研发 |
| 默认实施规则 | 接口错误码与重试中间件 | 所有外部接口和内部异步任务统一错误码、幂等键、重试次数、告警阈值和回执归档策略。 | 后端/测试/运维 |
04 · 业务流程
家长端服务中心主流程
流程用于指导原型图的页面顺序、按钮状态和异常分支。01P01 登录方式选择
P01 登录方式选择需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
02P02 手机号验证码登录
P02 手机号验证码登录需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
03P03 家长首页 / 多孩子聚合看板
P03 家长首页 / 多孩子聚合看板需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
04P04 学员绑定 / 监护关系认证
P04 学员绑定 / 监护关系认证需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
05P05 家庭 / 学员信息详情
P05 家庭 / 学员信息详情需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
06P06 课表与课次服务
P06 课表与课次服务需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
07P07 补课申请 / 补课安排
P07 补课申请 / 补课安排需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
08P08 合同列表
P08 合同列表需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。
05 · 功能清单
按子模块拆到可设计、可开发、可测试的颗粒度
每一行功能都需要在原型中体现入口、状态、按钮、字段和反馈。| 一级功能 | 二级功能 | 功能说明 | 规则/验收 |
|---|---|---|---|
| P01 登录方式选择 | 家长端前台操作 | P01 登录方式选择支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P01 登录方式选择 | 业务处理 | P01 登录方式选择需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P01 登录方式选择 | 异常闭环 | 协议未勾选处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P02 手机号验证码登录 | 家长端前台操作 | P02 手机号验证码登录支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P02 手机号验证码登录 | 业务处理 | P02 手机号验证码登录需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P02 手机号验证码登录 | 异常闭环 | 验证码错误处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P03 家长首页 / 多孩子聚合看板 | 家长端前台操作 | P03 家长首页 / 多孩子聚合看板支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P03 家长首页 / 多孩子聚合看板 | 业务处理 | P03 家长首页 / 多孩子聚合看板需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P03 家长首页 / 多孩子聚合看板 | 异常闭环 | 监护关系未认证处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P04 学员绑定 / 监护关系认证 | 家长端前台操作 | P04 学员绑定 / 监护关系认证支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P04 学员绑定 / 监护关系认证 | 业务处理 | P04 学员绑定 / 监护关系认证需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P04 学员绑定 / 监护关系认证 | 异常闭环 | 绑定关系异常处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P05 家庭 / 学员信息详情 | 家长端前台操作 | P05 家庭 / 学员信息详情支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P05 家庭 / 学员信息详情 | 业务处理 | P05 家庭 / 学员信息详情需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P05 家庭 / 学员信息详情 | 异常闭环 | 请假重复提交处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P06 课表与课次服务 | 家长端前台操作 | P06 课表与课次服务支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P06 课表与课次服务 | 业务处理 | P06 课表与课次服务需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P06 课表与课次服务 | 异常闭环 | 补课候选过期处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P07 补课申请 / 补课安排 | 家长端前台操作 | P07 补课申请 / 补课安排支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P07 补课申请 / 补课安排 | 业务处理 | P07 补课申请 / 补课安排需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P07 补课申请 / 补课安排 | 异常闭环 | 合同待签署处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P08 合同列表 | 家长端前台操作 | P08 合同列表支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P08 合同列表 | 业务处理 | P08 合同列表需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P08 合同列表 | 异常闭环 | 支付失败处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P09 合同详情 | 家长端前台操作 | P09 合同详情支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P09 合同详情 | 业务处理 | P09 合同详情需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P09 合同详情 | 异常闭环 | 海报生成失败处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P10 报价 / 优惠明细 | 家长端前台操作 | P10 报价 / 优惠明细支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P10 报价 / 优惠明细 | 业务处理 | P10 报价 / 优惠明细需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P10 报价 / 优惠明细 | 异常闭环 | 工单已关闭处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P11 电子合同签署 | 家长端前台操作 | P11 电子合同签署支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P11 电子合同签署 | 业务处理 | P11 电子合同签署需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P11 电子合同签署 | 异常闭环 | 满意度已提交处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P12 在线缴费 / 收银台 | 家长端前台操作 | P12 在线缴费 / 收银台支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P12 在线缴费 / 收银台 | 业务处理 | P12 在线缴费 / 收银台需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P12 在线缴费 / 收银台 | 异常闭环 | 接口超时处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P13 退费咨询 / 线下办理指引 | 家长端前台操作 | P13 退费咨询 / 线下办理指引支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P13 退费咨询 / 线下办理指引 | 业务处理 | P13 退费咨询 / 线下办理指引需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P13 退费咨询 / 线下办理指引 | 异常闭环 | 协议未勾选处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P14 家校沟通首页 / 消息列表 | 家长端前台操作 | P14 家校沟通首页 / 消息列表支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P14 家校沟通首页 / 消息列表 | 业务处理 | P14 家校沟通首页 / 消息列表需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P14 家校沟通首页 / 消息列表 | 异常闭环 | 验证码错误处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P15 消息详情 | 家长端前台操作 | P15 消息详情支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P15 消息详情 | 业务处理 | P15 消息详情需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P15 消息详情 | 异常闭环 | 监护关系未认证处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P16 课堂点评详情 | 家长端前台操作 | P16 课堂点评详情支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P16 课堂点评详情 | 业务处理 | P16 课堂点评详情需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P16 课堂点评详情 | 异常闭环 | 绑定关系异常处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P17 作业批改详情 | 家长端前台操作 | P17 作业批改详情支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P17 作业批改详情 | 业务处理 | P17 作业批改详情需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P17 作业批改详情 | 异常闭环 | 请假重复提交处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P18 测评报告摘要 | 家长端前台操作 | P18 测评报告摘要支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P18 测评报告摘要 | 业务处理 | P18 测评报告摘要需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P18 测评报告摘要 | 异常闭环 | 补课候选过期处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P19 服务回访记录 | 家长端前台操作 | P19 服务回访记录支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P19 服务回访记录 | 业务处理 | P19 服务回访记录需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P19 服务回访记录 | 异常闭环 | 合同待签署处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P20 服务工单列表 | 家长端前台操作 | P20 服务工单列表支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P20 服务工单列表 | 业务处理 | P20 服务工单列表需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P20 服务工单列表 | 异常闭环 | 支付失败处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P21 工单提交 | 家长端前台操作 | P21 工单提交支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P21 工单提交 | 业务处理 | P21 工单提交需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P21 工单提交 | 异常闭环 | 海报生成失败处理 | 失败原因可见、可重试、可转人工、可追溯 |
| P22 工单详情 / 处理进度 | 家长端前台操作 | P22 工单详情 / 处理进度支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| P22 工单详情 / 处理进度 | 业务处理 | P22 工单详情 / 处理进度需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| P22 工单详情 / 处理进度 | 异常闭环 | 工单已关闭处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S01 协议未勾选 / 验证码错误 | 家长端前台操作 | S01 协议未勾选 / 验证码错误支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S01 协议未勾选 / 验证码错误 | 业务处理 | S01 协议未勾选 / 验证码错误需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S01 协议未勾选 / 验证码错误 | 异常闭环 | 满意度已提交处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S02 多孩子切换抽屉 | 家长端前台操作 | S02 多孩子切换抽屉支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S02 多孩子切换抽屉 | 业务处理 | S02 多孩子切换抽屉需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S02 多孩子切换抽屉 | 异常闭环 | 接口超时处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S03 到校 / 课消通知 | 家长端前台操作 | S03 到校 / 课消通知支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S03 到校 / 课消通知 | 业务处理 | S03 到校 / 课消通知需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S03 到校 / 课消通知 | 异常闭环 | 协议未勾选处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S04 课次详情抽屉 | 家长端前台操作 | S04 课次详情抽屉支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S04 课次详情抽屉 | 业务处理 | S04 课次详情抽屉需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S04 课次详情抽屉 | 异常闭环 | 验证码错误处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S05 请假申请抽屉 | 家长端前台操作 | S05 请假申请抽屉支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S05 请假申请抽屉 | 业务处理 | S05 请假申请抽屉需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S05 请假申请抽屉 | 异常闭环 | 监护关系未认证处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S06 附件预览 | 家长端前台操作 | S06 附件预览支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S06 附件预览 | 业务处理 | S06 附件预览需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S06 附件预览 | 异常闭环 | 绑定关系异常处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S07 工单关闭 / 转人工确认 | 家长端前台操作 | S07 工单关闭 / 转人工确认支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S07 工单关闭 / 转人工确认 | 业务处理 | S07 工单关闭 / 转人工确认需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S07 工单关闭 / 转人工确认 | 异常闭环 | 请假重复提交处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S08 支付成功 / 失败 | 家长端前台操作 | S08 支付成功 / 失败支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S08 支付成功 / 失败 | 业务处理 | S08 支付成功 / 失败需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S08 支付成功 / 失败 | 异常闭环 | 补课候选过期处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S09 监护关系未认证 | 家长端前台操作 | S09 监护关系未认证支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S09 监护关系未认证 | 业务处理 | S09 监护关系未认证需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S09 监护关系未认证 | 异常闭环 | 合同待签署处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S10 合同待签署 | 家长端前台操作 | S10 合同待签署支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S10 合同待签署 | 业务处理 | S10 合同待签署需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S10 合同待签署 | 异常闭环 | 支付失败处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S11 无权限 / 加载失败 / 保存失败 | 家长端前台操作 | S11 无权限 / 加载失败 / 保存失败支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S11 无权限 / 加载失败 / 保存失败 | 业务处理 | S11 无权限 / 加载失败 / 保存失败需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S11 无权限 / 加载失败 / 保存失败 | 异常闭环 | 海报生成失败处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S12 审批驳回 / 外部接口异常 / 批量部分失败 | 家长端前台操作 | S12 审批驳回 / 外部接口异常 / 批量部分失败支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S12 审批驳回 / 外部接口异常 / 批量部分失败 | 业务处理 | S12 审批驳回 / 外部接口异常 / 批量部分失败需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S12 审批驳回 / 外部接口异常 / 批量部分失败 | 异常闭环 | 工单已关闭处理 | 失败原因可见、可重试、可转人工、可追溯 |
| S13 成长喜报生成 / 海报预览 | 家长端前台操作 | S13 成长喜报生成 / 海报预览支持查看、提交、确认、补充、评价和消息触达。 | 仅允许绑定关系与监护关系校验通过的家长账号操作 |
| S13 成长喜报生成 / 海报预览 | 业务处理 | S13 成长喜报生成 / 海报预览需覆盖入口、字段、状态、权限、审批/消息、异常处理、审计和指标统计，并与上下游模块保持数据一致。 | 必须联动状态、权限、消息、审批和指标 |
| S13 成长喜报生成 / 海报预览 | 异常闭环 | 满意度已提交处理 | 失败原因可见、可重试、可转人工、可追溯 |
功能到数据对象/接口/表映射
| 功能域 | 承接对象 | 核心表 | 代表接口 | 状态机/状态字段 | 研发落地校验 |
|---|---|---|---|---|---|
| P01 登录方式选择 | GuardianAccount、ParentLoginSession、ParentStudentBinding | par_guardian_account、par_login_session、par_student_binding | POST /api/v1/parent/auth/sms-login | bind_status、login_status、client_type、verify_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P02 手机号验证码登录 | GuardianAccount、ParentLoginSession、ParentStudentBinding | par_guardian_account、par_login_session、par_student_binding | POST /api/v1/parent/auth/sms-login | bind_status、login_status、client_type、verify_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P03 家长首页 / 多孩子聚合看板 | GuardianAccount、ParentStudentBinding、ParentHomeDashboardSnapshot、ParentServiceProfile | par_guardian_account、par_student_binding、par_home_dashboard_snapshot、par_service_profile | GET/POST /api/v1/parent/student-bindings | bind_status、verify_status、snapshot_status、risk_level | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P04 学员绑定 / 监护关系认证 | GuardianAccount、ParentStudentBinding、ParentHomeDashboardSnapshot、ParentServiceProfile | par_guardian_account、par_student_binding、par_home_dashboard_snapshot、par_service_profile | GET/POST /api/v1/parent/student-bindings | bind_status、verify_status、snapshot_status、risk_level | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P05 家庭 / 学员信息详情 | GuardianAccount、ParentStudentBinding、ParentHomeDashboardSnapshot、ParentServiceProfile | par_guardian_account、par_student_binding、par_home_dashboard_snapshot、par_service_profile | GET/POST /api/v1/parent/student-bindings | bind_status、verify_status、snapshot_status、risk_level | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P06 课表与课次服务 | ParentLeaveRequest | par_leave_request | GET /api/v1/parent/schedules | visible_status、makeup_notice_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P07 补课申请 / 补课安排 | ParentLeaveRequest、ParentMakeupConfirmation | par_leave_request、par_makeup_confirmation | GET/PATCH /api/v1/edu/makeup-arrangements | visible_status、makeup_notice_status、confirm_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P08 合同列表 | ParentPaymentRequest、ParentContractAction | par_payment_request、par_contract_action | GET /api/v1/parent/contracts/{id} | hand_sign_status、request_status、action_type、action_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P09 合同详情 | ParentPaymentRequest、ParentContractAction | par_payment_request、par_contract_action | GET /api/v1/parent/contracts/{id} | hand_sign_status、request_status、action_type、action_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P10 报价 / 优惠明细 | ParentPaymentRequest、ParentContractAction | par_payment_request、par_contract_action | GET /api/v1/parent/contracts/{id} | hand_sign_status、request_status、action_type、action_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P11 电子合同签署 | ParentPaymentRequest、ParentContractAction | par_payment_request、par_contract_action | GET /api/v1/parent/contracts/{id} | hand_sign_status、request_status、action_type、action_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P12 在线缴费 / 收银台 | ParentPaymentRequest、ParentContractAction | par_payment_request、par_contract_action | POST/GET /api/v1/parent/payments | hand_sign_status、request_status、action_type、action_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P13 退费咨询 / 线下办理指引 | ParentRefundConsultation、ParentNotificationRecord、ParentServiceTicket | par_refund_consultation、par_notification_record、par_service_ticket | POST/GET /api/v1/parent/refund-consultations | consult_type、consult_status、send_status、ticket_type、ticket_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P14 家校沟通首页 / 消息列表 | GuardianAccount、ParentStudentBinding、ParentHomeDashboardSnapshot、ParentServiceProfile | par_guardian_account、par_student_binding、par_home_dashboard_snapshot、par_service_profile | GET/POST /api/v1/parent/student-bindings | bind_status、verify_status、snapshot_status、risk_level | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P15 消息详情 | ParentServiceProfile、ParentNotificationRecord | par_service_profile、par_notification_record | GET/PATCH /api/v1/parent/messages | risk_level、send_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P16 课堂点评详情 | ParentServiceProfile、ParentNotificationRecord | par_service_profile、par_notification_record | GET/PATCH /api/v1/parent/messages | risk_level、send_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P17 作业批改详情 | ParentServiceProfile、ParentNotificationRecord | par_service_profile、par_notification_record | GET/PATCH /api/v1/parent/messages | risk_level、send_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P18 测评报告摘要 | ParentServiceProfile、ParentNotificationRecord | par_service_profile、par_notification_record | GET/PATCH /api/v1/parent/messages | risk_level、send_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P19 服务回访记录 | ParentServiceProfile、ParentNotificationRecord | par_service_profile、par_notification_record | GET/PATCH /api/v1/parent/messages | risk_level、send_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P20 服务工单列表 | ParentNotificationRecord、ParentServiceTicket、ParentSatisfactionFeedback | par_notification_record、par_service_ticket、par_satisfaction_feedback | POST/GET /api/v1/parent/service-tickets | send_status、ticket_type、ticket_status、feedback_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P21 工单提交 | ParentNotificationRecord、ParentServiceTicket、ParentSatisfactionFeedback | par_notification_record、par_service_ticket、par_satisfaction_feedback | POST/GET /api/v1/parent/service-tickets | send_status、ticket_type、ticket_status、feedback_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| P22 工单详情 / 处理进度 | ParentNotificationRecord、ParentServiceTicket、ParentSatisfactionFeedback | par_notification_record、par_service_ticket、par_satisfaction_feedback | POST/GET /api/v1/parent/service-tickets | send_status、ticket_type、ticket_status、feedback_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S01 协议未勾选 / 验证码错误 | GuardianAccount、ParentLoginSession、ParentStudentBinding | par_guardian_account、par_login_session、par_student_binding | POST /api/v1/parent/auth/sms-login | bind_status、login_status、client_type、verify_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S02 多孩子切换抽屉 | GuardianAccount、ParentStudentBinding、ParentHomeDashboardSnapshot、ParentServiceProfile | par_guardian_account、par_student_binding、par_home_dashboard_snapshot、par_service_profile | GET/POST /api/v1/parent/student-bindings | bind_status、verify_status、snapshot_status、risk_level | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S03 到校 / 课消通知 | ParentLeaveRequest | par_leave_request | GET /api/v1/parent/schedules | visible_status、makeup_notice_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S04 课次详情抽屉 | ParentLeaveRequest | par_leave_request | GET /api/v1/parent/schedules | visible_status、makeup_notice_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S05 请假申请抽屉 | ParentLeaveRequest | par_leave_request | POST/GET /api/v1/edu/leaves | visible_status、makeup_notice_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S06 附件预览 | ParentNotificationRecord、ParentServiceTicket、ParentSatisfactionFeedback | par_notification_record、par_service_ticket、par_satisfaction_feedback | POST/GET /api/v1/parent/service-tickets | send_status、ticket_type、ticket_status、feedback_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S07 工单关闭 / 转人工确认 | ParentNotificationRecord、ParentServiceTicket、ParentSatisfactionFeedback | par_notification_record、par_service_ticket、par_satisfaction_feedback | POST/GET /api/v1/parent/service-tickets | send_status、ticket_type、ticket_status、feedback_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S08 支付成功 / 失败 | ParentPaymentRequest、ParentContractAction | par_payment_request、par_contract_action | POST/GET /api/v1/parent/payments | hand_sign_status、request_status、action_type、action_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S09 监护关系未认证 | GuardianAccount、ParentStudentBinding、ParentHomeDashboardSnapshot、ParentServiceProfile | par_guardian_account、par_student_binding、par_home_dashboard_snapshot、par_service_profile | GET/POST /api/v1/parent/student-bindings | bind_status、verify_status、snapshot_status、risk_level | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S10 合同待签署 | ParentPaymentRequest、ParentContractAction | par_payment_request、par_contract_action | GET /api/v1/parent/contracts/{id} | hand_sign_status、request_status、action_type、action_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S11 无权限 / 加载失败 / 保存失败 | GuardianAccount、ParentLoginSession、ParentStudentBinding、ParentHomeDashboardSnapshot | par_guardian_account、par_login_session、par_student_binding、par_home_dashboard_snapshot | 接口资源组 /api/v1/par/features/33 | bind_status、login_status、client_type、verify_status、snapshot_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S12 审批驳回 / 外部接口异常 / 批量部分失败 | GuardianAccount、ParentLoginSession、ParentStudentBinding、ParentHomeDashboardSnapshot | par_guardian_account、par_login_session、par_student_binding、par_home_dashboard_snapshot | 接口资源组 /api/v1/par/features/34 | bind_status、login_status、client_type、verify_status、snapshot_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
| S13 成长喜报生成 / 海报预览 | ParentNotificationRecord、GrowthPoster | par_notification_record、par_growth_poster | POST/GET /api/v1/parent/growth-posters | send_status、poster_status | 新增/编辑/删除/审批/导出/回调均需校验租户、校区、角色、数据范围、逻辑删除、幂等和审计 |
06 · 原子级功能需求
用于研发任务拆分和测试用例追踪
需求编号可直接进入项目管理工具。| 编号 | 需求描述 | 入口页面 | 关键动作 | 输入校验 | 输出结果 | 异常处理 | 验收标准 |
|---|---|---|---|---|---|---|---|
| FR-PAR-001 | 家长端原型范围按 22 个独立页面 + 13 个弹窗/抽屉/状态页组织，页面、弹窗和状态均需可追溯到字段、按钮、异常、消息和验收口径 | P01-P22、S01-S13 原型范围 | 拆分页面、弹窗、状态和异常画板 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 页面编号缺失、状态画板缺失或字段动作不可追溯时不得进入原型评审 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-002 | 家长端只覆盖微信小程序和 H5 前台体验，后台维护、监管报送、财务科目、审批配置和接口技术细节由对应后台、接口说明书和技术设计文档承接 | 家长端小程序/H5 | 进入家长端服务中心 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 非家长账号、端类型不支持、后台能力误暴露或数据范围缺失时阻断 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-003 | 登录入口支持微信登录、手机号验证码登录、协议勾选、验证码倒计时、验证码错误提示、账号异常提示和联系客服入口 | P01 登录方式选择 / P02 手机号验证码登录 | 微信登录或手机号验证码登录 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 协议未勾选、验证码错误、验证码过期、微信授权失败或账号停用时提示处理路径 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-004 | 学员绑定和监护关系认证支持手机号绑定、微信绑定、学员关系认证、认证失败、重试和转人工处理 | P04 学员绑定 / 监护关系认证 | 绑定学员并提交监护关系认证 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 学员不存在、重复绑定、证明材料缺失、认证驳回或人工处理超时时提示原因 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-005 | 家长首页默认按多孩子聚合展示待办、课表摘要、服务提醒和快捷入口，通过孩子标签区分数据上下文，减少频繁全局切换 | P03 家长首页 / 多孩子聚合看板 | 查看全部孩子待办并切换孩子标签 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 无绑定学员、监护关系未认证、待办加载失败或孩子数据串线时阻断并提示 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-006 | 课表与课次服务展示课表日历、课次详情、到校通知、课消结果、教师、教室、剩余课时和请假入口 | P06 课表与课次服务 | 查看课表、课次详情、到校通知和课消结果 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 课次已取消、课消回写延迟、签到状态异常或课程无权限时展示状态说明 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-007 | 请假必须从课次详情发起，提交后进入老师/教务审核；请假审核通过后才提醒家长安排补课，补课页面自动带入原课次和可选时段 | P06 课表与课次服务 / S05 请假申请抽屉 | 从课次详情提交请假 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 重复请假、超过请假截止、课次不可请假、附件上传失败或审核流未命中时阻断 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-008 | 请假驳回、候选补课过期、补课名额不足、补课改期和补课取消必须有明确状态、原因和下一步动作 | P07 补课申请 / 补课安排 | 查看审核结果并确认补课候选 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 请假未通过、候选课次过期、补课名额已满、确认截止超时或改期申请失败时提示下一步 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-009 | 合同缴费链路覆盖合同列表、合同详情、报价/优惠明细、电子合同签署、在线缴费/收银台、支付成功/失败和已盖章合同查看 | P08 合同列表 / P09 合同详情 / P10 报价优惠 | 查看合同、权益、报价和优惠明细 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 合同已撤回、优惠已失效、金额不一致、合同无权限或数据同步延迟时提示原因 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-010 | 合同支付必须聚焦一次性缴费和正常在线支付，不支持分期付款，收银台不得展示分期方案、分期账单或分期计划 | P12 在线缴费 / 收银台 | 完成一次性在线支付 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 合同未签署、支付中断、支付失败、重复支付或误展示分期方案时阻断并提示 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-011 | 家长端不展示发票申请、发票中心、开票记录和发票抬头；如家长咨询发票，统一进入服务工单或线下咨询口径 | P08-P12 合同缴费链路 | 查看发票咨询入口并转服务工单或线下口径 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 页面出现发票中心、开票记录、发票抬头或发票申请入口时验收不通过 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-012 | 家长端不承接人脸采集授权、撤回授权、隐私授权管理和设备删除回执，不设置独立人脸授权页面或入口 | 家长端服务范围 | 查看人脸相关状态说明或线下处理提示 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 页面出现人脸采集授权、撤回授权、隐私授权管理或设备删除回执入口时验收不通过 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-013 | 退费能力收敛为退费咨询 / 线下办理指引，展示规则说明、材料清单、校区联系方式和受理后进度查询，不开放线上退费申请、退款审批或监管退款操作 | P13 退费咨询 / 线下办理指引 | 查看退费规则、提交咨询工单并查看进度 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 误创建线上退款审批、材料清单缺失、校区联系方式缺失或咨询提交失败时提示处理路径 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-014 | 家校沟通首页聚合课堂点评、作业批改、测评摘要、回访提醒、风险预警和服务消息，消息详情必须展示关联学员、课程、已读状态和业务跳转 | P14 家校沟通首页 / P15 消息详情 | 查看消息、点评、作业、测评和回访提醒 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 消息对象失效、关联学员无权限、已读失败或业务跳转失效时展示兜底入口 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-015 | 课堂优秀点评支持生成成长喜报海报，海报可预览、保存图片和分享给家人，生成失败需支持重试 | P16 课堂点评详情 / S13 成长喜报生成 | 生成、预览、保存和分享成长喜报 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 点评不满足生成条件、海报模板缺失、生成失败、保存失败或分享失败时支持重试 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-016 | 作业批改详情展示作业结果、得分、教师评语、订正要求和跳转学员端继续订正/学习的提示 | P17 作业批改详情 | 查看作业反馈和订正提示 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 批改未完成、订正入口失效、附件预览失败或学员端跳转失败时提示原因 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-017 | 测评报告摘要展示能力维度、测评结果、趋势摘要和学习建议，详细学习动作仍由学员端承接 | P18 测评报告摘要 | 查看能力摘要、趋势和学习建议 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 报告生成中、报告过期、维度数据缺失或无权限时展示空状态和刷新入口 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-018 | 服务工单覆盖投诉建议、退费咨询和服务请求，支持提交、附件、处理进度、补充说明、转人工确认、确认关闭和满意度评价 | P20 服务工单列表 / P21 工单提交 | 提交投诉建议、退费咨询或服务请求 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 工单类型缺失、附件超限、手机号格式错误、重复提交或提交失败时提示修正 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-019 | 工单已关闭后不可重复提交评价；需要补充说明、转人工、驳回或重新打开时必须保留历史处理记录 | P22 工单详情 / 处理进度 / S07 工单关闭 | 查看进度、补充说明、确认关闭和评价满意度 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 工单已关闭、转人工确认未完成、重复评价或重新打开失败时展示历史记录 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
| FR-PAR-020 | 家长端所有敏感动作必须校验绑定关系、监护关系、学员状态和数据范围；越权、加载失败、保存失败和接口异常均需展示可重试或联系客服入口 | 家长端全局权限与异常状态 | 校验绑定关系、监护关系、学员状态和数据范围 | 校验租户、校区、角色、数据范围、状态前置、必填、唯一和敏感操作授权 | 生成业务记录、状态流转、消息通知、审计日志、指标快照和必要的第三方任务 | 越权、加载失败、保存失败、接口超时或监护关系失效时提供重试、返回或联系客服入口 | 主流程、异常流、权限流、接口失败和数据一致性均可通过测试 |
07 · 关联闭环补充需求
家长端服务中心在跨模块闭环中的责任边界
本章节承接最终闭环核对清单，明确本模块需要补齐的页面、接口对象、异常兜底和验收口径。| 闭环项 | 本模块责任 | 关键场景 | 页面/功能补充 | 关联对象/接口 | 验收口径 |
|---|---|---|---|---|---|
| 家长端前台范围 | 负责家长可直接使用的前台服务体验，不承接后台财务、监管、发票、人脸授权和线上退款审批 | 家长进入小程序/H5 使用登录绑定、首页、课表、合同、消息和工单 | 登录入口、多孩子首页、课表、合同缴费、消息服务、工单 | GuardianAccount、ParentStudentBinding、ParentServiceTicket | 家长端范围内不得出现发票申请、分期付款、人脸采集授权和线上退费申请 |
| 补课改期取消 | 向家长提供请假申请、审核结果、补课候选确认、改期、取消和提醒 | 家长请假审核通过后需要安排补课，或候选课次过期 | 请假申请、审核结果、补课确认、改期申请、取消确认、消息通知 | LeaveRequest/MakeupArrangement、Attendance/Consumption | 家长端必须展示补课状态、确认截止时间和处理结果 |
| 合同签署缴费 | 支持家长查看合同、手写签署、在线缴费、查看支付结果和已盖章合同 | 员工端推送合同给家长后，家长完成签署和支付 | 合同详情、报价优惠、电子签署、收银台、支付结果 | Contract/Order/Payment、/api/v1/contracts/{id}/guardian-hand-sign | 支付前必须完成签署，支付失败可重试，不展示分期方案 |
| 服务工单与退费咨询 | 支持投诉建议、退费咨询、服务请求、附件、处理进度、确认关闭和满意度评价 | 家长需要咨询退费、投诉服务或补充材料 | 工单提交、工单详情、关闭确认、满意度评价 | ParentServiceTicket、ParentSatisfactionFeedback | 退费只进入咨询和线下办理指引，不触发线上退款审批 |
08 · 页面与原型设计说明
页面清单、布局要求、按钮字段和状态
原型图设计需要覆盖列表、详情、表单、弹窗、空状态、异常状态和权限状态。| 终端 | 页面 | 用户 | 页面目标 | 布局结构 | 关键按钮 | 关键字段 | 异常状态 | 原型备注 |
|---|---|---|---|---|---|---|---|---|
| 家长端小程序/H5 | P01 登录方式选择 | 家长 | 展示微信登录、手机号验证码登录、协议勾选、登录异常和客服入口，进入家长端前置校验 | 家长端登录采用移动端前置页，首屏只保留微信登录、手机号验证码登录、协议勾选和登录异常提示；验证码输入建议使用分格输入和倒计时重发。 | 微信登录、手机号验证码登录、勾选协议、重新发送验证码、进入家长首页、联系客服 | 手机号、短信验证码、验证码倒计时、微信授权状态、协议勾选、登录状态、账号异常原因、验证码、绑定学员、孩子标签 | 协议未勾选、验证码错误、验证码过期、账号停用、微信授权失败、手机号未绑定 | 家长端登录只解决家长身份进入，不承接员工端、学员端或后台管理登录。 建议 Figma Frame：PAR-p01_登录方式选择；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P02 手机号验证码登录 | 家长 | 输入手机号、短信验证码，展示倒计时、重新发送、验证码错误、登录成功和账号异常状态 | 家长端登录采用移动端前置页，首屏只保留微信登录、手机号验证码登录、协议勾选和登录异常提示；验证码输入建议使用分格输入和倒计时重发。 | 微信登录、手机号验证码登录、勾选协议、重新发送验证码、进入家长首页、联系客服 | 手机号、短信验证码、验证码倒计时、微信授权状态、协议勾选、登录状态、账号异常原因、验证码、绑定学员、孩子标签 | 协议未勾选、验证码错误、验证码过期、账号停用、微信授权失败、手机号未绑定 | 家长端登录只解决家长身份进入，不承接员工端、学员端或后台管理登录。 建议 Figma Frame：PAR-p02_手机号验证码登录；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P03 家长首页 / 多孩子聚合看板 | 家长 | 默认聚合全部孩子待办、课表摘要、服务提醒和快捷入口，通过孩子标签筛选上下文 | 家长首页默认多孩子聚合展示，顶部展示孩子标签和待办总览，内容区按待办、课表、合同缴费、消息服务分组；绑定与监护认证采用独立页面 + 状态反馈。 | 绑定学员、提交监护关系、切换孩子标签、查看待办、进入课表、查看学员信息、联系人工 | 家长账号、学员姓名、关系类型、绑定手机号、认证状态、孩子标签、待办数量、课表摘要、服务提醒、手机号 | 监护关系未认证、认证失败、无绑定学员、重复绑定、学员状态异常、加载失败 | 多孩子家庭不做频繁全局切换，首页聚合展示并用孩子标签区分待办、课表和消息。 建议 Figma Frame：PAR-p03_家长首页_多孩子聚合看板；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P04 学员绑定 / 监护关系认证 | 家长 | 支持手机号绑定、微信绑定、监护关系认证、认证失败、重试和转人工 | 家长首页默认多孩子聚合展示，顶部展示孩子标签和待办总览，内容区按待办、课表、合同缴费、消息服务分组；绑定与监护认证采用独立页面 + 状态反馈。 | 绑定学员、提交监护关系、切换孩子标签、查看待办、进入课表、查看学员信息、联系人工 | 家长账号、学员姓名、关系类型、绑定手机号、认证状态、孩子标签、待办数量、课表摘要、服务提醒、手机号 | 监护关系未认证、认证失败、无绑定学员、重复绑定、学员状态异常、加载失败 | 多孩子家庭不做频繁全局切换，首页聚合展示并用孩子标签区分待办、课表和消息。 建议 Figma Frame：PAR-p04_学员绑定_监护关系认证；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P05 家庭 / 学员信息详情 | 家长 | 查看家庭名下学员、关系状态、认证状态、孩子标签和学员基础服务信息 | 家长首页默认多孩子聚合展示，顶部展示孩子标签和待办总览，内容区按待办、课表、合同缴费、消息服务分组；绑定与监护认证采用独立页面 + 状态反馈。 | 绑定学员、提交监护关系、切换孩子标签、查看待办、进入课表、查看学员信息、联系人工 | 家长账号、学员姓名、关系类型、绑定手机号、认证状态、孩子标签、待办数量、课表摘要、服务提醒、手机号 | 监护关系未认证、认证失败、无绑定学员、重复绑定、学员状态异常、加载失败 | 多孩子家庭不做频繁全局切换，首页聚合展示并用孩子标签区分待办、课表和消息。 建议 Figma Frame：PAR-p05_家庭_学员信息详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P06 课表与课次服务 | 家长 | 展示课表日历、课次详情、到校课消、教师教室、剩余课时和请假入口 | 课表页以日历和课次卡片为核心，课次详情适合底部抽屉；请假从课次详情发起，审核通过后再提醒补课，补课页自动带入原课次。 | 查看课表、展开课次详情、提交请假、撤回请假、查看审核结果、选择补课候选、确认补课、申请改期 | 课次日期、课程、教师、教室、签到状态、课消结果、请假原因、审核状态、驳回原因、补课候选 | 请假已截止、重复请假、审核中不可补课、请假驳回、候选课次过期、补课名额已满、提交失败 | 请假提交后必须先进入老师/教务审核；审核通过后才出现补课提醒和补课安排，不允许家长端绕过审核直接补课。 建议 Figma Frame：PAR-p06_课表与课次服务；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P07 补课申请 / 补课安排 | 家长 | 请假审核通过后进入补课安排，自动带入原课次、候选时段、确认截止和补课结果 | 课表页以日历和课次卡片为核心，课次详情适合底部抽屉；请假从课次详情发起，审核通过后再提醒补课，补课页自动带入原课次。 | 查看课表、展开课次详情、提交请假、撤回请假、查看审核结果、选择补课候选、确认补课、申请改期 | 课次日期、课程、教师、教室、签到状态、课消结果、请假原因、审核状态、驳回原因、补课候选 | 请假已截止、重复请假、审核中不可补课、请假驳回、候选课次过期、补课名额已满、提交失败 | 请假提交后必须先进入老师/教务审核；审核通过后才出现补课提醒和补课安排，不允许家长端绕过审核直接补课。 建议 Figma Frame：PAR-p07_补课申请_补课安排；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P08 合同列表 | 家长 | 展示合同编号、课程、金额、签署状态、缴费状态、有效期和待处理提醒 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p08_合同列表；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P09 合同详情 | 家长 | 查看合同文件、课程权益、缴费信息、签署人、企业盖章状态和合同操作入口 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p09_合同详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P10 报价 / 优惠明细 | 家长 | 展示报价方案、优惠金额、赠课、应付金额、优惠失效和确认入口 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p10_报价_优惠明细；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P11 电子合同签署 | 家长 | 阅读合同、确认签署、手写签名、签署回执和签署失败提示 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p11_电子合同签署；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P12 在线缴费 / 收银台 | 家长 | 展示支付方式、应缴金额、支付中、支付成功、支付失败和重新发起支付，不展示分期方案 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p12_在线缴费_收银台；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P13 退费咨询 / 线下办理指引 | 家长 | 展示退费规则说明、线下办理流程、材料清单、校区联系方式和受理后进度查询，不开放线上退费申请 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p13_退费咨询_线下办理指引；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P14 家校沟通首页 / 消息列表 | 家长 | 聚合课堂点评、作业批改、测评摘要、回访提醒、风险预警和服务消息 | 家长首页默认多孩子聚合展示，顶部展示孩子标签和待办总览，内容区按待办、课表、合同缴费、消息服务分组；绑定与监护认证采用独立页面 + 状态反馈。 | 绑定学员、提交监护关系、切换孩子标签、查看待办、进入课表、查看学员信息、联系人工 | 家长账号、学员姓名、关系类型、绑定手机号、认证状态、孩子标签、待办数量、课表摘要、服务提醒、手机号 | 监护关系未认证、认证失败、无绑定学员、重复绑定、学员状态异常、加载失败 | 多孩子家庭不做频繁全局切换，首页聚合展示并用孩子标签区分待办、课表和消息。 建议 Figma Frame：PAR-p14_家校沟通首页_消息列表；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P15 消息详情 | 家长 | 展示消息内容、关联学员、关联课程、已读状态、业务跳转和对象失效提示 | 家校沟通与服务采用消息列表承接课堂点评、作业批改、测评报告、回访和风险提醒；服务工单采用列表、提交、详情进度和关闭评价四段结构。 | 查看消息、标记已读、查看课堂点评、生成成长喜报、保存海报、分享海报、查看作业反馈、查看测评报告 | 消息类型、关联学员、关联课程、点评内容、课堂照片、海报模板、作业得分、测评摘要、工单类型、附件 | 消息对象失效、海报生成失败、附件预览失败、工单已关闭、转人工确认、提交失败、满意度已提交 | 成长喜报聚焦优秀课堂点评传播，支持保存图片和分享给家人；工单必须支持附件、处理进度、确认关闭和满意度评价。 建议 Figma Frame：PAR-p15_消息详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P16 课堂点评详情 | 家长 | 展示课堂表现、课堂照片、老师评语、反馈动作和成长喜报生成入口 | 家校沟通与服务采用消息列表承接课堂点评、作业批改、测评报告、回访和风险提醒；服务工单采用列表、提交、详情进度和关闭评价四段结构。 | 查看消息、标记已读、查看课堂点评、生成成长喜报、保存海报、分享海报、查看作业反馈、查看测评报告 | 消息类型、关联学员、关联课程、点评内容、课堂照片、海报模板、作业得分、测评摘要、工单类型、附件 | 消息对象失效、海报生成失败、附件预览失败、工单已关闭、转人工确认、提交失败、满意度已提交 | 成长喜报聚焦优秀课堂点评传播，支持保存图片和分享给家人；工单必须支持附件、处理进度、确认关闭和满意度评价。 建议 Figma Frame：PAR-p16_课堂点评详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P17 作业批改详情 | 家长 | 展示作业结果、得分、教师评语、订正要求和学员端继续学习提示 | 家校沟通与服务采用消息列表承接课堂点评、作业批改、测评报告、回访和风险提醒；服务工单采用列表、提交、详情进度和关闭评价四段结构。 | 查看消息、标记已读、查看课堂点评、生成成长喜报、保存海报、分享海报、查看作业反馈、查看测评报告 | 消息类型、关联学员、关联课程、点评内容、课堂照片、海报模板、作业得分、测评摘要、工单类型、附件 | 消息对象失效、海报生成失败、附件预览失败、工单已关闭、转人工确认、提交失败、满意度已提交 | 成长喜报聚焦优秀课堂点评传播，支持保存图片和分享给家人；工单必须支持附件、处理进度、确认关闭和满意度评价。 建议 Figma Frame：PAR-p17_作业批改详情；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P18 测评报告摘要 | 家长 | 展示能力维度、测评结果、趋势摘要、学习建议和报告生成状态 | 家校沟通与服务采用消息列表承接课堂点评、作业批改、测评报告、回访和风险提醒；服务工单采用列表、提交、详情进度和关闭评价四段结构。 | 查看消息、标记已读、查看课堂点评、生成成长喜报、保存海报、分享海报、查看作业反馈、查看测评报告 | 消息类型、关联学员、关联课程、点评内容、课堂照片、海报模板、作业得分、测评摘要、工单类型、附件 | 消息对象失效、海报生成失败、附件预览失败、工单已关闭、转人工确认、提交失败、满意度已提交 | 成长喜报聚焦优秀课堂点评传播，支持保存图片和分享给家人；工单必须支持附件、处理进度、确认关闭和满意度评价。 建议 Figma Frame：PAR-p18_测评报告摘要；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P19 服务回访记录 | 家长 | 展示回访内容、处理人、处理结果、跟进计划和服务归属 | 家校沟通与服务采用消息列表承接课堂点评、作业批改、测评报告、回访和风险提醒；服务工单采用列表、提交、详情进度和关闭评价四段结构。 | 查看消息、标记已读、查看课堂点评、生成成长喜报、保存海报、分享海报、查看作业反馈、查看测评报告 | 消息类型、关联学员、关联课程、点评内容、课堂照片、海报模板、作业得分、测评摘要、工单类型、附件 | 消息对象失效、海报生成失败、附件预览失败、工单已关闭、转人工确认、提交失败、满意度已提交 | 成长喜报聚焦优秀课堂点评传播，支持保存图片和分享给家人；工单必须支持附件、处理进度、确认关闭和满意度评价。 建议 Figma Frame：PAR-p19_服务回访记录；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P20 服务工单列表 | 家长 | 展示投诉建议、退费咨询、服务请求、工单状态、更新时间和处理进度 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p20_服务工单列表；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P21 工单提交 | 家长 | 填写问题类型、描述、附件、联系人和提交结果，支持保存失败重试 | 家长端使用移动端卡片流和底部主按钮，重要操作采用二次确认弹窗并展示处理进度。 | 绑定学员、查看课表、提交请假、确认补课、改期取消、缴费、签署合同、提交工单 | 绑定学员、课程、合同、应缴金额、请假课次、补课候选、服务工单、服务消息、手机号、验证码 | 绑定关系异常、补课候选过期、支付失败、合同签署失败、工单已关闭、消息发送失败 | 需覆盖微信小程序/H5 状态、合同缴费、补课候选确认、服务通知、工单进度和异常联系入口。 建议 Figma Frame：PAR-p21_工单提交；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | P22 工单详情 / 处理进度 | 家长 | 展示分派、处理中、待确认、已关闭、驳回、补充说明、确认关闭和满意度评价 | 家校沟通与服务采用消息列表承接课堂点评、作业批改、测评报告、回访和风险提醒；服务工单采用列表、提交、详情进度和关闭评价四段结构。 | 查看消息、标记已读、查看课堂点评、生成成长喜报、保存海报、分享海报、查看作业反馈、查看测评报告 | 消息类型、关联学员、关联课程、点评内容、课堂照片、海报模板、作业得分、测评摘要、工单类型、附件 | 消息对象失效、海报生成失败、附件预览失败、工单已关闭、转人工确认、提交失败、满意度已提交 | 成长喜报聚焦优秀课堂点评传播，支持保存图片和分享给家人；工单必须支持附件、处理进度、确认关闭和满意度评价。 建议 Figma Frame：PAR-p22_工单详情_处理进度；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S01 协议未勾选 / 验证码错误 | 家长 | 登录前置校验、协议未勾选、短信验证码错误、账号异常和重试提示 | 家长端登录采用移动端前置页，首屏只保留微信登录、手机号验证码登录、协议勾选和登录异常提示；验证码输入建议使用分格输入和倒计时重发。 | 微信登录、手机号验证码登录、勾选协议、重新发送验证码、进入家长首页、联系客服 | 手机号、短信验证码、验证码倒计时、微信授权状态、协议勾选、登录状态、账号异常原因、验证码、绑定学员、孩子标签 | 协议未勾选、验证码错误、验证码过期、账号停用、微信授权失败、手机号未绑定 | 家长端登录只解决家长身份进入，不承接员工端、学员端或后台管理登录。 建议 Figma Frame：PAR-s01_协议未勾选_验证码错误；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S02 多孩子切换抽屉 | 家长 | 按孩子筛选首页数据、临时切换课表/合同/消息上下文 | 家长首页默认多孩子聚合展示，顶部展示孩子标签和待办总览，内容区按待办、课表、合同缴费、消息服务分组；绑定与监护认证采用独立页面 + 状态反馈。 | 绑定学员、提交监护关系、切换孩子标签、查看待办、进入课表、查看学员信息、联系人工 | 家长账号、学员姓名、关系类型、绑定手机号、认证状态、孩子标签、待办数量、课表摘要、服务提醒、手机号 | 监护关系未认证、认证失败、无绑定学员、重复绑定、学员状态异常、加载失败 | 多孩子家庭不做频繁全局切换，首页聚合展示并用孩子标签区分待办、课表和消息。 建议 Figma Frame：PAR-s02_多孩子切换抽屉；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S03 到校 / 课消通知 | 家长 | 展示到校结果、课消结果、剩余课时变化和关联课次 | 课表页以日历和课次卡片为核心，课次详情适合底部抽屉；请假从课次详情发起，审核通过后再提醒补课，补课页自动带入原课次。 | 查看课表、展开课次详情、提交请假、撤回请假、查看审核结果、选择补课候选、确认补课、申请改期 | 课次日期、课程、教师、教室、签到状态、课消结果、请假原因、审核状态、驳回原因、补课候选 | 请假已截止、重复请假、审核中不可补课、请假驳回、候选课次过期、补课名额已满、提交失败 | 请假提交后必须先进入老师/教务审核；审核通过后才出现补课提醒和补课安排，不允许家长端绕过审核直接补课。 建议 Figma Frame：PAR-s03_到校_课消通知；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S04 课次详情抽屉 | 家长 | 从课表点击课次展开，展示签到、课消、教师、教室、剩余课时和请假入口 | 课表页以日历和课次卡片为核心，课次详情适合底部抽屉；请假从课次详情发起，审核通过后再提醒补课，补课页自动带入原课次。 | 查看课表、展开课次详情、提交请假、撤回请假、查看审核结果、选择补课候选、确认补课、申请改期 | 课次日期、课程、教师、教室、签到状态、课消结果、请假原因、审核状态、驳回原因、补课候选 | 请假已截止、重复请假、审核中不可补课、请假驳回、候选课次过期、补课名额已满、提交失败 | 请假提交后必须先进入老师/教务审核；审核通过后才出现补课提醒和补课安排，不允许家长端绕过审核直接补课。 建议 Figma Frame：PAR-s04_课次详情抽屉；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S05 请假申请抽屉 | 家长 | 填写请假原因和证明附件，提交后进入待审核，审核通过后提醒补课 | 课表页以日历和课次卡片为核心，课次详情适合底部抽屉；请假从课次详情发起，审核通过后再提醒补课，补课页自动带入原课次。 | 查看课表、展开课次详情、提交请假、撤回请假、查看审核结果、选择补课候选、确认补课、申请改期 | 课次日期、课程、教师、教室、签到状态、课消结果、请假原因、审核状态、驳回原因、补课候选 | 请假已截止、重复请假、审核中不可补课、请假驳回、候选课次过期、补课名额已满、提交失败 | 请假提交后必须先进入老师/教务审核；审核通过后才出现补课提醒和补课安排，不允许家长端绕过审核直接补课。 建议 Figma Frame：PAR-s05_请假申请抽屉；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S06 附件预览 | 家长 | 全屏预览图片、文件、证明材料、课堂照片和工单附件 | 家长端使用移动端卡片流和底部主按钮，重要操作采用二次确认弹窗并展示处理进度。 | 绑定学员、查看课表、提交请假、确认补课、改期取消、缴费、签署合同、提交工单 | 绑定学员、课程、合同、应缴金额、请假课次、补课候选、服务工单、服务消息、手机号、验证码 | 绑定关系异常、补课候选过期、支付失败、合同签署失败、工单已关闭、消息发送失败 | 需覆盖微信小程序/H5 状态、合同缴费、补课候选确认、服务通知、工单进度和异常联系入口。 建议 Figma Frame：PAR-s06_附件预览；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S07 工单关闭 / 转人工确认 | 家长 | 确认关闭、转人工、补充说明、取消操作和二次确认提示 | 家长端使用移动端卡片流和底部主按钮，重要操作采用二次确认弹窗并展示处理进度。 | 绑定学员、查看课表、提交请假、确认补课、改期取消、缴费、签署合同、提交工单 | 绑定学员、课程、合同、应缴金额、请假课次、补课候选、服务工单、服务消息、手机号、验证码 | 绑定关系异常、补课候选过期、支付失败、合同签署失败、工单已关闭、消息发送失败 | 需覆盖微信小程序/H5 状态、合同缴费、补课候选确认、服务通知、工单进度和异常联系入口。 建议 Figma Frame：PAR-s07_工单关闭_转人工确认；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S08 支付成功 / 失败 | 家长 | 展示支付完成、支付失败原因、重新发起、联系客服和返回合同入口 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-s08_支付成功_失败；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S09 监护关系未认证 | 家长 | 展示认证失败、联系人工、重新提交和无法访问学员数据原因 | 家长首页默认多孩子聚合展示，顶部展示孩子标签和待办总览，内容区按待办、课表、合同缴费、消息服务分组；绑定与监护认证采用独立页面 + 状态反馈。 | 绑定学员、提交监护关系、切换孩子标签、查看待办、进入课表、查看学员信息、联系人工 | 家长账号、学员姓名、关系类型、绑定手机号、认证状态、孩子标签、待办数量、课表摘要、服务提醒、手机号 | 监护关系未认证、认证失败、无绑定学员、重复绑定、学员状态异常、加载失败 | 多孩子家庭不做频繁全局切换，首页聚合展示并用孩子标签区分待办、课表和消息。 建议 Figma Frame：PAR-s09_监护关系未认证；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S10 合同待签署 | 家长 | 展示待处理提示、去签署、签署截止和返回首页 | 家长首页默认多孩子聚合展示，顶部展示孩子标签和待办总览，内容区按待办、课表、合同缴费、消息服务分组；绑定与监护认证采用独立页面 + 状态反馈。 | 绑定学员、提交监护关系、切换孩子标签、查看待办、进入课表、查看学员信息、联系人工 | 家长账号、学员姓名、关系类型、绑定手机号、认证状态、孩子标签、待办数量、课表摘要、服务提醒、手机号 | 监护关系未认证、认证失败、无绑定学员、重复绑定、学员状态异常、加载失败 | 多孩子家庭不做频繁全局切换，首页聚合展示并用孩子标签区分待办、课表和消息。 建议 Figma Frame：PAR-s10_合同待签署；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S11 无权限 / 加载失败 / 保存失败 | 家长 | 通用权限不足、加载异常、保存失败、重试和联系客服 | 家长端使用移动端卡片流和底部主按钮，重要操作采用二次确认弹窗并展示处理进度。 | 绑定学员、查看课表、提交请假、确认补课、改期取消、缴费、签署合同、提交工单 | 绑定学员、课程、合同、应缴金额、请假课次、补课候选、服务工单、服务消息、手机号、验证码 | 绑定关系异常、补课候选过期、支付失败、合同签署失败、工单已关闭、消息发送失败 | 需覆盖微信小程序/H5 状态、合同缴费、补课候选确认、服务通知、工单进度和异常联系入口。 建议 Figma Frame：PAR-s11_无权限_加载失败_保存失败；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S12 审批驳回 / 外部接口异常 / 批量部分失败 | 家长 | 展示原因说明、失败明细、重新提交、转人工和处理结果 | 家长端使用移动端卡片流和底部主按钮，重要操作采用二次确认弹窗并展示处理进度。 | 绑定学员、查看课表、提交请假、确认补课、改期取消、缴费、签署合同、提交工单 | 绑定学员、课程、合同、应缴金额、请假课次、补课候选、服务工单、服务消息、手机号、验证码 | 绑定关系异常、补课候选过期、支付失败、合同签署失败、工单已关闭、消息发送失败 | 需覆盖微信小程序/H5 状态、合同缴费、补课候选确认、服务通知、工单进度和异常联系入口。 建议 Figma Frame：PAR-s12_审批驳回_外部接口异常_批量部分失败；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/H5 | S13 成长喜报生成 / 海报预览 | 家长 | 展示课堂照片、老师优质评语、海报预览、保存图片、分享给家人和生成失败重试 | 家校沟通与服务采用消息列表承接课堂点评、作业批改、测评报告、回访和风险提醒；服务工单采用列表、提交、详情进度和关闭评价四段结构。 | 查看消息、标记已读、查看课堂点评、生成成长喜报、保存海报、分享海报、查看作业反馈、查看测评报告 | 消息类型、关联学员、关联课程、点评内容、课堂照片、海报模板、作业得分、测评摘要、工单类型、附件 | 消息对象失效、海报生成失败、附件预览失败、工单已关闭、转人工确认、提交失败、满意度已提交 | 成长喜报聚焦优秀课堂点评传播，支持保存图片和分享给家人；工单必须支持附件、处理进度、确认关闭和满意度评价。 建议 Figma Frame：PAR-s13_成长喜报生成_海报预览；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | P01-P22 | 家长 | 围绕前台范围收敛完善P01-P22的入口、字段、状态、异常提示、处理进度和验收反馈 | 家长端使用移动端卡片流和底部主按钮，重要操作采用二次确认弹窗并展示处理进度。 | 绑定学员、查看课表、提交请假、确认补课、改期取消、缴费、签署合同、提交工单 | 绑定学员、课程、合同、应缴金额、请假课次、补课候选、服务工单、服务消息、手机号、验证码 | 绑定关系异常、补课候选过期、支付失败、合同签署失败、工单已关闭、消息发送失败 | 需覆盖微信小程序/H5 状态、合同缴费、补课候选确认、服务通知、工单进度和异常联系入口。 建议 Figma Frame：PAR-p01_p22；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | S01-S13 | 家长 | 围绕前台范围收敛完善S01-S13的入口、字段、状态、异常提示、处理进度和验收反馈 | 家长端使用移动端卡片流和底部主按钮，重要操作采用二次确认弹窗并展示处理进度。 | 绑定学员、查看课表、提交请假、确认补课、改期取消、缴费、签署合同、提交工单 | 绑定学员、课程、合同、应缴金额、请假课次、补课候选、服务工单、服务消息、手机号、验证码 | 绑定关系异常、补课候选过期、支付失败、合同签署失败、工单已关闭、消息发送失败 | 需覆盖微信小程序/H5 状态、合同缴费、补课候选确认、服务通知、工单进度和异常联系入口。 建议 Figma Frame：PAR-s01_s13；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | P07 补课申请 | 家长 | 围绕请假补课完善P07 补课申请的入口、字段、状态、异常提示、处理进度和验收反馈 | 课表页以日历和课次卡片为核心，课次详情适合底部抽屉；请假从课次详情发起，审核通过后再提醒补课，补课页自动带入原课次。 | 查看课表、展开课次详情、提交请假、撤回请假、查看审核结果、选择补课候选、确认补课、申请改期 | 课次日期、课程、教师、教室、签到状态、课消结果、请假原因、审核状态、驳回原因、补课候选 | 请假已截止、重复请假、审核中不可补课、请假驳回、候选课次过期、补课名额已满、提交失败 | 请假提交后必须先进入老师/教务审核；审核通过后才出现补课提醒和补课安排，不允许家长端绕过审核直接补课。 建议 Figma Frame：PAR-p07_补课申请；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | 补课安排 | 家长 | 围绕请假补课完善补课安排的入口、字段、状态、异常提示、处理进度和验收反馈 | 课表页以日历和课次卡片为核心，课次详情适合底部抽屉；请假从课次详情发起，审核通过后再提醒补课，补课页自动带入原课次。 | 查看课表、展开课次详情、提交请假、撤回请假、查看审核结果、选择补课候选、确认补课、申请改期 | 课次日期、课程、教师、教室、签到状态、课消结果、请假原因、审核状态、驳回原因、补课候选 | 请假已截止、重复请假、审核中不可补课、请假驳回、候选课次过期、补课名额已满、提交失败 | 请假提交后必须先进入老师/教务审核；审核通过后才出现补课提醒和补课安排，不允许家长端绕过审核直接补课。 建议 Figma Frame：PAR-补课安排；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | P08-P12 | 家长 | 围绕合同缴费完善P08-P12的入口、字段、状态、异常提示、处理进度和验收反馈 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p08_p12；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | S08 | 家长 | 围绕合同缴费完善S08的入口、字段、状态、异常提示、处理进度和验收反馈 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-s08；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | S10 | 家长 | 围绕合同缴费完善S10的入口、字段、状态、异常提示、处理进度和验收反馈 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-s10；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | P13 退费咨询 | 家长 | 围绕退费咨询完善P13 退费咨询的入口、字段、状态、异常提示、处理进度和验收反馈 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p13_退费咨询；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | 线下办理指引 | 家长 | 围绕退费咨询完善线下办理指引的入口、字段、状态、异常提示、处理进度和验收反馈 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-线下办理指引；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | P20-P22 工单 | 家长 | 围绕退费咨询完善P20-P22 工单的入口、字段、状态、异常提示、处理进度和验收反馈 | 合同缴费链路分为合同列表、合同详情、报价优惠、电子合同签署、在线缴费/收银台、支付结果和退费咨询；金额类信息需要清晰展示应付、优惠、赠课和支付状态。 | 查看合同、查看报价、查看优惠明细、手写签署、确认支付、重新支付、查看支付结果、查看退费指引 | 合同编号、课程权益、报价方案、优惠金额、赠课、应付金额、签署状态、支付方式、支付状态、校区联系方式 | 合同待签署、未签署不可支付、支付失败、支付中、合同已过期、优惠已失效、退费仅线下办理 | 家长端明确不支持分期付款，不展示发票申请、开票记录、发票抬头；退费仅提供咨询和线下办理指引，不提供线上退费申请。 建议 Figma Frame：PAR-p20_p22_工单；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | S13 成长喜报生成 | 家长 | 围绕成长喜报完善S13 成长喜报生成的入口、字段、状态、异常提示、处理进度和验收反馈 | 家校沟通与服务采用消息列表承接课堂点评、作业批改、测评报告、回访和风险提醒；服务工单采用列表、提交、详情进度和关闭评价四段结构。 | 查看消息、标记已读、查看课堂点评、生成成长喜报、保存海报、分享海报、查看作业反馈、查看测评报告 | 消息类型、关联学员、关联课程、点评内容、课堂照片、海报模板、作业得分、测评摘要、工单类型、附件 | 消息对象失效、海报生成失败、附件预览失败、工单已关闭、转人工确认、提交失败、满意度已提交 | 成长喜报聚焦优秀课堂点评传播，支持保存图片和分享给家人；工单必须支持附件、处理进度、确认关闭和满意度评价。 建议 Figma Frame：PAR-s13_成长喜报生成；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
| 家长端小程序/App/H5 | 海报预览 | 家长 | 围绕成长喜报完善海报预览的入口、字段、状态、异常提示、处理进度和验收反馈 | 家校沟通与服务采用消息列表承接课堂点评、作业批改、测评报告、回访和风险提醒；服务工单采用列表、提交、详情进度和关闭评价四段结构。 | 查看消息、标记已读、查看课堂点评、生成成长喜报、保存海报、分享海报、查看作业反馈、查看测评报告 | 消息类型、关联学员、关联课程、点评内容、课堂照片、海报模板、作业得分、测评摘要、工单类型、附件 | 消息对象失效、海报生成失败、附件预览失败、工单已关闭、转人工确认、提交失败、满意度已提交 | 成长喜报聚焦优秀课堂点评传播，支持保存图片和分享给家人；工单必须支持附件、处理进度、确认关闭和满意度评价。 建议 Figma Frame：PAR-海报预览；需补齐正常、空态、加载、无权限、处理中、成功和失败状态。 |
09 · 页面到接口的前后端闭环矩阵
把原型页面、后端接口、数据对象、状态和消息审批绑定到一起
设计原型时，每个关键页面必须能解释前端展示什么、后端提交什么、状态怎么变、异常怎么处理。| 原型页面 | 关键接口 | 关联对象 | 状态流 | 审批/权限触发 | 消息/待办触达 | 原型验收要求 |
|---|---|---|---|---|---|---|
| P01 登录方式选择 | POST /api/v1/parent/auth/sms-login | GuardianAccount | 未登录 -> 协议未勾选 -> 验证码发送中 -> 验证码错误 -> 登录中 -> 登录成功 -> 账号异常 -> 需绑定学员 | 监护关系人工认证：家长绑定学员失败、关系证明无法自动校验或疑似冒用 | 登录与绑定状态提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P02 手机号验证码登录 | GET /api/v1/parent/lesson-detail/{lessonId} | ParentLoginSession | 未绑定 -> 待认证 -> 认证中 -> 已认证 -> 认证失败 -> 已解绑 -> 转人工 | 服务工单转人工：投诉建议、退费咨询或服务请求需要升级到人工服务 | 补课安排提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P03 家长首页 / 多孩子聚合看板 | POST/GET /api/v1/parent/refund-consultations | ParentStudentBinding | 全部孩子聚合 -> 按孩子筛选 -> 无待办 -> 加载失败 -> 数据过期 -> 需重新同步 | 工单关闭确认：服务工单处理完成后需家长确认关闭并评价 | 合同签署缴费提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P04 学员绑定 / 监护关系认证 | POST /api/v1/parent/auth/sms-login | ParentHomeDashboardSnapshot | 可申请 -> 草稿 -> 已提交 -> 老师/教务审核中 -> 审核通过 -> 审核驳回 -> 已撤回 -> 已关闭 | 监护关系人工认证：家长绑定学员失败、关系证明无法自动校验或疑似冒用 | 退费咨询处理提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P05 家庭 / 学员信息详情 | GET /api/v1/parent/lesson-detail/{lessonId} | ParentServiceProfile | 待安排 -> 待家长确认 -> 已确认 -> 候选过期 -> 改期申请中 -> 已取消 -> 已完成 -> 异常待处理 | 服务工单转人工：投诉建议、退费咨询或服务请求需要升级到人工服务 | 成长喜报生成提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P06 课表与课次服务 | POST/GET /api/v1/parent/refund-consultations | ParentLeaveRequest | 待查看 -> 待签署 -> 已签署 -> 待支付 -> 支付中 -> 支付成功 -> 支付失败 -> 企业盖章中 -> 已盖章 -> 已关闭 | 工单关闭确认：服务工单处理完成后需家长确认关闭并评价 | 登录与绑定状态提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P07 补课申请 / 补课安排 | POST /api/v1/parent/auth/sms-login | ParentMakeupConfirmation | 未咨询 -> 咨询草稿 -> 已提交 -> 服务处理中 -> 需补充材料 -> 已转线下办理 -> 已关闭 | 监护关系人工认证：家长绑定学员失败、关系证明无法自动校验或疑似冒用 | 补课安排提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P08 合同列表 | GET /api/v1/parent/lesson-detail/{lessonId} | ParentPaymentRequest | 待生成 -> 生成中 -> 生成成功 -> 生成失败 -> 已保存 -> 已分享 | 服务工单转人工：投诉建议、退费咨询或服务请求需要升级到人工服务 | 合同签署缴费提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P09 合同详情 | POST/GET /api/v1/parent/refund-consultations | ParentContractAction | 草稿 -> 已提交 -> 已分派 -> 处理中 -> 待家长确认 -> 已补充 -> 已关闭 -> 已评价 -> 已驳回 -> 转人工 | 工单关闭确认：服务工单处理完成后需家长确认关闭并评价 | 退费咨询处理提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P10 报价 / 优惠明细 | POST /api/v1/parent/auth/sms-login | ParentRefundConsultation | 未登录 -> 协议未勾选 -> 验证码发送中 -> 验证码错误 -> 登录中 -> 登录成功 -> 账号异常 -> 需绑定学员 | 监护关系人工认证：家长绑定学员失败、关系证明无法自动校验或疑似冒用 | 成长喜报生成提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P11 电子合同签署 | GET /api/v1/parent/lesson-detail/{lessonId} | ParentNotificationRecord | 未绑定 -> 待认证 -> 认证中 -> 已认证 -> 认证失败 -> 已解绑 -> 转人工 | 服务工单转人工：投诉建议、退费咨询或服务请求需要升级到人工服务 | 登录与绑定状态提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
| P12 在线缴费 / 收银台 | POST/GET /api/v1/parent/refund-consultations | GrowthPoster | 全部孩子聚合 -> 按孩子筛选 -> 无待办 -> 加载失败 -> 数据过期 -> 需重新同步 | 工单关闭确认：服务工单处理完成后需家长确认关闭并评价 | 补课安排提醒 -> 家长 | 原型需展示入口、主按钮、禁用原因、提交中、成功、失败、无权限、空状态和异常转人工入口 |
10 · 原型、UI、研发、测试交付补充
把关键闭环补强为下一阶段可执行任务
本章节为正式 PRD 的交付要求，面向原型图、UI、开发、联调和测试分工。| 能力域 | 功能补充要求 | 原型交付要求 | UI 交互要求 | 研发实现要求 | 测试验收要求 |
|---|---|---|---|---|---|
| 前台范围收敛 | 明确家长端只做前台可落地体验：登录绑定、多孩子首页、课表请假补课、合同签署缴费、家校沟通、成长喜报和服务工单。 | P01-P22、S01-S13 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。 | UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。 | 后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。 | 测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；第 09 模块不出现发票申请、分期付款、人脸采集授权和线上退费申请入口。 |
| 请假补课 | 请假从课次详情发起，提交后进入老师/教务审核；审核通过后再提醒补课并自动带入原课次。 | P06 课表与课次服务、P07 补课申请 / 补课安排、S05 请假申请抽屉 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。 | UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。 | 后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。 | 测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；家长端可看到请假审核状态、驳回原因、补课候选、确认截止和处理结果。 |
| 合同缴费 | 补齐合同列表、合同详情、报价优惠、电子签署、在线缴费、支付成功/失败和已盖章合同查看；收银台不展示分期方案。 | P08-P12、S08、S10 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。 | UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。 | 后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。 | 测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；家长端金额展示与合同中心一致，支付前校验签署状态，支付失败可重试。 |
| 退费咨询 | 退费改为咨询和线下办理指引，展示规则、材料清单、校区联系方式、服务工单入口和受理后进度查询。 | P13 退费咨询 / 线下办理指引、P20-P22 工单 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。 | UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。 | 后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。 | 测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；家长端不能发起线上退款审批，只能提交退费咨询或服务工单。 |
| 成长喜报 | 课堂点评详情新增成长喜报生成入口，支持课堂照片、老师评语、海报预览、保存图片、分享给家人和生成失败重试。 | P16 课堂点评详情、S13 成长喜报生成 / 海报预览 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。 | UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。 | 后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。 | 测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；优秀点评能生成海报，生成、保存和分享动作可追踪。 |
| 服务工单闭环 | 补齐工单列表、提交、详情进度、补充说明、转人工确认、确认关闭和满意度评价。 | P20-P22、S06、S07 需要在原型中拆到列表、详情、表单、弹窗、空状态、失败态、无权限态和处理进度。 | UI 需清晰呈现状态标签、流程节点、主次按钮、危险操作确认、移动/平板/TV 适配和错误提示；PC 管理端遵循统一框架，仅输出信息架构和交互说明。 | 后端需提供接口幂等、权限校验、状态机、审计日志、消息/审批触发、异步补偿和跨模块数据一致性保障。 | 测试需覆盖主流程、异常流、权限流、重复提交、批量部分失败和数据一致性；工单从提交到关闭有处理记录，关闭后可评价且不可重复评价。 |
11 · 数据对象与字段字典
明确页面、接口、数据库共同使用的数据语言
字段涉及敏感、人脸、财务、绩效时，原型需体现脱敏、授权和审计。核心对象
| 对象 | 说明 |
|---|---|
| GuardianAccount | 家长端账号；落地表：par_guardian_account |
| ParentLoginSession | 家长端登录会话；落地表：par_login_session |
| ParentStudentBinding | 家长与学员绑定关系；落地表：par_student_binding |
| ParentHomeDashboardSnapshot | 多孩子首页聚合快照；落地表：par_home_dashboard_snapshot |
| ParentServiceProfile | 家长服务档案；落地表：par_service_profile |
| ParentLeaveRequest | 家长端请假入口；落地表：par_leave_request |
| ParentMakeupConfirmation | 补课安排家长确认；落地表：par_makeup_confirmation |
| ParentPaymentRequest | 家长端缴费请求；落地表：par_payment_request |
| ParentContractAction | 家长合同查看签署与支付操作；落地表：par_contract_action |
| ParentRefundConsultation | 退费咨询与线下办理指引；落地表：par_refund_consultation |
| ParentNotificationRecord | 家长端通知触达；落地表：par_notification_record |
| GrowthPoster | 成长喜报海报；落地表：par_growth_poster |
| ParentServiceTicket | 家长端服务工单；落地表：par_service_ticket |
| ParentSatisfactionFeedback | 家长服务满意度评价；落地表：par_satisfaction_feedback |
关联引用对象
| 对象 | 说明 |
|---|---|
| Organization | 集团、区域、校区、部门组织树；引用来源：FND / sys_organization |
| User/Employee | 统一登录账号；引用来源：FND / sys_user |
| Employee | 员工基础档案；引用来源：FND / sys_employee |
| Role | 角色定义；引用来源：FND / sys_role |
| ApprovalFlow | 审批流配置；引用来源：FND / sys_approval_flow |
| MessageTemplate | 消息模板与多端触达配置；引用来源：FND / sys_message_template |
| AuditLog | 全平台操作审计日志；引用来源：FND / sys_audit_log |
| IntegrationLog | 接口调用日志；引用来源：OPEN / int_integration_log |
| SensitiveFieldPolicy | 敏感字段脱敏策略；引用来源：SEC / sec_sensitive_field_policy |
| Guardian | 监护人/家长资料；引用来源：CRM / crm_guardian |
| Student | 学员基础档案；引用来源：CRM / stu_student |
| Schedule/Lesson | 课次和排课；引用来源：EDU / edu_lesson |
| Attendance | 上课签到记录；引用来源：EDU / edu_attendance |
| Consumption | 课消记录；引用来源：EDU / edu_consumption |
| LeaveRequest | 学员请假申请；引用来源：EDU / edu_leave_request |
| MakeupArrangement | 补课安排兜底入口；引用来源：EDU / edu_makeup_arrangement |
| HomeworkReview | 作业批改与点评；引用来源：EDU / edu_homework_review |
| GrowthRecord | 学习成长档案；引用来源：EDU / edu_growth_record |
| Contract | 合同主表；引用来源：CON / con_contract |
| Order | 订单和应收；引用来源：CON / ord_order |
| Payment | 收款单；引用来源：CON / ord_payment |
完整字段字典
| 对象 | 字段 | 类型 | 必填 | 规则 | 数据级别 |
|---|---|---|---|---|---|
| GuardianAccount | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| GuardianAccount | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| GuardianAccount | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| GuardianAccount | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| GuardianAccount | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| GuardianAccount | created_at | DATETIME | 是 | 创建时间 | 普通 |
| GuardianAccount | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| GuardianAccount | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| GuardianAccount | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| GuardianAccount | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| GuardianAccount | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| GuardianAccount | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| GuardianAccount | account_no | VARCHAR(64) | 是 | 家长账号编号，唯一 | 普通 |
| GuardianAccount | guardian_id | BIGINT | 是 | 监护人 ID | 普通 |
| GuardianAccount | mobile | VARCHAR(32) | 是 | 手机号，敏感 | 敏感 |
| GuardianAccount | wechat_openid | VARCHAR(128) | 否 | 微信 OpenID，敏感 | 敏感 |
| GuardianAccount | agreement_version | VARCHAR(32) | 否 | 最近一次勾选的用户协议/隐私政策版本 | 普通 |
| GuardianAccount | last_login_channel | VARCHAR(32) | 否 | 最近登录方式：微信/手机号验证码 | 普通 |
| GuardianAccount | bind_status | VARCHAR(32) | 是 | 待绑定/已绑定/已解绑/停用 | 普通 |
| GuardianAccount | notification_preference | JSON | 否 | 消息偏好 | 普通 |
| ParentLoginSession | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentLoginSession | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentLoginSession | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentLoginSession | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentLoginSession | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentLoginSession | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentLoginSession | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentLoginSession | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentLoginSession | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentLoginSession | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentLoginSession | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentLoginSession | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentLoginSession | guardian_account_id | BIGINT | 否 | 家长账号 ID，未完成登录时可为空 | 普通 |
| ParentLoginSession | login_channel | VARCHAR(32) | 是 | 微信登录/手机号验证码登录 | 普通 |
| ParentLoginSession | mobile | VARCHAR(32) | 否 | 登录手机号，敏感 | 敏感 |
| ParentLoginSession | sms_verify_id | VARCHAR(64) | 否 | 短信校验流水，不存储明文验证码 | 普通 |
| ParentLoginSession | wechat_openid | VARCHAR(128) | 否 | 微信 OpenID，敏感 | 敏感 |
| ParentLoginSession | agreement_accepted | TINYINT | 是 | 是否已勾选协议 | 普通 |
| ParentLoginSession | login_status | VARCHAR(32) | 是 | 待校验/成功/验证码错误/协议未勾选/账号异常 | 普通 |
| ParentLoginSession | client_type | VARCHAR(32) | 是 | 微信小程序/H5 | 普通 |
| ParentLoginSession | login_at | DATETIME | 否 | 登录成功时间 | 普通 |
| ParentStudentBinding | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentStudentBinding | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentStudentBinding | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentStudentBinding | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentStudentBinding | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentStudentBinding | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentStudentBinding | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentStudentBinding | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentStudentBinding | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentStudentBinding | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentStudentBinding | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentStudentBinding | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentStudentBinding | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentStudentBinding | student_id | BIGINT | 是 | 学员 ID | 普通 |
| ParentStudentBinding | relationship | VARCHAR(32) | 是 | 关系 | 普通 |
| ParentStudentBinding | verify_material_ids | JSON | 否 | 监护关系证明材料文件 ID | 普通 |
| ParentStudentBinding | verify_status | VARCHAR(32) | 是 | 待验证/已验证/已拒绝/已解绑 | 普通 |
| ParentStudentBinding | reject_reason | VARCHAR(512) | 否 | 认证失败原因 | 普通 |
| ParentStudentBinding | unbind_at | DATETIME | 否 | 解绑时间 | 普通 |
| ParentHomeDashboardSnapshot | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentHomeDashboardSnapshot | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentHomeDashboardSnapshot | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentHomeDashboardSnapshot | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentHomeDashboardSnapshot | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentHomeDashboardSnapshot | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentHomeDashboardSnapshot | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentHomeDashboardSnapshot | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentHomeDashboardSnapshot | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentHomeDashboardSnapshot | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentHomeDashboardSnapshot | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentHomeDashboardSnapshot | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentHomeDashboardSnapshot | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentHomeDashboardSnapshot | snapshot_date | DATE | 是 | 快照日期 | 普通 |
| ParentHomeDashboardSnapshot | child_scope | JSON | 是 | 本次聚合的学员 ID 列表 | 普通 |
| ParentHomeDashboardSnapshot | todo_summary | JSON | 否 | 待办汇总，含课程、合同、补课、工单和消息 | 普通 |
| ParentHomeDashboardSnapshot | schedule_summary | JSON | 否 | 课表摘要 | 普通 |
| ParentHomeDashboardSnapshot | payment_summary | JSON | 否 | 合同缴费摘要 | 普通 |
| ParentHomeDashboardSnapshot | message_summary | JSON | 否 | 消息摘要 | 普通 |
| ParentHomeDashboardSnapshot | snapshot_status | VARCHAR(32) | 是 | 正常/刷新中/刷新失败/数据过期 | 普通 |
| ParentServiceProfile | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentServiceProfile | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentServiceProfile | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentServiceProfile | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentServiceProfile | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentServiceProfile | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentServiceProfile | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentServiceProfile | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentServiceProfile | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentServiceProfile | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentServiceProfile | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentServiceProfile | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentServiceProfile | student_id | BIGINT | 是 | 学员 ID | 普通 |
| ParentServiceProfile | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentServiceProfile | service_owner_id | BIGINT | 否 | 班主任/学管师 ID | 普通 |
| ParentServiceProfile | communication_tags | JSON | 否 | 沟通偏好标签 | 普通 |
| ParentServiceProfile | risk_level | VARCHAR(32) | 否 | 服务风险等级 | 普通 |
| ParentServiceProfile | last_service_at | DATETIME | 否 | 最近服务时间 | 普通 |
| ParentLeaveRequest | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentLeaveRequest | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentLeaveRequest | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentLeaveRequest | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentLeaveRequest | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentLeaveRequest | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentLeaveRequest | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentLeaveRequest | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentLeaveRequest | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentLeaveRequest | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentLeaveRequest | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentLeaveRequest | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentLeaveRequest | leave_request_id | BIGINT | 是 | 教务请假单 ID | 普通 |
| ParentLeaveRequest | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentLeaveRequest | student_id | BIGINT | 是 | 学员 ID | 普通 |
| ParentLeaveRequest | lesson_id | BIGINT | 是 | 课次 ID | 普通 |
| ParentLeaveRequest | submit_channel | VARCHAR(32) | 是 | 小程序/H5/App | 普通 |
| ParentLeaveRequest | visible_status | VARCHAR(32) | 是 | 待审核/已通过/已驳回/已撤销 | 普通 |
| ParentLeaveRequest | reject_reason | VARCHAR(512) | 否 | 驳回原因 | 普通 |
| ParentLeaveRequest | makeup_notice_status | VARCHAR(32) | 否 | 无需补课/待生成/已提醒/已过期 | 普通 |
| ParentLeaveRequest | file_ids | JSON | 否 | 附件文件 ID 列表，文件中心统一管理 | 普通 |
| ParentLeaveRequest | evidence_snapshot | JSON | 否 | 关键凭据快照，提交后不可直接覆盖 | 普通 |
| ParentMakeupConfirmation | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentMakeupConfirmation | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentMakeupConfirmation | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentMakeupConfirmation | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentMakeupConfirmation | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentMakeupConfirmation | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentMakeupConfirmation | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentMakeupConfirmation | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentMakeupConfirmation | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentMakeupConfirmation | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentMakeupConfirmation | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentMakeupConfirmation | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentMakeupConfirmation | arrangement_id | BIGINT | 是 | 教务补课安排 ID | 普通 |
| ParentMakeupConfirmation | leave_request_id | BIGINT | 是 | 关联请假单 ID | 普通 |
| ParentMakeupConfirmation | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentMakeupConfirmation | student_id | BIGINT | 是 | 学员 ID | 普通 |
| ParentMakeupConfirmation | source_lesson_id | BIGINT | 是 | 原课次 ID | 普通 |
| ParentMakeupConfirmation | candidate_lessons | JSON | 否 | 候选补课课次 | 普通 |
| ParentMakeupConfirmation | confirm_deadline | DATETIME | 否 | 确认截止时间 | 普通 |
| ParentMakeupConfirmation | confirm_status | VARCHAR(32) | 是 | 待确认/已确认/改期申请中/已取消/已过期/已完成 | 普通 |
| ParentMakeupConfirmation | confirm_result | JSON | 否 | 确认结果，含选择课次、原因和处理说明 | 普通 |
| ParentPaymentRequest | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentPaymentRequest | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentPaymentRequest | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentPaymentRequest | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentPaymentRequest | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentPaymentRequest | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentPaymentRequest | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentPaymentRequest | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentPaymentRequest | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentPaymentRequest | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentPaymentRequest | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentPaymentRequest | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentPaymentRequest | payment_request_no | VARCHAR(64) | 是 | 缴费请求编号，唯一 | 普通 |
| ParentPaymentRequest | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentPaymentRequest | student_id | BIGINT | 是 | 学员 ID | 普通 |
| ParentPaymentRequest | order_id | BIGINT | 是 | 订单 ID | 普通 |
| ParentPaymentRequest | contract_id | BIGINT | 否 | 合同 ID | 普通 |
| ParentPaymentRequest | hand_sign_status | VARCHAR(32) | 是 | 待签署/已签署/签署失败 | 普通 |
| ParentPaymentRequest | pay_amount | DECIMAL(18,2) | 是 | 支付金额 | 普通 |
| ParentPaymentRequest | discount_summary | JSON | 否 | 优惠和赠课摘要 | 普通 |
| ParentPaymentRequest | pay_channel | VARCHAR(32) | 否 | 支付渠道 | 普通 |
| ParentPaymentRequest | request_status | VARCHAR(32) | 是 | 待支付/支付中/成功/失败/关闭 | 普通 |
| ParentContractAction | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentContractAction | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentContractAction | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentContractAction | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentContractAction | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentContractAction | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentContractAction | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentContractAction | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentContractAction | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentContractAction | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentContractAction | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentContractAction | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentContractAction | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentContractAction | student_id | BIGINT | 是 | 学员 ID | 普通 |
| ParentContractAction | contract_id | BIGINT | 是 | 合同 ID | 普通 |
| ParentContractAction | action_type | VARCHAR(32) | 是 | 查看/手写签署/发起支付/下载已盖章合同 | 普通 |
| ParentContractAction | action_status | VARCHAR(32) | 是 | 待处理/成功/失败/已关闭 | 普通 |
| ParentContractAction | sign_file_id | BIGINT | 否 | 手写签署文件 ID | 普通 |
| ParentContractAction | payment_no | VARCHAR(64) | 否 | 支付流水号 | 普通 |
| ParentContractAction | sealed_file_id | BIGINT | 否 | 已盖章合同文件 ID | 普通 |
| ParentRefundConsultation | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentRefundConsultation | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentRefundConsultation | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentRefundConsultation | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentRefundConsultation | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentRefundConsultation | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentRefundConsultation | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentRefundConsultation | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentRefundConsultation | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentRefundConsultation | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentRefundConsultation | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentRefundConsultation | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentRefundConsultation | consultation_no | VARCHAR(64) | 是 | 咨询单编号，唯一 | 普通 |
| ParentRefundConsultation | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentRefundConsultation | student_id | BIGINT | 是 | 学员 ID | 普通 |
| ParentRefundConsultation | contract_id | BIGINT | 否 | 关联合同 ID | 普通 |
| ParentRefundConsultation | consult_type | VARCHAR(32) | 是 | 退费规则咨询/材料咨询/进度咨询/其他 | 普通 |
| ParentRefundConsultation | guide_snapshot | JSON | 否 | 线下办理规则、材料清单和校区联系方式快照 | 普通 |
| ParentRefundConsultation | service_ticket_id | BIGINT | 否 | 关联服务工单 ID | 普通 |
| ParentRefundConsultation | consult_status | VARCHAR(32) | 是 | 草稿/已提交/处理中/需补充/已转线下办理/已关闭 | 普通 |
| ParentNotificationRecord | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentNotificationRecord | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentNotificationRecord | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentNotificationRecord | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentNotificationRecord | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentNotificationRecord | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentNotificationRecord | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentNotificationRecord | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentNotificationRecord | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentNotificationRecord | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentNotificationRecord | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentNotificationRecord | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentNotificationRecord | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentNotificationRecord | student_id | BIGINT | 否 | 学员 ID | 普通 |
| ParentNotificationRecord | template_code | VARCHAR(64) | 是 | 消息模板 | 普通 |
| ParentNotificationRecord | channel | VARCHAR(32) | 是 | 小程序/短信/Push/H5 | 普通 |
| ParentNotificationRecord | send_status | VARCHAR(32) | 是 | 待发送/成功/失败/已读 | 普通 |
| ParentNotificationRecord | biz_ref | VARCHAR(128) | 否 | 关联业务编号 | 普通 |
| GrowthPoster | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| GrowthPoster | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| GrowthPoster | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| GrowthPoster | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| GrowthPoster | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| GrowthPoster | created_at | DATETIME | 是 | 创建时间 | 普通 |
| GrowthPoster | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| GrowthPoster | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| GrowthPoster | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| GrowthPoster | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| GrowthPoster | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| GrowthPoster | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| GrowthPoster | poster_no | VARCHAR(64) | 是 | 海报编号，唯一 | 普通 |
| GrowthPoster | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| GrowthPoster | student_id | BIGINT | 是 | 学员 ID | 普通 |
| GrowthPoster | lesson_comment_id | BIGINT | 是 | 课堂点评 ID | 普通 |
| GrowthPoster | poster_template_id | BIGINT | 否 | 海报模板 ID | 普通 |
| GrowthPoster | poster_file_id | BIGINT | 否 | 生成后的海报文件 ID | 普通 |
| GrowthPoster | poster_status | VARCHAR(32) | 是 | 待生成/生成中/成功/失败/已保存/已分享 | 普通 |
| GrowthPoster | share_count | INT | 是 | 分享次数 | 普通 |
| ParentServiceTicket | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentServiceTicket | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentServiceTicket | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentServiceTicket | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentServiceTicket | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentServiceTicket | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentServiceTicket | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentServiceTicket | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentServiceTicket | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentServiceTicket | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentServiceTicket | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentServiceTicket | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentServiceTicket | ticket_no | VARCHAR(64) | 是 | 工单编号，唯一 | 普通 |
| ParentServiceTicket | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentServiceTicket | student_id | BIGINT | 否 | 关联学员 ID | 普通 |
| ParentServiceTicket | ticket_type | VARCHAR(32) | 是 | 投诉建议/退费咨询/服务请求/其他 | 普通 |
| ParentServiceTicket | content | TEXT | 是 | 工单描述 | 普通 |
| ParentServiceTicket | contact_mobile | VARCHAR(32) | 否 | 联系人手机号，敏感 | 敏感 |
| ParentServiceTicket | ticket_status | VARCHAR(32) | 是 | 草稿/已提交/已分派/处理中/待家长确认/已关闭/已驳回/转人工 | 普通 |
| ParentServiceTicket | owner_id | BIGINT | 否 | 当前处理人 | 普通 |
| ParentServiceTicket | file_ids | JSON | 否 | 附件文件 ID 列表，文件中心统一管理 | 普通 |
| ParentServiceTicket | evidence_snapshot | JSON | 否 | 关键凭据快照，提交后不可直接覆盖 | 普通 |
| ParentSatisfactionFeedback | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ParentSatisfactionFeedback | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ParentSatisfactionFeedback | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ParentSatisfactionFeedback | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ParentSatisfactionFeedback | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ParentSatisfactionFeedback | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ParentSatisfactionFeedback | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ParentSatisfactionFeedback | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ParentSatisfactionFeedback | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ParentSatisfactionFeedback | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ParentSatisfactionFeedback | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ParentSatisfactionFeedback | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ParentSatisfactionFeedback | ticket_id | BIGINT | 是 | 服务工单 ID | 普通 |
| ParentSatisfactionFeedback | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| ParentSatisfactionFeedback | score | INT | 是 | 满意度评分 1-5 | 普通 |
| ParentSatisfactionFeedback | feedback_content | VARCHAR(512) | 否 | 评价内容 | 普通 |
| ParentSatisfactionFeedback | feedback_status | VARCHAR(32) | 是 | 待提交/已提交/已撤回 | 普通 |
| ParentSatisfactionFeedback | submitted_at | DATETIME | 否 | 提交时间 | 普通 |
引用对象字段字典
| 引用表 | 对象 | 字段 | 类型 | 必填 | 规则 | 数据级别 |
|---|---|---|---|---|---|---|
| sys_organization | Organization | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_organization | Organization | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_organization | Organization | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_organization | Organization | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_organization | Organization | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_organization | Organization | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_organization | Organization | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_organization | Organization | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_organization | Organization | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_organization | Organization | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_organization | Organization | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_organization | Organization | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_organization | Organization | org_code | VARCHAR(64) | 是 | 组织编码，租户内唯一 | 普通 |
| sys_organization | Organization | org_name | VARCHAR(128) | 是 | 组织名称 | 普通 |
| sys_organization | Organization | org_type | VARCHAR(32) | 是 | 集团/区域/校区/部门/法人主体 | 普通 |
| sys_organization | Organization | parent_id | BIGINT | 否 | 上级组织 ID，根节点为空 | 普通 |
| sys_organization | Organization | sort_no | INT | 否 | 同级排序 | 普通 |
| sys_organization | Organization | enabled | TINYINT | 是 | 是否启用 | 普通 |
| sys_user | User/Employee | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_user | User/Employee | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_user | User/Employee | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_user | User/Employee | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_user | User/Employee | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_user | User/Employee | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_user | User/Employee | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_user | User/Employee | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_user | User/Employee | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_user | User/Employee | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_user | User/Employee | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_user | User/Employee | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_user | User/Employee | user_no | VARCHAR(64) | 是 | 账号编号，唯一 | 普通 |
| sys_user | User/Employee | login_name | VARCHAR(64) | 是 | 登录名，唯一 | 普通 |
| sys_user | User/Employee | mobile | VARCHAR(32) | 否 | 手机号，敏感脱敏展示 | 敏感 |
| sys_user | User/Employee | password_hash | VARCHAR(255) | 否 | 密码哈希，禁止前端返回 | 高敏 |
| sys_user | User/Employee | user_type | VARCHAR(32) | 是 | 员工/学员/家长/外部账号 | 普通 |
| sys_user | User/Employee | login_status | VARCHAR(32) | 是 | 正常/锁定/停用/待激活 | 普通 |
| sys_employee | Employee | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_employee | Employee | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_employee | Employee | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_employee | Employee | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_employee | Employee | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_employee | Employee | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_employee | Employee | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_employee | Employee | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_employee | Employee | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_employee | Employee | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_employee | Employee | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_employee | Employee | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_employee | Employee | employee_no | VARCHAR(64) | 是 | 工号，唯一 | 普通 |
| sys_employee | Employee | user_id | BIGINT | 否 | 关联账号 ID | 普通 |
| sys_employee | Employee | employee_name | VARCHAR(64) | 是 | 员工姓名 | 普通 |
| sys_employee | Employee | primary_campus_id | BIGINT | 否 | 主校区 ID | 普通 |
| sys_employee | Employee | job_title | VARCHAR(64) | 否 | 岗位名称 | 普通 |
| sys_employee | Employee | hire_status | VARCHAR(32) | 是 | 在职/试用/离职/停用 | 普通 |
| sys_role | Role | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_role | Role | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_role | Role | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_role | Role | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_role | Role | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_role | Role | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_role | Role | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_role | Role | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_role | Role | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_role | Role | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_role | Role | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_role | Role | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_role | Role | role_code | VARCHAR(64) | 是 | 角色编码，唯一 | 普通 |
| sys_role | Role | role_name | VARCHAR(128) | 是 | 角色名称 | 普通 |
| sys_role | Role | role_level | VARCHAR(32) | 是 | 总部/区域/校区/个人 | 普通 |
| sys_role | Role | data_scope_type | VARCHAR(32) | 是 | 数据范围类型 | 普通 |
| sys_role | Role | enabled | TINYINT | 是 | 是否启用 | 普通 |
| sys_approval_flow | ApprovalFlow | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_approval_flow | ApprovalFlow | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_approval_flow | ApprovalFlow | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_approval_flow | ApprovalFlow | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_approval_flow | ApprovalFlow | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_approval_flow | ApprovalFlow | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_approval_flow | ApprovalFlow | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_approval_flow | ApprovalFlow | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_approval_flow | ApprovalFlow | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_approval_flow | ApprovalFlow | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_approval_flow | ApprovalFlow | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_approval_flow | ApprovalFlow | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_approval_flow | ApprovalFlow | flow_code | VARCHAR(64) | 是 | 审批流编码，唯一 | 普通 |
| sys_approval_flow | ApprovalFlow | biz_type | VARCHAR(64) | 是 | 业务类型 | 普通 |
| sys_approval_flow | ApprovalFlow | flow_name | VARCHAR(128) | 是 | 审批流名称 | 普通 |
| sys_approval_flow | ApprovalFlow | condition_json | JSON | 否 | 触发条件 | 普通 |
| sys_approval_flow | ApprovalFlow | node_json | JSON | 是 | 节点、审批人和超时规则 | 普通 |
| sys_approval_flow | ApprovalFlow | version_no | INT | 是 | 审批流版本号 | 普通 |
| sys_approval_flow | ApprovalFlow | enabled | TINYINT | 是 | 是否启用 | 普通 |
| sys_message_template | MessageTemplate | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_message_template | MessageTemplate | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_message_template | MessageTemplate | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_message_template | MessageTemplate | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_message_template | MessageTemplate | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_message_template | MessageTemplate | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_message_template | MessageTemplate | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_message_template | MessageTemplate | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_message_template | MessageTemplate | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_message_template | MessageTemplate | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_message_template | MessageTemplate | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_message_template | MessageTemplate | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_message_template | MessageTemplate | template_code | VARCHAR(64) | 是 | 模板编码，唯一 | 普通 |
| sys_message_template | MessageTemplate | template_name | VARCHAR(128) | 是 | 模板名称 | 普通 |
| sys_message_template | MessageTemplate | channel | VARCHAR(32) | 是 | 站内信/短信/微信小程序/企微/Push | 普通 |
| sys_message_template | MessageTemplate | receiver_rule | JSON | 是 | 接收人规则 | 普通 |
| sys_message_template | MessageTemplate | content_template | TEXT | 是 | 模板内容 | 普通 |
| sys_message_template | MessageTemplate | enabled | TINYINT | 是 | 是否启用 | 普通 |
| sys_audit_log | AuditLog | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sys_audit_log | AuditLog | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sys_audit_log | AuditLog | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sys_audit_log | AuditLog | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sys_audit_log | AuditLog | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sys_audit_log | AuditLog | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sys_audit_log | AuditLog | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sys_audit_log | AuditLog | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sys_audit_log | AuditLog | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sys_audit_log | AuditLog | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sys_audit_log | AuditLog | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sys_audit_log | AuditLog | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sys_audit_log | AuditLog | operator_id | BIGINT | 是 | 操作人 ID | 普通 |
| sys_audit_log | AuditLog | biz_type | VARCHAR(64) | 是 | 业务类型 | 普通 |
| sys_audit_log | AuditLog | biz_id | BIGINT | 否 | 业务主键 ID | 普通 |
| sys_audit_log | AuditLog | action_code | VARCHAR(64) | 是 | 操作编码 | 普通 |
| sys_audit_log | AuditLog | before_snapshot | JSON | 否 | 变更前快照 | 普通 |
| sys_audit_log | AuditLog | after_snapshot | JSON | 否 | 变更后快照 | 普通 |
| sys_audit_log | AuditLog | ip_address | VARCHAR(64) | 否 | 操作 IP | 普通 |
| int_integration_log | IntegrationLog | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| int_integration_log | IntegrationLog | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| int_integration_log | IntegrationLog | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| int_integration_log | IntegrationLog | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| int_integration_log | IntegrationLog | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| int_integration_log | IntegrationLog | created_at | DATETIME | 是 | 创建时间 | 普通 |
| int_integration_log | IntegrationLog | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| int_integration_log | IntegrationLog | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| int_integration_log | IntegrationLog | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| int_integration_log | IntegrationLog | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| int_integration_log | IntegrationLog | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| int_integration_log | IntegrationLog | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| int_integration_log | IntegrationLog | request_id | VARCHAR(128) | 是 | 请求 ID，幂等键 | 普通 |
| int_integration_log | IntegrationLog | system_code | VARCHAR(64) | 是 | 外部系统编码 | 普通 |
| int_integration_log | IntegrationLog | api_path | VARCHAR(512) | 是 | 接口路径 | 普通 |
| int_integration_log | IntegrationLog | biz_type | VARCHAR(64) | 否 | 业务类型 | 普通 |
| int_integration_log | IntegrationLog | biz_id | BIGINT | 否 | 业务 ID | 普通 |
| int_integration_log | IntegrationLog | request_payload | JSON | 否 | 请求报文，敏感字段脱敏 | 敏感 |
| int_integration_log | IntegrationLog | response_payload | JSON | 否 | 响应报文 | 普通 |
| int_integration_log | IntegrationLog | call_status | VARCHAR(32) | 是 | 成功/失败/超时/重试中 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | created_at | DATETIME | 是 | 创建时间 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | field_code | VARCHAR(128) | 是 | 字段编码，唯一 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | biz_type | VARCHAR(64) | 是 | 业务类型 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | mask_rule | VARCHAR(64) | 是 | 脱敏规则 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | view_requires_approval | TINYINT | 是 | 明文查看是否需审批 | 普通 |
| sec_sensitive_field_policy | SensitiveFieldPolicy | watermark_required | TINYINT | 是 | 是否加水印 | 普通 |
| crm_guardian | Guardian | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| crm_guardian | Guardian | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| crm_guardian | Guardian | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| crm_guardian | Guardian | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| crm_guardian | Guardian | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| crm_guardian | Guardian | created_at | DATETIME | 是 | 创建时间 | 普通 |
| crm_guardian | Guardian | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| crm_guardian | Guardian | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| crm_guardian | Guardian | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| crm_guardian | Guardian | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| crm_guardian | Guardian | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| crm_guardian | Guardian | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| crm_guardian | Guardian | family_id | BIGINT | 是 | 家庭 ID | 普通 |
| crm_guardian | Guardian | guardian_name | VARCHAR(64) | 是 | 监护人姓名 | 普通 |
| crm_guardian | Guardian | mobile | VARCHAR(32) | 是 | 手机号，敏感 | 敏感 |
| crm_guardian | Guardian | relationship | VARCHAR(32) | 是 | 与学员关系 | 普通 |
| crm_guardian | Guardian | wechat_openid | VARCHAR(128) | 否 | 微信 OpenID，敏感 | 敏感 |
| crm_guardian | Guardian | verify_status | VARCHAR(32) | 是 | 未验证/已验证/已解绑 | 普通 |
| stu_student | Student | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| stu_student | Student | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| stu_student | Student | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| stu_student | Student | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| stu_student | Student | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| stu_student | Student | created_at | DATETIME | 是 | 创建时间 | 普通 |
| stu_student | Student | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| stu_student | Student | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| stu_student | Student | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| stu_student | Student | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| stu_student | Student | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| stu_student | Student | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| stu_student | Student | student_no | VARCHAR(64) | 是 | 学员编号，唯一 | 普通 |
| stu_student | Student | family_id | BIGINT | 否 | 家庭 ID | 普通 |
| stu_student | Student | student_name | VARCHAR(64) | 是 | 学员姓名 | 普通 |
| stu_student | Student | gender | VARCHAR(16) | 否 | 性别 | 普通 |
| stu_student | Student | birthday | DATE | 否 | 出生日期 | 普通 |
| stu_student | Student | grade | VARCHAR(32) | 否 | 年级 | 普通 |
| stu_student | Student | school_name | VARCHAR(128) | 否 | 学校名称 | 普通 |
| stu_student | Student | biz_status | VARCHAR(32) | 是 | 业务状态，取值来自状态机字典 | 普通 |
| stu_student | Student | remark | VARCHAR(512) | 否 | 业务备注，敏感内容按权限脱敏 | 普通 |
| edu_lesson | Schedule/Lesson | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_lesson | Schedule/Lesson | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_lesson | Schedule/Lesson | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_lesson | Schedule/Lesson | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_lesson | Schedule/Lesson | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_lesson | Schedule/Lesson | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_lesson | Schedule/Lesson | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_lesson | Schedule/Lesson | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_lesson | Schedule/Lesson | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_lesson | Schedule/Lesson | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_lesson | Schedule/Lesson | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_lesson | Schedule/Lesson | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_lesson | Schedule/Lesson | lesson_no | VARCHAR(64) | 是 | 课次编号，唯一 | 普通 |
| edu_lesson | Schedule/Lesson | class_id | BIGINT | 是 | 班级 ID | 普通 |
| edu_lesson | Schedule/Lesson | teacher_id | BIGINT | 是 | 授课教师 ID | 普通 |
| edu_lesson | Schedule/Lesson | classroom_id | BIGINT | 否 | 教室 ID | 普通 |
| edu_lesson | Schedule/Lesson | start_at | DATETIME | 是 | 上课开始时间 | 普通 |
| edu_lesson | Schedule/Lesson | end_at | DATETIME | 是 | 上课结束时间 | 普通 |
| edu_lesson | Schedule/Lesson | lesson_status | VARCHAR(32) | 是 | 待上课/上课中/已下课/已取消/需补课 | 普通 |
| edu_attendance | Attendance | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_attendance | Attendance | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_attendance | Attendance | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_attendance | Attendance | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_attendance | Attendance | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_attendance | Attendance | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_attendance | Attendance | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_attendance | Attendance | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_attendance | Attendance | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_attendance | Attendance | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_attendance | Attendance | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_attendance | Attendance | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_attendance | Attendance | lesson_id | BIGINT | 是 | 课次 ID | 普通 |
| edu_attendance | Attendance | student_id | BIGINT | 是 | 学员 ID | 普通 |
| edu_attendance | Attendance | checkin_type | VARCHAR(32) | 是 | 人工/人脸/补签/家长确认 | 普通 |
| edu_attendance | Attendance | checkin_at | DATETIME | 否 | 签到时间 | 普通 |
| edu_attendance | Attendance | attendance_status | VARCHAR(32) | 是 | 到课/请假/旷课/迟到/待确认 | 普通 |
| edu_attendance | Attendance | source_event_id | BIGINT | 否 | 来源设备或操作事件 | 普通 |
| edu_consumption | Consumption | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_consumption | Consumption | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_consumption | Consumption | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_consumption | Consumption | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_consumption | Consumption | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_consumption | Consumption | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_consumption | Consumption | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_consumption | Consumption | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_consumption | Consumption | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_consumption | Consumption | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_consumption | Consumption | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_consumption | Consumption | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_consumption | Consumption | lesson_id | BIGINT | 是 | 课次 ID | 普通 |
| edu_consumption | Consumption | student_id | BIGINT | 是 | 学员 ID | 普通 |
| edu_consumption | Consumption | contract_id | BIGINT | 是 | 合同 ID | 普通 |
| edu_consumption | Consumption | consumed_hours | DECIMAL(8,2) | 是 | 消耗课时 | 普通 |
| edu_consumption | Consumption | consume_amount | DECIMAL(18,2) | 否 | 课消金额 | 普通 |
| edu_consumption | Consumption | consume_status | VARCHAR(32) | 是 | 待确认/已课消/已冲销/异常 | 普通 |
| edu_leave_request | LeaveRequest | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_leave_request | LeaveRequest | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_leave_request | LeaveRequest | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_leave_request | LeaveRequest | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_leave_request | LeaveRequest | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_leave_request | LeaveRequest | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_leave_request | LeaveRequest | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_leave_request | LeaveRequest | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_leave_request | LeaveRequest | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_leave_request | LeaveRequest | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_leave_request | LeaveRequest | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_leave_request | LeaveRequest | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_leave_request | LeaveRequest | leave_no | VARCHAR(64) | 是 | 请假编号，唯一 | 普通 |
| edu_leave_request | LeaveRequest | student_id | BIGINT | 是 | 学员 ID | 普通 |
| edu_leave_request | LeaveRequest | lesson_id | BIGINT | 是 | 课次 ID | 普通 |
| edu_leave_request | LeaveRequest | leave_reason | VARCHAR(512) | 是 | 请假原因 | 普通 |
| edu_leave_request | LeaveRequest | proof_file_ids | JSON | 否 | 证明附件 | 普通 |
| edu_leave_request | LeaveRequest | leave_status | VARCHAR(32) | 是 | 待审核/已通过/已驳回/已撤销 | 普通 |
| edu_leave_request | LeaveRequest | approval_status | VARCHAR(32) | 否 | 审批状态，未发起为空 | 普通 |
| edu_leave_request | LeaveRequest | approval_instance_id | BIGINT | 否 | 关联审批实例 ID | 普通 |
| edu_makeup_arrangement | MakeupArrangement | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_makeup_arrangement | MakeupArrangement | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_makeup_arrangement | MakeupArrangement | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | arrangement_no | VARCHAR(64) | 是 | 补课安排编号，唯一 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | leave_request_id | BIGINT | 否 | 关联请假单 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | student_id | BIGINT | 是 | 学员 ID | 普通 |
| edu_makeup_arrangement | MakeupArrangement | candidate_lessons | JSON | 否 | 候选补课课次 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | makeup_preference | JSON | 否 | 家长期望时间 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | confirm_deadline | DATETIME | 否 | 确认截止时间 | 普通 |
| edu_makeup_arrangement | MakeupArrangement | arrange_status | VARCHAR(32) | 是 | 待安排/待确认/已确认/已完成/已取消 | 普通 |
| edu_homework_review | HomeworkReview | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_homework_review | HomeworkReview | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_homework_review | HomeworkReview | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_homework_review | HomeworkReview | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_homework_review | HomeworkReview | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_homework_review | HomeworkReview | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_homework_review | HomeworkReview | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_homework_review | HomeworkReview | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_homework_review | HomeworkReview | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_homework_review | HomeworkReview | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_homework_review | HomeworkReview | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_homework_review | HomeworkReview | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_homework_review | HomeworkReview | submit_id | BIGINT | 是 | 作业提交 ID | 普通 |
| edu_homework_review | HomeworkReview | teacher_id | BIGINT | 是 | 批改教师 ID | 普通 |
| edu_homework_review | HomeworkReview | score | DECIMAL(6,2) | 否 | 得分 | 普通 |
| edu_homework_review | HomeworkReview | comment | TEXT | 否 | 评语 | 普通 |
| edu_homework_review | HomeworkReview | wrong_question_json | JSON | 否 | 错题记录 | 普通 |
| edu_homework_review | HomeworkReview | review_status | VARCHAR(32) | 是 | 待批改/已批改/需订正 | 普通 |
| edu_growth_record | GrowthRecord | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| edu_growth_record | GrowthRecord | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| edu_growth_record | GrowthRecord | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| edu_growth_record | GrowthRecord | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| edu_growth_record | GrowthRecord | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| edu_growth_record | GrowthRecord | created_at | DATETIME | 是 | 创建时间 | 普通 |
| edu_growth_record | GrowthRecord | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| edu_growth_record | GrowthRecord | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| edu_growth_record | GrowthRecord | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| edu_growth_record | GrowthRecord | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| edu_growth_record | GrowthRecord | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| edu_growth_record | GrowthRecord | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| edu_growth_record | GrowthRecord | student_id | BIGINT | 是 | 学员 ID | 普通 |
| edu_growth_record | GrowthRecord | record_type | VARCHAR(32) | 是 | 课堂/作业/测评/签到/教师评价 | 普通 |
| edu_growth_record | GrowthRecord | biz_type | VARCHAR(64) | 是 | 来源业务类型 | 普通 |
| edu_growth_record | GrowthRecord | biz_id | BIGINT | 是 | 来源业务 ID | 普通 |
| edu_growth_record | GrowthRecord | record_content | JSON | 是 | 成长记录内容 | 普通 |
| edu_growth_record | GrowthRecord | visible_to_parent | TINYINT | 是 | 家长端是否可见 | 普通 |
| con_contract | Contract | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| con_contract | Contract | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| con_contract | Contract | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| con_contract | Contract | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| con_contract | Contract | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| con_contract | Contract | created_at | DATETIME | 是 | 创建时间 | 普通 |
| con_contract | Contract | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| con_contract | Contract | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| con_contract | Contract | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| con_contract | Contract | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| con_contract | Contract | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| con_contract | Contract | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| con_contract | Contract | contract_no | VARCHAR(64) | 是 | 合同编号，唯一 | 普通 |
| con_contract | Contract | student_id | BIGINT | 是 | 学员 ID | 普通 |
| con_contract | Contract | family_id | BIGINT | 否 | 客户家庭 ID | 普通 |
| con_contract | Contract | template_id | BIGINT | 是 | 合同模板 ID | 普通 |
| con_contract | Contract | employee_id | BIGINT | 否 | 创建合同的销售/市场/课程顾问员工 ID | 普通 |
| con_contract | Contract | source_terminal | VARCHAR(32) | 是 | 来源终端，教师端 App/小程序或 PC 管理端 | 普通 |
| con_contract | Contract | simulation_id | BIGINT | 否 | 关联优惠试算 ID | 普通 |
| con_contract | Contract | extra_discount_apply_id | BIGINT | 否 | 关联额外折扣申请 ID | 普通 |
| con_contract | Contract | hand_sign_status | VARCHAR(32) | 是 | 待手写签字/已手写签字/签字作废 | 普通 |
| con_contract | Contract | sign_status | VARCHAR(32) | 是 | 待家长签署/已手写签字/已作废 | 普通 |
| con_contract | Contract | payment_status | VARCHAR(32) | 是 | 待支付/支付中/支付成功/支付失败/已关闭 | 普通 |
| con_contract | Contract | enterprise_seal_status | VARCHAR(32) | 是 | 未触发/盖章中/已盖章/盖章失败/已归档 | 普通 |
| con_contract | Contract | contract_status | VARCHAR(32) | 是 | 草稿/生效/履约中/已终止/已退费 | 普通 |
| con_contract | Contract | supervision_status | VARCHAR(32) | 否 | 监管报送状态 | 普通 |
| con_contract | Contract | currency | VARCHAR(8) | 是 | 币种，默认 CNY | 普通 |
| con_contract | Contract | amount | DECIMAL(18,2) | 是 | 含税金额，必须大于等于 0 | 普通 |
| con_contract | Contract | tax_amount | DECIMAL(18,2) | 否 | 税额，按发票或税率计算 | 普通 |
| con_contract | Contract | approval_status | VARCHAR(32) | 否 | 审批状态，未发起为空 | 普通 |
| con_contract | Contract | approval_instance_id | BIGINT | 否 | 关联审批实例 ID | 普通 |
| ord_order | Order | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ord_order | Order | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ord_order | Order | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ord_order | Order | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ord_order | Order | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ord_order | Order | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ord_order | Order | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ord_order | Order | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ord_order | Order | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ord_order | Order | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ord_order | Order | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ord_order | Order | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ord_order | Order | order_no | VARCHAR(64) | 是 | 订单编号，唯一 | 普通 |
| ord_order | Order | contract_id | BIGINT | 是 | 合同 ID | 普通 |
| ord_order | Order | student_id | BIGINT | 是 | 学员 ID | 普通 |
| ord_order | Order | receivable_amount | DECIMAL(18,2) | 是 | 应收金额 | 普通 |
| ord_order | Order | discount_amount | DECIMAL(18,2) | 否 | 优惠金额 | 普通 |
| ord_order | Order | paid_amount | DECIMAL(18,2) | 是 | 已收金额 | 普通 |
| ord_order | Order | order_status | VARCHAR(32) | 是 | 待支付/支付中/已支付/已关闭 | 普通 |
| ord_payment | Payment | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| ord_payment | Payment | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| ord_payment | Payment | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| ord_payment | Payment | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| ord_payment | Payment | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| ord_payment | Payment | created_at | DATETIME | 是 | 创建时间 | 普通 |
| ord_payment | Payment | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| ord_payment | Payment | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| ord_payment | Payment | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| ord_payment | Payment | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| ord_payment | Payment | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| ord_payment | Payment | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| ord_payment | Payment | payment_no | VARCHAR(64) | 是 | 收款单号，唯一 | 普通 |
| ord_payment | Payment | order_id | BIGINT | 是 | 订单 ID | 普通 |
| ord_payment | Payment | pay_channel | VARCHAR(32) | 是 | 微信/支付宝/银行卡/现金/监管账户 | 普通 |
| ord_payment | Payment | paid_amount | DECIMAL(18,2) | 是 | 实收金额 | 普通 |
| ord_payment | Payment | paid_at | DATETIME | 否 | 支付完成时间 | 普通 |
| ord_payment | Payment | channel_trade_no | VARCHAR(128) | 否 | 渠道流水号 | 普通 |
| ord_payment | Payment | supervision_account_id | BIGINT | 否 | 资金监管账户 ID | 普通 |
| ord_payment | Payment | receipt_status | VARCHAR(32) | 是 | 待确认/已确认/异常 | 普通 |
JSON 字段结构与校验
| 表名 | 对象 | 字段 | 结构编码 | 结构定义 | 校验规则 | 示例 |
|---|---|---|---|---|---|---|
| par_guardian_account | GuardianAccount | notification_preference | MESSAGE_RECEIVER | {receiverType:string, roleCodes?:string[], userIds?:number[], dynamicField?:string} | 接收人必须能解析到有效账号；失败生成消息异常任务 | {"receiverType":"ROLE","roleCodes":["CAMPUS_MANAGER"]} |
| par_student_binding | ParentStudentBinding | verify_material_ids | GENERIC | object | array | 必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本 | {"version":1,"items":[]} |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | child_scope | GENERIC | object | array | 必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本 | {"version":1,"items":[]} |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | todo_summary | GENERIC | object | array | 必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本 | {"version":1,"items":[]} |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | schedule_summary | GENERIC | object | array | 必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本 | {"version":1,"items":[]} |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | payment_summary | GENERIC | object | array | 必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本 | {"version":1,"items":[]} |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | message_summary | GENERIC | object | array | 必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本 | {"version":1,"items":[]} |
| par_service_profile | ParentServiceProfile | communication_tags | MESSAGE_RECEIVER | {receiverType:string, roleCodes?:string[], userIds?:number[], dynamicField?:string} | 接收人必须能解析到有效账号；失败生成消息异常任务 | {"receiverType":"ROLE","roleCodes":["CAMPUS_MANAGER"]} |
| par_leave_request | ParentLeaveRequest | file_ids | ID_LIST | array<number> | 数组长度 1-500；元素必须为已存在且未逻辑删除的业务 ID | [10001,10002] |
| par_leave_request | ParentLeaveRequest | evidence_snapshot | AUDIT_SNAPSHOT | {before?:object, after?:object, changedFields:string[], maskPolicy:string} | 敏感字段必须按脱敏策略写入，不允许存储明文密码或密钥 | {"changedFields":["owner_id"],"maskPolicy":"MOBILE_MASK"} |
| par_makeup_confirmation | ParentMakeupConfirmation | candidate_lessons | LESSON_CANDIDATES | [{lessonId:number, startAt:string, teacherId:number, capacityLeft:number, conflict:boolean}] | 候选课次必须已排课、未满班且无时间冲突 | [{"lessonId":9001,"capacityLeft":3,"conflict":false}] |
| par_makeup_confirmation | ParentMakeupConfirmation | confirm_result | GENERIC | object | array | 必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本 | {"version":1,"items":[]} |
| par_payment_request | ParentPaymentRequest | discount_summary | GENERIC | object | array | 必须符合字段说明中的业务结构；保存前进行 JSON Schema 校验并记录版本 | {"version":1,"items":[]} |
| par_refund_consultation | ParentRefundConsultation | guide_snapshot | AUDIT_SNAPSHOT | {before?:object, after?:object, changedFields:string[], maskPolicy:string} | 敏感字段必须按脱敏策略写入，不允许存储明文密码或密钥 | {"changedFields":["owner_id"],"maskPolicy":"MOBILE_MASK"} |
| par_service_ticket | ParentServiceTicket | file_ids | ID_LIST | array<number> | 数组长度 1-500；元素必须为已存在且未逻辑删除的业务 ID | [10001,10002] |
| par_service_ticket | ParentServiceTicket | evidence_snapshot | AUDIT_SNAPSHOT | {before?:object, after?:object, changedFields:string[], maskPolicy:string} | 敏感字段必须按脱敏策略写入，不允许存储明文密码或密钥 | {"changedFields":["owner_id"],"maskPolicy":"MOBILE_MASK"} |
状态/枚举标准字典
| 表名 | 对象 | 字段 | 枚举编码 | 取值 | 终态/流转规则 | 字段说明 |
|---|---|---|---|---|---|---|
| par_guardian_account | GuardianAccount | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_guardian_account | GuardianAccount | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_guardian_account | GuardianAccount | agreement_version | AGREEMENT_VERSION | 最近一次勾选的用户协议、隐私政策版本 | 非终态，可按状态机或字典规则流转 | 最近一次勾选的用户协议/隐私政策版本 |
| par_guardian_account | GuardianAccount | last_login_channel | LAST_LOGIN_CHANNEL | 微信、手机号验证码 | 非终态，可按状态机或字典规则流转 | 最近登录方式：微信/手机号验证码 |
| par_guardian_account | GuardianAccount | bind_status | BIND_STATUS | 待绑定、已绑定、已解绑、停用 | 非终态，可按状态机或字典规则流转 | 待绑定/已绑定/已解绑/停用 |
| par_login_session | ParentLoginSession | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_login_session | ParentLoginSession | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_login_session | ParentLoginSession | login_channel | LOGIN_CHANNEL | 微信登录、手机号验证码登录 | 非终态，可按状态机或字典规则流转 | 微信登录/手机号验证码登录 |
| par_login_session | ParentLoginSession | agreement_accepted | BOOL | 按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识 | 非终态，可按状态机或字典规则流转 | 是否已勾选协议 |
| par_login_session | ParentLoginSession | login_status | LOGIN_STATUS | PENDING 待激活、NORMAL 正常、LOCKED 锁定、DISABLED 停用 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待校验/成功/验证码错误/协议未勾选/账号异常 |
| par_login_session | ParentLoginSession | client_type | CLIENT_TYPE | 微信小程序、H5 | 非终态，可按状态机或字典规则流转 | 微信小程序/H5 |
| par_student_binding | ParentStudentBinding | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_student_binding | ParentStudentBinding | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_student_binding | ParentStudentBinding | relationship | RELATIONSHIP | FATHER 父亲、MOTHER 母亲、GRANDFATHER 祖父/外祖父、GRANDMOTHER 祖母/外祖母、OTHER 其他监护关系 | 非终态，可按状态机或字典规则流转 | 关系 |
| par_student_binding | ParentStudentBinding | verify_status | VERIFY_STATUS | 待验证、已验证、已拒绝、已解绑 | 非终态，可按状态机或字典规则流转 | 待验证/已验证/已拒绝/已解绑 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | child_scope | CHILD_SCOPE | 按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识 | 非终态，可按状态机或字典规则流转 | 本次聚合的学员 ID 列表 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | snapshot_status | SNAPSHOT_STATUS | 正常、刷新中、刷新失败、数据过期 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 正常/刷新中/刷新失败/数据过期 |
| par_service_profile | ParentServiceProfile | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_service_profile | ParentServiceProfile | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_service_profile | ParentServiceProfile | service_owner_id | SERVICE_OWNER_ID | 班主任、学管师 ID | 非终态，可按状态机或字典规则流转 | 班主任/学管师 ID |
| par_service_profile | ParentServiceProfile | risk_level | RISK_LEVEL | LOW 低、MEDIUM 中、HIGH 高、CRITICAL 严重 | 非终态，可按状态机或字典规则流转 | 服务风险等级 |
| par_leave_request | ParentLeaveRequest | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_leave_request | ParentLeaveRequest | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_leave_request | ParentLeaveRequest | submit_channel | SUBMIT_CHANNEL | 小程序、H5、App | 非终态，可按状态机或字典规则流转 | 小程序/H5/App |
| par_leave_request | ParentLeaveRequest | visible_status | VISIBLE_STATUS | 待审核、已通过、已驳回、已撤销 | 非终态，可按状态机或字典规则流转 | 待审核/已通过/已驳回/已撤销 |
| par_leave_request | ParentLeaveRequest | makeup_notice_status | MAKEUP_NOTICE_STATUS | 无需补课、待生成、已提醒、已过期 | 非终态，可按状态机或字典规则流转 | 无需补课/待生成/已提醒/已过期 |
| par_makeup_confirmation | ParentMakeupConfirmation | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_makeup_confirmation | ParentMakeupConfirmation | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_makeup_confirmation | ParentMakeupConfirmation | confirm_status | CONFIRM_STATUS | 待确认、已确认、改期申请中、已取消、已过期、已完成 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待确认/已确认/改期申请中/已取消/已过期/已完成 |
| par_payment_request | ParentPaymentRequest | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_payment_request | ParentPaymentRequest | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_payment_request | ParentPaymentRequest | hand_sign_status | HAND_SIGN_STATUS | 待签署、已签署、签署失败 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待签署/已签署/签署失败 |
| par_payment_request | ParentPaymentRequest | pay_channel | PAY_CHANNEL | 按业务字典配置，需在字典中心维护编码、名称、排序、启停和终态标识 | 非终态，可按状态机或字典规则流转 | 支付渠道 |
| par_payment_request | ParentPaymentRequest | request_status | PAYMENT_STATUS | PENDING 待支付/待付款、PROCESSING 处理中、SUCCESS 成功、FAILED 失败、CLOSED 已关闭 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待支付/支付中/成功/失败/关闭 |
| par_contract_action | ParentContractAction | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_contract_action | ParentContractAction | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_contract_action | ParentContractAction | action_type | ACTION_TYPE | 查看、手写签署、发起支付、下载已盖章合同 | 非终态，可按状态机或字典规则流转 | 查看/手写签署/发起支付/下载已盖章合同 |
| par_contract_action | ParentContractAction | action_status | ACTION_STATUS | 待处理、成功、失败、已关闭 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待处理/成功/失败/已关闭 |
| par_refund_consultation | ParentRefundConsultation | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_refund_consultation | ParentRefundConsultation | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_refund_consultation | ParentRefundConsultation | consult_type | CONSULT_TYPE | 退费规则咨询、材料咨询、进度咨询、其他 | 非终态，可按状态机或字典规则流转 | 退费规则咨询/材料咨询/进度咨询/其他 |
| par_refund_consultation | ParentRefundConsultation | consult_status | CONSULT_STATUS | 草稿、已提交、处理中、需补充、已转线下办理、已关闭 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 草稿/已提交/处理中/需补充/已转线下办理/已关闭 |
| par_notification_record | ParentNotificationRecord | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_notification_record | ParentNotificationRecord | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_notification_record | ParentNotificationRecord | channel | CHANNEL | 小程序、短信、Push、H5 | 非终态，可按状态机或字典规则流转 | 小程序/短信/Push/H5 |
| par_notification_record | ParentNotificationRecord | send_status | SEND_STATUS | 待发送、成功、失败、已读 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待发送/成功/失败/已读 |
| par_growth_poster | GrowthPoster | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_growth_poster | GrowthPoster | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_growth_poster | GrowthPoster | poster_status | POSTER_STATUS | 待生成、生成中、成功、失败、已保存、已分享 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 待生成/生成中/成功/失败/已保存/已分享 |
| par_service_ticket | ParentServiceTicket | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_service_ticket | ParentServiceTicket | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_service_ticket | ParentServiceTicket | ticket_type | TICKET_TYPE | 投诉建议、退费咨询、服务请求、其他 | 非终态，可按状态机或字典规则流转 | 投诉建议/退费咨询/服务请求/其他 |
| par_service_ticket | ParentServiceTicket | ticket_status | TICKET_STATUS | 草稿、已提交、已分派、处理中、待家长确认、已关闭、已驳回、转人工 | 包含终态，终态禁止直接编辑，需走变更/红冲/撤回流程 | 草稿/已提交/已分派/处理中/待家长确认/已关闭/已驳回/转人工 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | tenant_id | TENANT_ID | 集团、租户隔离字段 | 非终态，可按状态机或字典规则流转 | 集团/租户隔离字段，所有查询必须带租户上下文 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | is_deleted | BOOL_DELETED | 0 未删除、1 已删除 | 非终态，可按状态机或字典规则流转 | 是否已删除，0 未删除，1 已删除 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | feedback_status | FEEDBACK_STATUS | 待提交、已提交、已撤回 | 非终态，可按状态机或字典规则流转 | 待提交/已提交/已撤回 |
敏感字段与数据安全策略
| 来源 | 表名 | 对象 | 字段 | 数据级别 | 脱敏/返回策略 | 明文查看条件 | 导出策略 | 审计要求 | 端侧展示规则 |
|---|---|---|---|---|---|---|---|---|---|
| 本模块对象 | par_guardian_account | GuardianAccount | account_no | 普通 | BANK_ACCOUNT_MASK | 默认展示后 4 位；付款、报销、工资发放场景按岗位权限展示 | 导出银行账号必须走财务/安全双审批 | 查看、变更、付款使用、导出均记录业务单号和操作者 | 财务 PC 可按权限明文；员工端和移动端默认脱敏 |
| 本模块对象 | par_guardian_account | GuardianAccount | mobile | 敏感 | MOBILE_MASK | 默认展示 138****0000；明文查看需字段权限或敏感字段查看审批 | 导出手机号必须触发导出审批、下载水印和有效期控制 | 明文查看、复制、导出和批量下载均写入 SensitiveAccessLog | PC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息 |
| 本模块对象 | par_guardian_account | GuardianAccount | wechat_openid | 敏感 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 本模块对象 | par_guardian_account | GuardianAccount | last_login_channel | 普通 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 本模块对象 | par_login_session | ParentLoginSession | login_channel | 普通 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 本模块对象 | par_login_session | ParentLoginSession | mobile | 敏感 | MOBILE_MASK | 默认展示 138****0000；明文查看需字段权限或敏感字段查看审批 | 导出手机号必须触发导出审批、下载水印和有效期控制 | 明文查看、复制、导出和批量下载均写入 SensitiveAccessLog | PC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息 |
| 本模块对象 | par_login_session | ParentLoginSession | wechat_openid | 敏感 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 本模块对象 | par_service_ticket | ParentServiceTicket | contact_mobile | 敏感 | MOBILE_MASK | 默认展示 138****0000；明文查看需字段权限或敏感字段查看审批 | 导出手机号必须触发导出审批、下载水印和有效期控制 | 明文查看、复制、导出和批量下载均写入 SensitiveAccessLog | PC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息 |
| 引用对象 | sys_user | User/Employee | mobile | 敏感 | MOBILE_MASK | 默认展示 138****0000；明文查看需字段权限或敏感字段查看审批 | 导出手机号必须触发导出审批、下载水印和有效期控制 | 明文查看、复制、导出和批量下载均写入 SensitiveAccessLog | PC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息 |
| 引用对象 | sys_user | User/Employee | password_hash | 高敏 | NEVER_RETURN | 禁止接口返回明文；仅密钥中心/鉴权服务按服务身份读取密钥引用 | 禁止导出；配置导出只允许导出脱敏引用和启停状态 | 配置新增、修改、启停、轮换和失败读取均记录安全审计 | 前端只展示已配置/未配置、到期时间和连通性状态，不展示密钥值 |
| 引用对象 | int_integration_log | IntegrationLog | request_payload | 敏感 | PAYLOAD_DESENSITIZE | 接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权 | 导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段 | 查看报文、下载附件、失败重放和人工补偿均记录审计 | 业务端展示摘要和状态，完整报文仅运维/安全后台查看 |
| 引用对象 | int_integration_log | IntegrationLog | response_payload | 普通 | PAYLOAD_DESENSITIZE | 接口报文、快照和文件地址默认脱敏；排障查看需运维/安全授权 | 导出日志或报文时自动清理手机号、证件号、密钥、票据和人脸字段 | 查看报文、下载附件、失败重放和人工补偿均记录审计 | 业务端展示摘要和状态，完整报文仅运维/安全后台查看 |
| 引用对象 | sec_sensitive_field_policy | SensitiveFieldPolicy | mask_rule | 普通 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 引用对象 | crm_guardian | Guardian | mobile | 敏感 | MOBILE_MASK | 默认展示 138****0000；明文查看需字段权限或敏感字段查看审批 | 导出手机号必须触发导出审批、下载水印和有效期控制 | 明文查看、复制、导出和批量下载均写入 SensitiveAccessLog | PC 管理端按字段权限展示；移动端仅展示本人授权范围内脱敏信息 |
| 引用对象 | crm_guardian | Guardian | wechat_openid | 敏感 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 引用对象 | stu_student | Student | remark | 普通 | BIZ_FIELD_MASK | 按字段权限、数据范围和业务角色展示；明文查看按敏感字段审批规则执行 | 导出时按数据级别触发审批、水印、下载有效期和日志 | 查看、修改、删除、导出、下载和审批均记录操作审计 | 默认遵循总部、区域、校区、团队、本人数据范围和端侧最小可见原则 |
| 引用对象 | edu_attendance | Attendance | checkin_type | 普通 | FACE_IMAGE_PROTECTED | 默认只返回受控文件 ID/缩略图；人脸照片查看、下发、删除需授权和审计 | 禁止常规导出；仅设备下发、授权撤回和合规取证场景允许 | 人脸采集、下发、识别、撤回、删除、失败重试全链路留痕 | 未授权端不展示原图；设备端按任务有效期拉取 |
| 引用对象 | con_contract | Contract | tax_amount | 普通 | TAX_INVOICE_MASK | 默认按税号/发票号局部脱敏；发票原图、OCR 结果和国税回执按财务权限查看 | 财务导出需审批并加水印；国税官方回执随业务单归档 | OCR、核验、查重、人工校正、导出和付款阻断均留痕 | 移动端可上传和查看本人报销结果，不展示其他人员票据明文 |
| 引用对象 | ord_payment | Payment | pay_channel | 普通 | BANK_ACCOUNT_MASK | 默认展示后 4 位；付款、报销、工资发放场景按岗位权限展示 | 导出银行账号必须走财务/安全双审批 | 查看、变更、付款使用、导出均记录业务单号和操作者 | 财务 PC 可按权限明文；员工端和移动端默认脱敏 |
核心数据表完整字段
| 表名 | 对象 | 字段 | 类型 | 必填 | 规则 | 数据级别 |
|---|---|---|---|---|---|---|
| par_guardian_account | GuardianAccount | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_guardian_account | GuardianAccount | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_guardian_account | GuardianAccount | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_guardian_account | GuardianAccount | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_guardian_account | GuardianAccount | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_guardian_account | GuardianAccount | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_guardian_account | GuardianAccount | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_guardian_account | GuardianAccount | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_guardian_account | GuardianAccount | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_guardian_account | GuardianAccount | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_guardian_account | GuardianAccount | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_guardian_account | GuardianAccount | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_guardian_account | GuardianAccount | account_no | VARCHAR(64) | 是 | 家长账号编号，唯一 | 普通 |
| par_guardian_account | GuardianAccount | guardian_id | BIGINT | 是 | 监护人 ID | 普通 |
| par_guardian_account | GuardianAccount | mobile | VARCHAR(32) | 是 | 手机号，敏感 | 敏感 |
| par_guardian_account | GuardianAccount | wechat_openid | VARCHAR(128) | 否 | 微信 OpenID，敏感 | 敏感 |
| par_guardian_account | GuardianAccount | agreement_version | VARCHAR(32) | 否 | 最近一次勾选的用户协议/隐私政策版本 | 普通 |
| par_guardian_account | GuardianAccount | last_login_channel | VARCHAR(32) | 否 | 最近登录方式：微信/手机号验证码 | 普通 |
| par_guardian_account | GuardianAccount | bind_status | VARCHAR(32) | 是 | 待绑定/已绑定/已解绑/停用 | 普通 |
| par_guardian_account | GuardianAccount | notification_preference | JSON | 否 | 消息偏好 | 普通 |
| par_login_session | ParentLoginSession | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_login_session | ParentLoginSession | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_login_session | ParentLoginSession | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_login_session | ParentLoginSession | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_login_session | ParentLoginSession | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_login_session | ParentLoginSession | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_login_session | ParentLoginSession | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_login_session | ParentLoginSession | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_login_session | ParentLoginSession | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_login_session | ParentLoginSession | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_login_session | ParentLoginSession | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_login_session | ParentLoginSession | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_login_session | ParentLoginSession | guardian_account_id | BIGINT | 否 | 家长账号 ID，未完成登录时可为空 | 普通 |
| par_login_session | ParentLoginSession | login_channel | VARCHAR(32) | 是 | 微信登录/手机号验证码登录 | 普通 |
| par_login_session | ParentLoginSession | mobile | VARCHAR(32) | 否 | 登录手机号，敏感 | 敏感 |
| par_login_session | ParentLoginSession | sms_verify_id | VARCHAR(64) | 否 | 短信校验流水，不存储明文验证码 | 普通 |
| par_login_session | ParentLoginSession | wechat_openid | VARCHAR(128) | 否 | 微信 OpenID，敏感 | 敏感 |
| par_login_session | ParentLoginSession | agreement_accepted | TINYINT | 是 | 是否已勾选协议 | 普通 |
| par_login_session | ParentLoginSession | login_status | VARCHAR(32) | 是 | 待校验/成功/验证码错误/协议未勾选/账号异常 | 普通 |
| par_login_session | ParentLoginSession | client_type | VARCHAR(32) | 是 | 微信小程序/H5 | 普通 |
| par_login_session | ParentLoginSession | login_at | DATETIME | 否 | 登录成功时间 | 普通 |
| par_student_binding | ParentStudentBinding | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_student_binding | ParentStudentBinding | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_student_binding | ParentStudentBinding | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_student_binding | ParentStudentBinding | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_student_binding | ParentStudentBinding | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_student_binding | ParentStudentBinding | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_student_binding | ParentStudentBinding | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_student_binding | ParentStudentBinding | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_student_binding | ParentStudentBinding | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_student_binding | ParentStudentBinding | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_student_binding | ParentStudentBinding | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_student_binding | ParentStudentBinding | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_student_binding | ParentStudentBinding | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_student_binding | ParentStudentBinding | student_id | BIGINT | 是 | 学员 ID | 普通 |
| par_student_binding | ParentStudentBinding | relationship | VARCHAR(32) | 是 | 关系 | 普通 |
| par_student_binding | ParentStudentBinding | verify_material_ids | JSON | 否 | 监护关系证明材料文件 ID | 普通 |
| par_student_binding | ParentStudentBinding | verify_status | VARCHAR(32) | 是 | 待验证/已验证/已拒绝/已解绑 | 普通 |
| par_student_binding | ParentStudentBinding | reject_reason | VARCHAR(512) | 否 | 认证失败原因 | 普通 |
| par_student_binding | ParentStudentBinding | unbind_at | DATETIME | 否 | 解绑时间 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | snapshot_date | DATE | 是 | 快照日期 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | child_scope | JSON | 是 | 本次聚合的学员 ID 列表 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | todo_summary | JSON | 否 | 待办汇总，含课程、合同、补课、工单和消息 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | schedule_summary | JSON | 否 | 课表摘要 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | payment_summary | JSON | 否 | 合同缴费摘要 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | message_summary | JSON | 否 | 消息摘要 | 普通 |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | snapshot_status | VARCHAR(32) | 是 | 正常/刷新中/刷新失败/数据过期 | 普通 |
| par_service_profile | ParentServiceProfile | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_service_profile | ParentServiceProfile | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_service_profile | ParentServiceProfile | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_service_profile | ParentServiceProfile | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_service_profile | ParentServiceProfile | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_service_profile | ParentServiceProfile | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_service_profile | ParentServiceProfile | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_service_profile | ParentServiceProfile | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_service_profile | ParentServiceProfile | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_service_profile | ParentServiceProfile | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_service_profile | ParentServiceProfile | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_service_profile | ParentServiceProfile | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_service_profile | ParentServiceProfile | student_id | BIGINT | 是 | 学员 ID | 普通 |
| par_service_profile | ParentServiceProfile | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_service_profile | ParentServiceProfile | service_owner_id | BIGINT | 否 | 班主任/学管师 ID | 普通 |
| par_service_profile | ParentServiceProfile | communication_tags | JSON | 否 | 沟通偏好标签 | 普通 |
| par_service_profile | ParentServiceProfile | risk_level | VARCHAR(32) | 否 | 服务风险等级 | 普通 |
| par_service_profile | ParentServiceProfile | last_service_at | DATETIME | 否 | 最近服务时间 | 普通 |
| par_leave_request | ParentLeaveRequest | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_leave_request | ParentLeaveRequest | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_leave_request | ParentLeaveRequest | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_leave_request | ParentLeaveRequest | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_leave_request | ParentLeaveRequest | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_leave_request | ParentLeaveRequest | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_leave_request | ParentLeaveRequest | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_leave_request | ParentLeaveRequest | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_leave_request | ParentLeaveRequest | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_leave_request | ParentLeaveRequest | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_leave_request | ParentLeaveRequest | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_leave_request | ParentLeaveRequest | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_leave_request | ParentLeaveRequest | leave_request_id | BIGINT | 是 | 教务请假单 ID | 普通 |
| par_leave_request | ParentLeaveRequest | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_leave_request | ParentLeaveRequest | student_id | BIGINT | 是 | 学员 ID | 普通 |
| par_leave_request | ParentLeaveRequest | lesson_id | BIGINT | 是 | 课次 ID | 普通 |
| par_leave_request | ParentLeaveRequest | submit_channel | VARCHAR(32) | 是 | 小程序/H5/App | 普通 |
| par_leave_request | ParentLeaveRequest | visible_status | VARCHAR(32) | 是 | 待审核/已通过/已驳回/已撤销 | 普通 |
| par_leave_request | ParentLeaveRequest | reject_reason | VARCHAR(512) | 否 | 驳回原因 | 普通 |
| par_leave_request | ParentLeaveRequest | makeup_notice_status | VARCHAR(32) | 否 | 无需补课/待生成/已提醒/已过期 | 普通 |
| par_leave_request | ParentLeaveRequest | file_ids | JSON | 否 | 附件文件 ID 列表，文件中心统一管理 | 普通 |
| par_leave_request | ParentLeaveRequest | evidence_snapshot | JSON | 否 | 关键凭据快照，提交后不可直接覆盖 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | arrangement_id | BIGINT | 是 | 教务补课安排 ID | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | leave_request_id | BIGINT | 是 | 关联请假单 ID | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | student_id | BIGINT | 是 | 学员 ID | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | source_lesson_id | BIGINT | 是 | 原课次 ID | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | candidate_lessons | JSON | 否 | 候选补课课次 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | confirm_deadline | DATETIME | 否 | 确认截止时间 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | confirm_status | VARCHAR(32) | 是 | 待确认/已确认/改期申请中/已取消/已过期/已完成 | 普通 |
| par_makeup_confirmation | ParentMakeupConfirmation | confirm_result | JSON | 否 | 确认结果，含选择课次、原因和处理说明 | 普通 |
| par_payment_request | ParentPaymentRequest | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_payment_request | ParentPaymentRequest | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_payment_request | ParentPaymentRequest | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_payment_request | ParentPaymentRequest | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_payment_request | ParentPaymentRequest | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_payment_request | ParentPaymentRequest | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_payment_request | ParentPaymentRequest | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_payment_request | ParentPaymentRequest | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_payment_request | ParentPaymentRequest | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_payment_request | ParentPaymentRequest | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_payment_request | ParentPaymentRequest | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_payment_request | ParentPaymentRequest | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_payment_request | ParentPaymentRequest | payment_request_no | VARCHAR(64) | 是 | 缴费请求编号，唯一 | 普通 |
| par_payment_request | ParentPaymentRequest | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_payment_request | ParentPaymentRequest | student_id | BIGINT | 是 | 学员 ID | 普通 |
| par_payment_request | ParentPaymentRequest | order_id | BIGINT | 是 | 订单 ID | 普通 |
| par_payment_request | ParentPaymentRequest | contract_id | BIGINT | 否 | 合同 ID | 普通 |
| par_payment_request | ParentPaymentRequest | hand_sign_status | VARCHAR(32) | 是 | 待签署/已签署/签署失败 | 普通 |
| par_payment_request | ParentPaymentRequest | pay_amount | DECIMAL(18,2) | 是 | 支付金额 | 普通 |
| par_payment_request | ParentPaymentRequest | discount_summary | JSON | 否 | 优惠和赠课摘要 | 普通 |
| par_payment_request | ParentPaymentRequest | pay_channel | VARCHAR(32) | 否 | 支付渠道 | 普通 |
| par_payment_request | ParentPaymentRequest | request_status | VARCHAR(32) | 是 | 待支付/支付中/成功/失败/关闭 | 普通 |
| par_contract_action | ParentContractAction | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_contract_action | ParentContractAction | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_contract_action | ParentContractAction | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_contract_action | ParentContractAction | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_contract_action | ParentContractAction | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_contract_action | ParentContractAction | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_contract_action | ParentContractAction | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_contract_action | ParentContractAction | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_contract_action | ParentContractAction | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_contract_action | ParentContractAction | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_contract_action | ParentContractAction | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_contract_action | ParentContractAction | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_contract_action | ParentContractAction | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_contract_action | ParentContractAction | student_id | BIGINT | 是 | 学员 ID | 普通 |
| par_contract_action | ParentContractAction | contract_id | BIGINT | 是 | 合同 ID | 普通 |
| par_contract_action | ParentContractAction | action_type | VARCHAR(32) | 是 | 查看/手写签署/发起支付/下载已盖章合同 | 普通 |
| par_contract_action | ParentContractAction | action_status | VARCHAR(32) | 是 | 待处理/成功/失败/已关闭 | 普通 |
| par_contract_action | ParentContractAction | sign_file_id | BIGINT | 否 | 手写签署文件 ID | 普通 |
| par_contract_action | ParentContractAction | payment_no | VARCHAR(64) | 否 | 支付流水号 | 普通 |
| par_contract_action | ParentContractAction | sealed_file_id | BIGINT | 否 | 已盖章合同文件 ID | 普通 |
| par_refund_consultation | ParentRefundConsultation | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_refund_consultation | ParentRefundConsultation | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_refund_consultation | ParentRefundConsultation | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_refund_consultation | ParentRefundConsultation | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_refund_consultation | ParentRefundConsultation | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_refund_consultation | ParentRefundConsultation | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_refund_consultation | ParentRefundConsultation | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_refund_consultation | ParentRefundConsultation | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_refund_consultation | ParentRefundConsultation | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_refund_consultation | ParentRefundConsultation | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_refund_consultation | ParentRefundConsultation | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_refund_consultation | ParentRefundConsultation | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_refund_consultation | ParentRefundConsultation | consultation_no | VARCHAR(64) | 是 | 咨询单编号，唯一 | 普通 |
| par_refund_consultation | ParentRefundConsultation | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_refund_consultation | ParentRefundConsultation | student_id | BIGINT | 是 | 学员 ID | 普通 |
| par_refund_consultation | ParentRefundConsultation | contract_id | BIGINT | 否 | 关联合同 ID | 普通 |
| par_refund_consultation | ParentRefundConsultation | consult_type | VARCHAR(32) | 是 | 退费规则咨询/材料咨询/进度咨询/其他 | 普通 |
| par_refund_consultation | ParentRefundConsultation | guide_snapshot | JSON | 否 | 线下办理规则、材料清单和校区联系方式快照 | 普通 |
| par_refund_consultation | ParentRefundConsultation | service_ticket_id | BIGINT | 否 | 关联服务工单 ID | 普通 |
| par_refund_consultation | ParentRefundConsultation | consult_status | VARCHAR(32) | 是 | 草稿/已提交/处理中/需补充/已转线下办理/已关闭 | 普通 |
| par_notification_record | ParentNotificationRecord | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_notification_record | ParentNotificationRecord | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_notification_record | ParentNotificationRecord | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_notification_record | ParentNotificationRecord | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_notification_record | ParentNotificationRecord | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_notification_record | ParentNotificationRecord | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_notification_record | ParentNotificationRecord | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_notification_record | ParentNotificationRecord | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_notification_record | ParentNotificationRecord | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_notification_record | ParentNotificationRecord | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_notification_record | ParentNotificationRecord | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_notification_record | ParentNotificationRecord | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_notification_record | ParentNotificationRecord | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_notification_record | ParentNotificationRecord | student_id | BIGINT | 否 | 学员 ID | 普通 |
| par_notification_record | ParentNotificationRecord | template_code | VARCHAR(64) | 是 | 消息模板 | 普通 |
| par_notification_record | ParentNotificationRecord | channel | VARCHAR(32) | 是 | 小程序/短信/Push/H5 | 普通 |
| par_notification_record | ParentNotificationRecord | send_status | VARCHAR(32) | 是 | 待发送/成功/失败/已读 | 普通 |
| par_notification_record | ParentNotificationRecord | biz_ref | VARCHAR(128) | 否 | 关联业务编号 | 普通 |
| par_growth_poster | GrowthPoster | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_growth_poster | GrowthPoster | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_growth_poster | GrowthPoster | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_growth_poster | GrowthPoster | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_growth_poster | GrowthPoster | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_growth_poster | GrowthPoster | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_growth_poster | GrowthPoster | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_growth_poster | GrowthPoster | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_growth_poster | GrowthPoster | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_growth_poster | GrowthPoster | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_growth_poster | GrowthPoster | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_growth_poster | GrowthPoster | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_growth_poster | GrowthPoster | poster_no | VARCHAR(64) | 是 | 海报编号，唯一 | 普通 |
| par_growth_poster | GrowthPoster | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_growth_poster | GrowthPoster | student_id | BIGINT | 是 | 学员 ID | 普通 |
| par_growth_poster | GrowthPoster | lesson_comment_id | BIGINT | 是 | 课堂点评 ID | 普通 |
| par_growth_poster | GrowthPoster | poster_template_id | BIGINT | 否 | 海报模板 ID | 普通 |
| par_growth_poster | GrowthPoster | poster_file_id | BIGINT | 否 | 生成后的海报文件 ID | 普通 |
| par_growth_poster | GrowthPoster | poster_status | VARCHAR(32) | 是 | 待生成/生成中/成功/失败/已保存/已分享 | 普通 |
| par_growth_poster | GrowthPoster | share_count | INT | 是 | 分享次数 | 普通 |
| par_service_ticket | ParentServiceTicket | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_service_ticket | ParentServiceTicket | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_service_ticket | ParentServiceTicket | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_service_ticket | ParentServiceTicket | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_service_ticket | ParentServiceTicket | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_service_ticket | ParentServiceTicket | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_service_ticket | ParentServiceTicket | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_service_ticket | ParentServiceTicket | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_service_ticket | ParentServiceTicket | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_service_ticket | ParentServiceTicket | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_service_ticket | ParentServiceTicket | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_service_ticket | ParentServiceTicket | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_service_ticket | ParentServiceTicket | ticket_no | VARCHAR(64) | 是 | 工单编号，唯一 | 普通 |
| par_service_ticket | ParentServiceTicket | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_service_ticket | ParentServiceTicket | student_id | BIGINT | 否 | 关联学员 ID | 普通 |
| par_service_ticket | ParentServiceTicket | ticket_type | VARCHAR(32) | 是 | 投诉建议/退费咨询/服务请求/其他 | 普通 |
| par_service_ticket | ParentServiceTicket | content | TEXT | 是 | 工单描述 | 普通 |
| par_service_ticket | ParentServiceTicket | contact_mobile | VARCHAR(32) | 否 | 联系人手机号，敏感 | 敏感 |
| par_service_ticket | ParentServiceTicket | ticket_status | VARCHAR(32) | 是 | 草稿/已提交/已分派/处理中/待家长确认/已关闭/已驳回/转人工 | 普通 |
| par_service_ticket | ParentServiceTicket | owner_id | BIGINT | 否 | 当前处理人 | 普通 |
| par_service_ticket | ParentServiceTicket | file_ids | JSON | 否 | 附件文件 ID 列表，文件中心统一管理 | 普通 |
| par_service_ticket | ParentServiceTicket | evidence_snapshot | JSON | 否 | 关键凭据快照，提交后不可直接覆盖 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | id | BIGINT | 是 | 主键，雪花或号段生成，禁止复用 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | tenant_id | BIGINT | 是 | 集团/租户隔离字段，所有查询必须带租户上下文 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | org_id | BIGINT | 否 | 所属组织，集团级或公共配置为空 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | campus_id | BIGINT | 否 | 所属校区，跨校区或总部级数据为空 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | created_by | BIGINT | 是 | 创建人账号 ID | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | created_at | DATETIME | 是 | 创建时间 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | updated_by | BIGINT | 否 | 最后更新人账号 ID | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | updated_at | DATETIME | 否 | 最后更新时间 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | is_deleted | TINYINT | 是 | 是否已删除，0 未删除，1 已删除 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | deleted_at | DATETIME | 否 | 删除时间，未删除为空 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | deleted_by | BIGINT | 否 | 删除人账号 ID，未删除为空 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | version | INT | 是 | 乐观锁版本号，写操作必须校验 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | ticket_id | BIGINT | 是 | 服务工单 ID | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | guardian_account_id | BIGINT | 是 | 家长账号 ID | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | score | INT | 是 | 满意度评分 1-5 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | feedback_content | VARCHAR(512) | 否 | 评价内容 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | feedback_status | VARCHAR(32) | 是 | 待提交/已提交/已撤回 | 普通 |
| par_satisfaction_feedback | ParentSatisfactionFeedback | submitted_at | DATETIME | 否 | 提交时间 | 普通 |
数据表与对象映射
| 表名 | 对象 | 用途 | 完整字段 | 索引建议 |
|---|---|---|---|---|
| par_guardian_account | GuardianAccount | 家长端账号 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、account_no(VARCHAR(64),必填)、guardian_id(BIGINT,必填)、mobile(VARCHAR(32),必填)、wechat_openid(VARCHAR(128))、agreement_version(VARCHAR(32))、last_login_channel(VARCHAR(32))、bind_status(VARCHAR(32),必填)、notification_preference(JSON) | uk_account_no、idx_mobile |
| par_login_session | ParentLoginSession | 家长端登录会话 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、guardian_account_id(BIGINT)、login_channel(VARCHAR(32),必填)、mobile(VARCHAR(32))、sms_verify_id(VARCHAR(64))、wechat_openid(VARCHAR(128))、agreement_accepted(TINYINT,必填)、login_status(VARCHAR(32),必填)、client_type(VARCHAR(32),必填)、login_at(DATETIME) | idx_account_status、idx_mobile_status |
| par_student_binding | ParentStudentBinding | 家长与学员绑定关系 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、guardian_account_id(BIGINT,必填)、student_id(BIGINT,必填)、relationship(VARCHAR(32),必填)、verify_material_ids(JSON)、verify_status(VARCHAR(32),必填)、reject_reason(VARCHAR(512))、unbind_at(DATETIME) | uk_guardian_student、idx_student |
| par_home_dashboard_snapshot | ParentHomeDashboardSnapshot | 多孩子首页聚合快照 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、guardian_account_id(BIGINT,必填)、snapshot_date(DATE,必填)、child_scope(JSON,必填)、todo_summary(JSON)、schedule_summary(JSON)、payment_summary(JSON)、message_summary(JSON)、snapshot_status(VARCHAR(32),必填) | uk_guardian_date、idx_status |
| par_service_profile | ParentServiceProfile | 家长服务档案 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、student_id(BIGINT,必填)、guardian_account_id(BIGINT,必填)、service_owner_id(BIGINT)、communication_tags(JSON)、risk_level(VARCHAR(32))、last_service_at(DATETIME) | idx_student_owner、idx_risk |
| par_leave_request | ParentLeaveRequest | 家长端请假入口 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、leave_request_id(BIGINT,必填)、guardian_account_id(BIGINT,必填)、student_id(BIGINT,必填)、lesson_id(BIGINT,必填)、submit_channel(VARCHAR(32),必填)、visible_status(VARCHAR(32),必填)、reject_reason(VARCHAR(512))、makeup_notice_status(VARCHAR(32))、file_ids(JSON)、evidence_snapshot(JSON) | idx_guardian_status、idx_leave |
| par_makeup_confirmation | ParentMakeupConfirmation | 补课安排家长确认 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、arrangement_id(BIGINT,必填)、leave_request_id(BIGINT,必填)、guardian_account_id(BIGINT,必填)、student_id(BIGINT,必填)、source_lesson_id(BIGINT,必填)、candidate_lessons(JSON)、confirm_deadline(DATETIME)、confirm_status(VARCHAR(32),必填)、confirm_result(JSON) | idx_guardian_status、idx_leave |
| par_payment_request | ParentPaymentRequest | 家长端缴费请求 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、payment_request_no(VARCHAR(64),必填)、guardian_account_id(BIGINT,必填)、student_id(BIGINT,必填)、order_id(BIGINT,必填)、contract_id(BIGINT)、hand_sign_status(VARCHAR(32),必填)、pay_amount(DECIMAL(18,2),必填)、discount_summary(JSON)、pay_channel(VARCHAR(32))、request_status(VARCHAR(32),必填) | uk_payment_request_no、idx_guardian_status |
| par_contract_action | ParentContractAction | 家长合同查看签署与支付操作 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、guardian_account_id(BIGINT,必填)、student_id(BIGINT,必填)、contract_id(BIGINT,必填)、action_type(VARCHAR(32),必填)、action_status(VARCHAR(32),必填)、sign_file_id(BIGINT)、payment_no(VARCHAR(64))、sealed_file_id(BIGINT) | idx_contract_action、idx_guardian_status |
| par_refund_consultation | ParentRefundConsultation | 退费咨询与线下办理指引 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、consultation_no(VARCHAR(64),必填)、guardian_account_id(BIGINT,必填)、student_id(BIGINT,必填)、contract_id(BIGINT)、consult_type(VARCHAR(32),必填)、guide_snapshot(JSON)、service_ticket_id(BIGINT)、consult_status(VARCHAR(32),必填) | uk_consultation_no、idx_guardian_status |
| par_notification_record | ParentNotificationRecord | 家长端通知触达 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、guardian_account_id(BIGINT,必填)、student_id(BIGINT)、template_code(VARCHAR(64),必填)、channel(VARCHAR(32),必填)、send_status(VARCHAR(32),必填)、biz_ref(VARCHAR(128)) | idx_guardian_status、idx_biz |
| par_growth_poster | GrowthPoster | 成长喜报海报 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、poster_no(VARCHAR(64),必填)、guardian_account_id(BIGINT,必填)、student_id(BIGINT,必填)、lesson_comment_id(BIGINT,必填)、poster_template_id(BIGINT)、poster_file_id(BIGINT)、poster_status(VARCHAR(32),必填)、share_count(INT,必填) | uk_poster_no、idx_student_status |
| par_service_ticket | ParentServiceTicket | 家长端服务工单 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、ticket_no(VARCHAR(64),必填)、guardian_account_id(BIGINT,必填)、student_id(BIGINT)、ticket_type(VARCHAR(32),必填)、content(TEXT,必填)、contact_mobile(VARCHAR(32))、ticket_status(VARCHAR(32),必填)、owner_id(BIGINT)、file_ids(JSON)、evidence_snapshot(JSON) | uk_ticket_no、idx_guardian_status、idx_student |
| par_satisfaction_feedback | ParentSatisfactionFeedback | 家长服务满意度评价 | id(BIGINT,必填)、tenant_id(BIGINT,必填)、org_id(BIGINT)、campus_id(BIGINT)、created_by(BIGINT,必填)、created_at(DATETIME,必填)、updated_by(BIGINT)、updated_at(DATETIME)、is_deleted(TINYINT,必填)、deleted_at(DATETIME)、deleted_by(BIGINT)、version(INT,必填)、ticket_id(BIGINT,必填)、guardian_account_id(BIGINT,必填)、score(INT,必填)、feedback_content(VARCHAR(512))、feedback_status(VARCHAR(32),必填)、submitted_at(DATETIME) | uk_ticket_guardian、idx_score |
12 · 状态机与业务规则
约束业务对象如何流转、何时可编辑、何时触发审批
原型需要把状态标签、可操作按钮和禁用原因展示清楚。| 对象 | 状态 | 触发与说明 |
|---|---|---|
| 家长登录 | 未登录 -> 协议未勾选 -> 验证码发送中 -> 验证码错误 -> 登录中 -> 登录成功 -> 账号异常 -> 需绑定学员 | 微信登录和手机号验证码登录的前置状态 |
| 监护关系认证 | 未绑定 -> 待认证 -> 认证中 -> 已认证 -> 认证失败 -> 已解绑 -> 转人工 | 学员绑定和监护关系认证决定家长可见数据范围 |
| 多孩子首页上下文 | 全部孩子聚合 -> 按孩子筛选 -> 无待办 -> 加载失败 -> 数据过期 -> 需重新同步 | 首页默认聚合多孩子待办、课表和消息，标签筛选只改变当前页面上下文 |
| 请假申请 | 可申请 -> 草稿 -> 已提交 -> 老师/教务审核中 -> 审核通过 -> 审核驳回 -> 已撤回 -> 已关闭 | 请假提交后必须先审核，审核通过后才进入补课安排 |
| 补课安排 | 待安排 -> 待家长确认 -> 已确认 -> 候选过期 -> 改期申请中 -> 已取消 -> 已完成 -> 异常待处理 | 补课页带入原课次，家长可确认候选或申请改期 |
| 合同签署支付 | 待查看 -> 待签署 -> 已签署 -> 待支付 -> 支付中 -> 支付成功 -> 支付失败 -> 企业盖章中 -> 已盖章 -> 已关闭 | 家长先签署再支付，支付结果回写合同与消息 |
| 退费咨询 | 未咨询 -> 咨询草稿 -> 已提交 -> 服务处理中 -> 需补充材料 -> 已转线下办理 -> 已关闭 | 家长端只做咨询和线下办理指引，不触发线上退款审批 |
| 家校消息 | 未读 -> 已读 -> 已跳转 -> 对象失效 -> 已删除 | 课堂点评、作业、测评、回访和系统通知聚合到消息中心 |
| 成长喜报 | 待生成 -> 生成中 -> 生成成功 -> 生成失败 -> 已保存 -> 已分享 | 优秀课堂点评生成可保存和分享的海报 |
| 服务工单 | 草稿 -> 已提交 -> 已分派 -> 处理中 -> 待家长确认 -> 已补充 -> 已关闭 -> 已评价 -> 已驳回 -> 转人工 | 投诉建议、退费咨询和服务请求的处理闭环 |
唯一性校验
家长端服务中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
跨校区数据隔离
家长端服务中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
敏感操作留痕
家长端服务中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
外部接口幂等
家长端服务中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
批量失败明细
家长端服务中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
状态回退审批
家长端服务中心涉及该规则时，必须在前端提示、后端校验、审计日志和测试用例中同时覆盖。
13 · 权限、审批与消息
动作权限、数据范围、审批触发和消息触达必须闭环
权限需要覆盖菜单、按钮、字段、接口和导出。动作权限
- 微信登录：需映射菜单、按钮、接口和字段权限
- 手机号验证码登录：需映射菜单、按钮、接口和字段权限
- 绑定学员：需映射菜单、按钮、接口和字段权限
- 查看多孩子首页：需映射菜单、按钮、接口和字段权限
- 查看课表：需映射菜单、按钮、接口和字段权限
- 提交请假：需映射菜单、按钮、接口和字段权限
- 查看审核结果：需映射菜单、按钮、接口和字段权限
- 确认补课：需映射菜单、按钮、接口和字段权限
- 查看合同：需映射菜单、按钮、接口和字段权限
- 手写签署：需映射菜单、按钮、接口和字段权限
- 在线缴费：需映射菜单、按钮、接口和字段权限
- 查看支付结果：需映射菜单、按钮、接口和字段权限
- 提交退费咨询：需映射菜单、按钮、接口和字段权限
- 生成成长喜报：需映射菜单、按钮、接口和字段权限
- 提交工单：需映射菜单、按钮、接口和字段权限
- 确认关闭：需映射菜单、按钮、接口和字段权限
- 评价满意度：需映射菜单、按钮、接口和字段权限
数据范围
- 总部全量
- 区域辖区
- 校区本地
- 部门/岗位
- 本人负责
- 授权班级/学员
审批配置
| 审批名称 | 触发条件 | 流程 | 结果 | 留痕 |
|---|---|---|---|---|
| 监护关系人工认证 | 家长绑定学员失败、关系证明无法自动校验或疑似冒用 | 家长提交 -> 班主任/学管师审核 -> 校区管理员复核可选 | 通过后开放该学员数据访问，驳回后展示原因和重试入口 | 保留证明材料、审核意见、处理人和认证结果 |
| 请假审核结果展示 | 家长提交请假后由老师/教务审核，家长端只展示审核状态和原因 | 教师/教务审核 -> 家长端消息触达 | 通过后生成补课提醒，驳回后展示原因 | 家长端不承接内部审批，仅接收结果和可操作下一步 |
| 服务工单转人工 | 投诉建议、退费咨询或服务请求需要升级到人工服务 | 家长提交 -> 班主任/学管师 -> 校区负责人可选 | 通过后进入人工处理，家长端展示当前处理进度 | 保留转人工原因、附件、处理节点和关闭确认 |
| 工单关闭确认 | 服务工单处理完成后需家长确认关闭并评价 | 服务人员处理 -> 家长确认关闭/评价 | 确认后进入已关闭并可提交满意度 | 评价仅允许一次，关闭后保留历史记录 |
消息模板
| 消息 | 接收人 | 触发 | 渠道 | 变量 |
|---|---|---|---|---|
| 登录与绑定状态提醒 | 家长 | 验证码错误、账号异常、监护关系认证通过/驳回、需补充材料 | 家长端小程序/H5、短信可选 | 手机号、认证状态、驳回原因、重试入口 |
| 多孩子首页待办提醒 | 家长 | 今日课程、待签合同、待缴费、待确认补课、未读服务消息刷新 | 家长端首页、Push 可选 | 学员、待办类型、截止时间、处理入口 |
| 请假审核结果提醒 | 家长 | 请假审核通过、驳回或需补充材料 | 家长端小程序/H5、站内信 | 课程、课次、审核结果、驳回原因、补课入口 |
| 补课安排提醒 | 家长 | 补课候选生成、确认截止临近、候选过期、改期结果 | 家长端小程序/H5、站内信 | 原课次、候选时间、确认截止、处理状态 |
| 合同签署缴费提醒 | 家长 | 合同待签署、待支付、支付成功、支付失败、企业盖章完成 | 家长端小程序/H5、短信可选 | 合同编号、课程权益、应付金额、签署/支付入口 |
| 退费咨询处理提醒 | 家长 | 退费咨询提交、需补充材料、已转线下办理、处理完成 | 家长端小程序/H5、站内信 | 咨询单号、材料清单、校区联系方式、处理结果 |
| 成长喜报生成提醒 | 家长 | 课堂优秀点评可生成海报、海报生成成功或失败 | 家长端小程序/H5 | 学员、课程、点评摘要、海报入口 |
| 服务工单处理提醒 | 家长 | 工单分派、处理中、需补充、待确认关闭、已关闭、待评价 | 家长端小程序/H5、站内信 | 工单编号、当前状态、处理人、下一步动作 |
14 · 接口与技术细节
接口需支持幂等、权限、审计、重试和回执
每个写接口必须有 requestId 或业务幂等键，外部回调必须验签和去重。| 接口 | 方法 | 方向 | 请求字段 | 响应字段 | 幂等/权限 |
|---|---|---|---|---|---|
| /api/v1/parent/auth/wechat-login | POST | 家长端小程序/H5到认证中心 | wechatCode, agreementAccepted, clientType, requestId | accessToken, accountStatus, bindSummary, nextAction | 协议勾选校验；requestId 幂等 |
| /api/v1/parent/auth/sms-login | POST | 家长端小程序/H5到认证中心 | mobile, smsCode, agreementAccepted, clientType, requestId | accessToken, accountStatus, bindSummary, nextAction | 验证码校验；协议未勾选阻断 |
| /api/v1/parent/students | GET | 家长端到平台 | guardianAccountId, relationStatus | studentList, serviceSummary, pendingTodoCount | 绑定关系和监护关系校验 |
| /api/v1/parent/student-bindings | POST/GET | 家长端到平台 | guardianAccountId, studentName, studentMobile, relationship, verifyPayload, requestId | bindingId, verifyStatus, rejectReason, nextAction | 手机号 + 学员 + 关系去重 |
| /api/v1/parent/home-dashboard | GET | 家长端到平台 | guardianAccountId, childFilter, date | todoCards, scheduleSummary, paymentTips, messageSummary, serviceTips | 只返回绑定学员范围内数据 |
| /api/v1/parent/schedules | GET | 家长端到教务 | guardianAccountId, studentId, dateRange, viewMode | calendarItems, lessonCards, attendanceSummary | 监护关系校验 |
| /api/v1/parent/lesson-detail/{lessonId} | GET | 家长端到教务 | guardianAccountId, studentId, lessonId | lessonDetail, attendanceStatus, consumptionStatus, availableActions | 课次和学员绑定关系校验 |
| /api/v1/edu/leaves | POST/GET | 家长端到教务 | studentId, lessonId, leaveReason, attachments, requestId | leaveId, leaveStatus, makeupArrangeStatus, notifyStatus | 请假提交后进入老师/教务审核；studentId + lessonId 单活跃请假 |
| /api/v1/edu/makeup-arrangements | GET/PATCH | 家长端到教务 | leaveId, arrangementId, action, candidateLessonId, reason, requestId | confirmStatus, arrangedLesson, confirmDeadline, notifyStatus | 仅审核通过后的请假可确认补课 |
| /api/v1/parent/contracts | GET | 家长端到合同中心 | guardianAccountId, studentId, contractStatus, paymentStatus | contractList, todoCount, expiredTips | 只返回绑定学员合同 |
| /api/v1/parent/contracts/{id} | GET | 家长端到合同中心 | contractId, guardianAccountId | contractDetail, rightsSummary, quoteSummary, signStatus, paymentStatus, sealStatus | 合同查看权限校验 |
| /api/v1/contracts/{id}/guardian-hand-sign | POST | 家长端到合同中心 | contractId, guardianId, handSignFileId, signTrace, requestId | handSignStatus, nextAction | 家长手写签字完成后才开放支付 |
| /api/v1/parent/payments | POST/GET | 家长端到支付服务 | studentId, contractId, payChannel, amount, requestId | payUrl, paymentNo, paymentStatus, retryable | 不支持分期付款；支付前校验签署状态 |
| /api/v1/parent/refund-consultations | POST/GET | 家长端到服务中心 | studentId, contractId, consultType, content, attachments, requestId | consultationId, ticketId, guideInfo, handleStatus | 只创建退费咨询/线下办理指引，不创建退款审批 |
| /api/v1/parent/messages | GET/PATCH | 家长端到消息中心 | guardianAccountId, studentId, category, readStatus, messageIds | messageList, unreadCount, readResult | 只能处理本人消息 |
| /api/v1/parent/growth-posters | POST/GET | 家长端到教学服务 | lessonCommentId, guardianAccountId, posterTemplateId, requestId | posterId, posterUrl, generateStatus, sharePayload | 优秀点评可生成成长喜报海报 |
| /api/v1/parent/service-tickets | POST/GET | 家长端到服务中心 | studentId, ticketType, content, attachments, contactMobile, requestId | ticketId, ticketNo, ticketStatus, owner | 绑定关系校验；退费类只作为咨询工单 |
| /api/v1/parent/service-tickets/{id} | GET/PATCH | 家长端到服务中心 | ticketId, action, supplementContent, satisfactionScore, requestId | ticketDetail, nextStatus, closeStatus, satisfactionStatus | 确认关闭和满意度评价幂等 |
前端约束
- 统一登录态和租户校区上下文
- 列表分页、筛选、排序、列显隐
- 表单本地校验与服务端错误映射
- 移动/平板/TV 按终端适配交互
后端约束
- 领域服务封装业务规则
- 写操作事务一致性
- 关键操作审计快照
- 异步任务失败重试和告警
集成约束
- 第三方接口统一走开放集成中心
- 回执文件归档
- 接口日志可按业务单号追踪
- 密钥和回调地址按环境隔离
15 · 数据库与存储设计
核心表建议、关键字段和索引方向
详细 DDL 已在平台技术设计文档中统一展开，本处保留模块核心表、关键字段和索引方向。| 表名 | 用途 | 核心字段 | 索引建议 |
|---|---|---|---|
| par_guardian_account | 家长端账号 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、account_no、guardian_id、mobile、wechat_openid、agreement_version、last_login_channel、bind_status、notification_preference | uk_account_no、idx_mobile |
| par_login_session | 家长端登录会话 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、guardian_account_id、login_channel、mobile、sms_verify_id、wechat_openid、agreement_accepted、login_status、client_type、login_at | idx_account_status、idx_mobile_status |
| par_student_binding | 家长与学员绑定关系 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、guardian_account_id、student_id、relationship、verify_material_ids、verify_status、reject_reason、unbind_at | uk_guardian_student、idx_student |
| par_home_dashboard_snapshot | 多孩子首页聚合快照 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、guardian_account_id、snapshot_date、child_scope、todo_summary、schedule_summary、payment_summary、message_summary、snapshot_status | uk_guardian_date、idx_status |
| par_service_profile | 家长服务档案 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、student_id、guardian_account_id、service_owner_id、communication_tags、risk_level、last_service_at | idx_student_owner、idx_risk |
| par_leave_request | 家长端请假入口 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、leave_request_id、guardian_account_id、student_id、lesson_id、submit_channel、visible_status、reject_reason、makeup_notice_status、file_ids、evidence_snapshot | idx_guardian_status、idx_leave |
| par_makeup_confirmation | 补课安排家长确认 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、arrangement_id、leave_request_id、guardian_account_id、student_id、source_lesson_id、candidate_lessons、confirm_deadline、confirm_status、confirm_result | idx_guardian_status、idx_leave |
| par_payment_request | 家长端缴费请求 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、payment_request_no、guardian_account_id、student_id、order_id、contract_id、hand_sign_status、pay_amount、discount_summary、pay_channel、request_status | uk_payment_request_no、idx_guardian_status |
| par_contract_action | 家长合同查看签署与支付操作 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、guardian_account_id、student_id、contract_id、action_type、action_status、sign_file_id、payment_no、sealed_file_id | idx_contract_action、idx_guardian_status |
| par_refund_consultation | 退费咨询与线下办理指引 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、consultation_no、guardian_account_id、student_id、contract_id、consult_type、guide_snapshot、service_ticket_id、consult_status | uk_consultation_no、idx_guardian_status |
| par_notification_record | 家长端通知触达 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、guardian_account_id、student_id、template_code、channel、send_status、biz_ref | idx_guardian_status、idx_biz |
| par_growth_poster | 成长喜报海报 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、poster_no、guardian_account_id、student_id、lesson_comment_id、poster_template_id、poster_file_id、poster_status、share_count | uk_poster_no、idx_student_status |
| par_service_ticket | 家长端服务工单 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、ticket_no、guardian_account_id、student_id、ticket_type、content、contact_mobile、ticket_status、owner_id、file_ids、evidence_snapshot | uk_ticket_no、idx_guardian_status、idx_student |
| par_satisfaction_feedback | 家长服务满意度评价 | id、tenant_id、org_id、campus_id、created_by、created_at、updated_by、updated_at、is_deleted、deleted_at、deleted_by、version、ticket_id、guardian_account_id、score、feedback_content、feedback_status、submitted_at | uk_ticket_guardian、idx_score |
DDL 草案
par_guardian_accountGuardianAccount
CREATE TABLE `par_guardian_account` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`account_no` VARCHAR(64) NOT NULL COMMENT '家长账号编号，唯一；数据级别：普通',
`guardian_id` BIGINT NOT NULL COMMENT '监护人 ID；数据级别：普通',
`mobile` VARCHAR(32) NOT NULL COMMENT '手机号，敏感；数据级别：敏感',
`wechat_openid` VARCHAR(128) NULL COMMENT '微信 OpenID，敏感；数据级别：敏感',
`agreement_version` VARCHAR(32) NULL COMMENT '最近一次勾选的用户协议/隐私政策版本；数据级别：普通',
`last_login_channel` VARCHAR(32) NULL COMMENT '最近登录方式：微信/手机号验证码；数据级别：普通',
`bind_status` VARCHAR(32) NOT NULL COMMENT '待绑定/已绑定/已解绑/停用；数据级别：普通',
`notification_preference` JSON NULL COMMENT '消息偏好；数据级别：普通',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_account_no` (`account_no`),
KEY `idx_mobile` (`mobile`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='GuardianAccount：家长端账号';par_login_sessionParentLoginSession
CREATE TABLE `par_login_session` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`guardian_account_id` BIGINT NULL COMMENT '家长账号 ID，未完成登录时可为空；数据级别：普通',
`login_channel` VARCHAR(32) NOT NULL COMMENT '微信登录/手机号验证码登录；数据级别：普通',
`mobile` VARCHAR(32) NULL COMMENT '登录手机号，敏感；数据级别：敏感',
`sms_verify_id` VARCHAR(64) NULL COMMENT '短信校验流水，不存储明文验证码；数据级别：普通',
`wechat_openid` VARCHAR(128) NULL COMMENT '微信 OpenID，敏感；数据级别：敏感',
`agreement_accepted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已勾选协议；数据级别：普通',
`login_status` VARCHAR(32) NOT NULL COMMENT '待校验/成功/验证码错误/协议未勾选/账号异常；数据级别：普通',
`client_type` VARCHAR(32) NOT NULL COMMENT '微信小程序/H5；数据级别：普通',
`login_at` DATETIME NULL COMMENT '登录成功时间；数据级别：普通',
PRIMARY KEY (`id`),
KEY `idx_account_status` (`guardian_account_id`, `login_status`),
KEY `idx_mobile_status` (`mobile`, `login_status`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentLoginSession：家长端登录会话';par_student_bindingParentStudentBinding
CREATE TABLE `par_student_binding` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
`relationship` VARCHAR(32) NOT NULL COMMENT '关系；数据级别：普通',
`verify_material_ids` JSON NULL COMMENT '监护关系证明材料文件 ID；数据级别：普通',
`verify_status` VARCHAR(32) NOT NULL COMMENT '待验证/已验证/已拒绝/已解绑；数据级别：普通',
`reject_reason` VARCHAR(512) NULL COMMENT '认证失败原因；数据级别：普通',
`unbind_at` DATETIME NULL COMMENT '解绑时间；数据级别：普通',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_guardian_student` (`guardian_account_id`, `student_id`),
KEY `idx_student` (`student_id`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentStudentBinding：家长与学员绑定关系';par_home_dashboard_snapshotParentHomeDashboardSnapshot
CREATE TABLE `par_home_dashboard_snapshot` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`snapshot_date` DATE NOT NULL COMMENT '快照日期；数据级别：普通',
`child_scope` JSON NOT NULL COMMENT '本次聚合的学员 ID 列表；数据级别：普通',
`todo_summary` JSON NULL COMMENT '待办汇总，含课程、合同、补课、工单和消息；数据级别：普通',
`schedule_summary` JSON NULL COMMENT '课表摘要；数据级别：普通',
`payment_summary` JSON NULL COMMENT '合同缴费摘要；数据级别：普通',
`message_summary` JSON NULL COMMENT '消息摘要；数据级别：普通',
`snapshot_status` VARCHAR(32) NOT NULL COMMENT '正常/刷新中/刷新失败/数据过期；数据级别：普通',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_guardian_date` (`guardian_account_id`, `snapshot_date`),
KEY `idx_status` (`snapshot_status`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentHomeDashboardSnapshot：多孩子首页聚合快照';par_service_profileParentServiceProfile
CREATE TABLE `par_service_profile` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`service_owner_id` BIGINT NULL COMMENT '班主任/学管师 ID；数据级别：普通',
`communication_tags` JSON NULL COMMENT '沟通偏好标签；数据级别：普通',
`risk_level` VARCHAR(32) NULL COMMENT '服务风险等级；数据级别：普通',
`last_service_at` DATETIME NULL COMMENT '最近服务时间；数据级别：普通',
PRIMARY KEY (`id`),
KEY `idx_student_owner` (`student_id`, `service_owner_id`),
KEY `idx_risk` (`risk_level`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentServiceProfile：家长服务档案';par_leave_requestParentLeaveRequest
CREATE TABLE `par_leave_request` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`leave_request_id` BIGINT NOT NULL COMMENT '教务请假单 ID；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
`lesson_id` BIGINT NOT NULL COMMENT '课次 ID；数据级别：普通',
`submit_channel` VARCHAR(32) NOT NULL COMMENT '小程序/H5/App；数据级别：普通',
`visible_status` VARCHAR(32) NOT NULL COMMENT '待审核/已通过/已驳回/已撤销；数据级别：普通',
`reject_reason` VARCHAR(512) NULL COMMENT '驳回原因；数据级别：普通',
`makeup_notice_status` VARCHAR(32) NULL COMMENT '无需补课/待生成/已提醒/已过期；数据级别：普通',
`file_ids` JSON NULL COMMENT '附件文件 ID 列表，文件中心统一管理；数据级别：普通',
`evidence_snapshot` JSON NULL COMMENT '关键凭据快照，提交后不可直接覆盖；数据级别：普通',
PRIMARY KEY (`id`),
KEY `idx_guardian_status` (`guardian_account_id`, `visible_status`),
KEY `idx_leave` (`leave_request_id`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentLeaveRequest：家长端请假入口';par_makeup_confirmationParentMakeupConfirmation
CREATE TABLE `par_makeup_confirmation` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`arrangement_id` BIGINT NOT NULL COMMENT '教务补课安排 ID；数据级别：普通',
`leave_request_id` BIGINT NOT NULL COMMENT '关联请假单 ID；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
`source_lesson_id` BIGINT NOT NULL COMMENT '原课次 ID；数据级别：普通',
`candidate_lessons` JSON NULL COMMENT '候选补课课次；数据级别：普通',
`confirm_deadline` DATETIME NULL COMMENT '确认截止时间；数据级别：普通',
`confirm_status` VARCHAR(32) NOT NULL COMMENT '待确认/已确认/改期申请中/已取消/已过期/已完成；数据级别：普通',
`confirm_result` JSON NULL COMMENT '确认结果，含选择课次、原因和处理说明；数据级别：普通',
PRIMARY KEY (`id`),
KEY `idx_guardian_status` (`guardian_account_id`, `confirm_status`),
KEY `idx_leave` (`leave_request_id`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentMakeupConfirmation：补课安排家长确认';par_payment_requestParentPaymentRequest
CREATE TABLE `par_payment_request` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`payment_request_no` VARCHAR(64) NOT NULL COMMENT '缴费请求编号，唯一；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
`order_id` BIGINT NOT NULL COMMENT '订单 ID；数据级别：普通',
`contract_id` BIGINT NULL COMMENT '合同 ID；数据级别：普通',
`hand_sign_status` VARCHAR(32) NOT NULL COMMENT '待签署/已签署/签署失败；数据级别：普通',
`pay_amount` DECIMAL(18,2) NOT NULL COMMENT '支付金额；数据级别：普通',
`discount_summary` JSON NULL COMMENT '优惠和赠课摘要；数据级别：普通',
`pay_channel` VARCHAR(32) NULL COMMENT '支付渠道；数据级别：普通',
`request_status` VARCHAR(32) NOT NULL COMMENT '待支付/支付中/成功/失败/关闭；数据级别：普通',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_payment_request_no` (`payment_request_no`),
KEY `idx_guardian_status` (`guardian_account_id`, `hand_sign_status`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentPaymentRequest：家长端缴费请求';par_contract_actionParentContractAction
CREATE TABLE `par_contract_action` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
`contract_id` BIGINT NOT NULL COMMENT '合同 ID；数据级别：普通',
`action_type` VARCHAR(32) NOT NULL COMMENT '查看/手写签署/发起支付/下载已盖章合同；数据级别：普通',
`action_status` VARCHAR(32) NOT NULL COMMENT '待处理/成功/失败/已关闭；数据级别：普通',
`sign_file_id` BIGINT NULL COMMENT '手写签署文件 ID；数据级别：普通',
`payment_no` VARCHAR(64) NULL COMMENT '支付流水号；数据级别：普通',
`sealed_file_id` BIGINT NULL COMMENT '已盖章合同文件 ID；数据级别：普通',
PRIMARY KEY (`id`),
KEY `idx_contract_action` (`contract_id`, `action_type`),
KEY `idx_guardian_status` (`guardian_account_id`, `action_status`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentContractAction：家长合同查看签署与支付操作';par_refund_consultationParentRefundConsultation
CREATE TABLE `par_refund_consultation` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`consultation_no` VARCHAR(64) NOT NULL COMMENT '咨询单编号，唯一；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
`contract_id` BIGINT NULL COMMENT '关联合同 ID；数据级别：普通',
`consult_type` VARCHAR(32) NOT NULL COMMENT '退费规则咨询/材料咨询/进度咨询/其他；数据级别：普通',
`guide_snapshot` JSON NULL COMMENT '线下办理规则、材料清单和校区联系方式快照；数据级别：普通',
`service_ticket_id` BIGINT NULL COMMENT '关联服务工单 ID；数据级别：普通',
`consult_status` VARCHAR(32) NOT NULL COMMENT '草稿/已提交/处理中/需补充/已转线下办理/已关闭；数据级别：普通',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_consultation_no` (`consultation_no`),
KEY `idx_guardian_status` (`guardian_account_id`, `consult_status`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentRefundConsultation：退费咨询与线下办理指引';par_notification_recordParentNotificationRecord
CREATE TABLE `par_notification_record` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`student_id` BIGINT NULL COMMENT '学员 ID；数据级别：普通',
`template_code` VARCHAR(64) NOT NULL COMMENT '消息模板；数据级别：普通',
`channel` VARCHAR(32) NOT NULL COMMENT '小程序/短信/Push/H5；数据级别：普通',
`send_status` VARCHAR(32) NOT NULL COMMENT '待发送/成功/失败/已读；数据级别：普通',
`biz_ref` VARCHAR(128) NULL COMMENT '关联业务编号；数据级别：普通',
PRIMARY KEY (`id`),
KEY `idx_guardian_status` (`guardian_account_id`, `send_status`),
KEY `idx_biz` (`biz_ref`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentNotificationRecord：家长端通知触达';par_growth_posterGrowthPoster
CREATE TABLE `par_growth_poster` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`poster_no` VARCHAR(64) NOT NULL COMMENT '海报编号，唯一；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`student_id` BIGINT NOT NULL COMMENT '学员 ID；数据级别：普通',
`lesson_comment_id` BIGINT NOT NULL COMMENT '课堂点评 ID；数据级别：普通',
`poster_template_id` BIGINT NULL COMMENT '海报模板 ID；数据级别：普通',
`poster_file_id` BIGINT NULL COMMENT '生成后的海报文件 ID；数据级别：普通',
`poster_status` VARCHAR(32) NOT NULL COMMENT '待生成/生成中/成功/失败/已保存/已分享；数据级别：普通',
`share_count` INT NOT NULL DEFAULT 0 COMMENT '分享次数；数据级别：普通',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_poster_no` (`poster_no`),
KEY `idx_student_status` (`student_id`, `poster_status`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='GrowthPoster：成长喜报海报';par_service_ticketParentServiceTicket
CREATE TABLE `par_service_ticket` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`ticket_no` VARCHAR(64) NOT NULL COMMENT '工单编号，唯一；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`student_id` BIGINT NULL COMMENT '关联学员 ID；数据级别：普通',
`ticket_type` VARCHAR(32) NOT NULL COMMENT '投诉建议/退费咨询/服务请求/其他；数据级别：普通',
`content` TEXT NOT NULL COMMENT '工单描述；数据级别：普通',
`contact_mobile` VARCHAR(32) NULL COMMENT '联系人手机号，敏感；数据级别：敏感',
`ticket_status` VARCHAR(32) NOT NULL COMMENT '草稿/已提交/已分派/处理中/待家长确认/已关闭/已驳回/转人工；数据级别：普通',
`owner_id` BIGINT NULL COMMENT '当前处理人；数据级别：普通',
`file_ids` JSON NULL COMMENT '附件文件 ID 列表，文件中心统一管理；数据级别：普通',
`evidence_snapshot` JSON NULL COMMENT '关键凭据快照，提交后不可直接覆盖；数据级别：普通',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_ticket_no` (`ticket_no`),
KEY `idx_guardian_status` (`guardian_account_id`, `ticket_status`),
KEY `idx_student` (`student_id`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentServiceTicket：家长端服务工单';par_satisfaction_feedbackParentSatisfactionFeedback
CREATE TABLE `par_satisfaction_feedback` (
`id` BIGINT NOT NULL COMMENT '主键，雪花或号段生成，禁止复用；数据级别：普通',
`tenant_id` BIGINT NOT NULL COMMENT '集团/租户隔离字段，所有查询必须带租户上下文；数据级别：普通',
`org_id` BIGINT NULL COMMENT '所属组织，集团级或公共配置为空；数据级别：普通',
`campus_id` BIGINT NULL COMMENT '所属校区，跨校区或总部级数据为空；数据级别：普通',
`created_by` BIGINT NOT NULL COMMENT '创建人账号 ID；数据级别：普通',
`created_at` DATETIME NOT NULL COMMENT '创建时间；数据级别：普通',
`updated_by` BIGINT NULL COMMENT '最后更新人账号 ID；数据级别：普通',
`updated_at` DATETIME NULL COMMENT '最后更新时间；数据级别：普通',
`is_deleted` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已删除，0 未删除，1 已删除；数据级别：普通',
`deleted_at` DATETIME NULL COMMENT '删除时间，未删除为空；数据级别：普通',
`deleted_by` BIGINT NULL COMMENT '删除人账号 ID，未删除为空；数据级别：普通',
`version` INT NOT NULL DEFAULT 1 COMMENT '乐观锁版本号，写操作必须校验；数据级别：普通',
`ticket_id` BIGINT NOT NULL COMMENT '服务工单 ID；数据级别：普通',
`guardian_account_id` BIGINT NOT NULL COMMENT '家长账号 ID；数据级别：普通',
`score` INT NOT NULL COMMENT '满意度评分 1-5；数据级别：普通',
`feedback_content` VARCHAR(512) NULL COMMENT '评价内容；数据级别：普通',
`feedback_status` VARCHAR(32) NOT NULL COMMENT '待提交/已提交/已撤回；数据级别：普通',
`submitted_at` DATETIME NULL COMMENT '提交时间；数据级别：普通',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_ticket_guardian` (`ticket_id`, `guardian_account_id`),
KEY `idx_score` (`score`),
KEY `idx_tenant_deleted` (`tenant_id`, `is_deleted`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='ParentSatisfactionFeedback：家长服务满意度评价';16 · 异常、指标、测试与初始化
保证模块上线后可运营、可追踪、可验收
测试要覆盖主流程、异常流、权限流、接口失败和数据一致性。异常状态
协议未勾选验证码错误监护关系未认证绑定关系异常请假重复提交补课候选过期合同待签署支付失败海报生成失败工单已关闭满意度已提交接口超时
指标埋点
家长登录成功率学员绑定成功率多孩子首页待办点击率请假审核通过后补课确认率缴费完成率支付失败重试成功率成长喜报保存分享率工单关闭确认率满意度评价提交率
测试用例
| 编号 | 场景 | 前置 | 步骤 | 预期 | 优先级 |
|---|---|---|---|---|---|
| TC-PAR-AUTH-001 | 微信登录与协议勾选 | 家长未登录且微信授权服务可用 | 打开 P01，未勾选协议点击微信登录，再勾选协议后完成授权登录 | 未勾选协议时阻断；授权成功后进入绑定或首页；登录状态和审计记录正确 | 高 |
| TC-PAR-AUTH-002 | 手机号验证码登录 | 短信服务可用且手机号存在家长账号 | 输入手机号，获取验证码，分别输入错误验证码和正确验证码 | 错误验证码提示明确；正确验证码登录成功；倒计时和重发规则正确 | 高 |
| TC-PAR-BIND-001 | 学员绑定与监护关系认证 | 家长账号未绑定学员 | 提交学员姓名、手机号、关系和证明材料，模拟通过与驳回 | 通过后首页显示该学员数据；驳回展示原因和重试/转人工入口 | 高 |
| TC-PAR-HOME-001 | 多孩子首页聚合展示 | 家长绑定两个学员且都有待办、课表和消息 | 进入 P03，查看全部孩子聚合看板并切换孩子标签 | 默认展示全部孩子待办；切换标签仅影响当前页面上下文；数据不串孩子 | 高 |
| TC-PAR-LEAVE-001 | 请假审核后补课联动 | 课次可请假且教务审核流可用 | 从课次详情提交请假，模拟审核通过，进入补课安排并确认候选课次 | 请假提交后先为审核中；审核通过后才出现补课入口；补课自动带入原课次 | 高 |
| TC-PAR-LEAVE-002 | 请假驳回与候选过期 | 请假已提交或补课候选已生成 | 模拟请假驳回、补课候选过期和补课名额已满 | 家长端展示驳回原因、候选过期原因和可联系校区/重新安排入口 | 中 |
| TC-PAR-CON-001 | 合同签署后缴费 | 员工端已推送合同到家长端 | 家长查看合同详情、报价优惠，未签署尝试支付，完成手写签署后支付 | 未签署不可支付；签署后收银台可用；支付成功后合同状态和消息更新 | 高 |
| TC-PAR-CON-002 | 收银台不展示分期和发票 | 存在待支付合同 | 进入在线缴费/收银台和合同详情 | 页面不出现分期方案、分期账单、发票申请、开票记录和发票抬头入口 | 高 |
| TC-PAR-REFUND-001 | 退费咨询线下办理指引 | 家长有退费咨询需求 | 进入 P13 查看规则，提交退费咨询工单并查看处理进度 | 只生成咨询/服务工单，不创建退款审批；展示材料清单和校区联系方式 | 高 |
| TC-PAR-FACE-001 | 家长端无人脸授权入口 | 家长账号已登录 | 搜索或浏览个人中心、服务首页、消息和设置页面 | 不展示人脸采集授权、撤回授权、设备删除回执入口；如相关信息需提示线下或后台处理 | 高 |
| TC-PAR-POSTER-001 | 成长喜报生成与分享 | 课堂点评包含优秀评语和课堂照片 | 打开课堂点评详情，生成成长喜报，预览、保存图片并分享 | 海报生成成功可保存和分享；生成失败可重试；操作有埋点 | 中 |
| TC-PAR-TICKET-001 | 工单提交到关闭评价 | 家长需要提交投诉建议或服务请求 | 提交工单、补充附件、查看处理进度、确认关闭并提交满意度 | 工单状态完整流转；关闭后只能评价一次；历史处理记录可见 | 高 |
| TC-PAR-ENH-001 | 前台范围收敛交付闭环验收 | P01-P22、S01-S13相关基础数据、权限、审批流、消息模板和接口配置已初始化 | 按明确家长端只做前台可落地体验：登录绑定、多孩子首页、课表请假补课、合同签署缴费、家校沟通、成长喜报和服务工单。执行前端提交、后端处理、状态流转、异常重试和消息触达 | 第 09 模块不出现发票申请、分期付款、人脸采集授权和线上退费申请入口。；同时产生审计日志、指标埋点和必要的补偿任务 | 高 |
| TC-PAR-ENH-002 | 请假补课交付闭环验收 | P06 课表与课次服务、P07 补课申请 / 补课安排、S05 请假申请抽屉相关基础数据、权限、审批流、消息模板和接口配置已初始化 | 按请假从课次详情发起，提交后进入老师/教务审核；审核通过后再提醒补课并自动带入原课次。执行前端提交、后端处理、状态流转、异常重试和消息触达 | 家长端可看到请假审核状态、驳回原因、补课候选、确认截止和处理结果。；同时产生审计日志、指标埋点和必要的补偿任务 | 高 |
| TC-PAR-ENH-003 | 合同缴费交付闭环验收 | P08-P12、S08、S10相关基础数据、权限、审批流、消息模板和接口配置已初始化 | 按补齐合同列表、合同详情、报价优惠、电子签署、在线缴费、支付成功/失败和已盖章合同查看；收银台不展示分期方案。执行前端提交、后端处理、状态流转、异常重试和消息触达 | 家长端金额展示与合同中心一致，支付前校验签署状态，支付失败可重试。；同时产生审计日志、指标埋点和必要的补偿任务 | 高 |
| TC-PAR-ENH-004 | 退费咨询交付闭环验收 | P13 退费咨询 / 线下办理指引、P20-P22 工单相关基础数据、权限、审批流、消息模板和接口配置已初始化 | 按退费改为咨询和线下办理指引，展示规则、材料清单、校区联系方式、服务工单入口和受理后进度查询。执行前端提交、后端处理、状态流转、异常重试和消息触达 | 家长端不能发起线上退款审批，只能提交退费咨询或服务工单。；同时产生审计日志、指标埋点和必要的补偿任务 | 高 |
| TC-PAR-ENH-005 | 成长喜报交付闭环验收 | P16 课堂点评详情、S13 成长喜报生成 / 海报预览相关基础数据、权限、审批流、消息模板和接口配置已初始化 | 按课堂点评详情新增成长喜报生成入口，支持课堂照片、老师评语、海报预览、保存图片、分享给家人和生成失败重试。执行前端提交、后端处理、状态流转、异常重试和消息触达 | 优秀点评能生成海报，生成、保存和分享动作可追踪。；同时产生审计日志、指标埋点和必要的补偿任务 | 高 |
| TC-PAR-ENH-006 | 服务工单闭环交付闭环验收 | P20-P22、S06、S07相关基础数据、权限、审批流、消息模板和接口配置已初始化 | 按补齐工单列表、提交、详情进度、补充说明、转人工确认、确认关闭和满意度评价。执行前端提交、后端处理、状态流转、异常重试和消息触达 | 工单从提交到关闭有处理记录，关闭后可评价且不可重复评价。；同时产生审计日志、指标埋点和必要的补偿任务 | 高 |
上线初始化
| 初始化项 | 动作 | 数据 | 验收 |
|---|---|---|---|
| 家长端范围开关 | 初始化家长端前台范围开关，关闭发票、分期付款、人脸采集授权、线上退费申请等入口 | enableInvoice=false、enableInstallment=false、enableFaceAuthorization=false、enableOnlineRefund=false | 家长端页面和接口均不出现被关闭能力 |
| 登录与协议策略 | 初始化微信登录、手机号验证码登录、协议版本、验证码有效期、重发间隔和账号异常提示 | wechatLogin、smsLogin、agreementVersion、smsExpireSeconds、smsRetryInterval、accountStatusTips | 家长可通过微信或手机号验证码登录，协议未勾选时阻断 |
| 监护关系认证策略 | 初始化学员绑定规则、关系类型、证明材料、认证失败原因和人工处理入口 | relationshipTypes、verifyMaterialRule、rejectReasonCodes、manualReviewFlow | 绑定和认证结果可追踪，可控制家长数据访问范围 |
| 多孩子首页配置 | 初始化多孩子聚合首页待办、课表、合同缴费、消息服务、快捷入口和孩子标签展示规则 | dashboardWidgets、childTagRule、todoMergeRule、quickActions、emptyState | 多孩子家庭默认聚合展示且可按孩子标签筛选 |
| 请假补课规则 | 初始化请假提交、审核结果展示、补课候选、确认截止、候选过期、改期申请和消息模板 | leaveSubmitRule、approvalResultVisible、candidateRule、confirmDeadline、rescheduleRule、notifyTemplate | 请假审核通过后才提醒补课，补课安排自动带入原课次 |
| 合同签署缴费规则 | 初始化合同列表、报价展示、电子签署、支付前置校验、支付失败重试和已盖章合同查看规则 | contractListRule、quoteDisplayRule、handSignRequired、paymentGuard、paymentRetry、sealedContractView | 家长端签署后支付，收银台不展示分期方案 |
| 退费咨询线下办理规则 | 初始化退费规则说明、材料清单、校区联系方式、咨询工单类型和受理后进度展示 | refundGuide、materialChecklist、campusContact、ticketType=REFUND_CONSULT、progressVisible | 家长端只提供咨询和线下办理指引，不创建线上退款审批 |
| 家校消息与喜报规则 | 初始化课堂点评、作业反馈、测评报告、回访提醒、风险预警和成长喜报海报模板 | messageCategories、posterTemplates、sharePolicy、saveImagePolicy、generateRetryPolicy | 优秀点评可生成、保存和分享成长喜报 |
| 服务工单闭环规则 | 初始化工单类型、附件限制、转人工、补充说明、确认关闭、满意度评价和重复评价限制 | ticketTypes、attachmentLimit、manualTransferRule、closeConfirmRule、satisfactionRule、duplicateReviewGuard | 工单从提交到关闭评价可闭环追踪 |
| 前台范围收敛交付配置 | 初始化明确家长端只做前台可落地体验：登录绑定、多孩子首页、课表请假补课、合同签署缴费、家校沟通、成长喜报和服务工单。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限 | P01-P22、S01-S13 | 第 09 模块不出现发票申请、分期付款、人脸采集授权和线上退费申请入口。 |
| 请假补课交付配置 | 初始化请假从课次详情发起，提交后进入老师/教务审核；审核通过后再提醒补课并自动带入原课次。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限 | P06 课表与课次服务、P07 补课申请 / 补课安排、S05 请假申请抽屉 | 家长端可看到请假审核状态、驳回原因、补课候选、确认截止和处理结果。 |
| 合同缴费交付配置 | 初始化补齐合同列表、合同详情、报价优惠、电子签署、在线缴费、支付成功/失败和已盖章合同查看；收银台不展示分期方案。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限 | P08-P12、S08、S10 | 家长端金额展示与合同中心一致，支付前校验签署状态，支付失败可重试。 |
| 退费咨询交付配置 | 初始化退费改为咨询和线下办理指引，展示规则、材料清单、校区联系方式、服务工单入口和受理后进度查询。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限 | P13 退费咨询 / 线下办理指引、P20-P22 工单 | 家长端不能发起线上退款审批，只能提交退费咨询或服务工单。 |
| 成长喜报交付配置 | 初始化课堂点评详情新增成长喜报生成入口，支持课堂照片、老师评语、海报预览、保存图片、分享给家人和生成失败重试。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限 | P16 课堂点评详情、S13 成长喜报生成 / 海报预览 | 优秀点评能生成海报，生成、保存和分享动作可追踪。 |
| 服务工单闭环交付配置 | 初始化补齐工单列表、提交、详情进度、补充说明、转人工确认、确认关闭和满意度评价。所需的页面入口、功能开关、审批流、消息模板、状态枚举、异常原因和角色权限 | P20-P22、S06、S07 | 工单从提交到关闭有处理记录，关闭后可评价且不可重复评价。 |