feat: refactor cart and bundle handling to support Buyable interface for improved flexibility

app/Domains/Bundle/Models/Bundle.php

@@ -2,15 +2,14 @@
 
 namespace App\Domains\Bundle\Models;
 
+use App\Domains\Shared\Contracts\Buyable;
 use App\Domains\Tenant\Models\Tenant;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Casts\Attribute;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
-use Illuminate\Database\Eloquent\Casts\Attribute;
-
-use App\Domains\Shared\Contracts\Stockable;
 
 #[Fillable([
     'tenant_codigo',
@@ -18,7 +17,7 @@ use App\Domains\Shared\Contracts\Stockable;
     'descripcion',
     'precio',
 ])]
-class Bundle extends Model implements Stockable
+class Bundle extends Model implements Buyable
 {
     use HasFactory;
 
@@ -49,36 +48,43 @@ class Bundle extends Model implements Stockable
         return $this->hasMany(BundleItem::class, 'bundle_id');
     }
 
-    public function incrementRealStock(int $amount): void
+    public function getPrice(): float
     {
-        if ($amount < 0) {
-            throw new \InvalidArgumentException('El monto a incrementar debe ser positivo.');
-        }
-
-        foreach ($this->items as $item) {
-            $item->variant->incrementRealStock($amount * $item->cantidad);
-        }
+        return (float) $this->precio;
     }
 
-    public function decrementRealStock(int $amount): void
+    public function getName(): string
     {
-        if ($amount < 0) {
-            throw new \InvalidArgumentException('El monto a decrementar debe ser positivo.');
-        }
-
-        foreach ($this->items as $item) {
-            $item->variant->decrementRealStock($amount * $item->cantidad);
-        }
+        return $this->nombre ?? 'Bundle';
     }
 
-    public function incrementReservedStock(int $amount): void
+    public function availableQuantity(): ?int
+    {
+        if ($this->items->isEmpty()) {
+            return 0;
+        }
+
+        $availableQuantities = [];
+
+        foreach ($this->items as $item) {
+            $variantQuantity = $item->variant?->availableQuantity();
+
+            if ($variantQuantity !== null) {
+                $availableQuantities[] = intdiv($variantQuantity, $item->cantidad);
+            }
+        }
+
+        return $availableQuantities === [] ? null : min($availableQuantities);
+    }
+
+    public function reserveStock(int $amount): void
     {
         if ($amount < 0) {
-            throw new \InvalidArgumentException('El monto a incrementar debe ser positivo.');
+            throw new \InvalidArgumentException('El monto a reservar debe ser positivo.');
         }
 
         foreach ($this->items as $item) {
-            $item->variant->incrementReservedStock($amount * $item->cantidad);
+            $item->variant->reserveStock($amount * $item->cantidad);
         }
     }
 
@@ -93,43 +99,28 @@ class Bundle extends Model implements Stockable
         }
     }
 
-    public function confirmReservedStock(int $amount): void
+    public function buy(int $amount): void
     {
         if ($amount < 0) {
-            throw new \InvalidArgumentException('El monto a confirmar debe ser positivo.');
+            throw new \InvalidArgumentException('El monto a comprar debe ser positivo.');
         }
 
         foreach ($this->items as $item) {
-            $item->variant->confirmReservedStock($amount * $item->cantidad);
+            $item->variant->buy($amount * $item->cantidad);
         }
     }
 
     public function validateStock(): void
     {
-        if ($this->stock_tecnico <= 0) {
-            throw new \InvalidArgumentException('El bundle no tiene stock técnico disponible.');
+        $availableQuantity = $this->availableQuantity();
+
+        if ($availableQuantity !== null && $availableQuantity <= 0) {
+            throw new \InvalidArgumentException('El bundle no tiene stock tecnico disponible.');
         }
     }
 
     protected function stockTecnico(): Attribute
     {
-        return Attribute::get(function () {
-            if ($this->items->isEmpty()) {
-                return 0;
-            }
-            
-            $minStock = PHP_INT_MAX;
-            foreach ($this->items as $item) {
-                // Ensure variant is loaded
-                if ($item->variant) {
-                    $itemStock = floor($item->variant->stock_tecnico / $item->cantidad);
-                    if ($itemStock < $minStock) {
-                        $minStock = $itemStock;
-                    }
-                }
-            }
-            
-            return $minStock === PHP_INT_MAX ? 0 : (int) $minStock;
-        });
+        return Attribute::get(fn (): ?int => $this->availableQuantity());
     }
 }