Modern Boarding House Management Platform
Boarding House Management is a modern open-source system built with Laravel 11.
The project focuses on modular architecture, clean UI design, scalability, and developer experience.
The system helps landlords manage rooms, tenants, contracts, utility bills, and payments in a centralized platform.
boarding-house-management
├── app
│ ├── Http
│ │ ├── Controllers # Request handlers
│ │ └── Middleware # Authentication middleware
│ ├── Models # Eloquent models
│ └── Services # Business logic services
├── database
│ ├── migrations # Database schema
│ └── seeders # Sample data
├── resources
│ ├── views # Blade templates
│ └── css / js # Frontend assets
├── routes
│ └── web.php # Route definitions
└── public # Static assets- Room listing & details
- Room status tracking (available, occupied, maintenance)
- Room type management
- Room pricing configuration
- Tenant profiles
- ID card & contact information
- Tenant status tracking
- Tenant history
- Create & manage rental contracts
- Contract start / end dates
- Deposit tracking
- Contract renewal & termination
- Monthly electricity meter readings
- Monthly water meter readings
- Utility usage history
- Automatic calculation
- Auto-generate monthly invoices
- Room fee + electricity + water + services
- Invoice status tracking
- Payment history
- Record payments
- Outstanding debt tracking
- Payment receipts
- Revenue overview
- Additional services (internet, parking, cleaning)
- Service pricing
- Service assignment per room
- Monthly revenue reports
- Vacant room reports
- Debt reports
- Occupancy statistics
| Technology | Version | Description |
|---|---|---|
| Laravel | 11.x | PHP Framework |
| PHP | 8.2+ | Backend Language |
| MySQL | 8+ | Database |
| Vite | Latest | Frontend Build Tool |
| Technology | Description | Version |
|---|---|---|
| Blade | Template Engine | Latest |
| Tailwind CSS | UI Framework | 3.x |
| Alpine.js | Frontend Interaction | Latest |
| JavaScript | Frontend Logic | ES6+ |
Recommended environment:
- PHP >= 8.2
- Composer >= 2.x
- MySQL >= 8.x
- Node.js >= 18
- NPM >= 9
git clone https://github.com/scoppy9201/boarding-house-management.git
cd boarding-house-managementcomposer install
npm installcp .env.example .env
php artisan key:generateUpdate database configuration:
DB_DATABASE=boarding_house
DB_USERNAME=root
DB_PASSWORD=php artisan migrate:fresh --seedphp artisan serve
npm run devVisit:
http://127.0.0.1:8000
- Custom authentication pages
- Session-based authentication
- Role & permission system (Admin / Staff)
- Extendable RBAC architecture
The system follows a modern modular architecture:
- Service-based architecture
- Reusable Blade components
- Clean separation of concerns
- Scalable business logic
Main architecture layers:
- Controllers
- Services
- Models
- Blade Components
- Views
This system is suitable for:
- Boarding house & dormitory management
- Apartment rental management
- Small-scale property management
- Academic & graduation projects
Upcoming planned features:
- Tenant mobile app
- Online payment integration
- Maintenance request tracking
- SMS / Email notifications
- Advanced analytics dashboard
- Multi-property support
Contributions are welcome.
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to your branch
- Open a Pull Request
MIT License