🔧 Plomberie Pro — Tanger Plomberie

SaaS-Ready Management Platform & Professional Showcase for plumbing services. Built with a high-fidelity "Hard Edges" design system, optimized for performance and conversion.

📋 Table of Contents

• 🌟 Project Vision
• ✨ Key Features
• 🛠️ Tech Stack
• 🚀 Quick Start
• 📁 Project Architecture
• 💻 Development Workflow
• 📄 License

🌟 Project Vision

Plomberie Pro is more than just a website; it's a comprehensive management ecosystem for plumbing professionals. It combines a premium landing page for customer acquisition with a robust admin dashboard and client portal for operations management.

The platform is designed with a "Hard Edges" aesthetic — prioritizing clarity, high data density, and cinematic visuals.

✨ Key Features

🏢 Infrastructure

• Role-Based Access (RBAC): Fine-grained permissions (Admin, Technician, Client) via Spatie.
• Inertia.js Integration: Seamless SPA experience using Laravel backend with React frontend.
• Responsive Design: Mobile-first "Hard Edges" UI optimized for field technicians and desktop admins.

🛠️ Core Modules

• Service Management: Dynamic service catalog with real-time image previews and slug-based routing.
• Booking System: Comprehensive appointment scheduling with status tracking and logs.
• Intervention Tracking: Digital records for on-site plumbing interventions.
• Portfolio (Projects): High-fidelity gallery to showcase completed work and build trust.
• Client Portal: Dedicated space for clients to track their history and requests.

🛠️ Tech Stack

Backend

• Framework: Laravel 12.0
• Language: PHP 8.2+
• Database: MySQL / SQLite (Development)
• Auth: Laravel Breeze + Sanctum
• Packages: spatie/laravel-permission, tightenco/ziggy

Frontend

• Library: React 18
• Styling: Tailwind CSS 4.0 (Vite integration)
• Animations: Framer Motion & React Spring
• Icons: Lucide React
• State Management: Inertia.js (Server-driven state)

🚀 Quick Start

Prerequisites

• PHP 8.2+
• Composer
• Node.js 18+ & npm
• A local database (MySQL or SQLite)

Installation

# 1. Clone the repository
git clone https://github.com/BenTaleb-Mehdi/plomberie-pro.git
cd plomberie-pro/plomberie-app

# 2. Install dependencies
composer install
npm install

# 3. Environment Setup
cp .env.example .env
php artisan key:generate

# 4. Database Setup
# If using SQLite:
touch database/database.sqlite
php artisan migrate --seed

# 5. Build Assets & Start
npm run dev
# In another terminal:
php artisan serve

📁 Project Architecture

plomberie-pro/
├── plomberie-app/          # Core Laravel Application
│   ├── app/                # PHP Logic (Models, Controllers, Services)
│   ├── database/           # Migrations, Seeders & Factories
│   ├── resources/
│   │   ├── js/             # React Components & Pages
│   │   └── css/            # Global Styles (Tailwind 4)
│   ├── routes/             # Web & API Routes
│   ├── tests/              # Feature & Unit Tests
│   └── vite.config.js      # Build configuration
└── README.md

💻 Development Workflow

Useful Commands

📄 License

This project is licensed under the MIT License.

<div align="center"> _{Crafted with precision by <b>BenTaleb Mehdi</b>} </div>