QLTS · UC-QLTS-07

UC-QLTS-07 — Tiếp sinh / xác nhận nhập học

Tiếp sinh / xác nhận nhập học. `TTTNhapHoc` hiện 0 row trong catalog DB; API vẫn cần vì source SMS có đọc/ghi bảng này.

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

S1 · Danh sách tiếp sinh

Danh sách tiếp sinh

Load accepted students and distinguish chưa nhập học / đã nhập học / đã chuyển QLSV.

cycleIdroundIdkeywordacceptedStudentIdstudentIdstudentCodefullNameclassIdnoticeNo

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

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

`STTSVTN.IDTTSVTN`, `IDSV`, `NHHK`, `IDDVPC`; `TDSTRTUYEN.IDDSTRTUYEN`, `IDDSTS`, `IDSV`, `MaSV`, `IDLop`, `SOGBTT`, `NGAYGIONH`, `USERTIEPSINH`, `GCNHAPHOC`, `

S2 · Xác nhận nhập học

Xác nhận nhập học

Confirm one accepted student and persist the check-in state.

acceptedStudentIdconfirmedcheckedDocuments[]paidItems[]

API: `POST /checkin/confirm`. · DB:

Check-in row: `TTTNhapHoc.IDTTNhapHoc`, `IDSV`, `IsDKKTX`; accepted result flags/metadata: `TDSTRTUYEN.IDSV`, `NGAYGIONH`, `USERTIEPSINH`, `GCNHAPHOC`, `IsXNNH`

S3 · Hồ sơ nhập học / KTX

Hồ sơ nhập học / KTX

Verify document checklist and KTX option can be represented without requiring HP/RMS runtime.

checkedDocuments[]hoc_bacmnd

API: `POST /checkin/confirm`. · DB:

Document checklist itself is an API input for MVP; QLTS DB persistence available in current schema is `TTTNhapHoc.IsDKKTX` for KTX and `TDSTRTUYEN.GCNHAPHOC` fo

S4 · Xuất hand-off sang QLSV

Xuất hand-off sang QLSV

Mark eligible accepted students as exported and return result count without depending on QLSV runtime in MVP.

roundIdacceptedStudentIds[]

API: `POST /checkin/export-to-qlsv`. · DB:

QLTS-side export guard/result: `TDSTRTUYEN.IDDOTNVTS`, `IDSV`, `MaSV`, `IDLop`, `CHUYENQLSV`, `IsXNNH`, `NGAYGIONH`, `USERTIEPSINH`; accepted-list keys: `STTSVT

S5 · Fee hand-off boundary

Fee hand-off boundary

Ensure paid item controls do not imply QLTS owns HP/RMS writes.

paidItems[]

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: `POST /checkin/confirm`; no QLTS fee endpoint in `openapi.yaml`. · DB:

QLTS can only assert admission/check-in columns: `TDSTRTUYEN.BienLaiHP`, `NgayDong`, `ThuNH`, `GCNHAPHOC`, `IsXNNH`; fee module persistence is explicitly outsid