feat: add username management system

2025-11-15 21:41:28 -08:00
parent ca94c360ea
commit ea0bc91251
11 changed files with 647 additions and 0 deletions
--- a/app/Models/Username.php
+++ b/app/Models/Username.php
@@ -0,0 +1,72 @@
+<?php
+
+namespace App\Models;
+
+use App\enum\ProviderType;
+use App\enum\UsernameType;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class Username extends Model
+{
+    use HasFactory;
+    use SoftDeletes;
+
+    protected $fillable = [
+        'username',
+        'is_active',
+        'daily_mailbox_limit',
+        'username_type',
+        'provider_type',
+        'starts_at',
+        'ends_at',
+        'last_used_at',
+        'checked_at',
+    ];
+
+    protected function casts(): array
+    {
+        return [
+            'is_active' => 'boolean',
+            'daily_mailbox_limit' => 'integer',
+            'starts_at' => 'datetime',
+            'ends_at' => 'datetime',
+            'last_used_at' => 'datetime',
+            'checked_at' => 'datetime',
+        ];
+    }
+
+    /**
+     * Retrieve active username by type and provider.
+     *
+     * @param  UsernameType|null  $usernameType  Filter by username type
+     * @param  ProviderType|null  $providerType  Filter by provider type
+     * @return array Array of usernames
+     */
+    public static function getActiveUsernameByType(
+        ?UsernameType $usernameType = null,
+        ?ProviderType $providerType = null,
+    ): array {
+        $query = static::query()
+            ->where('is_active', true)
+            ->where(function ($query) {
+                $query->whereNull('starts_at')
+                    ->orWhere('starts_at', '<=', now());
+            })
+            ->where(function ($query) {
+                $query->whereNull('ends_at')
+                    ->orWhere('ends_at', '>=', now());
+            });
+
+        if ($usernameType) {
+            $query->where('username_type', $usernameType);
+        }
+
+        if ($providerType) {
+            $query->where('provider_type', $providerType);
+        }
+
+        return $query->pluck('username')->toArray();
+    }
+}