SRM · UC-SRM-05

UC-SRM-05 — Thi lai / phach / lop ket qua

Thi lai / phach / lop ket qua. This UC is contract-ready for implementation baseline; full 1:1 requires the blocker checks below.

Nguồn: docs/modules/srm/use-cases/UC-SRM-05.md · Sample data (fake VN)

S1 · Retake registration

Retake registration

termCodeKyHieuTP

API: `POST /retake-exams/registrations` with `dryRun=true`, then verify created/validated response · DB:

`DDKTHILAI`: `IDDKThiLai`, `IDKQDK`, `NHHK`, `KyHieuTP`, `IDDP`, `MaUser`, `NgayThem`; `MKQDK`: `IDKQDK`, `IDSV`, `NHHK`, `IDToHoc`, `DiemTKHP`, `DiemChu`, `Die

S2 · Exam code generation

Exam code generation

keywordtermCode

API: `POST /exam-codes/generate` and `GET /exam-codes/{groupId}?termCode={NHHK}` · DB:

`DNhPhach`: `IDNhPhach`, `NHHK`, `IDMH`, `TenNhPhach`, `KyThi`, `NguonPhach`, `MaNhPhach`, `DaTaoPhach`, `SoBaiTrenLo`, `SoLoTrenTui`, `IsLock`, `IsDaHoiPhach`;

S3 · Student phach detail and permission

Student phach detail and permission

MaTuiMaLoMaPhach

API: `GET /exam-codes/{groupId}` · DB:

`DNhPhachSV`: `IDNhPhachSV`, `IDNhPhachCT`, `IDSV`, `NHHK`, `IDKQDK`, `IDKQDKDThi`, `Stt`, `MaTui`, `MaLo`, `MaPhach`, `DiemPh`, `SoBD`; `DPQPhach`: `IDPQPhach`

S4 · True gaps

True gaps

TachGhepLopDA

Mã	Họ tên	Lớp/Ngành	Trạng thái	Ghi chú
SV22010001	Nguyễn Văn An	CNTT-K18-01	Đang học	QĐ/2025/810
SV22010015	Trần Thị Bình	CNTT-K18-02	Tạm dừng	QĐ/2025/811
SV22010028	Lê Minh Châu	KT-K18-01	Đang học	QĐ/2025/812
SV22010042	Phạm Quốc Dũng	QTKD-K18-01	Nghỉ luôn	QĐ/2025/813
SV22010057	Hoàng Thu Hà	NN-K18-03	Đang học	QĐ/2025/814
SV22010063	Vũ Đức Khoa	CNTT-K18-01	Tốt nghiệp	QĐ/2025/815

API: API endpoints cover registration/phach only; no dedicated split/merge retake endpoint is documented under SRM · DB:

`TaoPhachDA` and `TachGhepLopDA` method bodies are DLL-only, so generated code ordering/randomization is a known parity gap