100 Commits

This Branch

This Branch

All Branches

• 班级查询按“考试场次”合并，显示为“分散至 N 个考场”，不再生成大量重复卡片。[后端实现 (line 416)](E:/jiaowu/src/Jiaowu.Api/Infrastructure/Timetables/TimetableDataService.cs:416)

  学生登录后只显示本人座位对应的考场，同时修复混排考场可能带出其他课程的问题。[筛选逻辑 (line 561)](E:/jiaowu/src/Jiaowu.Api/Infrastructure/Timetables/TimetableDataService.cs:561)
  多考场卡片提示学生登录查看本人考场及监考教师。[前端展示 (line 1122)](E:/jiaowu/web/src/views/TimetableView.vue:1122)
  教室课表、监考教师课表仍按具体考场显示，不受合并影响。
  已增加班级合并和学生精准考场回归测试。[测试 (line 183)](E:/jiaowu/tests/Jiaowu.Api.Tests/ExamArrangementServiceTests.cs:183)

  biss 2026-08-02 17:09:26 +08:00
  8cb9b4f57b
• 实验课现在直接进入普通排课流程，不再要求先到实验排课模块逐个安排。

  普通“添加排课”新增“理论课 / 实验课”类型。
  自动排课会分别补足理论学时和实验学时。
  实验课只能安排到实验室、实训室、机房、语音室等场地。
  发布课表时分别校验理论、实验学时；任一未排足都不能发布。
  普通课表及 Excel 导出会标注“实验课”。
  历史排课保持不变，迁移后默认识别为理论课；后续新建或修订版本时再补充实验课。

  biss 2026-08-02 16:54:41 +08:00
  f0f59419d5
• 支持为同一学期、同一课程的多个教学任务批量创建相同实验项目。

  新增批量排课表，可为多个实验项目分别设置日期、节次、实验室和容量。
  批量排课采用原子事务：任一项目发生教室、教师、班级或课表冲突，整批不写入。
  已发布项目批量新增场次时，继续按原逻辑通知学生。
  后端继续执行管理范围、教学任务状态、开放日期和容量校验。
  页面在 390px 手机宽度下无横向溢出。

  biss 2026-08-01 16:08:03 +08:00
  9d525826ce
• 超级管理员现在可在“组织与权限 → 运维与审计 → 系统性能”中直接查看：

  请求量、5xx 比例、HTTP/数据库 P95
  请求速率与延迟趋势
  最慢接口排行
  慢查询与数据库查询排行
  Grafana 原始调用链入口

  biss 2026-07-31 09:34:31 +08:00
  551f1143b7
• 接入 OpenTelemetry 1.17.0，覆盖 HTTP、HttpClient、.NET Runtime 和数据库链路。

  新增 EF Core 数据库拦截器，记录耗时、失败数、慢查询数、TraceId、查询标签和 SQL 哈希；默认不记录完整 SQL及参数。
  未配置 OTLP Collector 时不启动 SDK，避免无收益的性能开销。
  为课表的作息、课程、灵活课程、考试、实验等六类查询增加稳定标签。
  增加可配置的 500ms 慢查询阈值，以及生产环境变量示例。
  README 补充 MySQL 慢查询与 EXPLAIN ANALYZE 操作规范。

  biss 2026-07-31 08:24:27 +08:00
  ca7148ab61
• 课表查询中最明显的性能优化。

  将混合考场查询从“加载整个学期的考场、座位、教师、班级后在内存筛选”，改为在数据库中按班级、教师或教室直接筛选。
  改为窄字段投影，避免创建大量 EF 实体和关系对象。
  添加查询标签，便于后续在 MySQL 慢查询和链路追踪中定位。
  保留现有 HybridCache/可选 Redis 缓存体系，无需新增依赖或数据库迁移。
  增加教室、无关教室、监考教师三种回归场景。

  biss 2026-07-31 07:56:30 +08:00
  a369b4fe02
• 修复统计图
  biss 2026-07-29 11:50:15 +08:00
  7bcfa1a7a4
• 智能开屏：显示“姓名＋早上/中午/下午/晚上问候”，支持春节、端午、中秋、国庆等节日文案，可点击跳过：[SmartLaunchScreen.vue](E:/jiaowu/web/src/components/SmartLaunchScreen.vue)

  长按 App 图标：提供“我的课表、考试安排、课堂签到、消息中心”四个入口。签到会按学生/教师角色自动分流：[shortcuts.xml](E:/jiaowu/web/native/android/app/src/main/res/xml/shortcuts.xml)
  桌面小组件：新增“今日课表”和“近期考试”，展示最近同步的数据，点击可进入对应页面：[WidgetRenderer.java](E:/jiaowu/web/native/android/app/src/main/java/edu/mingxu/jiaowu/WidgetRenderer.java)
  安全处理：组件只缓存课程和考试摘要，不保存登录令牌；退出账号会清空组件，隔天未刷新时不会继续展示旧的“今日课表”。
  原生模板已纳入版本管理，每次 npm run cap:sync 会自动恢复到被忽略的 Android 工程：[configure-capacitor.mjs](E:/jiaowu/web/scripts/configure-capacitor.mjs)

  biss 2026-07-29 11:11:37 +08:00
  66622ca207
• APP热更新
  biss 2026-07-29 10:34:33 +08:00
  93997ea8b1
• 已改成“普通排课与实验学时分离”：

  普通课表学时 = 总学时 − 实践学时。
  自动排课、手工排课、课表发布都会阻止把实践学时重复排入。
  全部为实践学时的课程应设为“非排时课程”，再由实验管理安排。
  教学任务和排课页面会显示“常规 / 实践学时”。
  已有教学任务即使仍保存旧周学时，排课时也会按拆分后的课程学时计算。
  无需数据库迁移。

  biss 2026-07-29 09:57:49 +08:00
  692b521453
• 修复实验排课
  biss 2026-07-29 09:40:11 +08:00
  356c410788
• 已按“实验成绩独立管理”完成修改。

  每个实验项目独立建成绩单，支持评分项、参与状态、补做次数、安全违规、报告地址和教师评语。
  流程为：录入 → 学院审核 → 教务发布；学生只能查看已发布成绩。
  自主预约实验支持同步有效预约名单，已评分记录不会被误删。
  课程成绩可将已发布实验成绩汇总为快照导入指定分项；导入后锁定，不能手工篡改。
  实验项目成绩不完整时，对应课程分项保持空白，不按 0 分处理。
  一级“实验管理”菜单下增加“项目与场次”“实验成绩”；学生端增加“实验安排”“实验成绩”。
  已生成 MySQL 正式迁移及 SQLite 开发迁移，尚未操作生产数据库。
  界面采用“实验项目 → 独立评分 → 审核发布”工作台设计。

  biss 2026-07-28 22:21:18 +08:00
  8f56548b54
• 实验课表
  biss 2026-07-28 21:25:21 +08:00
  51c3b81e27
• 实验预约
  biss 2026-07-28 21:04:18 +08:00
  ec979f640d
• 修复课表
  biss 2026-07-28 20:08:12 +08:00
  865378dbdf
• update
  biss 2026-07-28 15:41:28 +08:00
  2dae303cf1
• 考试按实际日期、周次和节次融入周/日/总视图，并用橙色“考试”卡片区分。

  即使固定课表尚未发布，只要考试已发布，也能正常显示。
  考试计划、考场、监考教师和日期都会显示。
  Excel 导出同步包含考试安排。

  biss 2026-07-28 14:16:24 +08:00
  a61dacff1a
• app
  biss 2026-07-28 13:59:16 +08:00
  9a75589282
• 修复统计报表
  biss 2026-07-28 11:13:23 +08:00
  be842cc1d5
• 变更摘要：考试安排注入课表

  问题根因
  
    TimetableDataService.LoadExamEntriesAsync 只查询旧的 ExamSession（legacy 直接分配教室），完全忽略自动编排生成的
    ExamRoomAssignment（混排考场），导致：
  
    ┌──────────┬──────────────────────────┬───────────────────────────────────┐
    │ 课表类型 │           之前           │               之后                │
    ├──────────┼──────────────────────────┼───────────────────────────────────┤
    │ 教室课表 │ return [] 硬编码空数组   │ 查询 legacy + mixed room 两类数据 │
    ├──────────┼──────────────────────────┼───────────────────────────────────┤
    │ 教师课表 │ 只显示监考               │ 监考 + 自己授课的考试             │
    ├──────────┼──────────────────────────┼───────────────────────────────────┤
    │ 学生课表 │ 只通过 CourseEnrollments │ 同时查 ExamSeats（座位分配）      │
    ├──────────┼──────────────────────────┼───────────────────────────────────┤
    │ 空闲教室 │ 只排除 legacy 考试占用   │ 同时排除混排考场占用              │
    └──────────┴──────────────────────────┴───────────────────────────────────┘
  
    修改的文件
  
    1. TimetableDataService.cs — 重写 LoadExamEntriesAsync
  
    - 拆分为两个数据源：legacy ExamSessions + mixed ExamRoomAssignment（通过 ExamRoomSession 关联）
    - 新增 ApplyLegacyResourceFilter / ApplyMixedResourceFilter
    两个过滤方法，按资源类型（Classroom/Teacher/Student/Class）分别过滤
    - 新增 MapToEntryDto 统一映射到 TimetableEntryDto
    - 新增 ExamSessionProjection record 统一两个数据源的投影
  
    各资源类型的数据来源：
  
    ┌───────────┬────────────────────────────────┬──────────────────────────────────────┐
    │ 资源类型  │          Legacy 过滤           │           Mixed-room 过滤            │
    ├───────────┼────────────────────────────────┼──────────────────────────────────────┤
    │ Classroom │ ExamSessions.ClassroomId == id │ ExamRoom.ClassroomId == id           │
    ├───────────┼────────────────────────────────┼──────────────────────────────────────┤
    │ Teacher   │ 监考 + 授课教师                │ 监考 + 授课教师                      │
    ├───────────┼────────────────────────────────┼──────────────────────────────────────┤
    │ Student   │ CourseEnrollments + 行政班     │ ExamSeats.StudentId                  │
    ├───────────┼────────────────────────────────┼──────────────────────────────────────┤
    │ Class     │ TeachingTask.Classes           │ SessionLinks → ExamSession → Classes │
    └───────────┴────────────────────────────────┴──────────────────────────────────────┘
  
    2. ClassroomReservationAvailabilityService.cs — 补充混排考场占用
  
    在 GetOccupiedClassroomIdsAsync 新增 ExamRoomAssignment 查询，空闲教室查询现在会正确排除混排考场占用的教室。
  
    3. TimetablesController.cs — 课表选项含考试学期
  
    - 学期级的 HasPublishedTimetable 增加 ExamPlans.Status == Published 判断
    - 班级级的 HasPublishedTimetable 增加 ExamSessions 关联判断

  biss 2026-07-28 08:27:22 +08:00
  7e14b22296
• 参照现有的 ExamArrangementJob / SchedulePublishJob 后台任务模式，将发布改为通过 RabbitMQ

  队列异步执行，拆分查询消除笛卡尔积。
  
    修改的文件（共 13 个）
  
    ┌───────────────────────────────────────────────────────────────┬──────────────────────────────────────────────────┐
    │                             文件                              │                       变更                       │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Domain/Academic/ExamEntities.cs                               │ 新增 ExamPublishJob 实体 + ExamPublishJobStatus  │
    │                                                               │ / ExamPublishJobKind 枚举                        │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Domain/System/BackgroundJobOutboxMessage.cs                   │ BackgroundJobKind 新增 ExamPublish = 6           │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Infrastructure/BackgroundJobs/BackgroundJobOptions.cs         │ 新增 ExamPublishConcurrency 配置项               │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Infrastructure/BackgroundJobs/BackgroundJobRunner.cs          │ RunAsync 和 MarkJobRetryLimitExceeded 添加       │
    │                                                               │ ExamPublish 分支                                 │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Infrastructure/BackgroundJobs/RabbitMqBackgroundJobs.cs       │ JobKinds 数组和 RoutingKey 添加 ExamPublish →    │
    │                                                               │ "exam.publish"                                   │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Infrastructure/BackgroundJobs/BackgroundJobOutboxPublisher.cs │ 启动恢复逻辑添加 ExamPublishJobs                 │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Infrastructure/Persistence/AppDbContext.cs                    │ 新增 ExamPublishJobs DbSet                       │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Controllers/OperationsController.cs                           │ CountFailedJobsAsync / GetFailedJobs             │
    │                                                               │ 添加考试发布失败统计和筛选                       │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Program.cs                                                    │ 校验 ExamPublishConcurrency + 注册               │
    │                                                               │ ExamPublishJobProcessor                          │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Infrastructure/Exams/ExamPublishJobs.cs                       │ 新文件 —                                         │
    │                                                               │ ExamPublishJobProcessor，拆分查询校验后发布      │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Controllers/ExamsController.cs                                │ Publish 改为创建后台任务 + 202 返回；新增 GET    │
    │                                                               │ publish-jobs/{id} / GET plans/{id}/publish-job   │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ Controllers/MakeupExamsController.cs                          │ 同上改造                                         │
    ├───────────────────────────────────────────────────────────────┼──────────────────────────────────────────────────┤
    │ tests/.../TeachingWorkflowRosterTests.cs                      │ 更新测试适配新的异步发布模式                     │
    └───────────────────────────────────────────────────────────────┴──────────────────────────────────────────────────┘
  
    笛卡尔积消除
  
    之前：一个 Include 链拉全部 → EF Core 生成 Sessions × Invigilators × RoomLinks × Seats 笛卡尔积
  
    之后：
    - 场次计数：db.ExamSessions.CountAsync（无 JOIN）
    - 场次摘要：Select new { Id, ClassroomId, InvigilatorCount, RoomLinkCount }（只查所需列）
    - 容量超限：db.ExamRooms.Select(r => new { SeatCount = r.Seats.Count, Capacity })（单表 JOIN）
    - 课程冲突：db.ExamRoomSessions.Where(link => ...CourseId != link.ExamRoom!.CourseId)（独立查询）
    - 每个查询只做自己需要的 JOIN，互不干扰
  
    测试结果
  
    213 通过，0 失败，0 跳过
  
    配置方式
  
    - BackgroundJobs__Transport=RabbitMq → 走 RabbitMQ 队列 jiaowu.background-jobs.exam.publish
    - BackgroundJobs__Transport=InMemory（默认） → 走内存 Channel
    - BackgroundJobs__ExamPublishConcurrency=1（默认，可调 1-16）

  biss 2026-07-28 08:10:22 +08:00
  3ec0f117d3
• 取消笛卡尔积运算
  biss 2026-07-27 22:23:08 +08:00
  b2de605680
• 1. 教室容量按 1/2 计算

  - ExamArrangementService.cs: SelectRooms() 使用 Capacity / 2 选择房间、计算剩余座位和总容量
    - MakeupExamArrangementService.cs: 数据库查询用 x.Capacity >= enrolledCount * 2（等价于 Capacity/2 >=
    enrolledCount），消息显示有效座位数
  
    2. 教学楼限制多选
  
    - Domain: ExamSession 和 MakeupExamSession 新增 RequiredBuildingIds (JSON string)，保留旧 RequiredBuildingId 向后兼容
    - Service: RoomGroupKey 改为字符串键确保值相等；GroupKey() 合并新旧字段
    - Controller: 请求 DTO 增加 RequiredBuildingIds (Guid 数组)，响应包含该字段
    - DB: MySQL 迁移 + SQLite migrator 添加新列
    - Frontend: <el-select> 改为 multiple，新增 parseBuildingIds() 解析服务器返回的 JSON
  
    3. 导出签名单后台任务
  
    - 新增: ExamSignInExportJob 实体、ExamSignInExportJobProcessor、ExamSignInExportJobStatus 枚举
    - BackgroundJobKind: 新增 ExamSignInExport = 5
    - RabbitMQ: routing key exam.sign-in-export，队列 jiaowu.background-jobs.exam.sign-in-export
    - API: POST /sign-in-export 创建任务返回 202；GET /sign-in-exports/{jobId} 查询状态；GET
    /sign-in-exports/{jobId}/download 下载文件
    - Frontend: 导出改为异步任务 + 轮询 + 自动下载，显示进度条
    - 恢复: OutboxPublisher 启动时恢复未完成的任务，重试超限自动标记失败

  biss 2026-07-27 22:00:35 +08:00
  52e4a8a5be
• 自动编排接口现在立即返回 202 + jobId，不会再等待 15 秒导致 Axios 超时。

  任务参数、状态和结果持久化到 MySQL。
  接入现有 outbox；配置 BackgroundJobs__Transport=RabbitMq 时使用 RabbitMQ 队列 exam.arrangement，否则使用 InMemory worker。
  服务重启后可恢复未完成任务。
  前端显示排队/执行/完成/失败状态，刷新页面可恢复正在执行的任务。
  编排期间禁止修改、删除或发布对应计划。
  补考原有“一键生成”保留，并与编排任务互斥。
  运维后台增加“考试与补考编排”失败任务筛选。

  biss 2026-07-27 21:40:14 +08:00
  9e0d4062a4
• 自动排考
  biss 2026-07-27 21:27:00 +08:00
  9d9f54a3b0
• 优化考试排考
  biss 2026-07-27 19:31:19 +08:00
  c3e8a42641
• 草稿计划支持选择场次后“批量移除已选场次”，一次最多 100 个。

  批量操作会完整校验：包含不存在、其他计划或已发布计划的场次时整批拒绝，不会部分删除。[ExamsController.cs (line 384)](E:/jiaowu/src/Jiaowu.Api/Controllers/ExamsController.cs:384)
  草稿计划新增“删除草稿”按钮，删除前显示计划名称及场次数量确认。[ExamsView.vue (line 292)](E:/jiaowu/web/src/views/ExamsView.vue:292)
  删除草稿计划会级联清理场次和监考关联；已发布计划不能删除。[ExamsController.cs (line 81)](E:/jiaowu/src/Jiaowu.Api/Controllers/ExamsController.cs:81)
  删除后会自动切换到其他计划；没有剩余计划时正确显示空状态。
  新增草稿、已发布、跨计划混选及级联删除测试。[ExamDeletionControllerTests.cs (line 17)](E:/jiaowu/tests/Jiaowu.Api.Tests/ExamDeletionControllerTests.cs:17)

  biss 2026-07-27 18:31:52 +08:00
  64decdab7e
• 已修改完成，同时解决了“考生名单都是 0 人”的根因。

  考生范围统一为“行政班关联学生 + 已选课学生”，并自动去重；考场分配、人数显示、冲突检测、学生考试安排均使用同一口径。[TeachingTaskRosterQuery.cs (line 40)](E:/jiaowu/src/Jiaowu.Api/Infrastructure/Teaching/TeachingTaskRosterQuery.cs:40)
  新增考场签名单 Excel 导出接口。[ExamsController.cs (line 568)](E:/jiaowu/src/Jiaowu.Api/Controllers/ExamsController.cs:568)
  考试计划页面新增“导出考场签名单”按钮。[ExamsView.vue (line 255)](E:/jiaowu/web/src/views/ExamsView.vue:255)
  工作簿包含“考场汇总”以及每个考试场次独立的 A4 签到表，字段包括座位号、学号、姓名、行政班、考生签名和备注。[ExamSignInWorkbookExporter.cs (line 12)](E:/jiaowu/src/Jiaowu.Api/Infrastructure/Exams/ExamSignInWorkbookExporter.cs:12)
  未分配考场或监考教师时，也能导出并显示“待分配”。

  biss 2026-07-27 18:24:32 +08:00
  fb2acc6751
• 修复MySQL问题
  biss 2026-07-27 17:27:17 +08:00
  2e422acd19
• v2.0.0
  biss 2026-07-27 17:12:03 +08:00
  514689c7e8
• “教务总览”改成可实际工作的分级工作台：

  校级管理员查看全校数据，学院管理员仅查看本学院数据。
  待办按当前审批阶段统计，涵盖授课资格、成绩、调停课、学籍异动、教室借用等。
  增加学期进度、教学任务发布、课表覆盖、成绩发布状态。
  快捷入口根据管理员角色自动调整。
  完善未配置学期、无待办、加载失败等状态。
  适配桌面和 390px 移动端，无横向溢出。

  biss 2026-07-27 17:11:51 +08:00
  2d1e2cb697
• 修复考试安排
  biss 2026-07-27 16:47:55 +08:00
  b8df564b85
• “运维与审计控制台”。

  主要能力：
  SuperAdmin 专用入口：组织与权限 → 运维与审计。
  操作日志分页查询，支持时间、账号、路径、方法和状态码筛选。
  汇总自动排课、课表发布、补考安排三类失败后台任务。
  实时检查数据库、缓存、任务通道及积压状态。
  聚合 5xx、失败/重试任务、健康探针和备份时效告警。
  SQLite 在线备份；MySQL 调用原生客户端备份。
  SHA-256 校验及隔离数据库恢复演练，不覆盖业务库。
  MySQL 强制使用独立运维连接，容器增加持久化备份卷与数据库客户端。

  biss 2026-07-27 16:37:45 +08:00
  4d8de1e4ae
• 消息修复
  biss 2026-07-27 16:06:02 +08:00
  14ac49115c
• 发信改为事务内每 300 人分批写入，避免全校群发一次插入过大；数据库异常现在返回明确的 503，不再只显示模糊 500。

  校级、学院级管理员支持按学院、身份、行政班、教学班、姓名/学号/工号筛选，也可指定最多 500 名收件人。所有结果均由服务端重新校验权限。
  接入 CKEditor 5，支持标题、列表、引用和链接；正文扩展为 MySQL longtext。
  富文本在收件箱、详情弹窗和已发送记录中统一经 DOMPurify 净化后展示。
  页面改用系统现有的冷白、靛蓝、青绿色令牌，新增“选择收件人 → 编辑内容”工作台和移动端适配。

  biss 2026-07-27 12:53:10 +08:00
  06d40a7bf1
• 预演
  biss 2026-07-27 12:20:29 +08:00
  33ae991e86
• 排课
  biss 2026-07-27 09:55:22 +08:00
  727a429abf
• 调课
  biss 2026-07-27 08:59:02 +08:00
  2f5c6af37c
• 点名、成绩册统一读取“行政班在籍学生 ∪ 已选课学生”，不再错误显示 0 人。

  教师选课名单改为展示全部本人教学班及完整学生名单，支持 Excel 导出。
  调停课改用教师专用教学班接口，并在服务端限制只能操作本人教学班。

  biss 2026-07-27 08:05:42 +08:00
  22321abe23
• 优化
  biss 2026-07-26 22:16:58 +08:00
  bc6ffa2ada
• 学生视图
  biss 2026-07-26 21:53:00 +08:00
  dd1b752fa3
• 给统计缓存加版本并绑定现有基础数据/课表失效标签，同时让演示数据、人员数据写入主动清理统计缓存；不改统计口径、筛选、导出或页面结构。
  biss 2026-07-26 21:32:51 +08:00
  b39a57ebdf
• 第二阶段优化已完成，重点是提高后台任务吞吐并降低 Outbox 数据库开销。

  RabbitMQ 默认从单一回调通道提升为三类任务独立并行，跨类型并发能力由 1 提升到 3；每类还能独立配置 1–16 个消费者。[RabbitMqBackgroundJobs.cs (line 143)](E:/jiaowu/src/Jiaowu.Api/Infrastructure/BackgroundJobs/RabbitMqBackgroundJobs.cs:143)
  InMemory 开发模式同步改为按任务类型隔离队列，避免某类长任务堵塞其他任务。
  租约恢复检查从“每发布一条执行一次”改为默认每 60 秒维护一次。
  启动恢复改为数据库 NOT EXISTS 查询，不再把全部历史 Outbox 加载进内存。[BackgroundJobOutboxPublisher.cs (line 9)](E:/jiaowu/src/Jiaowu.Api/Infrastructure/BackgroundJobs/BackgroundJobOutboxPublisher.cs:9)
  完成消息默认保留 14 天，之后按每批 500 条清理，并增加对应组合索引。
  /health/messaging 现在返回各状态积压量、过期租约和最老任务等待时间。[BackgroundJobMonitoringService.cs (line 16)](E:/jiaowu/src/Jiaowu.Api/Infrastructure/BackgroundJobs/BackgroundJobMonitoringService.cs:16)
  新增 Jiaowu.BackgroundJobs 运行时指标，覆盖发布量、处理量、发布耗时、处理耗时和清理量。[BackgroundJobTelemetry.cs (line 9)](E:/jiaowu/src/Jiaowu.Api/Infrastructure/BackgroundJobs/BackgroundJobTelemetry.cs:9)
  配置、Compose 和调优建议已更新。[README.md (line 257)](E:/jiaowu/README.md:257)

  biss 2026-07-26 21:05:18 +08:00
  034f1eacb8
• 排课计算、课表发布、补考自动编排三类任务统一接入消息系统。

  业务任务与 Outbox 消息同一事务落库，避免“数据库成功但消息没发出去”。
  RabbitMQ 使用持久化消息、发布确认、手动 ACK、Quorum Queue、死信队列。
  增加处理租约、心跳、异常重试、最大重试次数和幂等状态控制。
  保留 InMemory 模式，开发环境无需安装 RabbitMQ。
  支持多实例竞争消费，后续可以横向扩容。
  新增 /health/messaging 消息系统健康检查。

  biss 2026-07-26 20:51:42 +08:00
  6300645120
• 教室预约
  biss 2026-07-26 20:11:56 +08:00
  9f534c22f4
• 成绩通知：仅在某门课程成绩正式发布后自动发送，按成绩单学生名单通知，不展示具体分数；发布状态与通知同一次提交。

  手动发信：移除“成绩通知”选项，只能发送普通通知，原有角色与范围权限保持不变。
  选课通知：管理员关闭一轮选课时，自动向每位参与学生发送一条汇总通知，包含最终选中课程及候补未成功课程；候补失效、轮次关闭和通知生成保持原子性。
  关闭选课界面会明确提示发送通知，并显示实际通知人数。

  biss 2026-07-26 19:12:42 +08:00
  b0679a253d
• 学生可在“学籍管理 → 电子成绩单与证明”申请成绩单或学籍证明。

  服务端根据登录账号绑定本人档案，不接受学生 ID，无法代他人申请。
  成绩单仅包含正式发布成绩；无已发布成绩时明确提示。
  同类型、同用途 5 分钟内重复申请复用已有有效凭证。
  申请后即时生成 PDF，可在本人凭证列表下载、二维码验真。
  管理员的下载记录、失效、重签能力保持不变。

  biss 2026-07-26 18:24:53 +08:00
  ecc6546f3a
• 已完善个人教学日历订阅。

  主要能力：
  教师、学生可在“我的课表”启用订阅、复制 URL、唤起日历客户端或下载一次性 ICS。
  自动覆盖固定课程、调停课后的最新安排、考试/监考、补考，以及灵活课程提醒。
  采用独立随机订阅标识和 HMAC 签名；重置或停用后旧地址立即失效。
  支持 ETag 条件请求和一小时刷新提示，减少日历客户端重复同步。
  订阅地址按实际前端 API 地址生成，兼容独立部署域名。
  已增加窄屏弹窗最大宽度和纵向操作布局。

  biss 2026-07-26 17:22:58 +08:00
  40b8cb6e3c
• 将索引缩短为 IX_CE_Offering_Status_WaitlistedAt。

  将候补迁移改为可重入：先检查列和索引是否存在，再执行 DDL。
  附件中已经成功添加 WaitlistedAt、但索引创建失败的数据库可直接重试，不会报重复列。
  运行时和 dotnet ef 连接统一开启 AllowUserVariables；Connector/NET 默认关闭该选项。Connector/NET 官方说明
  增加所有 MySQL 索引名不得超过 64 字符的回归测试。

  biss 2026-07-26 16:24:52 +08:00
  ec28eb6c16
• 已把选课的“年级划分”和限制规则补成完整闭环：

  选课批次可指定多个适用年级；留空兼容原有“全部年级”。
  新增可选的“最多课程门数”，与原有学分上限并行。
  年级、门数限制统一作用于学生可见批次、自主选课、候补、管理员代选和自动递补。
  普通候选名单遵守年级及行政班范围；强制选课可绕过业务限制，但仍严格遵守管理员学院权限。
  管理页面会展示“2026 级 · 最多 6 门 · 最多 30 学分”，名单和候补列表也增加年级列。
  新增 MySQL 迁移：[CourseSelectionGradeLimits.cs](E:/jiaowu/src/Jiaowu.Api/Infrastructure/Persistence/Migrations/MySql/20260726180000_CourseSelectionGradeLimits.cs)。

  biss 2026-07-26 16:12:21 +08:00
  f62cd21319
• 已完成“选课候补与自动递补”完整流程。

  学生端：满员后可加入/取消候补，展示候补顺位和当前候补人数。
  自动递补：退课释放名额后，按候补时间顺序重新校验学籍、范围、学分及时间冲突；不合格者自动失效并继续下一位。
  管理端：教学班显示候补人数，名单抽屉提供候补队列及移出操作。
  状态通知：递补成功、资格失效、批次关闭、管理员移出均会通知学生。
  并发安全：退课和递补放在 Serializable 事务中执行。
  数据库：已补充 SQLite 开发迁移和 MySQL 正式迁移。

  biss 2026-07-26 15:39:50 +08:00
  56b13b3adb
• v1.2.0
  biss 2026-07-26 15:18:57 +08:00
  65eed820a7
• 仪表盘和 6 类统计摘要接入 HybridCache（内存 + Redis）。

  默认 Redis 缓存 3 分钟、本地缓存 30 秒，可通过环境变量调整。
  缓存键包含数据权限范围、有效学院和全部筛选条件，避免跨学院串数据。
  Excel 导出保持实时查询，不使用摘要缓存。
  无需数据库迁移。

  biss 2026-07-26 15:13:22 +08:00
  631c81821d
• 主要变更：

  新增统一缓存封装：[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) 部署说明。

  biss 2026-07-26 14:42:27 +08:00
  77dfa8145c
• 免修、缓考现在包含当前学期课程，以及未归档且课表已发布的实际修读课程。

  实际开发库验证已返回 CS101 程序设计基础。
  课程替代改为“修读中/未通过课程 → 已发布及格课程”的双栏选择。
  新增搜索、教学班号、学期、教师、学分、课表状态和完整空状态说明。
  新增课程替代申请记录。
  提交接口增加服务端资格校验，不能伪造课程 ID 绕过前端。

  biss 2026-07-26 14:12:52 +08:00
  0970c7cd40
• 修复500

  TimeOnly ↔ TimeSpan

  biss 2026-07-26 12:56:59 +08:00
  32eb723c02
• v1.1.0
  biss 2026-07-26 11:21:29 +08:00
  0c3745d91a
• 学年学期页面新增“设为当前”“归档”“撤销归档”，当前学期不能归档、删除或直接取消；已归档学期需先撤销才能重新设为当前。[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)

  biss 2026-07-26 11:14:05 +08:00
  c91d826169
• 已完成，学生端考勤记录现在按课程展示。

  每门课程会独立显示：
  课程名称、代码、教学班和任课教师。
  课程总体出勤率。
  出勤、迟到、缺勤、请假、免修次数。
  按日期排列的历次点名记录。
  缺勤或迟到记录仍可单独申诉。

  biss 2026-07-26 10:49:06 +08:00
  3b73292d93
• 修复Mysql
  biss 2026-07-26 10:19:46 +08:00
  72297aa23f
• 登录
  biss 2026-07-26 08:53:55 +08:00
  634ef69a27
• 修复数据
  biss 2026-07-25 22:14:40 +08:00
  aafc8c537e
• ge

  xiufu

  biss 2026-07-25 21:49:56 +08:00
  d42ec74822
• 更改docker
  biss 2026-07-25 21:26:49 +08:00
  eb13465b49
• docker更新
  biss 2026-07-25 21:21:25 +08:00
  2e940f7f30
• 自动构建
  biss 2026-07-25 21:15:32 +08:00
  1595d6f0c0
• 新增显式命令：--seed-demo-data --confirm-production-demo-data

  仅允许非 Development 环境运行。
  只允许写入没有业务数据的独立空库。
  演示数据使用单个 InnoDB 事务，失败整体回滚；迁移 DDL 仍单独执行，因为 MySQL 8.4 的 DDL 会隐式提交。MySQL 事务文档、隐式提交说明
  不包含通用测试密码或学生、教师登录账号。
  包含校区、学期、30 间教室、16 个学院、52 个专业、104 个班级、128 名教师、3,640 名学生和148门课程。

  biss 2026-07-25 20:58:51 +08:00
  2ac873c347
• 新增“课程统计”模式，展示总体出勤率、状态分布、历次趋势和每位学生的出勤明细。

  支持按姓名/学号、行政班及异常情况筛选，默认优先显示低出勤率学生。
  新增课程统计 Excel 导出，包含课程概览、学生出勤明细、历次点名趋势三个工作表。
  统计仅使用已提交点名；出勤和迟到计为到课，免修不计入应到次数。
  修复了枚举兼容问题，已提交点名不会再错误显示为“草稿”，考勤状态中文标签恢复正常。
  统计与导出接口均执行教师/数据范围权限校验。

  biss 2026-07-25 20:47:56 +08:00
  08b81eec42
• 更新
  biss 2026-07-25 20:31:19 +08:00
  d8696ae80b
• 生产环境
  biss 2026-07-25 20:21:42 +08:00
  a576cc815d
• 补考增强
  biss 2026-07-25 19:38:39 +08:00
  1da6543a38
• 补考系统
  biss 2026-07-25 19:16:11 +08:00
  44e90ae35f
• 评教系统
  biss 2026-07-25 18:41:53 +08:00
  376bc0d0a1
• ---

  成绩册 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

  biss 2026-07-25 17:57:56 +08:00
  15a34a306c
• 统计报表
  biss 2026-07-25 17:48:53 +08:00
  97691cb203
• 学业预警自动化
  biss 2026-07-25 17:28:53 +08:00
  3d4d9953e8
• 全部完成。定时检测系统概览：

  新增组件
  
    ┌────────────────────────────────┬─────────────────────────────────────────────────────────┐
    │              组件              │                          说明                           │
    ├────────────────────────────────┼─────────────────────────────────────────────────────────┤
    │ WarningSchedule 实体           │ 定时配置：学期、星期几、时、分、启用/禁用、上次执行时间 │
    ├────────────────────────────────┼─────────────────────────────────────────────────────────┤
    │ WarningCheckWorker             │ BackgroundService，每分钟轮询一次，匹配到时间就执行检测 │
    ├────────────────────────────────┼─────────────────────────────────────────────────────────┤
    │ GET/PUT /api/warnings/schedule │ 读取/保存定时配置                                       │
    └────────────────────────────────┴─────────────────────────────────────────────────────────┘
  
    页面配置
  
    在学业预警页面顶部新增「定时检测」区域：
    - 启用开关：一键开/关自动检测
    - 星期选择：周一至周日
    - 时分选择：精确到分钟
    - 上次执行时间：自动显示
  
    工作流程
  
    每分钟 Worker 轮询
      → 查询 WarningSchedules 表，匹配当前星期+时+分
      → 检查是否已在本分钟执行过（防止重复）
      → 加载该学期全部启用规则 + 在籍学生
      → 逐条规则、逐个学生检测
      → 已存在的同型预警跳过，新预警写入 + 通知学生/辅导员
      → 更新 LastRunAt
  
    管理员配置"每周一 08:00 自动检测"，系统就会在每周一早上 8 点整自动执行一次完整的学业预警检测。

  biss 2026-07-25 17:17:05 +08:00
  d23b5156b4
• 学业预警
  biss 2026-07-25 17:14:20 +08:00
  db3a275601
• 各类申请
  biss 2026-07-25 16:51:12 +08:00
  5e4c76a9e4
• 教学点名强化
  biss 2026-07-25 16:16:23 +08:00
  d02b0c56a1
• 统一通知中心
  biss 2026-07-25 15:50:00 +08:00
  2c6103d3ae
• 调课、停课、补课申请
  biss 2026-07-25 15:36:14 +08:00
  13b61f191a
• 选课
  biss 2026-07-25 15:30:46 +08:00
  9685435da9
• 考试排考
  biss 2026-07-25 14:51:17 +08:00
  4e7da6709e
• 成绩+点名
  biss 2026-07-25 14:08:50 +08:00
  36049af692
• deepseek

  前台 — 路由 (router/index.ts)
  
    - my-timetable 路由的角色从 ['Student'] 扩展为 ['Student', 'Teacher']
    - 新增 teacher-timetable/:teacherId 路由，用于查看指定教师的课表
  
    前台 — 课表视图 (TimetableView.vue)
  
    - 新增 isTeacherView 和 isTeacher 计算属性，区分教师个人课表和查看他人课表
    - 教师个人课表：标题显示"我的授课课表"，描述改为"展示本人本学期所有授课安排"
    - 查看他人课表：标题显示"教师课表"
    - 两种模式均隐藏资源筛选面板，只保留学期选择
    - 加载逻辑适配教师模式 API
  
    前台 — 教师档案页 (PersonnelView.vue)
  
    - 教师行操作列新增 "课表" 按钮（带日历图标），仅在职教师可点击
    - 点击后跳转到该教师的授课课表页面
  
    前台 — 侧边导航 (AdminLayout.vue)
  
    - 教师角色可见"我的授课课表"菜单项，与学生的"我的课表"并列

  biss 2026-07-25 13:21:06 +08:00
  7800951aee
• deepseek

  2 处改动：
  
    1. ValidateRequestAsync — 当 classIds 为空时跳过行政班验证（选修课可不选班）
    2. ValidatePublishingTasksAsync — 移除了"发布前至少需要关联一个行政班"的强制校验，允许无行政班的教学任务直接发布

  biss 2026-07-25 13:10:19 +08:00
  a081273ac6
• 已改成后台“检查并发布”任务，原来的超时主要就是同步逐条校验导致的。

  发布接口立即返回 202 Accepted，页面轮询显示检查进度。
  校验改为批量读取，减少重复数据库查询。
  检查失败保留草稿并显示具体原因；成功后原子完成旧课表归档和新课表发布。
  同一学期禁止两个发布任务并发，服务重启后未完成任务会自动恢复。
  发布期间锁定编辑、自动排课等冲突操作。
  已补齐 SQLite 开发迁移及 MySQL 生产迁移。

  biss 2026-07-25 12:07:03 +08:00
  b015514115
• 选课
  biss 2026-07-25 11:46:39 +08:00
  fdca6a3edf
• 自动排课
  biss 2026-07-25 11:32:13 +08:00
  533ff6b9f6
• 已完成教学任务归档纠错功能：

  已归档任务新增“撤销归档”和“删除”，支持单条及批量操作。
  撤销后恢复为“已发布”状态。
  已发布任务仍不可直接删除；被排课、选课、成绩或考试引用的归档任务也会拒绝删除并明确提示。
  状态与操作文案统一为“归档”

  biss 2026-07-25 11:03:42 +08:00
  a63c943815
• 自动排课完成后逐条显示“需人工处理”的任务和原因，并提供“检查排课约束”入口；刷新页面后仍可读取最近一次结果。

  批量排课约束新增校区、教学楼、多教室统一指定，也支持清除原有限定。
  课表新增“总视图”，同一时段、不同周次课程会并列显示。
  周视图按教学周过滤，支持上一周、下一周、周次下拉和回到本周。
  日视图按周次过滤；连续两节课程会跨两行完整占格。

  biss 2026-07-25 10:55:09 +08:00
  e4a12931ea
• 教师档案增加“激活账号”：管理员设置初始密码，服务端校验管理权限、学院数据范围、在职状态、工号冲突，并自动关联教师角色与档案。

  已发布课表增加“发布后修改”：创建修订草稿，旧课表继续生效；修订版重新发布后再替换旧版本。
  修复 390px 窄屏下课表页头按钮溢出。

  biss 2026-07-25 10:09:05 +08:00
  db91988264
• 已发布方案可修改名称、总学分、说明、课程模块及课程配置。

  适用专业、入学年级、版本号保持锁定；前端禁用，后端也会返回 409 拒绝篡改。
  归档方案仍只读。
  修改已发布方案前增加即时生效警示和二次确认。

  biss 2026-07-25 09:42:09 +08:00
  ce65fe82d9
• 课程库：保留并验证现有 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)

  biss 2026-07-25 09:23:10 +08:00
  9a3afa3df5
• 主要更新：

  班级课表支持年级、学院、专业、行政班分级筛选。
  管理员课表查询中心支持班级、教师、场地三种课表。
  超级管理员、校级教务、学院教务、领导可查询草稿和已发布版本；学院管理员保留学院数据范围。
  增加周视图、日视图切换。
  支持 Excel 导出和当前视图 PDF 导出。
  学生端增加“空闲教室”，支持学期、周次、星期、连续节次、校区、教学楼、容量筛选，并按教学楼分组、分页展示。
  空闲教室只依据正式课表计算；未配置节次表时自动提供默认节次。

  biss 2026-07-25 08:53:42 +08:00
  0d34936d38
• 教学任务按 授课周数 × 周学时 = 课程总学时 双端校验，不匹配会显示具体差额并阻止保存；公共课批量生成同样校验。

  排课约束增加课程、教师、学院、授课方式、场地要求、约束状态筛选，并支持批量修改当前筛选结果。
  新增“非排时课程”授课方式：不进入自动排课
  不占星期、节次和教室
  不阻塞课表发布
  允许正常选课
  在班级课表和学生个人课表中单独展示

  biss 2026-07-25 08:18:25 +08:00
  fe508054d0
• 取消新增/Excel 导入档案时自动创建账号。

  取消修改人员档案时同步登录账号。
  Excel 人员模板恢复为不含“初始密码”。
  登录页新增“学生首次登录？自助激活账号”入口。
  公开激活地址：http://127.0.0.1:5255/activate

  biss 2026-07-25 07:55:49 +08:00
  30c15f89e5
• 升级
  biss 2026-07-24 22:18:32 +08:00
  27c3944c28
• 主要改动：

  自动排课接口立即返回 202 + jobId
  后台服务独立执行，不受浏览器关闭或前端超时影响
  进度、成功、失败状态持久化到数据库
  服务重启后自动恢复排队中或中断的任务
  同一草稿禁止重复提交后台任务
  运行期间禁止编辑、发布或删除该课表
  排课结果和任务成功状态在同一事务中提交
  前端每秒轮询进度，显示已处理教学班和已规划安排数

  biss 2026-07-24 21:55:07 +08:00
  d67a07f23e