ce-aavoryi8125-bot/Hostel_Hub

Hostel Hub is a student accommodation discovery platform designed for students of the University of Mines and Technology (UMaT) in Tarkwa, Ghana. The platform helps students browse nearby hostels, compare room options and prices, and connect with hostel agents for tours and booking support. # 🏠 Hostel Hub v4 **Premium Student Hostel Management Platform — UMaT Tarkwa** Three completely independent portals: **Student** | **Hostel Manager** | **Administrator** --- ## Quick Start ```bash npm install npm start # → localhost ``` --- ## ⚠️ Required: Run Database Migration Before using the platform, you **must** run the migration SQL in your Supabase dashboard: 1. Go to **Supabase Dashboard → SQL Editor → New Query** 2. Open `supabase/MIGRATION_REQUIRED.sql` 3. Paste the contents and click **Run** This adds required columns (`status`, `verification_status`, `is_published`, etc.) and creates audit/log tables. > The app works without the migration but with reduced functionality (manager approval workflow, hostel verification, payment methods, audit logs). --- ## Demo Credentials | Role | Email | Password | |------|-------|----------| | Administrator | admin@hostelhub.dev | admin123 | | Hostel Manager | manager@hostelhub.dev | manager123 | | Student | Sign up on the platform | — | --- ## Role-Based Portals ### 🎓 Student Portal - Browse and search verified hostels - Book rooms and submit payment proof - Download official receipts - Submit maintenance requests - View announcements and notifications - Manage profile ### 🏢 Manager Portal - Dashboard with occupancy and financial summary - Manage residents (add/remove/view) - Manage rooms and availability - Verify student payment submissions → auto-generates receipts - Log expenses and track finances - Send announcements to residents - Handle maintenance requests - Configure payment methods (bank, MoMo) ### 🛡️ Administrator Portal - Platform-wide statistics dashboard - **Hostel management**: create, verify, publish, assign managers - **Manager applications**: review → approve/reject → assign to hostels - **User management**: students, managers, admins - **Verification queue**: approve pending hostels - **Audit log**: complete trail of all admin actions - Platform announcements - Payment o …