- 服务端新增 database 模块(/api/database/*,仅 ADMIN):全库 JSON 快照(备份 / 恢复 / 导入导出 / 定时备份
共用同一格式,14 张表按拓扑序导出、恢复时关外键检查)、连接测试与目标库校验、一键 SQLite ⇄ MySQL 切换
(备份 → 导出 → 测试连接 → 校验空库 → 改 schema → 子进程 generate / tsc / db push → 写数据,全部成功才改写
.env,中途失败回滚 schema);XML 快照与 SQLite 数据文件均可下载;打包形态随包带上 prisma CLI 与 typescript
(prisma-client 生成物是 .ts,需再编进 dist/generated,安装包因之变大)
- Web 管理端新增「数据库管理」页(仅管理员),并加首次登录新手引导(el-tour,可跳过、可随时重看,版本号写
localStorage,改版后老用户会再收到一次)
- 客户端设置改版:侧边栏改为分组折叠菜单,设置拆成 6 个子路由
(/settings/{general,appearance,island,reminder,account,about}),新增深色模式(主题持久化到主进程配置,
主窗口底色跟主题走,避免"先白后黑"闪一下),新增「关于」页(应用信息 / 诊断信息)
- 客户端新增首启六步引导(OnboardingWelcome,状态存主进程配置 onboardingDone)
- 客户端主窗口初始尺寸与 ClassIsland 对齐(1242x582 / minHeight 540 / 居中)
- 版本号统一提升到 1.0.0:5 个 package.json、部署配置与镜像标签(.env.example / docker-compose / Dockerfile)、
服务端 /health 与首页、插件 manifest.yml 与 BridgeService.PluginVersion、文档里的安装包名
- 文档与验收同步:AGENTS.md 补第 37~51 条约定(深色主题实现边界、设置子路由、数据库管理三件事、侧栏与窗口
尺寸、引导在自动化里的判据等),README 补「数据库管理 / 新手引导 / 设置改版」三节;verify:e2e 增补 13 条
数据库管理用例,客户端冒烟与 Web UI 冒烟跟进子路由、深色主题、侧栏与引导
验证:pnpm lint 0 error;pnpm typecheck 全过;verify:e2e 186/186;verify:classisland-plugin 68/68;
build:desktop 通过(含产物凭据门禁);verify:desktop 99/102(3 项为上课时段下的"真实通知链路"用例,
客户端按产品规则暂存普通通知所致,见下);插件 dotnet 编译 0 错误。
注:verify:desktop 的「真实通知链路 / 标记已读」三项要求当前不在上课时段——本次运行时种子课表恰有
「周五 10:55-11:40 生物」正在进行,客户端正确地暂存了普通通知(AGENTS.md 第 18 条),属时间相关用例,
与本次改动无关。
132 lines
4.1 KiB
TypeScript
132 lines
4.1 KiB
TypeScript
import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router';
|
|
import { STORAGE_KEYS } from '@classhelper/shared';
|
|
|
|
const routes: RouteRecordRaw[] = [
|
|
{
|
|
path: '/login',
|
|
name: 'login',
|
|
component: () => import('@/views/LoginView.vue'),
|
|
meta: { public: true, title: '登录' },
|
|
},
|
|
{
|
|
path: '/',
|
|
component: () => import('@/layouts/AdminLayout.vue'),
|
|
redirect: '/dashboard',
|
|
children: [
|
|
{
|
|
path: 'dashboard',
|
|
name: 'dashboard',
|
|
component: () => import('@/views/DashboardView.vue'),
|
|
meta: { title: '仪表盘', icon: 'Odometer' },
|
|
},
|
|
{
|
|
path: 'classes',
|
|
name: 'classes',
|
|
component: () => import('@/views/ClassesView.vue'),
|
|
meta: { title: '班级管理', icon: 'School', roles: ['ADMIN'] },
|
|
},
|
|
{
|
|
path: 'students',
|
|
name: 'students',
|
|
component: () => import('@/views/StudentsView.vue'),
|
|
meta: { title: '学生管理', icon: 'User', roles: ['ADMIN'] },
|
|
},
|
|
{
|
|
path: 'teachers',
|
|
name: 'teachers',
|
|
component: () => import('@/views/TeachersView.vue'),
|
|
meta: { title: '教师管理', icon: 'UserFilled', roles: ['ADMIN'] },
|
|
},
|
|
{
|
|
path: 'schedules',
|
|
name: 'schedules',
|
|
component: () => import('@/views/SchedulesView.vue'),
|
|
meta: { title: '课表管理', icon: 'Calendar' },
|
|
},
|
|
{
|
|
path: 'homeworks',
|
|
name: 'homeworks',
|
|
component: () => import('@/views/HomeworksView.vue'),
|
|
meta: { title: '作业发布', icon: 'Notebook' },
|
|
},
|
|
{
|
|
path: 'notifications',
|
|
name: 'notifications',
|
|
component: () => import('@/views/NotificationsView.vue'),
|
|
meta: { title: '通知发布', icon: 'Bell' },
|
|
},
|
|
{
|
|
path: 'grades',
|
|
name: 'grades',
|
|
component: () => import('@/views/GradesView.vue'),
|
|
meta: { title: '成绩录入', icon: 'Trophy' },
|
|
},
|
|
{
|
|
path: 'integrations',
|
|
name: 'integrations',
|
|
component: () => import('@/views/IntegrationsView.vue'),
|
|
// 与后端 requireRole('ADMIN','TEACHER') 对齐:学生角色不该看到这一页
|
|
meta: { title: 'ClassIsland 联动', icon: 'Connection', roles: ['ADMIN', 'TEACHER'] },
|
|
},
|
|
{
|
|
path: 'database',
|
|
name: 'database',
|
|
component: () => import('@/views/DatabaseView.vue'),
|
|
// 与后端 requireRole('ADMIN') 对齐:改动数据库是最高危操作,仅管理员
|
|
meta: { title: '数据库管理', icon: 'Coin', roles: ['ADMIN'] },
|
|
},
|
|
],
|
|
},
|
|
{
|
|
path: '/:pathMatch(.*)*',
|
|
name: 'not-found',
|
|
component: () => import('@/views/NotFoundView.vue'),
|
|
meta: { public: true, title: '页面不存在' },
|
|
},
|
|
];
|
|
|
|
export const router = createRouter({
|
|
history: createWebHistory(),
|
|
routes,
|
|
});
|
|
|
|
/** 读取已保存的登录用户角色(路由守卫用;未登录/解析失败返回 null) */
|
|
function storedRole(): string | null {
|
|
try {
|
|
const raw = localStorage.getItem(STORAGE_KEYS.user);
|
|
if (!raw) return null;
|
|
const parsed = JSON.parse(raw) as { role?: string };
|
|
return parsed?.role ?? null;
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
router.beforeEach((to) => {
|
|
const token = localStorage.getItem(STORAGE_KEYS.token);
|
|
if (to.meta.public) {
|
|
if (to.name === 'login' && token) return { name: 'dashboard' };
|
|
return true;
|
|
}
|
|
if (!token) {
|
|
return { name: 'login', query: { redirect: to.fullPath } };
|
|
}
|
|
// 仅管理员可见的页面(班级/学生/教师管理):直接输网址也要挡回去,
|
|
// 不能依赖"菜单隐藏"——菜单隐藏只是看不见,不是权限。
|
|
const roles = to.meta.roles;
|
|
if (Array.isArray(roles) && roles.length > 0) {
|
|
const role = storedRole();
|
|
if (!role || !(roles as string[]).includes(role)) {
|
|
return { name: 'dashboard' };
|
|
}
|
|
}
|
|
return true;
|
|
});
|
|
|
|
router.afterEach((to) => {
|
|
const title = typeof to.meta.title === 'string' ? to.meta.title : '';
|
|
document.title = title ? `${title} · 班级小助手` : '班级小助手 · 管理端';
|
|
});
|
|
|
|
export default router;
|