feat: add username management system

app/Filament/Resources/Usernames/Pages/CreateUsername.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace App\Filament\Resources\Usernames\Pages;
+
+use App\Filament\Resources\Usernames\UsernameResource;
+use Filament\Resources\Pages\CreateRecord;
+
+class CreateUsername extends CreateRecord
+{
+    protected static string $resource = UsernameResource::class;
+}

app/Filament/Resources/Usernames/Pages/EditUsername.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Filament\Resources\Usernames\Pages;
+
+use App\Filament\Resources\Usernames\UsernameResource;
+use Filament\Actions\DeleteAction;
+use Filament\Actions\ForceDeleteAction;
+use Filament\Actions\RestoreAction;
+use Filament\Resources\Pages\EditRecord;
+
+class EditUsername extends EditRecord
+{
+    protected static string $resource = UsernameResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            DeleteAction::make(),
+            ForceDeleteAction::make(),
+            RestoreAction::make(),
+        ];
+    }
+}

app/Filament/Resources/Usernames/Pages/ListUsernames.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Filament\Resources\Usernames\Pages;
+
+use App\Filament\Resources\Usernames\UsernameResource;
+use Filament\Actions\CreateAction;
+use Filament\Resources\Pages\ListRecords;
+
+class ListUsernames extends ListRecords
+{
+    protected static string $resource = UsernameResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            CreateAction::make(),
+        ];
+    }
+}

app/Filament/Resources/Usernames/Schemas/UsernameForm.php

@@ -0,0 +1,67 @@
+<?php
+
+namespace App\Filament\Resources\Usernames\Schemas;
+
+use App\enum\ProviderType;
+use App\enum\UsernameType;
+use Filament\Forms\Components\DateTimePicker;
+use Filament\Forms\Components\Select;
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Components\ToggleButtons;
+use Filament\Infolists\Components\TextEntry;
+use Filament\Schemas\Schema;
+
+class UsernameForm
+{
+    public static function configure(Schema $schema): Schema
+    {
+        return $schema
+            ->components([
+                TextInput::make('username')
+                    ->columnSpan(1)
+                    ->alphaDash()
+                    ->helperText('Email: myusername@gmail.com | Username: myusername')
+                    ->required(),
+                TextInput::make('daily_mailbox_limit')
+                    ->integer()
+                    ->minValue(1)
+                    ->default(100)
+                    ->helperText('How many mailboxes can be created with this domain daily')
+                    ->columnSpan(1)
+                    ->required(),
+                ToggleButtons::make('is_active')
+                    ->options([
+                        true => 'Active',
+                        false => 'Disabled',
+                    ])
+                    ->inline()
+                    ->default(true)
+                    ->columnSpanFull()
+                    ->required(),
+                Select::make('username_type')
+                    ->options(UsernameType::class)
+                    ->enum(UsernameType::class)
+                    ->required(),
+                Select::make('provider_type')
+                    ->options(ProviderType::class)
+                    ->enum(ProviderType::class)
+                    ->required(),
+                DateTimePicker::make('starts_at'),
+                DateTimePicker::make('ends_at'),
+                TextEntry::make('last_used_at')
+                    ->label('Last Used At')
+                    ->formatStateUsing(fn ($state) => $state ? $state->diffForHumans() : 'Never')
+                    ->visible(fn ($context) => $context === 'edit'),
+                TextEntry::make('checked_at')
+                    ->label('Last Checked At')
+                    ->formatStateUsing(fn ($state) => $state ? $state->diffForHumans() : 'Never')
+                    ->visible(fn ($context) => $context === 'edit'),
+                TextEntry::make('deleted_at')
+                    ->label('Deleted At')
+                    ->formatStateUsing(fn ($state) => $state ? $state->diffForHumans() : null)
+                    ->color('danger')
+                    ->icon('heroicon-o-trash')
+                    ->visible(fn ($record) => $record?->deleted_at !== null),
+            ]);
+    }
+}

app/Filament/Resources/Usernames/Tables/UsernamesTable.php

@@ -0,0 +1,108 @@
+<?php
+
+namespace App\Filament\Resources\Usernames\Tables;
+
+use App\enum\ProviderType;
+use App\enum\UsernameType;
+use Filament\Actions\BulkActionGroup;
+use Filament\Actions\DeleteBulkAction;
+use Filament\Actions\EditAction;
+use Filament\Actions\ForceDeleteBulkAction;
+use Filament\Actions\RestoreBulkAction;
+use Filament\Support\Icons\Heroicon;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Columns\ToggleColumn;
+use Filament\Tables\Filters\SelectFilter;
+use Filament\Tables\Filters\TrashedFilter;
+use Filament\Tables\Table;
+
+class UsernamesTable
+{
+    public static function configure(Table $table): Table
+    {
+        return $table
+            ->columns([
+                TextColumn::make('username')
+                    ->label('Usernames')
+                    ->searchable()
+                    ->weight('medium')
+                    ->icon(Heroicon::OutlinedUser)
+                    ->copyable()
+                    ->copyMessage('Domain copied!')
+                    ->copyMessageDuration(1500),
+                ToggleColumn::make('is_active')
+                    ->label('Active')
+                    ->alignCenter(),
+                TextColumn::make('username_type')
+                    ->label('Type')
+                    ->formatStateUsing(fn ($state) => $state ? UsernameType::tryFrom($state)?->getLabel() : '-')
+                    ->badge()
+                    ->color(fn ($state) => $state ? UsernameType::tryFrom($state)?->getColor() : 'gray')
+                    ->alignCenter(),
+                TextColumn::make('provider_type')
+                    ->label('Provider')
+                    ->formatStateUsing(fn ($state) => $state ? ProviderType::tryFrom($state)?->getLabel() : '-')
+                    ->badge()
+                    ->color(fn ($state) => $state ? ProviderType::tryFrom($state)?->getColor() : 'gray')
+                    ->alignCenter(),
+                TextColumn::make('daily_mailbox_limit')
+                    ->label('Daily Limit')
+                    ->numeric()
+                    ->formatStateUsing(fn ($state) => number_format($state))
+                    ->alignCenter()
+                    ->icon('heroicon-o-inbox'),
+                TextColumn::make('last_used_at')
+                    ->label('Last Used')
+                    ->dateTime('M j, Y g:i A')
+                    ->placeholder('Never')
+                    ->sortable()
+                    ->since()
+                    ->alignCenter(),
+                TextColumn::make('checked_at')
+                    ->label('Checked')
+                    ->dateTime('M j, Y')
+                    ->placeholder('Never')
+                    ->sortable()
+                    ->since()
+                    ->alignCenter()
+                    ->toggleable(isToggledHiddenByDefault: true),
+
+            ])
+            ->filters([
+                SelectFilter::make('username_type')
+                    ->label('Username Type')
+                    ->options(UsernameType::class),
+                SelectFilter::make('provider_type')
+                    ->label('Provider Type')
+                    ->options(ProviderType::class),
+                SelectFilter::make('is_active')
+                    ->label('Status')
+                    ->options([
+                        true => 'Active',
+                        false => 'Inactive',
+                    ]),
+                TrashedFilter::make(),
+            ])
+            ->recordActions([
+                EditAction::make(),
+            ])
+            ->toolbarActions([
+                BulkActionGroup::make([
+                    DeleteBulkAction::make(),
+                    ForceDeleteBulkAction::make(),
+                    RestoreBulkAction::make(),
+                ]),
+            ])
+            ->emptyStateHeading('No usernames found')
+            ->emptyStateDescription('Get started by creating your first username.')
+            ->emptyStateActions([
+                // Add create action if needed
+            ])
+            ->poll('60s')
+            ->striped()
+            ->defaultPaginationPageOption(10)
+            ->paginated([10, 25, 50, 100])
+            ->reorderable('sort_order')
+            ->defaultSort('username');
+    }
+}

app/Filament/Resources/Usernames/UsernameResource.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Filament\Resources\Usernames;
+
+use App\Filament\Resources\Usernames\Pages\CreateUsername;
+use App\Filament\Resources\Usernames\Pages\EditUsername;
+use App\Filament\Resources\Usernames\Pages\ListUsernames;
+use App\Filament\Resources\Usernames\Schemas\UsernameForm;
+use App\Filament\Resources\Usernames\Tables\UsernamesTable;
+use App\Models\Username;
+use BackedEnum;
+use Filament\Resources\Resource;
+use Filament\Schemas\Schema;
+use Filament\Support\Icons\Heroicon;
+use Filament\Tables\Table;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\SoftDeletingScope;
+
+class UsernameResource extends Resource
+{
+    protected static ?string $model = Username::class;
+
+    protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedUserGroup;
+
+    protected static string|null|\UnitEnum $navigationGroup = 'Email';
+
+    public static function form(Schema $schema): Schema
+    {
+        return UsernameForm::configure($schema);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return UsernamesTable::configure($table);
+    }
+
+    public static function getRelations(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => ListUsernames::route('/'),
+            'create' => CreateUsername::route('/create'),
+            'edit' => EditUsername::route('/{record}/edit'),
+        ];
+    }
+
+    public static function getRecordRouteBindingEloquentQuery(): Builder
+    {
+        return parent::getRecordRouteBindingEloquentQuery()
+            ->withoutGlobalScopes([
+                SoftDeletingScope::class,
+            ]);
+    }
+}

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();
+    }
+}

app/enum/UsernameType.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\enum;
+
+enum UsernameType: string
+{
+    case PUBLIC = 'public';
+    case PREMIUM = 'premium';
+
+    public function getColor(): string
+    {
+        return match ($this) {
+            self::PUBLIC => 'warning',
+            self::PREMIUM => 'success',
+        };
+    }
+
+    public function getLabel(): string
+    {
+        return match ($this) {
+            self::PUBLIC => 'Public',
+            self::PREMIUM => 'Premium',
+        };
+    }
+}