QLTS · UC-QLTS-01

UC-QLTS-01 — Chuẩn bị danh mục tuyển sinh

Chuẩn bị danh mục tuyển sinh. Danh mục toàn hệ và danh mục theo kỳ phải tách rõ để đổi kỳ không làm mất master data.

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

S1 · Danh mục khối/tổ hợp

Danh mục khối/tổ hợp

List/create master khối tuyển sinh and verify it can be scoped into a kỳ tuyển sinh.

keywordcycleIdroundIdcodename

API: `GET /catalogs/blocks`; `POST /catalogs/blocks`; `POST /catalogs/sync-to-cycle` with `cycleId`, `blockIds`. · DB:

Master row: `TDMKHOITS.IDKHOITS`, `MAKHOITS`, `TENKHOITS`, `TTKHOITS`, `VTKHOITS`, `HUYKHOITS`, `GCKHOITS`, `IDDVPC`. Cycle snapshot: `TDSKHOITS.IDDSKHOITS`, `N

S2 · Danh mục ngành

Danh mục ngành

List/create master ngành and verify chỉ tiêu/điều kiện theo kỳ are available to later intake/selection screens.

keywordcycleIdcodenamemajorIds

API: `GET /catalogs/majors`; `POST /catalogs/majors`; `POST /catalogs/sync-to-cycle` with `cycleId`, `majorIds`. · DB:

Master row: `TDMNGTS.IDNGTS`, `MANGTS`, `TENNGTS`, `MASONGTS`, `TTNGTS`, `HUYNGTS`, `IDDVPC`. Cycle row: `TDSNGTS.IDDSNGTS`, `NHHK`, `IDKyTS`, `IDNGTS`, `CHITIE

S3 · Danh mục môn

Danh mục môn

List/create master môn and confirm field mapping for score entry is preserved.

keywordcycleIdcodenamesubjectIds

API: `GET /catalogs/subjects`; `POST /catalogs/subjects`; `POST /catalogs/sync-to-cycle` with `cycleId`, `subjectIds`. · DB:

Master row: `TDMMONTS.IDMONTS`, `MAMONTS`, `TENMONTS`, `FieldMap`, `IsNangKhieu`, `DiemDK`, `HUYMONTS`, `IDDVPC`. Cycle row: `TDSMONTS.IDDSMONTS`, `NHHK`, `IDKy

S4 · Lấy danh mục vào kỳ

Lấy danh mục vào kỳ

Verify one command copies selected master catalogs into kỳ-specific lookup rows used by UC-03..05.

cycleIdblockIds[]majorIds[]subjectIds[]successaffectedCountwarnings[]

cycleId	blockIds[]	majorIds[]	subjectIds[]	success	affectedCount
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: `POST /catalogs/sync-to-cycle`. · DB:

Mapping rows exist for selected ids in `TDSKHOITS.IDKyTS/IDKHOITS`, `TDSNGTS.IDKyTS/IDNGTS`, `TDSMONTS.IDKyTS/IDMONTS`; phương thức mappings can be asserted thr