01 — Executive Overview & Problem Statement
Prior to SiMona Polban, dormitory operations at Politeknik Negeri Bandung relied on fragmented WhatsApp chats, manual spreadsheets, and physical logbooks across 2 dormitory buildings (48 rooms, 192 residents). Damage reports frequently lost tracking history, overnight permits lacked real-time curfew auditing, and quarterly rent + personal electronics tariff calculations required error-prone manual reconciliation.
Leading the upstream System Requirements & Domain Modeling and Frontend Monorepo Architecture, we designed a dual-interface platform: an installable, thumb-friendly Mobile PWA for dormitory residents and a high-density Web Management Dashboard for administrators and mentors.
02 — 3-Tier Monorepo System Architecture
Next.js 15, React 19 & MUI v6 PWA
Managed inside a Turborepo monorepo with shared UI primitives, delivering a desktop data-table dashboard for staff and an installable Mobile-First PWA with Service Workers for residents.
NestJS 11 Modular REST API
Strict modular domain boundaries enforcing RBAC guards (Admin, Mentor, Resident), automated tariff math, and rate limiting.
PostgreSQL & Prisma ORM
Type-safe relational schema governing rooms, cohorts, electronic assets, tickets, permits, and payment ledgers with automated daily database backups.
JWT HTTP-Only Cookies & Bcrypt
Dual-TTL session policies: 7-day persistent sessions on resident Mobile PWA vs 24-hour staff Web sessions with 60-minute idle auto-logout.
03 — Core Platform Modules (6 Domain Engines)
End-to-end operational modules uniting resident self-service and administrative governance:
Incident Ticketing & Facility Reporting Engine
Digital ticketing pipeline replacing unstructured chat logs with structured facility damage and behavioral violation workflows across 48 dormitory rooms.
- Supports photo evidence uploads (JPG/PNG up to 2MB) with client-side validation
- Emergency priority alerts and an Anonymous Toggle that masks reporter identity from public/staff views while preserving encrypted audit logs
- Strict state machine progression: PENDING → IN_PROGRESS → RESOLVED / REJECTED with mandatory rejection notes
Room Quota & Personal Inventory Governance
Spatial and asset management system governing 2 dormitory buildings (24 rooms per building, 48 rooms total, 4 residents per room).
- Enforces hard capacity guard of maximum 4 active residents per room before permitting check-in assignment
- Tracks room-level shared facility states (Good, Damaged, Under Repair) alongside resident-owned personal electronics
- Dynamic electronic item registration directly feeds the quarterly tariff calculation engine
Resident Profile & Population Lifecycle
Centralized population directory supporting multi-cohort student onboarding, role-based filtering, and historical offboarding.
- Supports 3 scholarship & program tracks (KIP-K, ADik, and Regular cohorts) with automated billing exemptions
- Soft-delete offboarding architecture vacating room slots without breaking historical ticket or payment foreign keys
- Self-service profile onboarding requiring emergency contact and study program verification on first login
Digital Leave & Late-Return Permit Workflow
End-to-end digital curfew and overnight leave authorization replacing paper logbooks with timestamped approval trails.
- Validates temporal integrity (return date strictly >= departure date) before queueing permits for mentor review
- Real-time approval/rejection dispatch with mandatory rejection notes and automated curfew monitoring
- Auto-flags overdue status when a resident passes their approved return timestamp without check-in confirmation
Quarterly Rent & Electronics Tariff Verification
Automated billing calculation and manual transfer receipt verification dashboard for quarterly dormitory rent cycles.
- Automatic tariff formula: Total Quarterly Bill = (Base Monthly Rent + (Registered Electronics × Rp 20,000)) × 3 Months
- Automated Rp 0 exemption tagging for KIP-K and ADik scholarship residents while preserving full audit trails
- Side-by-side receipt inspection modal converting transfer proof status from PENDING to VERIFIED or REJECTED
Targeted Broadcast & Announcement CMS
Role-aware bulletin publisher delivering urgent operational notices to targeted dormitory buildings or the entire resident population.
- Granular target-audience routing (All Residents, Building A Only, or Building B Only)
- Supports PDF circular attachments and priority pinning to the top of the resident mobile PWA feed
- Scheduled auto-archiving after expiration dates to keep the resident dashboard clutter-free
04 — Performance & Operational Targets
Key responsiveness and concurrency benchmarks engineered across the web and mobile PWA interfaces:
≤ 3.0 Seconds
Maximum initial load time for Resident Mobile PWA over standard 4G connections.
≤ 2.0 Seconds
Maximum server query & table render latency for Admin dashboards on campus Wi-Fi.
300+ Sessions
Simultaneous active sessions supported without degradation during peak curfew hours.
