Files
ClassHelper/packages/web-admin/src/views/LoginView.vue
T
LoveChengke 817af02357 feat(permissions,clients,ai,system,server,web,client,shared)!: 权限组 + 客户端设备远控与自动更新 + 大模型助手 + 系统诊断(1.3.0)
功能级准入改为「权限键」,`requireRole` 退成默认模板。

权限组
- 权限目录(39 键:键 / 中文名 / 分类 / 默认角色)收口到 shared,路由挂 requirePermission / requireAnyPermission
- 有效权限每请求实时算,改完分组立刻生效:ADMIN 全集且 permission:manage、system:manage 不可剥夺;
  CLASS_DEVICE 空集(不受分组影响);有分组 = 并集(因此也能用来**收回**权限);无分组 = 角色默认模板
- 新增「权限组」页:组增删改、成员分配、生效权限预览
- 班级维度的科目规则(assertCanManageSubjectContent)故意不可被权限组覆盖

客户端设备(ClassHelper 桌面端)
- 设备身份是 deviceKey(首次启动生成的 UUID,saveConfig 拒绝改写、退出登录也保留)
- 心跳走「DB 记状态 + 客户端定时拉」,不引入新的长连接:30 秒一次,在线窗口 90 秒
- 远控命令 shutdown / restart / logoff / lock:服务端有效期 10 分钟,客户端弹默认选中「取消」的对话框、
  60 秒未确认按取消处理,执行后必须回执(重复回执幂等),同一台机器同一条命令只弹一次
- 新增「客户端设备」页:版本一览、一键推送更新、下发远控

客户端安装包由服务端下载并缓存(教室机常常没有外网,浏览器也受 CSP 限制)
- POST /api/update/client/fetch 由服务端下载到 data/client-releases/<版本>/ 并登记 sha256 + size
- 自动安装三条护栏:没有 sha256 就拒收、必须等到非上课且主窗口隐藏满 5 分钟、冒烟模式永不安装

大模型助手:只解析、不落库
- POST /api/ai/interpret 返回**待确认**的结构化动作(建作业 / 发通知 / 叫人),
  真正落库仍调既有端点 —— 权限断言、上课时段紧急通知保护、ClassIsland 推送全部自动复用
- 模型给的 params 用与手动入口**同一份** zod 再校验(模型输出不可信)
- API Key 走 AES-256-GCM(密钥由 JWT_SECRET 经 scrypt 派生)加密存 AppSetting,只进不出
- provider=mock 是离线确定性解析,自动化验收一律用它;每次解析写一条 AiAudit(不含密钥)

系统与运维
- 开发者模式(服务端内存缓存开关,热路径不查库;开启后 500 才附 error.stack)、运行诊断(绝不回传密钥)
- 开机自启动运行期可改:Windows 改 HKCU\...\Run、Linux systemctl enable/disable,
  **非安装形态一律返回 supported:false**,不往开发机的注册表里写自启项
- 服务端侧栏折叠只用 CSS 收拢(不重建 DOM),关怀模式只放大字号与控件、不动任何几何令牌

客户端
- 崩溃自愈:渲染进程挂掉 / 超 10 秒无响应先静默重建主窗口(10 分钟最多 3 次),
  未捕获异常只在「没在上课、没人看着」时才重启进程;冒烟模式绝不重启(会杀掉验证实例)
- 上线补弹离线期间收到的消息只做一次:起点只在「可达 → 不可达」的边界写,恢复时取最近 5 条按时间升序推

发布内容批量
- POST /notifications/bulk、POST /homeworks/bulk:**单班失败不影响整批**,逐班返回结果
- 作业的科目名跨班**按名匹配**已有课程,找不到就整班记失败,绝不自动建课
  (自动建课会把创建者写成任课老师,等于越权改任教关系)
- 通知与作业同口径按「所属日期」归档,新增 /notifications/days 与 /notifications/creators

BREAKING CHANGE: 能不能做某件事不再看角色名,而是看权限键(GET /api/permissions/me)。
未分组的账号按角色默认模板生效,行为与 1.2.0 一致;分组之后生效集合只由组的并集决定。
服务端首次启动会自动应用 1 个数据库迁移(权限组 3 表 / AppSetting / 客户端设备·命令·安装包 /
AiAudit / Notification.assignDate / User.careMode,历史通知按本地日期回填),升级前请先备份。
2026-10-11 11:49:32 +08:00

171 lines
5.1 KiB
Vue

<script setup lang="ts">
import { reactive, ref } from 'vue';
import { useRoute, useRouter } from 'vue-router';
import { ElMessage, type FormInstance, type FormRules } from 'element-plus';
import { useAuthStore } from '@/stores/auth';
const route = useRoute();
const router = useRouter();
const auth = useAuthStore();
const formRef = ref<FormInstance>();
const form = reactive({ username: '', password: '' });
const rules: FormRules = {
username: [{ required: true, message: '请输入用户名', trigger: 'blur' }],
password: [{ required: true, message: '请输入密码', trigger: 'blur' }],
};
async function submit(): Promise<void> {
const valid = await formRef.value?.validate().catch(() => false);
if (!valid) return;
try {
await auth.login({ username: form.username.trim(), password: form.password });
ElMessage.success(`欢迎回来,${auth.displayName}`);
const redirect = typeof route.query.redirect === 'string' ? route.query.redirect : '/dashboard';
await router.replace(redirect);
} catch {
// 错误提示已由 axios 拦截器统一处理
}
}
</script>
<template>
<div class="login-page">
<div class="login-card">
<div class="login-brand">
<img class="login-logo" src="/logo.png" alt="" width="44" height="44" />
<div>
<h1 class="login-title">ClassHelper</h1>
<p class="login-subtitle">Web 管理端 · 教师 / 管理员登录</p>
</div>
</div>
<el-form ref="formRef" :model="form" :rules="rules" size="large" @submit.prevent="submit">
<el-form-item prop="username">
<el-input v-model="form.username" placeholder="用户名" :prefix-icon="'User'" clearable />
</el-form-item>
<el-form-item prop="password">
<el-input
v-model="form.password"
type="password"
placeholder="密码"
:prefix-icon="'Lock'"
show-password
@keyup.enter="submit"
/>
</el-form-item>
<el-button type="primary" size="large" class="login-button" :loading="auth.loading" @click="submit">
登录
</el-button>
</el-form>
</div>
</div>
</template>
<style scoped>
.login-page {
min-height: 100vh;
min-height: 100dvh;
display: flex;
align-items: center;
justify-content: center;
padding: 16px;
background: linear-gradient(135deg, #1f2d3d 0%, #3a5169 55%, #409eff 100%);
}
.login-card {
width: 400px;
max-width: 100%;
background: #fff;
border-radius: 14px;
padding: 30px 28px 22px;
box-shadow: 0 18px 40px rgba(15, 30, 50, 0.28);
/*
* 登录卡片**永远按浅色渲染**。
*
* 页面底色是刻意固定的深色渐变(AGENTS.md §5 第 46 条),卡片按设计就是"深底白卡"。
* 但卡片的内部颜色原本会随 `html.dark` 变:Element Plus 的深色 css-vars 与 `--ch-*`
* 是挂在 `<html>` 上的,照常继承进白卡片 —— 于是深色主题下出现"白卡片 + 深色输入框 +
* 浅灰字"的黑白混搭(用户反馈的「登录页出现黑夜白天模式混合显示」)。
* 这里把卡片范围内的语义色与关键 --el-* 变量钉回浅色值;原生控件也一并声明为 light。
*/
color-scheme: light;
--ch-surface: #ffffff;
--ch-surface-alt: #f7f9fc;
--ch-surface-sunken: #f2f3f5;
--ch-surface-hover: #e6e8eb;
--ch-border: #e6e8ef;
--ch-text: #303133;
--ch-text-secondary: #606266;
--ch-text-muted: #909399;
--ch-text-placeholder: #c0c4cc;
--el-bg-color: #ffffff;
--el-bg-color-overlay: #ffffff;
--el-bg-color-page: #f2f4f8;
--el-text-color-primary: #303133;
--el-text-color-regular: #606266;
--el-text-color-secondary: #909399;
--el-text-color-placeholder: #c0c4cc;
--el-text-color-disabled: #a8abb2;
--el-fill-color-blank: #ffffff;
--el-fill-color-light: #f2f3f5;
--el-fill-color-lighter: #f5f7fa;
--el-fill-color: #f2f3f5;
--el-border-color: #e6e8ef;
--el-border-color-light: #e6e8ef;
--el-border-color-lighter: #e6e8ef;
--el-color-primary: #409eff;
/*
* 入场用 PANEL 弹簧(beUI 的 center-morph-modal 观感:从略小、略高处落下来)。
* 登录页是整个应用里最"一次性"、最值得给一点分量的一屏 ——
* 它不像弹窗那样会被反复开关,慢一点不会变成等待。
* keyframes 定义在 styles/index.css 的动效层里(全局,scoped 样式也能引用)。
*/
animation: ch-panel-in var(--ch-spring-panel-dur) var(--ch-spring-panel) both;
}
@media (max-width: 768px) {
.login-card {
padding: 22px 18px 18px;
border-radius: 12px;
}
.login-title {
font-size: 18px;
}
.login-brand {
margin-bottom: 16px;
}
}
.login-brand {
display: flex;
align-items: center;
gap: 12px;
margin-bottom: 22px;
}
/* 品牌标:与应用图标同一份图(`public/logo.png`)。图自带圆角与透明边角,不要再加 border-radius。 */
.login-logo {
flex: none;
display: block;
}
.login-title {
font-size: 20px;
margin: 0;
}
.login-subtitle {
margin: 4px 0 0;
font-size: 13px;
color: var(--ch-text-muted);
}
.login-button {
width: 100%;
}
</style>