家长单

家长问得最多的一句话是「我家孩子还剩多少课时」。前台或老师不用口头报数字、也不用截图台账页发过去，直接在学生详情页点一下，打出一张纸交给家长——这就是家长单。它是三种打印物之一（另外两种是课表、成绩单），只服务一个学生，不像经营报表那样统计一整个机构。

入口

学生详情页（花名册 → 学生列表 → 点开某个学生）标题栏右侧有一个打印家长单按钮，需要同时满足两个条件：账号持有 export.print 权限点，并且机构已开通「点名与课消」这块积木——两个条件缺一个，按钮都不出现。 export.print 不是稀有权限点：老师账号本身就带着这个权限点（连同 schedule.view），不需要额外开通，只是老师打印时只能打自己任教班级的学生，校区管理员、教务及以上账号不受这层限制。

点击按钮会在新标签页打开 /print/parent-note/学生ID——这是一条独立于后台界面的打印路由，没有侧边栏和顶部导航，链接可以直接复制转发。数据来自 GET /api/students/学生ID/parent-note 这一条接口，是这张单子唯一的数据源，台账页、报表页看到的余额都是同一套算法算出来的，不会另起一份滞后的数字。

单子上有什么

单子从上到下分三块：头部（机构名、学生姓名、打印用的期间、打印时间）、出勤明细表（这段期间内的点名记录，按课节列出日期、班级、状态、扣课时）、剩余课时表（按学科分桶列出课时类别与剩余数量，学科留空的桶显示为「通用课时」）。出勤状态用的是点名那三个状态的原文——出勤 / 缺勤 / 请假，跟花名册面板上看到的是同一套字样。

这张单子不含学生的联系方式，也不含任何金额：家长单只回答「上没上课、还剩多少课时」这两件事，收费信息和电话号码都不会出现在纸面上，不是遗漏，是设计成这样。具体每一栏怎么排版、字号大小、页眉长什么样，以下面这张打印预览截图为准，正文不逐字复述版式细节，免得跟界面改动脱节。

打印

打印页默认统计最近 30 天（含当天）的出勤明细，不用手动选期间。如果要打别的时间段，直接在链接后面拼 ?from=2026-08-01&to=2026-08-31 这样的查询参数重新打开就行，两个参数可以只改一个，另一个照样落回默认值。打印时间（页面右上角「打印时间」那一行）取的是打开这张单子那台电脑此刻的时间，跟数据新不新鲜没关系。

页面本身没有导出按钮，用浏览器自带的打印功能（Windows/Linux 是 Ctrl+P， Mac 是 Cmd+P）就能打印或另存为 PDF。这条路由链接对着谁转发都能开，但打开之后照样要先登录、再按 export.print 权限和任教范围重新核验一遍——把链接转给一个没有登录、或者登录了但没有这个权限的人，对方打开看到的是一行报错文案，不会自动帮忙登录或者绕过权限。

常见问题

老师能打印所有学生的家长单吗？ 不能。老师打印时只能打自己任教班级的学生，打开不属于自己任教班级的学生会看到没有权限的报错；校区管理员、教务及以上账号不受此限制，能打本人管理校区内的任意学生。

这段期间没有点名记录怎么办？ 出勤明细表会显示「本期间内没有点名记录。」，不会留一张空表格，剩余课时表则始终按学生当前的分桶余额显示，跟期间无关——这一点跟课时余额与预警里「余额是当前快照」的口径是一致的。

为什么单子上看不到家长电话或者收费金额？ 这是家长单本身的设计，不是权限问题或者数据没录全。这张单子的数据源只返回出勤记录和分桶余额两类字段，压根不去读联系方式和台账里的金额列，所以哪个账号打开都不会多出这两项。

打印之前需要先点名或者算好余额吗？ 不需要，单子上的出勤明细和剩余课时都是从既有的点名记录（详见点名与课消）和台账流水现算出来的，家长单本身不产生任何数据，只是把已经存在的数字打印成一张纸。

跟打印课表是不是同一个入口？ 不是。打印课表、家长单、成绩单导出的是某校区某一周的整周课表；家长单是从学生详情页打印单个学生的出勤与余额，面向具体某个家长。两者是两条不同的打印路由，权限判定也各自独立。