新增 [Eis.Tools (line 1)](C:/Users/BI/Documents/EIS-dotnet/src/Eis.Tools/Program.cs:1)，支持 database init/reset/seed。

数据库维护、安全校验和事务逻辑位于 [DatabaseMaintenanceService.cs (line 1)](C:/Users/BI/Documents/EIS-dotnet/src/Eis.Infrastructure/Data/DatabaseMaintenanceService.cs:1)。内置完整演示数据：1200 名考生、10800 条成绩、2404 条招生记录。删除旧 import-test-data.mjs 和 reset-dev-database.mjs 运行入口。 Docker 镜像同时包含 Web 和 /app/tools/Eis.Tools.dll。 [package.json (line 11)](C:/Users/BI/Documents/EIS-dotnet/package.json:11) 原数据库命令已改为调用 .NET。新增统一发布脚本：[publish.ps1 (line 1)](C:/Users/BI/Documents/EIS-dotnet/scripts/publish.ps1:1)。
2026-07-23 16:25:40 +08:00
parent e3c04dad8a
commit f3ffc18aae
23 changed files with 1299 additions and 281 deletions
@@ -100,6 +100,25 @@ dotnet run --project .\src\Eis.Web\Eis.Web.csproj

 本地开发无需额外配置，首次运行会自动创建 `data/exam.sqlite` 和完整关系型数据库结构，但不会导入学校、考生、考试或报名测试数据。首次建库会写入系统基础配置、默认审批流程和一个超级管理员；账号、密码和显示名可通过 `INITIAL_ADMIN_USERNAME`、`INITIAL_ADMIN_PASSWORD`、`INITIAL_ADMIN_DISPLAY_NAME` 设置。当前数据库结构版本为 v20。

+统一发布 Web 和数据库工具：
+
+```powershell
+pwsh.exe -NoLogo -NoProfile -NonInteractive -File .\scripts\publish.ps1
+```
+
+发布结果分别位于 `artifacts/publish/web` 和 `artifacts/publish/tools`。服务器启动 Web：
+
+```powershell
+dotnet .\artifacts\publish\web\Eis.Web.dll
+```
+
+数据库工具使用编译后的 `Eis.Tools.dll`，不需要源代码或 `dotnet run`：
+
+```powershell
+dotnet .\artifacts\publish\tools\Eis.Tools.dll database init --sqlite --path .\data\exam.sqlite
+dotnet .\artifacts\publish\tools\Eis.Tools.dll database seed --sqlite --path .\data\demo.sqlite --dry-run
+```
+
 ### Docker

 项目根目录包含生产镜像和 Docker Compose 配置。默认使用 SQLite，数据库保存在命名卷 `exam-information-data` 中，因此重建容器不会丢失数据。
@@ -131,7 +150,15 @@ docker compose logs --follow app
 docker build --tag hengzhun-exam-system:local .
 ```

-镜像仅包含 ASP.NET Core 10 运行时，默认监听 `0.0.0.0:4173`，以非 root 用户运行，并通过 `/health/live` 执行健康检查。需要连接 MySQL 或 Redis 时，用运行环境变量覆盖 `DATABASE_CLIENT`、`DATABASE_URL`/`MYSQL_*`、`REDIS_URL`；认证状态默认使用同一 Redis 服务的独立 DB 1，也可以通过 `REDIS_SESSION_DB` 或 `REDIS_SESSION_URL` 单独配置。此时 SQLite 数据卷可以移除。
+镜像包含 ASP.NET Core 10 Web 宿主和编译后的 `/app/tools/Eis.Tools.dll`，默认监听 `0.0.0.0:4173`，以非 root 用户运行，并通过 `/health/live` 执行健康检查。需要连接 MySQL 或 Redis 时，用运行环境变量覆盖 `DATABASE_CLIENT`、`DATABASE_URL`/`MYSQL_*`、`REDIS_URL`；认证状态默认使用同一 Redis 服务的独立 DB 1，也可以通过 `REDIS_SESSION_DB` 或 `REDIS_SESSION_URL` 单独配置。此时 SQLite 数据卷可以移除。
+
+容器内执行数据库工具前应先停止 Web，SQLite 目标必须与命名卷路径完全一致：
+
+```powershell
+docker compose stop app
+docker compose run --rm --entrypoint dotnet app /app/tools/Eis.Tools.dll database seed --sqlite --path /app/data/exam.sqlite --confirm-target /app/data/exam.sqlite
+docker compose up --detach app
+```

 #### Gitea Actions 自动发布到 Docker Hub 与 Gitea 软件包

@@ -165,7 +192,7 @@ git push origin v1.3.0-rc.1

 首次成功推送后，容器镜像会出现在 `biss` 所有者的软件包列表。Gitea 的软件包归属于用户或组织，不会天然归属于某个仓库；打开该软件包的设置页面，将它关联到 `Exam-Information-System`，即可让它显示在此仓库的“软件包”页。之后可使用 `docker pull git.biss.click/biss/exam-information-system:latest` 拉取。

-应用会在空库上自动创建结构和基础配置。旧版 Node 数据重置、样例数据和地区快照构建脚本仍保留为开发维护工具，不会被生产镜像复制或执行；运行这些脚本前必须明确数据库目标，且不得对生产业务库执行。
+应用会在空库上自动创建结构和基础配置。测试数据导入和空库重建均由编译后的 `Eis.Tools.dll` 完成；旧 Node 导入入口已移除。演示数据包内置于 `Eis.Infrastructure.dll`，生产服务器不需要 Node.js。

 ## 数据库配置

@@ -252,21 +279,25 @@ dotnet run --project .\src\Eis.Web\Eis.Web.csproj

 ### 导入服务器 MySQL 测试数据

-先停止正在运行的应用进程，确认服务器 `.env` 中已经设置 `DATABASE_CLIENT=mysql` 及完整 MySQL 连接参数，然后执行：
+先停止正在运行的应用进程，确认服务器 `.env` 中已经设置 `DATABASE_CLIENT=mysql` 及完整 MySQL 连接参数。先预检并确认工具输出的数据库名：

 ```powershell
-npm run seed-test-data:mysql
+dotnet .\artifacts\publish\tools\Eis.Tools.dll database seed --mysql --dry-run
 ```

-脚本会读取 `.env`，校验当前连接的数据库名称、v15 表结构和已有数据。目标是新数据库时会自动建表并导入；目标只有首次启动生成的空业务结构时会在事务中替换为样例数据。若检测到学校、考生、考试、报名等业务数据，脚本默认拒绝覆盖。
-
-仅在确认目标是可以完全覆盖的测试库时使用：
+确认目标测试数据库名为 `exam_test` 后执行：

 ```powershell
-npm run seed-test-data:mysql -- --force
+dotnet .\artifacts\publish\tools\Eis.Tools.dll database seed --mysql --confirm-target exam_test
 ```

-强制模式会删除该 MySQL 数据库内现有应用数据并在同一事务中写入样例数据，但不会删除数据库或数据表。导入完成后再重新启动应用，避免导入期间出现并发写入或保留旧登录会话。不要对生产业务库执行此命令。本地需要明确使用 SQLite 时可运行 `npm run seed-test-data:sqlite`。
+工具会读取 `.env`，拒绝 MySQL 系统数据库，校验 v20 结构和已有数据，并在同一事务内清理、导入。若检测到无法识别为内置演示数据的业务记录，默认拒绝覆盖。仅在确认目标确实是可完全覆盖的测试库时追加：
+
+```powershell
+dotnet .\artifacts\publish\tools\Eis.Tools.dll database seed --mysql --confirm-target exam_test --force
+```
+
+强制模式会删除该 MySQL 数据库内现有应用数据并在同一事务中写入样例数据，但不会删除数据库本身。MySQL 操作前应另行完成数据库备份；不要对生产业务库执行该命令。

 ## 中考志愿填报与招生录取

@@ -307,20 +338,20 @@ npm run seed-test-data:mysql -- --force

 ## 测试结束后初始化系统

-先停止应用，然后运行以下命令。命令会读取 `.env` 并自动选择 SQLite 或 MySQL，删除样例学校、考生、考试、报名等业务数据，恢复系统基础配置和一个初始超级管理员：
+先停止应用。SQLite 重建会自动生成带时间戳的原库备份，然后恢复系统基础配置和一个初始超级管理员：

 ```powershell
-npm run initialize-system
+dotnet .\artifacts\publish\tools\Eis.Tools.dll database reset --sqlite --path .\data\exam.sqlite --confirm-target .\data\exam.sqlite
 ```

-也可以明确指定数据库类型：
+MySQL 应先执行 `--dry-run` 确认目标，再明确填写数据库名：

 ```powershell
-npm run initialize-system:sqlite
-npm run initialize-system:mysql
+dotnet .\artifacts\publish\tools\Eis.Tools.dll database reset --mysql --dry-run
+dotnet .\artifacts\publish\tools\Eis.Tools.dll database reset --mysql --confirm-target exam_test
 ```

-MySQL 模式会自动识别由本项目生成的批量样例数据并清理。若目标包含无法识别为样例数据的业务记录，命令会拒绝执行；只有明确确认目标可完全清空时才可运行 `npm run initialize-system:mysql -- --force`。初始化完成后，初始管理员账号由 `.env` 中的 `INITIAL_ADMIN_USERNAME`、`INITIAL_ADMIN_PASSWORD`、`INITIAL_ADMIN_DISPLAY_NAME` 决定，然后再重新启动应用。
+MySQL 模式会自动识别由本项目生成的批量演示数据；目标包含非演示业务记录时仍会拒绝，只有确认可覆盖时才能追加 `--force`。初始化管理员由 `.env` 中的 `INITIAL_ADMIN_USERNAME`、`INITIAL_ADMIN_PASSWORD`、`INITIAL_ADMIN_DISPLAY_NAME` 决定。

 ## 自动化测试

@@ -340,13 +371,15 @@ Eis.slnx                           .NET 10 解决方案
 src/Eis.Domain                     领域模型与业务值
 src/Eis.Application                应用服务契约
 src/Eis.Infrastructure             SQLite/MySQL、认证、缓存、Excel 与业务实现
+src/Eis.Tools                      可独立发布的数据库初始化、重建和演示数据工具
 src/Eis.Web                        ASP.NET Core 宿主、端点和发布静态资源
 tests/Eis.Infrastructure.Tests     xUnit 自动化测试

 index.html / styles.css / app.js    前端入口、样式和控制器
 src/client                         公共、考生、管理及招生前端模块
 src/database/schema.mjs            兼容 SQLite/MySQL 的 v20 建库定义
-scripts                            迁移验证与旧版开发数据维护工具
+scripts/publish.ps1                Web 与数据库工具统一发布脚本
+scripts                            迁移验证及演示数据包维护工具
 server.mjs / src/routes            仅保留的旧 Node 行为对照源码
 data/exam.sqlite                   本地运行后生成的 SQLite 数据库
 .env.example                       开发与生产环境变量模板