Skip to content

youssefhamdy7dev/fath-company

Repository files navigation

🏢 Fath Company – Management System

Fath Company is a custom-built business management system developed using Laravel, designed to manage daily operations related to customers, trucks, purchases, inventory, and financial tracking.

This project reflects a real-world business workflow and focuses on clean backend architecture, performance, and maintainability.

🌐 Live Demo:
👉 http://al-fath-company.great-site.net


🚀 Features

👥 Customer Management

  • Add, edit, and manage customers
  • Track customer balances and transactions

🚚 Truck & Logistics Management

  • Manage trucks and their operational status
  • Track finished and unfinished truck operations
  • Optimized pagination and filtering

📦 Purchases & Inventory

  • Record customer purchases
  • Track box classes, quantities, and prices
  • Automatic calculations for totals and summaries

💰 Financial Tracking

  • Accurate balance calculations
  • Date-based filtering for transactions
  • Clear financial records per customer

🖥 User Interface

  • Blade templating engine
  • AJAX-based filtering and pagination
  • Arabic language support
  • Responsive and clean UI
  • Designed and implemented to align closely with user requirements and expectations

🛠 Tech Stack

  • Backend: PHP 8.x, Laravel
  • Frontend: Blade, HTML, CSS, Bootstrap5.3x ,JavaScript, AJAX
  • Database: MySQL
  • Version Control: Git & GitHub
  • Local Environment: XAMPP / Laravel Artisan

📂 Project Structure Highlights

  • MVC architecture (Models, Views, Controllers)
  • Form Request validation
  • Eloquent relationships
  • Reusable Blade components
  • Clean and readable codebase

⚙️ Installation (Local Setup)

  1. Clone the repository:
    git clone https://github.com/youssefhamdy7dev/fath-company.git
  2. Navigate to the project directory:
    cd fath-company
  3. Install dependencies:
    composer install
  4. Copy environment file:
    cp .env.example .env
  5. Generate application key:
    php artisan key:generate
  6. Configure your database credentials in .env Run migrations: bash php artisan migrate
  7. Start the development server:
    php artisan serve

🎯 Project Goals

  • Build a real-world Laravel application
  • Apply best practices in backend development
  • Demonstrate professional Laravel skills
  • Provide a scalable foundation for future features

🔮 Future Improvements

  • Authentication & role-based access
  • Advanced reporting (PDF / Excel export)
  • REST API for mobile or third-party integrations
  • Improved UI/UX
  • Docker & cloud deployment

👨‍💻 Author

Youssef Hamdy Ahmed Mohamed


About

A local business management system for a fruit stock house located in Dar El-Salam, Cairo, Egypt.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors