feat: add category support to article creation and updates, including validation and relationships

Author: aspirantzhang

contexts/ArticlePublishing/Application/Coordinators/ArticlePublishingCoordinator.php

@@ -10,6 +10,7 @@
 use Contexts\ArticlePublishing\Application\DTOs\CreateArticleDTO;
 use Contexts\ArticlePublishing\Application\DTOs\GetArticleListDTO;
 use Contexts\ArticlePublishing\Application\DTOs\UpdateArticleDTO;
+use Contexts\ArticlePublishing\Domain\Gateway\CategoryGateway;
 use Contexts\ArticlePublishing\Domain\Models\Article;
 use Contexts\ArticlePublishing\Domain\Models\ArticleId;
 use Contexts\ArticlePublishing\Domain\Models\ArticleStatus;
@@ -19,7 +20,8 @@
 class ArticlePublishingCoordinator extends BaseCoordinator
 {
     public function __construct(
-        private ArticleRepository $repository
+        private ArticleRepository $repository,
+        private CategoryGateway $categoryGateway
     ) {}
 
     public function create(CreateArticleDTO $data): Article
@@ -42,6 +44,7 @@ private function createDraft(CreateArticleDTO $data): Article
             ArticleId::null(),
             $data->title,
             $data->body,
+            $this->categoryGateway->getArticleCategories($data->category_ids),
             $data->created_at ? CarbonImmutable::parse($data->created_at) : null
         );
 
@@ -54,6 +57,7 @@ private function createPublished(CreateArticleDTO $data): Article
             ArticleId::null(),
             $data->title,
             $data->body,
+            $this->categoryGateway->getArticleCategories($data->category_ids),
             $data->created_at ? CarbonImmutable::parse($data->created_at) : null
         );
 
@@ -87,6 +91,7 @@ public function updateArticle(int $id, UpdateArticleDTO $data): Article
             $data->title,
             $data->body,
             $data->status ? ArticleStatus::fromString($data->status) : null,
+            $this->categoryGateway->getArticleCategories($data->category_ids),
             $data->created_at ? CarbonImmutable::parse($data->created_at) : null
         );
 

contexts/ArticlePublishing/Application/DTOs/CreateArticleDTO.php

@@ -10,6 +10,7 @@ public function __construct(
         public readonly string $title,
         public readonly string $body,
         public readonly string $status,
+        public readonly array $category_ids,
         public readonly ?string $created_at
     ) {}
 
@@ -19,6 +20,7 @@ public static function fromRequest(array $data): self
             $data['title'],
             $data['body'] ?? '',
             $data['status'] ?? 'draft',
+            $data['category_ids'] ?? [],
             $data['created_at'] ?? null,
         );
     }

contexts/ArticlePublishing/Application/DTOs/GetArticleListDTO.php

@@ -10,6 +10,7 @@ public function __construct(
         public readonly ?string $id,
         public readonly ?string $title,
         public readonly ?string $status,
+        public readonly ?int $categoryId,
         public readonly ?array $createdAtRange,
         public readonly int $page,
         public readonly int $perPage,
@@ -21,6 +22,7 @@ public static function fromRequest(array $data): self
             $data['id'] ?? null,
             $data['title'] ?? null,
             $data['status'] ?? null,
+            $data['category_id'] ?? null,
             $data['created_at_range'] ?? null,
             $data['page'] ?? 1,
             $data['per_page'] ?? 10,
@@ -33,6 +35,7 @@ public function toCriteria(): array
             'id' => $this->id,
             'title' => $this->title,
             'status' => $this->status,
+            'category_id' => $this->categoryId,
             'created_at_range' => $this->createdAtRange,
         ];
     }

contexts/ArticlePublishing/Application/DTOs/UpdateArticleDTO.php

@@ -10,6 +10,7 @@ public function __construct(
         public readonly ?string $title,
         public readonly ?string $body,
         public readonly ?string $status,
+        public readonly ?array $category_ids,
         public readonly ?string $created_at
     ) {}
 
@@ -19,6 +20,7 @@ public static function fromRequest(array $data): self
             $data['title'] ?? null,
             $data['body'] ?? null,
             $data['status'] ?? null,
+            $data['category_ids'] ?? null,
             $data['created_at'] ?? null,
         );
     }

contexts/ArticlePublishing/Infrastructure/Migrations/2025_03_01_022301_create_articles_table.php

@@ -19,6 +19,14 @@ public function up(): void
             $table->text('body')->nullable();
             $table->tinyInteger('status')->default(0)->comment('0: draft, 1: published, 2: archived, 3: deleted');
             $table->timestamps();
+            $table->softDeletes();
+        });
+
+        Schema::create('pivot_article_category', function (Blueprint $table) {
+            $table->increments('id');
+            $table->unsignedInteger('article_id');
+            $table->unsignedInteger('category_id');
+            $table->timestamps();
         });
     }
 

contexts/ArticlePublishing/Infrastructure/Records/ArticleRecord.php

@@ -7,9 +7,13 @@
 use App\Exceptions\SysException;
 use App\Http\Models\BaseModel;
 use Contexts\ArticlePublishing\Domain\Models\Article;
+use Contexts\ArticlePublishing\Domain\Models\ArticleCategory;
+use Contexts\ArticlePublishing\Domain\Models\ArticleCategoryCollection;
 use Contexts\ArticlePublishing\Domain\Models\ArticleId;
 use Contexts\ArticlePublishing\Domain\Models\ArticleStatus;
+use Contexts\CategoryManagement\Infrastructure\Records\CategoryRecord;
 use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Support\Carbon;
 
 /**
@@ -22,10 +26,17 @@
  */
 class ArticleRecord extends BaseModel
 {
+    use SoftDeletes;
+
     protected $table = 'articles';
 
     protected $fillable = ['title', 'body', 'status', 'created_at'];
 
+    public function categories()
+    {
+        return $this->belongsToMany(CategoryRecord::class, 'pivot_article_category', 'article_id', 'category_id');
+    }
+
     public const STATUS_MAPPING = [
         0 => 'draft',
         1 => 'published',
@@ -53,11 +64,16 @@ public static function mapStatusToRecord(ArticleStatus $status): int
 
     public function toDomain(array $events = []): Article
     {
+        $categories = new ArticleCategoryCollection(
+            $this->categories()->get()->map(fn ($category) => new ArticleCategory($category->id, $category->label))->toArray()
+        );
+
         return Article::reconstitute(
             ArticleId::fromInt($this->id),
             $this->title,
             $this->body,
             self::mapStatusToDomain($this->status),
+            $categories,
             $this->created_at->toImmutable(),
             $this->updated_at?->toImmutable(),
             events: $events
@@ -78,6 +94,12 @@ public function scopeSearch(Builder $query, array $criteria = [])
             $query->where('status', $criteria['status']);
         });
 
+        $query->when(isset($criteria['category_id']), function ($query) use ($criteria) {
+            $query->whereHas('categories', function ($query) use ($criteria) {
+                $query->where('category_id', $criteria['category_id']);
+            });
+        });
+
         $query->when(isset($criteria['created_at_range']), function ($query) use ($criteria) {
             [$start, $end] = $criteria['created_at_range'];
             $query->whereBetween('created_at', [$start, $end]);

contexts/ArticlePublishing/Presentation/Requests/CreateArticleRequest.php

@@ -14,6 +14,8 @@ public function rules(): array
             'title' => ['required', 'string', 'max:255'],
             'body' => ['string', 'max:20000'],
             'status' => ['required', 'string', 'in:draft,published'],
+            'category_ids' => ['array'],
+            'category_ids.*' => ['integer', 'gt:0'],
             'created_at' => ['date', 'date_format: Y-m-d H:i:s'],
         ];
     }

contexts/ArticlePublishing/Presentation/Requests/GetArticleListRequest.php

@@ -14,6 +14,7 @@ public function rules(): array
             'id' => ['integer', 'gt:0'],
             'title' => ['string', 'max:255'],
             'status' => ['string', 'in:draft,published'],
+            'category_id' => ['integer', 'gt:0'],
             'created_at_range' => ['array', 'size:2'],
             'created_at_range.*' => ['date'],
             'page' => ['integer', 'gt:0'],

contexts/ArticlePublishing/Presentation/Requests/UpdateArticleRequest.php

@@ -15,6 +15,8 @@ public function rules(): array
             'title' => ['string', 'max:255'],
             'body' => ['string', 'max:20000'],
             'status' => ['string', 'in:draft,published'],
+            'category_ids' => ['array'],
+            'category_ids.*' => ['integer', 'gt:0'],
             'created_at' => ['date', 'date_format: Y-m-d H:i:s'],
         ];
     }

contexts/ArticlePublishing/Presentation/Resources/ArticleResource.php

@@ -22,7 +22,10 @@ public function toArray(Request $request): array
             'title' => (string) $article->getTitle(),
             'body' => (string) $article->getbody(),
             'status' => (string) $article->getStatus()->getValue(),
-
+            'categories' => $article->getCategories()->map(fn ($category) => [
+                'id' => $category->getId(),
+                'label' => $category->getLabel(),
+            ])->toArray(),
             'created_at' => $article->getCreatedAt()->format('Y-m-d H:i:s'),
             'updated_at' => $article->getUpdatedAt()?->format('Y-m-d H:i:s'),
         ];