Salon Management System

A professional, high-end management system for Maie's Salon, designed to handle appointments, client management, invoicing, and reporting with a premium aesthetic.

🚀 Features

• Appointment Scheduling: Effortless booking and management of salon services.
• Client Management: Maintain detailed records and history for every client.
• Invoicing & Billing: Generate professional PDF receipts and track revenue.
• Reporting Dashboard: Real-time insights into business performance and KPIs.
• Role-based Access: Secure access for Admins, Receptionists, and Staff.
• Premium Design: Dark-mode optimized, golden-themed interface for a luxury feel.

📋 Prerequisites

• PHP: >= 8.0
• Database: MySQL or MariaDB
• Composer: For dependency management
• Web Server: Apache, Nginx, or PHP's built-in server (for development)

🛠️ Installation

1. Clone the repository:

   git clone <repository-url>
   cd "Salon management system"
   

2. Install Dependencies: Ensure you have Composer installed, then run:

   composer install
   

3. Configure Environment: Copy the example environment file and update it with your database credentials:

   cp .env.example .env
   

   Open .env and configure:

   • DB_DATABASE: Your database name
   • DB_USERNAME: Your database username
   • DB_PASSWORD: Your database password
   • APP_URL: Your local development URL (e.g., http://localhost:8000)

4. Database Setup:

   • Open phpMyAdmin (usually http://localhost/phpmyadmin).
   • Create a new database named u259446585_maies_salon (or whatever you set in .env).
   • Select the database and use the Import tab to upload database/schema.sql.
   • To add sample data, run the seeder scripts (see below).

🏃 How to Run

Development Server (Quick Start)

The easiest way to run the project locally is using PHP's built-in server:

1. Open your terminal in the project root.
2. Run the following command (using the XAMPP path if not in your PATH):

   C:\xampp\php\php.exe -S localhost:8000
   

   If PHP is in your PATH, you can just use php -S localhost:8000.
3. Visit http://localhost:8000 in your browser.

🧪 Seeding Data

To populate the database with services, clients, and inventory, run:

C:\xampp\php\php.exe database/seed.php

Using XAMPP/WAMP (Windows)

1. Move the project folder to your htdocs (XAMPP) or www (WAMP) directory.
2. Ensure MySQL and Apache are running in the Control Panel.
3. Update APP_URL in .env to match the folder path (e.g., http://localhost/Salon-management-system).
4. Access via http://localhost/Salon-management-system.

or run via;

$ProjectPath = "c:\Users\PRMSC\Desktop\Own stuff\client project\salon project\Salon management system"; cd $ProjectPath; & "C:\xampp\php\php.exe" -S localhost:8000

📁 Project Structure

• assets/: CSS, JS, and image files.
• controllers/: Handles application logic and routing.
• models/: Database interaction and business logic.
• views/: UI templates and pages.
• routes/: Application URL definitions.
• config/: Configuration files.
• database/: SQL scripts and migrations.
• vendor/: Composer dependencies (generated after install).

📄 License

Proprietary. All rights reserved.