feat: Implement inventory policy for product variants

- Introduced InventoryPolicy enum to manage tracked and unlimited inventory types.
- Updated ProductVariant model to include inventory_policy and cantidad_vendida attributes.
- Modified addItem and updateItem methods in Cart to check available quantity based on inventory policy.
- Added migration to include inventory_policy and cantidad_vendida in productos_variantes table.
- Enhanced tests to validate inventory behavior for both tracked and unlimited policies.
- Updated various request and resource classes to handle new inventory fields.

tests/Feature/Purchase/StorePurchaseTest.php

@@ -2,14 +2,19 @@
 
 namespace Tests\Feature\Purchase;
 
+use App\Domains\Attachable\Enums\AttachmentType;
+use App\Domains\Attachable\Models\Attachment;
 use App\Domains\Auth\Models\User;
 use App\Domains\Cart\Models\Cart;
+use App\Domains\Catalog\Enums\InventoryPolicy;
+use App\Domains\Catalog\Models\Category;
 use App\Domains\Catalog\Models\Product;
 use App\Domains\Catalog\Models\ProductVariant;
 use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Purchase\Services\CheckoutService;
 use App\Domains\Tenant\Models\Tenant;
 use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Str;
 use Tests\TestCase;
 
 class StorePurchaseTest extends TestCase
@@ -22,7 +27,7 @@ class StorePurchaseTest extends TestCase
         $user = User::factory()->create([
             'email' => 'buyer@example.com',
         ]);
-        $category = \App\Domains\Catalog\Models\Category::query()->create([
+        $category = Category::query()->create([
             'tenant_code' => 'sonder',
             'nombre' => 'Test Category',
         ]);
@@ -237,6 +242,13 @@ class StorePurchaseTest extends TestCase
         $checkoutService->confirmPurchase($purchase);
         $purchase->refresh()->markAsPaid();
 
+        $this->assertDatabaseHas('productos_variantes', [
+            'id' => $variant->id,
+            'stock_real' => 8,
+            'stock_reservado' => 0,
+            'cantidad_vendida' => 2,
+        ]);
+
         $this->assertSoftDeleted('carritos', [
             'id' => $purchase->cart_id,
         ]);
@@ -401,18 +413,48 @@ class StorePurchaseTest extends TestCase
             ->assertJsonValidationErrors(['cart_id']);
     }
 
+    public function test_it_confirms_unlimited_inventory_without_reducing_real_stock_and_is_idempotent(): void
+    {
+        $this->createTenant('sonder', 'Sonder', 'sonder.com.ar');
+        $user = User::factory()->create();
+        $variant = $this->createVariantForTenant(
+            'sonder',
+            0,
+            '50.00',
+            'unlimited',
+            InventoryPolicy::Unlimited,
+        );
+        $purchase = $this->createCheckoutPurchase($user, 'sonder', $variant, 25);
+        $purchase->update(['payment_method' => 'transfer']);
+
+        $checkoutService = app(CheckoutService::class);
+        $purchase = $checkoutService->completePurchase($purchase);
+        $checkoutService->confirmPurchase($purchase);
+        $checkoutService->confirmPurchase($purchase);
+
+        $this->assertDatabaseHas('productos_variantes', [
+            'id' => $variant->id,
+            'inventory_policy' => InventoryPolicy::Unlimited->value,
+            'stock_real' => 0,
+            'stock_reservado' => 0,
+            'cantidad_vendida' => 25,
+        ]);
+        $this->assertDatabaseCount('compra_items', 1);
+    }
+
     protected function createVariantForTenant(
         string $tenantCode,
         int $stock,
         string $price,
         string $slugPrefix = 'shirt',
+        InventoryPolicy $inventoryPolicy = InventoryPolicy::Tracked,
     ): ProductVariant {
         $tenant = Tenant::query()->where('codigo', $tenantCode)->first();
         if (! $tenant) {
             $this->createTenant($tenantCode, ucfirst($tenantCode), "{$tenantCode}.com");
         }
 
-        $category = \App\Domains\Catalog\Models\Category::query()->create([
+        $category = Category::query()->create([
             'tenant_code' => $tenantCode,
             'nombre' => "{$slugPrefix} category {$tenantCode}",
         ]);
@@ -428,6 +470,7 @@ class StorePurchaseTest extends TestCase
 
         return ProductVariant::query()->create([
             'producto_id' => $product->id,
+            'inventory_policy' => $inventoryPolicy->value,
             'slug' => "{$slugPrefix}-variant-".ProductVariant::query()->count(),
             'nombre' => ucfirst($slugPrefix).' Variant',
             'stock' => $stock,
@@ -462,21 +505,21 @@ class StorePurchaseTest extends TestCase
 
     protected function createTenant(string $codigo, string $nombre, string $dominio): Tenant
     {
-        $hdrKey = (string) \Illuminate\Support\Str::uuid();
-        $ftrKey = (string) \Illuminate\Support\Str::uuid();
+        $hdrKey = (string) Str::uuid();
+        $ftrKey = (string) Str::uuid();
 
-        $headerAttachment = \App\Domains\Attachable\Models\Attachment::create([
+        $headerAttachment = Attachment::create([
             'key' => $hdrKey,
-            'path' => 'tenants/' . $hdrKey . '.png',
+            'path' => 'tenants/'.$hdrKey.'.png',
             'filename' => 'logo_header.png',
-            'type' => \App\Domains\Attachable\Enums\AttachmentType::Image,
+            'type' => AttachmentType::Image,
             'mime_type' => 'image/png',
         ]);
-        $footerAttachment = \App\Domains\Attachable\Models\Attachment::create([
+        $footerAttachment = Attachment::create([
             'key' => $ftrKey,
-            'path' => 'tenants/' . $ftrKey . '.png',
+            'path' => 'tenants/'.$ftrKey.'.png',
             'filename' => 'logo_footer.png',
-            'type' => \App\Domains\Attachable\Enums\AttachmentType::Image,
+            'type' => AttachmentType::Image,
             'mime_type' => 'image/png',
         ]);