QLTS · UC-QLTS-06

UC-QLTS-06 — Phân lớp, gán mã SV, giấy báo

Phân lớp, gán mã SV, giấy báo. `STTSVTN` không chứa lớp/mã trực tiếp trong catalog hiện tại; lớp/mã nằm ở `TDSTRTUYEN`/`TDSTS` theo schema dump.

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

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

Danh sách trúng tuyển

Load the candidate pool after UC-05 and verify class/code/notice columns are visible before assignment.

cycleIdroundIdkeywordapplicationIdacceptedStudentIdstudentIdstudentCodeclassIdnoticeNo

cycleId	roundId	keyword	applicationId	acceptedStudentId	studentId
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: `GET /accepted-students`. · DB:

`TDSTRTUYEN.IDDSTRTUYEN`, `IDKyTS`, `IDDSTS`, `IDDOTNVTS`, `IDNGTS`, `IDKHOITS`, `MaSV`, `IDSV`, `IDLop`, `SOGBTT`, `IDBH`, `IDDVPC`; `STTSVTN.IDTTSVTN`, `IDSV`

S2 · Phân lớp tự động/thủ công

Phân lớp tự động/thủ công

Assign class ids to accepted candidates and verify capacity strategy does not overwrite already assigned rows unless allowed.

roundIdmajorIdclassPlan[]classIdcapacitystrategyAUTO_BY_CAPACITY

API: `POST /accepted-students/assign-classes`. · DB:

Primary update: `TDSTRTUYEN.IDDSTRTUYEN`, `IDDOTNVTS`, `IDNGTS`, `IDLop`, `IDBH`, `IDDVPC`; mirrored/lookup candidate fields if service updates them: `TDSTS.IDD

S3 · Gán mã sinh viên

Gán mã sinh viên

Generate or save student codes after class assignment.

roundIdstartCodestrategy

API: `POST /accepted-students/assign-codes`. · DB:

`TDSTRTUYEN.MaSV`, `IDSV`, `IDLop`, `IDDSTS`, `IDDOTNVTS`, `IDNGTS`, `IDKHOITS`, `IDDVPC`; mirrored candidate code `TDSTS.MaSV`; accepted-list link `STTSVTN.IDS

S4 · Số giấy báo / dữ liệu in giấy báo

Số giấy báo / dữ liệu in giấy báo

Create notice numbers/artifacts for selected accepted students.

roundIdtemplateIdacceptedStudentIds[]fullNamemajorblockstudentCodenoticeNo

API: `POST /accepted-students/admission-notices`. · DB:

`TDSTRTUYEN.SOGBTT`, `DENNGAYGIONH`, `NGAYGIONH`, `MaSV`, `IDLop`, `IDSV`, `IDDSTS`, `IDDOTNVTS`, `IDNGTS`, `IDKHOITS`; source display fields `TDSTS.TenDayDu`,

S5 · Conflict before downstream hand-off

Conflict before downstream hand-off

Verify UC-06 does not mutate rows already marked as moved to later steps.

CHUYENQLSV=1

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: Same assignment/notice endpoints; error contract `409 CONFLICT`. · DB:

Guard columns on `TDSTRTUYEN`: `CHUYENQLSV`, `IsXNNH`, `IsXNNHBO`, `SOGBTT`, `MaSV`, `IDLop`; check audit/update columns `MaUser`, `NgayThem`, `IDDVPC`.