SMS · UC-SMS-03

UC-SMS-03 — Diem danh / sinh vien vang

Diem danh / sinh vien vang based on legacy SMS source. This UC assumes `SDMSV`/`SSVHK` hub data already exists and does not require QLTS runtime.

Nguồn: docs/modules/sms/use-cases/UC-SMS-03.md · Sample data (fake VN)

S1 · Legacy `S7`; remake attendance session list

Legacy S7; remake attendance session list

Load attendance sessions by term/schedule context.

termCodeNHHKkeywordIDToHocIDTKBNgayHocThuTietBDSoTietIDPhongIDDiemDanhNgayGioDiemDanhHoTenNVDiemDanhGCDiemDanh

termCode	NHHK	keyword	IDToHoc	IDTKB	NgayHoc
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 /attendance/sessions`. · DB:

`SDiemDanh.IDDiemDanh`, `NHHK`, `IDTKB`, `NgayHoc`, `Thu`, `TietBD`, `SoTiet`, `IDPhong`, `IDToHoc`, `NgayGioDiemDanh`, `HoTenNVDiemDanh`, `GCDiemDanh`.

S2 · Legacy `S7`; remake create session dialog

Legacy S7; remake create session dialog

Create or update a teaching/attendance header.

termCodeIDTKBIDToHocIDNVDiemDanhHoTenNVDiemDanhNoiDungGDSoTietGDURLZoomIDZoom dryRun

API: `POST /attendance/sessions`. · DB:

`SDiemDanh.NHHK`, `IDTKB`, `IDToHoc`, `NgayGioDiemDanh`, `IDNVDiemDanh`, `HoTenNVDiemDanh`, `NoiDungGD`, `SoTietGD`, `URLZoom`, `IDZoom`, `NgayThem`, `MaUser`.

S3 · Legacy `SaveDSSinhVienVang`; remake student attendance grid

Legacy SaveDSSinhVienVang; remake student attendance grid

Mark absent/late/early and persist row-level notes.

sessionIdstudentIdsTrangThaiDiemDanhNgayGioVaoLopSoPhutVaoTreSoPhutVeSomDSTietCoHocGCSVDiemDanh

sessionId	studentIds	TrangThaiDiemDanh	NgayGioVaoLop	SoPhutVaoTre	SoPhutVeSom
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: `PUT /attendance/sessions/{sessionId}/students`. · DB:

`SSVDiemDanh.IDSVDiemDanh`, `IDDiemDanh`, `IDSV`, `TrangThaiDiemDanh`, `NgayGioVaoLop`, `SoPhutVaoTre`, `SoPhutVeSom`, `DSTietCoHoc`, `GCSVDiemDanh`; roster che

S4 · GAP - timetable lookup columns

GAP - timetable lookup columns

SMS docs reference SCH/`KTKB*` context but this UC file does not include full timetable table columns.

SDiemDanh

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: `GET /attendance/sessions`, `POST /attendance/sessions`. · DB: `SDiemDanh.IDTKB`, `IDToHoc`; add `KTKB*` field map from SCH docs before 1:1 timetable smoke.