主要更新:

班级课表支持年级、学院、专业、行政班分级筛选。
管理员课表查询中心支持班级、教师、场地三种课表。
超级管理员、校级教务、学院教务、领导可查询草稿和已发布版本;学院管理员保留学院数据范围。
增加周视图、日视图切换。
支持 Excel 导出和当前视图 PDF 导出。
学生端增加“空闲教室”,支持学期、周次、星期、连续节次、校区、教学楼、容量筛选,并按教学楼分组、分页展示。
空闲教室只依据正式课表计算;未配置节次表时自动提供默认节次。
This commit is contained in:
2026-07-25 08:53:42 +08:00 Unverified
parent fe508054d0
commit 0d34936d38
15 changed files with 2411 additions and 209 deletions
@@ -0,0 +1,162 @@
using ClosedXML.Excel;
namespace Jiaowu.Api.Infrastructure.Timetables;
public static class TimetableExcelExporter
{
private static readonly string[] Weekdays =
["", "星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期日"];
public static byte[] Create(TimetableData timetable)
{
using var workbook = new XLWorkbook();
var sheet = workbook.Worksheets.Add("课表");
sheet.Style.Font.FontName = "Microsoft YaHei";
sheet.Range("A1:H1").Merge();
sheet.Cell("A1").Value = $"{timetable.Subject.Name} · {timetable.Term.Name}课表";
sheet.Cell("A1").Style
.Font.SetBold()
.Font.SetFontSize(18)
.Font.SetFontColor(XLColor.White)
.Fill.SetBackgroundColor(XLColor.FromHtml("#173E72"))
.Alignment.SetHorizontal(XLAlignmentHorizontalValues.Left)
.Alignment.SetVertical(XLAlignmentVerticalValues.Center);
sheet.Row(1).Height = 34;
sheet.Range("A2:H2").Merge();
sheet.Cell("A2").Value = timetable.Plan is null
? "本学期暂无可用课表版本"
: $"版本:{timetable.Plan.Version} · 状态:{PlanStatus(timetable.Plan.Status)} · 导出时间:{DateTime.Now:yyyy-MM-dd HH:mm}";
sheet.Cell("A2").Style
.Font.SetFontColor(XLColor.FromHtml("#52677A"))
.Fill.SetBackgroundColor(XLColor.FromHtml("#EFF3F6"));
sheet.Row(2).Height = 24;
var headerRow = 4;
var headers = new[] { "节次 / 时间" }.Concat(Weekdays.Skip(1)).ToArray();
for (var column = 1; column <= headers.Length; column++)
{
var cell = sheet.Cell(headerRow, column);
cell.Value = headers[column - 1];
cell.Style
.Font.SetBold()
.Font.SetFontColor(XLColor.White)
.Fill.SetBackgroundColor(XLColor.FromHtml("#24706A"))
.Alignment.SetHorizontal(XLAlignmentHorizontalValues.Center)
.Alignment.SetVertical(XLAlignmentVerticalValues.Center);
}
sheet.Row(headerRow).Height = 26;
var periods = timetable.Slots.Select(x => x.PeriodNumber)
.Concat(timetable.Entries.SelectMany(x =>
Enumerable.Range(x.StartPeriod, x.PeriodCount)))
.Distinct()
.Order()
.ToArray();
if (periods.Length == 0) periods = Enumerable.Range(1, 8).ToArray();
for (var index = 0; index < periods.Length; index++)
{
var period = periods[index];
var row = headerRow + index + 1;
var slot = timetable.Slots.FirstOrDefault(x => x.PeriodNumber == period);
sheet.Cell(row, 1).Value = slot is null
? $"第 {period} 节"
: $"第 {period} 节\n{slot.StartsAt:HH\\:mm}-{slot.EndsAt:HH\\:mm}";
sheet.Cell(row, 1).Style
.Font.SetBold()
.Fill.SetBackgroundColor(XLColor.FromHtml("#F0F4F6"))
.Alignment.SetHorizontal(XLAlignmentHorizontalValues.Center)
.Alignment.SetVertical(XLAlignmentVerticalValues.Center)
.Alignment.SetWrapText();
for (var day = 1; day <= 7; day++)
{
var entries = timetable.Entries
.Where(x =>
x.DayOfWeek == day &&
x.StartPeriod <= period &&
x.StartPeriod + x.PeriodCount - 1 >= period)
.ToList();
var cell = sheet.Cell(row, day + 1);
cell.Value = string.Join("\n\n", entries.Select(EntryText));
cell.Style
.Alignment.SetVertical(XLAlignmentVerticalValues.Top)
.Alignment.SetWrapText();
if (entries.Count > 0)
{
cell.Style
.Fill.SetBackgroundColor(XLColor.FromHtml("#E8F3F2"))
.Font.SetFontColor(XLColor.FromHtml("#173F4C"));
}
}
sheet.Row(row).Height = 64;
}
var grid = sheet.Range(
headerRow,
1,
headerRow + periods.Length,
headers.Length);
grid.Style.Border.InsideBorder = XLBorderStyleValues.Thin;
grid.Style.Border.InsideBorderColor = XLColor.FromHtml("#D8E1E6");
grid.Style.Border.OutsideBorder = XLBorderStyleValues.Medium;
grid.Style.Border.OutsideBorderColor = XLColor.FromHtml("#AABBC5");
sheet.Column(1).Width = 16;
for (var column = 2; column <= 8; column++) sheet.Column(column).Width = 24;
sheet.SheetView.FreezeRows(headerRow);
if (timetable.FlexibleCourses.Count > 0)
{
var startRow = headerRow + periods.Length + 3;
sheet.Range(startRow, 1, startRow, 8).Merge();
sheet.Cell(startRow, 1).Value = "非排时课程(不占正常上课时间与场地)";
sheet.Cell(startRow, 1).Style
.Font.SetBold()
.Font.SetFontColor(XLColor.White)
.Fill.SetBackgroundColor(XLColor.FromHtml("#805C27"));
var row = startRow + 1;
foreach (var course in timetable.FlexibleCourses)
{
sheet.Range(row, 1, row, 8).Merge();
sheet.Cell(row, 1).Value =
$"{course.CourseCode} · {course.CourseName} · {string.Join('、', course.TeacherNames)} · 第 {course.StartWeek}-{course.EndWeek} 周 · 每周 {course.WeeklyHours} 学时";
sheet.Cell(row, 1).Style
.Fill.SetBackgroundColor(XLColor.FromHtml("#FFF8EA"))
.Alignment.SetWrapText();
row++;
}
}
sheet.PageSetup.PageOrientation = XLPageOrientation.Landscape;
sheet.PageSetup.PaperSize = XLPaperSize.A4Paper;
sheet.PageSetup.FitToPages(1, 0);
sheet.PageSetup.Margins.SetLeft(0.25).SetRight(0.25).SetTop(0.35).SetBottom(0.35);
using var stream = new MemoryStream();
workbook.SaveAs(stream);
return stream.ToArray();
}
private static string EntryText(TimetableEntryDto entry) =>
$"{entry.CourseName}\n" +
$"{string.Join('、', entry.TeacherNames)}\n" +
$"{Location(entry)}\n" +
$"{entry.StartWeek}-{entry.EndWeek} 周";
private static string Location(TimetableEntryDto entry) =>
string.Join(" · ", new[]
{
entry.CampusName,
entry.BuildingName,
entry.ClassroomName
}.Where(x => !string.IsNullOrWhiteSpace(x)));
private static string PlanStatus(Domain.Academic.SchedulePlanStatus status) =>
status switch
{
Domain.Academic.SchedulePlanStatus.Draft => "草稿",
Domain.Academic.SchedulePlanStatus.Published => "已发布",
Domain.Academic.SchedulePlanStatus.Archived => "已归档",
_ => status.ToString()
};
}