feat:[LAR-34] Add filament tags crud in cpanel with feature test

.gitignore

@@ -4,7 +4,7 @@
 npm-debug.log
 yarn-error.log
 yarn.lock
-
+package-lock.json
 /vendor
 composer.phar
 

app/Filament/Resources/TagResource.php

@@ -0,0 +1,89 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources;
+
+use App\Filament\Resources\TagResource\Pages;
+use App\Models\Tag;
+use Filament\Forms;
+use Filament\Forms\Components\Select;
+use Filament\Forms\Form;
+use Filament\Forms\Get;
+use Filament\Forms\Set;
+use Filament\Resources\Resource;
+use Filament\Tables;
+use Filament\Tables\Table;
+use Illuminate\Support\Str;
+
+final class TagResource extends Resource
+{
+    protected static ?string $model = Tag::class;
+
+    protected static ?string $navigationIcon = 'heroicon-o-tag';
+
+    public static function form(Form $form): Form
+    {
+        return $form
+            ->schema([
+                Forms\Components\TextInput::make('name')
+                    ->required()
+                    ->live(onBlur: true)
+                    ->afterStateUpdated(function (Get $get, Set $set, ?string $old, ?string $state): void {
+                        if (($get('slug') ?? '') !== Str::slug($old)) {
+                            return;
+                        }
+                        $set('slug', Str::slug($state));
+                    }),
+                Forms\Components\TextInput::make('slug')
+                    ->required(),
+                Select::make('concerns')
+                    ->multiple()
+                    ->options([
+                        'post' => 'Post',
+                        'tutorial' => 'Tutorial',
+                        'discussion' => 'Discussion',
+                    ])
+                    ->required()
+                    ->columnSpanFull(),
+                Forms\Components\Textarea::make('description')
+                    ->columnSpanFull(),
+            ]);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return $table
+            ->columns([
+                Tables\Columns\TextColumn::make('name')
+                    ->searchable(),
+                Tables\Columns\TextColumn::make('slug')
+                    ->searchable(),
+                Tables\Columns\TextColumn::make(name: 'concerns'),
+            ])
+            ->filters([
+                //
+            ])
+            ->actions([
+                \Filament\Tables\Actions\ActionGroup::make([
+                    Tables\Actions\DeleteAction::make(),
+                    Tables\Actions\EditAction::make()
+                        ->color('warning'),
+                ]),
+            ])
+            ->bulkActions([
+                Tables\Actions\BulkActionGroup::make([
+                    Tables\Actions\DeleteBulkAction::make(),
+                ]),
+            ]);
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => Pages\ListTags::route('/'),
+            'create' => Pages\CreateTag::route('/create'),
+            'edit' => Pages\EditTag::route('/{record}/edit'),
+        ];
+    }
+}

app/Filament/Resources/TagResource/Pages/CreateTag.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources\TagResource\Pages;
+
+use App\Filament\Resources\TagResource;
+use Filament\Resources\Pages\CreateRecord;
+
+final class CreateTag extends CreateRecord
+{
+    protected static string $resource = TagResource::class;
+}

app/Filament/Resources/TagResource/Pages/EditTag.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources\TagResource\Pages;
+
+use App\Filament\Resources\TagResource;
+use Filament\Actions;
+use Filament\Resources\Pages\EditRecord;
+
+final class EditTag extends EditRecord
+{
+    protected static string $resource = TagResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            Actions\DeleteAction::make(),
+        ];
+    }
+}

app/Filament/Resources/TagResource/Pages/ListTags.php

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

tests/Feature/Filament/TagTest.php

@@ -0,0 +1,105 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Filament\Resources\TagResource;
+use App\Filament\Resources\TagResource\Pages\CreateTag;
+use App\Filament\Resources\TagResource\Pages\ListTags;
+use App\Models\Tag;
+use Filament\Actions\EditAction;
+use Illuminate\Database\Eloquent\Factories\Sequence;
+use Livewire\Livewire;
+
+beforeEach(function (): void {
+    $this->user = $this->login();
+    $this->tags = Tag::factory()
+        ->count(10)
+        ->state(new Sequence(
+            ['concerns' => ['post', 'tutorial']],
+            ['concerns' => ['post']],
+        ))
+        ->create();
+});
+
+describe(TagResource::class, function (): void {
+
+    it('page can display table with records', function (): void {
+        Livewire::test(ListTags::class)
+            ->assertCanSeeTableRecords($this->tags);
+    });
+
+    it('can automatically generate a slug from the title', function (): void {
+        $name = fake()->name();
+
+        Livewire::test(CreateTag::class)
+            ->fillForm([
+                'name' => $name,
+            ])
+            ->assertFormSet([
+                'slug' => Str::slug($name),
+            ]);
+    });
+
+    it('can validate input is value is null or empty', function (): void {
+        $name = fake()->name();
+
+        Livewire::test(CreateTag::class)
+            ->fillForm([
+                'name' => null,
+                'concerns' => [],
+                'description' => 'Description du tag '.$name,
+            ])
+            ->call('create')
+            ->assertHasFormErrors(['name' => 'required', 'concerns' => 'required']);
+    });
+
+    it('Admin user can create tag', function (): void {
+        $name = fake()->name();
+
+        Livewire::test(CreateTag::class)
+            ->fillForm([
+                'name' => $name,
+                'concerns' => ['post', 'tutorial'],
+                'description' => 'Description du tag '.$name,
+            ])
+            ->call('create');
+    });
+
+    it('Generate tag if tag already exist', function (): void {
+
+        $name = fake()->name();
+        Tag::factory()->create([
+            'name' => $name,
+            'slug' => Str::slug($name),
+            'concerns' => ['discussion'],
+        ]);
+
+        Livewire::test(CreateTag::class)
+            ->fillForm([
+                'name' => $name,
+                'concerns' => ['post', 'tutorial'],
+                'description' => 'Description du tag '.$name,
+            ])
+            ->call('create');
+
+        expect(Tag::orderByDesc('id')->first()->slug)
+            ->toBe(Str::slug($name).'-1');
+
+    });
+
+    it('Admin user can edit tag', function (): void {
+        $tag = Tag::factory()->create();
+
+        Livewire::test(ListTags::class)
+            ->callTableAction(EditAction::class, $tag, data: [
+                'name' => 'Edited tag',
+            ])
+            ->assertHasNoTableActionErrors();
+
+        $tag->refresh();
+
+        expect($tag->name)
+            ->toBe('Edited tag');
+    });
+
+})->group('tags');