明序教务管理系统

面向普通高校的教务管理系统。后端使用 ASP.NET Core 10、EF Core 10，前端使用 Vue 3、TypeScript 和 Element Plus。

当前已实现系统登录与角色权限、基础数据、用户管理、教师档案、学生档案、课程库和首页统计。人员及课程列表支持组合筛选、服务端分页和完整增删改查。

本地开发：热更新模式

本地开发固定使用 SQLite。首次启动会自动创建 src/Jiaowu.Api/data/jiaowu-dev.sqlite 并写入演示组织数据。

dotnet run --project src/Jiaowu.Api

另开一个终端：

Set-Location web
npm install
npm run dev

访问 http://localhost:5173，开发账号为 admin，密码为 Admin@123456。

本地开发：单服务模式

不需要前端热更新时，可以先把 Vue 编译进 API 的 wwwroot：

npm --prefix web run build
dotnet run --project src/Jiaowu.Api

访问 http://localhost:5255。/api 和静态页面由同一个 ASP.NET Core 服务提供，/base-data 等前端路由刷新时也会回退到 index.html。

MySQL 部署

非 Development 环境只允许使用 MySQL。dotnet publish 会自动执行 npm ci 和 npm run build，并将 Vue 静态文件放入发布目录的 wwwroot：

$env:ASPNETCORE_ENVIRONMENT = 'Production'
$env:Database__Provider = 'MySql'
$env:ConnectionStrings__MySql = 'Server=127.0.0.1;Port=3306;Database=jiaowu;User=YOUR_USER;Password=YOUR_PASSWORD;'
$env:Jwt__Key = '至少32字节的随机生产密钥'
dotnet publish src/Jiaowu.Api -c Release -o .artifacts/publish
.artifacts/publish/Jiaowu.Api.exe

如需在特殊流水线中跳过自动前端构建，可传入 -p:BuildFrontendOnPublish=false。

生产环境不会创建默认管理员。首次部署前可以临时配置 SeedAdmin__UserName、SeedAdmin__Password 和 SeedAdmin__DisplayName，账号创建后移除这些配置。

生产数据库使用 MySQL 专用 EF Core 迁移。部署前先恢复仓库工具并检查迁移：

dotnet tool restore
dotnet ef migrations list --project src/Jiaowu.Api --startup-project src/Jiaowu.Api

应用启动时会自动执行尚未应用的 MySQL 迁移。SQLite 只用于本地开发：新库通过 EnsureCreated 建立，已有开发库通过轻量、版本化的本地升级脚本补齐结构，不需要手动删除数据文件。SQLite 文件不能用于生产。

验证

dotnet test Jiaowu.slnx
npm --prefix web run build
pwsh.exe -NoLogo -NoProfile -NonInteractive -File scripts/smoke-test.ps1