---
title: 作业
description: 作业按所属日期归类、看板与全屏看板、教室机器录入作业、未交名单与附件。
---

# 作业

## 按「所属日期」归类，不是按录入时间

每份作业有一个**所属日期**（`Homework.assignDate`，形如 `2026-10-06` 的本地日期，不带时区）。
按天查看、日期高亮、客户端的「只看今天」都看它。

> 用录入时间（`createdAt`）当"哪一天的作业"是错的：它是 UTC，晚上 8 点留的作业会被算到第二天。
> 系统里统一用「本地日期」，新增按天查询的接口也一样走 `?date=YYYY-MM-DD`。

所以老师可以给今天、明天、甚至补录上周某一天 —— 客户端按日期查得到。

## 两端各自能做什么

| 能力               | Web 管理端（老师）                       | 桌面客户端（教室机器）                          |
| ------------------ | ---------------------------------------- | ----------------------------------------------- |
| 按天查看           | 工具栏日期选择器；有作业的日期下面带圆点 | 日期选择器 + 前 / 后一天，支持 `?date=` 深链    |
| 发布 / 编辑 / 删除 | ✅（教师 / 管理员）                      | ✅ **录入**（班级账号也能发，归属到该班班主任） |
| 看板模式           | —                                        | ✅ 默认视图                                     |
| 全屏看板           | —                                        | ✅                                              |
| 完成情况           | ✅ 按名单统计完成人数                    | ❌ **客户端不显示"已完成 / 待完成"**            |
| 未交名单           | ✅ 作业详情抽屉里可看可改                | ✅                                              |

> 客户端刻意不显示完成状态：完成与否是**老师端与通知中心**的概念；
> 教室机器上只做"看作业 + 录作业"两件事。服务端的完成数据与统计接口都还在，Web 端照旧可用。

## 看板模式

客户端作业页默认按**科目**分卡片，每张卡列出该科的所有作业。工具栏可以：

- **看板 / 列表** 切换视图（列表模式有一列"作业要求"全文）；
- **只看今天** 开关（默认开）；
- **显示时间** 开关；
- **字号**滑块（11–28px 即时生效）。

这些偏好存在客户端配置里，重启后仍生效。

卡片里同时渲染**标题 + 作业要求全文**（不截断）。

### 全屏看板

点卡片或「全屏看板」进入。全屏下的排版不是简单地放大：

1. 按"可用宽 × 可用高"枚举 1..N 列，取**单卡面积最大、宽高比最接近 1.15** 的方案；
2. 再按「内容高度 / 可用高度」整体 `transform: scale()` 缩到刚好铺满 —— 所以**不用上下翻页**；
3. 标题栏中间绝对居中显示当天日期时间（受「显示时间」开关控制，每分钟刷新）。

> 字号仍由工具栏的滑块决定，缩放只负责"放得下"。工具栏上会显示当前缩放比例。

## 教室机器录入作业

教室里那台机器用**班级账号**登录，可以直接发作业。两个细节：

- 服务端拿到的是班级账号的会话（`sub` 是班级 id），写 `createdBy` 前会换成该班班主任，
  否则会撞外键。
- **本机刚录入的那条不会弹到灵动岛上**——自己通知自己没意义。这条判断是在发请求**之前**
  按内容登记指纹做的（服务端是先广播后回响应，等拿到 id 再登记就晚了）。

录入时可以点**快捷短语**（默认 `P` / `大本` / `小本` / `卷子` / `背诵` / `默写` / `听写` / `预习` /
`订正` / `读书`），点一下追加到标题或内容。短语可以在客户端「设置 → 通用」里增删，存在本机。

## 未交名单

在作业列表或详情里点「未交名单」→ 勾选**没交作业**的同学 → 保存。

其余同学会被自动标记为已完成（接口是 `PATCH /api/homeworks/:id/submissions`）。
Web 端作业详情抽屉里同样可看可改。

> 名单来自班级的学生名单 —— 名单不全，这项就不准。见[班级、学生与教师](classes.md)。

## 附件

作业可以带一个附件链接。**只接受 `http(s)://` 或站内相对路径**，其他 scheme（`javascript:`、
`data:text/html` 等）服务端会直接拒；Web 端渲染前还会再兜一层。
放行这些 scheme 等于给了一条存储型 XSS。

## 实时推送

发布 / 修改 / 删除作业会分别广播：

| 事件               | 客户端反应                            |
| ------------------ | ------------------------------------- |
| `homework:new`     | 作业列表刷新 + 灵动岛弹「新作业」胶囊 |
| `homework:updated` | 刷新；带 `deleted: true` 表示删除     |
| `homework:status`  | 完成状态变化时刷新统计                |

课表、作业、通知、成绩都是同一个套路：写库 → 按班级房间广播 → 客户端更新内存状态并写回 IndexedDB。