๐ฝ๏ธ Meal Management System
๐ Overview
The Meal Management System is a web-based application that helps manage meals, expenses, and deposits for shared living environments such as bachelor messes, hostels, and dormitories. It automates calculations and ensures transparency for all members.
๐ฏ Why Use This System?
- Avoid manual calculation errors
- Track meals and expenses easily
- Calculate fair meal rates automatically
- View clear monthly summaries
๐งฐ Technology Used
- Backend: PHP (Laravel)
- Frontend: Blade, HTML, CSS, JavaScript
- Database: MySQL
- Authentication: Laravel Auth
โจ Key Features
๐ค Member Management
- Add, edit, or remove members
- Activate or deactivate members
๐ฝ๏ธ Meal Management
- Daily meal entry
- Automatic total meal calculation
๐ฐ Expense Management
- Add daily or monthly expenses
- Automatic expense total
๐ณ Deposit Management
- Record member deposits
- Track balance and due
๐ Automatic Calculation
Meal Rate = Total Expenses / Total Meals
Member Cost = Member Meals ร Meal Rate
๐ Reports
- Monthly summary
- Individual member report
๐ Security
- Secure login system
- Admin-only access
โ๏ธ Installation (Quick Guide)
Requirements
- PHP 8.0+
- Composer
- MySQL
- Node.js & NPM
Setup Steps
git clone https://github.com/theshakhawathosen/Meal-Management-System.git
cd Meal-Management-System
composer install
npm install && npm run build
Create database and import SQL:
CREATE DATABASE meal_management;
mysql -u username -p meal_management < mealmanager.sql
Configure environment:
cp .env.example .env
php artisan key:generate
php artisan serve
Open in browser:
http://127.0.0.1:8000
๐ How to Use
- Login as admin
- Add members
- Enter daily meals
- Add expenses and deposits
- View monthly reports
๐๏ธ Project Structure
app/
database/
resources/
routes/
public/
mealmanager.sql
README.md
๐ Future Improvements
- PDF reports
- Mobile-friendly UI
- Charts & analytics
- Role-based access
๐งพ Credits
Developer: Shakhawat Hosen GitHub: https://github.com/theshakhawathosen
๐ License
MIT License
โญ Star the repository if you find it useful.