## 权限矩阵(前后端共用一份) - 新增 `packages/shared/src/permissions.ts`:`ClassRole`(ADMIN/HEAD/SUBJECT/STUDENT/NONE)、 `resolveClassRole()`、`canManageClasses/AssignTeachers/Roster/Schedule/Courses/PublishContent/ManageGrades/Import` 与 `PERMISSION_MATRIX`(README 与验收脚本据此展开)。 - 后端 `lib/access.ts`:新增 `resolveUserClassRole()`(`Class.teacherId` → 班主任,`ClassTeacher` → 科任) 与 `assertCanManageClasses/AssignTeachers/Roster/Schedule/PublishContent/ManageGrades`; 各 service 在**服务层**断言(路由仅做角色过滤),越权统一 403。 - 收紧项:班级增删改、班主任/科任分配、学生名单与账号 → 仅 ADMIN; 课表/课程增删改 → ADMIN 或本班班主任;成绩录入/修改/批量 → 仅 ADMIN(按需求清单); 作业/通知/叫人 → ADMIN、班主任、科任皆可。 - 读权限保持不变:教师仍可查看自己班级的课表/作业/通知/成绩列表与统计。 ## 前端按同一矩阵隐藏入口 - 侧边栏:教师端不再显示「班级管理 / 学生管理 / 成绩录入」(管理员仍是 7 项)。 - 班级页:新建/编辑/删除按钮仅管理员可见;课表页:增删改按钮仅"管理员或本班班主任"可见; 成绩页:录入/批量/删除按钮仅管理员可见。 - **叫人入口调整**:教师需要叫人,而「学生管理」是管理员专属,因此教师入口移到 「通知发布 → 叫人」(选班级 → 选学生 → 快捷短语/自定义消息;名单走 `/classes/:id/students`, 不使用管理员专属的 `/students`);管理员在学生管理页仍保留逐行「叫人」。 ## 顺手修掉的两个真实缺陷 - `NotificationsView.openCreate()`:班级列表异步加载期间点「发布通知」会导致「目标班级」为空、 校验失败且**静默不发布**;现在打开弹窗前会确保班级已加载(冒烟同步等待下拉就绪)。 - `desktop-client/scripts/smoke.mjs`:上一次冒烟被强杀后配置目录仍被句柄占用,`rmSync` 报 ENOTEMPTY 直接让冒烟启动失败;改为按进程号使用独立目录并容错清理。 ## 验证 - `pnpm verify:e2e` **82/82** ✅:新增 14 项角色权限断言(班主任/科任建班被拒、班主任删班被拒、 班主任/科任分配人员被拒、管理员分配与取消成功、科任管理课表被拒、科任可布置作业、 科任/班主任录入成绩被拒、管理员录入成功),并把历史用例中"仅管理员可执行"的操作切到管理员令牌。 - `pnpm verify:web` **17/17** ✅:新增「教师端隐藏无权入口」断言(可见菜单=仪表盘/课表/作业/通知, 越权入口=[]),叫人入口改到通知页后仍验证弹窗、8 条快捷短语、自定义输入与可选中态。 - `pnpm verify:desktop` **34/34** ✅;`lint` / `format:check` / `typecheck` 全绿。 - 数据清理:清掉历史遗留的测试班级与 4 条探针课表,演示数据恢复为 3 个班级。
74 lines
3.0 KiB
JavaScript
74 lines
3.0 KiB
JavaScript
/**
|
|
* Electron 冒烟验证:以 ELECTRON_SMOKE_TEST=1 启动应用(不弹窗),
|
|
* 主进程会依次校验 preload 桥接、渲染进程挂载、登录页 DOM、
|
|
* IPC 往返、IndexedDB 缓存读写、断网回退缓存,然后自动退出。
|
|
*
|
|
* 前置条件:已执行 npm run build(需要 dist/main 与 dist/renderer)。
|
|
*/
|
|
import { spawn } from 'node:child_process';
|
|
import fs from 'node:fs';
|
|
import path from 'node:path';
|
|
import { fileURLToPath } from 'node:url';
|
|
import { resolveElectronEnv, resolveElectronExecutable } from '../../../scripts/lib/electron-env.mjs';
|
|
|
|
const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
|
const repoRoot = path.resolve(root, '..', '..');
|
|
const electronPath = resolveElectronExecutable(path.join(root, 'node_modules', 'electron'));
|
|
const required = [path.join(root, 'dist/main/index.js'), path.join(root, 'dist/renderer/index.html')];
|
|
const missing = required.filter((file) => !fs.existsSync(file));
|
|
|
|
if (missing.length > 0) {
|
|
console.error('[smoke] 缺少构建产物,请先执行构建:');
|
|
console.error(' pnpm --filter @classhelper/desktop-client build');
|
|
for (const file of missing) console.error(` 缺失: ${path.relative(root, file)}`);
|
|
process.exit(2);
|
|
}
|
|
|
|
console.log('[smoke] 启动 Electron 冒烟验证...\n');
|
|
|
|
// 独立的 userData:避免与用户正在运行的客户端抢单实例锁(否则新进程会静默退出)。
|
|
// 目录按进程号区分:上一次冒烟若被强杀,目录可能仍被句柄占用(rmSync 会 ENOTEMPTY),
|
|
// 用独立目录可以彻底避免互相干扰。
|
|
const profileDir = path.join(repoRoot, '.cache', `desktop-smoke-profile-${process.pid}`);
|
|
try {
|
|
fs.rmSync(profileDir, { recursive: true, force: true, maxRetries: 3, retryDelay: 200 });
|
|
} catch (error) {
|
|
console.warn(`[smoke] 复用/清理配置目录失败(忽略):${error?.message ?? error}`);
|
|
}
|
|
console.log(`[smoke] 独立配置目录:${profileDir}`);
|
|
|
|
// 未显式指定时自动探测后端:可达则启用联网集成 + 侧边栏点击测试
|
|
let online = process.env.ELECTRON_SMOKE_ONLINE;
|
|
if (online === undefined) {
|
|
online = '0';
|
|
try {
|
|
const controller = new AbortController();
|
|
const timer = setTimeout(() => controller.abort(), 2500);
|
|
const response = await fetch('http://127.0.0.1:4000/api/health', { signal: controller.signal });
|
|
clearTimeout(timer);
|
|
online = response.ok ? '1' : '0';
|
|
} catch {
|
|
online = '0';
|
|
}
|
|
console.log(
|
|
online === '1'
|
|
? '[smoke] 检测到后端在线,将执行联网集成与侧边栏点击测试'
|
|
: '[smoke] 后端未在线,仅执行本地检查(离线缓存/界面渲染);如需联网测试请先启动 pnpm dev:server',
|
|
);
|
|
}
|
|
|
|
const child = spawn(electronPath, ['.'], {
|
|
cwd: root,
|
|
stdio: 'inherit',
|
|
env: resolveElectronEnv({
|
|
ELECTRON_SMOKE_TEST: '1',
|
|
ELECTRON_SMOKE_ONLINE: online,
|
|
ELECTRON_SMOKE_PROFILE: profileDir,
|
|
}),
|
|
});
|
|
|
|
child.on('exit', (code) => {
|
|
console.log(`\n[smoke] Electron 退出,code=${code ?? 1}`);
|
|
process.exit(code ?? 1);
|
|
});
|