Laravel/Vue.js Referral & Leaderboard Modifications

Job ID: 38208543

Budget: $30 – $250 USD

Currently they systems credit my user when they invite new friend and will have to wait till their potential friend make a withdrawal before they could get the supposed reward coin but we aim to change so user can get an instant reward upon successful referrals with multi level package.
## Tiered Referral Program with Instant Rewards

This improved referral program offers users three reward tiers based on the number of successful referrals they achieve. Here's how it works:

**User Experience:**

1. Users invite friends through our web app's referral system.
2. Upon successful friend registration (typically through a unique referral link), the referring user instantly receives a reward based on their current tier.
3. There are three tiers:
* **Level 1:** Users earn **100 coins** per successful referral (up to a maximum of **100 referrals**).
* **Level 2:** Once Level 1 is reached, users earn **200 coins** per successful referral (up to a maximum of **200 additional referrals**).
* **Level 3:** After reaching Level 2, users earn **500 coins** per successful referral with **no limit** on the number of referrals.

**Benefits:**

* **Increased User Engagement:** Tiered rewards incentivize users to actively invite more friends.
* **Faster Reward Fulfillment:** Users get rewarded instantly, eliminating the wait for friend withdrawal.
* **Flexibility for All Users:** Different tiers cater to users with varying referral goals.

**Technical Implementation for Developers:**

1. **User Tiers:** Create a new field in the user model to store the current referral tier (e.g., integer value 1-3).
2. **Referral Tracking:** Modify the referral system to track successful registrations.
3. **Reward Logic:** Implement logic to check the user's tier and award the corresponding number of coins upon successful referral. (e.g., if tier = 1, award 100 coins)
4. **Tier Advancement:** Update the system to automatically promote users to the next tier when they reach the maximum referrals for the current level. (e.g., after 100 referrals, update tier to 2)
5. **Admin Panel:** add new additional admin panel that allows setting:
* The number of referrals required for each tier.
* The reward amount for each tier.



**1. Admin Interface for Contest Selection:**

* Create a new section in the admin panel specifically for "Contests".
* Allow the admin to select a pre-defined "Challenge Type" from a dropdown menu. (e.g., Referrals, Points Earned in a Specific , etc.)
* Depending on the chosen challenge type, display additional configuration options:

Leaderboard currently it rank all the earning coins from general user but the change should be.
**2. Leaderboard Update:**

* Modify the logic that calculates the leaderboard ranking.
* Instead of solely focusing on total coins, consider the chosen "Challenge Type" and timeframe when calculating a user's score for the contest leaderboard.
* For "Referrals": Track the number of successful referrals within the specified time period for each user.
* For other challenge types: Track the completion of relevant actions and assign points based on the pre-defined configuration.
* Update the leaderboard admin to select a a specific game, for example referral program can be set from.admin and set date and time with how much to be won ,the contest leaderboard alongside the general leaderboard Update the user interface
Related categories: PHP Laravel Tailwind CSS