HP · UC-HP-01

UC-HP-01 — Cau hinh khoan thu / don gia

Cau hinh khoan thu / don gia. 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-01.md · Sample data (fake VN)

S1 · Tuition config: fee item list/filter

Tuition config: fee item list/filter

termCodeNHHKIDCapIDPhanCapIDDSVLoaiDGHPMucDGHPLoaiDTHP

termCode	NHHK	IDCap	IDPhanCap	IDDSV	LoaiDGHP
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 /api/v1/hp/tuition/fee-items?termCode={NHHK}` · DB:

`MDGHP.IDDGHP`, `MDGHP.NHHK`, `MDGHP.IDCap`, `MDGHP.IDPhanCap`, `MDGHP.IDDSV`, `MDGHP.LoaiDGHP`, `MDGHP.MucDGHP`, `MDGHP.LoaiDTHP`, `MDGHP.DonGiaHP`, `MDGHP.KyH

S2 · Tuition config: create/update fee item

Tuition config: create/update fee item

DonGiaHPDonGiaTamKyHieuTPGhiChuDGHPMaUser

API: `POST /api/v1/hp/tuition/fee-items` · DB: New/updated `MDGHP.IDDGHP`, `DonGiaHP`, `DonGiaTam`, `KyHieuTP`, `GhiChuDGHP`, `NgayThem`, `MaUser`

S3 · Discount / reduction rule smoke

Discount / reduction rule smoke

IDSVNHHKPhTramMGHPSoTienMGSoQDMGHPTrangThaiDuyetMGHP

API: Covered by `POST /api/v1/hp/tuition/fee-items` contract until a dedicated discount endpoint is split · DB:

`MMGHP.IDMGHP`, `MMGHP.IDSV`, `MMGHP.NHHK`, `MMGHP.PhTramMGHP`, `MMGHP.SoTienMG`, `MMGHP.SoQDMGHP`, `MMGHP.NgayQDMGHP`, `MMGHP.TrangThaiDuyetMGHP`; optional sub

S4 · Collection rule / accounting catalog

Collection rule / accounting catalog

MaLThuTenLThuMaCTThuTenCTThuMaTKThuTenTKThuTtLThuHuyLThuTTCTThuHuyCTThuTTTKThuHuyTKThu

API: `GET /api/v1/hp/tuition/collection-rules`, `POST /api/v1/hp/tuition/collection-rules` · DB:

`MDMLThu.IDLThu`, `MaLThu`, `TenLThu`, `LoaiDTHP`, `LoaiNgThu`; `MDMCTThu.IDCTThu`, `MaCTThu`, `TenCTThu`; `MDMTKThu.IDTKThu`, `MaTKThu`, `TenTKThu`, `IDCap`, `

S5 · Credit tuition milestone smoke

Credit tuition milestone smoke

IDMHNHHKMaUserIDDVPC

IDMH	NHHK	MaUser	IDDVPC
SV22010001	Nguyễn Văn An	CNTT-K18-01	Đang học
SV22010015	Trần Thị Bình	CNTT-K18-02	Tạm dừng
SV22010028	Lê Minh Châu	KT-K18-01	Đang học
SV22010042	Phạm Quốc Dũng	QTKD-K18-01	Nghỉ luôn
SV22010057	Hoàng Thu Hà	NN-K18-03	Đang học
SV22010063	Vũ Đức Khoa	CNTT-K18-01	Tốt nghiệp

API: Read through fee-item/config lookup · DB: `MMHHPTC.IDMHHPTC`, `MMHHPTC.IDMH`, `MMHHPTC.NHHK`, `MMHHPTC.NgayThem`, `MMHHPTC.MaUser`, `MMHHPTC.IDDVPC`