HP · UC-HP-02

UC-HP-02 — Tinh hoc phi tu dong

Tinh hoc phi tu dong. This UC owns tuition/receivable/payment data and only reads SMS/QLSV/SRM/QLTS as integration context.

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

S1 · Tuition calculation: preview

Tuition calculation: preview

termCodeNHHKstudentIdsIDSVdryRun=trueIDMHKyHieuTPLoaiDTHPIDNhCT

API: `POST /api/v1/hp/tuition/calculate/preview` · DB:

No write expected; response must be reconcilable to source config `MDGHP.NHHK`, `MDGHP.LoaiDGHP`, `MDGHP.MucDGHP`, `MDGHP.DonGiaHP`, `MDMLThu.LoaiDTHP` and exis

S2 · Tuition calculation: commit

Tuition calculation: commit

dryRun=falseIDSVNHHK

API: `POST /api/v1/hp/tuition/calculate` then `GET /api/v1/hp/tuition/calculations/{calculationId}?termCode={NHHK}` · DB:

`MHPCT.IDHPCT`, `NHHK`, `IDSV`, `IDMH`, `KyHieuTP`, `NhomHoc`, `ToHoc`, `LoaiDTHP`, `IDNgThu`, `DonGiaHPCT`, `HeSoHP`, `ThanhTien`, `PhaiThu`, `TienPhat`, `SoTC

S3 · Student-level discount / override

Student-level discount / override

PTMGCSSoTienGiamTTMienGiamXLCoGiamSoTienGCMienGiam

API: Reflected in calculation preview/commit totals · DB:

`MHPCTSV.IDHPCTSV`, `IDSV`, `NHHK`, `PTMGCS`, `SoTienGiam`, `TTMienGiam`, `XLCoGiamSoTien`, `XLCoGiamCS`, `GCMienGiam`, `NgayThem`, `MaUser`

S4 · Calculation audit trail

Calculation audit trail

keywordtermCode

API: `GET /api/v1/hp/tuition/calculations/{calculationId}` · DB:

`MLogHPCT.IDLogHP`, `IDHPCT`, `NHHK`, `IDSV`, `IDMH`, `LoaiDTHP`, `LoaiDGHP`, `MucDGHP`, `DonGiaHPCT`, `ThanhTien`, `TTienPT`, `TTienMG`, `PhaiThu`, `AcctionLog

S5 · Numbering / report side effect

Numbering / report side effect

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: Covered by calculate response/report metadata · DB: `MBoDemHP.IDBoDemHP`, `IDCap`, `IDPhanCap`, `IDNhCT`, `IDBoDem`, `IDSubReport`, `IDSubReportHoan`, `MaUser`, `NgayThem`