Add CatalogPlugin scaffold and EvCompany resource (T2.0, T2.1)

Registers CatalogPlugin with the admin panel so catalog Filament
resources auto-discover, and adds the EvCompany model/migration/
factory plus its Filament resource (auto-generated slug on create).

app-modules/catalog/src/CatalogPlugin.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Modules\Catalog;
+
+use Filament\Contracts\Plugin;
+use Filament\Panel;
+
+class CatalogPlugin implements Plugin
+{
+    public function getId(): string
+    {
+        return 'catalog';
+    }
+
+    public function register(Panel $panel): void
+    {
+        $panel
+            ->discoverResources(
+                in: __DIR__.'/Filament/Resources',
+                for: 'Modules\Catalog\Filament\Resources',
+            )
+            ->discoverPages(
+                in: __DIR__.'/Filament/Pages',
+                for: 'Modules\Catalog\Filament\Pages',
+            )
+            ->discoverWidgets(
+                in: __DIR__.'/Filament/Widgets',
+                for: 'Modules\Catalog\Filament\Widgets',
+            );
+    }
+
+    public function boot(Panel $panel): void {}
+
+    public static function make(): static
+    {
+        return app(static::class);
+    }
+}

app-modules/catalog/src/Filament/Resources/EvCompanies/EvCompanyResource.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\EvCompanies;
+
+use BackedEnum;
+use Filament\Resources\Resource;
+use Filament\Schemas\Schema;
+use Filament\Support\Icons\Heroicon;
+use Filament\Tables\Table;
+use Modules\Catalog\Filament\Resources\EvCompanies\Pages\CreateEvCompany;
+use Modules\Catalog\Filament\Resources\EvCompanies\Pages\EditEvCompany;
+use Modules\Catalog\Filament\Resources\EvCompanies\Pages\ListEvCompanies;
+use Modules\Catalog\Filament\Resources\EvCompanies\Schemas\EvCompanyForm;
+use Modules\Catalog\Filament\Resources\EvCompanies\Tables\EvCompaniesTable;
+use Modules\Catalog\Models\EvCompany;
+use UnitEnum;
+
+class EvCompanyResource extends Resource
+{
+    protected static ?string $model = EvCompany::class;
+
+    protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedRectangleStack;
+
+    protected static string|UnitEnum|null $navigationGroup = 'Catalog';
+
+    public static function form(Schema $schema): Schema
+    {
+        return EvCompanyForm::configure($schema);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return EvCompaniesTable::configure($table);
+    }
+
+    public static function getRelations(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => ListEvCompanies::route('/'),
+            'create' => CreateEvCompany::route('/create'),
+            'edit' => EditEvCompany::route('/{record}/edit'),
+        ];
+    }
+}

app-modules/catalog/src/Filament/Resources/EvCompanies/Pages/CreateEvCompany.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\EvCompanies\Pages;
+
+use Filament\Resources\Pages\CreateRecord;
+use Modules\Catalog\Filament\Resources\EvCompanies\EvCompanyResource;
+
+class CreateEvCompany extends CreateRecord
+{
+    protected static string $resource = EvCompanyResource::class;
+}

app-modules/catalog/src/Filament/Resources/EvCompanies/Pages/EditEvCompany.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\EvCompanies\Pages;
+
+use Filament\Actions\DeleteAction;
+use Filament\Resources\Pages\EditRecord;
+use Modules\Catalog\Filament\Resources\EvCompanies\EvCompanyResource;
+
+class EditEvCompany extends EditRecord
+{
+    protected static string $resource = EvCompanyResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            DeleteAction::make(),
+        ];
+    }
+}

app-modules/catalog/src/Filament/Resources/EvCompanies/Pages/ListEvCompanies.php

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

app-modules/catalog/src/Filament/Resources/EvCompanies/Schemas/EvCompanyForm.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\EvCompanies\Schemas;
+
+use Filament\Forms\Components\FileUpload;
+use Filament\Forms\Components\Textarea;
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Components\Toggle;
+use Filament\Schemas\Schema;
+
+class EvCompanyForm
+{
+    public static function configure(Schema $schema): Schema
+    {
+        return $schema
+            ->components([
+                TextInput::make('name')
+                    ->required()
+                    ->maxLength(255),
+                TextInput::make('mm_name')
+                    ->required()
+                    ->maxLength(255),
+                Textarea::make('description')
+                    ->columnSpanFull(),
+                Textarea::make('mm_description')
+                    ->columnSpanFull(),
+                TextInput::make('contact')
+                    ->required()
+                    ->tel()
+                    ->maxLength(255),
+                TextInput::make('address')
+                    ->required()
+                    ->maxLength(255),
+                FileUpload::make('logo')
+                    ->image(),
+                Toggle::make('is_active')
+                    ->required()
+                    ->default(true),
+            ]);
+    }
+}

app-modules/catalog/src/Filament/Resources/EvCompanies/Tables/EvCompaniesTable.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Modules\Catalog\Filament\Resources\EvCompanies\Tables;
+
+use Filament\Actions\BulkActionGroup;
+use Filament\Actions\DeleteBulkAction;
+use Filament\Actions\EditAction;
+use Filament\Tables\Columns\IconColumn;
+use Filament\Tables\Columns\ImageColumn;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Filters\TernaryFilter;
+use Filament\Tables\Table;
+
+class EvCompaniesTable
+{
+    public static function configure(Table $table): Table
+    {
+        return $table
+            ->columns([
+                ImageColumn::make('logo')
+                    ->circular(),
+                TextColumn::make('name')
+                    ->searchable()
+                    ->sortable(),
+                TextColumn::make('slug')
+                    ->searchable(),
+                TextColumn::make('contact')
+                    ->searchable(),
+                IconColumn::make('is_active')
+                    ->boolean(),
+                TextColumn::make('created_at')
+                    ->dateTime()
+                    ->sortable()
+                    ->toggleable(isToggledHiddenByDefault: true),
+            ])
+            ->defaultSort('created_at', 'desc')
+            ->filters([
+                TernaryFilter::make('is_active'),
+            ])
+            ->recordActions([
+                EditAction::make(),
+            ])
+            ->toolbarActions([
+                BulkActionGroup::make([
+                    DeleteBulkAction::make(),
+                ]),
+            ]);
+    }
+}

app-modules/catalog/src/Models/EvCompany.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace Modules\Catalog\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Str;
+use Modules\Catalog\Database\Factories\EvCompanyFactory;
+
+class EvCompany extends Model
+{
+    /** @use HasFactory<EvCompanyFactory> */
+    use HasFactory;
+
+    /**
+     * @var list<string>
+     */
+    protected $fillable = [
+        'name',
+        'mm_name',
+        'slug',
+        'description',
+        'mm_description',
+        'contact',
+        'address',
+        'logo',
+        'is_active',
+    ];
+
+    protected static function booted(): void
+    {
+        static::creating(function (self $evCompany): void {
+            if (filled($evCompany->slug)) {
+                return;
+            }
+
+            $slug = Str::slug($evCompany->name);
+            $uniqueSlug = $slug;
+            $suffix = 1;
+
+            while (static::where('slug', $uniqueSlug)->exists()) {
+                $uniqueSlug = "{$slug}-{$suffix}";
+                $suffix++;
+            }
+
+            $evCompany->slug = $uniqueSlug;
+        });
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    protected function casts(): array
+    {
+        return [
+            'is_active' => 'boolean',
+        ];
+    }
+}