# Car Repairs Shop

A modern Laravel-based application for managing car repair shop operations, built with Livewire, Volt, and Flux UI. This project streamlines customer management, appointments, inventory, service orders, technician management, and reporting.

## Features
- Customer and Vehicle Management
- Appointment Scheduling
- Service Orders and Estimates
- Inventory and Parts Tracking
- Technician Performance and Skills
- Timesheets and Work Orders
- Dashboard and Analytics
- Role-based Permissions
- Notifications

## Tech Stack
- **Backend:** Laravel 12, PHP 8.2
- **Frontend:** Livewire, Volt, Flux UI, Tailwind CSS, Vite
- **Database:** MySQL (default), SQLite (for testing)
- **Testing:** PHPUnit

## Installation
1. **Clone the repository:**
   ```bash
   git clone https://git.safetracksystems.com/sackey/Car-Repairs-Shop.git
   cd Car-Repairs-Shop
   ```
2. **Install PHP dependencies:**
   ```bash
   composer install
   ```
3. **Install Node.js dependencies:**
   ```bash
   npm install
   ```
4. **Copy environment file and set up keys:**
   ```bash
   cp .env.example .env
   php artisan key:generate
   ```
5. **Configure your database in `.env`**
6. **Run migrations and seeders:**
   ```bash
   php artisan migrate --seed
   ```
7. **Build frontend assets:**
   ```bash
   npm run build
   ```
8. **Start the development server:**
   ```bash
   php artisan serve
   ```

## Usage
- Access the app at `http://localhost:8000`
- Login/register and start managing your car repair shop

## Testing
Run all tests with:
```bash
./vendor/bin/phpunit
```

## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

## License
MIT