学生可在“学籍管理 → 电子成绩单与证明”申请成绩单或学籍证明。
服务端根据登录账号绑定本人档案，不接受学生 ID，无法代他人申请。 成绩单仅包含正式发布成绩；无已发布成绩时明确提示。 同类型、同用途 5 分钟内重复申请复用已有有效凭证。 申请后即时生成 PDF，可在本人凭证列表下载、二维码验真。 管理员的下载记录、失效、重签能力保持不变。
This commit is contained in:
@@ -0,0 +1,165 @@
|
||||
using System.Security.Cryptography;
|
||||
using System.Text;
|
||||
using System.Text.Json;
|
||||
using Jiaowu.Api.Domain.Academic;
|
||||
using Jiaowu.Api.Infrastructure.Persistence;
|
||||
using Microsoft.EntityFrameworkCore;
|
||||
|
||||
namespace Jiaowu.Api.Infrastructure.OfficialDocuments;
|
||||
|
||||
public sealed class OfficialDocumentService(
|
||||
AppDbContext db,
|
||||
OfficialDocumentOptions options,
|
||||
IOfficialDocumentPdfGenerator pdfGenerator)
|
||||
{
|
||||
private static readonly JsonSerializerOptions SnapshotJsonOptions = new(JsonSerializerDefaults.Web);
|
||||
|
||||
public async Task<OfficialDocument> CreateAsync(
|
||||
Guid studentId,
|
||||
OfficialDocumentType type,
|
||||
string? purpose,
|
||||
Guid issuedByUserId,
|
||||
string issuedByName,
|
||||
string verificationBaseUrl,
|
||||
Guid? reissuedFromDocumentId,
|
||||
CancellationToken cancellationToken)
|
||||
{
|
||||
var student = await db.Students.AsNoTracking()
|
||||
.Where(x => x.Id == studentId)
|
||||
.Select(x => new
|
||||
{
|
||||
x.StudentNumber,
|
||||
x.Name,
|
||||
x.Gender,
|
||||
x.EnrollmentYear,
|
||||
x.EnrollmentDate,
|
||||
x.Status,
|
||||
CollegeName = x.AdministrativeClass!.Major!.College!.Name,
|
||||
MajorName = x.AdministrativeClass.Major.Name,
|
||||
ClassName = x.AdministrativeClass.Name
|
||||
})
|
||||
.SingleOrDefaultAsync(cancellationToken)
|
||||
?? throw new OfficialDocumentValidationException("学生档案不存在。");
|
||||
|
||||
var grades = type == OfficialDocumentType.Transcript
|
||||
? await db.GradeRecords.AsNoTracking()
|
||||
.Where(x =>
|
||||
x.StudentId == studentId &&
|
||||
x.GradeSheet!.Status == GradeSheetStatus.Published)
|
||||
.OrderBy(x => x.GradeSheet!.TeachingTask!.AcademicTerm!.StartDate)
|
||||
.ThenBy(x => x.GradeSheet!.TeachingTask!.Course!.Code)
|
||||
.Select(x => new OfficialTranscriptRow(
|
||||
x.GradeSheet!.TeachingTask!.AcademicTerm!.Name,
|
||||
x.GradeSheet.TeachingTask.Course!.Code,
|
||||
x.GradeSheet.TeachingTask.Course.Name,
|
||||
x.GradeSheet.TeachingTask.Course.Credits,
|
||||
x.TotalScore,
|
||||
x.GradePoint,
|
||||
GradeExamStatusLabel(x.ExamStatus)))
|
||||
.ToListAsync(cancellationToken)
|
||||
: [];
|
||||
|
||||
if (type == OfficialDocumentType.Transcript && grades.Count == 0)
|
||||
throw new OfficialDocumentValidationException("该学生暂无已发布成绩，不能签发官方成绩单。");
|
||||
|
||||
var issuedAt = DateTime.UtcNow;
|
||||
var documentNumber = CreateDocumentNumber(type, issuedAt);
|
||||
var verificationCode = CreateVerificationCode();
|
||||
var studentSnapshot = new OfficialStudentSnapshot(
|
||||
student.StudentNumber,
|
||||
student.Name,
|
||||
GenderLabel(student.Gender),
|
||||
student.CollegeName,
|
||||
student.MajorName,
|
||||
student.ClassName,
|
||||
student.EnrollmentYear,
|
||||
student.EnrollmentDate,
|
||||
StudentStatusLabel(student.Status));
|
||||
var totalCredits = grades.Sum(x => x.Credits);
|
||||
var passedGrades = grades
|
||||
.Where(x => x.Score >= 60 || x.ExamStatus == "免修")
|
||||
.ToArray();
|
||||
var gpaGrades = grades.Where(x => x.GradePoint.HasValue).ToArray();
|
||||
var gpaCredits = gpaGrades.Sum(x => x.Credits);
|
||||
var gpa = gpaCredits > 0
|
||||
? gpaGrades.Sum(x => x.GradePoint!.Value * x.Credits) / gpaCredits
|
||||
: (decimal?)null;
|
||||
var snapshot = new OfficialDocumentSnapshot(
|
||||
options.InstitutionName,
|
||||
options.IssuingOffice,
|
||||
documentNumber,
|
||||
type,
|
||||
issuedAt,
|
||||
issuedByName,
|
||||
string.IsNullOrWhiteSpace(purpose) ? null : purpose.Trim(),
|
||||
studentSnapshot,
|
||||
grades,
|
||||
totalCredits,
|
||||
passedGrades.Sum(x => x.Credits),
|
||||
gpa);
|
||||
var verificationUrl = $"{verificationBaseUrl.TrimEnd('/')}/verify/{verificationCode}";
|
||||
var generated = pdfGenerator.Generate(snapshot, verificationUrl);
|
||||
|
||||
return new OfficialDocument
|
||||
{
|
||||
DocumentNumber = documentNumber,
|
||||
VerificationCodeHash = HashVerificationCode(verificationCode),
|
||||
Type = type,
|
||||
Status = OfficialDocumentStatus.Valid,
|
||||
StudentId = studentId,
|
||||
IssuedByUserId = issuedByUserId,
|
||||
IssuedAt = issuedAt,
|
||||
Purpose = snapshot.Purpose,
|
||||
SnapshotJson = JsonSerializer.Serialize(snapshot, SnapshotJsonOptions),
|
||||
PdfContent = generated.Content,
|
||||
PdfSha256 = generated.Sha256,
|
||||
ReissuedFromDocumentId = reissuedFromDocumentId
|
||||
};
|
||||
}
|
||||
|
||||
public static string HashVerificationCode(string verificationCode) =>
|
||||
Convert.ToHexString(SHA256.HashData(Encoding.UTF8.GetBytes(verificationCode)))
|
||||
.ToLowerInvariant();
|
||||
|
||||
public static OfficialDocumentSnapshot DeserializeSnapshot(string json) =>
|
||||
JsonSerializer.Deserialize<OfficialDocumentSnapshot>(json, SnapshotJsonOptions)
|
||||
?? throw new InvalidOperationException("官方凭证快照无法读取。");
|
||||
|
||||
private string CreateDocumentNumber(OfficialDocumentType type, DateTime issuedAt)
|
||||
{
|
||||
var typeCode = type == OfficialDocumentType.Transcript ? "TR" : "SC";
|
||||
var random = Convert.ToHexString(RandomNumberGenerator.GetBytes(6));
|
||||
return $"{options.DocumentNumberPrefix}-{typeCode}-{issuedAt:yyyyMMdd}-{random}";
|
||||
}
|
||||
|
||||
private static string CreateVerificationCode() =>
|
||||
Convert.ToHexString(RandomNumberGenerator.GetBytes(24)).ToLowerInvariant();
|
||||
|
||||
private static string GenderLabel(Gender value) => value switch
|
||||
{
|
||||
Gender.Male => "男",
|
||||
Gender.Female => "女",
|
||||
_ => "未登记"
|
||||
};
|
||||
|
||||
private static string StudentStatusLabel(StudentStatus value) => value switch
|
||||
{
|
||||
StudentStatus.Active => "在读",
|
||||
StudentStatus.Suspended => "休学",
|
||||
StudentStatus.Graduated => "已毕业",
|
||||
StudentStatus.Withdrawn => "退学",
|
||||
_ => "未知"
|
||||
};
|
||||
|
||||
private static string GradeExamStatusLabel(GradeExamStatus value) => value switch
|
||||
{
|
||||
GradeExamStatus.Normal => "正常",
|
||||
GradeExamStatus.Absent => "缺考",
|
||||
GradeExamStatus.Deferred => "缓考",
|
||||
GradeExamStatus.Exempt => "免修",
|
||||
GradeExamStatus.Makeup => "补考",
|
||||
_ => "未知"
|
||||
};
|
||||
}
|
||||
|
||||
public sealed class OfficialDocumentValidationException(string message) : Exception(message);
|
||||
Reference in New Issue
Block a user