ClassHelper/docs/app/classes.md

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

# 班级、学生与教师

## 班级账号

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

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

## 学生名单

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

## 教师与科目

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

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

## 权限、学年与归档

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