feat: implement product management module with CRUD operations, service layer, and validation logic

app/Domains/Catalog/Controllers/ProductController.php

@@ -29,16 +29,12 @@ class ProductController extends Controller
         return ProductResource::make($product)->response()->setStatusCode(201);
     }
 
-    public function show(Tenant $tenant, Product $producto): ProductResource
+    public function show(Tenant $tenant, Product $producto, ProductService $productService): ProductResource
     {
         $producto = $this->resolveScopedProduct($tenant, $producto);
+        $producto = $productService->getProductDetail($tenant, $producto);
 
-        return ProductResource::make($producto->load([
+        return ProductResource::make($producto);
-            'attachments',
-            'brand',
-            'category',
-            'attributes.options',
-        ]));
     }
 
     public function update(UpdateProductRequest $request, Tenant $tenant, Product $producto, ProductService $productService): ProductResource

app/Domains/Catalog/Models/Product.php

@@ -27,7 +27,8 @@ class Product extends Model
     use HasFactory;
 
     protected $table = 'productos';
-
+    
+    protected ?ProductVariant $defaultVariant = null;
     protected function casts(): array
     {
         return [
@@ -274,4 +275,16 @@ class Product extends Model
         $attribute->options()->delete();
         $attribute->delete();
     }
+
+    
+
+    public function setDefaultVariant(ProductVariant $variant): void
+    {
+        $this->defaultVariant = $variant;
+    }
+
+    public function getDefaultVariant(): ?ProductVariant
+    {
+        return $this->defaultVariant;
+    }
 }

app/Domains/Catalog/Resources/ProductResource.php

@@ -32,6 +32,22 @@ class ProductResource extends JsonResource
                     ->values()
             ),
             'attributes' => AttributeResource::collection($this->whenLoaded('attributes')),
+            'variants' => ProductVariantResource::collection($this->whenLoaded('variants')),
+            'default_variant' => $this->when(
+                $this->getDefaultVariant() !== null,
+                function () {
+                    $defaultVariant = $this->getDefaultVariant();
+                    return [
+                        'variant_id' => $defaultVariant->id,
+                        'images' => $defaultVariant->attachments->isNotEmpty()
+                            ? $defaultVariant->attachments->map(fn ($attachment) => $attachment->getTemporaryUrl(1440))->values()
+                            : $this->attachments->map(fn ($attachment) => $attachment->getTemporaryUrl(1440))->values(),
+                        'attributes' => $defaultVariant->definitions->mapWithKeys(function ($definition) {
+                            return [$definition->attribute?->codigo => $definition->value];
+                        })->toArray(),
+                    ];
+                }
+            ),
         ];
     }
 }

app/Domains/Catalog/Services/ProductService.php

@@ -277,4 +277,27 @@ class ProductService
 
         return $products;
     }
+
+    public function getProductDetail(Tenant $tenant, Product $product): Product
+    {
+        $product->load([
+            'attachments',
+            'brand',
+            'category',
+            'attributes.options',
+        ]);
+
+        $defaultVariant = $product->variants()
+            ->with([
+                'attachments',
+                'definitions.attribute.options',
+            ])
+            ->first();
+
+        if ($defaultVariant) {
+            $product->setDefaultVariant($defaultVariant);
+        }
+
+        return $product;
+    }
 }

tests/Feature/Catalog/ProductControllerTest.php

@@ -389,6 +389,75 @@ class ProductControllerTest extends TestCase
         ]);
     }
 
+    public function test_it_returns_product_detail_with_variants_and_default_variant(): void
+    {
+        // 1. Create a product
+        $product = Product::create([
+            'tenant_codigo' => $this->tenant->codigo,
+            'categoria_id' => 1,
+            'slug' => 'test-product-show',
+            'nombre' => 'Test Product Show',
+            'precio' => 100.00,
+        ]);
+
+        // Associate attributes to product
+        $product->attributes()->sync([$this->sizeAttr->id, $this->colorAttr->id]);
+
+        // 2. Create variant
+        $variant = $product->createVariant([
+            'slug' => 'test-product-show-s-azul',
+            'nombre' => 'Test Product Show S Azul',
+            'stock' => 10,
+            'precio' => 105.00,
+            'definitions' => [
+                [
+                    'attribute_id' => $this->sizeAttr->id,
+                    'value' => 'S',
+                ],
+                [
+                    'attribute_id' => $this->colorAttr->id,
+                    'value' => 'Azul',
+                ],
+            ],
+        ]);
+
+        // Attach an image to the variant
+        $attachment = \App\Domains\Attachable\Models\Attachment::create([
+            'key' => (string) Str::uuid(),
+            'path' => 'attachments/variant-img.png',
+            'filename' => 'variant-img.png',
+            'type' => \App\Domains\Attachable\Enums\AttachmentType::Image,
+            'mime_type' => 'image/png',
+        ]);
+        $variant->attachments()->attach($attachment->id);
+
+        // 3. Request product show detail
+        $response = $this->getJson("/api/tenants/{$this->tenant->codigo}/productos/{$product->id}");
+
+        $response->assertOk();
+
+        // 4. Assert default_variant structure and data
+        $response->assertJsonStructure([
+            'data' => [
+                'id',
+                'nombre',
+                'default_variant' => [
+                    'variant_id',
+                    'images',
+                    'attributes' => [
+                        'talle',
+                        'color',
+                    ],
+                ],
+            ],
+        ]);
+
+        $response->assertJsonPath('data.default_variant.variant_id', $variant->id);
+        $response->assertJsonPath('data.default_variant.attributes.talle', 'S');
+        $response->assertJsonPath('data.default_variant.attributes.color', 'Azul');
+        $response->assertJsonCount(1, 'data.default_variant.images');
+    }
+
     protected function createTenant(string $codigo, string $nombre, string $dominio): Tenant
     {
         $hdrKey = (string) Str::uuid();