Catering Tracker - Financial Record Management System

This is a Laravel 11 application for managing catering and payment records.

Prerequisites

• PHP 8.3 or higher
• Composer
• MySQL 8+
• Node.js and npm (for frontend assets)

Installation

1. Install PHP 8.3 from https://windows.php.net/download

   • Download the ZIP file for PHP 8.3.x
   • Extract to a folder, e.g., C:\php
   • Add C:\php to your PATH environment variable

2. Install Composer from https://getcomposer.org/download/

   • Download and run the installer

3. Clone or download this project to your workspace

4. Run composer install to install PHP dependencies

5. Copy .env.example to .env and configure your database settings:

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=catering_tracker
   DB_USERNAME=your_username
   DB_PASSWORD=your_password
   

6. Run php artisan key:generate

7. Run php artisan migrate to create database tables

8. Install Laravel Breeze: php artisan breeze:install blade

9. Install Livewire: composer require livewire/livewire

10. Install Laravel Excel: composer require maatwebsite/excel

11. Install DomPDF: composer require barryvdh/laravel-dompdf

12. Run npm install to install frontend dependencies

13. Run npm run build or npm run dev for assets

14. Run php artisan serve to start the development server

Features Implemented

• Role-based authentication (Superadmin, Admin)
• Member management (CRUD)
• Transaction management (CRUD) with auto-calculations
• Payment management (CRUD)
• CSV import/export
• PDF export
• Analytics dashboard with Chart.js
• Week grouping logic
• Caching for performance

Database Schema

• users: Admin accounts with role
• members: Registered members
• transactions: Expense records
• payments: Deposit records
• weeks: Week groupings
• mutasi: Active members per week

Usage

• Register/Login as admin or superadmin
• Manage members, transactions, payments
• Import CSV data
• View dashboard analytics
• Export data to CSV or PDF

Next Steps

• Implement audit logging for imports
• Add undo feature for imports
• Create full views for CRUD operations
• Add Livewire for reactive updates
• Test all functionalities