feat: add domain enums (ArticleStatus with transitions, ArticleCondition, AttributeType, OrderStatus, AIPipelineJob enums)

src/Domain/Article/ArticleCondition.php

@@ -0,0 +1,13 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Article;
+
+enum ArticleCondition: string
+{
+    case New = 'new';
+    case LikeNew = 'like_new';
+    case Good = 'good';
+    case Acceptable = 'acceptable';
+}

src/Domain/Article/ArticleStatus.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Article;
+
+enum ArticleStatus: string
+{
+    case Ingesting = 'ingesting';
+    case Draft = 'draft';
+    case NeedsReview = 'needs_review';
+    case Active = 'active';
+    case Listed = 'listed';
+    case Sold = 'sold';
+
+    /** @return list<self> */
+    public function allowedTransitions(): array
+    {
+        return match ($this) {
+            self::Ingesting => [self::Draft, self::NeedsReview],
+            self::Draft => [self::Active, self::NeedsReview],
+            self::NeedsReview => [self::Draft],
+            self::Active => [self::Listed, self::Draft],
+            self::Listed => [self::Sold, self::Active],
+            self::Sold => [],
+        };
+    }
+
+    public function canTransitionTo(self $next): bool
+    {
+        return \in_array($next, $this->allowedTransitions(), strict: true);
+    }
+}

src/Domain/Article/AttributeType.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Article;
+
+enum AttributeType: string
+{
+    case String = 'string';
+    case Int = 'int';
+    case Float = 'float';
+    case Bool = 'bool';
+    case Select = 'select';
+    case MultiSelect = 'multi_select';
+}

src/Domain/Order/OrderStatus.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Order;
+
+enum OrderStatus: string
+{
+    case Pending = 'pending';
+    case Processing = 'processing';
+    case Shipped = 'shipped';
+    case Completed = 'completed';
+    case Failed = 'failed';
+}

src/Domain/Pipeline/AIPipelineJobStatus.php

@@ -0,0 +1,14 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Pipeline;
+
+enum AIPipelineJobStatus: string
+{
+    case Queued = 'queued';
+    case Processing = 'processing';
+    case Completed = 'completed';
+    case Failed = 'failed';
+    case NeedsReview = 'needs_review';
+}

src/Domain/Pipeline/AIPipelineJobType.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Domain\Pipeline;
+
+enum AIPipelineJobType: string
+{
+    case Photo = 'photo';
+    case Pxe = 'pxe';
+    case TextGeneration = 'text_gen';
+}

tests/Unit/Domain/Article/ArticleStatusTest.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Tests\Unit\Domain\Article;
+
+use App\Domain\Article\ArticleStatus;
+use PHPUnit\Framework\TestCase;
+
+final class ArticleStatusTest extends TestCase
+{
+    public function test_valid_transitions(): void
+    {
+        $this->assertTrue(ArticleStatus::Ingesting->canTransitionTo(ArticleStatus::Draft));
+        $this->assertTrue(ArticleStatus::Draft->canTransitionTo(ArticleStatus::Active));
+        $this->assertTrue(ArticleStatus::Draft->canTransitionTo(ArticleStatus::NeedsReview));
+        $this->assertTrue(ArticleStatus::NeedsReview->canTransitionTo(ArticleStatus::Draft));
+        $this->assertTrue(ArticleStatus::Active->canTransitionTo(ArticleStatus::Listed));
+        $this->assertTrue(ArticleStatus::Listed->canTransitionTo(ArticleStatus::Sold));
+    }
+
+    public function test_invalid_transitions(): void
+    {
+        $this->assertFalse(ArticleStatus::Sold->canTransitionTo(ArticleStatus::Draft));
+        $this->assertFalse(ArticleStatus::Ingesting->canTransitionTo(ArticleStatus::Sold));
+        $this->assertFalse(ArticleStatus::Listed->canTransitionTo(ArticleStatus::Ingesting));
+    }
+}