Skip to content

About

A modern boarding house management system built with Laravel 11 — manage rooms, tenants, contracts, utility bills, and payments in one platform.

Topics

Resources

Stars

12 stars

Watchers

0 watching

Forks

Repository files navigation

Boarding House Management

Modern Boarding House Management Platform

Laravel PHP Blade Tailwind MySQL License


Boarding House Management System

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.


Project Structure

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

Core Modules

Room Management

  • Room listing & details
  • Room status tracking (available, occupied, maintenance)
  • Room type management
  • Room pricing configuration

Tenant Management

  • Tenant profiles
  • ID card & contact information
  • Tenant status tracking
  • Tenant history

Contract Management

  • Create & manage rental contracts
  • Contract start / end dates
  • Deposit tracking
  • Contract renewal & termination

Utility Management

  • Monthly electricity meter readings
  • Monthly water meter readings
  • Utility usage history
  • Automatic calculation

Invoice Management

  • Auto-generate monthly invoices
  • Room fee + electricity + water + services
  • Invoice status tracking
  • Payment history

Payment Management

  • Record payments
  • Outstanding debt tracking
  • Payment receipts
  • Revenue overview

Service Management

  • Additional services (internet, parking, cleaning)
  • Service pricing
  • Service assignment per room

Reports & Statistics

  • Monthly revenue reports
  • Vacant room reports
  • Debt reports
  • Occupancy statistics

Technology Stack

Backend

Technology Version Description
Laravel 11.x PHP Framework
PHP 8.2+ Backend Language
MySQL 8+ Database
Vite Latest Frontend Build Tool

Frontend

Technology Description Version
Blade Template Engine Latest
Tailwind CSS UI Framework 3.x
Alpine.js Frontend Interaction Latest
JavaScript Frontend Logic ES6+

Installation Guide

Requirements

Recommended environment:

  • PHP >= 8.2
  • Composer >= 2.x
  • MySQL >= 8.x
  • Node.js >= 18
  • NPM >= 9

Installation

1. Clone Repository

git clone https://github.com/scoppy9201/boarding-house-management.git
cd boarding-house-management

2. Install Dependencies

composer install
npm install

3. Configure Environment

cp .env.example .env
php artisan key:generate

Update database configuration:

DB_DATABASE=boarding_house
DB_USERNAME=root
DB_PASSWORD=

4. Run Migration & Seeder

php artisan migrate:fresh --seed

5. Start Development Server

php artisan serve
npm run dev

Visit:

http://127.0.0.1:8000

Authentication & Authorization

  • Custom authentication pages
  • Session-based authentication
  • Role & permission system (Admin / Staff)
  • Extendable RBAC architecture

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

Use Cases

This system is suitable for:

  • Boarding house & dormitory management
  • Apartment rental management
  • Small-scale property management
  • Academic & graduation projects

Roadmap

Upcoming planned features:

  • Tenant mobile app
  • Online payment integration
  • Maintenance request tracking
  • SMS / Email notifications
  • Advanced analytics dashboard
  • Multi-property support

Contributing

Contributions are welcome.

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to your branch
  5. Open a Pull Request

License

MIT License


Links


Built with ❤️ using Laravel 11 & Blade

About

A modern boarding house management system built with Laravel 11 — manage rooms, tenants, contracts, utility bills, and payments in one platform.

Topics

Resources

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages