feat: referral_code

app/Http/Controllers/UserController.php

@@ -210,14 +210,22 @@ public function register(Request $request)
             'method' => 'string|in:code,link|nullable',
             'birthday' => 'date|nullable',
             'gender' => ['integer', 'nullable', Rule::in(User::GENDERS)],
+            'referrer_code' => ['string', 'nullable', 'exists:users,referral_code'],
         ]);
-    
+
           $method = $data['method'] ?? 'link';
             unset($data['method']);
 
             // Extract and remove package_name
             $packageNameValue = $data['package_name'];
             unset($data['package_name']);
+
+            // Resolve referrer code (کد معرف) to the referring user
+            $referrerCode = $data['referrer_code'] ?? null;
+            unset($data['referrer_code']);
+            if ($referrerCode && $referrer = User::where('referral_code', $referrerCode)->first()) {
+                $data['referred_by'] = $referrer->id;
+            }
     
         if (isset($data['mobile'])) {
             $data['mobile'] = MobileNumberHelper::formatMobile($data['mobile']);

app/Models/User.php

@@ -3,6 +3,7 @@
 namespace App\Models;
 
 use App\Traits\HasUuid;
+use App\Traits\HasReferralCode;
 use DateTimeInterface;
 use EloquentFilter\Filterable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -13,7 +14,7 @@
 use Illuminate\Support\Str;
 class User extends Authenticatable
 {
-    use HasApiTokens, HasFactory, Notifiable, HasUuid, Filterable;
+    use HasApiTokens, HasFactory, Notifiable, HasUuid, HasReferralCode, Filterable;
 
     const GENDERS = [
         'male' => 1,
@@ -61,6 +62,16 @@ public function otpTokens()
         return $this->hasMany(OtpTokens::class);
     }
 
+    public function referrer()
+    {
+        return $this->belongsTo(User::class, 'referred_by');
+    }
+
+    public function referrals()
+    {
+        return $this->hasMany(User::class, 'referred_by');
+    }
+
     public function transactions()
     {
         return $this->hasMany(Transaction::class);

app/Traits/HasReferralCode.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Traits;
+
+use Illuminate\Support\Str;
+
+trait HasReferralCode
+{
+    public static function bootHasReferralCode(): void
+    {
+        static::creating(function ($model) {
+            if (!$model->referral_code) {
+                $model->referral_code = static::generateReferralCode();
+            }
+        });
+    }
+
+    public static function generateReferralCode(): string
+    {
+        do {
+            $code = strtoupper(Str::random(8));
+        } while (static::where('referral_code', $code)->exists());
+
+        return $code;
+    }
+}