feat: enhance product detail retrieval to support variant selection and fallback image handling

app/Domains/Catalog/Services/ProductService.php

@@ -10,6 +10,7 @@ use App\Domains\Tenant\Models\Tenant;
 use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 use Illuminate\Http\UploadedFile;
 use Illuminate\Support\Facades\DB;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 
 class ProductService
 {
@@ -281,16 +282,35 @@ class ProductService
         return $products;
     }
 
-    public function getProductDetail(Tenant $tenant, Product $product): Product
+    public function getProductDetail(Tenant $tenant, Product $product, ?int $variantId = null): Product
     {
         $product->load([
-            'attachments',
+            'attachments' => fn ($query) => $query->orderBy('attachments.id'),
+            'attributes.options',
             'brand',
             'category',
             'variants' => fn ($query) => $query->orderBy('id'),
             'variants.definitions.productAttribute.attribute.options',
         ]);
 
+        $selectedVariant = $variantId !== null
+            ? $product->variants->firstWhere('id', $variantId)
+            : $product->variants->first(fn (ProductVariant $variant) => $variant->stock > 0);
+
+        if ($variantId !== null && $selectedVariant === null) {
+            throw new NotFoundHttpException('Product variant not found for product.');
+        }
+
+        $selectedVariant ??= $product->variants->first();
+
+        if ($selectedVariant !== null) {
+            $selectedVariant->load([
+                'attachments' => fn ($query) => $query->orderBy('attachments.id'),
+            ]);
+            $selectedVariant->setRelation('fallbackAttachments', $product->attachments);
+            $product->setSelectedVariant($selectedVariant);
+        }
+
         return $product;
     }
 }