biss
6538b6080a
课程约束：可限定校区、教学楼、指定教室、允许上课日、最早/最晚节次。 无教室课程：教室可为空，但仍校验教师和班级冲突。 作息维护：按学期维护节次、上下课时间和启用状态。 发布保护：发布前重新检查全部约束，并阻止学时未排满的课表发布。 工作台升级：增加“排课规则与作息”“自动排课”入口，自动生成后仍支持手工微调。 同时兼容 SQLite 和 MySQL，已生成正式迁移。
5.1 KiB
明序教务管理系统
面向普通高校的教务管理系统。后端使用 ASP.NET Core 10、EF Core 10，前端使用 Vue 3、TypeScript 和 Element Plus。
当前已实现系统登录与角色权限、基础数据、用户管理、教师档案、学生档案、课程库、培养方案、教学任务、排课课表、学生选课、成绩管理、考试考场、学籍异动、毕业审核、学位授予、毕业离校和首页统计。人员及课程列表支持组合筛选、服务端分页和完整增删改查；培养方案支持课程模块、专业年级版本、复制新版本、发布锁定和旧版本归档；教学任务支持学期课程开设、多教师、合班、容量校验、发布与结课；排课支持学期作息维护、单双周与周次节次、课程可用时间、校区/教学楼/指定教室约束、不占用教室课程、教室容量、教师/行政班/教室冲突校验、自动生成、手工微调和版本化发布；选课支持批次时间窗、投放范围、容量与学分上限、重复课程与课表冲突校验、退课截止时间和实时教学班名单；成绩管理支持分项比例、批量录入、特殊考试状态、自动总评与绩点、教师提交、学院审核、校级发布和学生成绩单；考试管理支持考试计划、场次、考场容量、监考教师、考生名单以及考场/监考/学生时间冲突校验；学籍异动支持休学、复学、退学申请，辅导员、学院、学校三级顺序审核，学生撤回，以及最终审批后自动同步学籍状态；毕业审核按入学年级匹配已发布培养方案，以正式成绩计算总学分、必修通过和未解决不及格课程，支持学院范围查看、人工复核、校级锁定发布和学生结果查询；学位授予以已发布毕业资格为来源，按正式成绩加权平均绩点生成规则结论，支持学院人工复核、校级发布锁定和学生结果查询；毕业离校支持自定义事项与责任部门，按校级、学院、辅导员角色分工办理，强制数据范围校验，学生进度查询，以及必办事项全部完成后的批次锁定。
权限采用后端强制校验的角色与数据范围模型。多角色账号按 All > College > Class > Self 取最高数据范围：校级角色可访问全校数据，院系管理员限定本学院，辅导员通过稳定的账号 ID 绑定所带行政班，教师和学生限定本人及当前教学关系；前端菜单和路由限制仅作为交互辅助，不替代 API 授权。
本地开发：热更新模式
本地开发固定使用 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 |
| 校级教务 | academic |
Academic@123456 |
| 学院教务 | college |
College@123456 |
| 所带班级 | counselor |
Counselor@123456 |
| 教师本人 | teacher |
Teacher@123456 |
| 学生本人 | student |
Student@123456 |
| 领导查看 | leader |
Leader@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