╔══════════════════════════════════════════════════════════════════════╗
║                                                                      ║
║              🚀 OMNIA PWA - QUICK START GUIDE                        ║
║                                                                      ║
╚══════════════════════════════════════════════════════════════════════╝

┌──────────────────────────────────────────────────────────────────────┐
│ ⚡ FASTEST WAY TO INSTALL                                            │
└──────────────────────────────────────────────────────────────────────┘

  1. Upload ALL files to your server
  2. Visit: https://your-domain.com/install.php
  3. Follow the wizard (10-15 minutes)
  4. Delete install.php when done
  5. Done! ✅


┌──────────────────────────────────────────────────────────────────────┐
│ 📖 DOCUMENTATION (Now Organized!)                                    │
└──────────────────────────────────────────────────────────────────────┘

  READ IN THIS ORDER:

  00 → 00-DOCUMENTATION_INDEX.md     (Overview - start here!)
  01 → 01-START_HERE.md              (Main entry point)
  02 → 02-COMPLETE_DEPLOYMENT_GUIDE.md (Full manual)
  03 → 03-DEPLOYMENT_CHECKLIST.md   (Track progress)
  04 → 04-PWA_SETUP_GUIDE.md         (PWA setup)
  05 → 05-PROPHET_AI_SETUP.md        (AI setup - optional)
  06 → 06-CACHE_CLEARING_GUIDE.md    (Troubleshooting)


┌──────────────────────────────────────────────────────────────────────┐
│ 🛠️ INSTALLATION OPTIONS                                              │
└──────────────────────────────────────────────────────────────────────┘

  Option A: PHP Installer (Easiest!)
    → Visit: https://your-domain.com/install.php
    → Time: 10-15 min

  Option B: Bash Script
    → Run: bash install.sh
    → Time: 15-20 min

  Option C: Manual
    → Follow: 02-COMPLETE_DEPLOYMENT_GUIDE.md
    → Time: 30-60 min


┌──────────────────────────────────────────────────────────────────────┐
│ 🔧 AFTER GIT PULL (Update Existing)                                 │
└──────────────────────────────────────────────────────────────────────┘

  # Always run these after git pull:
  composer install --no-dev
  npm install
  npm run build
  php artisan migrate --force
  php artisan optimize:clear

  # Update service worker version in:
  public/service-worker.js

  # Tell users to hard refresh:
  Ctrl + Shift + R (Windows)
  Cmd + Shift + R (Mac)


┌──────────────────────────────────────────────────────────────────────┐
│ ⚠️ COMMON ISSUES                                                     │
└──────────────────────────────────────────────────────────────────────┘

  Users see old content?
    → See: 06-CACHE_CLEARING_GUIDE.md

  PWA notifications not working?
    → See: 04-PWA_SETUP_GUIDE.md

  Missing dependencies after git pull?
    → Run: composer install --no-dev
    → Run: npm install && npm run build

  Database errors?
    → Check .env settings
    → Run: php artisan migrate --force


┌──────────────────────────────────────────────────────────────────────┐
│ ✅ PRE-DEPLOYMENT CHECKLIST                                          │
└──────────────────────────────────────────────────────────────────────┘

  Required:
  ☐ PHP 8.2+
  ☐ MySQL 8.0+ / MariaDB 10.6+
  ☐ Composer 2.x
  ☐ Node.js 18+
  ☐ php8.2-gmp extension (for PWA!)
  ☐ HTTPS/SSL certificate (MANDATORY for PWA!)

  After Install:
  ☐ Delete public/install.php
  ☐ Set APP_DEBUG=false
  ☐ Set APP_ENV=production
  ☐ Setup queue workers
  ☐ Setup cron jobs


┌──────────────────────────────────────────────────────────────────────┐
│ 🎯 QUICK COMMANDS                                                    │
└──────────────────────────────────────────────────────────────────────┘

  Clear all caches:
    php artisan optimize:clear

  Run migrations:
    php artisan migrate --force

  Generate VAPID keys:
    php artisan webpush:vapid

  Check logs:
    tail -100 storage/logs/laravel.log


┌──────────────────────────────────────────────────────────────────────┐
│ 📞 HELP & SUPPORT                                                    │
└──────────────────────────────────────────────────────────────────────┘

  Start with: 01-START_HERE.md

  Then read the numbered guides in order (01, 02, 03, etc.)

  All documentation is now organized with numbers!


╔══════════════════════════════════════════════════════════════════════╗
║  Your Omnia PWA is ready to deploy! 🚀                               ║
║  Start with: 01-START_HERE.md                                        ║
╚══════════════════════════════════════════════════════════════════════╝
