Car-Rental-php

Complete README documentation

Car Rental System - Laravel 11

Modern car rental management system built with Laravel 11, featuring multi-language support, real-time currency conversion, and comprehensive vehicle management.

Features

  • 🚗 Vehicle Management - Complete CRUD operations for car fleet
  • 💰 Dynamic Pricing - Real-time currency conversion with TCMB integration
  • 🌍 Multi-language - Turkish and English support
  • 👥 User Management - Role-based access control (Admin/User)
  • 📊 Order System - Guest and authenticated user orders
  • 📧 Contact Forms - Customer inquiry management
  • 🎨 Modern UI - Clean, responsive design with green theme
    Project

Tech Stack

  • Framework: Laravel 11
  • Database: MySQL 8.4
  • Cache: Redis 7
  • Frontend: Bootstrap 3, jQuery, Owl Carousel
  • Containerization: Docker & Docker Compose

Installation

Prerequisites

  • Docker & Docker Compose
  • Git

Quick Start

  1. Clone the repository
git clone <your-repo-url>
   cd car-rental-laravel
  1. Copy environment file
cp .env.example .env
  1. Update .env file

    • Set your APP_KEY (or run php artisan key:generate later)
    • Configure database credentials
    • Update other settings as needed
  2. Start Docker containers

docker-compose up -d
  1. Install dependencies & setup
docker-compose exec app composer install
   docker-compose exec app php artisan key:generate
   docker-compose exec app php artisan storage:link
   docker-compose exec app php artisan migrate --seed
  1. Access the application

Default Credentials

After seeding, you can login with:

Project Structure

car-rental-laravel/
├── app/
│   ├── Http/Controllers/     # Controllers
│   ├── Models/               # Eloquent models
│   └── Services/             # Business logic services
├── database/
│   ├── migrations/           # Database migrations
│   └── seeders/             # Data seeders
├── resources/
│   └── views/               # Blade templates
├── routes/                  # Application routes
├── public/                  # Public assets
└── docker-compose.yml       # Docker configuration

Development

Running Artisan Commands

docker-compose exec app php artisan <command>

Viewing Logs

docker-compose exec app tail -f storage/logs/laravel.log

Database Access

docker-compose exec db mysql -uroot -proot car_rental

Color Palette

The application uses a soft, clean green-based theme:

  • Primary Green: #29ca8e
  • Secondary Green: #1dbf73
  • Dark Green (text): #1a7f5a

Turkish Character Support

Full UTF-8 support for Turkish characters (ç, ğ, ı, ö, ş, ü).

License

This project is open-sourced software.

Support

For issues and questions, please open an issue in the repository.