KYM Network Marketing — Laravel MLM Platform with MacroDroid SMS & CodeStar License

KYM Network Marketing is a complete, production-ready Multi-Level Marketing (MLM) platform built on Laravel 11. It is designed for entrepreneurs, MLM companies, and digital business operators who need a professional, transparent, and legally compliant network marketing system.

The platform features a unique Single-Wallet architecture (no dual wallet confusion), 5-level referral commission engine, MacroDroid-powered free SMS auto-verification for Pakistani payment gateways, and a beautiful premium UI with VIP Digital Membership Cards.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔑 KEY FEATURES

✅ 5-Step Web Installer Wizard
Buyers simply open /install in their browser, enter their CodeStar purchase code, connect their database, and the system auto-migrates and seeds all required tables. No SSH or terminal required.

✅ Single-Wallet System (Strict Compliance)
All earnings — referral commissions, ROI profits, deposits, and withdrawals — go into one unified PKR wallet per member. No BV points, no dual wallets, no confusion. 100% transparent.

✅ 5-Level MLM Referral Commission Engine
- Level 1 Direct Referral: 10% + Rs.500 fixed
- Level 2 Downline: 5% + Rs.250 fixed
- Level 3 Team: 3% + Rs.150 fixed
- Level 4 Network: 2% + Rs.100 fixed
- Level 5 Depth: 1% + Rs.50 fixed
- Diamond Leader Royalty Pool: 2.5%
All levels are fully configurable from the admin panel.

✅ MacroDroid Free SMS Auto-Verification
Admin installs the free MacroDroid app on their Android phone. When a member sends payment via EasyPaisa, JazzCash, UPaisa, SadaPay, NayaPay, Binance Pay, or Meezan Bank, the confirmation SMS is automatically forwarded to the platform. The system matches the Transaction ID and activates the member's plan instantly — no manual approval needed.

✅ Dual Checkout Modes
- Option A: Automatic — Member enters Transaction ID, matched against SMS webhook in real-time
- Option B: Manual — Member uploads payment screenshot; admin reviews and approves with 1 click

✅ 7 Pakistani Payment Gateways Pre-Configured
EasyPaisa, JazzCash, UPaisa, SadaPay, NayaPay, Binance Pay/USDT (TRC20), Meezan Bank Ltd

✅ Premium VIP Digital Membership Card
Each member receives a luxury black-gold digital membership card with their photo, member ID, sponsor details, blue tick verification badge, referral QR code, and animated effects.

✅ 5 Investment Plans
Starter (Rs.1,000), Bronze (Rs.3,000), Silver (Rs.5,000), Gold (Rs.10,000), Diamond Executive (Rs.25,000) — all fully customizable from admin panel.

✅ Interactive Genealogy Downline Tree
Visual tree showing all 5 levels of downline members with real-time stats.

✅ Daily ROI Distribution Engine
Admin configures daily profit percentage per plan. Cron job distributes ROI profits automatically to all active plan holders every day.

✅ Admin Panel (Full Control)
- Member Management (search, filter, block, verify)
- Plan Activations Queue (approve/reject manual payments)
- Financial Ledger & Manual Wallet Adjustments
- Withdrawal Management (two-phase approval)
- Referral Level Generator (add/edit/delete commission rules)
- MacroDroid SMS Simulator & Webhook Settings
- USD/PKR Exchange Rate Control
- Announcements Manager
- CodeStar License & Auto-Updater Panel
- Detailed Reports & CSV Exports

✅ 4 User Roles
Super Admin, Finance Admin, Team Manager, Support Admin

✅ Member Portal
Dashboard, Wallet Ledger, Deposit (Auto + Manual), Withdrawal, P2P Transfer with Printable Receipt, Referral Tree, Team Management, Helpdesk Support Tickets

✅ 21+ Public Marketing Pages
Home (3D premium animated hero), About, Business Plan, Compensation Plan, Membership Benefits, FAQ, Contact, Policies, Payment Methods, Support Center, and more.

✅ Premium 3D Homepage
Neural network canvas animation, floating 3D coin, live ledger activity stream, interactive profit calculator, 5-tier referral visualization, VIP card preview, gateway showcase.

✅ Mobile Responsive
Fully responsive on desktop, tablet, and mobile. Bootstrap 5 framework with custom premium CSS.

✅ CodeStar License Protection
Every buyer's copy is domain-locked to their server via CodeStar real-time API. Instant revocation available if needed. Auto-updater included.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🛠️ TECH STACK

- Backend: Laravel 11 (PHP 8.2+)
- Database: MySQL 5.7+ / MariaDB 10.3+
- Frontend: Bootstrap 5, Bootstrap Icons, Vanilla JS
- Animations: CSS3 3D transforms, Canvas API
- Auth: Laravel built-in session auth
- License: CodeStar API (domain locking + revocation)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚙️ INSTALLATION (3 METHODS)

Method 1 — Web Installer (Recommended):
1. Upload and extract ZIP to public_html
2. Create MySQL database in cPanel
3. Edit .env with DB credentials
4. Visit yourdomain.com/install
5. Follow 5-step wizard → Done!

Method 2 — phpMyAdmin SQL Import:
1. Upload files to public_html
2. Import database/kym_clean_install.sql via phpMyAdmin
3. Edit .env with DB credentials + purchase code
4. Visit yourdomain.com → Live!

Method 3 — SSH/Terminal:
php artisan migrate --force
php artisan db:seed --force
php artisan storage