1.7 KiB
1.7 KiB
明序教务管理系统
面向普通高校的教务管理系统。后端使用 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。
MySQL 部署
非 Development 环境只允许使用 MySQL。连接串和 JWT 密钥应通过环境变量或安全配置中心提供：
$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 run --project src/Jiaowu.Api
生产环境不会创建默认管理员。首次部署前可以临时配置 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
Set-Location web
npm run build