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

@@ -1,5 +1,5 @@
import { Router } from 'express';
import { sendOk } from '../../lib/http.js';
import { ApiError, sendOk } from '../../lib/http.js';
import { authenticate, getAuthUser, requireRole } from '../../middleware/auth.js';
import { validate, validatedBody, validatedQuery } from '../../middleware/validate.js';
import { defineModule } from '../module.types.js';
@@ -25,9 +25,12 @@ router.use(authenticate());
/**
* GET /api/imports/template?kind=grades|students&format=csv|xlsx - 下载导入模板
* 成绩模板=管理员;名单模板=管理员(与写入权限一致,不额外开入口)
* 成绩模板:管理员或班主任(空白模板,不含任何业务数据);名单模板:仅管理员
*/
router.get('/template', requireRole('ADMIN'), (req, res) => {
router.get('/template', requireRole('ADMIN', 'TEACHER'), (req, res) => {
if (req.query.kind === 'students' && getAuthUser(req).role !== 'ADMIN') {
throw ApiError.forbidden('只有管理员可以导入学生名单');
}
const kind = req.query.kind === 'students' ? 'students' : 'grades';
const format = req.query.format === 'xlsx' ? 'xlsx' : 'csv';
if (format === 'xlsx') {
@@ -46,16 +49,30 @@ router.get('/template', requireRole('ADMIN'), (req, res) => {
/**
* POST /api/imports/table/preview - 上传表格并预览(解析 + 必填列校验 + 建议字段映射)
* 仅管理员:与"成绩录入 / 名单管理"权限一致
* 成绩:管理员或班主任;学生名单:仅管理员(与写入权限保持一致)
*/
router.post('/table/preview', requireRole('ADMIN'), validate({ body: tableFileSchema }), (req, res) => {
sendOk(res, previewTable(validatedBody<TableFileInput>(req)), '表格解析成功');
});
router.post(
'/table/preview',
requireRole('ADMIN', 'TEACHER'),
validate({ body: tableFileSchema }),
(req, res) => {
const input = validatedBody<TableFileInput>(req);
if (input.kind === 'students' && getAuthUser(req).role !== 'ADMIN') {
throw ApiError.forbidden('只有管理员可以导入学生名单');
}
sendOk(res, previewTable(input), '表格解析成功');
},
);
/** POST /api/imports/table/commit - 执行导入(字段映射 + 写入模式 + 结果统计) */
/**
* POST /api/imports/table/commit - 执行导入(字段映射 + 写入模式 + 结果统计)
*
* 路由放行 ADMIN|TEACHER,真正的权限在 service 内按 kind + 班级二次校验:
* 成绩 → 管理员或本班班主任;学生名单 → 仅管理员;科任老师一律 403(需求 7)。
*/
router.post(
'/table/commit',
requireRole('ADMIN'),
requireRole('ADMIN', 'TEACHER'),
validate({ body: tableCommitSchema }),
async (req, res) => {
const result = await commitTable(getAuthUser(req), validatedBody<TableCommitInput>(req));