# 💈 Ultimate POS v7.2 සදහා Salon & Spa Appointment Booking Module ස්ථාපනය සහ භාවිතය පිළිබඳ සම්පූර්ණ මගපෙන්වීම (Sinhala Guide)

මෙම Module එක **Ultimate POS v7.2** ERP පද්ධතියට සෘජුවම සම්බන්ධ කර සැලූන් (Salon & Spa) ව්‍යාපාරයක් සදහා අවශ්‍ය සියලුම පහසුකම් ලබා දීමට සකස් කර ඇත.

ඔබ ලබා දුන් Screen Shots (1, 2, 3, 4, 5) වල ඇති flow එකට 100% සමානව Touch-Screen Friendly Popup Booking Engine එක නිර්මාණය කර ඇත.

---

## 🌟 ප්‍රධාන අංග සහ විශේෂාංග (Key Features)

✅ **Screens 1-5 Popup Booking Flow:**
- **Screen 1:** සේවා තෝරාගැනීම (Hair Cut - 45 mins, Makeup - 1 hour, etc.)
- **Screen 2:** Full Month Interactive Calendar (දිනය තේරීම, Asia/Colombo Timezone)
- **Screen 3:** Dynamic Time Slot Generator (8:00 AM, 8:30 AM, 9:00 AM, 9:30 AM...)
- **Screen 4:** Customer & Booking Confirmation Form (First name, Email, Phone, Stylist, Chair)
- **Screen 5:** Instant Confirmation, Notify.lk Auto SMS, WhatsApp Message සහ POS Cart එකට Load කිරීම.

✅ **Notify.lk SMS Gateway Integration:**
- Booking එක Confirm වූ විගස Customer වෙත Auto SMS යැවීම.
- Reminder SMS (පැය 24 කට පෙර).
- Booking Complete වූ විට "Thank you + Loyalty Points" SMS යැවීම.

✅ **Stylist & Staff Availability & Commission:**
- එක් එක් Stylist ගේ Shift Hours, Off-days සහ Services කළමනාකරණය.

✅ **Chair & Station Management:**
- VIP Chairs, Hair Color Stations, Bridal Suites, Facial Beds වල Live Status බැලීම.

✅ **Bridal Management & Packages:**
- මනාලියන් සහ Bridal Party සදහා Multiple Appointments, Advance Deposit සහ Balance Due කළමනාකරණය.

✅ **Customer CRM, Loyalty Points & Visit History:**
- පාරිභෝගිකයාගේ Hair Color Formulas (Dye Codes), Allergies, Past visits සහ Points POS Invoice එකට සම්බන්ධ කිරීම.

✅ **POS Screen Integration (F6 Shortcut):**
- POS Terminal එකේ Top Bar එකෙන් Popup window එක විවෘත කිරීම සහ 1-Click එකෙන් Bill එකට දමා Payment (Cash/Card) ලබා ගැනීම.

---

## 🛠️ ස්ථාපනය කිරීමේ පියවර (Step-by-Step Installation)

### පියවර 1: Module Files පිටපත් කිරීම (Copy Files)
ඔබගේ Ultimate POS v7.2 Root Folder එක තුළ ඇති `Modules/` ෆෝල්ඩරය වෙත මෙම `SalonBooking` ෆෝල්ඩරය Copy කරන්න:

```bash
# Ultimate POS root folder එකට යන්න
cd /path-to-your-ultimatepos/

# Modules directory එකට copy කරන්න
cp -r /home/user/UltimatePOS_Salon_Module/SalonBooking Modules/
```

ෆෝල්ඩර සැකැස්ම මෙසේ විය යුතුය:
```
ultimatepos/
└── Modules/
    └── SalonBooking/
        ├── Config/
        ├── Database/
        │   └── Migrations/
        ├── Entities/
        ├── Http/
        │   └── Controllers/
        ├── Providers/
        ├── Resources/
        │   ├── assets/
        │   └── views/
        ├── Routes/
        ├── Utils/
        ├── composer.json
        └── module.json
```

---

### පියවර 2: Database Migrations ධාවනය කිරීම (Run Migrations)
Terminal එක හරහා පහත command එක ධාවනය කර Salon Tables Database එකට සාදා ගන්න:

```bash
php artisan module:migrate SalonBooking
```

හෝ

```bash
php artisan migrate
```

---

### පියවර 3: Ultimate POS හි Module එක Activate කිරීම
1. ඔබගේ Ultimate POS Admin Panel එකට Log වන්න.
2. Left Menu එකෙන් **Settings** → **Modules** (හෝ Manage Modules) වෙත යන්න.
3. **SalonBooking** module එක සොයාගෙන **"Activate / Enable"** ක්ලික් කරන්න.
4. **User Management** → **Roles & Permissions** වෙත ගොස් Cashier / Receptionist / Stylist roles වලට `salon_booking` permissions ලබා දෙන්න.

---

### පියවර 4: Notify.lk SMS Gateway එක Configure කිරීම
1. Left Menu එකෙන් **Salon & Spa Appointments** → **Notify.lk SMS Gateway** වෙත යන්න.
2. ඔබගේ **Notify.lk User ID**, **API Key** සහ **Sender ID (Masking Name)** ඇතුලත් කරන්න.
3. පහත Settings Enable කරන්න:
   - ☑️ **Auto Send SMS on Booking Confirmation**
   - ☑️ **Auto Send 24h Reminder SMS**
   - ☑️ **Auto Send Thank You & Loyalty Points SMS on Completion**
4. **Save Settings** ක්ලික් කරන්න.
5. "Test Notify.lk SMS" කොටසේ ඔබගේ දුරකථන අංකය යොදා Test SMS එකක් යවා පරීක්ෂා කරන්න.

---

### පියවර 5: POS Screen එකට සම්බන්ධ කිරීම (POS Header Integration)
Module එක Activate වූ පසු POS Screen එකේ ඉහළ Top Bar එකෙහි **"📅 Book Appointment (F6)"** නිල් පැහැති බොත්තම ස්වයංක්‍රීයව දිස්වේ.

- කැෂියර් හට **F6 key** එක එබීමෙන් හෝ බොත්තම ක්ලික් කිරීමෙන් Popup Booking Window එක ක්ෂණිකව විවෘත වේ.
- Booking එකක් සම්පූර්ණ වූ පසු **"Load into POS Bill"** ක්ලික් කළ විට සෘජුවම POS Cart එකට වැටී Cash/Card මගින් Bill එක print කළ හැක.

---

## 📱 සජීවීව ක්‍රියාත්මක වන Live Demo Simulator
ඔබට මෙම Workspace එක තුළ දැනටමත් ධාවනය වන Live Web Preview එකෙන් Screenshots 1-5 හි සම්පූර්ණ අත්දැකීම දැන්ම පරීක්ෂා කළ හැක:
- **Port:** `3000` (Browser Preview)
- **Screen 1 → Screen 2 → Screen 3 → Screen 4 → Screen 5** සියල්ල පරීක්ෂා කරන්න.
- Notify.lk SMS log සහ WhatsApp reminder බොත්තම් සජීවීව ක්‍රියා කරයි.