💈 Saloon Booking Application

💈 Comprehensive SaaS Saloon & Spa Booking Platform featuring Multi-Tenant Laravel Backend, Flutter Customer Mobile App, and Flutter Salon Owner App.

---

📖 Table of Contents

• 🌟 Architecture Overview
• 📱 Applications & Modules
• ✨ Key Features
• 🛠️ Tech Stack
• 🚀 Getting Started
  • Backend Setup (Laravel)
  • Customer Mobile App Setup (Flutter)
  • Salon Owner App Setup (Flutter)
• 🔒 Security & Zero-Trust Governance
• 📄 License

---

🌟 Architecture Overview

The Saloon Booking Application ecosystem is architected as a complete multi-tenant booking and management solution:

                               ┌─────────────────────────────┐
                               │     Laravel REST API        │
                               │   (Multi-Tenant Backend)    │
                               └──────────────┬──────────────┘
                                              │
                     ┌────────────────────────┴────────────────────────┐
                     ▼                                                 ▼
      ┌─────────────────────────────┐                   ┌─────────────────────────────┐
      │     Customer Mobile App     │                   │     Salon Owner App         │
      │       (Flutter / Dart)      │                   │     (Flutter / Dart)        │
      ├─────────────────────────────┤                   ├─────────────────────────────┤
      │ • Browse salons & stylists  │                   │ • Real-time calendar schedule│
      │ • Instant slot booking      │                   │ • Staff & service assignment │
      │ • Live appointment tracking │                   │ • Earnings & financial ledger│
      │ • Payment integration       │                   │ • Customer CRM & analytics   │
      └─────────────────────────────┘                   └─────────────────────────────┘

---

📱 Applications & Modules

Module	Directory	Technology	Description
Backend API	/backend	Laravel / PHP	Multi-tenant core API, MySQL database, booking engine, and auth services.
Customer App	/customer_app	Flutter / Dart	Native iOS & Android app for clients to discover salons, select services, and book slots.
Owner App	/owner_app	Flutter / Dart	Dedicated management console for salon owners, staff management, and appointment rosters.
Documentation	/docs	Markdown / PRD	Product Requirement Documents (PRD), architectural specs, and API contracts.

---

✨ Key Features

• 📅 Real-Time Booking & Slot Management: Dynamic time-slot reservation with double-booking prevention and instant confirmation.
• 👥 Multi-Tenant Salon CRM: Supports multiple salon locations, individual stylist rosters, service pricing tiers, and operating hours.
• 📊 Owner Dashboard & Ledger: Visual analytics on daily appointments, revenue charts, staff commissions, and customer retention.
• 🔔 Notifications & Reminders: Automated push notifications and booking status updates.
• 🛡️ Zero-Trust Security: Built with strict environment variable isolation, sanitized API endpoints, and role-based permissions (RBAC).

---

🛠️ Tech Stack

• Mobile Clients: Flutter 3.x, Dart 3.x, Provider / Riverpod state management.
• Backend API: Laravel 11.x, PHP 8.2+, Eloquent ORM.
• Database: MySQL / PostgreSQL with full relational migrations.
• Security & Pipeline: DevPulse AI Security Core, SHA-256 Audit Trail.

---

🚀 Getting Started

Prerequisites

• Flutter SDK (>= 3.19.0)
• PHP (>= 8.2) & Composer
• MySQL or Docker

---

1. Backend Setup (Laravel)

cd backend
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve

The API will be available at http://localhost:8000.

---

2. Customer Mobile App Setup (Flutter)

cd customer_app
flutter pub get
flutter run

---

3. Salon Owner App Setup (Flutter)

cd owner_app
flutter pub get
flutter run

---

🔒 Security & Zero-Trust Governance

• Zero Plaintext Secrets: All API keys, database credentials, and payment tokens are stored exclusively in .env files and never committed to version control.
• Continuous Audit: Every commit and release is checked against local security scanners with SHA-256 tamper-evident verification.

---

📄 License

This project is licensed under the MIT License.