feat: implement product controller, service, and feature tests with updated API collection.

app/Domains/Catalog/Controllers/ProductController.php

@@ -15,19 +15,10 @@ use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 
 class ProductController extends Controller
 {
-    public function index(Tenant $tenant): JsonResponse
+    public function index(Tenant $tenant, ProductService $productService): JsonResponse
     {
         return ProductResource::collection(
-            Product::query()
-                ->where('tenant_codigo', $tenant->codigo)
-                ->with([
-                    'attachments' => fn ($query) => $query->orderBy('attachments.id')->limit(1),
-                    'brand',
-                    'category',
-                    'attributes.options',
-                ])
-                ->latest()
-                ->paginateFromRequest()
+            $productService->getProductos($tenant)
         )->response();
     }
 

app/Domains/Catalog/Services/ProductService.php

@@ -244,4 +244,37 @@ class ProductService
             Product::deleteAttribute($attribute);
         });
     }
+
+    /**
+     * Get products for a tenant with resolved first image (with fallback to first variant's first image).
+     */
+    public function getProductos(Tenant $tenant): \Illuminate\Contracts\Pagination\LengthAwarePaginator
+    {
+        $products = Product::query()
+            ->where('tenant_codigo', $tenant->codigo)
+            ->with([
+                'attachments' => fn ($query) => $query->orderBy('attachments.id'),
+                'brand',
+                'category',
+                'variants.attachments' => fn ($query) => $query->orderBy('attachments.id'),
+            ])
+            ->latest()
+            ->paginateFromRequest();
+
+        foreach ($products as $product) {
+            $resolvedAttachment = null;
+            if ($product->attachments->isNotEmpty()) {
+                $resolvedAttachment = $product->attachments->first();
+            } else {
+                $firstVariant = $product->variants->sortBy('id')->first();
+                if ($firstVariant && $firstVariant->attachments->isNotEmpty()) {
+                    $resolvedAttachment = $firstVariant->attachments->first();
+                }
+            }
+
+            $product->setRelation('attachments', $resolvedAttachment ? collect([$resolvedAttachment]) : collect());
+        }
+
+        return $products;
+    }
 }