SCH · UC-SCH-02

UC-SCH-02 — Xep TKB tu dong / thu cong

Xep TKB tu dong / thu cong. This UC is contract-ready for implementation baseline; full 1:1 requires the blocker checks below.

Nguồn: docs/modules/sch/use-cases/UC-SCH-02.md · Sample data (fake VN)

S1 · Generate timetable

Generate timetable

termCode dryRun

API: `POST /timetable/generate` with `dryRun=true`, then controlled generate in dev · DB:

`KTKB`: `IDTKB`, `NHHK`, `IDToHop`, `Thu`, `TietBD`, `SoTiet`, `IDPH`, `SoThuTu`, `IDLoaiTG`, `KhgXetTKBLop`, `KhgXetTKBPh`, `KhgXetTKBCB`, `IsCongBo`; `KTKBTua

S2 · Manual session edit

Manual session edit

keywordtermCode

API: `PUT /timetable/sessions/{sessionId}` · DB:

`KTKBLog`: `IDTKBLog`, `IDTKB`, `IDToHop`, `Thu`, `TietBD`, `SoTiet`, `SoThuTu`, `IDPH`, `NHHK`, `IsCongBo`, `MaUser`; `KToHopTKBSS`: `IDTHTKBSS`, `IDTKB`, `NHH

S3 · Split/merge class session

Split/merge class session

keywordtermCode

API: `POST /timetable/sessions/{sessionId}/split-merge` · DB:

`KGhepLop`: `IDGhepLop`, `NHHK`, `IDLop`, `KHGhLop`; `KGhepLopMH`: `IDGhepLopMH`, `IDLop`, `IDMH`, `NHHK`, `KHGhLopMH`, `IDMHDK`, `KHGhep`; `KTachLopMH`: `IDTac

S4 · True gaps

True gaps

keywordtermCode

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: Endpoint contract exists but final generation payload/result schema is generic · DB: `DULIEUXEPTKBTUDONGDA` automatic scheduling algorithm is DLL-only; parity cannot be asserted from docs alone