feat: LAR-175 upgrade the approbation system (#340)

Author: StevyMarlino

app/Actions/Article/DeclineArticleAction.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Actions\Article;
+
+use App\Models\Article;
+use App\Notifications\ArticleDeclinedNotification;
+use Carbon\Carbon;
+use Illuminate\Support\Facades\DB;
+
+final class DeclineArticleAction
+{
+    public function execute(string $reason, Article $article): Article
+    {
+        return DB::transaction(function () use ($reason, $article) {
+
+            $article->update([
+                'declined_at' => Carbon::now(),
+                'reason' => $reason,
+                'submitted_at' => null,
+            ]);
+
+            $article->user->notify(new ArticleDeclinedNotification($article));
+
+            $article->refresh();
+
+            return $article;
+        });
+    }
+}

app/Actions/Article/UpdateArticleAction.php

@@ -31,6 +31,10 @@ public function execute(ArticleData $articleData, Article $article): Article
             );
         }
 
+        if ($articleData->declined_at) {
+            $articleData->declined_at = null;
+        }
+
         $article->update($articleData->toArray());
 
         $article->refresh();

app/Data/ArticleData.php

@@ -17,5 +17,6 @@ public function __construct(
         public ?string $canonical_url = null,
         public ?Carbon $published_at = null,
         public ?Carbon $submitted_at = null,
+        public ?Carbon $declined_at = null,
     ) {}
 }

app/Filament/Resources/ArticleResource.php

@@ -5,10 +5,13 @@
 namespace App\Filament\Resources;
 
 use App\Actions\Article\ApprovedArticleAction;
+use App\Actions\Article\DeclineArticleAction;
 use App\Filament\Resources\ArticleResource\Pages;
 use App\Models\Article;
 use Awcodes\FilamentBadgeableColumn\Components\Badge;
 use Awcodes\FilamentBadgeableColumn\Components\BadgeableColumn;
+use Filament\Forms\Components\Textarea;
+use Filament\Notifications\Notification;
 use Filament\Resources\Resource;
 use Filament\Support\Enums\MaxWidth;
 use Filament\Tables;
@@ -123,15 +126,27 @@ public static function table(Table $table): Table
                         ->label('Décliner')
                         ->icon('heroicon-s-x-mark')
                         ->color('warning')
-                        ->modalHeading(__('Voulez vous décliner cet article'))
-                        ->successNotificationTitle(__('Opération effectuée avec succès'))
+                        ->form([
+                            Textarea::make('reason')
+                                ->label(__('Raison du refus'))
+                                ->maxLength(255)
+                                ->required(),
+                        ])
+                        ->modalHeading('Décliner l\'article')
+                        ->modalDescription('Veuillez fournir une raison détaillée pour le refus de cet article. L\'auteur recevra cette explication.')
+                        ->successNotificationTitle('Article décliné avec succès')
                         ->requiresConfirmation()
                         ->modalIcon('heroicon-s-x-mark')
-                        ->action(function ($record): void {
+                        ->action(function (array $data, Article $record): void {
                             Gate::authorize('decline', $record);
 
-                            $record->declined_at = now();
-                            $record->save();
+                            app(DeclineArticleAction::class)->execute($data['reason'], $record);
+
+                            Notification::make()
+                                ->title('Article décliné')
+                                ->body('L\'auteur a été notifié de la raison du refus.')
+                                ->success()
+                                ->send();
                         }),
                     Tables\Actions\Action::make('show')
                         ->icon('untitledui-eye')

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

@@ -7,6 +7,7 @@
 use App\Filament\Resources\ArticleResource;
 use App\Models\Article;
 use Closure;
+use Filament\Resources\Components\Tab;
 use Filament\Resources\Pages\ListRecords;
 
 final class ListArticles extends ListRecords
@@ -17,4 +18,13 @@ public function isTableRecordSelectable(): Closure
     {
         return fn (Article $record): bool => $record->isNotPublished();
     }
+
+    public function getTabs(): array
+    {
+        return [
+            'En attente' => Tab::make()->query(fn ($query) => $query->awaitingApproval()),
+            'Apprové' => Tab::make()->query(fn ($query) => $query->published()),
+            'Décliné' => Tab::make()->query(fn ($query) => $query->declined()),
+        ];
+    }
 }

app/Models/Article.php

@@ -32,6 +32,7 @@
  * @property bool $is_pinned
  * @property int $is_sponsored
  * @property string | null $canonical_url
+ * @property string | null $reason
  * @property int | null $tweet_id
  * @property int $user_id
  * @property string | null $locale
@@ -63,6 +64,7 @@ final class Article extends Model implements HasMedia, ReactableInterface, Sitem
         'body',
         'slug',
         'canonical_url',
+        'reason',
         'show_toc',
         'is_pinned',
         'user_id',

app/Notifications/ArticleDeclinedNotification.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Notifications;
+
+use App\Models\Article;
+use Illuminate\Bus\Queueable;
+use Illuminate\Notifications\Messages\MailMessage;
+use Illuminate\Notifications\Notification;
+
+final class ArticleDeclinedNotification extends Notification
+{
+    use Queueable;
+
+    public function __construct(public Article $article) {}
+
+    public function via(mixed $notifiable): array
+    {
+        return ['mail', 'database'];
+    }
+
+    public function toMail(mixed $notifiable): MailMessage
+    {
+        return (new MailMessage)
+            ->subject(__('emails/article.article_declined.subject'))
+            ->markdown('emails.article_declined', ['article' => $this->article]);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function toArray(): array
+    {
+        return [
+            'article' => $this->article,
+            'owner' => $this->article->user->name,
+            'email' => $this->article->user->email,
+        ];
+    }
+}

database/migrations/2025_02_20_112613_add_reason_field_to_articles_table.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('articles', static function (Blueprint $table): void {
+            $table->string('reason')->nullable()->after('canonical_url');
+        });
+    }
+};

lang/en/emails/article.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+
+    'article_declined' => [
+        'subject' => 'Your article has been declined',
+        'head' => 'Your article :title has been declined for the following reason:',
+        'recommandation_body' => 'Don\'t be discouraged! You can:',
+        'recommandation_1' => '1. Review your article and the reason for the decline',
+        'recommandation_2' => '2. Make the necessary changes',
+        'recommandation_3' => '3. Resubmit your article once the corrections are made',
+        'help' => 'Our team is here to help you improve your content.',
+        'closing' => 'Best regards,',
+        'team' => 'The Laravel Cameroon Team',
+        'button_update_article' => 'Edit my article',
+    ],
+
+];

lang/fr/emails/article.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+
+    'article_declined' => [
+        'subject' => 'Votre article a été décliné',
+        'head' => 'Votre article :title a été décliné pour la raison suivante :',
+        'recommandation_body' => 'Ne vous découragez pas ! Vous pouvez :',
+        'recommandation_1' => '1. Consulter votre article et la raison du refus',
+        'recommandation_2' => '2. Apporter les modifications nécessaires',
+        'recommandation_3' => '3. Re-soumettre votre article une fois les corrections effectuées',
+        'help' => 'Notre équipe est là pour vous aider à améliorer votre contenu.',
+        'closing' => 'Cordialement,',
+        'team' => 'L\'équipe Laravel Cameroun',
+        'button_update_article' => 'Modifier mon article',
+    ],
+
+];