feat:[LAR-32] Add article list with action in cpanel

app/Filament/Actions/ApprovedAction.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Actions;
+
+use Filament\Actions\Concerns\CanCustomizeProcess;
+use Illuminate\Database\Eloquent\Model;
+
+final class ApprovedAction extends \Filament\Tables\Actions\Action
+{
+    use CanCustomizeProcess;
+
+    public static function getDefaultName(): ?string
+    {
+        return 'approved';
+    }
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->label(__('Approuver'));
+
+        $this->modalHeading(fn (): string => __('Voulez vous approuver cet article', ['label' => $this->getRecordTitle()]));
+
+        $this->modalSubmitActionLabel(__('Approuver'));
+
+        $this->successNotificationTitle(__('Opération effectuée avec succès'));
+
+        $this->color('success');
+
+        $this->icon('heroicon-s-check');
+
+        $this->requiresConfirmation();
+
+        $this->modalIcon('heroicon-s-check');
+
+        $this->action(function (): void {
+            $result = $this->process(static fn (Model $record) => $record->update(['approved_at' => now(), 'declined_at' => null]));
+
+            if (! $result) {
+                $this->failure();
+
+                return;
+            }
+
+            $this->success();
+        });
+    }
+}

app/Filament/Actions/DeclinedAction.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Actions;
+
+use Filament\Actions\Concerns\CanCustomizeProcess;
+use Illuminate\Database\Eloquent\Model;
+
+final class DeclinedAction extends \Filament\Tables\Actions\Action
+{
+    use CanCustomizeProcess;
+
+    public static function getDefaultName(): ?string
+    {
+        return 'declined';
+    }
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->label(__('Décliner'));
+
+        $this->modalHeading(fn (): string => __('Voulez vous décliner cet article', ['label' => $this->getRecordTitle()]));
+
+        $this->modalSubmitActionLabel(__('Décliner'));
+
+        $this->successNotificationTitle(__('Opération effectuée avec succès'));
+
+        $this->color('warning');
+
+        $this->icon('heroicon-s-x-mark');
+
+        $this->requiresConfirmation();
+
+        $this->modalIcon('heroicon-s-x-mark');
+
+        $this->action(function (): void {
+            $result = $this->process(static fn (Model $record) => $record->update(['declined_at' => now(), 'approved_at' => null]));
+
+            if (! $result) {
+                $this->failure();
+
+                return;
+            }
+
+            $this->success();
+        });
+    }
+}

app/Filament/Clusters/Articles.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Clusters;
+
+use Filament\Clusters\Cluster;
+
+final class Articles extends Cluster
+{
+    protected static ?string $navigationIcon = 'heroicon-o-newspaper';
+}

app/Filament/Resources/ArticleResource.php

@@ -0,0 +1,85 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Filament\Resources;
+
+use App\Filament\Actions\ApprovedAction;
+use App\Filament\Actions\DeclinedAction;
+use App\Filament\Resources\ArticleResource\Pages;
+use App\Models\Article;
+use Filament\Resources\Resource;
+use Filament\Tables;
+use Filament\Tables\Actions\ActionGroup;
+use Filament\Tables\Columns\TextColumn;
+use Filament\Tables\Filters\Filter;
+use Filament\Tables\Table;
+use Illuminate\Database\Eloquent\Builder;
+
+final class ArticleResource extends Resource
+{
+    protected static ?string $model = Article::class;
+
+    protected static ?string $navigationIcon = 'heroicon-o-newspaper';
+
+    public static function table(Table $table): Table
+    {
+        return $table
+            ->columns([
+                TextColumn::make('title')
+                    ->label('Titre')
+                    ->sortable(),
+                TextColumn::make('status')
+                    ->getStateUsing(function ($record) {
+                        if ($record->approved_at) {
+                            return 'Approuver';
+                        } elseif ($record->declined_at) {
+                            return 'Décliner';
+                        } elseif ($record->submitted_at) {
+                            return 'Soumis';
+                        } else {
+                            return 'Brouillon';
+                        }
+                    })
+                    ->colors([
+                        'success' => 'Approuver',
+                        'danger' => 'Décliner',
+                        'warning' => 'Soumis',
+                        'default' => 'Brouillon',
+                    ])
+                    ->badge(),
+                TextColumn::make('submitted_at')
+                    ->label('Date de soumission')
+                    ->dateTime(),
+                TextColumn::make('user.name')
+                    ->label('Auteur')
+                    ->sortable(),
+            ])
+            ->filters([
+                Filter::make('submitted_at')->query(fn (Builder $query) => $query->whereNotNull('submitted_at'))->label('Soumis'),
+                Filter::make('declined_at')->query(fn (Builder $query) => $query->whereNotNull('declined_at'))->label('Décliner'),
+                Filter::make('approved_at')->query(fn (Builder $query) => $query->whereNotNull('approved_at'))->label('Approuver'),
+            ])
+
+            ->actions([
+                ActionGroup::make([
+                    ApprovedAction::make('approved'),
+                    DeclinedAction::make('declined'),
+                    Tables\Actions\DeleteAction::make('delete'),
+                ]),
+
+            ])
+            ->bulkActions([
+                Tables\Actions\BulkActionGroup::make([
+                    Tables\Actions\DeleteBulkAction::make(),
+                ]),
+            ]);
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => Pages\ListArticles::route('/'),
+        ];
+    }
+}

app/Filament/Resources/ArticleResource/Pages/ListArticles.php

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

app/Providers/Filament/AdminPanelProvider.php

@@ -39,6 +39,7 @@ public function panel(Panel $panel): Panel
             ->discoverResources(in: app_path('Filament/Resources'), for: 'App\\Filament\\Resources')
             ->discoverPages(in: app_path('Filament/Pages'), for: 'App\\Filament\\Pages')
             ->discoverWidgets(in: app_path('Filament/Widgets'), for: 'App\\Filament\\Widgets')
+            ->discoverClusters(in: app_path('Filament/Clusters'), for: 'App\\Filament\\Clusters')
             ->pages([
                 Pages\Dashboard::class,
             ])

tests/Feature/Filament/ArticleTest.php

@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Filament\Resources\ArticleResource;
+use App\Models\Article;
+use Livewire\Livewire;
+
+beforeEach(function (): void {
+    $this->user = $this->login();
+    $this->articles = Article::factory()->count(10)->create([
+        'submitted_at' => now(),
+    ]);
+});
+
+describe(ArticleResource::class, function (): void {
+
+    it('page can display table with records', function (): void {
+        Livewire::test(ArticleResource\Pages\ListArticles::class)
+            ->assertCanSeeTableRecords($this->articles);
+    });
+
+    it('table can render columns', function (): void {
+        Livewire::test(ArticleResource\Pages\ListArticles::class)
+            ->assertCanRenderTableColumn('title')
+            ->assertCanRenderTableColumn('status')
+            ->assertCanRenderTableColumn('status')
+            ->assertCanRenderTableColumn('submitted_at');
+    });
+
+    it('admin user  can approved article', function (): void {
+        $article = Article::factory()->create(['submitted_at' => now()]);
+
+        Livewire::test(ArticleResource\Pages\ListArticles::class)
+            ->callTableAction('approved', $article);
+
+        $article->refresh();
+
+        expect($article->approved_at)
+            ->not
+            ->toBe(null)
+            ->and($article->declined_at)
+            ->toBe(null);
+    });
+
+    it('admin user can declined article', function (): void {
+        $article = Article::factory()->create(['submitted_at' => now()]);
+
+        Livewire::test(ArticleResource\Pages\ListArticles::class)
+            ->callTableAction('declined', $article);
+
+        $article->refresh();
+
+        expect($article->declined_at)
+            ->not
+            ->toBe(null)
+            ->and($article->approved_at)
+            ->toBe(null);
+    });
+
+})->group('articles');