看板
📊 用 SQL 快速搭建班级数据看板
看板支持多看板、多列表与分屏布局。你可以直接写 SQL 查询学生数据，并按卡片/网格/表格方式展示。
入口与权限
- 入口：侧边栏
看板 - 权限：
只读/积分/管理都可查看看板数据- 仅
管理权限可编辑看板（新增、删除、重命名、改 SQL、改布局）
看板结构
看板由三层组成：
- 看板（Board）：用于区分场景（如“课堂实时”“周复盘”）
- 学生列表（List）：每个列表对应一条 SQL 查询
- 布局（Layout）：支持左右拆分、上下拆分，并可拖动分隔条调整比例
系统会自动保证每个看板至少保留 1 个列表。
SQL 查询规则
看板 SQL 由应用直接执行，当前规则如下：
- 仅允许单条
SELECT/WITH（CTE）只读查询 - 不允许
;、注释（--//* */）和写入类关键字（如insert/update/delete/drop等） - 每次查询最多返回 500 行（界面运行时按 500 行请求）
时间模板变量
SQL 支持以下模板变量，运行时会自动替换为 ISO 时间字符串：
{{today_start}}{{this_week_start}}{{last_week_start}}{{since_7d}}{{since_30d}}{{now}}
结果展示与字段映射
自动识别学生卡片
当查询结果中包含学生姓名字段时，会自动渲染为学生卡片：
- 姓名字段支持：
student_name/name/studentName
若无法识别姓名字段，则以通用表格展示原始列。
常用指标字段
看板会尝试识别以下字段并展示为标签：
- 总分：
score - 加分：
add_score/addScore/plus_score/plusScore - 扣分：
deduct_score/deductScore/minus_score/minusScore - 奖励分：
reward_points/rewardPoints - 近 7 天变化：
week_change/range_change/change - 近 7 天扣分：
week_deducted/deducted - 今日回答次数：
answered_count/answer_count
视图模式支持 列表 / 卡片 / 网格；分值显示支持 总分 或 加分+扣分。
内置预设
当前内置 3 个 SQL 预设，可在编辑列表时一键套用：
- 上周低扣分排行：统计近 7 天扣分较低的学生
- 今日活跃榜：按今日回答次数与积分变化排序
- 奖励积分榜：按奖励积分与总分排序
刷新与数据同步
- 切换看板、修改 SQL 后会自动重新运行查询
- 学生/积分事件/理由数据变化后，看板会自动刷新
- 你也可以点击页面右上角
刷新手动重载看板配置
相关模块
贡献者
更新日志
2026/3/29 07:58
查看所有更新日志
388c1-于
版权所有
版权归属：SECTL
许可证：CC BY-NC-SA 4.0