════════════════════════════════════════════════════════════════════
  CHANDRA & SONS PHARMA — cPANEL DEPLOYMENT GUIDE
  Laravel 10 + Filament PHP CMS
════════════════════════════════════════════════════════════════════

OPTION A — WEB INSTALLER (Easiest) ──────────────────────────────

1. In cPanel → File Manager, upload chandrasons.zip to your
   domain's root folder (e.g. public_html/)

2. Right-click the zip → Extract

3. Open your browser: https://yourdomain.com/install.php

4. Fill in your database credentials and admin password → Install

5. DELETE install.php from the server immediately after!

Done. Visit https://yourdomain.com/admin to log in.


OPTION B — MANUAL (SSH / cPanel Terminal) ──────────────────────

Step 1 — Upload & Extract
  Upload chandrasons.zip into your hosting root folder
  Unzip: unzip chandrasons.zip

Step 2 — Configure .env
  cp .env.example .env
  Edit .env with your actual DB credentials and APP_URL

Step 3 — Set Permissions
  chmod -R 775 storage bootstrap/cache
  chmod -R 664 storage/framework storage/logs
  find storage -type f -exec chmod 664 {} \;
  find storage -type d -exec chmod 775 {} \;

Step 4 — Run Setup Commands (cPanel Terminal)
  php artisan key:generate
  php artisan migrate --force
  php artisan db:seed --force
  php artisan storage:link
  php artisan config:cache
  php artisan route:cache
  php artisan view:clear

Step 5 — Set Document Root (if needed)
  In cPanel → Domains → your domain → Document Root
  Point to: /home/yourusername/public_html/public
  (Or use the root .htaccess already included — it redirects
   web traffic into /public automatically)

Step 6 — Cron Job (cPanel → Cron Jobs)
  Command: php /home/yourusername/public_html/artisan schedule:run
  Frequency: Every Minute (*/1 * * * *)


AFTER INSTALLATION ──────────────────────────────────────────────

Admin URL:      https://yourdomain.com/admin
Admin Email:    admin@chandrasons.com  (change in .env before seeding)
Admin Password: Admin@1234            (change immediately after login!)

Things to configure in Admin Panel:
  Settings → General   : Logo, phone, address, business hours
  Settings → SEO       : Google Analytics, Search Console verification
  Settings → Email     : SMTP host/port/password for enquiry emails
  Brand Partners       : Upload real company logos
  Hero Banners         : Upload store/warehouse photos
  Products             : Add your product catalog


FILE PERMISSIONS REFERENCE ─────────────────────────────────────

Directories:   755 (public) or 775 (writable dirs)
Files:         644 (public) or 664 (writable files)

Writable directories (must be 775):
  storage/
  storage/app/
  storage/app/public/
  storage/framework/
  storage/framework/cache/
  storage/framework/sessions/
  storage/framework/views/
  storage/logs/
  bootstrap/cache/


DEFAULT ADMIN CREDENTIALS ──────────────────────────────────────

  Email:    admin@chandrasons.com
  Password: Admin@1234

  ⚠️  CHANGE THIS IMMEDIATELY after first login!
  Admin → profile icon (top right) → Edit Profile → Change Password


SEEDED DATA (installed automatically) ─────────────────────────

  ✅ 3 Languages: English, Hindi, Nepali
  ✅ All Site Settings (phone, address, social links, email config)
  ✅ 4 Services (Wholesale, Retail, Nepal Export, Pharmacy/Hospital)
  ✅ 4 Product Categories (Branded, Generic, Surgical, OTC)
  ✅ 30 Brand Partners with logos
  ✅ 10 FAQs (General + Nepal Export category)
  ✅ 3 Sample Testimonials
  ✅ 2 Sample Blog Posts
  ✅ Social Links (Facebook, Instagram, TikTok)
  ✅ Stats Counter (150+ Brands, 10+ Years, 1000+ Products, 2500+ Clients)
  ✅ Admin User


TROUBLESHOOTING ────────────────────────────────────────────────

White page / 500 error:
  → Check storage/ and bootstrap/cache/ are writable (chmod 775)
  → Check .env has correct DB credentials
  → Run: php artisan config:clear && php artisan view:clear

"Class not found" errors:
  → vendor/ directory must be present (it's included in the zip)
  → Run: composer dump-autoload

Images not showing:
  → Run: php artisan storage:link
  → Or create manually: ln -s ../storage/app/public public/storage

Session errors:
  → Ensure storage/framework/sessions/ exists and is writable

════════════════════════════════════════════════════════════════════