添加wiki

Home.md

@@ -1 +1,55 @@
-欢迎来到百科。
+# 明序教务管理系统说明书
+
+本 Wiki 是“明序教务管理系统”的使用、部署和开发说明。系统面向普通高校，覆盖基础数据、教学运行、学生服务、成绩考试、学籍毕业与运维审计等业务；后端为 ASP.NET Core 10 / EF Core 10，前端为 Vue 3 / TypeScript / Element Plus。
+
+> 本文档以当前代码库的功能为准。页面是否可见、可操作范围及数据范围由账号角色和后端授权共同决定；前端菜单仅用于辅助导航，不能替代权限校验。
+
+## 从这里开始
+
+| 读者 | 建议先阅读 |
+| --- | --- |
+| 首次使用人员 | [[快速开始与账号]]、[[角色与数据权限]] |
+| 教务处、学院教务管理员 | [[教学运行与排课]]、[[选课与教学服务]]、[[成绩考试与统计]] |
+| 教师 | [[教师工作台]] |
+| 学生 | [[学生服务指南]] |
+| 学籍、毕业、学位管理人员 | [[学籍毕业与学位]] |
+| 系统管理员、运维人员 | [[系统管理与运维]]、[[部署指南]] |
+| 开发与实施人员 | [[开发指南与架构]] |
+
+## 文档目录
+
+1. [[快速开始与账号]]：访问方式、登录、自助激活、个人账户与常见入口。
+2. [[角色与数据权限]]：系统角色、数据范围与职责边界。
+3. [[教学运行与排课]]：基础数据、课程、培养方案、教学任务、排课课表和实验教学。
+4. [[选课与教学服务]]：选课批次、候补递补、调停课、教室预约与考勤。
+5. [[教师工作台]]：授课申报、课表、名单、点名、成绩和评价。
+6. [[学生服务指南]]：选课、课表、成绩、学业规划、申请、证明和移动端。
+7. [[成绩考试与统计]]：成绩全流程、实验成绩、其他考试、考试安排和分析报表。
+8. [[学籍毕业与学位]]：异动、预警、毕业审核、学位授予和离校。
+9. [[系统管理与运维]]：账号权限、通知、审计、备份、性能、App 更新与 Swagger。
+10. [[部署指南]]：本地运行、生产配置、MySQL、Docker、systemd 与升级。
+11. [[开发指南与架构]]：项目结构、接口约定、构建测试和扩展原则。
+
+## 业务主线
+
+```text
+组织与学期 → 课程与培养方案 → 教学任务 → 排课 / 实验安排
+                                      ↓
+             教师授课申报 ← 选课批次 ← 发布教学班
+                                      ↓
+                    点名 / 调停课 / 考试 → 成绩录入与审核发布
+                                                      ↓
+                         学业规划 / 预警 → 毕业审核 → 学位与离校
+```
+
+## 使用约定
+
+- 先维护基础数据，再创建依赖它的业务数据。例如，建立教学任务前应完成学期、课程、教师、行政班等维护。
+- “发布”“结课”“锁定”等状态变更通常具有业务约束；应先检查清单、冲突和审批状态。
+- Excel 导入均应先下载系统模板。系统会在写入前校验整批数据，失败时不写入部分数据。
+- 课程、人员、教学任务、成绩、考试等列表支持筛选和分页。请使用条件检索，而不要依赖浏览器一次加载全部数据。
+- 任何密码、JWT 密钥、连接串、SSO 密钥和 `.env` 文件都不得提交到代码仓库或通过普通聊天渠道传递。
+
+## 获取帮助
+
+操作问题请先记录：访问页面、账号角色、操作时间、筛选条件、完整提示信息和可复现步骤。管理员可结合“运维与审计”中的审计日志、任务状态和性能信息定位问题；接口问题可在获超级管理员授权且 Swagger 已开启时查看接口文档。

_Sidebar.md

@@ -0,0 +1,14 @@
+# 明序教务管理系统
+
+- [[首页|Home]]
+- [[快速开始与账号]]
+- [[角色与数据权限]]
+- [[教学运行与排课]]
+- [[选课与教学服务]]
+- [[教师工作台]]
+- [[学生服务指南]]
+- [[成绩考试与统计]]
+- [[学籍毕业与学位]]
+- [[系统管理与运维]]
+- [[部署指南]]
+- [[开发指南与架构]]

学生服务指南.md

@@ -0,0 +1,40 @@
+# 学生服务指南
+
+## 我的培养方案与学业规划
+
+“我的培养方案”展示本人入学年级、专业对应的已发布培养方案，以及每门课程的完成状态和学分进度。发现适用方案异常时，联系学院教务核对专业、行政班和入学年级，不要自行依据其他年级方案判断毕业资格。
+
+“学业规划与毕业模拟”基于正式课程、已发布成绩和培养方案规则进行非破坏性预测，可帮助识别待完成课程、先修约束和建议学期。模拟结果仅供规划，不会替代学校最终发布的毕业审核结论。
+
+## 选课、课表与教室
+
+在选课批次开放期间进入“学生选课”，查看可选课程、已选课程与候补状态。选择前应核对时间、学分、课程重复和容量；系统会阻止不满足条件的请求。需要退课时必须在批次设定的截止时间前完成。
+
+“我的课表”显示已发布的学习安排；课程、考试和补考可订阅至日历客户端。可在“空闲教室”按时间和容量查询，并按规定预约教室。课表临时调整以系统中的最新记录和通知为准。
+
+## 考勤与课堂签到
+
+在“我的考勤”查看点名记录。二维码签到时使用教师展示的有效二维码，扫码后确认课程与时限再提交；定位签到需授予 App 必要的精确位置权限并在教学地点附近完成。系统会校验教学班身份、时间、距离和定位精度，代签或伪造定位可能被记录为异常。
+
+认为记录有误时，按页面规则提交考勤申诉并写明原因，等待教师或管理人员审核。
+
+## 成绩与其他考试
+
+“学业成绩”显示已经正式发布的课程成绩、分项及状态（以页面权限为准）。总评、绩点与通过状态由服务端计算；学生不应依据本地 Excel 公式或截图作为正式成绩凭据。
+
+“其他考试成绩”用于查看学校录入的独立外部考试成绩及历史。课程成绩更正、免修、缓考、课程替代等事项通过“审批中心”按业务规则申请和跟踪，不能直接修改成绩记录。
+
+## 考试、学籍与毕业
+
+- 在“考试安排”“补考安排”查看本人考试时间、地点、座位等正式安排，提前核对证件与考场规则。
+- 在“学籍异动”提交休学、复学或退学申请；可在最终审批前按页面规则撤回，流程依次经过辅导员、学院和学校审核。
+- 在“学业预警”关注待完成或存在风险的学业事项。
+- 在“毕业资格”“学位结果”“毕业离校”查看学校发布的结论和待办。毕业模拟不等同于最终资格，正式结论以已发布审核结果为准。
+
+## 电子成绩单与证明
+
+可在“电子成绩单与证明”按系统开放的类型自助申请官方凭证。系统生成带唯一编号与二维码的 PDF；第三方可通过验真页面核验编号、签发状态、有效性和必要的公开信息。凭证失效或重新签发后，应以最新有效版本为准。
+
+## Android App
+
+App 使用与网页相同的账号。首次安装或登录后，可使用“我的课表、考试安排、课堂签到、消息中心”等快捷入口；桌面组件显示最近成功加载的今日课表与近期考试，退出账号后会清除本地组件数据。普通前端更新可由 App 的 OTA 更新器下发，但涉及相机、定位等原生权限或插件变更时必须安装新版 App。