feat(server,web,desktop,shared,deploy,plugin): 数据库管理模块 + 客户端深色模式/设置拆子路由/首启引导，版本统一 1.0.0

- 服务端新增 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 条），属时间相关用例，与本次改动无关。
2026-10-02 11:18:47 +08:00
1 parent 391e2c1591
commit 572295c297
@@ -96,6 +96,9 @@ importers:
      '@prisma/adapter-libsql':
        specifier: 7.10.0
        version: 7.10.0
+      '@prisma/adapter-mariadb':
+        specifier: 7.10.0
+        version: 7.10.0
      '@prisma/client':
        specifier: 7.10.0
        version: 7.10.0(prisma@7.10.0(@types/react@19.3.0)(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(typescript@5.9.3))(typescript@5.9.3)
@@ -123,9 +126,15 @@ importers:
      jsonwebtoken:
        specifier: ^9.0.3
        version: 9.0.3
+      prisma:
+        specifier: 7.10.0
+        version: 7.10.0(@types/react@19.3.0)(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(typescript@5.9.3)
      socket.io:
        specifier: ^4.8.3
        version: 4.8.3
+      typescript:
+        specifier: ~5.9.3
+        version: 5.9.3
      xlsx:
        specifier: 0.18.5
        version: 0.18.5
@@ -148,18 +157,12 @@ importers:
      '@types/node':
        specifier: ^22.20.2
        version: 22.20.2
-      prisma:
-        specifier: 7.10.0
-        version: 7.10.0(@types/react@19.3.0)(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(typescript@5.9.3)
      socket.io-client:
        specifier: ^4.8.3
        version: 4.8.3
      tsx:
        specifier: ^4.23.13
        version: 4.23.13
-      typescript:
-        specifier: ~5.9.3
-        version: 5.9.3

  packages/shared:
    devDependencies:
@@ -646,6 +649,9 @@ packages:
  '@prisma/adapter-libsql@7.10.0':
    resolution: {integrity: sha512-ANjUjJ/TrDQhR8jFU8HvYWRdwP17Lox1WL81zZvHcPVeFehZfNomAsPMNY24EBTLLZp0Xw4Na5Zf1S+EuKMKxw==}

+  '@prisma/adapter-mariadb@7.10.0':
+    resolution: {integrity: sha512-n/mNi6/l2V79pNwuvzRlZO+X8dr38eqjx1norvXs3t+bTJkSotxwV40HW0SCSl2vBp/YMfX2w6ZHKePgurf1gw==}
+
  '@prisma/client-runtime-utils@7.10.0':
    resolution: {integrity: sha512-cnCy7lUV8/CctgKVEmqAbSLAmwqJdE/qAlqTBk/0NDk59zEb2cZ0M0M0E4vVPnqbSEYudRroQDvOWfUZH6RIfw==}

@@ -1194,6 +1200,10 @@ packages:
    resolution: {integrity: sha512-/5NV/vDALVFDXgLmfsy9TRCBlKwO2LNBFzpzvb9iIj+jR+eSc6DLYYvVOdivT/jm7MtU6TebYuRmzEOI7w40UA==}
    engines: {node: '>=10.0.0'}

+  '@xmldom/xmldom@0.9.12':
+    resolution: {integrity: sha512-5AXjrcMClTryPe9LgZrygpB1lj7s0S9E0+W+AHaVKAVyHanafK86iPSvG5xHVSp/jC+VH1UXu0TAEmY279xH7A==}
+    engines: {node: '>=14.6'}
+
  abbrev@4.0.0:
    resolution: {integrity: sha512-a1wflyaL0tHtJSmLSOVybYhy22vRih4eduhhrkcjgrWGnRfrZtovJ2FRjxuTtkkj47O/baf0R86QU5OuYpz8fA==}
    engines: {node: ^20.17.0 || >=22.9.0}
@@ -2053,8 +2063,8 @@ packages:
    resolution: {integrity: sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==}
    engines: {node: '>=10.13.0'}

-  glob@7.2.3:
-    resolution: {integrity: sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==}
+  glob@7.2.0:
+    resolution: {integrity: sha512-lmLf6gtyrPq8tTjSmrO94wBeQbFR3HbLHbuyD69wuyQkImp2hWqMGB47OX65FBkPffO641IP9jWa1z4ivqG26Q==}
    deprecated: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me

  global-agent@3.0.0:
@@ -2145,6 +2155,10 @@ packages:
    resolution: {integrity: sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==}
    engines: {node: '>= 14'}

+  iconv-lite@0.6.3:
+    resolution: {integrity: sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==}
+    engines: {node: '>=0.10.0'}
+
  iconv-lite@0.7.3:
    resolution: {integrity: sha512-IKXpvIzjnC9XTAUbVBcMfGS0EPaIXtW6v+zr+RRp+hqULEpo0owZax6wyRwPOJbWbzjYspQwusTsfVr0ifh4uQ==}
    engines: {node: '>=0.10.0'}
@@ -2413,6 +2427,9 @@ packages:
    resolution: {integrity: sha512-tqNXrS78oMOE73NMxK4EMLQsQowWf8jKooH9g7xPavRT706R6bkQJ6DY2Te7QukaZsulxa30wQ7bk0pm4XiHmA==}
    engines: {node: '>=8'}

+  lru-cache@10.4.3:
+    resolution: {integrity: sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==}
+
  lru-cache@6.0.0:
    resolution: {integrity: sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==}
    engines: {node: '>=10'}
@@ -2428,6 +2445,10 @@ packages:
  magic-string@0.30.21:
    resolution: {integrity: sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==}

+  mariadb@3.4.5:
+    resolution: {integrity: sha512-gThTYkhIS5rRqkVr+Y0cIdzr+GRqJ9sA2Q34e0yzmyhMCwyApf3OKAC1jnF23aSlIOqJuyaUFUcj7O1qZslmmQ==}
+    engines: {node: '>= 14'}
+
  matcher@3.0.0:
    resolution: {integrity: sha512-OkeDaAZ/bQCxeFAozM55PKcKU0yJMPGifLwV4Qgjitu+5MoAfSQN4lsLJeXZ1b8w0x+/Emda6MZgXS1jvsapng==}
    engines: {node: '>=10'}
@@ -2684,6 +2705,10 @@ packages:
    resolution: {integrity: sha512-uysumyrvkUX0rX/dEVqt8gC3sTBzd4zoWfLeS29nb53imdaXVvLINYXTI2GNqzaMuvacNx4uJQ8+b3zXR0pkgQ==}
    engines: {node: '>=10.4.0'}

+  plist@3.1.1:
+    resolution: {integrity: sha512-ZIfcLJC+7E7FBFnDxm9MPmt7D+DidyQ26lewieO75AdhA2ayMtsJSES0iWzqJQbcVRSrTufQoy0DR94xHue0oA==}
+    engines: {node: '>=10.4.0'}
+
  postcss-selector-parser@7.1.6:
    resolution: {integrity: sha512-7qASPzhKF2l2KLboRZux8CCTRMdGiV08vWmyKzPz22qZ7ZjQBOeY7rNzNoCLSUiftJ7HUq0GERHmxw/t0dCdMw==}
    engines: {node: '>=4'}
@@ -2987,8 +3012,8 @@ packages:
    resolution: {integrity: sha512-2Dd78bqzzjE6KPkD5fHZmDAKRNe3J15q+YHDrIsy9WEkqttc7GY+kT9OBLSMaPbQaEd0x1BjcmtMtXkfpc+T5A==}
    engines: {node: '>=10.2.0'}

-  source-map-js@1.2.1:
-    resolution: {integrity: sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==}
+  source-map-js@1.2.2:
+    resolution: {integrity: sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==}
    engines: {node: '>=0.10.0'}

  source-map-support@0.5.21:
@@ -3462,7 +3487,7 @@ snapshots:
  '@electron/asar@3.4.1':
    dependencies:
      commander: 5.1.0
-      glob: 7.2.3
+      glob: 7.2.0
      minimatch: 3.1.5

  '@electron/fuses@1.8.0':
@@ -3513,7 +3538,7 @@ snapshots:
      fs-extra: 10.1.0
      isbinaryfile: 4.0.10
      minimist: 1.2.8
-      plist: 3.1.0
+      plist: 3.1.1
    transitivePeerDependencies:
      - supports-color

@@ -3536,7 +3561,7 @@ snapshots:
      dir-compare: 4.2.0
      fs-extra: 11.4.0
      minimatch: 9.0.9
-      plist: 3.1.0
+      plist: 3.1.1
    transitivePeerDependencies:
      - supports-color

@@ -3831,6 +3856,11 @@ snapshots:
      - bufferutil
      - utf-8-validate

+  '@prisma/adapter-mariadb@7.10.0':
+    dependencies:
+      '@prisma/driver-adapter-utils': 7.10.0
+      mariadb: 3.4.5
+
  '@prisma/client-runtime-utils@7.10.0': {}

  '@prisma/client@7.10.0(prisma@7.10.0(@types/react@19.3.0)(react-dom@19.3.0(react@19.3.0))(react@19.3.0)(typescript@5.9.3))(typescript@5.9.3)':
@@ -4383,7 +4413,7 @@ snapshots:
      '@vue/shared': 3.5.42
      entities: 7.0.1
      estree-walker: 2.0.2
-      source-map-js: 1.2.1
+      source-map-js: 1.2.2

  '@vue/compiler-dom@3.5.42':
    dependencies:
@@ -4400,7 +4430,7 @@ snapshots:
      estree-walker: 2.0.2
      magic-string: 0.30.21
      postcss: 8.5.28
-      source-map-js: 1.2.1
+      source-map-js: 1.2.2

  '@vue/compiler-ssr@3.5.42':
    dependencies:
@@ -4469,6 +4499,8 @@ snapshots:

  '@xmldom/xmldom@0.8.15': {}

+  '@xmldom/xmldom@0.9.12': {}
+
  abbrev@4.0.0: {}

  accepts@1.3.8:
@@ -5502,7 +5534,7 @@ snapshots:
    dependencies:
      is-glob: 4.0.3

-  glob@7.2.3:
+  glob@7.2.0:
    dependencies:
      fs.realpath: 1.0.0
      inflight: 1.0.6
@@ -5618,6 +5650,10 @@ snapshots:
    transitivePeerDependencies:
      - supports-color

+  iconv-lite@0.6.3:
+    dependencies:
+      safer-buffer: 2.1.2
+
  iconv-lite@0.7.3:
    dependencies:
      safer-buffer: 2.1.2
@@ -5843,6 +5879,8 @@ snapshots:

  lowercase-keys@2.0.0: {}

+  lru-cache@10.4.3: {}
+
  lru-cache@6.0.0:
    dependencies:
      yallist: 4.0.0
@@ -5857,6 +5895,14 @@ snapshots:
    dependencies:
      '@jridgewell/sourcemap-codec': 1.6.0

+  mariadb@3.4.5:
+    dependencies:
+      '@types/geojson': 7946.0.16
+      '@types/node': 24.13.4
+      denque: 2.1.0
+      iconv-lite: 0.6.3
+      lru-cache: 10.4.3
+
  matcher@3.0.0:
    dependencies:
      escape-string-regexp: 4.0.0
@@ -6089,6 +6135,12 @@ snapshots:
      base64-js: 1.5.1
      xmlbuilder: 15.1.1

+  plist@3.1.1:
+    dependencies:
+      '@xmldom/xmldom': 0.9.12
+      base64-js: 1.5.1
+      xmlbuilder: 15.1.1
+
  postcss-selector-parser@7.1.6:
    dependencies:
      cssesc: 3.0.0
@@ -6098,7 +6150,7 @@ snapshots:
    dependencies:
      nanoid: 3.3.19
      picocolors: 1.1.1
-      source-map-js: 1.2.1
+      source-map-js: 1.2.2

  postgres@3.4.7: {}

@@ -6243,7 +6295,7 @@ snapshots:

  rimraf@2.6.3:
    dependencies:
-      glob: 7.2.3
+      glob: 7.2.0

  roarr@2.15.4:
    dependencies:
@@ -6442,7 +6494,7 @@ snapshots:
      - supports-color
      - utf-8-validate

-  source-map-js@1.2.1: {}
+  source-map-js@1.2.2: {}

  source-map-support@0.5.21:
    dependencies: