# 🪁 Kite Suite — cPanel / Webuzo Live Deployment Guide

> **Q: Kya sirf `public_html/` folder ke andar ka content cPanel ke `public_html/` mein daalne se sab kuch live ho jaayega?**  
> **A: HAAN, 100% HO JAAYEGA!**  
> Aapko is `public_html/` folder ke bahar se **kuch bhi upload karne ki zaroorat nahi hai**. Sabhi UI pages, 9-dot Google launcher, CSS, JS, `.htaccess` clean URL routing, PHP APIs, MySQL database schema/seed, aur optional Node.js server sab kuch is `public_html/` folder ke andar already pack kar diya gaya hai.

---

## 📁 Is Folder Ke Andar Kya Kya Hai? (Self-Contained Package)

| File / Folder | Role & Function |
|---|---|
| `index.html` | **Main Platform Hub** (9-dots launcher, suite overview, microservice status) |
| `.htaccess` | **Apache/LiteSpeed Configuration** (Clean URLs `/billing/`, Gzip compression, browser cache, security headers) |
| `master-admin/` | **Master Admin Control Plane** |
| `billing/` | **Kite Billing & Invoicing** |
| `restaurant/` | **Kite Dining & Food POS** |
| `grocery/` | **Kite QuickMart Grocery & Delivery** |
| `clothing/` | **Kite Vastra Fashion & Apparel** |
| `gym/` | **Kite Gym & Fitness Management** |
| `salon/` | **Kite Salon & Spa Dispatch** |
| `hrm/` | **Kite People HR & Payroll** |
| `manufacturing/` | **Kite Manufacturing ERP & BOM** |
| `readstudent/` | **Kite ReadStudent LMS & Quizzes** |
| `social/` | **Kite OnePost Multi-Social Scheduler** |
| `assets/css/style.css` | **Unified Dark/Light Theme & CSS Design System** |
| `assets/js/app-launcher.js` | **Universal 9-Dots Launcher & Search Controller** |
| `api/` | **PHP Backend Endpoints** (`apps.php`, `auth.php`, `health.php`, `webhooks.php`, `config.php`) |
| `database/` | **MySQL Database Import Files** (`schema.sql`, `seed.sql`, `DATABASE_SETUP_GUIDE.md`) |
| `server.js` & `package.json` | **Optional Node.js Server** (Agar cPanel mein "Setup Node.js App" use karna ho) |

---

## 🚀 Live Karne Ka Tarika (Step-by-Step)

### Option 1: Standard cPanel Hosting (PHP / Apache) — Sabse Aasan & Fast

1. **ZIP banaiye:**
   Apne computer par `public_html` folder ke andar ke sabhi files ko select karke ek `kite-suite.zip` banaiye.
2. **cPanel File Manager Kholiye:**
   - cPanel login karein → **File Manager** par click karein.
   - Apne cPanel ke `public_html/` directory ke andar jaaiye.
3. **Upload & Extract:**
   - **Upload** button dabakar `kite-suite.zip` upload karein.
   - Zip file par right-click karke **Extract** dabayein.
   - *(Make sure `.htaccess` file upload/extract hui ho — File Manager Settings mein "Show Hidden Files (dotfiles)" tick rakhein).*
4. **Site Check Karein:**
   Apna domain browser mein kholein: `https://yourdomain.com/`
   👉 **Aapki puri suite instantly live ho jaayegi!** Sabhi 11 microservices, 9-dot launcher, theme toggle, aur clean links turant chalenge!

---

### (Optional) Database Connect Karna (MySQL)

Agar aapko MySQL database connect karna hai:

1. cPanel mein **MySQL Database Wizard** se ek database aur user create karein (jaise `cpaneluser_kitedb`).
2. cPanel **phpMyAdmin** kholein:
   - Apne naye database par click karein.
   - **Import** tab mein jaakar `database/schema.sql` upload karein → Click **Go**.
   - Phir dobara **Import** mein jaakar `database/seed.sql` upload karein → Click **Go**.
3. File Manager mein `api/config.php` edit karein aur apna DB Name, DB User, aur DB Password daal dein:
   ```php
   define('DB_HOST', 'localhost');
   define('DB_NAME', 'cpaneluser_kitedb');
   define('DB_USER', 'cpaneluser_kiteuser');
   define('DB_PASS', 'YourPassword123');
   ```
> *Note: Agar aap database connect NAHI bhi karte, tab bhi yeh platform 100% smoothly chalta rahega kyunki isme built-in automatic fallback engine shamil hai!*

---

### Option 2: Agar cPanel mein "Setup Node.js App" use kar rahe hain

1. cPanel mein **Setup Node.js App** par click karein.
2. **Create Application**:
   - Node.js Version: `18.x` ya `20.x`
   - Application root: `public_html`
   - Application startup file: `server.js`
3. Click **Create** & **Run/Restart**.
4. Aapka Node.js standalone server `server.js` port par listen karke live ho jaayega!

---

## 🔒 Mobile Apps Ka Kya?
`mobile-apps/` folder ko **kabhi bhi web server / cPanel par upload nahi karna hota**. Mobile apps (React Native / Expo) Android (`.apk` / `.aab`) aur iOS (`.ipa`) builds ke liye hain jo Google Play Store aur Apple App Store par publish hote hain. Isliye unhe web server se alag rakha gaya hai.