Reward Loyalty

✨ Key Features

• Points Engine: Earn on purchases, actions (sign-up, reviews), and events (birthdays); configurable earn/burn ratios.
• Tiers & Perks: Bronze/Silver/Gold (or custom) with benefits like accelerated earn rates, free shipping, and early access.
• Referral Program: Give-get links/codes, fraud checks, cooldowns, and attribution reporting.
• Wallet & Coupons: In-app balance, voucher generation, single/multi-use codes, expiration, min spend, and stacking rules.
• Campaigns & Bonuses: Double points weekends, first-order boosters, seasonal promos, and geo/segment targeting.
• POS & QR: Search by phone/email; QR membership cards for quick scans at checkout.
• Integrations: Webhooks & REST API for carts/POS; ready for popular gateways (Stripe/PayPal) for top-ups or paid memberships.
• Messaging: Email/SMS templates for enrollment, point balance, tier upgrades, and expiring rewards.
• Fraud Controls: IP/device rate limits, blacklist, manual review queue, and anomaly flags.
• Analytics: Repeat rate, AOV lift, point liability, cohort retention, campaign ROI; export to CSV/XLS.
• Localization: Multi-language UI, multi-currency, RTL support, locale-aware formatting.
• SEO-Friendly Pages: Public explainer/FAQ with clean URLs, schema hooks, and fast load for branded loyalty microsites.
• Extensible: Modular services, event listeners/webhooks, and policy-driven rules for custom earning/redemption logic.

⚙️ Technical Stack

• Backend: PHP 8.x (Laravel-style routing, middleware, policies, queues)
• Frontend (Web): Blade/Twig-style templates or SPA-ready JSON APIs; Tailwind/Bootstrap supported
• Database: MySQL/MariaDB (InnoDB, UTF-8MB4)
• Cache & Queue: Redis for sessions, queues, rate limiting
• Optional Mobile: Flutter 3.x or React Native client for member wallet, QR card, and balance lookup
• Server Requirements: Nginx/Apache; PHP extensions: pdo_mysql, mbstring, openssl, json, xml, ctype, curl, zip
• Tooling: Composer, Node.js (Vite/Mix); Flutter SDK/Xcode/Android Studio for mobile builds (optional)

🧩 Installation Guide

1. Provision Server: Create a UTF-8MB4 database; enable required PHP extensions; install Composer & Node.js.
2. Deploy Code: Upload files; run composer install --no-dev and php artisan key:generate.
3. Configure Environment: Copy .env.example to .env; set APP_URL, DB, mail (SMTP), cache/queue, and payment keys (if used).
4. Migrate & Seed: php artisan migrate --seed to create tables and starter tiers/campaign examples.
5. Build Frontend: npm install then npm run build (or dev for local).
6. Workers & Scheduler: Start php artisan queue:work; cron: * * * * * php artisan schedule:run.
7. Optional Mobile: Set API base URL in flutter/ app config; run flutter build apk / ios.
8. Go Live: Point domain to public/, enable HTTPS, add CSP/HSTS headers, and test webhooks.

📦 Deliverables

• PHP (Laravel-style) backend source + web templates
• SQL migrations & seeders (tiers, example campaigns, roles)
• REST API endpoints & examples (cart/POS integration)
• Email/SMS templates, localization files, and schema hooks
• Sample .env.example and deployment notes
• Optional Flutter/React Native client source
• Quick-start documentation & developer notes

📱 Supported Platforms

• Web (Admin & Member): Chrome, Firefox, Safari, Edge (latest)
• Android: Android 7.0+ (if using the mobile app)
• iOS: iOS 13+ (Xcode build required for mobile)
• Server OS: Ubuntu/Debian/CentOS recommended; Windows Server compatible

🧠 Notes

• License: Distributed under the GPL for lawful study, modification, and redistribution per GPL terms.
• Customization Tips: Keep earning/burning logic in service classes; expose rules in admin UI; use events/webhooks for POS/eCommerce sync.
• Security: Enforce HTTPS, CSRF protection, rate limiting; store secrets in env vars; enable audit logs for points edits and manual adjustments.
• Performance: OPcache + Redis; index on member, order, and event tables; batch point accrual during high-volume campaigns.
• SEO Assurance: Clean URLs, meta fields, Open Graph/Twitter cards, structured data hooks; fast LCP and stable CLS on public landing pages.

👨‍💻 Original Developer Credit

We credit the original developer and marketplace publisher as the authoritative source for the concept and feature design.
For provenance and official updates, please consult the original listing on
CodeCanyon (or the developer’s official site).

🔒 Disclaimer

This is a GPL redistribution intended for learning, testing, and compliant use under the GPL. We are not the original authors and do not claim endorsement or affiliation.
Trademarks and brand names belong to their respective owners. Before production use, verify third-party licenses (SMS/email providers, payment SDKs), comply with marketplace terms, and conduct security and performance reviews.