Commit Graph
125 Commits
  • 已完善个人教学日历订阅。
    主要能力:
    教师、学生可在“我的课表”启用订阅、复制 URL、唤起日历客户端或下载一次性 ICS。
    自动覆盖固定课程、调停课后的最新安排、考试/监考、补考,以及灵活课程提醒。
    采用独立随机订阅标识和 HMAC 签名;重置或停用后旧地址立即失效。
    支持 ETag 条件请求和一小时刷新提示,减少日历客户端重复同步。
    订阅地址按实际前端 API 地址生成,兼容独立部署域名。
    已增加窄屏弹窗最大宽度和纵向操作布局。
  • 将索引缩短为 IX_CE_Offering_Status_WaitlistedAt。
    将候补迁移改为可重入:先检查列和索引是否存在,再执行 DDL。
    附件中已经成功添加 WaitlistedAt、但索引创建失败的数据库可直接重试,不会报重复列。
    运行时和 dotnet ef 连接统一开启 AllowUserVariables;Connector/NET 默认关闭该选项。Connector/NET 官方说明
    增加所有 MySQL 索引名不得超过 64 字符的回归测试。
  • 已把选课的“年级划分”和限制规则补成完整闭环:
    选课批次可指定多个适用年级;留空兼容原有“全部年级”。
    新增可选的“最多课程门数”,与原有学分上限并行。
    年级、门数限制统一作用于学生可见批次、自主选课、候补、管理员代选和自动递补。
    普通候选名单遵守年级及行政班范围;强制选课可绕过业务限制,但仍严格遵守管理员学院权限。
    管理页面会展示“2026 级 · 最多 6 门 · 最多 30 学分”,名单和候补列表也增加年级列。
    新增 MySQL 迁移:[CourseSelectionGradeLimits.cs](E:/jiaowu/src/Jiaowu.Api/Infrastructure/Persistence/Migrations/MySql/20260726180000_CourseSelectionGradeLimits.cs)。
  • 已完成“选课候补与自动递补”完整流程。
    学生端:满员后可加入/取消候补,展示候补顺位和当前候补人数。
    自动递补:退课释放名额后,按候补时间顺序重新校验学籍、范围、学分及时间冲突;不合格者自动失效并继续下一位。
    管理端:教学班显示候补人数,名单抽屉提供候补队列及移出操作。
    状态通知:递补成功、资格失效、批次关闭、管理员移出均会通知学生。
    并发安全:退课和递补放在 Serializable 事务中执行。
    数据库:已补充 SQLite 开发迁移和 MySQL 正式迁移。
  • 仪表盘和 6 类统计摘要接入 HybridCache(内存 + Redis)。
    默认 Redis 缓存 3 分钟、本地缓存 30 秒,可通过环境变量调整。
    缓存键包含数据权限范围、有效学院和全部筛选条件,避免跨学院串数据。
    Excel 导出保持实时查询,不使用摘要缓存。
    无需数据库迁移。
  • 主要变更:
    新增统一缓存封装:[AppCache.cs (line 12)](/E:/jiaowu/src/Jiaowu.Api/Infrastructure/Caching/AppCache.cs:12)
    接入 HybridCache 和可选 Redis:[Program.cs (line 153)](/E:/jiaowu/src/Jiaowu.Api/Program.cs:153)
    缓存学生激活选项、基础数据、公开课表和课表选项。
    个人课表、选课容量、成绩、权限、通知和任务状态保持实时查询。
    基础数据、课程、教师、教学任务、作息、考试和课表发布后自动失效相关缓存。
    新增 /health/cache,Redis 故障不影响 /health/ready。
    Compose 增加 256MB、allkeys-lfu、无持久化的 redis:8.8-alpine 服务;该镜像标签已由 Docker 官方镜像仓库核对。
    更新 [.env.example (line 1)](/E:/jiaowu/.env.example:1) 和 [README.md (line 190)](/E:/jiaowu/README.md:190) 部署说明。
  • 免修、缓考现在包含当前学期课程,以及未归档且课表已发布的实际修读课程。
    实际开发库验证已返回 CS101 程序设计基础。
    课程替代改为“修读中/未通过课程 → 已发布及格课程”的双栏选择。
    新增搜索、教学班号、学期、教师、学分、课表状态和完整空状态说明。
    新增课程替代申请记录。
    提交接口增加服务端资格校验,不能伪造课程 ID 绕过前端。
  • 修复500
    TimeOnly ↔ TimeSpan
  • 学年学期页面新增“设为当前”“归档”“撤销归档”,当前学期不能归档、删除或直接取消;已归档学期需先撤销才能重新设为当前。[BaseDataController.cs (line 286)](/E:/jiaowu/src/Jiaowu.Api/Controllers/BaseDataController.cs:286)
    切换后,其他学期自动变为历史态;已归档学期进一步弱化。所有主要学期选择器统一默认当前,并显示“当前 / 历史 / 已归档”。[academicTerms.ts (line 1)](/E:/jiaowu/web/src/utils/academicTerms.ts:1)
    桌面使用分层表格,390px 手机端改为独立学期卡片,操作不会再挤压表格。[BaseDataView.vue (line 211)](/E:/jiaowu/web/src/views/BaseDataView.vue:211)
    归档定义为“历史显示状态”,不是成绩冻结:补考成绩仍可录入并回写,已发布成绩仍可走成绩更正审批。
    已加入 SQLite 开发迁移、MySQL 正式迁移和切换/归档/撤销测试。[20260726143000_AcademicTermArchiving.cs (line 1)](/E:/jiaowu/src/Jiaowu.Api/Infrastructure/Persistence/Migrations/MySql/20260726143000_AcademicTermArchiving.cs:1)
  • 已完成,学生端考勤记录现在按课程展示。
    每门课程会独立显示:
    课程名称、代码、教学班和任课教师。
    课程总体出勤率。
    出勤、迟到、缺勤、请假、免修次数。
    按日期排列的历次点名记录。
    缺勤或迟到记录仍可单独申诉。
  • ge
    xiufu
  • 新增显式命令:--seed-demo-data --confirm-production-demo-data
    仅允许非 Development 环境运行。
    只允许写入没有业务数据的独立空库。
    演示数据使用单个 InnoDB 事务,失败整体回滚;迁移 DDL 仍单独执行,因为 MySQL 8.4 的 DDL 会隐式提交。MySQL 事务文档、隐式提交说明
    不包含通用测试密码或学生、教师登录账号。
    包含校区、学期、30 间教室、16 个学院、52 个专业、104 个班级、128 名教师、3,640 名学生和148门课程。
  • 新增“课程统计”模式,展示总体出勤率、状态分布、历次趋势和每位学生的出勤明细。
    支持按姓名/学号、行政班及异常情况筛选,默认优先显示低出勤率学生。
    新增课程统计 Excel 导出,包含课程概览、学生出勤明细、历次点名趋势三个工作表。
    统计仅使用已提交点名;出勤和迟到计为到课,免修不计入应到次数。
    修复了枚举兼容问题,已提交点名不会再错误显示为“草稿”,考勤状态中文标签恢复正常。
    统计与导出接口均执行教师/数据范围权限校验。
  • ---
    成绩册 Excel 导入/导出 — 已完成
    
      后端 (GradesController.cs)
    
      GET /api/grades/sheets/{id}/template — 下载成绩导入模板
      - 根据成绩单的动态分项(GradeItems)生成对应的 Excel 列:学号 | 姓名 | 班级 | 平时成绩 | [分项1] | [分项2] | ... | 期末成绩 | 考试状态 | 备注
      - 预填已有学生信息和已有成绩
      - 附带填写说明工作表
    
      POST /api/grades/sheets/{id}/import — 从 Excel 导入成绩
      - 按学号匹配学生,批量更新平时成绩、分项成绩、期末成绩、考试状态、备注
      - 支持留空(不覆盖已有成绩)、0-100 范围校验、考试状态校验(正常/缺考/缓考/免修)
      - 导入后自动重新计算总评成绩和绩点
      - 仅限 Draft/Returned 状态的成绩单,仅限有编辑权限的用户
      - 错误时整批回滚,最多显示 50 条错误详情
    
      前端 (GradesView.vue)
    
      在成绩登记册底部操作栏新增两个按钮(仅在 canEdit 时显示):
      - 下载模板 — 调用 downloadApiFile 下载当前成绩单的 Excel 模板
      - Excel导入 — 通过隐藏 file input 选择 .xlsx 文件,调用 importExcel 上传
    
      工作流程
    
      1. 教师打开成绩单 → 点击「下载模板」
      2. 在 Excel 中填写/修改学生成绩
      3. 点击「Excel导入」选择文件上传
      4. 系统自动校验、合并成绩、重新计算总评 → 提示更新条数
      5. 成绩表刷新显示最新数据
    
    ✻ Crunched for 5m 50s
  • 全部完成。定时检测系统概览:
    新增组件
    
      ┌────────────────────────────────┬─────────────────────────────────────────────────────────┐
      │              组件              │                          说明                           │
      ├────────────────────────────────┼─────────────────────────────────────────────────────────┤
      │ WarningSchedule 实体           │ 定时配置:学期、星期几、时、分、启用/禁用、上次执行时间 │
      ├────────────────────────────────┼─────────────────────────────────────────────────────────┤
      │ WarningCheckWorker             │ BackgroundService,每分钟轮询一次,匹配到时间就执行检测 │
      ├────────────────────────────────┼─────────────────────────────────────────────────────────┤
      │ GET/PUT /api/warnings/schedule │ 读取/保存定时配置                                       │
      └────────────────────────────────┴─────────────────────────────────────────────────────────┘
    
      页面配置
    
      在学业预警页面顶部新增「定时检测」区域:
      - 启用开关:一键开/关自动检测
      - 星期选择:周一至周日
      - 时分选择:精确到分钟
      - 上次执行时间:自动显示
    
      工作流程
    
      每分钟 Worker 轮询
        → 查询 WarningSchedules 表,匹配当前星期+时+分
        → 检查是否已在本分钟执行过(防止重复)
        → 加载该学期全部启用规则 + 在籍学生
        → 逐条规则、逐个学生检测
        → 已存在的同型预警跳过,新预警写入 + 通知学生/辅导员
        → 更新 LastRunAt
    
      管理员配置"每周一 08:00 自动检测",系统就会在每周一早上 8 点整自动执行一次完整的学业预警检测。
  • deepseek
    前台 — 路由 (router/index.ts)
    
      - my-timetable 路由的角色从 ['Student'] 扩展为 ['Student', 'Teacher']
      - 新增 teacher-timetable/:teacherId 路由,用于查看指定教师的课表
    
      前台 — 课表视图 (TimetableView.vue)
    
      - 新增 isTeacherView 和 isTeacher 计算属性,区分教师个人课表和查看他人课表
      - 教师个人课表:标题显示"我的授课课表",描述改为"展示本人本学期所有授课安排"
      - 查看他人课表:标题显示"教师课表"
      - 两种模式均隐藏资源筛选面板,只保留学期选择
      - 加载逻辑适配教师模式 API
    
      前台 — 教师档案页 (PersonnelView.vue)
    
      - 教师行操作列新增 "课表" 按钮(带日历图标),仅在职教师可点击
      - 点击后跳转到该教师的授课课表页面
    
      前台 — 侧边导航 (AdminLayout.vue)
    
      - 教师角色可见"我的授课课表"菜单项,与学生的"我的课表"并列
  • deepseek
    2 处改动:
    
      1. ValidateRequestAsync — 当 classIds 为空时跳过行政班验证(选修课可不选班)
      2. ValidatePublishingTasksAsync — 移除了"发布前至少需要关联一个行政班"的强制校验,允许无行政班的教学任务直接发布
  • 已改成后台“检查并发布”任务,原来的超时主要就是同步逐条校验导致的。
    发布接口立即返回 202 Accepted,页面轮询显示检查进度。
    校验改为批量读取,减少重复数据库查询。
    检查失败保留草稿并显示具体原因;成功后原子完成旧课表归档和新课表发布。
    同一学期禁止两个发布任务并发,服务重启后未完成任务会自动恢复。
    发布期间锁定编辑、自动排课等冲突操作。
    已补齐 SQLite 开发迁移及 MySQL 生产迁移。
  • 已完成教学任务归档纠错功能:
    已归档任务新增“撤销归档”和“删除”,支持单条及批量操作。
    撤销后恢复为“已发布”状态。
    已发布任务仍不可直接删除;被排课、选课、成绩或考试引用的归档任务也会拒绝删除并明确提示。
    状态与操作文案统一为“归档”
  • 自动排课完成后逐条显示“需人工处理”的任务和原因,并提供“检查排课约束”入口;刷新页面后仍可读取最近一次结果。
    批量排课约束新增校区、教学楼、多教室统一指定,也支持清除原有限定。
    课表新增“总视图”,同一时段、不同周次课程会并列显示。
    周视图按教学周过滤,支持上一周、下一周、周次下拉和回到本周。
    日视图按周次过滤;连续两节课程会跨两行完整占格。
  • 教师档案增加“激活账号”:管理员设置初始密码,服务端校验管理权限、学院数据范围、在职状态、工号冲突,并自动关联教师角色与档案。
    已发布课表增加“发布后修改”:创建修订草稿,旧课表继续生效;修订版重新发布后再替换旧版本。
    修复 390px 窄屏下课表页头按钮溢出。
  • 已发布方案可修改名称、总学分、说明、课程模块及课程配置。
    适用专业、入学年级、版本号保持锁定;前端禁用,后端也会返回 409 拒绝篡改。
    归档方案仍只读。
    修改已发布方案前增加即时生效警示和二次确认。
  • 课程库:保留并验证现有 Excel 导入,支持模板下载、按编码新增/更新、整批校验及事务回滚。
    授课资格:学院可直接选择本院教师、学期和课程并分配资格,服务端强制学院数据范围。[后端接口 (line 178)](/E:/jiaowu/src/Jiaowu.Api/Controllers/TeacherCourseApplicationsController.cs:178) · [页面 (line 151)](/E:/jiaowu/web/src/views/TeachingPreferencesView.vue:151)
    学生培养方案:新增“我的培养方案”,展示学分进度及已完成、在读、重修中、未通过、待完成、未修读课程,并支持搜索筛选。[学生接口 (line 15)](/E:/jiaowu/src/Jiaowu.Api/Controllers/StudentCurriculumController.cs:15) · [学生页面 (line 88)](/E:/jiaowu/web/src/views/StudentCurriculumView.vue:88)
  • 主要更新:
    班级课表支持年级、学院、专业、行政班分级筛选。
    管理员课表查询中心支持班级、教师、场地三种课表。
    超级管理员、校级教务、学院教务、领导可查询草稿和已发布版本;学院管理员保留学院数据范围。
    增加周视图、日视图切换。
    支持 Excel 导出和当前视图 PDF 导出。
    学生端增加“空闲教室”,支持学期、周次、星期、连续节次、校区、教学楼、容量筛选,并按教学楼分组、分页展示。
    空闲教室只依据正式课表计算;未配置节次表时自动提供默认节次。
  • 教学任务按 授课周数 × 周学时 = 课程总学时 双端校验,不匹配会显示具体差额并阻止保存;公共课批量生成同样校验。
    排课约束增加课程、教师、学院、授课方式、场地要求、约束状态筛选,并支持批量修改当前筛选结果。
    新增“非排时课程”授课方式:不进入自动排课
    不占星期、节次和教室
    不阻塞课表发布
    允许正常选课
    在班级课表和学生个人课表中单独展示