biss/Academic-Affairs-System
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 8 Wiki Activity
89 Commits 1 Branch 8 Tags
14ac49115c31522fc8143cf4c5926918a84735a7
Commit Graph
57 Commits
  • 消息修复
    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
    Build and publish Jiaowu packages and container image / Test, package and publish (push) Successful in 32m28s
    Details
    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: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
  • 仪表盘和 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
    Build and publish Jiaowu packages and container image / Test, package and publish (push) Successful in 27m29s
    Details
    0970c7cd40
  • 修复500 
    TimeOnly ↔ TimeSpan
    biss 2026-07-26 12:56:59 +08:00
    32eb723c02
  • 学年学期页面新增“设为当前”“归档”“撤销归档”，当前学期不能归档、删除或直接取消；已归档学期需先撤销才能重新设为当前。[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
  • 自动构建
    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:21:42 +08:00
    a576cc815d
  • 已改成后台“检查并发布”任务，原来的超时主要就是同步逐条校验导致的。 
    发布接口立即返回 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
  • 主要改动： 
    自动排课接口立即返回 202 + jobId
后台服务独立执行，不受浏览器关闭或前端超时影响
进度、成功、失败状态持久化到数据库
服务重启后自动恢复排队中或中断的任务
同一草稿禁止重复提交后台任务
运行期间禁止编辑、发布或删除该课表
排课结果和任务成功状态在同一事务中提交
前端每秒轮询进度，显示已处理教学班和已规划安排数
    biss 2026-07-24 21:55:07 +08:00
    d67a07f23e
  • 选课
    biss 2026-07-24 20:37:42 +08:00
    20ca205080
  • 已完成“专业课教学任务下放学院管理”。 
    专业必修、专业选修、实践课程：由课程所属学院创建、修改、删除、发布和关闭。
公共必修、公共选修：仍由校级教务管理。
校级教务可以查看全校专业课任务，但不能代替学院维护。
超级管理员保留跨学院纠错权限。
教师分配统一要求：教师已申报该课程，并通过学院审核。
兼岗账号同时拥有校级公共课和本学院专业课职责。
    biss 2026-07-24 19:43:24 +08:00
    5da1a8a403
  • 优化排课
    biss 2026-07-24 19:35:49 +08:00
    e6d8eb0662
  • 自动排课：保留手工安排，按教师、行政班、周次、节次、容量和场地约束补排。 
    课程约束：可限定校区、教学楼、指定教室、允许上课日、最早/最晚节次。
无教室课程：教室可为空，但仍校验教师和班级冲突。
作息维护：按学期维护节次、上下课时间和启用状态。
发布保护：发布前重新检查全部约束，并阻止学时未排满的课表发布。
工作台升级：增加“排课规则与作息”“自动排课”入口，自动生成后仍支持手工微调。
同时兼容 SQLite 和 MySQL，已生成正式迁移。
    biss 2026-07-24 19:19:18 +08:00
    6538b6080a
  • 课程库 Excel 导入导出已完成： 
    支持下载标准导入模板。
导出严格沿用当前关键词、学院、分类、课程性质和状态筛选。
以课程编码为唯一键：存在则更新，不存在则新增。
校验学院编码、课程分类、课程性质、学分学时及考核方式。
整批原子导入，任一行错误则全部不写入，并提示具体行号。
学院管理员仍只能维护本学院的专业课和实践课，无法借 Excel 越权。
界面入口沿用现有课程库工具栏样式。
    biss 2026-07-24 18:56:25 +08:00
    d7cf3f9e76
  • 培养方案下放学院维护，学院账号被后端限制在本学院范围；新增按年级、学院、专业联动筛选及维护范围提示。 
    课程库实行分级维护：学院只能维护本学院的专业必修、专业选修和实践课程；通识课程可查看、引用但不可修改。校级账号保留全校统筹权限。
“排课与课表”已从“教学建设”迁移到“教学运行”，原路由保持不变。
权限规则同时落实在前端和 API，并新增专项测试。
    biss 2026-07-24 18:31:33 +08:00
    5a7a8d530b
  • 已完成“组织与权限”优化： 
    基础数据拆分为：组织机构、学年学期、教学场所。
人员档案拆分为：教师档案、学生档案。
基础数据、教师、学生、用户权限均支持 Excel 模板下载、批量导入和导出。
导入按编码/工号/学号/账号新增或更新；整批校验，失败不写入，限制 2000 条、10 MB。
用户列表新增密码重置，包含双重确认、最低 8 位校验和服务端权限保护。
导入严格执行角色及学院数据范围校验，并保护当前超级管理员账号。
保留旧地址重定向，原有入口不会失效。
    biss 2026-07-24 18:12:56 +08:00
    022e79c48d
  • 学籍异动：休学、复学、退学申请及辅导员→学院→教务处分级审批。 
    毕业审核：批次计算、缺失课程检查、人工复核、结果发布。
学位授予：毕业资格与 GPA 计算、人工调整、发布授予结果。
毕业离校：离校事项配置、责任角色分工、逐项办理及批次关闭。
    biss 2026-07-24 17:30:05 +08:00
    b0eaa20da6
  • 已完成“考试安排与考场管理”模块： 
    考试计划草稿、场次配置与正式发布。
教学班、考试时间、考场、监考教师关联。
自动校验考场容量。
阻止考场、监考教师和学生考试时间冲突。
管理员查看考生名单。
教师查看个人监考安排。
学生查看已发布考试日程。
SQLite 增量升级和 MySQL 正式迁移。
    biss 2026-07-24 15:43:55 +08:00
    7f3e37de20