ClassHelper/docs/app/classes.md

---
title: 班级、学生与教师
description: 名单、班级会话、任课关系与年度升级。
---

# 班级、学生与教师

## 班级账号

教室客户端使用班级码和班级密码登录，形成 CLASS_DEVICE 会话，主体是班级。
班级码保存时统一大写；管理员在“班级管理”维护班级码、密码与班主任。
班级端的已读、作业完成等操作代表全班，学生没有个人登录账号。
客户端没有修改密码入口；员工本人改密码在 Web 顶栏菜单。

班级名由入学年份和班号组成，例如“2026级1班”；年级独立保存，学年升级时班名不随之改写。
班主任可以暂空，新学年自动创建的高一班级仅有骨架，需要管理员后续分配教师。

## 学生名单

Student 存学号、姓名、班级、性别、家长电话和状态，没有密码或角色字段。
学号为必填唯一标识，格式为 1–32 位字母、数字或 . _ -；不会自动生成登录名。
具有名单管理键的管理员、本班班主任或全校名单范围的授权员工管理学生；只读账号按名单读取键和范围查看历史。
名单表格导入要求 import:students、roster:manage 和对应班级范围；学号查重在 Student 表完成，不当成 User 用户名。
调班保留历史内容原归属；转出独立记账并从现行业务名单过滤，学号不可复用。

## 教师与科目

教师使用工号和密码登录，管理入口受 teacher:read/teacher:manage 等功能权限控制。
教师名单导入还要求管理员身份和相应导入权限。班主任关系在 Class.teacherId；
科任关系唯一存于 Course(classId, name, teacherId)，分配任课关系由班级管理权限及服务端断言限制。
班主任不任教某科就不能修改该科作业/成绩；科任老师有相应权限时可以管理自己任教科目。

删除教师前，服务端检查其负责的班级、任课课程、发布过的作业/通知与所属课件；仍有业务内容则返回冲突，避免级联丢失。
教师本人改密码、管理员修改教师密码、班级账号密码是不同入口；学生没有密码接口。

## 权限、学年与归档

角色给默认权限模板，实际入口由可编辑权限组决定；岗位组还能配置年级或部范围。
范围不代替科目写权限，详见[角色与权限](../dev/permissions.md)。
学期周数受全校可配置上限约束，默认上限 30、允许 1–60，见[课表](schedules.md)。
学年升级按计划时间运行，执行前保存快照，以年份幂等；启动发现漏跑需管理员预览补跑。
默认高中轨道按高一、高二、高三排列，毕业学段归档，其余升一级；也可配置其他轨道。新班不复制任课关系。归档页查看届别历史与转出记录，
不再通过手动创建归档来代替年度升级。撤回转出由 roster:manage 控制，原班归档后可指定其他在读班。

## 学生生命周期

资料编辑仅修改学号、姓名、性别与家长电话，不接受状态或班级字段；旧客户端发送这两项会收到 400 和专用接口提示。
默认名单只显示未归档的 active；状态筛选可查看 inactive、transferred、graduated，“包含归档”另行控制归档标记。

调班、转出、转入、复学、撤回与移出班级均在一个事务内修改学生并写历史，包含批次、学年、原新班级与年级、来源去向学校、操作人和备注。
调班需同时覆盖源班与目标班；跨年级须管理员勾选允许跨年级并填写备注。目标班必须在读。
转出保留原班及业务历史，只接受在读或停用学生。转入支持新建学号或选择转出/停用学生，毕业或归档学生不能通过名单入口复活。
撤回转出可选择另一个在读班，原历史保留。默认删除动作改为停用；硬删除另须管理员确认且无成绩、作业、已读或历史。

## 升级预览与执行

“学年升级”页面独立要求 promotion:manage，全校范围。先保存轨道、有序年级、起始班数、执行时间、开学日和周次重置策略，再预览逐班影响。
预览包含在读/停用/转出人数、新班码、周次删除行数、阻断和警告、计划哈希。未知年级、缺失届别、重复班号、已有届别档案或新班码冲突会阻断执行。
执行需确认学年和预览哈希；业务或配置变化后必须重新预览。未来学年禁止执行，过去学年仅 ADMIN 明确补跑。

毕业班所有学生挂届别：在读转毕业，转出和停用保留状态；非毕业班只升到下一学段并清本班开学日覆盖。
新班只有骨架，开学日取计划值（未配置时为执行学年 9 月 1 日）。保留周次时，旧逐周区间会继续覆盖新学年，页面会警告。
同年执行幂等，执行记录显示操作人、快照路径、SHA256、明细与错误。快照失败不升级，失败事务回滚后可修正重试。
撤销归档只清标记并将毕业生恢复在读，转出/停用不变；不回滚年级、不删除新班、不恢复已清空周次，整学年恢复需管理员手工使用快照。