import type { UserRole } from './types.js'; /** * 班级内的角色(相对"某一个班级"而言)。 * * - `ADMIN` 系统管理员:班级增删改、人员分配、全部数据 * - `HEAD` 班主任(`Class.teacherId`):本班课表 + 本班成绩(含导入)+ 作业/通知/叫人 * - `SUBJECT` 科任老师(`ClassTeacher`):仅作业/通知/叫人 * - `STUDENT` 学生(班级账号;个人学生账号已清理):只读 * - `NONE` 与该班级无关 */ export type ClassRole = 'ADMIN' | 'HEAD' | 'SUBJECT' | 'STUDENT' | 'NONE'; export interface ClassRoleContext { role: UserRole; /** 是否是该班班主任(Class.teacherId === 当前用户) */ isHeadTeacher?: boolean; /** 是否被分配为该班科任/协作老师(ClassTeacher 中存在当前用户) */ isSubjectTeacher?: boolean; } /** 依据账号角色与该班归属关系,解析出班级内角色 */ export function resolveClassRole(context: ClassRoleContext): ClassRole { if (context.role === 'ADMIN') return 'ADMIN'; if (context.role === 'TEACHER') { if (context.isHeadTeacher) return 'HEAD'; if (context.isSubjectTeacher) return 'SUBJECT'; return 'NONE'; } if (context.role === 'STUDENT') return 'STUDENT'; return 'NONE'; } /** 班级本身(创建/修改/删除)与人员分配:仅管理员 */ export function canManageClasses(role: UserRole): boolean { return role === 'ADMIN'; } /** 班主任与科任老师名单的编辑:仅管理员 */ export function canAssignTeachers(role: UserRole): boolean { return role === 'ADMIN'; } /** 学生名单(增删学生、导入名单):仅管理员(学生没有账号,因此没有"重置密码"这一步) */ export function canManageRoster(role: UserRole): boolean { return role === 'ADMIN'; } /** 课表管理:管理员或本班班主任(科任老师不可以) */ export function canManageSchedule(classRole: ClassRole): boolean { return classRole === 'ADMIN' || classRole === 'HEAD'; } /** 课程(课表的前置数据):与课表同权限 */ export function canManageCourses(classRole: ClassRole): boolean { return canManageSchedule(classRole); } /** 布置作业 / 叫人 / 发通知:管理员、班主任、科任老师皆可(学生不可) */ export function canPublishContent(classRole: ClassRole): boolean { return classRole === 'ADMIN' || classRole === 'HEAD' || classRole === 'SUBJECT'; } /** * 成绩录入 / 修改 / 导入:管理员,或**本班班主任**。 * * 需求 6 要求"成绩与表格导入……老师端与学生端班级账号均可用且不越权", * 而需求 7 的权限清单(班级增删改、人员分配、科任权限、班主任课表)并未把成绩收归管理员专属, * 因此按"老师端可用 + 不越权"落地:班主任只能动**自己班上**的成绩, * 科任老师依旧只有作业 / 叫人 / 通知权限(与需求 7 完全一致)。 */ export function canManageGrades(classRole: ClassRole): boolean { return classRole === 'ADMIN' || classRole === 'HEAD'; } /** 可导入的数据类型 */ export type ImportKind = 'grades' | 'students' | 'teachers' | 'scheduleTimes'; /** 导入权限:成绩=管理员或本班班主任;学生/教师名单=仅管理员;课表时间=管理员或本班班主任 */ export function canImport(role: UserRole, classRole: ClassRole, kind: ImportKind): boolean { if (kind === 'students' || kind === 'teachers') return canManageRoster(role); if (kind === 'scheduleTimes') return canManageSchedule(classRole); return canManageGrades(classRole); } /** 人类可读的权限矩阵(README / 设置页展示,单一事实来源) */ export const PERMISSION_MATRIX: readonly { action: string; admin: boolean; head: boolean; subject: boolean; }[] = [ { action: '班级创建 / 修改 / 删除', admin: true, head: false, subject: false }, { action: '分配班主任与科任老师', admin: true, head: false, subject: false }, { action: '学生名单管理(增删 / 导入)', admin: true, head: false, subject: false }, { action: '教师录入(新建 / 导入名单 / 重置密码)', admin: true, head: false, subject: false }, { action: '课表管理(增删改 / 时间配置导入)', admin: true, head: true, subject: false }, { action: '布置作业', admin: true, head: true, subject: true }, { action: '叫人', admin: true, head: true, subject: true }, { action: '发布通知', admin: true, head: true, subject: true }, { action: '成绩录入 / 修改 / 导入(仅本班)', admin: true, head: true, subject: false }, ];