QLTS · UC-QLTS-04

UC-QLTS-04 — Tổ chức thi, SBD/phòng/phách/điểm

Tổ chức thi, SBD/phòng/phách/điểm. Sau sửa điểm phải chạy lại cộng điểm để UC-05 không xét trên điểm cũ.

Nguồn: docs/modules/qlts/use-cases/UC-QLTS-04.md · Sample data (fake VN)

S1 · Đồng bộ môn thi theo hồ sơ

Đồng bộ môn thi theo hồ sơ

Create candidate-subject rows from selected kỳ/đợt so score entry has deterministic rows.

cycleIdroundIdaffectedCount

API: `POST /exam/sync-subjects` with `cycleId`, `roundId`. · DB:

Candidate source: `TDSTS.IDDSTS`, `IDKyTS`, `IDNGTS`, `IDKHOITS`, `IDDVPC`. Subject rows created/updated: `TDSTSMON.IDDSTSMON`, `IDKyTS`, `IDDSTS`, `IDMONTS`, `

S2 · Gán / khóa số báo danh

Gán / khóa số báo danh

Verify automatic/continued/manual SBD assignment and lock metadata on candidate row.

cycleIdmodeASSIGNCONTINUEMANUALapplicationIdseatNoSBD2

API: `POST /exam/seat-numbers`. · DB:

`TDSTS.IDDSTS`, `SBD`, `SBD2`, `ISLOCKSBD`, `NGAYLOCKSBD`, `USERLOCKSBD`, `IDKyTS`, `IDDVPC`; conflict smoke should return `409` if seat number is locked.

S3 · Phân phòng/phách

Phân phòng/phách

Verify selected rooms are assigned only to the requested môn/ngày-buổi candidate set.

cycleIdroomIds[]subjectId

API: `POST /exam/rooms`. · DB:

Assignment detail rows: `TDSTSMONCT.IDDSTSMONCT`, `IDGRPTSCT`, `IDMONTS`, `IDKyTS`, `IDDSTS`, `IDPHTHI`, `STTTRANG`, `STTSCAN`, `NGAYGIOPV`, `IDHDGK`, `DIEMMONC

S4 · Nhập điểm theo SBD/phách

Nhập điểm theo SBD/phách

Save one score and confirm UC-05 score calculation can read the component value.

applicationIdsubjectIdscorescoreTypeBY_SEAT_NOBY_ANONYMIZED_CODE

API: `POST /exam/scores`. · DB:

`TDIEMTPMHTS.IDDiemTPTS`, `IDDSTSMON`, `LoaiPAND`, `DiemTPTS`, `HeSoPAND`, `MaUser`, `NgayThem`, `IDDVPC`; roll-up fields if recalculated: `TDSTSMON.DIEMMON`, `

S5 · Điểm thưởng/phạt theo môn

Điểm thưởng/phạt theo môn

Verify bonus/penalty rows are available for the total score pipeline when the UI exposes them.

applicationIdsubjectIdbonusScorebonusNotepenaltyScorepenaltyNote

applicationId	subjectId	bonusScore	bonusNote	penaltyScore	penaltyNote
SV22010001	Nguyễn Văn An	CNTT-K18-01	Đang học	QĐ/2025/810	Mẫu-1
SV22010015	Trần Thị Bình	CNTT-K18-02	Tạm dừng	QĐ/2025/811	Mẫu-2
SV22010028	Lê Minh Châu	KT-K18-01	Đang học	QĐ/2025/812	Mẫu-3
SV22010042	Phạm Quốc Dũng	QTKD-K18-01	Nghỉ luôn	QĐ/2025/813	Mẫu-4
SV22010057	Hoàng Thu Hà	NN-K18-03	Đang học	QĐ/2025/814	Mẫu-5
SV22010063	Vũ Đức Khoa	CNTT-K18-01	Tốt nghiệp	QĐ/2025/815	Mẫu-6

API: Included in the `/exam/scores` score-save pipeline for MVP; no separate endpoint is listed in `openapi.yaml`. · DB:

`TDSTSMONTP.IDDSTSMONTP`, `IDKyTS`, `IDDSTS`, `IDMONTS`, `DIEMTHUONG`, `GCTHUONG`, `DIEMPHAT`, `GCPHAT`, `HTPHAT`, `MaUser`, `NgayThem`.