明序校园综合服务平台说明书

本 Wiki 是“明序校园综合服务平台”的使用、部署和开发说明。平台面向普通高校，覆盖基础数据、教学运行、学生服务、成绩考试、学籍毕业、体育健康、校园事务与运维审计等业务；后端为 ASP.NET Core 10 / EF Core 10，正式发布前端为 Vue 3 / TypeScript / Element Plus。仓库中的 React / Ant Design 前端正在并行迁移和联调，完成发布切换前不替代现有前端。

学校名称、平台名称与定位语统一维护在 src/Jiaowu.Api/appsettings.json 的 Branding 节；面向其他学校部署时无需修改业务代码。

本文档以当前代码库的功能为准。页面是否可见、可操作范围及数据范围由账号角色和后端授权共同决定；前端菜单仅用于辅助导航，不能替代权限校验。

从这里开始

读者	建议先阅读
首次使用人员	快速开始与账号、角色与数据权限
教务处、学院教务管理员	教学运行与排课、选课与教学服务、成绩考试与统计
教师	教师工作台
学生	学生服务指南
学籍、毕业、学位管理人员	学籍毕业与学位
系统管理员、运维人员	系统管理与运维、部署指南
开发与实施人员	开发指南与架构

文档目录

快速开始与账号：访问方式、登录、自助激活、个人账户与常见入口。
角色与数据权限：系统角色、数据范围与职责边界。
教学运行与排课：基础数据、课程、培养方案、教学任务、校历、排课课表和实验教学。
选课与教学服务：选课批次、候补递补、调停课、教室预约与考勤。
教师工作台：授课申报、课表、名单、点名、成绩和评价。
学生服务指南：选课、课表、成绩、体质健康、学业预警、规划、申请、证明和移动端。
成绩考试与统计：成绩全流程、实验成绩、其他考试、考试安排和分析报表。
学籍毕业与学位：异动、预警、毕业审核、学位授予和离校。
系统管理与运维：账号权限、插件中心、通知、教室报修、审计、备份、性能、App 更新与 Swagger。
部署指南：本地运行、生产配置、MySQL、Docker、systemd 与升级。
开发指南与架构：项目结构、接口约定、构建测试和扩展原则。

业务主线

组织与学期 → 课程与培养方案 → 教学任务 → 排课 / 实验安排
                                      ↓
             教师授课申报 ← 选课批次 ← 发布教学班
                                      ↓
                    点名 / 调停课 / 考试 → 成绩录入与审核发布
                                                      ↓
                         学业规划 / 预警 → 毕业审核 → 学位与离校

使用约定

先维护基础数据，再创建依赖它的业务数据。例如，建立教学任务前应完成学期、课程、教师、行政班等维护。
“发布”“结课”“锁定”等状态变更通常具有业务约束；应先检查清单、冲突和审批状态。
Excel 导入均应先下载系统模板。系统会在写入前校验整批数据，失败时不写入部分数据。
课程、人员、教学任务、成绩、考试等列表支持筛选和分页。请使用条件检索，而不要依赖浏览器一次加载全部数据。
任何密码、JWT 密钥、连接串、SSO 密钥和 .env 文件都不得提交到代码仓库或通过普通聊天渠道传递。

获取帮助

操作问题请先记录：访问页面、账号角色、操作时间、筛选条件、完整提示信息和可复现步骤。管理员可结合“运维与审计”中的审计日志、任务状态和性能信息定位问题；接口问题可在获超级管理员授权且 Swagger 已开启时查看接口文档。