- 服务端新增 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 条),属时间相关用例,
与本次改动无关。
37 lines
1.3 KiB
Bash
37 lines
1.3 KiB
Bash
# ---------------------------------------------------------------------------
|
|
# 班级小助手 · Docker 单容器(SQLite)环境变量
|
|
# 复制为 deploy/.env.sqlite 后填写:cp deploy/.env.sqlite.example deploy/.env.sqlite
|
|
# 配合 deploy/docker-compose.sqlite.yml 使用
|
|
# ---------------------------------------------------------------------------
|
|
|
|
# 服务端对外端口(宿主机)。注意与同机其他服务错开:80/443 常被反代占用
|
|
SERVER_PORT=4000
|
|
|
|
# 应用版本(镜像标签)
|
|
APP_VERSION=1.0.0
|
|
|
|
# JWT 签名密钥(必填,必须 ≥32 位;不能包含 secret / change-me 等示例词)
|
|
# 生成:node -e "console.log(require('crypto').randomBytes(48).toString('hex'))"
|
|
JWT_SECRET=
|
|
|
|
# 令牌有效期
|
|
JWT_EXPIRES_IN=7d
|
|
|
|
# 允许的跨域来源;用域名访问时建议写成具体来源,例如 https://class.example.com
|
|
CORS_ORIGIN=*
|
|
|
|
# 首次启动创建的管理员账号(**部署后请立即登录修改密码**)
|
|
INITIAL_ADMIN_USERNAME=admin
|
|
INITIAL_ADMIN_PASSWORD=admin123
|
|
|
|
# 各类账号的默认初始密码(新增/重置时使用)
|
|
DEFAULT_STUDENT_PASSWORD=123456
|
|
DEFAULT_CLASS_PASSWORD=123456
|
|
DEFAULT_TEACHER_PASSWORD=123456
|
|
|
|
# 第 1 教学周的周一(用于"当前周次")
|
|
TERM_START_DATE=2026-08-31
|
|
|
|
# 日志级别:debug | info | warn | error
|
|
LOG_LEVEL=info
|