feat: enhance purchase detail handling to support cart items and improve resource structure

app/Domains/Purchase/Controllers/PurchaseController.php

@@ -19,7 +19,6 @@ class PurchaseController extends Controller
     {
         return PurchaseResource::collection(
             Purchase::query()
-                ->with(['items.variant.product', 'items.variant.definitions.productAttribute.attribute'])
                 ->where('tenant_codigo', $tenant->codigo)
                 ->where('user_id', $request->user()->id)
                 ->when($request->query('status'), function ($query, $status) {
@@ -48,7 +47,7 @@ class PurchaseController extends Controller
         $compra = $this->resolveScopedPurchase($tenant, $request->user()->id, $compra);
 
         return PurchaseResource::make(
-            $compra->loadMissing(['items.variant.product', 'items.variant.definitions.productAttribute.attribute'])
+            $compra->loadMissing($this->purchaseDetailRelations())
         );
     }
 
@@ -140,4 +139,19 @@ class PurchaseController extends Controller
 
         return $purchase;
     }
+
+    /**
+     * @return list<string>
+     */
+    protected function purchaseDetailRelations(): array
+    {
+        return [
+            'items.variant.product',
+            'items.variant.definitions.productAttribute.attribute',
+            'items.variant.attachments',
+            'cart.items.variant.product',
+            'cart.items.variant.definitions.productAttribute.attribute',
+            'cart.items.variant.attachments',
+        ];
+    }
 }

app/Domains/Purchase/Resources/PurchaseItemResource.php

@@ -2,12 +2,13 @@
 
 namespace App\Domains\Purchase\Resources;
 
-use App\Domains\Catalog\Resources\ProductVariantDefinitionResource;
+use App\Domains\Cart\Models\CartItem;
+use App\Domains\Purchase\Models\PurchaseItem;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
 
 /**
- * @mixin \App\Domains\Purchase\Models\PurchaseItem
+ * @mixin \App\Domains\Purchase\Models\PurchaseItem|\App\Domains\Cart\Models\CartItem
  */
 class PurchaseItemResource extends JsonResource
 {
@@ -18,24 +19,90 @@ class PurchaseItemResource extends JsonResource
     {
         $variant = $this->variant;
         $product = $variant?->product;
+        $quantity = (int) ($this->cantidad ?? 0);
+        $unitPrice = $this->resolveUnitPrice();
+        $lineTotal = $this->resolveLineTotal($unitPrice, $quantity);
 
         return [
             'id' => $this->id,
-            'cantidad' => $this->cantidad,
-            'precio_unitario' => $this->formatMoney($this->precio_unitario),
-            'total' => $this->formatMoney($this->total),
+            'quantity' => $quantity,
+            'unit_price' => $this->formatMoney($unitPrice),
+            'line_total' => $this->formatMoney($lineTotal),
             'product' => $product === null ? null : [
                 'id' => $product->id,
                 'nombre' => $product->nombre,
                 'slug' => $product->slug,
+                'imagen' => $this->resolveImageUrl(),
             ],
             'variant' => $variant === null ? null : [
                 'id' => $variant->id,
-                'definitions' => ProductVariantDefinitionResource::collection($variant->definitions),
+                'attributes' => $this->resolveAttributes(),
             ],
         ];
     }
 
+    protected function resolveUnitPrice(): float
+    {
+        if ($this->resource instanceof PurchaseItem) {
+            return (float) ($this->precio_unitario ?? 0);
+        }
+
+        if ($this->resource instanceof CartItem) {
+            return (float) ($this->variant?->product?->precio ?? 0);
+        }
+
+        return 0.0;
+    }
+
+    protected function resolveLineTotal(float $unitPrice, int $quantity): float
+    {
+        if ($this->resource instanceof PurchaseItem) {
+            return (float) ($this->total ?? 0);
+        }
+
+        return $unitPrice * $quantity;
+    }
+
+    protected function resolveImageUrl(): ?string
+    {
+        $variant = $this->variant;
+
+        if ($variant === null || ! $variant->relationLoaded('attachments')) {
+            return null;
+        }
+
+        $attachment = $variant->attachments->first();
+
+        if ($attachment === null) {
+            return null;
+        }
+
+        return $attachment->getTemporaryUrl(1440);
+    }
+
+    /**
+     * @return array<int, array{name: string, value: mixed}>
+     */
+    protected function resolveAttributes(): array
+    {
+        $variant = $this->variant;
+
+        if ($variant === null || ! $variant->relationLoaded('definitions')) {
+            return [];
+        }
+
+        return $variant->definitions
+            ->map(function ($definition): array {
+                return [
+                    'name' => (string) ($definition->productAttribute?->attribute?->nombre ?? ''),
+                    'value' => $definition->value,
+                ];
+            })
+            ->filter(fn (array $attribute): bool => $attribute['name'] !== '' || $attribute['value'] !== null)
+            ->values()
+            ->all();
+    }
+
     protected function formatMoney(float|int|string|null $amount): ?string
     {
         if ($amount === null) {

app/Domains/Purchase/Resources/PurchaseResource.php

@@ -2,8 +2,11 @@
 
 namespace App\Domains\Purchase\Resources;
 
+use App\Domains\Cart\Models\CartItem;
+use App\Domains\Purchase\Models\PurchaseItem;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
+use Illuminate\Support\Collection;
 
 /**
  * @mixin \App\Domains\Purchase\Models\Purchase
@@ -15,20 +18,18 @@ class PurchaseResource extends JsonResource
      */
     public function toArray(Request $request): array
     {
-        $items = $this->resource->relationLoaded('items')
-            ? $this->resource->getRelation('items')
-            : collect();
+        [$items, $itemsSource] = $this->resolveItems();
 
         $subtotal = $items->isNotEmpty()
             ? $items->reduce(
-                fn (float $carry, $item): float => $carry + ((float) $item->precio_unitario * $item->cantidad),
+                fn (float $carry, PurchaseItem|CartItem $item): float => $carry + $this->resolveItemSubtotal($item),
                 0.0,
             )
             : (float) ($this->total ?? 0);
 
         $total = $items->isNotEmpty()
             ? $items->reduce(
-                fn (float $carry, $item): float => $carry + (float) $item->total,
+                fn (float $carry, PurchaseItem|CartItem $item): float => $carry + $this->resolveItemTotal($item),
                 0.0,
             )
             : (float) ($this->total ?? 0);
@@ -38,18 +39,66 @@ class PurchaseResource extends JsonResource
             'cart_id' => $this->cart_id,
             'tenant_codigo' => $this->tenant_codigo,
             'user_id' => $this->user_id,
+            'created_at' => $this->created_at,
             'status' => $this->status,
             'payment_method' => $this->payment_method,
             'dni' => $this->dni,
             'telefono' => $this->telefono,
             'nombre_apellido' => $this->nombre_apellido,
             'email' => $this->email,
+            'items_source' => $itemsSource,
             'items' => PurchaseItemResource::collection($items),
             'subtotal' => $this->formatMoney($subtotal),
             'total' => $this->formatMoney($total),
         ];
     }
 
+    /**
+     * @return array{0: Collection<int, PurchaseItem|CartItem>, 1: string|null}
+     */
+    protected function resolveItems(): array
+    {
+        if (! $this->resource->relationLoaded('items')) {
+            return [collect(), null];
+        }
+
+        $purchaseItems = $this->resource->getRelation('items');
+
+        if ($purchaseItems->isNotEmpty()) {
+            return [$purchaseItems, 'purchase'];
+        }
+
+        if (! $this->resource->relationLoaded('cart')) {
+            return [collect(), null];
+        }
+
+        $cart = $this->resource->getRelation('cart');
+
+        if ($cart === null || ! $cart->relationLoaded('items')) {
+            return [collect(), null];
+        }
+
+        return [$cart->getRelation('items'), 'cart'];
+    }
+
+    protected function resolveItemSubtotal(PurchaseItem|CartItem $item): float
+    {
+        if ($item instanceof PurchaseItem) {
+            return (float) $item->precio_unitario * $item->cantidad;
+        }
+
+        return (float) ($item->variant?->product?->precio ?? 0) * $item->cantidad;
+    }
+
+    protected function resolveItemTotal(PurchaseItem|CartItem $item): float
+    {
+        if ($item instanceof PurchaseItem) {
+            return (float) ($item->total ?? 0);
+        }
+
+        return $this->resolveItemSubtotal($item);
+    }
+
     protected function formatMoney(float|int|string|null $amount): string
     {
         return number_format((float) ($amount ?? 0), 2, '.', '');