feat(rbac): 成绩录入/导入放开到本班班主任(需求 6 与需求 7 口径统一)

依据: 需求 6 明确要求'成绩与表格导入……老师端与学生端班级账号均可用且不越权',
      需求 7 的权限清单并未把成绩收归管理员专属(只限制班级增删改、人员分配与科任权限)。

变更:
- shared/permissions: canManageGrades(classRole) = ADMIN | HEAD;canImport 按 kind 分发
  (成绩=ADMIN|HEAD、名单=仅管理员、课表时间=ADMIN|HEAD);PERMISSION_MATRIX 同步
- lib/access: assertCanManageGrades(user, classId) 异步按班级角色判定,科任/跨班给出针对性提示
- grades 服务与路由、imports 的模板/预览/提交路由放宽为 ADMIN|TEACHER,
  服务层按 kind + 班级二次校验(名单仍仅管理员,科任仍 403)
- Web 管理端: 成绩录入菜单对教师可见;写入/导入按钮仅对'管理员或所选班级班主任'显示

验证:
- verify:e2e 133/133(新增: 班主任录入本班成绩 201 + 跨班 403、班主任模板/预览/导入本班成绩可用、
  科任导入 403、班主任名单模板与导入 403、append 重复导入跳过)
- verify:web 19/19(新增: 班主任可见成绩导入入口并打开弹窗,越权入口仍隐藏、菜单 5 项)
- verify:desktop 47/47(未受影响)
文档: README 权限矩阵与'需求 6/7 口径统一'对照表、各项计数更新
This commit is contained in:
LoveChengke committed 2026-09-12 16:21:39 +08:00
1 parent 21485ea294
commit 97a89de944
11 files changed
+359 -89

No files matched your search

+20 -4
View File
@@ -157,11 +157,27 @@ export async function assertCanPublishContent(user: TokenPayload, classId: strin
}
}
/** 成绩录入 / 修改 / 导入:仅管理员 */
export function assertCanManageGrades(user: TokenPayload): void {
if (!canManageGrades(user.role)) {
throw ApiError.forbidden('只有管理员可以录入、修改或导入成绩');
/**
* 成绩录入 / 修改 / 导入:管理员,或**本班班主任**(需求 6"老师端可用且不越权")。
* 科任老师仍然被拒(需求 7:科任只有作业 / 叫人 / 通知)。
*
* @param classId 目标成绩所属班级;不传时按"全局"判定(仅管理员可用,例如空白模板下载)
*/
export async function assertCanManageGrades(user: TokenPayload, classId?: string): Promise<void> {
if (!classId) {
// 没有班级上下文(例如下载空白模板):只有管理员可以执行
if (user.role !== 'ADMIN') throw ApiError.forbidden('该操作需要指定班级,只有管理员可以全局执行');
return;
}
const classRole = await resolveUserClassRole(user, classId);
if (canManageGrades(classRole)) return;
throw ApiError.forbidden(
classRole === 'SUBJECT'
? '科任老师不能录入或导入成绩,请联系班主任或管理员'
: '只能录入或导入自己担任班主任的班级的成绩',
);
}
/** 学生的主班级,未分配班级时抛 403 */