已修改完成,同时解决了“考生名单都是 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)
未分配考场或监考教师时,也能导出并显示“待分配”。
This commit is contained in:
2026-07-27 18:24:32 +08:00 Unverified
parent 2e422acd19
commit fb2acc6751
9 changed files with 856 additions and 71 deletions
@@ -48,6 +48,7 @@ public sealed class ExamArrangementServiceTests
.SingleAsync(x => x.Id == untouched.Id);
Assert.True(result.Success);
Assert.NotNull(persistedSelected.ClassroomId);
Assert.Equal(seed.LargeClassroom.Id, persistedSelected.ClassroomId);
Assert.Null(persistedUntouched.ClassroomId);
Assert.Single(persistedSelected.Invigilators);
Assert.Empty(persistedUntouched.Invigilators);
@@ -159,6 +160,27 @@ public sealed class ExamArrangementServiceTests
BuildingId = building.Id,
Capacity = 80
};
var smallClassroom = new Classroom
{
Code = $"R-SMALL-{suffix}",
Name = "102",
BuildingId = building.Id,
Capacity = 1
};
var major = new Major
{
Code = $"MAJOR-{suffix}",
Name = "计算机科学与技术",
CollegeId = college.Id,
DegreeType = "工学学士"
};
var administrativeClass = new AdministrativeClass
{
Code = $"CLASS-{suffix}",
Name = "计科 2026-1 班",
MajorId = major.Id,
Grade = 2026
};
var firstCourse = new Course
{
Code = $"COURSE-1-{suffix}",
@@ -177,7 +199,14 @@ public sealed class ExamArrangementServiceTests
Name = "程序设计教学班",
AcademicTermId = term.Id,
CourseId = firstCourse.Id,
Status = TeachingTaskStatus.Published
Status = TeachingTaskStatus.Published,
Classes =
[
new TeachingTaskClass
{
AdministrativeClassId = administrativeClass.Id
}
]
};
var secondTask = new TeachingTask
{
@@ -201,6 +230,25 @@ public sealed class ExamArrangementServiceTests
college,
building,
classroom,
smallClassroom,
major,
administrativeClass,
new Student
{
StudentNumber = $"STUDENT-1-{suffix}",
Name = "学生甲",
AdministrativeClassId = administrativeClass.Id,
EnrollmentYear = 2026,
EnrollmentDate = new DateOnly(2026, 9, 1)
},
new Student
{
StudentNumber = $"STUDENT-2-{suffix}",
Name = "学生乙",
AdministrativeClassId = administrativeClass.Id,
EnrollmentYear = 2026,
EnrollmentDate = new DateOnly(2026, 9, 1)
},
firstCourse,
secondCourse,
firstTask,
@@ -223,11 +271,12 @@ public sealed class ExamArrangementServiceTests
EndsAt = new TimeOnly(9, 50)
});
await db.SaveChangesAsync();
return new SeedData(term, firstTask, secondTask);
return new SeedData(term, firstTask, secondTask, classroom);
}
private sealed record SeedData(
AcademicTerm Term,
TeachingTask FirstTask,
TeachingTask SecondTask);
TeachingTask SecondTask,
Classroom LargeClassroom);
}
@@ -0,0 +1,60 @@
using ClosedXML.Excel;
using Jiaowu.Api.Infrastructure.Exams;
namespace Jiaowu.Api.Tests;
public sealed class ExamSignInWorkbookExporterTests
{
[Fact]
public void Create_builds_summary_and_printable_session_sheets()
{
var sessionId = Guid.NewGuid();
var session = new ExamSignInSessionData(
sessionId,
new DateOnly(2027, 1, 8),
new DateTime(2027, 1, 8, 8, 0, 0, DateTimeKind.Utc),
new DateTime(2027, 1, 8, 9, 50, 0, DateTimeKind.Utc),
"CS101",
"程序设计基础",
"2026-1-CS101-01",
"第一教学楼",
"101",
["张老师", "李老师"],
[
new ExamSignInStudentData(
Guid.NewGuid(),
"202601001",
"周同学",
"计科 2026-1 班")
]);
var data = new ExamSignInWorkbookData(
"2026—2027 学年第一学期期末考试",
"2026—2027 学年第一学期",
[
session,
session with { SessionId = Guid.NewGuid() }
]);
var bytes = ExamSignInWorkbookExporter.Create(data);
using var stream = new MemoryStream(bytes);
using var workbook = new XLWorkbook(stream);
Assert.Equal(3, workbook.Worksheets.Count);
Assert.Equal("考场汇总", workbook.Worksheet(1).Name);
Assert.Equal(1, workbook.Worksheet("考场汇总").Cell("F5").GetDouble());
Assert.Equal(1, workbook.Worksheet("考场汇总").Cell("F6").GetDouble());
Assert.Equal(
workbook.Worksheets.Count,
workbook.Worksheets.Select(x => x.Name)
.Distinct(StringComparer.OrdinalIgnoreCase)
.Count());
var signInSheet = workbook.Worksheet(2);
Assert.Equal("考试考场签名单", signInSheet.Cell("A1").GetString());
Assert.Contains("第一教学楼", signInSheet.Cell("E4").GetString());
Assert.Equal("202601001", signInSheet.Cell("C8").GetString());
Assert.Equal("周同学", signInSheet.Cell("D8").GetString());
Assert.Equal(XLPageOrientation.Portrait, signInSheet.PageSetup.PageOrientation);
Assert.Equal(XLPaperSize.A4Paper, signInSheet.PageSetup.PaperSize);
}
}
@@ -119,15 +119,28 @@ public sealed class MySqlMigrationTests
public void MySql_teaching_task_roster_query_is_translatable()
{
using var db = new AppDbContext(CreateMySqlOptions());
var studentId =
Guid.Parse("22222222-2222-2222-2222-222222222222");
var sql = TeachingTaskRosterQuery
.ForTask(
db,
Guid.Parse("11111111-1111-1111-1111-111111111111"))
.ToQueryString();
var taskIdsSql = TeachingTaskRosterQuery
.TaskIdsForStudent(db, studentId)
.ToQueryString();
Assert.Contains("TeachingTaskClasses", sql, StringComparison.OrdinalIgnoreCase);
Assert.Contains("CourseEnrollments", sql, StringComparison.OrdinalIgnoreCase);
Assert.Contains(
"TeachingTaskClasses",
taskIdsSql,
StringComparison.OrdinalIgnoreCase);
Assert.Contains(
"CourseEnrollments",
taskIdsSql,
StringComparison.OrdinalIgnoreCase);
}
[Fact]
@@ -1,7 +1,10 @@
using ClosedXML.Excel;
using Jiaowu.Api.Controllers;
using Jiaowu.Api.Domain.Academic;
using Jiaowu.Api.Domain.Identity;
using Jiaowu.Api.Infrastructure.Auth;
using Jiaowu.Api.Infrastructure.Caching;
using Jiaowu.Api.Infrastructure.Exams;
using Jiaowu.Api.Infrastructure.Persistence;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Data.Sqlite;
@@ -12,7 +15,7 @@ namespace Jiaowu.Api.Tests;
public sealed class TeachingWorkflowRosterTests
{
[Fact]
public async Task ClassAssignedStudents_AppearAcrossTeacherWorkflows()
public async Task ClassAssignedStudents_AppearAcrossTeachingAndExamWorkflows()
{
await using var connection = new SqliteConnection("Data Source=:memory:");
await connection.OpenAsync();
@@ -23,6 +26,7 @@ public sealed class TeachingWorkflowRosterTests
await db.Database.EnsureCreatedAsync();
var teacherUserId = Guid.NewGuid();
var studentUserId = Guid.NewGuid();
var teacherUser = new ApplicationUser
{
Id = teacherUserId,
@@ -30,6 +34,13 @@ public sealed class TeachingWorkflowRosterTests
NormalizedUserName = "T001",
DisplayName = "张老师"
};
var studentUser = new ApplicationUser
{
Id = studentUserId,
UserName = "202601001",
NormalizedUserName = "202601001",
DisplayName = "周同学"
};
var college = new College { Code = "CS", Name = "计算机学院" };
var major = new Major
{
@@ -51,7 +62,8 @@ public sealed class TeachingWorkflowRosterTests
Name = "周同学",
AdministrativeClassId = administrativeClass.Id,
EnrollmentYear = 2026,
EnrollmentDate = new DateOnly(2026, 9, 1)
EnrollmentDate = new DateOnly(2026, 9, 1),
UserId = studentUserId
};
var teacher = new Teacher
{
@@ -107,6 +119,7 @@ public sealed class TeachingWorkflowRosterTests
};
db.AddRange(
teacherUser,
studentUser,
college,
major,
administrativeClass,
@@ -117,6 +130,28 @@ public sealed class TeachingWorkflowRosterTests
task);
await db.SaveChangesAsync();
var examPlan = new ExamPlan
{
AcademicTermId = term.Id,
Name = "期末考试",
Status = ExamPlanStatus.Published,
Sessions =
[
new ExamSession
{
TeachingTaskId = task.Id,
ExamDate = new DateOnly(2027, 1, 8),
StartPeriod = 1,
PeriodCount = 2,
StartsAt = new DateTime(2027, 1, 8, 8, 0, 0, DateTimeKind.Utc),
EndsAt = new DateTime(2027, 1, 8, 9, 50, 0, DateTimeKind.Utc),
RequiredInvigilatorCount = 1
}
]
};
db.ExamPlans.Add(examPlan);
await db.SaveChangesAsync();
var scope = new TeacherDataScope(teacherUserId);
var attendance = new AttendanceController(db, scope);
var attendanceResult = await attendance.CreateSheet(
@@ -153,6 +188,39 @@ public sealed class TeachingWorkflowRosterTests
Assert.Single(ReadItems(await adjustments.GetTaskOptions(
term.Id,
CancellationToken.None)));
var managerScope = new ManagerDataScope();
var exams = new ExamsController(
db,
managerScope,
new ExamArrangementService(db),
NoOpAppCache.Instance);
var planResult = Assert.IsType<OkObjectResult>(
await exams.GetPlan(examPlan.Id, CancellationToken.None));
var planSessions = ReadEnumerableProperty(planResult.Value!, "Sessions");
Assert.Equal(1, ReadIntProperty(planSessions.Single(), "StudentCount"));
var examSessionId = examPlan.Sessions.Single().Id;
var rosterResult = Assert.IsType<OkObjectResult>(
await exams.GetRoster(examSessionId, CancellationToken.None));
Assert.Single(ReadEnumerableProperty(rosterResult.Value!, "Students"));
var studentExams = new ExamsController(
db,
new StudentDataScope(studentUserId),
new ExamArrangementService(db),
NoOpAppCache.Instance);
Assert.Single(ReadItems(
await studentExams.GetMySchedule(CancellationToken.None)));
var exportResult = Assert.IsType<FileContentResult>(
await exams.ExportSignInSheets(examPlan.Id, CancellationToken.None));
using var workbookStream = new MemoryStream(exportResult.FileContents);
using var workbook = new XLWorkbook(workbookStream);
Assert.Equal(2, workbook.Worksheets.Count);
var signInSheet = workbook.Worksheets.Single(x => x.Name != "考场汇总");
Assert.Equal("202601001", signInSheet.Cell("C8").GetString());
Assert.Equal("周同学", signInSheet.Cell("D8").GetString());
}
private static List<object> ReadItems(ActionResult result)
@@ -166,6 +234,12 @@ public sealed class TeachingWorkflowRosterTests
private static int ReadIntProperty(object value, string name) =>
(int)value.GetType().GetProperty(name)!.GetValue(value)!;
private static List<object> ReadEnumerableProperty(object value, string name) =>
Assert.IsAssignableFrom<System.Collections.IEnumerable>(
value.GetType().GetProperty(name)!.GetValue(value))
.Cast<object>()
.ToList();
private sealed class TeacherDataScope(Guid userId) : ICurrentUserDataScope
{
public CurrentUserScope Current { get; } = new(
@@ -175,4 +249,24 @@ public sealed class TeachingWorkflowRosterTests
DataScope.Self,
new HashSet<string>([SystemRoles.Teacher]));
}
private sealed class StudentDataScope(Guid userId) : ICurrentUserDataScope
{
public CurrentUserScope Current { get; } = new(
userId,
"周同学",
null,
DataScope.Self,
new HashSet<string>([SystemRoles.Student]));
}
private sealed class ManagerDataScope : ICurrentUserDataScope
{
public CurrentUserScope Current { get; } = new(
Guid.NewGuid(),
"考试管理员",
null,
DataScope.All,
new HashSet<string>([SystemRoles.AcademicAdmin]));
}
}