QLTS · UC-QLTS-05

UC-QLTS-05 — Cộng điểm & xét tuyển

Cộng điểm & xét tuyển. Thuật toán core đã decompile từ `Edusoft.CMS.DataAccess.dll`; khi remake cần port theo policy có tenant flags thay vì chỉ ship baseline generic.

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

S1 · Preview cộng điểm

Preview cộng điểm

Recalculate wish totals without persisting accepted results.

cycleIdroundIdmodeBY_ROUNDBY_CANDIDATEdryRun=truemethodIds[]

API: `POST /selection/calculate-scores`. · DB:

Source rows: `TDSTS.IDDSTS`, `IDKyTS`, `IDPTXT`, `IDNGTS`, `IDKHOITS`, `Diem1`, `Diem2`, `Diem3`, `DiemTong`, `IsDuyetHoSo`, `IsXetBangDH`, `CO_TN`, `IDDVPC`; w

S2 · Ưu tiên / điểm sàn / chỉ tiêu

Ưu tiên / điểm sàn / chỉ tiêu

Verify score calculation uses configured ngành/khối/phương thức and object priority data.

cycleIdroundIdmajorIdblockId

API: `POST /selection/calculate-scores`; errors use `422 VALIDATION_FAILED`. · DB:

Config reads: `TDSNGTS.IDKyTS`, `IDNGTS`, `CHITIEUDK`, `DiemTong`, `MonDK1`, `MonDK2`, `DoTuoi`, `LoaiBangTN`, `IsBangDHThS`; `TDSKHOITS.IDKyTS`, `IDKHOITS`, `D

S3 · Chạy xét tuyển

Chạy xét tuyển

Persist accepted results and prevent duplicate acceptance for the same candidate/wish.

cycleIdroundIdmodedryRun=falseBY_CANDIDATE

API: `POST /selection/run`. · DB:

Accepted result: `TDSTRTUYEN.IDDSTRTUYEN`, `IDKyTS`, `IDDSTS`, `NGUYENVONG`, `IDNGTS`, `IDDOTNVTS`, `IDKHOITS`, `MaSV`, `IDSV`, `IDLop`, `SOGBTT`, `IDDVPC`, `CH

S4 · Danh sách trúng tuyển

Danh sách trúng tuyển

Verify the list consumed by UC-06/07 is generated from persisted selection output.

cycleIdroundIdkeywordcandidateCodefullNamemajorblockstudentCodeclassIdnoticeNo

cycleId	roundId	keyword	candidateCode	fullName	major
Nguyễn Thị Mai	079203001234	CNTT	HS-2025-100	Đã nộp	Mẫu-1
Trần Văn Hùng	001203004567	KT	HS-2025-101	Đã nộp	Mẫu-2
Lê Thuý An	079204008901	NN	HS-2025-102	Đã nộp	Mẫu-3
Phạm Minh Tuấn	001204002345	QTKD	HS-2025-103	Đã nộp	Mẫu-4
Hoàng Gia Bảo	079205006789	CNTT	HS-2025-104	Đã nộp	Mẫu-5
Võ Ngọc Diệp	001205001122	KT	HS-2025-105	Đã nộp	Mẫu-6

API: `GET /accepted-students`. · DB:

Join/assert keys: `TDSTRTUYEN.IDDSTS`, `IDDOTNVTS`, `IDNGTS`, `IDKHOITS`, `MaSV`, `IDSV`, `IDLop`, `SOGBTT`, `CHUYENQLSV`; `TDSTS.IDDSTS`, `TenDayDu`, `SoCMND`;

S5 · Hủy kết quả xét tuyển

Hủy kết quả xét tuyển

Verify cancel is blocked after downstream side-effects and otherwise removes accepted results.

roundIdreasonSOGBTTMaSVIDLop

API: `POST /selection/cancel`. · DB:

Conflict guard columns: `TDSTRTUYEN.SOGBTT`, `MaSV`, `IDLop`, `CHUYENQLSV`; delete target rows by `TDSTRTUYEN.IDDOTNVTS`, `NGUYENVONG`, `IDDSTS`, `IDNGTS`, `IDK

S6 · Xét học bạ / biến thể điểm

Xét học bạ / biến thể điểm

Verify học bạ-specific input rows can participate in score preview/run when tenant enables the branch.

cycleIdroundId

Mã	Họ tên	Lớp/Ngành	Trạng thái	Ghi chú
Nguyễn Thị Mai	079203001234	CNTT	HS-2025-100	Đã nộp
Trần Văn Hùng	001203004567	KT	HS-2025-101	Đã nộp
Lê Thuý An	079204008901	NN	HS-2025-102	Đã nộp
Phạm Minh Tuấn	001204002345	QTKD	HS-2025-103	Đã nộp
Hoàng Gia Bảo	079205006789	CNTT	HS-2025-104	Đã nộp
Võ Ngọc Diệp	001205001122	KT	HS-2025-105	Đã nộp

API: Same selection endpoints: `POST /selection/calculate-scores`, `POST /selection/run`. · DB:

`TDSTS.DMHK1LP10`, `DMHK2LP10`, `DMHK1LP11`, `DMHK2LP11`, `DMHK1LP12`, `DMHK2LP12`, `DiemTong`, `CO_HB`, `IsNotHB`; học bạ tables `TTSDSHB.IDTSHB`, `IDDSTS`, `I