An enterprise full-stack platform built for INTI Nilai Campus. Engineered with transactional bed allocations, automated PDFKit invoicing, Malaysian FPX mock checkout, and real-time maintenance workflows.
Interactive matrix for INTI Nilai campus accommodation. Select a residential hall to inspect room capacity, inventory, and tier pricing.
Executive private single rooms. Designed for postgraduates and final-year scholars seeking dedicated quiet study environments.
Complete end-to-end automation from student registration to checkout reconciliation.
Real-time occupancy KPIs, revenue collection tracking, bed status breakdowns, and block-by-block financial visualizers.
PostgreSQL SELECT ... FOR UPDATE transactional row-locking and partial unique indexes to completely eliminate double-booking.
Dynamic fee generation based on room capacity and air-conditioning tiers with one-click official downloadable A4 PDF tax invoices.
Full checkout simulation supporting 9 Malaysian online banking portals (Maybank2u, CIMB Clicks, Public Bank, etc.) and Credit/Debit cards.
Categorized issue reporting (Electrical, Plumbing, AC, Furniture) with automatic warden assignment and real-time status transitions.
Instant notice broadcast engine with targeted filters for university-wide, hall-specific, or single-student emergency communications.
INTI-HMS calculates per-student fees dynamically by dividing the room base rate by its bed capacity.
Twin Room on Floor 3 (Air-Conditioned). Base rate RM 1,200 divided equally between 2 occupants.
Test any user role immediately with pre-configured mock data and granular access privileges.
Full system control: staff account provisioning, bed matrix editing, invoicing, financial audits, and reporting.
Operational access: student check-ins, bed assignments, counter cash collections, and complaint resolutions.
Resident portal: active room pass, fee ledger, online FPX checkout, PDF receipt download, and ticket filing.
Engineered for low-latency responsiveness, high concurrency safety, and zero external runtime dependencies.
Follow these simple steps to run the complete environment locally.
# 1. Clone repository & enter directory
git clone https://github.com/IsaacDavid2012/hostelmanagementsystem.git hostelms
cd hostelms
# 2. Seed PostgreSQL schema & demo dataset (50+ students, 360 beds)
cd backend && npm install && npm run seed && cd ..
# 3. Launch both Backend (Port 5200) and Frontend (Port 5173)
./start.sh
✓ Backend running on http://localhost:5200
✓ Frontend running on http://localhost:5173
✓ Cloudflare Live Tunnel on https://hms.creativeclicks.art