第 5 / 8 篇
整理于 · 7 分钟
学习信息怎样呈现给不同角色
面向学员、教师与管理者的信息呈现与 AI 辅助
串联早期信息展示需求与九月图表修订，尚未证实的能力仍保留边界。
贯穿项目的约定 本篇涉及 2 条
教务系统需要根据不同角色的职责，组织他们要查看的信息：
- 学员与家长需要看清孩子的学情成长轨迹、课堂表现与薄弱环节；
- 授课教师需要聚焦今日排课、点名出勤与班级作业反馈；
- 机构管理员则需要掌控全局营收、消耗进度、欠费退费与经营态势。
教育机构管理系统围绕这些需求，分别调整了成绩展示、AI 建议加载、工作台和经营指标口径。
1. 学情成长：多量纲成绩与真实时间轴
培训机构的课程种类繁多，不同类别的考核方式差异极大：少儿美术可能采用五星评价制，英语口语可能采用等级制（A/B/C/D），而数理竞赛则采用标准的百分制（0~100分）。
1.1 灵活的多量纲支撑
系统在底层支持百分制、等级制与星级制的异构存储：
- 严禁在没有明确数学转换规则的情况下，将星级或等级强行换算成百分制进行加总平均；
- 成绩缺失状态与真实零分分开处理，未测评不作为零分参与统计，避免把缺少记录解释为低分。
1.2 按真实考试日期绘制趋势
早期学情图表按月份组织成绩，后续需求改为按实际考试日期展示。培训机构的测验间隔并不固定，例如一个月内可能有多次测验，也可能连续两个月没有测验。按月汇总可能掩盖这些间隔和起伏。
趋势图因此改用实际考试日期组织记录，让成绩变化与发生时间对应。这样既能区分同一月内的不同考试，也不必为没有考试的月份补出成绩。
2. AI 学习建议：独立加载与失败重试
学习报告引入了大语言模型生成的学习建议。由于模型响应时间和可用性受外部服务影响，页面把业务数据与 AI 请求分开加载：
分成两路的地方就是第 3 步那一次请求：它只负责把请求发出去，报告页的业务数据不等它，成功与失败两种收尾都不影响上面已经渲染好的部分。
- 独立加载：出勤、成绩图表与 AI 建议分别管理加载和错误状态，AI 失败时在建议区域提示并提供重试；
- 配置与测试：管理员可配置模型端点、选择模型、编辑提示词并测试连接。建议生成仍依赖可用的模型服务，独立加载本身不代表服务可用性已经得到全面验证。
3. 分角色的工作台组织
不同角色进入系统后，需要先看到与本人职责相关的信息。
3.1 教师工作台：紧扣教学与课堂交付
教师工作台围绕本人今日课程、班级学员、考勤和学习情况组织信息。最初需求还提出了课时统计、课时费和班级分析等方向，不能仅凭这份需求就把每个区域都写成已经完成。
九月调整了查询、图表与 AI 请求的生命周期，使失败区域可以单独重试，并分别检查管理员和教师视图的图表绘制。这些检查没有扩展为全站移动端视觉验收。
3.2 管理员工作台：精确的财务与经营口径
管理看板需要区分充值、购课消费与退费。早期需求记录专门提出：钱包充值不能直接计入课程收入。
据此，管理看板按系统业务口径区分以下指标；这些定义不等同于正式会计上的收入确认或利润核算：
| 看板指标名称 | 系统业务口径 | 阅读时需要区分的概念 |
|---|---|---|
| 课程实收（Revenue） | 购课成功支付的金额；月度统计按支付表中当月成功记录汇总 | 不计仅充值未购课的资金，也不以已开课履约为前提 |
| 钱包充值总额（Deposits） | 用户向钱包充值的资金总额 | 充值与购课消费分别统计 |
| 沉淀余额（User Balances） | 用户钱包中的可用及冻结资金总和 | 表示钱包资金状态，不直接代表利润 |
| 累计退费（Refunds） | 经审批并实际退回的资金总额 | 有可信付款记录时优先退原付款人；历史兼容路径另有边界 |
列表名称也随口径调整：仅返回学费缴纳记录的列表改称“缴费流水”，避免让读者误以为它包含全部资金流动。
4. 业务通知与课堂评价闭环
信息的双向互动还体现在通知与评价体系中：
- 通知与业务动作分开：已读只表示看过消息，确认绑定或审批申请才会改变业务状态。九月把通知中的绑定操作与绑定页统一，保留失败提示、请求期间禁用和迟到响应处理，防止页面切换后旧响应错误地改变当前状态；
- 评价资格检查：评价入口检查实际参与、有效考勤、课次结束和是否已评价等条件，限制未满足资格或重复提交的评价。这些规则约束提交资格，不能保证评价内容本身客观。
这些调整分别解决了量纲、时间、角色和金额口径的问题。读者看到一张图或一个数字时，需要知道它统计的对象、时间范围与缺失状态，才能据此判断。