docs(postman): regenerate collection after API cleanup

docs(menu): describe internal-only configuration
docs(integration): remove deleted endpoint references
2026-08-27 12:11:08 -03:00 · 2026-08-27 12:11:08 -03:00 · 2026-08-27 12:11:08 -03:00 · 2026-08-27 12:11:08 -03:00 · 2026-08-27 12:11:08 -03:00 · 2026-08-27 12:10:57 -03:00
113 changed files with 2441 additions and 6261 deletions
--- a/.env.example
+++ b/.env.example
@@ -5,9 +5,6 @@ APP_DEBUG=false
 APP_URL=http://localhost

 PURCHASE_CHECKOUT_EXPIRATION_MINUTES=30
-PURCHASE_QR_EXPIRATION_MINUTES=15
-PURCHASE_TELEPAGOS_EXPIRATION_MINUTES=30
-PURCHASE_TRANSFER_EXPIRATION_MINUTES=1440
 STOCK_RESERVATION_EXPIRATION_MINUTES=30
 FRONTEND_URLS=http://localhost:4200

@@ -31,6 +28,7 @@ AUTH_LOGIN_ATTEMPT_WINDOW_MINUTES=30
 AUTH_LOGIN_LOCK_MINUTES=15
 AUTH_LOGIN_RATE_LIMIT_PER_MINUTE=10
 AUTH_LOGIN_IP_RATE_LIMIT_PER_MINUTE=30
+AUTH_PASSWORD_RESET_EXPIRATION_MINUTES=60

 LOG_CHANNEL=daily
 LOG_STACK=single
--- a/ShopIt_API_Postman_Collection.json
+++ b/ShopIt_API_Postman_Collection.json
--- a/app/Domains/Auth/Controllers/ValidateResetPasswordAttemptController.php
+++ b/app/Domains/Auth/Controllers/ValidateResetPasswordAttemptController.php
@@ -22,10 +22,18 @@ class ValidateResetPasswordAttemptController extends Controller
    {
        $data = $request->validated();

-        if (! $this->resetPasswordAttemptService->validateCode(
+        $result = $this->resetPasswordAttemptService->validateCode(
            $data['email'],
            $data['codigo'],
-        )) {
+        );
+
+        if ($result === ResetPasswordAttemptService::CODE_EXPIRED) {
+            throw ValidationException::withMessages([
+                'codigo' => __('api.auth.reset_code_expired'),
+            ]);
+        }
+
+        if ($result !== ResetPasswordAttemptService::CODE_VALID) {
            throw ValidationException::withMessages([
                'codigo' => __('api.auth.reset_code_invalid'),
            ]);
--- a/app/Domains/Auth/Models/ResetPasswordAttempt.php
+++ b/app/Domains/Auth/Models/ResetPasswordAttempt.php
@@ -7,7 +7,7 @@ use Illuminate\Database\Eloquent\Attributes\Hidden;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;

-#[Fillable(['user_id', 'codigo', 'reason', 'status'])]
+#[Fillable(['user_id', 'codigo', 'reason', 'status', 'expires_at'])]
 #[Hidden(['codigo'])]
 class ResetPasswordAttempt extends Model
 {
@@ -31,6 +31,7 @@ class ResetPasswordAttempt extends Model
    {
        return [
            'user_id' => 'integer',
+            'expires_at' => 'datetime',
        ];
    }

--- a/app/Domains/Auth/Services/ResetPasswordAttemptService.php
+++ b/app/Domains/Auth/Services/ResetPasswordAttemptService.php
@@ -12,6 +12,12 @@ use Throwable;

 class ResetPasswordAttemptService
 {
+    public const CODE_VALID = 'valid';
+
+    public const CODE_INVALID = 'invalid';
+
+    public const CODE_EXPIRED = 'expired';
+
    public function createForEmail(
        string $email,
        string $tenantCode,
@@ -146,12 +152,12 @@ class ResetPasswordAttemptService
        );
    }

-    public function validateCode(string $email, string $code): bool
+    public function validateCode(string $email, string $code): string
    {
        $emailFingerprint = $this->emailFingerprint($email);

        try {
-            return DB::transaction(function () use ($email, $code, $emailFingerprint): bool {
+            return DB::transaction(function () use ($email, $code, $emailFingerprint): string {
                $user = User::query()
                    ->where('email', $email)
                    ->lockForUpdate()
@@ -169,14 +175,27 @@ class ResetPasswordAttemptService
                        'email_fingerprint' => $emailFingerprint,
                    ]);

-                    return false;
+                    return self::CODE_INVALID;
+                }
+
+                if ($attempt->expires_at?->isPast()) {
+                    $attempt->update([
+                        'status' => ResetPasswordAttempt::STATUS_EXPIRED,
+                    ]);
+
+                    Log::info('Password reset code validation failed: attempt expired.', [
+                        'email_fingerprint' => $emailFingerprint,
+                        'attempt_id' => $attempt->getKey(),
+                    ]);
+
+                    return self::CODE_EXPIRED;
                }

                $attempt->update([
                    'status' => ResetPasswordAttempt::STATUS_VALIDATED,
                ]);

-                return true;
+                return self::CODE_VALID;
            });
        } catch (Throwable $exception) {
            Log::error('Failed to validate password reset code.', [
@@ -214,6 +233,19 @@ class ResetPasswordAttemptService
                    return false;
                }

+                if ($attempt->expires_at?->isPast()) {
+                    $attempt->update([
+                        'status' => ResetPasswordAttempt::STATUS_EXPIRED,
+                    ]);
+
+                    Log::info('Password reset failed: attempt expired.', [
+                        'email_fingerprint' => $emailFingerprint,
+                        'attempt_id' => $attempt->getKey(),
+                    ]);
+
+                    return false;
+                }
+
                $user->password = $password;
                $user->failed_login_attempts = 0;
                $user->last_failed_login_at = null;
@@ -270,6 +302,7 @@ class ResetPasswordAttemptService
            'codigo' => $this->generateCode(),
            'reason' => $reason,
            'status' => ResetPasswordAttempt::STATUS_PENDING,
+            'expires_at' => now()->addMinutes((int) config('auth.passwords.users.expire')),
        ]);

        return $attempt->getKey();
--- a/app/Domains/Cart/Models/Cart.php
+++ b/app/Domains/Cart/Models/Cart.php
@@ -5,6 +5,7 @@ namespace App\Domains\Cart\Models;
 use App\Domains\Auth\Models\User;
 use App\Domains\Catalog\Models\CatalogItem;
 use App\Domains\Catalog\Models\Inventory;
+use App\Domains\Catalog\Models\StockReservation;
 use App\Domains\Catalog\Models\Variant;
 use App\Domains\Catalog\Services\CatalogInventoryService;
 use App\Domains\Catalog\Services\StockReservationService;
@@ -28,6 +29,7 @@ use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
    'status',
    'origin',
    'current_purchase_id',
+    'current_stock_reservation_id',
 ])]
 class Cart extends Model
 {
@@ -36,6 +38,16 @@ class Cart extends Model

    protected $table = 'carritos';

+    public const STATUS_ACTIVE = 'active';
+
+    public const STATUS_CHECKOUT = 'checkout';
+
+    public const STATUS_CONVERTED = 'converted';
+
+    public const STATUS_EXPIRED = 'expired';
+
+    public const STATUS_ABANDONED = 'abandoned';
+
    public const ORIGIN_USER = 'user';

    public const ORIGIN_DIRECT_CHECKOUT = 'direct_checkout';
@@ -45,6 +57,7 @@ class Cart extends Model
        return [
            'user_id' => 'integer',
            'current_purchase_id' => 'integer',
+            'current_stock_reservation_id' => 'integer',
        ];
    }

@@ -84,6 +97,15 @@ class Cart extends Model
        return $this->belongsTo(Purchase::class, 'current_purchase_id');
    }

+    /** @return BelongsTo<StockReservation, $this> */
+    public function currentStockReservation(): BelongsTo
+    {
+        return $this->belongsTo(
+            StockReservation::class,
+            'current_stock_reservation_id',
+        );
+    }
+
    public function getTotalAmount(): float
    {
        $items = $this->relationLoaded('items')
@@ -107,6 +129,7 @@ class Cart extends Model

        return DB::transaction(function () use ($catalogItemId, $variantId, $quantity): CartItem {
            $this->invalidateCurrentCheckout();
+            app(StockReservationService::class)->assertCartReservationUsable($this);
            $selectedItem = $this->resolveScopedItem($catalogItemId, $variantId, true);
            $cartQuantity = (int) $this->items()
                ->where('catalog_item_id', $catalogItemId)
@@ -140,12 +163,11 @@ class Cart extends Model
                    'cantidad' => $quantity,
                ]);
            } else {
-                app(StockReservationService::class)->ensure($item, $selectedItem);
                $item->cantidad += $quantity;
                $item->save();
            }

-            app(StockReservationService::class)->reserve($item, $selectedItem, $quantity);
+            app(StockReservationService::class)->syncCart($this);

            return $item->fresh();
        });
@@ -172,6 +194,7 @@ class Cart extends Model
            $excludedPurchaseId,
        ): CartItem {
            $this->invalidateCurrentCheckout();
+            app(StockReservationService::class)->assertCartReservationUsable($this);

            /** @var CartItem $item */
            $item = $this->items()
@@ -205,7 +228,6 @@ class Cart extends Model
                    $nextAvailableQuantity,
                );

-                app(StockReservationService::class)->release($item, $currentSelection, $item->cantidad);
                $availableQuantity = $inventoryService->availableQuantity($nextSelection);

                if ($availableQuantity !== null && $availableQuantity < $quantity) {
@@ -222,11 +244,10 @@ class Cart extends Model
                    ->first();

                if ($targetItem !== null) {
-                    app(StockReservationService::class)->ensure($targetItem, $nextSelection);
                    $targetItem->cantidad += $quantity;
                    $targetItem->save();
-                    app(StockReservationService::class)->reserve($targetItem, $nextSelection, $quantity);
                    $item->delete();
+                    app(StockReservationService::class)->syncCart($this);

                    return $targetItem->fresh();
                }
@@ -234,7 +255,7 @@ class Cart extends Model
                $item->variant_id = $variantId;
                $item->cantidad = $quantity;
                $item->save();
-                app(StockReservationService::class)->reserve($item, $nextSelection, $quantity);
+                app(StockReservationService::class)->syncCart($this);

                return $item->fresh();
            }
@@ -263,16 +284,9 @@ class Cart extends Model
                ]);
            }

-            if ($delta > 0) {
-                app(StockReservationService::class)->reserve($item, $currentSelection, $delta);
-            }
-
-            if ($delta < 0) {
-                app(StockReservationService::class)->release($item, $currentSelection, abs($delta));
-            }
-
            $item->cantidad = $quantity;
            $item->save();
+            app(StockReservationService::class)->syncCart($this);

            return $item->fresh();
        });
@@ -282,6 +296,7 @@ class Cart extends Model
    {
        DB::transaction(function () use ($cartItemId): void {
            $this->invalidateCurrentCheckout();
+            app(StockReservationService::class)->assertCartReservationUsable($this);

            /** @var CartItem $item */
            $item = $this->items()
@@ -289,17 +304,8 @@ class Cart extends Model
                ->lockForUpdate()
                ->firstOrFail();

-            $selectedItem = $this->resolveScopedItem(
-                $item->catalog_item_id,
-                $item->variant_id,
-                true,
-            );
-            app(StockReservationService::class)->release(
-                $item,
-                $selectedItem,
-                $item->cantidad,
-            );
            $item->delete();
+            app(StockReservationService::class)->syncCart($this);
        });
    }

@@ -341,13 +347,20 @@ class Cart extends Model
            Purchase::STATUS_CREATED,
            Purchase::STATUS_PENDING_PAYMENT,
        ], true)) {
+            app(StockReservationService::class)->returnToCart($currentPurchase, $cart);
            $currentPurchase->update([
                'status' => Purchase::STATUS_SUPERSEDED,
-                'expires_at' => null,
            ]);
+
+            $this->current_purchase_id = null;
+
+            return;
        }

-        app(StockReservationService::class)->detachFromPurchase($currentPurchase);
+        app(StockReservationService::class)->releaseForPurchase(
+            $currentPurchase,
+            reason: StockReservationService::REASON_PURCHASE_SUPERSEDED,
+        );
        self::query()
            ->whereKey($cart->getKey())
            ->where('current_purchase_id', $currentPurchase->getKey())
--- a/app/Domains/Cart/Models/CartItem.php
+++ b/app/Domains/Cart/Models/CartItem.php
@@ -3,13 +3,11 @@
 namespace App\Domains\Cart\Models;

 use App\Domains\Catalog\Models\CatalogItem;
-use App\Domains\Catalog\Models\StockReservation;
 use App\Domains\Catalog\Models\Variant;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
-use Illuminate\Database\Eloquent\Relations\HasMany;

 #[Fillable([
    'cart_id',
@@ -57,10 +55,4 @@ class CartItem extends Model
    {
        return $this->variant ?? $this->catalogItem;
    }
-
-    /** @return HasMany<StockReservation, $this> */
-    public function stockReservations(): HasMany
-    {
-        return $this->hasMany(StockReservation::class);
-    }
 }
--- a/app/Domains/Cart/Services/CartService.php
+++ b/app/Domains/Cart/Services/CartService.php
@@ -4,9 +4,12 @@ namespace App\Domains\Cart\Services;

 use App\Domains\Auth\Models\User;
 use App\Domains\Cart\Models\Cart;
+use App\Domains\Catalog\Exceptions\StockReservationExpiredException;
+use App\Domains\Catalog\Services\ExpireStockReservationsService;
 use App\Domains\Tenant\Models\Tenant;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
 use Illuminate\Validation\ValidationException;
 use Symfony\Component\HttpFoundation\Cookie;
@@ -22,7 +25,7 @@ class CartService
            return $this->makeEmptyCart($tenant);
        }

-        $cart = $this->findCart($tenant, $resolvedIdentity['identity']);
+        $cart = $this->resolveCart($tenant, $resolvedIdentity['identity']);

        if ($cart === null) {
            return $this->makeEmptyCart($tenant);
@@ -119,7 +122,7 @@ class CartService
    {
        $cart = new Cart([
            'tenant_codigo' => $tenant->codigo,
-            'status' => 'active',
+            'status' => Cart::STATUS_ACTIVE,
        ]);

        $cart->setRelation('items', collect());
@@ -220,12 +223,14 @@ class CartService
    {
        return Cart::query()
            ->where('tenant_codigo', $tenant->codigo)
-            ->where('status', 'active')
+            ->where('origin', Cart::ORIGIN_USER)
+            ->whereIn('status', [Cart::STATUS_ACTIVE, Cart::STATUS_EXPIRED])
            ->when(
                $identity['user_id'] !== null,
                fn ($query) => $query->where('user_id', $identity['user_id']),
                fn ($query) => $query->where('guest_token', $identity['guest_token']),
            )
+            ->orderByRaw('CASE WHEN status = ? THEN 0 ELSE 1 END', [Cart::STATUS_ACTIVE])
            ->first();
    }

@@ -234,7 +239,7 @@ class CartService
     */
    protected function findCartOrFail(Tenant $tenant, array $identity): Cart
    {
-        $cart = $this->findCart($tenant, $identity);
+        $cart = $this->resolveCart($tenant, $identity, replaceExpired: false);

        if ($cart === null) {
            throw new NotFoundHttpException('Cart not found.');
@@ -247,10 +252,73 @@ class CartService
     * @param  array{user_id: ?int, guest_token: ?string}  $identity
     */
    protected function findOrCreateCart(Tenant $tenant, array $identity): Cart
+    {
+        return $this->resolveCart($tenant, $identity)
+            ?? $this->createCart($tenant, $identity);
+    }
+
+    /**
+     * @param  array{user_id: ?int, guest_token: ?string}  $identity
+     */
+    protected function resolveCart(
+        Tenant $tenant,
+        array $identity,
+        bool $replaceExpired = true,
+    ): ?Cart {
+        $cart = $this->findCart($tenant, $identity);
+
+        if ($cart?->status === Cart::STATUS_ACTIVE
+            && $cart->current_stock_reservation_id !== null
+            && app(ExpireStockReservationsService::class)
+                ->expireIfOverdue($cart->current_stock_reservation_id)) {
+            $cart = $this->findCart($tenant, $identity);
+        }
+
+        if ($cart?->status === Cart::STATUS_EXPIRED) {
+            if (! $replaceExpired) {
+                throw new StockReservationExpiredException;
+            }
+
+            return $this->replaceExpiredCart($cart, $tenant, $identity);
+        }
+
+        if ($cart !== null) {
+            return $cart;
+        }
+
+        return null;
+    }
+
+    /**
+     * @param  array{user_id: ?int, guest_token: ?string}  $identity
+     */
+    protected function replaceExpiredCart(Cart $expiredCart, Tenant $tenant, array $identity): Cart
+    {
+        return DB::transaction(function () use ($expiredCart, $tenant, $identity): Cart {
+            /** @var Cart|null $lockedCart */
+            $lockedCart = Cart::query()->lockForUpdate()->find($expiredCart->getKey());
+
+            if ($lockedCart?->status === Cart::STATUS_EXPIRED) {
+                $lockedCart->update([
+                    'status' => Cart::STATUS_ABANDONED,
+                    'current_purchase_id' => null,
+                ]);
+            }
+
+            return $this->findCart($tenant, $identity)
+                ?? $this->createCart($tenant, $identity);
+        });
+    }
+
+    /**
+     * @param  array{user_id: ?int, guest_token: ?string}  $identity
+     */
+    protected function createCart(Tenant $tenant, array $identity): Cart
    {
        $attributes = [
            'tenant_codigo' => $tenant->codigo,
-            'status' => 'active',
+            'status' => Cart::STATUS_ACTIVE,
+            'origin' => Cart::ORIGIN_USER,
        ];

        if ($identity['user_id'] !== null) {
--- a/app/Domains/Cart/Services/ExpireCartReservationsService.php
+++ b/app/Domains/Cart/Services/ExpireCartReservationsService.php
@@ -1,123 +0,0 @@
-<?php
-
-namespace App\Domains\Cart\Services;
-
-use App\Domains\Cart\Models\Cart;
-use App\Domains\Cart\Models\CartItem;
-use App\Domains\Catalog\Models\Inventory;
-use App\Domains\Catalog\Models\StockReservation;
-use Illuminate\Support\Facades\DB;
-
-class ExpireCartReservationsService
-{
-    public function expireOverdue(): int
-    {
-        $expiredItems = 0;
-        $lastCartItemId = 0;
-
-        do {
-            $cartItemIds = StockReservation::query()
-                ->where('status', StockReservation::STATUS_ACTIVE)
-                ->whereNull('purchase_id')
-                ->whereNotNull('cart_item_id')
-                ->whereNotNull('expires_at')
-                ->where('expires_at', '<=', now())
-                ->where('cart_item_id', '>', $lastCartItemId)
-                ->whereHas('cartItem.cart', fn ($query) => $query->where('status', 'active'))
-                ->select('cart_item_id')
-                ->distinct()
-                ->orderBy('cart_item_id')
-                ->limit(500)
-                ->pluck('cart_item_id');
-
-            foreach ($cartItemIds as $cartItemId) {
-                $lastCartItemId = (int) $cartItemId;
-
-                if ($this->expireCartItem($lastCartItemId)) {
-                    $expiredItems++;
-                }
-            }
-        } while ($cartItemIds->count() === 500);
-
-        return $expiredItems;
-    }
-
-    private function expireCartItem(int $cartItemId): bool
-    {
-        /** @var CartItem|null $candidate */
-        $candidate = CartItem::query()->select(['id', 'cart_id'])->find($cartItemId);
-        if ($candidate === null) {
-            return false;
-        }
-
-        return DB::transaction(function () use ($candidate, $cartItemId): bool {
-            /** @var Cart|null $cart */
-            $cart = Cart::query()
-                ->whereKey($candidate->cart_id)
-                ->where('status', 'active')
-                ->lockForUpdate()
-                ->first();
-
-            if ($cart === null) {
-                return false;
-            }
-
-            /** @var CartItem|null $cartItem */
-            $cartItem = $cart->items()
-                ->whereKey($cartItemId)
-                ->lockForUpdate()
-                ->first();
-
-            if ($cartItem === null) {
-                return false;
-            }
-
-            $reservations = StockReservation::query()
-                ->where('cart_item_id', $cartItem->getKey())
-                ->where('status', StockReservation::STATUS_ACTIVE)
-                ->orderBy('inventory_id')
-                ->lockForUpdate()
-                ->get();
-
-            if (
-                $reservations->isEmpty()
-                || $reservations->contains(
-                    fn (StockReservation $reservation): bool => $reservation->purchase_id !== null
-                        || $reservation->expires_at === null
-                        || $reservation->expires_at->isFuture(),
-                )
-            ) {
-                return false;
-            }
-
-            $inventories = Inventory::query()
-                ->whereKey($reservations->pluck('inventory_id'))
-                ->orderBy('id')
-                ->lockForUpdate()
-                ->get()
-                ->keyBy('id');
-
-            foreach ($reservations as $reservation) {
-                $inventory = $inventories->get($reservation->inventory_id)
-                    ?? throw new \InvalidArgumentException('No se encontro el inventario reservado.');
-
-                $inventory->release((int) $reservation->quantity);
-                $reservation->update([
-                    'quantity' => 0,
-                    'status' => StockReservation::STATUS_EXPIRED,
-                    'expires_at' => null,
-                    'released_at' => now(),
-                ]);
-            }
-
-            $cartItem->delete();
-
-            if (! $cart->items()->exists()) {
-                $cart->update(['status' => 'expired']);
-                $cart->delete();
-            }
-
-            return true;
-        });
-    }
-}
--- a/app/Domains/Cart/documentacion/README.md
+++ b/app/Domains/Cart/documentacion/README.md
@@ -6,13 +6,12 @@ Gestiona el carrito activo de un tenant tanto para visitantes como para usuarios

 ## Modelo

- `Cart`: pertenece a un tenant y opcionalmente a un usuario; calcula el total y permite agregar, actualizar o quitar ítems.
+- `Cart`: pertenece a un tenant y opcionalmente a un usuario; calcula el total, permite agregar, actualizar o quitar ítems y apunta a su reserva de stock vigente mediante `current_stock_reservation_id`.
 - `CartItem`: referencia un `CatalogItem` y, opcionalmente, una `Variant`; sólo persiste la selección y cantidad, y expone siempre los datos vigentes del catálogo.

 ## Servicios

 - `CartService`: obtiene el carrito, modifica ítems y administra la cookie del token invitado.
- `ExpireCartReservationsService`: libera las reservas vencidas de carritos activos y elimina los carritos que quedan vacíos.
 - `GuestCartMergeService`: incorpora el carrito invitado al usuario cuando este se autentica.

 ## Endpoints
@@ -34,4 +33,6 @@ Depende de `Catalog` para productos y variantes, de `Tenant` para aislar datos y

 Un carrito puede pasar a `checkout`. Las compras directas usan un carrito técnico con `origin=direct_checkout`; los carritos normales conservan `origin=user` y pueden restaurarse al cancelar o vencer la compra.

-El comando unificado `php artisan reservations:expire` procesa primero las compras vencidas y luego las reservas activas sin compra cuyo `expires_at` haya vencido. Se ejecuta cada minuto mediante el scheduler, conserva la fila de reserva con estado `expired`, elimina el ítem abandonado y elimina lógicamente el carrito cuando queda vacío. Cada intento registra sus resultados o su error en el log diario `storage/logs/commands/commands-AAAA-MM-DD.log`.
+Cada edición sincroniza una única reserva para el carrito completo. Si varios ítems o bundles consumen el mismo inventario, se persiste una sola línea con la cantidad agregada. Al editar durante checkout, la compra anterior queda `superseded`, se desvincula y el carrito conserva la misma reserva activa con sus líneas actualizadas.
+
+El comando unificado `php artisan reservations:expire` recorre una sola vez las reservas activas cuyo `expires_at` haya vencido. Cuando pertenecen a un carrito, conserva la reserva y sus líneas como historial, libera el stock como conjunto y cambia el carrito asociado a `expired` sin eliminar sus ítems. Al volver a resolver ese carrito desde la API, el anterior pasa automáticamente a `abandoned` y se crea uno activo y vacío para la misma identidad. El cliente nunca necesita reiniciarlo explícitamente. La API también materializa este vencimiento al acceder al carrito aunque el comando programado todavía no haya corrido.
--- a/app/Domains/Catalog/Controllers/AdminApp/OnTicketFeaturedGroupController.php
+++ b/app/Domains/Catalog/Controllers/AdminApp/OnTicketFeaturedGroupController.php
@@ -1,65 +0,0 @@
-<?php
-
-namespace App\Domains\Catalog\Controllers\AdminApp;
-
-use App\Domains\Catalog\Models\FeaturedGroup;
-use App\Domains\Catalog\Requests\AdminApp\UpsertOnTicketFeaturedGroupRequest;
-use App\Domains\Catalog\Resources\AdminApp\OnTicketFeaturedGroupResource;
-use App\Domains\Catalog\Services\OnTicketFeaturedGroupService;
-use App\Domains\Tenant\Models\Tenant;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
-use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
-
-class OnTicketFeaturedGroupController extends Controller
-{
-    public function __construct(
-        private readonly OnTicketFeaturedGroupService $featuredGroupService,
-    ) {}
-
-    public function index(Request $request): AnonymousResourceCollection
-    {
-        return OnTicketFeaturedGroupResource::collection(
-            $this->featuredGroupService->forTenant($this->onTicketTenant($request))
-        );
-    }
-
-    public function store(UpsertOnTicketFeaturedGroupRequest $request): JsonResponse
-    {
-        $featuredGroup = $this->featuredGroupService->create(
-            $this->onTicketTenant($request),
-            $request->validated(),
-        );
-
-        return OnTicketFeaturedGroupResource::make($featuredGroup)
-            ->response()
-            ->setStatusCode(201);
-    }
-
-    public function update(
-        UpsertOnTicketFeaturedGroupRequest $request,
-        FeaturedGroup $featuredGroup,
-    ): OnTicketFeaturedGroupResource {
-        $tenant = $this->onTicketTenant($request);
-
-        abort_unless($featuredGroup->tenant_code === $tenant->codigo, 404);
-
-        return OnTicketFeaturedGroupResource::make(
-            $this->featuredGroupService->update(
-                $tenant,
-                $featuredGroup,
-                $request->validated(),
-            )
-        );
-    }
-
-    private function onTicketTenant(Request $request): Tenant
-    {
-        $tenant = $request->user()->tenant()->firstOrFail();
-
-        abort_unless($tenant->website_type_code === 'onticket', 404);
-
-        return $tenant;
-    }
-}
--- a/app/Domains/Catalog/Exceptions/StockReservationExpiredException.php
+++ b/app/Domains/Catalog/Exceptions/StockReservationExpiredException.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace App\Domains\Catalog\Exceptions;
+
+use RuntimeException;
+
+class StockReservationExpiredException extends RuntimeException
+{
+    public function __construct()
+    {
+        parent::__construct(__('api.cart.reservation_expired'));
+    }
+}
--- a/app/Domains/Catalog/Models/Inventory.php
+++ b/app/Domains/Catalog/Models/Inventory.php
@@ -48,10 +48,10 @@ class Inventory extends Model
        return $this->hasOne(Variant::class);
    }

-    /** @return HasMany<StockReservation, $this> */
-    public function stockReservations(): HasMany
+    /** @return HasMany<StockReservationLine, $this> */
+    public function stockReservationLines(): HasMany
    {
-        return $this->hasMany(StockReservation::class);
+        return $this->hasMany(StockReservationLine::class);
    }

    public function availableStock(): int
--- a/app/Domains/Catalog/Models/StockReservation.php
+++ b/app/Domains/Catalog/Models/StockReservation.php
@@ -2,21 +2,20 @@

 namespace App\Domains\Catalog\Models;

-use App\Domains\Cart\Models\CartItem;
+use App\Domains\Cart\Models\Cart;
 use App\Domains\Purchase\Models\Purchase;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\HasOne;

 #[Fillable([
-    'inventory_id',
-    'cart_item_id',
-    'purchase_id',
-    'quantity',
    'status',
    'expires_at',
    'committed_at',
    'released_at',
+    'expired_at',
+    'release_reason',
 ])]
 class StockReservation extends Model
 {
@@ -31,31 +30,28 @@ class StockReservation extends Model
    protected function casts(): array
    {
        return [
-            'inventory_id' => 'integer',
-            'cart_item_id' => 'integer',
-            'purchase_id' => 'integer',
-            'quantity' => 'integer',
            'expires_at' => 'datetime',
            'committed_at' => 'datetime',
            'released_at' => 'datetime',
+            'expired_at' => 'datetime',
        ];
    }

-    /** @return BelongsTo<Inventory, $this> */
-    public function inventory(): BelongsTo
+    /** @return HasMany<StockReservationLine, $this> */
+    public function lines(): HasMany
    {
-        return $this->belongsTo(Inventory::class);
+        return $this->hasMany(StockReservationLine::class);
    }

-    /** @return BelongsTo<CartItem, $this> */
-    public function cartItem(): BelongsTo
+    /** @return HasOne<Cart, $this> */
+    public function currentCart(): HasOne
    {
-        return $this->belongsTo(CartItem::class);
+        return $this->hasOne(Cart::class, 'current_stock_reservation_id');
    }

-    /** @return BelongsTo<Purchase, $this> */
-    public function purchase(): BelongsTo
+    /** @return HasOne<Purchase, $this> */
+    public function purchase(): HasOne
    {
-        return $this->belongsTo(Purchase::class);
+        return $this->hasOne(Purchase::class);
    }
 }
--- a/app/Domains/Catalog/Models/StockReservationLine.php
+++ b/app/Domains/Catalog/Models/StockReservationLine.php
@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Domains\Catalog\Models;
+
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+#[Fillable([
+    'stock_reservation_id',
+    'inventory_id',
+    'quantity',
+    'tracks_inventory',
+])]
+class StockReservationLine extends Model
+{
+    protected function casts(): array
+    {
+        return [
+            'stock_reservation_id' => 'integer',
+            'inventory_id' => 'integer',
+            'quantity' => 'integer',
+            'tracks_inventory' => 'boolean',
+        ];
+    }
+
+    /** @return BelongsTo<StockReservation, $this> */
+    public function reservation(): BelongsTo
+    {
+        return $this->belongsTo(StockReservation::class, 'stock_reservation_id');
+    }
+
+    /** @return BelongsTo<Inventory, $this> */
+    public function inventory(): BelongsTo
+    {
+        return $this->belongsTo(Inventory::class);
+    }
+}
--- a/app/Domains/Catalog/Requests/AdminApp/UpsertOnTicketFeaturedGroupRequest.php
+++ b/app/Domains/Catalog/Requests/AdminApp/UpsertOnTicketFeaturedGroupRequest.php
@@ -1,22 +0,0 @@
-<?php
-
-namespace App\Domains\Catalog\Requests\AdminApp;
-
-use Illuminate\Foundation\Http\FormRequest;
-
-class UpsertOnTicketFeaturedGroupRequest extends FormRequest
-{
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    /** @return array<string, mixed> */
-    public function rules(): array
-    {
-        return [
-            'category_name' => ['required', 'string', 'max:255'],
-            'is_featured' => ['required', 'boolean'],
-        ];
-    }
-}
--- a/app/Domains/Catalog/Resources/AdminApp/OnTicketFeaturedGroupResource.php
+++ b/app/Domains/Catalog/Resources/AdminApp/OnTicketFeaturedGroupResource.php
@@ -1,29 +0,0 @@
-<?php
-
-namespace App\Domains\Catalog\Resources\AdminApp;
-
-use App\Domains\Catalog\Enums\ProductLayout;
-use App\Domains\Catalog\Models\FeaturedGroup;
-use Illuminate\Http\Request;
-use Illuminate\Http\Resources\Json\JsonResource;
-
-/** @mixin FeaturedGroup */
-class OnTicketFeaturedGroupResource extends JsonResource
-{
-    /** @return array<string, mixed> */
-    public function toArray(Request $request): array
-    {
-        return [
-            'id' => $this->id,
-            'code' => $this->code,
-            'category_id' => $this->category_id,
-            'category_name' => $this->category->nombre,
-            'group_name' => $this->group_name,
-            'is_featured' => $this->product_layout === ProductLayout::Row,
-            'type' => $this->source_type->value,
-            'product_layout' => $this->product_layout->value,
-            'group_layout' => $this->group_layout->value,
-            'order' => $this->group_order,
-        ];
-    }
-}
--- a/app/Domains/Catalog/Services/CatalogInventoryService.php
+++ b/app/Domains/Catalog/Services/CatalogInventoryService.php
@@ -25,6 +25,24 @@ class CatalogInventoryService
        );
    }

+    /**
+     * @return array<int, array{quantity: int, tracks_inventory: bool}>
+     */
+    public function detailedRequirementsFor(CatalogItem|Variant $selection, int $quantity = 1): array
+    {
+        if ($quantity <= 0) {
+            throw new \InvalidArgumentException('La cantidad debe ser mayor a cero.');
+        }
+
+        return array_map(
+            fn (array $requirement): array => [
+                ...$requirement,
+                'quantity' => $requirement['quantity'] * $quantity,
+            ],
+            $this->inventoryRequirements($selection),
+        );
+    }
+
    public function availableQuantity(CatalogItem|Variant $selection): ?int
    {
        if ($selection instanceof CatalogItem
--- a/app/Domains/Catalog/Services/ExpireStockReservationsService.php
+++ b/app/Domains/Catalog/Services/ExpireStockReservationsService.php
@@ -2,50 +2,184 @@

 namespace App\Domains\Catalog\Services;

-use App\Domains\Cart\Services\ExpireCartReservationsService;
-use App\Domains\Purchase\Services\CheckoutService;
+use App\Domains\Cart\Models\Cart;
+use App\Domains\Catalog\Models\StockReservation;
+use App\Domains\Purchase\Models\Purchase;
+use App\Domains\Purchase\Services\Checkout\ReleaseCheckoutService;
+use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Log;
+use RuntimeException;
 use Throwable;

 class ExpireStockReservationsService
 {
+    private const BATCH_SIZE = 500;
+
    public function __construct(
-        private readonly CheckoutService $checkout,
-        private readonly ExpireCartReservationsService $carts,
+        private readonly ReleaseCheckoutService $purchases,
+        private readonly StockReservationService $reservations,
    ) {}

    /**
-     * @return array{purchases: int, cart_items: int}
+     * @return array{purchases: int, cart_reservations: int, orphan_reservations: int, failed: int}
     */
    public function expireOverdue(): array
    {
-        $expiredPurchases = null;
-        $expiredCartItems = null;
+        $summary = [
+            'purchases' => 0,
+            'cart_reservations' => 0,
+            'orphan_reservations' => 0,
+            'failed' => 0,
+        ];
+        $lastReservationId = 0;

-        try {
-            $expiredPurchases = $this->checkout->expireOverduePurchases();
-            $expiredCartItems = $this->carts->expireOverdue();
+        do {
+            $reservationIds = StockReservation::query()
+                ->where('status', StockReservation::STATUS_ACTIVE)
+                ->whereNotNull('expires_at')
+                ->where('expires_at', '<=', now())
+                ->where('id', '>', $lastReservationId)
+                ->orderBy('id')
+                ->limit(self::BATCH_SIZE)
+                ->pluck('id');

-            Log::channel('commands')->info('Stock reservation cleanup completed.', [
-                'command' => 'reservations:expire',
-                'expired_purchases' => $expiredPurchases,
-                'expired_cart_items' => $expiredCartItems,
-                'total_expired' => $expiredPurchases + $expiredCartItems,
-            ]);
+            foreach ($reservationIds as $reservationId) {
+                $lastReservationId = (int) $reservationId;

-            return [
-                'purchases' => $expiredPurchases,
-                'cart_items' => $expiredCartItems,
-            ];
-        } catch (Throwable $exception) {
-            Log::channel('commands')->error('Stock reservation cleanup failed.', [
-                'command' => 'reservations:expire',
-                'expired_purchases' => $expiredPurchases,
-                'expired_cart_items' => $expiredCartItems,
-                'exception' => $exception,
-            ]);
+                try {
+                    $owner = $this->expireReservation($lastReservationId);
+                    if ($owner !== null) {
+                        $summary[$owner]++;
+                    }
+                } catch (Throwable $exception) {
+                    $summary['failed']++;
+                    Log::channel('commands')->error('Failed to expire overdue stock reservation.', [
+                        'command' => 'reservations:expire',
+                        'stock_reservation_id' => $lastReservationId,
+                        'exception' => $exception,
+                    ]);
+                }
+            }
+        } while ($reservationIds->count() === self::BATCH_SIZE);

-            throw $exception;
+        Log::channel('commands')->info('Stock reservation cleanup completed.', [
+            'command' => 'reservations:expire',
+            'expired_purchases' => $summary['purchases'],
+            'expired_cart_reservations' => $summary['cart_reservations'],
+            'expired_orphan_reservations' => $summary['orphan_reservations'],
+            'failed_reservations' => $summary['failed'],
+            'total_expired' => $summary['purchases']
+                + $summary['cart_reservations']
+                + $summary['orphan_reservations'],
+        ]);
+
+        return $summary;
+    }
+
+    public function expireIfOverdue(int $reservationId): bool
+    {
+        /** @var StockReservation|null $reservation */
+        $reservation = StockReservation::query()->find($reservationId);
+        if ($reservation?->status === StockReservation::STATUS_EXPIRED) {
+            return true;
        }
+        if (! $this->isOverdue($reservation)) {
+            return false;
+        }
+
+        return $this->expireReservation($reservationId) !== null;
+    }
+
+    /** @return 'purchases'|'cart_reservations'|'orphan_reservations'|null */
+    private function expireReservation(int $reservationId): ?string
+    {
+        $purchaseId = Purchase::query()
+            ->where('stock_reservation_id', $reservationId)
+            ->value('id');
+        if ($purchaseId !== null) {
+            return $this->expirePurchase((int) $purchaseId);
+        }
+
+        $cartId = Cart::query()
+            ->where('current_stock_reservation_id', $reservationId)
+            ->where('status', 'active')
+            ->value('id');
+        if ($cartId !== null) {
+            return $this->expireCart((int) $cartId, $reservationId);
+        }
+
+        return $this->expireOrphan($reservationId);
+    }
+
+    /** @return 'purchases'|null */
+    private function expirePurchase(int $purchaseId): ?string
+    {
+        /** @var Purchase|null $purchase */
+        $purchase = Purchase::query()->find($purchaseId);
+        if ($purchase === null) {
+            return null;
+        }
+
+        $purchase = $this->purchases->expire($purchase);
+        if ($purchase->status === Purchase::STATUS_EXPIRED) {
+            return 'purchases';
+        }
+
+        $reservation = $purchase->stockReservation;
+        if ($this->isOverdue($reservation)) {
+            throw new RuntimeException('An overdue active reservation belongs to a purchase that cannot expire.');
+        }
+
+        return null;
+    }
+
+    /** @return 'cart_reservations'|null */
+    private function expireCart(int $cartId, int $reservationId): ?string
+    {
+        return DB::transaction(function () use ($cartId, $reservationId): ?string {
+            /** @var Cart|null $cart */
+            $cart = Cart::query()
+                ->whereKey($cartId)
+                ->where('current_stock_reservation_id', $reservationId)
+                ->where('status', Cart::STATUS_ACTIVE)
+                ->lockForUpdate()
+                ->first();
+            if ($cart === null) {
+                return null;
+            }
+
+            /** @var StockReservation|null $reservation */
+            $reservation = StockReservation::query()->lockForUpdate()->find($reservationId);
+            if (! $this->isOverdue($reservation)) {
+                return null;
+            }
+
+            $this->reservations->expire($reservation);
+            $cart->update(['status' => Cart::STATUS_EXPIRED]);
+
+            return 'cart_reservations';
+        });
+    }
+
+    /** @return 'orphan_reservations'|null */
+    private function expireOrphan(int $reservationId): ?string
+    {
+        /** @var StockReservation|null $reservation */
+        $reservation = StockReservation::query()->find($reservationId);
+        if (! $this->isOverdue($reservation)) {
+            return null;
+        }
+
+        $this->reservations->expire($reservation);
+
+        return 'orphan_reservations';
+    }
+
+    private function isOverdue(?StockReservation $reservation): bool
+    {
+        return $reservation !== null
+            && $reservation->status === StockReservation::STATUS_ACTIVE
+            && $reservation->expires_at !== null
+            && ! $reservation->expires_at->isFuture();
    }
 }
--- a/app/Domains/Catalog/Services/OnTicketFeaturedGroupService.php
+++ b/app/Domains/Catalog/Services/OnTicketFeaturedGroupService.php
@@ -1,95 +0,0 @@
-<?php
-
-namespace App\Domains\Catalog\Services;
-
-use App\Domains\Catalog\Enums\FeaturedGroupSource;
-use App\Domains\Catalog\Enums\GroupLayout;
-use App\Domains\Catalog\Enums\ProductLayout;
-use App\Domains\Catalog\Models\Category;
-use App\Domains\Catalog\Models\FeaturedGroup;
-use App\Domains\Tenant\Models\Tenant;
-use Illuminate\Database\Eloquent\Collection;
-use Illuminate\Support\Facades\DB;
-
-class OnTicketFeaturedGroupService
-{
-    /** @return Collection<int, FeaturedGroup> */
-    public function forTenant(Tenant $tenant): Collection
-    {
-        return FeaturedGroup::query()
-            ->where('tenant_code', $tenant->codigo)
-            ->where('source_type', FeaturedGroupSource::Category)
-            ->whereHas('category', fn ($query) => $query->where('tenant_code', $tenant->codigo))
-            ->with('category')
-            ->orderBy('group_order')
-            ->orderBy('id')
-            ->get();
-    }
-
-    /** @param array{category_name: string, is_featured: bool} $data */
-    public function create(Tenant $tenant, array $data): FeaturedGroup
-    {
-        return DB::transaction(function () use ($tenant, $data): FeaturedGroup {
-            $category = $tenant->categories()->create([
-                'nombre' => $data['category_name'],
-            ]);
-
-            $featuredGroup = FeaturedGroup::query()->create([
-                'tenant_code' => $tenant->codigo,
-                'source_type' => FeaturedGroupSource::Category,
-                'category_id' => $category->id,
-                'product_layout' => $this->productLayout($data['is_featured']),
-                'group_layout' => GroupLayout::Paginated,
-                'group_name' => $data['category_name'],
-                'group_order' => $this->nextOrder($tenant),
-            ]);
-
-            return $featuredGroup->setRelation('category', $category);
-        });
-    }
-
-    /** @param array{category_name: string, is_featured: bool} $data */
-    public function update(
-        Tenant $tenant,
-        FeaturedGroup $featuredGroup,
-        array $data,
-    ): FeaturedGroup {
-        return DB::transaction(function () use ($tenant, $featuredGroup, $data): FeaturedGroup {
-            $featuredGroup = FeaturedGroup::query()
-                ->whereKey($featuredGroup->getKey())
-                ->where('tenant_code', $tenant->codigo)
-                ->where('source_type', FeaturedGroupSource::Category)
-                ->lockForUpdate()
-                ->firstOrFail();
-
-            $category = Category::query()
-                ->whereKey($featuredGroup->category_id)
-                ->where('tenant_code', $tenant->codigo)
-                ->lockForUpdate()
-                ->firstOrFail();
-
-            $category->update(['nombre' => $data['category_name']]);
-            $featuredGroup->update([
-                'group_name' => $data['category_name'],
-                'product_layout' => $this->productLayout($data['is_featured']),
-                'group_layout' => GroupLayout::Paginated,
-            ]);
-
-            return $featuredGroup->setRelation('category', $category);
-        });
-    }
-
-    private function productLayout(bool $isFeatured): ProductLayout
-    {
-        return $isFeatured ? ProductLayout::Row : ProductLayout::ColumnWithCart;
-    }
-
-    private function nextOrder(Tenant $tenant): int
-    {
-        $maximumOrder = FeaturedGroup::query()
-            ->where('tenant_code', $tenant->codigo)
-            ->max('group_order');
-
-        return $maximumOrder === null ? 0 : ((int) $maximumOrder) + 1;
-    }
-}
--- a/app/Domains/Catalog/Services/StockReservationService.php
+++ b/app/Domains/Catalog/Services/StockReservationService.php
@@ -2,262 +2,486 @@

 namespace App\Domains\Catalog\Services;

+use App\Domains\Cart\Models\Cart;
 use App\Domains\Cart\Models\CartItem;
-use App\Domains\Catalog\Models\CatalogItem;
+use App\Domains\Catalog\Exceptions\StockReservationExpiredException;
+use App\Domains\Catalog\Models\Inventory;
 use App\Domains\Catalog\Models\StockReservation;
-use App\Domains\Catalog\Models\Variant;
+use App\Domains\Catalog\Models\StockReservationLine;
 use App\Domains\Purchase\Models\Purchase;
 use Illuminate\Support\Carbon;
+use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\DB;

 class StockReservationService
 {
+    public const REASON_CART_EMPTY = 'cart_empty';
+
+    public const REASON_CART_CHANGED = 'cart_changed';
+
+    public const REASON_PURCHASE_SUPERSEDED = 'purchase_superseded';
+
+    public const REASON_PURCHASE_CANCELLED = 'purchase_cancelled';
+
+    public const REASON_PAYMENT_REJECTED = 'payment_rejected';
+
+    public const REASON_MANUAL_RELEASE = 'manual_release';
+
    public function __construct(
        private readonly CatalogInventoryService $inventory,
    ) {}

-    public function reserve(CartItem $cartItem, CatalogItem|Variant $selection, int $quantity): void
+    public function syncCart(Cart $cart): ?StockReservation
    {
-        DB::transaction(function () use ($cartItem, $selection, $quantity): void {
-            $this->inventory->reserve($selection, $quantity);
-            $this->recordIncrease($cartItem, $selection, $quantity);
-        });
-    }
+        return DB::transaction(function () use ($cart): ?StockReservation {
+            /** @var Cart $lockedCart */
+            $lockedCart = Cart::query()->lockForUpdate()->findOrFail($cart->getKey());
+            $items = $lockedCart->items()->orderBy('id')->lockForUpdate()->get();
+            $this->loadSelections($items);
+            $requirements = $this->requirementsForItems($items);

-    public function release(
-        CartItem $cartItem,
-        CatalogItem|Variant $selection,
-        int $quantity,
-        string $releasedStatus = StockReservation::STATUS_RELEASED,
-    ): void {
-        DB::transaction(function () use ($cartItem, $selection, $quantity, $releasedStatus): void {
-            $this->ensure($cartItem, $selection);
-            $this->inventory->release($selection, $quantity);
-            $this->recordDecrease($cartItem, $selection, $quantity, $releasedStatus);
-        });
-    }
+            $reservation = $lockedCart->current_stock_reservation_id === null
+                ? null
+                : StockReservation::query()->lockForUpdate()->find($lockedCart->current_stock_reservation_id);

-    public function commit(
-        CartItem $cartItem,
-        CatalogItem|Variant $selection,
-        Purchase $purchase,
-    ): void {
-        DB::transaction(function () use ($cartItem, $selection, $purchase): void {
-            $this->ensure($cartItem, $selection);
-            $this->inventory->commit($selection, (int) $cartItem->cantidad);
+            if ($reservation !== null) {
+                $this->assertUsableCartReservation($reservation);
+            }

-            $requirements = $this->inventory->requirementsFor($selection, (int) $cartItem->cantidad);
-            foreach ($requirements as $inventoryId => $quantity) {
-                $reservation = $this->lockReservation($cartItem, $inventoryId);
-                if (
-                    $reservation === null
-                    || $reservation->status !== StockReservation::STATUS_ACTIVE
-                    || $reservation->purchase_id !== $purchase->getKey()
-                    || $reservation->quantity !== $quantity
-                ) {
-                    throw new \InvalidArgumentException('La reserva de stock no coincide con el item del carrito.');
+            if ($requirements === []) {
+                if ($reservation !== null && $reservation->status === StockReservation::STATUS_ACTIVE) {
+                    $this->finalizeLocked(
+                        $reservation,
+                        StockReservation::STATUS_RELEASED,
+                        self::REASON_CART_EMPTY,
+                    );
                }

-                $reservation->update([
-                    'status' => StockReservation::STATUS_COMMITTED,
-                    'committed_at' => now(),
-                    'expires_at' => null,
-                ]);
+                $lockedCart->update(['current_stock_reservation_id' => null]);
+                $cart->current_stock_reservation_id = null;
+
+                return null;
            }
-        });
-    }
-
-    public function ensure(CartItem $cartItem, CatalogItem|Variant $selection): void
-    {
-        $requirements = $this->inventory->requirementsFor($selection, (int) $cartItem->cantidad);
-
-        foreach ($requirements as $inventoryId => $quantity) {
-            $reservation = $this->lockReservation($cartItem, $inventoryId);

            if ($reservation === null) {
-                StockReservation::query()->create([
-                    'inventory_id' => $inventoryId,
-                    'cart_item_id' => $cartItem->getKey(),
-                    'quantity' => $quantity,
+                $reservation = StockReservation::query()->create([
                    'status' => StockReservation::STATUS_ACTIVE,
                    'expires_at' => $this->expiration(),
                ]);
-
-                continue;
+                $lockedCart->update(['current_stock_reservation_id' => $reservation->getKey()]);
            }

-            if ($reservation->status !== StockReservation::STATUS_ACTIVE || $reservation->quantity !== $quantity) {
-                $reservation->update([
-                    'quantity' => $quantity,
-                    'status' => StockReservation::STATUS_ACTIVE,
-                    'committed_at' => null,
-                    'released_at' => null,
-                    'expires_at' => $this->expiration(),
-                ]);
+            if (Purchase::query()->where('stock_reservation_id', $reservation->getKey())->exists()) {
+                throw new \InvalidArgumentException('La reserva vinculada a una compra no se puede modificar.');
            }
-        }
-    }

-    public function attachToPurchase(
-        CartItem $cartItem,
-        CatalogItem|Variant $selection,
-        Purchase $purchase,
-    ): void {
-        DB::transaction(function () use ($cartItem, $selection, $purchase): void {
-            $this->ensure($cartItem, $selection);
-            StockReservation::query()
-                ->where('cart_item_id', $cartItem->getKey())
-                ->where('status', StockReservation::STATUS_ACTIVE)
-                ->update([
-                    'purchase_id' => $purchase->getKey(),
-                    'expires_at' => $purchase->expires_at,
-                ]);
-        });
-    }
-
-    public function detachFromPurchase(Purchase $purchase): void
-    {
-        StockReservation::query()
-            ->where('purchase_id', $purchase->getKey())
-            ->where('status', StockReservation::STATUS_ACTIVE)
-            ->update([
-                'purchase_id' => null,
-                'expires_at' => $this->expiration(),
-            ]);
-    }
-
-    public function restore(CartItem $cartItem, CatalogItem|Variant $selection): void
-    {
-        DB::transaction(function () use ($cartItem, $selection): void {
-            $requirements = $this->inventory->requirementsFor(
-                $selection,
-                (int) $cartItem->cantidad,
-            );
-            $activeReservations = StockReservation::query()
-                ->where('cart_item_id', $cartItem->getKey())
-                ->where('status', StockReservation::STATUS_ACTIVE)
+            $currentLines = StockReservationLine::query()
+                ->where('stock_reservation_id', $reservation->getKey())
+                ->orderBy('inventory_id')
                ->lockForUpdate()
                ->get()
                ->keyBy('inventory_id');
-
-            $hasCompleteReservation = collect($requirements)->every(
-                fn (int $quantity, int $inventoryId): bool => (int) ($activeReservations->get($inventoryId)?->quantity ?? 0) === $quantity,
-            );
-
-            if ($hasCompleteReservation) {
-                return;
-            }
-
-            if ($activeReservations->isNotEmpty()) {
-                throw new \InvalidArgumentException('La reserva de stock del carrito es inconsistente.');
-            }
-
-            $this->inventory->reserve($selection, (int) $cartItem->cantidad);
-            $this->recordIncrease($cartItem, $selection, (int) $cartItem->cantidad);
-        });
-    }
-
-    public function syncPurchaseExpiration(Purchase $purchase): void
-    {
-        StockReservation::query()
-            ->where('purchase_id', $purchase->getKey())
-            ->where('status', StockReservation::STATUS_ACTIVE)
-            ->update(['expires_at' => $purchase->expires_at]);
-    }
-
-    public function transfer(CartItem $source, CartItem $target): void
-    {
-        DB::transaction(function () use ($source, $target): void {
-            $sourceReservations = StockReservation::query()
-                ->where('cart_item_id', $source->getKey())
-                ->where('status', StockReservation::STATUS_ACTIVE)
-                ->orderBy('inventory_id')
+            $inventoryIds = collect(array_keys($requirements))
+                ->merge($currentLines->keys())
+                ->map(fn ($id): int => (int) $id)
+                ->unique()
+                ->sort()
+                ->values();
+            $inventories = Inventory::query()
+                ->whereKey($inventoryIds)
+                ->orderBy('id')
                ->lockForUpdate()
-                ->get();
+                ->get()
+                ->keyBy('id');

-            foreach ($sourceReservations as $sourceReservation) {
-                $targetReservation = $this->lockReservation($target, (int) $sourceReservation->inventory_id);
+            foreach ($inventoryIds as $inventoryId) {
+                $inventory = $inventories->get($inventoryId)
+                    ?? throw new \InvalidArgumentException('No se encontró el inventario requerido.');
+                $previous = (int) ($currentLines->get($inventoryId)?->quantity ?? 0);
+                $required = (int) ($requirements[$inventoryId]['quantity'] ?? 0);
+                $delta = $required - $previous;

-                if ($targetReservation === null) {
-                    $sourceItemQuantity = (int) $source->cantidad;
-                    $targetItemQuantity = (int) $target->fresh()->cantidad;
-                    $perItemQuantity = intdiv((int) $sourceReservation->quantity, $sourceItemQuantity);
-                    $sourceReservation->update([
-                        'cart_item_id' => $target->getKey(),
-                        'purchase_id' => null,
-                        'quantity' => $perItemQuantity * $targetItemQuantity,
-                        'expires_at' => $this->expiration(),
-                    ]);
+                if ($delta > 0
+                    && $requirements[$inventoryId]['tracks_inventory']
+                    && $inventory->availableStock() < $delta) {
+                    throw new \InvalidArgumentException('No hay suficiente stock disponible para reservar el carrito.');
+                }
+
+                if ($delta < 0 && $inventory->reserved_stock < abs($delta)) {
+                    throw new \InvalidArgumentException('La reserva de stock del carrito es inconsistente.');
+                }
+            }
+
+            foreach ($inventoryIds as $inventoryId) {
+                /** @var Inventory $inventory */
+                $inventory = $inventories->get($inventoryId);
+                $line = $currentLines->get($inventoryId);
+                $previous = (int) ($line?->quantity ?? 0);
+                $required = (int) ($requirements[$inventoryId]['quantity'] ?? 0);
+                $delta = $required - $previous;
+
+                if ($delta > 0) {
+                    $inventory->reserve($delta, $requirements[$inventoryId]['tracks_inventory']);
+                } elseif ($delta < 0) {
+                    $inventory->release(abs($delta));
+                }
+
+                if ($required === 0) {
+                    $line?->delete();

                    continue;
                }

-                $targetReservation->update([
-                    'quantity' => $targetReservation->quantity + $sourceReservation->quantity,
-                    'status' => StockReservation::STATUS_ACTIVE,
-                    'expires_at' => $this->expiration(),
-                ]);
-                $sourceReservation->delete();
+                StockReservationLine::query()->updateOrCreate(
+                    [
+                        'stock_reservation_id' => $reservation->getKey(),
+                        'inventory_id' => $inventoryId,
+                    ],
+                    [
+                        'quantity' => $required,
+                        'tracks_inventory' => $requirements[$inventoryId]['tracks_inventory'],
+                    ],
+                );
+            }
+
+            $reservation->update([
+                'expires_at' => $this->expiration(),
+                'release_reason' => null,
+            ]);
+            $cart->current_stock_reservation_id = $reservation->getKey();
+
+            return $reservation->fresh('lines');
+        });
+    }
+
+    public function attachToPurchase(
+        Cart $cart,
+        Purchase $purchase,
+        Carbon $expiresAt,
+    ): StockReservation {
+        return DB::transaction(function () use ($cart, $purchase, $expiresAt): StockReservation {
+            /** @var Cart $lockedCart */
+            $lockedCart = Cart::query()->lockForUpdate()->findOrFail($cart->getKey());
+            /** @var Purchase $lockedPurchase */
+            $lockedPurchase = Purchase::query()->lockForUpdate()->findOrFail($purchase->getKey());
+
+            if ($lockedCart->current_stock_reservation_id === null) {
+                throw new \InvalidArgumentException('El carrito no tiene una reserva de stock activa.');
+            }
+
+            /** @var StockReservation $reservation */
+            $reservation = StockReservation::query()->lockForUpdate()->findOrFail($lockedCart->current_stock_reservation_id);
+            $this->assertUsableCartReservation($reservation);
+
+            $linkedPurchase = Purchase::query()
+                ->where('stock_reservation_id', $reservation->getKey())
+                ->whereKeyNot($lockedPurchase->getKey())
+                ->exists();
+            if ($linkedPurchase) {
+                throw new \InvalidArgumentException('La reserva de stock ya pertenece a otra compra.');
+            }
+
+            $lockedPurchase->update(['stock_reservation_id' => $reservation->getKey()]);
+            $reservation->update(['expires_at' => $expiresAt]);
+            $purchase->stock_reservation_id = $reservation->getKey();
+            $cart->current_stock_reservation_id = $reservation->getKey();
+
+            return $reservation->fresh('lines');
+        });
+    }
+
+    public function commit(Purchase $purchase): void
+    {
+        DB::transaction(function () use ($purchase): void {
+            /** @var Purchase $purchase */
+            $purchase = Purchase::query()->lockForUpdate()->findOrFail($purchase->getKey());
+            if ($purchase->stock_reservation_id === null) {
+                throw new \InvalidArgumentException('La compra no tiene una reserva de stock.');
+            }
+
+            /** @var StockReservation $reservation */
+            $reservation = StockReservation::query()->lockForUpdate()->findOrFail($purchase->stock_reservation_id);
+            if ($reservation->status === StockReservation::STATUS_COMMITTED) {
+                return;
+            }
+            if ($reservation->status !== StockReservation::STATUS_ACTIVE) {
+                throw new \InvalidArgumentException('La reserva de stock no está activa.');
+            }
+            if ($reservation->expires_at !== null && ! $reservation->expires_at->isFuture()) {
+                throw new StockReservationExpiredException;
+            }
+
+            $lines = $this->lockLines($reservation);
+            if ($lines->isEmpty()) {
+                throw new \InvalidArgumentException('La reserva de stock no tiene inventarios.');
+            }
+
+            $inventories = $this->lockInventories($lines);
+            foreach ($lines as $line) {
+                $inventory = $inventories->get($line->inventory_id)
+                    ?? throw new \InvalidArgumentException('No se encontró el inventario reservado.');
+                if ($inventory->reserved_stock < $line->quantity
+                    || ($line->tracks_inventory && $inventory->real_stock < $line->quantity)) {
+                    throw new \InvalidArgumentException('La reserva de stock no alcanza para confirmar la compra.');
+                }
+            }
+
+            foreach ($lines as $line) {
+                $inventories->get($line->inventory_id)->buy(
+                    (int) $line->quantity,
+                    (bool) $line->tracks_inventory,
+                );
+            }
+
+            $reservation->update([
+                'status' => StockReservation::STATUS_COMMITTED,
+                'expires_at' => null,
+                'committed_at' => now(),
+                'released_at' => null,
+                'expired_at' => null,
+                'release_reason' => null,
+            ]);
+        });
+    }
+
+    public function releaseForPurchase(
+        Purchase $purchase,
+        string $status = StockReservation::STATUS_RELEASED,
+        ?string $reason = null,
+    ): void {
+        DB::transaction(function () use ($purchase, $status, $reason): void {
+            /** @var Purchase $purchase */
+            $purchase = Purchase::query()->lockForUpdate()->findOrFail($purchase->getKey());
+            if ($purchase->stock_reservation_id === null) {
+                return;
+            }
+
+            /** @var StockReservation|null $reservation */
+            $reservation = StockReservation::query()->lockForUpdate()->find($purchase->stock_reservation_id);
+            if ($reservation !== null) {
+                $this->finalizeLocked($reservation, $status, $reason);
            }
        });
    }

-    private function recordIncrease(CartItem $cartItem, CatalogItem|Variant $selection, int $quantity): void
+    public function returnToCart(Purchase $purchase, Cart $cart): StockReservation
    {
-        foreach ($this->inventory->requirementsFor($selection, $quantity) as $inventoryId => $requiredQuantity) {
-            $reservation = $this->lockReservation($cartItem, $inventoryId);
+        return DB::transaction(function () use ($purchase, $cart): StockReservation {
+            /** @var Purchase $purchase */
+            $purchase = Purchase::query()->lockForUpdate()->findOrFail($purchase->getKey());
+            /** @var Cart $cart */
+            $cart = Cart::query()->lockForUpdate()->findOrFail($cart->getKey());

-            if ($reservation === null) {
-                StockReservation::query()->create([
-                    'inventory_id' => $inventoryId,
-                    'cart_item_id' => $cartItem->getKey(),
-                    'quantity' => $requiredQuantity,
-                    'status' => StockReservation::STATUS_ACTIVE,
-                    'expires_at' => $this->expiration(),
-                ]);
-
-                continue;
+            if ($purchase->stock_reservation_id === null
+                || $cart->current_stock_reservation_id !== $purchase->stock_reservation_id) {
+                throw new \InvalidArgumentException('La compra y el carrito no comparten la reserva activa.');
            }

-            $reservation->update([
-                'quantity' => ($reservation->status === StockReservation::STATUS_ACTIVE ? $reservation->quantity : 0) + $requiredQuantity,
-                'status' => StockReservation::STATUS_ACTIVE,
-                'committed_at' => null,
-                'released_at' => null,
-                'expires_at' => $this->expiration(),
-            ]);
-        }
+            /** @var StockReservation $reservation */
+            $reservation = StockReservation::query()
+                ->lockForUpdate()
+                ->findOrFail($purchase->stock_reservation_id);
+            $this->assertUsableCartReservation($reservation);
+
+            $purchase->update(['stock_reservation_id' => null]);
+            $cart->update(['current_purchase_id' => null]);
+            $reservation->update(['expires_at' => $this->expiration()]);
+
+            return $reservation->fresh('lines');
+        });
    }

-    private function recordDecrease(
-        CartItem $cartItem,
-        CatalogItem|Variant $selection,
-        int $quantity,
-        string $releasedStatus,
+    public function assertCartReservationUsable(Cart $cart): void
+    {
+        DB::transaction(function () use ($cart): void {
+            /** @var Cart $cart */
+            $cart = Cart::query()->lockForUpdate()->findOrFail($cart->getKey());
+            if ($cart->current_stock_reservation_id === null) {
+                return;
+            }
+
+            /** @var StockReservation $reservation */
+            $reservation = StockReservation::query()
+                ->lockForUpdate()
+                ->findOrFail($cart->current_stock_reservation_id);
+            $this->assertUsableCartReservation($reservation);
+        });
+    }
+
+    public function releaseCurrentCartReservation(
+        Cart $cart,
+        string $reason = self::REASON_CART_CHANGED,
    ): void {
-        foreach ($this->inventory->requirementsFor($selection, $quantity) as $inventoryId => $requiredQuantity) {
-            $reservation = $this->lockReservation($cartItem, $inventoryId);
-            if ($reservation === null || $reservation->status !== StockReservation::STATUS_ACTIVE || $reservation->quantity < $requiredQuantity) {
-                throw new \InvalidArgumentException('La reserva de stock no alcanza para liberar la cantidad solicitada.');
+        DB::transaction(function () use ($cart, $reason): void {
+            /** @var Cart $cart */
+            $cart = Cart::query()->lockForUpdate()->findOrFail($cart->getKey());
+            if ($cart->current_stock_reservation_id === null) {
+                return;
            }

-            $remaining = $reservation->quantity - $requiredQuantity;
-            $reservation->update([
-                'quantity' => $remaining,
-                'status' => $remaining === 0 ? $releasedStatus : StockReservation::STATUS_ACTIVE,
-                'released_at' => $remaining === 0 ? now() : null,
-                'expires_at' => $remaining === 0 ? null : $reservation->expires_at,
-            ]);
+            /** @var StockReservation|null $reservation */
+            $reservation = StockReservation::query()->lockForUpdate()->find($cart->current_stock_reservation_id);
+            if ($reservation !== null) {
+                $this->finalizeLocked($reservation, StockReservation::STATUS_RELEASED, $reason);
+            }
+            $cart->update(['current_stock_reservation_id' => null]);
+        });
+    }
+
+    public function expire(StockReservation $reservation): void
+    {
+        DB::transaction(function () use ($reservation): void {
+            /** @var StockReservation $reservation */
+            $reservation = StockReservation::query()->lockForUpdate()->findOrFail($reservation->getKey());
+            if ($reservation->status !== StockReservation::STATUS_ACTIVE
+                || $reservation->expires_at === null
+                || $reservation->expires_at->isFuture()) {
+                return;
+            }
+
+            $this->finalizeLocked($reservation, StockReservation::STATUS_EXPIRED, null);
+        });
+    }
+
+    public function clearExpirationForReview(Purchase $purchase): void
+    {
+        DB::transaction(function () use ($purchase): void {
+            /** @var Purchase $purchase */
+            $purchase = Purchase::query()->lockForUpdate()->findOrFail($purchase->getKey());
+            if ($purchase->stock_reservation_id === null) {
+                throw new \InvalidArgumentException('La compra no tiene una reserva de stock.');
+            }
+
+            /** @var StockReservation $reservation */
+            $reservation = StockReservation::query()
+                ->lockForUpdate()
+                ->findOrFail($purchase->stock_reservation_id);
+            if ($reservation->status !== StockReservation::STATUS_ACTIVE) {
+                throw new \InvalidArgumentException('La reserva de stock no está activa.');
+            }
+            if ($reservation->expires_at !== null && ! $reservation->expires_at->isFuture()) {
+                throw new StockReservationExpiredException;
+            }
+
+            $reservation->update(['expires_at' => null]);
+        });
+    }
+
+    /**
+     * @param  Collection<int, CartItem>  $items
+     * @return array<int, array{quantity: int, tracks_inventory: bool}>
+     */
+    private function requirementsForItems(Collection $items): array
+    {
+        $requirements = [];
+        foreach ($items as $item) {
+            $selection = $item->selectedItem();
+            if ($selection === null) {
+                throw new \InvalidArgumentException('El carrito contiene un item de catálogo inexistente.');
+            }
+
+            foreach ($this->inventory->detailedRequirementsFor($selection, (int) $item->cantidad) as $inventoryId => $requirement) {
+                if (isset($requirements[$inventoryId])) {
+                    $requirements[$inventoryId]['quantity'] += $requirement['quantity'];
+                    $requirements[$inventoryId]['tracks_inventory'] =
+                        $requirements[$inventoryId]['tracks_inventory'] || $requirement['tracks_inventory'];
+
+                    continue;
+                }
+
+                $requirements[$inventoryId] = $requirement;
+            }
+        }
+
+        ksort($requirements);
+
+        return $requirements;
+    }
+
+    /** @param Collection<int, CartItem> $items */
+    private function loadSelections(Collection $items): void
+    {
+        $items->load([
+            'catalogItem.inventory',
+            'catalogItem.bundleComponents.catalogItem.inventory',
+            'catalogItem.bundleComponents.variant.inventory',
+            'catalogItem.bundleComponents.variant.catalogItem',
+            'variant.inventory',
+            'variant.catalogItem',
+        ]);
+    }
+
+    /** @return Collection<int, StockReservationLine> */
+    private function lockLines(StockReservation $reservation): Collection
+    {
+        return StockReservationLine::query()
+            ->where('stock_reservation_id', $reservation->getKey())
+            ->orderBy('inventory_id')
+            ->lockForUpdate()
+            ->get();
+    }
+
+    /**
+     * @param  Collection<int, StockReservationLine>  $lines
+     * @return Collection<int, Inventory>
+     */
+    private function lockInventories(Collection $lines): Collection
+    {
+        return Inventory::query()
+            ->whereKey($lines->pluck('inventory_id'))
+            ->orderBy('id')
+            ->lockForUpdate()
+            ->get()
+            ->keyBy('id');
+    }
+
+    private function finalizeLocked(
+        StockReservation $reservation,
+        string $status,
+        ?string $reason,
+    ): void {
+        if ($reservation->status !== StockReservation::STATUS_ACTIVE) {
+            return;
+        }
+        if (! in_array($status, [StockReservation::STATUS_RELEASED, StockReservation::STATUS_EXPIRED], true)) {
+            throw new \InvalidArgumentException('El estado final de la reserva no es válido.');
+        }
+
+        $lines = $this->lockLines($reservation);
+        $inventories = $this->lockInventories($lines);
+        foreach ($lines as $line) {
+            $inventory = $inventories->get($line->inventory_id)
+                ?? throw new \InvalidArgumentException('No se encontró el inventario reservado.');
+            $inventory->release((int) $line->quantity);
+        }
+
+        $now = now();
+        $reservation->update([
+            'status' => $status,
+            'expires_at' => null,
+            'released_at' => $status === StockReservation::STATUS_RELEASED ? $now : null,
+            'expired_at' => $status === StockReservation::STATUS_EXPIRED ? $now : null,
+            'release_reason' => $status === StockReservation::STATUS_RELEASED ? $reason : null,
+        ]);
+
+        if ($status === StockReservation::STATUS_RELEASED) {
+            Cart::query()
+                ->where('current_stock_reservation_id', $reservation->getKey())
+                ->update(['current_stock_reservation_id' => null]);
        }
    }

-    private function lockReservation(CartItem $cartItem, int $inventoryId): ?StockReservation
+    private function assertUsableCartReservation(StockReservation $reservation): void
    {
-        return StockReservation::query()
-            ->where('cart_item_id', $cartItem->getKey())
-            ->where('inventory_id', $inventoryId)
-            ->lockForUpdate()
-            ->first();
+        if ($reservation->status === StockReservation::STATUS_EXPIRED
+            || ($reservation->expires_at !== null && ! $reservation->expires_at->isFuture())) {
+            throw new StockReservationExpiredException;
+        }
+
+        if ($reservation->status !== StockReservation::STATUS_ACTIVE
+            || $reservation->expires_at === null) {
+            throw new \InvalidArgumentException('La reserva de stock no está disponible para operar el carrito.');
+        }
    }

    private function expiration(): Carbon
--- a/app/Domains/Catalog/documentacion/README.md
+++ b/app/Domains/Catalog/documentacion/README.md
@@ -9,7 +9,7 @@ Modela y publica la oferta comercial del tenant: productos, variantes, categorí
 - `CatalogItem` es la raíz del producto y se relaciona con tenant, categoría, marca, inventario, variantes, atributos, adjuntos y grupos destacados.
 - `Variant`, `ItemAttribute`, `Attribute`, `AttributeOption` y `VariantDefinition` describen opciones comercializables.
 - `Inventory` administra stock disponible, reservado y comprado.
- `StockReservation` atribuye cada unidad reservada a un ítem de carrito y, durante checkout, a una compra, con estados `active`, `committed`, `released` y `expired`.
+- `StockReservation` representa la reserva completa de un carrito o checkout, con estados `active`, `committed`, `released` y `expired`. Su `expires_at` es el único reloj del bloqueo. Al expirar, también pasan a `expired` la compra pagable y el carrito asociados dentro de la misma transacción. Sus estados terminales nunca se reactivan ni se reemplazan implícitamente. Sus `StockReservationLine` agregan la cantidad requerida por inventario, incluso cuando varios ítems o bundles consumen el mismo stock.
 - `Category` soporta jerarquía y categorías globales o propias del tenant.
 - `FeaturedGroup` y `FeaturedItem` organizan secciones destacadas.
 - `BundleComponent` representa los componentes de un paquete.
@@ -18,18 +18,14 @@ Modela y publica la oferta comercial del tenant: productos, variantes, categorí

 - `CatalogService`: alta, búsqueda, detalle, listado por categoría y eliminación.
 - `CatalogInventoryService`: consulta, reserva, libera y confirma inventario.
- `StockReservationService`: mantiene el ledger de reservas sincronizado con `Inventory.reserved_stock`.
+- `StockReservationService`: sincroniza el carrito como conjunto, bloquea todos sus inventarios en orden estable y mantiene el ledger agregado consistente con `Inventory.reserved_stock`.
+- `ExpireStockReservationsService`: detecta en un único recorrido reservas vencidas de compras, carritos y huérfanas, y delega los efectos comerciales sin mezclar esas reglas con la liberación física del inventario.
 - `FeaturedGroupService`: pagina los ítems destacados para la tienda.
- `OnTicketFeaturedGroupService`: administra grupos destacados del panel para sitios de tickets.

 ## Endpoints de tienda

 Bajo `/tenants/{tenant:codigo}` se publican catálogo, búsqueda, categoría, detalle, alta de ítems y paginación de grupos destacados.

-## Endpoints administrativos
-
-Bajo `/v1/adminapp/tenant/featured-groups`, con `auth:sanctum` y `adminapp.tenant`, se listan, crean y actualizan grupos destacados.
-
 ## Dependencias y reglas

 Usa `Attachable` para imágenes/archivos, `Tenant` para aislamiento y `Ticket`/`Event` para vigencia y fechas. `Cart` y `Purchase` consumen sus precios, variantes e inventario. Los cambios de stock deben pasar por `CatalogInventoryService` para conservar reservas y disponibilidad.
--- a/app/Domains/Catalog/routes/adminapp.php
+++ b/app/Domains/Catalog/routes/adminapp.php
@@ -1,15 +0,0 @@
-<?php
-
-use App\Domains\Catalog\Controllers\AdminApp\OnTicketFeaturedGroupController;
-use Illuminate\Support\Facades\Route;
-
-Route::prefix('v1/adminapp/tenant')
-    ->middleware(['auth:sanctum', 'adminapp.tenant'])
-    ->group(function (): void {
-        Route::get('featured-groups', [OnTicketFeaturedGroupController::class, 'index'])
-            ->name('adminapp.featured-groups.index');
-        Route::post('featured-groups', [OnTicketFeaturedGroupController::class, 'store'])
-            ->name('adminapp.featured-groups.store');
-        Route::put('featured-groups/{featuredGroup}', [OnTicketFeaturedGroupController::class, 'update'])
-            ->name('adminapp.featured-groups.update');
-    });
--- a/app/Domains/Catalog/routes/api.php
+++ b/app/Domains/Catalog/routes/api.php
@@ -15,5 +15,3 @@ Route::prefix('tenants/{tenant:codigo}')->group(function (): void {
    Route::post('catalog-items/{catalogItem}/variant-options', [CatalogController::class, 'variantOptions']);
    Route::post('catalog-items', [CatalogController::class, 'store']);
 });
-
-require __DIR__.'/adminapp.php';
--- a/app/Domains/Client/Controllers/ClientController.php
+++ b/app/Domains/Client/Controllers/ClientController.php
@@ -1,47 +0,0 @@
-<?php
-
-namespace App\Domains\Client\Controllers;
-
-use App\Domains\Client\Models\Client;
-use App\Domains\Client\Requests\StoreClientRequest;
-use App\Domains\Client\Requests\UpdateClientRequest;
-use App\Domains\Client\Resources\ClientResource;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Response;
-
-class ClientController extends Controller
-{
-    public function index(): JsonResponse
-    {
-        return ClientResource::collection(
-            Client::query()->with('tenants')->latest()->paginateFromRequest()
-        )->response();
-    }
-
-    public function store(StoreClientRequest $request): JsonResponse
-    {
-        return ClientResource::make(
-            Client::query()->create($request->validated())->load('tenants')
-        )->response()->setStatusCode(201);
-    }
-
-    public function show(Client $client): ClientResource
-    {
-        return ClientResource::make($client->load('tenants'));
-    }
-
-    public function update(UpdateClientRequest $request, Client $client): ClientResource
-    {
-        $client->update($request->validated());
-
-        return ClientResource::make($client->fresh()->load('tenants'));
-    }
-
-    public function destroy(Client $client): Response
-    {
-        $client->delete();
-
-        return response()->noContent();
-    }
-}
--- a/app/Domains/Client/Requests/StoreClientRequest.php
+++ b/app/Domains/Client/Requests/StoreClientRequest.php
@@ -1,22 +0,0 @@
-<?php
-
-namespace App\Domains\Client\Requests;
-
-use Illuminate\Foundation\Http\FormRequest;
-use Illuminate\Validation\Rule;
-
-class StoreClientRequest extends FormRequest
-{
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    public function rules(): array
-    {
-        return [
-            'code' => ['required', 'string', 'max:255', Rule::unique('clients', 'code')],
-            'name' => ['required', 'string', 'max:255'],
-        ];
-    }
-}
--- a/app/Domains/Client/Requests/UpdateClientRequest.php
+++ b/app/Domains/Client/Requests/UpdateClientRequest.php
@@ -1,26 +0,0 @@
-<?php
-
-namespace App\Domains\Client\Requests;
-
-use App\Domains\Client\Models\Client;
-use Illuminate\Foundation\Http\FormRequest;
-use Illuminate\Validation\Rule;
-
-class UpdateClientRequest extends FormRequest
-{
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    public function rules(): array
-    {
-        /** @var Client|null $client */
-        $client = $this->route('client');
-
-        return [
-            'code' => ['sometimes', 'string', 'max:255', Rule::unique('clients', 'code')->ignore($client?->id)],
-            'name' => ['sometimes', 'string', 'max:255'],
-        ];
-    }
-}
--- a/app/Domains/Client/Resources/ClientResource.php
+++ b/app/Domains/Client/Resources/ClientResource.php
@@ -1,26 +0,0 @@
-<?php
-
-namespace App\Domains\Client\Resources;
-
-use App\Domains\Client\Models\Client;
-use Illuminate\Http\Request;
-use Illuminate\Http\Resources\Json\JsonResource;
-
-/** @mixin Client */
-class ClientResource extends JsonResource
-{
-    public function toArray(Request $request): array
-    {
-        return [
-            'id' => $this->id,
-            'code' => $this->code,
-            'name' => $this->name,
-            'tenants' => $this->whenLoaded('tenants', fn () => $this->tenants->map(fn ($tenant): array => [
-                'id' => $tenant->id,
-                'codigo' => $tenant->codigo,
-                'nombre' => $tenant->nombre,
-                'dominio' => $tenant->dominio,
-            ])),
-        ];
-    }
-}
--- a/app/Domains/Client/routes/api.php
+++ b/app/Domains/Client/routes/api.php
@@ -1,6 +0,0 @@
-<?php
-
-use App\Domains\Client\Controllers\ClientController;
-use Illuminate\Support\Facades\Route;
-
-Route::apiResource('clients', ClientController::class);
--- a/app/Domains/Desfile/Controllers/EntryController.php
+++ b/app/Domains/Desfile/Controllers/EntryController.php
@@ -10,7 +10,6 @@ use App\Domains\Desfile\Services\EntryService;
 use App\Http\Controllers\Controller;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
-use Illuminate\Http\Response;

 class EntryController extends Controller
 {
@@ -48,10 +47,4 @@ class EntryController extends Controller
        ));
    }

-    public function destroyImage(Request $request): Response
-    {
-        $this->entryService->deleteImage($request->user()->tenant()->firstOrFail());
-
-        return response()->noContent();
-    }
 }
--- a/app/Domains/Desfile/Services/EntryService.php
+++ b/app/Domains/Desfile/Services/EntryService.php
@@ -166,19 +166,6 @@ class EntryService
        return $this->current($tenant);
    }

-    public function deleteImage(Tenant $tenant): void
-    {
-        $attachment = DB::transaction(function () use ($tenant): Attachment {
-            $entry = $this->entryQuery($tenant)->lockForUpdate()->firstOrFail();
-            $attachment = $entry->allAttachments()->lockForUpdate()->firstOrFail();
-            $entry->allAttachments()->detach($attachment->id);
-
-            return $attachment;
-        });
-
-        $this->deleteIfUnused($attachment);
-    }
-
    /** @return Collection<string, ItemAttribute> */
    private function itemAttributes(CatalogItem $entry): Collection
    {
--- a/app/Domains/Desfile/Services/InvitationPurchaseProvisioner.php
+++ b/app/Domains/Desfile/Services/InvitationPurchaseProvisioner.php
@@ -144,7 +144,6 @@ class InvitationPurchaseProvisioner
        if ($purchaseId !== null) {
            DB::table('compras')->where('id', $purchaseId)->update([
                'status' => 'paid',
-                'expires_at' => null,
                'total' => 0,
                'updated_at' => $now,
            ]);
@@ -158,7 +157,6 @@ class InvitationPurchaseProvisioner
            'cart_id' => null,
            'status' => 'paid',
            'payment_method' => self::PAYMENT_METHOD,
-            'expires_at' => null,
            'total' => 0,
            'dni' => null,
            'transfer_payer_dni' => null,
@@ -392,15 +390,27 @@ class InvitationPurchaseProvisioner
            'sold_units' => $inventory->sold_units + 1,
        ]);

-        DB::table('stock_reservations')->insert([
+        $reservationId = DB::table('compras')->where('id', $purchaseId)->value('stock_reservation_id');
+        if ($reservationId === null) {
+            $reservationId = DB::table('stock_reservations')->insertGetId([
+                'status' => 'committed',
+                'committed_at' => $now,
+                'released_at' => null,
+                'expired_at' => null,
+                'release_reason' => null,
+                'created_at' => $now,
+                'updated_at' => $now,
+            ]);
+            DB::table('compras')->where('id', $purchaseId)->update([
+                'stock_reservation_id' => $reservationId,
+            ]);
+        }
+
+        DB::table('stock_reservation_lines')->insert([
+            'stock_reservation_id' => $reservationId,
            'inventory_id' => $inventory->id,
-            'cart_item_id' => null,
-            'purchase_id' => $purchaseId,
            'quantity' => 1,
-            'status' => 'committed',
-            'expires_at' => null,
-            'committed_at' => $now,
-            'released_at' => null,
+            'tracks_inventory' => true,
            'created_at' => $now,
            'updated_at' => $now,
        ]);
--- a/app/Domains/Desfile/routes/api.php
+++ b/app/Domains/Desfile/routes/api.php
@@ -14,6 +14,4 @@ Route::prefix('v1/adminapp/tenant/desfile')
            ->name('adminapp.desfile.entries.image.replace');
        Route::patch('entries/image', [EntryController::class, 'updateImage'])
            ->name('adminapp.desfile.entries.image.update');
-        Route::delete('entries/image', [EntryController::class, 'destroyImage'])
-            ->name('adminapp.desfile.entries.image.destroy');
    });
--- a/app/Domains/Integration/Controllers/IntegrationController.php
+++ b/app/Domains/Integration/Controllers/IntegrationController.php
@@ -1,42 +0,0 @@
-<?php
-
-namespace App\Domains\Integration\Controllers;
-
-use App\Domains\Integration\Models\Integration;
-use App\Domains\Integration\Requests\StoreIntegrationRequest;
-use App\Domains\Integration\Requests\UpdateIntegrationRequest;
-use Illuminate\Routing\Controller;
-
-class IntegrationController extends Controller
-{
-    public function index()
-    {
-        return response()->json(Integration::all());
-    }
-
-    public function store(StoreIntegrationRequest $request)
-    {
-        $integration = Integration::create($request->validated());
-
-        return response()->json($integration, 201);
-    }
-
-    public function show(Integration $integration)
-    {
-        return response()->json($integration);
-    }
-
-    public function update(UpdateIntegrationRequest $request, Integration $integration)
-    {
-        $integration->update($request->validated());
-
-        return response()->json($integration->fresh());
-    }
-
-    public function destroy(Integration $integration)
-    {
-        $integration->delete();
-
-        return response()->noContent();
-    }
-}
--- a/app/Domains/Integration/Controllers/TelepagosWebhookController.php
+++ b/app/Domains/Integration/Controllers/TelepagosWebhookController.php
@@ -1,32 +0,0 @@
-<?php
-
-namespace App\Domains\Integration\Controllers;
-
-use App\Domains\Client\Models\Client;
-use App\Domains\Integration\Requests\TelepagosWebhookRequest;
-use App\Domains\Integration\Services\TelepagosWebhookService;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\JsonResponse;
-
-class TelepagosWebhookController extends Controller
-{
-    /**
-     * Handle the incoming Telepagos webhook.
-     */
-    public function handle(TelepagosWebhookRequest $request, Client $client, TelepagosWebhookService $service): JsonResponse
-    {
-        try {
-            $cashinId = $request->validated('id');
-
-            $service->handleWebhook($client, $cashinId);
-
-            return response()->json(['status' => 'success']);
-        } catch (\Exception $e) {
-            return response()->json([
-                'status' => 'error',
-                'code' => 'integration.webhook_failed',
-                'message' => __('api.integration.webhook_failed'),
-            ], 500);
-        }
-    }
-}
--- a/app/Domains/Integration/Requests/StoreIntegrationRequest.php
+++ b/app/Domains/Integration/Requests/StoreIntegrationRequest.php
@@ -1,24 +0,0 @@
-<?php
-
-namespace App\Domains\Integration\Requests;
-
-use Illuminate\Foundation\Http\FormRequest;
-
-class StoreIntegrationRequest extends FormRequest
-{
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    public function rules(): array
-    {
-        return [
-            'integration_code' => ['required', 'string', 'unique:integrations,integration_code'],
-            'name' => ['required', 'string', 'max:255'],
-            'url' => ['nullable', 'url', 'max:255'],
-            'integration_data_schema' => ['nullable', 'array'],
-            'requires_client_configuration' => ['sometimes', 'boolean'],
-        ];
-    }
-}
--- a/app/Domains/Integration/Requests/TelepagosWebhookRequest.php
+++ b/app/Domains/Integration/Requests/TelepagosWebhookRequest.php
@@ -1,28 +0,0 @@
-<?php
-
-namespace App\Domains\Integration\Requests;
-
-use Illuminate\Foundation\Http\FormRequest;
-
-class TelepagosWebhookRequest extends FormRequest
-{
-    /**
-     * Determine if the user is authorized to make this request.
-     */
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    /**
-     * Get the validation rules that apply to the request.
-     *
-     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array|string>
-     */
-    public function rules(): array
-    {
-        return [
-            'id' => ['required', 'string'],
-        ];
-    }
-}
--- a/app/Domains/Integration/Requests/UpdateIntegrationRequest.php
+++ b/app/Domains/Integration/Requests/UpdateIntegrationRequest.php
@@ -1,27 +0,0 @@
-<?php
-
-namespace App\Domains\Integration\Requests;
-
-use Illuminate\Foundation\Http\FormRequest;
-
-class UpdateIntegrationRequest extends FormRequest
-{
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    public function rules(): array
-    {
-        $integration = $this->route('integration');
-
-        return [
-            'name' => ['sometimes', 'required', 'string', 'max:255'],
-            'url' => ['nullable', 'url', 'max:255'],
-            'integration_data_schema' => ['nullable', 'array'],
-            'requires_client_configuration' => ['sometimes', 'boolean'],
-            // the code shouldn't ideally be updatable, but if it is:
-            'integration_code' => ['sometimes', 'required', 'string', 'unique:integrations,integration_code,'.($integration->id ?? '')],
-        ];
-    }
-}
--- a/app/Domains/Integration/Services/TelepagosWebhookService.php
+++ b/app/Domains/Integration/Services/TelepagosWebhookService.php
@@ -1,212 +0,0 @@
-<?php
-
-namespace App\Domains\Integration\Services;
-
-use App\Domains\Client\Models\Client;
-use App\Domains\Purchase\Models\Purchase;
-use App\Domains\Purchase\Models\TelepagosPayment;
-use App\Domains\Purchase\Models\TelepagosQr;
-use App\Domains\Purchase\Services\CheckoutService;
-use Exception;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\Log;
-
-class TelepagosWebhookService
-{
-    public function __construct(
-        private readonly CheckoutService $checkoutService,
-    ) {}
-
-    /**
-     * Handle the Telepagos webhook notification.
-     *
-     * @throws Exception
-     */
-    public function handleWebhook(Client $client, string $cashinId): void
-    {
-        Log::channel('telepagos')->info('Telepagos webhook received.', [
-            'client_code' => $client->code,
-            'cashin_id' => $cashinId,
-        ]);
-
-        $telepagosService = new TelepagosIntegrationService;
-        $telepagosService->forClient($client);
-
-        try {
-            $details = $telepagosService->getCashinDetails($cashinId);
-
-            $qrOrderId = $details['data']['qr_order_id'] ?? $details['qr_order_id'] ?? null;
-            $amount = $this->normalizeAmount($details['data']['amount'] ?? $details['amount'] ?? 0);
-            $operationId = $details['data']['operation_id'] ?? $details['operation_id'] ?? null;
-
-            $paymentData = [
-                'compra_id' => null,
-                'matched_purchase_ids' => null,
-                'cuit_buyer' => $details['data']['buyer']['cuit'] ?? $details['buyer']['cuit'] ?? null,
-                'cvu_buyer' => $details['data']['buyer']['cvu'] ?? $details['buyer']['cvu'] ?? null,
-                'amount' => $amount,
-                'concept' => $details['data']['concept'] ?? $details['concept'] ?? null,
-                'operation' => $details['data']['operation'] ?? $details['operation'] ?? null,
-                'operation_id' => $details['data']['operation_id'] ?? $details['operation_id'] ?? null,
-                'transaction_id' => $details['data']['transaction_id'] ?? $details['transaction_id'] ?? null,
-                'qr_order_id' => $qrOrderId,
-                'link_id' => $details['data']['link_id'] ?? $details['link_id'] ?? null,
-            ];
-
-            $transferenciaOperationIds = [1, 3, 11];
-            $qrOperationIds = [31, 37, 47];
-
-            $compra = null;
-
-            if (in_array((int) $operationId, $transferenciaOperationIds, true)) {
-                $cuit = $details['data']['buyer']['cuit'] ?? $details['buyer']['cuit'] ?? null;
-
-                if (! $cuit) {
-                    Log::channel('telepagos')->warning('Telepagos webhook: CUIT not found for transfer.', [
-                        'client_code' => $client->code,
-                        'cashin_id' => $cashinId,
-                    ]);
-
-                    return;
-                }
-
-                $dni = substr($cuit, 2, -1);
-
-                $tenantCodes = $client->tenants()->pluck('codigo');
-                $purchases = Purchase::whereIn('tenant_codigo', $tenantCodes)
-                    ->where('transfer_payer_dni', $dni)
-                    ->whereIn('status', [
-                        Purchase::STATUS_CREATED,
-                        Purchase::STATUS_PENDING_PAYMENT,
-                        Purchase::STATUS_IN_REVIEW,
-                    ])
-                    ->where('payment_method', 'transfer')
-                    ->where('total', $amount)
-                    ->latest()
-                    ->get();
-
-                $paymentData['matched_purchase_ids'] = $purchases->pluck('id')->all();
-                $compra = $purchases->count() === 1 ? $purchases->first() : null;
-
-                if (! $compra) {
-                    if ($purchases->count() > 1) {
-                        TelepagosPayment::create($paymentData);
-                    }
-
-                    Log::channel('telepagos')->warning('Telepagos webhook: Expected exactly one matching purchase.', [
-                        'client_code' => $client->code,
-                        'cashin_id' => $cashinId,
-                        'amount' => $amount,
-                        'matches' => $purchases->count(),
-                    ]);
-
-                    return;
-                }
-            } elseif (in_array((int) $operationId, $qrOperationIds, true)) {
-                if (! $qrOrderId) {
-                    Log::channel('telepagos')->warning('Telepagos webhook: qr_order_id not present in provider response.', [
-                        'client_code' => $client->code,
-                        'cashin_id' => $cashinId,
-                    ]);
-
-                    return;
-                }
-
-                $telepagosQr = TelepagosQr::where('qr_order_id', $qrOrderId)->first();
-
-                if (! $telepagosQr) {
-                    Log::channel('telepagos')->warning('Telepagos webhook: QR not found in database.', [
-                        'client_code' => $client->code,
-                        'cashin_id' => $cashinId,
-                        'qr_order_id' => $qrOrderId,
-                    ]);
-
-                    return;
-                }
-
-                $compra = $telepagosQr->compra;
-
-                if (! $compra) {
-                    Log::channel('telepagos')->warning('Telepagos webhook: Purchase not found for QR.', [
-                        'client_code' => $client->code,
-                        'cashin_id' => $cashinId,
-                        'qr_order_id' => $qrOrderId,
-                    ]);
-
-                    return;
-                }
-
-                if (! $client->tenants()->where('codigo', $compra->tenant_codigo)->exists()) {
-                    Log::channel('telepagos')->warning('Telepagos webhook: Purchase does not belong to client.', [
-                        'client_code' => $client->code,
-                        'cashin_id' => $cashinId,
-                        'purchase_id' => $compra->id,
-                    ]);
-
-                    return;
-                }
-
-                if (! in_array($compra->status, [
-                    Purchase::STATUS_PENDING_PAYMENT,
-                ], true)) {
-                    Log::channel('telepagos')->warning('Telepagos webhook: Purchase is not awaiting payment confirmation.', [
-                        'client_code' => $client->code,
-                        'cashin_id' => $cashinId,
-                        'purchase_id' => $compra->id,
-                        'purchase_status' => $compra->status,
-                    ]);
-
-                    return;
-                }
-
-                $totalAmount = $this->normalizeAmount($compra->getTotalAmount());
-
-                if ($amount !== $totalAmount) {
-                    Log::channel('telepagos')->warning('Telepagos webhook: Amount mismatch.', [
-                        'client_code' => $client->code,
-                        'cashin_id' => $cashinId,
-                        'purchase_id' => $compra->id,
-                        'cashin_amount' => $amount,
-                        'purchase_amount' => $totalAmount,
-                    ]);
-
-                    return;
-                }
-            } else {
-                Log::channel('telepagos')->warning('Telepagos webhook: Unknown operation_id.', [
-                    'client_code' => $client->code,
-                    'cashin_id' => $cashinId,
-                    'operation_id' => $operationId,
-                ]);
-
-                return;
-            }
-
-            $paymentData['compra_id'] = $compra->id;
-
-            DB::transaction(function () use ($compra, $paymentData) {
-                TelepagosPayment::create($paymentData);
-                $this->checkoutService->confirmPaidPurchase($compra);
-            });
-
-            Log::channel('telepagos')->info('Telepagos webhook processed successfully.', [
-                'client_code' => $client->code,
-                'cashin_id' => $cashinId,
-                'purchase_id' => $compra->id,
-                'transaction_id' => $paymentData['transaction_id'],
-            ]);
-        } catch (Exception $e) {
-            Log::channel('telepagos')->error('Telepagos webhook processing failed.', [
-                'client_code' => $client->code,
-                'cashin_id' => $cashinId,
-                'error' => $e->getMessage(),
-            ]);
-            throw $e;
-        }
-    }
-
-    protected function normalizeAmount(mixed $amount): string
-    {
-        return number_format((float) $amount, 2, '.', '');
-    }
-}
--- a/app/Domains/Integration/documentacion/README.md
+++ b/app/Domains/Integration/documentacion/README.md
@@ -16,18 +16,15 @@ Gestiona integraciones externas disponibles y su configuración por cliente. Un
 - `BaseIntegrationService`: resuelve el cliente desde el tenant operativo y carga exclusivamente la configuración del cliente.
 - `MailService`: envío de correo usando la integración configurada.
 - `TelepagosIntegrationService`: autenticación, caché de token, generación de QR y consulta de cobros.
- `TelepagosWebhookService`: procesa notificaciones recibidas desde Telepagos.

 ## Endpoints

- CRUD global bajo `/integrations`.
 - Consulta y configuración por cliente bajo `/clients/{client}/integrations`.
- `POST /webhooks/telepagos/{client}` para notificaciones del proveedor.

 ## Logging de Telepagos

-Los eventos de autenticación, QR, consultas de cuenta y procesamiento de webhooks se escriben en el canal diario `telepagos`, separado del log general. Los archivos se generan en `storage/logs/telepagos/telepagos-YYYY-MM-DD.log`; el nivel y la retención se configuran con `TELEPAGOS_LOG_LEVEL` y `TELEPAGOS_LOG_DAYS`. Tokens y credenciales se eliminan del contexto antes de registrar respuestas del proveedor.
+Los eventos de autenticación, QR y consultas de cuenta se escriben en el canal diario `telepagos`, separado del log general. Los archivos se generan en `storage/logs/telepagos/telepagos-YYYY-MM-DD.log`; el nivel y la retención se configuran con `TELEPAGOS_LOG_LEVEL` y `TELEPAGOS_LOG_DAYS`. Tokens y credenciales se eliminan del contexto antes de registrar respuestas del proveedor.

 ## Dependencias y reglas

-Se integra con `Client`, `Tenant` y con el checkout de `Purchase`. `Notification` utiliza `MailService`. El tenant conserva el contexto operativo y de branding, pero nunca es dueño de credenciales. Las credenciales no se exponen en respuestas ni logs; los webhooks deben validar su contrato antes de alterar una compra.
+Se integra con `Client`, `Tenant` y con el checkout de `Purchase`. `Notification` utiliza `MailService`. El tenant conserva el contexto operativo y de branding, pero nunca es dueño de credenciales. Las credenciales no se exponen en respuestas ni logs.
--- a/app/Domains/Integration/routes/api.php
+++ b/app/Domains/Integration/routes/api.php
@@ -1,22 +1,10 @@
 <?php

 use App\Domains\Integration\Controllers\ClientIntegrationController;
-use App\Domains\Integration\Controllers\IntegrationController;
-use App\Domains\Integration\Controllers\TelepagosWebhookController;
 use Illuminate\Support\Facades\Route;

-Route::group(['prefix' => 'integrations'], function () {
-    Route::get('/', [IntegrationController::class, 'index']);
-    Route::post('/', [IntegrationController::class, 'store']);
-    Route::get('/{integration}', [IntegrationController::class, 'show']);
-    Route::put('/{integration}', [IntegrationController::class, 'update']);
-    Route::delete('/{integration}', [IntegrationController::class, 'destroy']);
-});
-
 Route::group(['prefix' => 'clients/{client}/integrations'], function () {
    Route::get('/', [ClientIntegrationController::class, 'index']);
    Route::get('/{integration_code}', [ClientIntegrationController::class, 'show']);
    Route::put('/{integration_code}', [ClientIntegrationController::class, 'store']);
 });
-
-Route::post('webhooks/telepagos/{client}', [TelepagosWebhookController::class, 'handle']);
--- a/app/Domains/MailTest/Controllers/MailTestController.php
+++ b/app/Domains/MailTest/Controllers/MailTestController.php
@@ -1,32 +0,0 @@
-<?php
-
-namespace App\Domains\MailTest\Controllers;
-
-use App\Domains\MailTest\Requests\SendTestMailRequest;
-use App\Domains\MailTest\Services\MailTestService;
-use App\Domains\Tenant\Models\Tenant;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\JsonResponse;
-
-class MailTestController extends Controller
-{
-    public function __construct(
-        protected MailTestService $mailTestService,
-    ) {}
-
-    public function __invoke(SendTestMailRequest $request, string $tenantCode): JsonResponse
-    {
-        $tenant = Tenant::query()
-            ->where('codigo', $tenantCode)
-            ->firstOrFail();
-
-        return response()->json(
-            $this->mailTestService->send(
-                $tenant,
-                $request->validated('to'),
-                $request->validated('subject'),
-                $request->validated('message'),
-            )
-        );
-    }
-}
--- a/app/Domains/MailTest/Mailables/TestMail.php
+++ b/app/Domains/MailTest/Mailables/TestMail.php
@@ -1,51 +0,0 @@
-<?php
-
-namespace App\Domains\MailTest\Mailables;
-
-use App\Domains\Tenant\Models\Tenant;
-use Illuminate\Bus\Queueable;
-use Illuminate\Mail\Mailable;
-use Illuminate\Mail\Mailables\Content;
-use Illuminate\Mail\Mailables\Envelope;
-use Illuminate\Queue\SerializesModels;
-
-class TestMail extends Mailable
-{
-    use Queueable, SerializesModels;
-
-    public function __construct(
-        public readonly string $mailSubject,
-        public readonly string $mailMessage,
-        public readonly Tenant $tenant,
-    ) {}
-
-    public function envelope(): Envelope
-    {
-        return new Envelope(subject: $this->mailSubject);
-    }
-
-    public function content(): Content
-    {
-        $this->tenant->loadMissing(['headerLogo', 'footerLogo']);
-
-        $branding = [
-            'name' => $this->tenant->nombre,
-            'primary_color' => $this->tenant->primary_color ?? '#6376f3',
-            'body_color' => '#334155',
-            'background_color' => '#f1f5f9',
-            'surface_color' => '#ffffff',
-            'header_bg_color' => $this->tenant->header_bg_color ?? '#ffffff',
-            'footer_bg_color' => $this->tenant->footer_bg_color ?? '#334155',
-        ];
-
-        return new Content(
-            view: 'mail.test',
-            with: [
-                'tenant' => $this->tenant,
-                'branding' => $branding,
-                'headerLogoUrl' => $this->tenant->headerLogo?->getTemporaryUrl(1440),
-                'footerLogoUrl' => $this->tenant->footerLogo?->getTemporaryUrl(1440),
-            ],
-        );
-    }
-}
--- a/app/Domains/MailTest/Requests/SendTestMailRequest.php
+++ b/app/Domains/MailTest/Requests/SendTestMailRequest.php
@@ -1,25 +0,0 @@
-<?php
-
-namespace App\Domains\MailTest\Requests;
-
-use Illuminate\Foundation\Http\FormRequest;
-
-class SendTestMailRequest extends FormRequest
-{
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    /**
-     * @return array<string, array<int, string>>
-     */
-    public function rules(): array
-    {
-        return [
-            'to' => ['required', 'string', 'email', 'max:255'],
-            'subject' => ['nullable', 'string', 'max:255'],
-            'message' => ['nullable', 'string', 'max:5000'],
-        ];
-    }
-}
--- a/app/Domains/MailTest/Services/MailTestService.php
+++ b/app/Domains/MailTest/Services/MailTestService.php
@@ -1,35 +0,0 @@
-<?php
-
-namespace App\Domains\MailTest\Services;
-
-use App\Domains\Integration\Services\MailService;
-use App\Domains\Tenant\Models\Tenant;
-
-class MailTestService
-{
-    /**
-     * @return array<string, string>
-     */
-    public function send(Tenant $tenant, string $recipient, ?string $subject = null, ?string $message = null): array
-    {
-        $subject ??= 'Prueba de correo de Shopit';
-        $message ??= 'Este es un correo de prueba enviado desde Shopit.';
-
-        $mailService = (new MailService)->forTenant($tenant->codigo);
-        $mailService->send(
-            $recipient,
-            $subject,
-            '<h1 style="margin: 0 0 20px;">'.e($subject).'</h1>'
-                .'<p>'.nl2br(e($message)).'</p>',
-        );
-
-        return [
-            'code' => 'mail.test_sent',
-            'message' => __('api.mail.test_sent'),
-            'recipient' => $recipient,
-            'tenant_code' => $tenant->codigo,
-            'mailer' => $mailService->mailerName(),
-            'sent_at' => now()->toIso8601String(),
-        ];
-    }
-}
--- a/app/Domains/MailTest/documentacion/README.md
+++ b/app/Domains/MailTest/documentacion/README.md
@@ -1,24 +0,0 @@
-# Dominio MailTest
-
-## Propósito
-
-Ofrece una operación técnica para verificar la configuración de correo de un tenant sin ejecutar un flujo funcional real.
-
-## Componentes
-
- `MailTestController`: endpoint invocable de envío.
- `SendTestMailRequest`: valida destinatario y contenido requerido.
- `MailTestService`: coordina el envío de prueba.
- `TestMail`: mailable utilizado para construir el mensaje.
-
-## Endpoint
-
- `POST /{tenant_code}/mail-test/send`.
-
-## Dependencias
-
-Usa la configuración de correo del dominio `Integration` y resuelve el tenant indicado.
-
-## Consideraciones
-
-Es una herramienta de diagnóstico. Debe restringirse o deshabilitarse en entornos donde no corresponda exponer envíos de prueba, y nunca debe registrar credenciales.
--- a/app/Domains/MailTest/routes/api.php
+++ b/app/Domains/MailTest/routes/api.php
@@ -1,6 +0,0 @@
-<?php
-
-use App\Domains\MailTest\Controllers\MailTestController;
-use Illuminate\Support\Facades\Route;
-
-Route::post('{tenant_code}/mail-test/send', MailTestController::class);
--- a/app/Domains/Menu/Controllers/MenuController.php
+++ b/app/Domains/Menu/Controllers/MenuController.php
@@ -1,79 +0,0 @@
-<?php
-
-namespace App\Domains\Menu\Controllers;
-
-use App\Domains\Menu\Models\Menu;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Request;
-use Illuminate\Validation\Rule;
-
-class MenuController extends Controller
-{
-    public function index(): JsonResponse
-    {
-        $menues = Menu::all();
-
-        return response()->json($menues);
-    }
-
-    public function store(Request $request): JsonResponse
-    {
-        $validated = $request->validate([
-            'code' => 'required|string|unique:menues,code',
-            'label' => 'required|string|max:255',
-            'parent_menu_code' => [
-                'nullable',
-                'string',
-                Rule::exists('menues', 'code'),
-                'different:code',
-            ],
-            'content_type' => [
-                'sometimes',
-                Rule::in([Menu::CONTENT_TYPE_STATIC, Menu::CONTENT_TYPE_DYNAMIC]),
-            ],
-            'static_content_schema' => 'required_if:content_type,static|nullable|array',
-            'route' => 'required|string',
-        ]);
-
-        $menu = Menu::create($validated);
-
-        return response()->json($menu, 201);
-    }
-
-    public function show(Menu $menu): JsonResponse
-    {
-        return response()->json($menu);
-    }
-
-    public function update(Request $request, Menu $menu): JsonResponse
-    {
-        $validated = $request->validate([
-            'code' => 'sometimes|required|string|unique:menues,code,'.$menu->id,
-            'label' => 'sometimes|required|string|max:255',
-            'parent_menu_code' => [
-                'nullable',
-                'string',
-                Rule::exists('menues', 'code'),
-                Rule::notIn([$menu->code]),
-            ],
-            'content_type' => [
-                'sometimes',
-                Rule::in([Menu::CONTENT_TYPE_STATIC, Menu::CONTENT_TYPE_DYNAMIC]),
-            ],
-            'static_content_schema' => 'required_if:content_type,static|nullable|array',
-            'route' => 'sometimes|required|string',
-        ]);
-
-        $menu->update($validated);
-
-        return response()->json($menu);
-    }
-
-    public function destroy(Menu $menu): JsonResponse
-    {
-        $menu->delete();
-
-        return response()->json(null, 204);
-    }
-}
--- a/app/Domains/Menu/Controllers/TenantMenuController.php
+++ b/app/Domains/Menu/Controllers/TenantMenuController.php
@@ -1,32 +0,0 @@
-<?php
-
-namespace App\Domains\Menu\Controllers;
-
-use App\Domains\Menu\Models\Menu;
-use App\Domains\Menu\Requests\StoreTenantMenuRequest;
-use App\Domains\Menu\Services\TenantMenuService;
-use App\Domains\Tenant\Models\Tenant;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\JsonResponse;
-
-class TenantMenuController extends Controller
-{
-    public function __construct(private readonly TenantMenuService $tenantMenuService) {}
-
-    public function store(
-        StoreTenantMenuRequest $request,
-        string $tenantCode,
-        string $menuCode,
-    ): JsonResponse {
-        $tenant = Tenant::query()->where('codigo', $tenantCode)->firstOrFail();
-        $menu = Menu::query()->where('code', $menuCode)->firstOrFail();
-
-        $tenantMenu = $this->tenantMenuService->configure(
-            $tenant,
-            $menu,
-            $request->validated('static_content'),
-        );
-
-        return response()->json($tenantMenu);
-    }
-}
--- a/app/Domains/Menu/Requests/StoreTenantMenuRequest.php
+++ b/app/Domains/Menu/Requests/StoreTenantMenuRequest.php
@@ -1,49 +0,0 @@
-<?php
-
-namespace App\Domains\Menu\Requests;
-
-use App\Domains\Menu\Models\Menu;
-use Illuminate\Foundation\Http\FormRequest;
-use Illuminate\Validation\ValidationException;
-
-class StoreTenantMenuRequest extends FormRequest
-{
-    private ?Menu $menuModel = null;
-
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    protected function prepareForValidation(): void
-    {
-        $this->menuModel = Menu::query()
-            ->where('code', $this->route('menu_code'))
-            ->first();
-
-        if (! $this->menuModel) {
-            throw ValidationException::withMessages([
-                'menu_code' => __('api.menu.not_found'),
-            ]);
-        }
-    }
-
-    public function rules(): array
-    {
-        if ($this->menuModel?->content_type !== Menu::CONTENT_TYPE_STATIC) {
-            return [
-                'static_content' => ['nullable', 'array'],
-            ];
-        }
-
-        $rules = [
-            'static_content' => ['required', 'array'],
-        ];
-
-        foreach ($this->menuModel->static_content_schema as $field => $rule) {
-            $rules["static_content.{$field}"] = $rule;
-        }
-
-        return $rules;
-    }
-}
--- a/app/Domains/Menu/Services/TenantMenuService.php
+++ b/app/Domains/Menu/Services/TenantMenuService.php
@@ -1,26 +0,0 @@
-<?php
-
-namespace App\Domains\Menu\Services;
-
-use App\Domains\Menu\Models\Menu;
-use App\Domains\Menu\Models\TenantMenu;
-use App\Domains\Tenant\Models\Tenant;
-use Illuminate\Support\Facades\DB;
-
-class TenantMenuService
-{
-    public function configure(Tenant $tenant, Menu $menu, ?array $staticContent): TenantMenu
-    {
-        return DB::transaction(fn () => TenantMenu::query()->updateOrCreate(
-            [
-                'tenant_code' => $tenant->codigo,
-                'menu_code' => $menu->code,
-            ],
-            [
-                'static_content' => $menu->content_type === Menu::CONTENT_TYPE_STATIC
-                    ? $staticContent
-                    : null,
-            ],
-        ));
-    }
-}
--- a/app/Domains/Menu/documentacion/README.md
+++ b/app/Domains/Menu/documentacion/README.md
@@ -10,15 +10,6 @@ Define menús disponibles y permite configurar su contenido para cada tenant y r
 - `TenantMenu`: configuración específica por tenant, incluyendo contenido estático cuando corresponde.
 - `MenuRole`: asociación entre menú y rol autorizado.

-## Servicios
-
-`TenantMenuService::configure()` crea o actualiza atómicamente la configuración de un menú para un tenant. Solo conserva `static_content` cuando el menú fue definido como contenido estático.
-
-## Endpoints
-
- Recurso REST `/menues` mediante `MenuController`.
- `POST /{tenant_code}/menues/{menu_code}` para configurar un menú del tenant.
-
 ## Dependencias y reglas

-Depende de `Tenant` y `Authorization`. Los códigos de menú y tenant forman la identidad lógica de la configuración; el contenido enviado debe respetar el tipo definido por `Menu`.
+Depende de `Tenant` y `Authorization`. Los menús se configuran mediante seeders y relaciones internas; no se exponen endpoints públicos de administración.
--- a/app/Domains/Menu/routes/api.php
+++ b/app/Domains/Menu/routes/api.php
@@ -1,12 +0,0 @@
-<?php
-
-use App\Domains\Menu\Controllers\MenuController;
-use App\Domains\Menu\Controllers\TenantMenuController;
-use Illuminate\Support\Facades\Route;
-
-Route::apiResource('menues', MenuController::class);
-
-Route::post(
-    '{tenant_code}/menues/{menu_code}',
-    [TenantMenuController::class, 'store']
-);
--- a/app/Domains/Purchase/Controllers/PurchaseController.php
+++ b/app/Domains/Purchase/Controllers/PurchaseController.php
@@ -36,6 +36,7 @@ class PurchaseController extends Controller

        return PurchaseResource::collection(
            Purchase::query()
+                ->with('stockReservation')
                ->where('tenant_codigo', $tenant->codigo)
                ->where('user_id', $request->user()->id)
                ->when($statuses !== [], fn ($query) => $query->whereIn('status', $statuses))
@@ -92,7 +93,6 @@ class PurchaseController extends Controller
        PaymentIntentRequest $request,
        Tenant $tenant,
        Purchase $compra,
-        CheckoutService $checkoutService,
        PurchaseStateGuard $purchaseState,
    ): JsonResponse {
        $compra = $this->resolveScopedPurchase($tenant, $request->user()->id, $compra);
@@ -101,7 +101,12 @@ class PurchaseController extends Controller
            ? preg_replace('/\D+/', '', (string) $request->validated('transfer_payer_dni'))
            : null;

-        $updated = DB::transaction(function () use ($compra, $method, $purchaseState, $transferPayerDni): bool {
+        $updated = DB::transaction(function () use (
+            $compra,
+            $method,
+            $purchaseState,
+            $transferPayerDni,
+        ): bool {
            /** @var Purchase|null $purchase */
            $purchase = Purchase::query()
                ->whereKey($compra->getKey())
@@ -128,9 +133,6 @@ class PurchaseController extends Controller
            $purchaseUpdate = [
                'payment_method' => $method,
                'status' => Purchase::STATUS_PENDING_PAYMENT,
-                'expires_at' => now()->addMinutes(
-                    max(1, (int) config("purchase.payment_expiration_minutes.{$method}", 30))
-                ),
                'total' => $purchase->calculateCurrentTotalAmount(),
            ];

@@ -150,7 +152,6 @@ class PurchaseController extends Controller

        $compra->refresh();
        $totalAmount = (float) $compra->total;
-        $checkoutService->syncReservationExpiration($compra);

        if ($method === 'transfer') {
            $telepagosService = new TelepagosIntegrationService;
@@ -242,15 +243,6 @@ class PurchaseController extends Controller
        ], 400);
    }

-    public function complete(Request $request, Tenant $tenant, Purchase $compra, CheckoutService $checkoutService): PurchaseResource
-    {
-        $compra = $this->resolveScopedPurchase($tenant, $request->user()->id, $compra);
-
-        return PurchaseResource::make(
-            $checkoutService->completePurchase($compra)
-        );
-    }
-
    public function submitForReview(
        Request $request,
        Tenant $tenant,
--- a/app/Domains/Purchase/Models/Purchase.php
+++ b/app/Domains/Purchase/Models/Purchase.php
@@ -19,11 +19,11 @@ use Illuminate\Support\Facades\DB;

 #[Fillable([
    'cart_id',
+    'stock_reservation_id',
    'tenant_codigo',
    'user_id',
    'status',
    'payment_method',
-    'expires_at',
    'total',
    'dni',
    'transfer_payer_dni',
@@ -77,8 +77,8 @@ class Purchase extends Model
    {
        return [
            'cart_id' => 'integer',
+            'stock_reservation_id' => 'integer',
            'user_id' => 'integer',
-            'expires_at' => 'datetime',
            'total' => 'decimal:2',
        ];
    }
@@ -123,10 +123,10 @@ class Purchase extends Model
        return $this->hasMany(Ticket::class, 'source_purchase_id');
    }

-    /** @return HasMany<StockReservation, $this> */
-    public function stockReservations(): HasMany
+    /** @return BelongsTo<StockReservation, $this> */
+    public function stockReservation(): BelongsTo
    {
-        return $this->hasMany(StockReservation::class);
+        return $this->belongsTo(StockReservation::class);
    }

    /**
--- a/app/Domains/Purchase/Resources/PurchaseResource.php
+++ b/app/Domains/Purchase/Resources/PurchaseResource.php
@@ -17,6 +17,8 @@ class PurchaseResource extends JsonResource
     */
    public function toArray(Request $request): array
    {
+        $serverTime = now();
+        $expiresAt = $this->stockReservation?->expires_at;
        $items = $this->resource->relationLoaded('items')
            ? $this->resource->getRelation('items')
            : collect();
@@ -48,7 +50,11 @@ class PurchaseResource extends JsonResource
            'created_at' => $this->created_at,
            'status' => $this->status,
            'payment_method' => $this->payment_method,
-            'expires_at' => $this->expires_at,
+            'expires_at' => $expiresAt,
+            'expires_in_seconds' => $expiresAt === null
+                ? null
+                : max(0, $expiresAt->getTimestamp() - $serverTime->getTimestamp()),
+            'server_time' => $serverTime,
            'dni' => $this->dni,
            'transfer_payer_dni' => $this->transfer_payer_dni,
            'telefono' => $this->telefono,
--- a/app/Domains/Purchase/Services/Checkout/CompleteCheckoutService.php
+++ b/app/Domains/Purchase/Services/Checkout/CompleteCheckoutService.php
@@ -18,33 +18,6 @@ class CompleteCheckoutService
        private readonly PurchaseStateGuard $purchaseState,
    ) {}

-    public function complete(Purchase $purchase): Purchase
-    {
-        return DB::transaction(function () use ($purchase): Purchase {
-            $purchase = $this->lockPurchase($purchase);
-            $this->purchaseState->assertNotExpired($purchase);
-
-            if ($purchase->payment_method === null) {
-                throw ValidationException::withMessages([
-                    'payment_method' => __('api.purchase.payment_method_required'),
-                ]);
-            }
-
-            if ($this->isTerminal($purchase)) {
-                return $this->loadPurchase($purchase);
-            }
-
-            $this->purchaseState->lockCurrentCart($purchase);
-
-            $purchase->update([
-                'status' => Purchase::STATUS_PENDING_PAYMENT,
-                'total' => $purchase->calculateCurrentTotalAmount(),
-            ]);
-
-            return $this->loadPurchase($purchase);
-        });
-    }
-
    public function submitForReview(Purchase $purchase): Purchase
    {
        return DB::transaction(function () use ($purchase): Purchase {
@@ -61,10 +34,7 @@ class CompleteCheckoutService

            $this->purchaseState->lockCurrentCart($purchase);

-            if (
-                $purchase->status !== Purchase::STATUS_PENDING_PAYMENT
-                || ($purchase->expires_at !== null && $purchase->expires_at->isPast())
-            ) {
+            if ($purchase->status !== Purchase::STATUS_PENDING_PAYMENT) {
                throw ValidationException::withMessages([
                    'purchase' => __('api.purchase.not_available_for_review'),
                ]);
@@ -72,9 +42,8 @@ class CompleteCheckoutService

            $purchase->update([
                'status' => Purchase::STATUS_IN_REVIEW,
-                'expires_at' => null,
            ]);
-            $this->reservations->syncPurchaseExpiration($purchase);
+            $this->reservations->clearExpirationForReview($purchase);

            return $this->loadPurchase($purchase);
        });
@@ -161,31 +130,20 @@ class CompleteCheckoutService
                    ]);
                }

-                try {
-                    $this->reservations->commit($cartItem, $selection, $purchase);
-                } catch (\InvalidArgumentException) {
-                    throw ValidationException::withMessages([
-                        'items' => __('api.purchase.inconsistent_reservation'),
-                    ]);
-                }
+            }
+
+            try {
+                $this->reservations->commit($purchase);
+            } catch (\InvalidArgumentException) {
+                throw ValidationException::withMessages([
+                    'items' => __('api.purchase.inconsistent_reservation'),
+                ]);
            }

            $this->sourceCart->finalize($purchase);
        });
    }

-    private function isTerminal(Purchase $purchase): bool
-    {
-        return in_array($purchase->status, [
-            Purchase::STATUS_PAID,
-            Purchase::STATUS_IN_REVIEW,
-            Purchase::STATUS_CANCELLED,
-            Purchase::STATUS_REJECTED,
-            Purchase::STATUS_EXPIRED,
-            Purchase::STATUS_SUPERSEDED,
-        ], true);
-    }
-
    private function lockPurchase(Purchase $purchase): Purchase
    {
        /** @var Purchase */
@@ -194,7 +152,7 @@ class CompleteCheckoutService

    private function loadPurchase(Purchase $purchase): Purchase
    {
-        return $purchase->load(['items.imageAttachment']);
+        return $purchase->load(['items.imageAttachment', 'stockReservation']);
    }

    private function itemKey(int $catalogItemId, ?int $variantId): string
--- a/app/Domains/Purchase/Services/Checkout/PurchaseResponseLoader.php
+++ b/app/Domains/Purchase/Services/Checkout/PurchaseResponseLoader.php
@@ -8,6 +8,6 @@ class PurchaseResponseLoader
 {
    public function load(Purchase $purchase): Purchase
    {
-        return $purchase->load(['tenant', 'items.imageAttachment']);
+        return $purchase->load(['tenant', 'items.imageAttachment', 'stockReservation']);
    }
 }
--- a/app/Domains/Purchase/Services/Checkout/ReleaseCheckoutService.php
+++ b/app/Domains/Purchase/Services/Checkout/ReleaseCheckoutService.php
@@ -5,11 +5,10 @@ namespace App\Domains\Purchase\Services\Checkout;
 use App\Domains\Cart\Models\Cart;
 use App\Domains\Catalog\Models\StockReservation;
 use App\Domains\Catalog\Services\StockReservationService;
+use App\Domains\Purchase\Exceptions\PurchaseExpiredException;
 use App\Domains\Purchase\Models\Purchase;
 use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\Log;
 use Illuminate\Validation\ValidationException;
-use Throwable;

 class ReleaseCheckoutService
 {
@@ -32,40 +31,6 @@ class ReleaseCheckoutService
        return $this->release($purchase, Purchase::STATUS_EXPIRED);
    }

-    public function expireOverdue(): int
-    {
-        $expiredCount = 0;
-
-        Purchase::query()
-            ->whereIn('status', [Purchase::STATUS_CREATED, Purchase::STATUS_PENDING_PAYMENT])
-            ->whereNotNull('expires_at')
-            ->where('expires_at', '<=', now())
-            ->orderBy('id')
-            ->eachById(function (Purchase $purchase) use (&$expiredCount): void {
-                try {
-                    $purchase = $this->expire($purchase);
-                } catch (Throwable $exception) {
-                    Log::channel('commands')->error('Failed to expire overdue purchase.', [
-                        'command' => 'reservations:expire',
-                        'purchase_id' => $purchase->getKey(),
-                        'tenant_codigo' => $purchase->tenant_codigo,
-                        'cart_id' => $purchase->cart_id,
-                        'status' => $purchase->status,
-                        'expires_at' => $purchase->expires_at,
-                        'exception' => $exception,
-                    ]);
-
-                    return;
-                }
-
-                if ($purchase->status === Purchase::STATUS_EXPIRED) {
-                    $expiredCount++;
-                }
-            });
-
-        return $expiredCount;
-    }
-
    private function release(
        Purchase $purchase,
        string $targetStatus,
@@ -78,6 +43,11 @@ class ReleaseCheckoutService
        ): Purchase {
            $purchase = $this->lockPurchase($purchase);

+            if ($purchase->status === Purchase::STATUS_EXPIRED
+                && $targetStatus !== Purchase::STATUS_EXPIRED) {
+                throw new PurchaseExpiredException;
+            }
+
            if ($purchase->status === Purchase::STATUS_PAID) {
                if ($targetStatus === Purchase::STATUS_EXPIRED) {
                    return $this->loadPurchase($purchase);
@@ -100,14 +70,31 @@ class ReleaseCheckoutService
                return $this->loadPurchase($purchase);
            }

+            $cart = $purchase->cart()->withTrashed()->lockForUpdate()->first();
+
+            if ($targetStatus === Purchase::STATUS_CANCELLED
+                && $cart?->status === 'active'
+                && in_array($purchase->status, [
+                    Purchase::STATUS_CREATED,
+                    Purchase::STATUS_PENDING_PAYMENT,
+                ], true)) {
+                $this->reservations->returnToCart($purchase, $cart);
+                $purchase->update(['status' => Purchase::STATUS_CANCELLED]);
+
+                return $this->loadPurchase($purchase);
+            }
+
            if (
                $targetStatus === Purchase::STATUS_EXPIRED
-                && ($purchase->expires_at === null || $purchase->expires_at->isFuture())
+                && (! in_array($purchase->status, [
+                    Purchase::STATUS_CREATED,
+                    Purchase::STATUS_PENDING_PAYMENT,
+                ], true) || ! $this->hasOverdueActiveReservation($purchase))
            ) {
                return $this->loadPurchase($purchase);
            }

-            $this->releasePurchaseReservations($purchase, $targetStatus);
+            $this->releasePurchaseReservations($purchase, $targetStatus, $cart);

            $purchase->update(['status' => $targetStatus]);

@@ -115,60 +102,67 @@ class ReleaseCheckoutService
        });
    }

-    private function releasePurchaseReservations(Purchase $purchase, string $targetStatus): void
-    {
-        $cart = $purchase->cart()->withTrashed()->lockForUpdate()->first();
+    private function releasePurchaseReservations(
+        Purchase $purchase,
+        string $targetStatus,
+        ?Cart $cart,
+    ): void {
+        try {
+            $this->reservations->releaseForPurchase(
+                $purchase,
+                $targetStatus === Purchase::STATUS_EXPIRED
+                    ? StockReservation::STATUS_EXPIRED
+                    : StockReservation::STATUS_RELEASED,
+                $targetStatus === Purchase::STATUS_CANCELLED
+                    ? StockReservationService::REASON_PURCHASE_CANCELLED
+                    : ($targetStatus === Purchase::STATUS_REJECTED
+                        ? StockReservationService::REASON_PAYMENT_REJECTED
+                        : null),
+            );
+        } catch (\InvalidArgumentException) {
+            throw ValidationException::withMessages([
+                'items' => __('api.purchase.inconsistent_reservation'),
+            ]);
+        }
+
        if ($cart === null) {
            return;
        }

-        if ($cart->status === 'active') {
-            $this->reservations->detachFromPurchase($purchase);
+        if ($targetStatus === Purchase::STATUS_EXPIRED
+            && in_array($cart->status, [Cart::STATUS_ACTIVE, Cart::STATUS_CHECKOUT], true)) {
            Cart::query()
                ->whereKey($cart->getKey())
                ->where('current_purchase_id', $purchase->getKey())
-                ->update(['current_purchase_id' => null]);
-
-            return;
-        }
-
-        if ($cart->status !== 'checkout') {
-            return;
-        }
-
-        $cartItems = $cart->items()->orderBy('id')->lockForUpdate()->get();
-        $cartItems->load([
-            'catalogItem.inventory',
-            'catalogItem.bundleComponents.catalogItem.inventory',
-            'catalogItem.bundleComponents.variant.inventory',
-            'variant.inventory',
-            'variant.catalogItem',
-        ]);
-
-        foreach ($cartItems as $cartItem) {
-            $selection = $cartItem->selectedItem();
-            if ($selection === null) {
-                continue;
-            }
-
-            try {
-                $this->reservations->release(
-                    $cartItem,
-                    $selection,
-                    (int) $cartItem->cantidad,
-                    $targetStatus === Purchase::STATUS_EXPIRED
-                        ? StockReservation::STATUS_EXPIRED
-                        : StockReservation::STATUS_RELEASED,
-                );
-            } catch (\InvalidArgumentException) {
-                throw ValidationException::withMessages([
-                    'items' => __('api.purchase.inconsistent_reservation'),
+                ->where('current_stock_reservation_id', $purchase->stock_reservation_id)
+                ->update([
+                    'status' => Cart::STATUS_EXPIRED,
+                    'current_purchase_id' => null,
                ]);
-            }
+
+            return;
+        }
+
+        if ($cart->status === Cart::STATUS_ACTIVE) {
+            $cartUpdate = [
+                'current_purchase_id' => null,
+                'current_stock_reservation_id' => null,
+            ];
+
+            Cart::query()
+                ->whereKey($cart->getKey())
+                ->where('current_purchase_id', $purchase->getKey())
+                ->update($cartUpdate);
+
+            return;
+        }
+
+        if ($cart->status !== Cart::STATUS_CHECKOUT) {
+            return;
        }

        if (! $cart->trashed()) {
-            $cart->update(['status' => 'converted']);
+            $cart->update(['status' => Cart::STATUS_CONVERTED]);
            $cart->delete();
        }
    }
@@ -218,6 +212,17 @@ class ReleaseCheckoutService

    private function loadPurchase(Purchase $purchase): Purchase
    {
-        return $purchase->load(['items.imageAttachment']);
+        return $purchase->load(['items.imageAttachment', 'stockReservation']);
+    }
+
+    private function hasOverdueActiveReservation(Purchase $purchase): bool
+    {
+        /** @var StockReservation|null $reservation */
+        $reservation = $purchase->stockReservation()->lockForUpdate()->first();
+
+        return $reservation !== null
+            && $reservation->status === StockReservation::STATUS_ACTIVE
+            && $reservation->expires_at !== null
+            && ! $reservation->expires_at->isFuture();
    }
 }
--- a/app/Domains/Purchase/Services/Checkout/StartCheckoutService.php
+++ b/app/Domains/Purchase/Services/Checkout/StartCheckoutService.php
@@ -4,6 +4,7 @@ namespace App\Domains\Purchase\Services\Checkout;

 use App\Domains\Cart\Models\Cart;
 use App\Domains\Cart\Models\CartItem;
+use App\Domains\Catalog\Exceptions\StockReservationExpiredException;
 use App\Domains\Catalog\Models\CatalogItem;
 use App\Domains\Catalog\Models\Variant;
 use App\Domains\Catalog\Services\CatalogInventoryService;
@@ -12,6 +13,7 @@ use App\Domains\Purchase\Exceptions\InsufficientStockException;
 use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Purchase\Services\UserPurchaseLimitService;
 use App\Domains\Tenant\Models\Tenant;
+use Illuminate\Support\Carbon;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Validation\ValidationException;
@@ -169,21 +171,31 @@ class StartCheckoutService
                'cantidad' => $line['quantity'],
            ]);

-            try {
-                $this->reservations->reserve($cartItem, $line['selection'], $line['quantity']);
-            } catch (\InvalidArgumentException) {
-                $availableQuantity = $this->inventory->availableQuantity($line['selection']) ?? 0;
-
-                throw new InsufficientStockException([
-                    $this->unavailableItem($line, $availableQuantity),
-                ]);
-            }
-
            $cartItem->setRelation('catalogItem', $line['catalog_item']);
            $cartItem->setRelation('variant', $line['selection'] instanceof Variant ? $line['selection'] : null);
            $cartItems->push($cartItem);
        }

+        try {
+            $this->reservations->syncCart($cart);
+        } catch (\InvalidArgumentException) {
+            $unavailable = $resolvedLines
+                ->map(function (array $line): ?array {
+                    $availableQuantity = $this->inventory->availableQuantity($line['selection']);
+
+                    return $availableQuantity !== null && $availableQuantity < $line['quantity']
+                        ? $this->unavailableItem($line, $availableQuantity)
+                        : null;
+                })
+                ->filter()
+                ->values()
+                ->all();
+
+            throw new InsufficientStockException($unavailable !== [] ? $unavailable : [
+                $this->unavailableItem($resolvedLines->first(), 0),
+            ]);
+        }
+
        $purchase = $this->createPurchase(
            $tenant,
            $userId,
@@ -194,19 +206,12 @@ class StartCheckoutService
            $cart->getKey(),
        );
        $cart->update(['current_purchase_id' => $purchase->getKey()]);
+        $this->reservations->attachToPurchase($cart, $purchase, $this->checkoutExpiration());

        $cartItems = $cart->items()->orderBy('id')->lockForUpdate()->get();
        $this->loadCartItems($cartItems);
        $purchase->items()->createMany($this->snapshots->fromCartItems($cartItems));

-        foreach ($cartItems as $index => $cartItem) {
-            $this->reservations->attachToPurchase(
-                $cartItem,
-                $resolvedLines->get($index)['selection'],
-                $purchase,
-            );
-        }
-
        return $this->loadPurchase($purchase);
    }

@@ -257,6 +262,7 @@ class StartCheckoutService
        $this->verifyTenantItems($tenant, $cartItems);
        $this->assertCartPurchaseLimits($tenant, $userId, $cartItems, $cart->getKey());
        $cart->setRelation('items', $cartItems);
+        $this->reservations->syncCart($cart);

        $purchase = $this->createPurchase(
            $tenant,
@@ -266,16 +272,9 @@ class StartCheckoutService
            $cart->getKey(),
        );
        $cart->update(['current_purchase_id' => $purchase->getKey()]);
+        $this->reservations->attachToPurchase($cart, $purchase, $this->checkoutExpiration());
        $purchase->items()->createMany($this->snapshots->fromCartItems($cartItems));

-        foreach ($cartItems as $cartItem) {
-            $this->reservations->attachToPurchase(
-                $cartItem,
-                $cartItem->selectedItem(),
-                $purchase,
-            );
-        }
-
        return $this->loadPurchase($purchase);
    }

@@ -316,9 +315,9 @@ class StartCheckoutService
            Purchase::STATUS_CREATED,
            Purchase::STATUS_PENDING_PAYMENT,
        ], true)) {
+            $this->reservations->returnToCart($currentPurchase, $cart);
            $currentPurchase->update([
                'status' => Purchase::STATUS_SUPERSEDED,
-                'expires_at' => null,
            ]);
        }

@@ -331,7 +330,11 @@ class StartCheckoutService
            throw new NotFoundHttpException('Cart not found for tenant.');
        }

-        if ($cart->status !== 'active') {
+        if ($cart->status === Cart::STATUS_EXPIRED) {
+            throw new StockReservationExpiredException;
+        }
+
+        if ($cart->status !== Cart::STATUS_ACTIVE) {
            throw ValidationException::withMessages([
                'cart_id' => __('api.purchase.inactive_cart'),
            ]);
@@ -405,13 +408,17 @@ class StartCheckoutService
            'user_id' => $userId,
            'status' => Purchase::STATUS_CREATED,
            'payment_method' => null,
-            'expires_at' => now()->addMinutes(
-                max(1, (int) config('purchase.checkout_expiration_minutes', 30)),
-            ),
            'total' => $total,
        ]);
    }

+    private function checkoutExpiration(): Carbon
+    {
+        return now()->addMinutes(
+            max(1, (int) config('purchase.checkout_expiration_minutes', 30)),
+        );
+    }
+
    /** @param Collection<int, CartItem> $cartItems */
    private function loadCartItems(Collection $cartItems): void
    {
--- a/app/Domains/Purchase/Services/CheckoutService.php
+++ b/app/Domains/Purchase/Services/CheckoutService.php
@@ -2,7 +2,6 @@

 namespace App\Domains\Purchase\Services;

-use App\Domains\Catalog\Services\StockReservationService;
 use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Purchase\Services\Checkout\CompleteCheckoutService;
 use App\Domains\Purchase\Services\Checkout\EditCheckoutService;
@@ -23,7 +22,6 @@ class CheckoutService
        private readonly EditCheckoutService $editor,
        private readonly CompleteCheckoutService $completer,
        private readonly ReleaseCheckoutService $releaser,
-        private readonly StockReservationService $reservations,
    ) {}

    /** @param array<string, mixed> $purchaseData */
@@ -32,11 +30,6 @@ class CheckoutService
        return $this->starter->start($tenant, $userId, $purchaseData);
    }

-    public function completePurchase(Purchase $purchase): Purchase
-    {
-        return $this->completer->complete($purchase);
-    }
-
    public function submitForReview(Purchase $purchase): Purchase
    {
        return $this->completer->submitForReview($purchase);
@@ -77,14 +70,4 @@ class CheckoutService
    {
        return $this->releaser->expire($purchase);
    }
-
-    public function expireOverduePurchases(): int
-    {
-        return $this->releaser->expireOverdue();
-    }
-
-    public function syncReservationExpiration(Purchase $purchase): void
-    {
-        $this->reservations->syncPurchaseExpiration($purchase);
-    }
 }
--- a/app/Domains/Purchase/Services/PurchaseStateGuard.php
+++ b/app/Domains/Purchase/Services/PurchaseStateGuard.php
@@ -3,6 +3,7 @@
 namespace App\Domains\Purchase\Services;

 use App\Domains\Cart\Models\Cart;
+use App\Domains\Catalog\Models\StockReservation;
 use App\Domains\Purchase\Exceptions\PurchaseExpiredException;
 use App\Domains\Purchase\Models\Purchase;
 use Illuminate\Validation\ValidationException;
@@ -11,15 +12,32 @@ class PurchaseStateGuard
 {
    public function assertNotExpired(Purchase $purchase): void
    {
-        $hasExpiredStatus = $purchase->status === Purchase::STATUS_EXPIRED;
-        $hasExpiredByTime = in_array($purchase->status, [
+        if ($purchase->status === Purchase::STATUS_EXPIRED) {
+            throw new PurchaseExpiredException;
+        }
+
+        if (! in_array($purchase->status, [
            Purchase::STATUS_CREATED,
            Purchase::STATUS_PENDING_PAYMENT,
-        ], true)
-            && $purchase->expires_at !== null
-            && $purchase->expires_at->isPast();
+        ], true)) {
+            return;
+        }

-        if ($hasExpiredStatus || $hasExpiredByTime) {
+        /** @var StockReservation|null $reservation */
+        $reservation = $purchase->relationLoaded('stockReservation')
+            ? $purchase->getRelation('stockReservation')
+            : ($purchase->exists
+                ? $purchase->stockReservation()->first()
+                : null);
+
+        if ($reservation !== null && (
+            $reservation->status === StockReservation::STATUS_EXPIRED
+            || (
+                $reservation->status === StockReservation::STATUS_ACTIVE
+                && $reservation->expires_at !== null
+                && ! $reservation->expires_at->isFuture()
+            )
+        )) {
            throw new PurchaseExpiredException;
        }
    }
--- a/app/Domains/Purchase/Services/TenantTransactionResetService.php
+++ b/app/Domains/Purchase/Services/TenantTransactionResetService.php
@@ -135,11 +135,25 @@ class TenantTransactionResetService
     */
    private function reservationQuery(array $scope): Builder
    {
+        $reservationIds = DB::table('carritos')
+            ->whereIn('id', $scope['cart_ids'])
+            ->whereNotNull('current_stock_reservation_id')
+            ->pluck('current_stock_reservation_id')
+            ->merge(
+                DB::table('compras')
+                    ->whereIn('id', $scope['purchase_ids'])
+                    ->whereNotNull('stock_reservation_id')
+                    ->pluck('stock_reservation_id'),
+            )
+            ->merge(
+                DB::table('stock_reservation_lines')
+                    ->whereIn('inventory_id', $scope['inventory_ids'])
+                    ->pluck('stock_reservation_id'),
+            )
+            ->unique()
+            ->values();
+
        return DB::table('stock_reservations')
-            ->where(function (Builder $query) use ($scope): void {
-                $query->whereIn('inventory_id', $scope['inventory_ids'])
-                    ->orWhereIn('purchase_id', $scope['purchase_ids'])
-                    ->orWhereIn('cart_item_id', $scope['cart_item_ids']);
-            });
+            ->whereIn('id', $reservationIds);
    }
 }
--- a/app/Domains/Purchase/Services/UserPurchaseLimitService.php
+++ b/app/Domains/Purchase/Services/UserPurchaseLimitService.php
@@ -88,9 +88,9 @@ class UserPurchaseLimitService
                        $excludedCartId !== null,
                        fn ($query) => $query->whereKeyNot($excludedCartId),
                    ))
-                ->whereHas('stockReservations', fn ($query) => $query
+                ->whereHas('cart.currentStockReservation', fn ($query) => $query
                    ->where('status', 'active')
-                    ->whereNull('purchase_id'))
+                    ->whereDoesntHave('purchase'))
                ->sum('cantidad');

            if ($purchasedQuantity + $checkoutQuantity + $reservedCartQuantity + $requestedQuantity > $limit) {
@@ -161,9 +161,9 @@ class UserPurchaseLimitService
            ->whereHas('cart', fn ($query) => $query
                ->where('user_id', $userId)
                ->where('status', 'active'))
-            ->whereHas('stockReservations', fn ($query) => $query
+            ->whereHas('cart.currentStockReservation', fn ($query) => $query
                ->where('status', 'active')
-                ->whereNull('purchase_id'))
+                ->whereDoesntHave('purchase'))
            ->groupBy('catalog_item_id')
            ->pluck('quantity', 'catalog_item_id');

--- a/app/Domains/Purchase/documentacion/README.md
+++ b/app/Domains/Purchase/documentacion/README.md
@@ -6,7 +6,7 @@ Implementa el ciclo de compra y checkout: crea la cabecera de compra desde un ca

 ## Modelo

- `Purchase`: raíz de la compra; estados `created`, `pending_payment`, `in_review`, `paid`, `cancelled`, `rejected` y `expired`.
+- `Purchase`: raíz de la compra; estados `created`, `pending_payment`, `in_review`, `paid`, `cancelled`, `rejected` y `expired`, y referencia la reserva que respaldó ese intento de checkout. No guarda un vencimiento propio: expira como consecuencia del vencimiento de su reserva.
 - `PurchaseItem`: snapshot definitivo del producto o variante, creado recién al confirmar la compra.
 - `TelepagosQr` y `TelepagosPayment`: datos del QR e intentos/resultados del proveedor.
 - `PurchasePaid`: evento emitido una sola vez al pasar a pagada bajo bloqueo transaccional.
@@ -15,16 +15,16 @@ Implementa el ciclo de compra y checkout: crea la cabecera de compra desde un ca

 `CheckoutService` es la fachada estable. Delega en:

- `StartCheckoutService`: inicia la compra desde el carrito o crea un carrito técnico para compra directa, sin crear todavía `PurchaseItem`.
+- `StartCheckoutService`: inicia la compra desde el carrito o crea un carrito técnico para compra directa, refresca el vencimiento de la reserva agregada y crea los snapshots `PurchaseItem`.
 - `EditCheckoutService`: modifica los datos del comprador antes del cierre.
 - `CompleteCheckoutService`: completa, envía a revisión o materializa los `PurchaseItem` al confirmar el pago.
- `ReleaseCheckoutService`: cancela, vence y procesa vencimientos pendientes.
+- `ReleaseCheckoutService`: cancela o vence una compra y aplica sus efectos comerciales; el scanner unificado del dominio Catalog detecta las reservas pendientes de vencimiento.
 - `SourceCartService`: sincroniza o finaliza el carrito de checkout asociado a la compra.
 - `CatalogSelectionResolver` y `PurchaseItemSnapshotFactory`: resuelven selecciones y generan snapshots.

-Al informar una transferencia, la compra pasa de `pending_payment` a `in_review` y deja de vencer. Si el comprador abandona el checkout durante la revisión, la compra y sus reservas permanecen intactas y se crea un carrito activo nuevo para que pueda seguir comprando. Adminapp puede confirmar o anular explícitamente la compra en revisión.
+Al iniciar checkout o elegir un medio de pago se refresca directamente `StockReservation.expires_at`, que es la única fuente de verdad y se expone como `expires_at` en la respuesta pública de la compra. El refresco sólo se permite mientras la reserva siga vigente; una fecha vencida bloquea todas las mutaciones aun antes de que corra el scheduler. Al materializar la expiración, la compra pagable, su carrito y la reserva pasan a `expired` dentro de la misma transacción. Al cancelar o reemplazar una compra recuperable, ésta se desvincula y el carrito conserva la misma reserva activa. Al informar una transferencia, la compra pasa de `pending_payment` a `in_review` y ese vencimiento se limpia. Si el comprador abandona el checkout durante la revisión, la compra y sus reservas permanecen intactas y se crea un carrito activo nuevo para que pueda seguir comprando. Adminapp puede confirmar o anular explícitamente la compra en revisión.

-Las cantidades y variantes se editan mediante el dominio Cart. El endpoint autenticado `PATCH /checkout-carts/{cart}/items/{cartItem}` valida que el carrito pertenezca al usuario y a una compra editable. Cuando existe un cambio real, invalida atómicamente el intento de pago anterior, recalcula el total y renueva la reserva; Purchase no expone operaciones sobre líneas antes de la confirmación.
+Las cantidades y variantes se editan mediante el dominio Cart. El endpoint autenticado `PATCH /checkout-carts/{cart}/items/{cartItem}` valida que el carrito pertenezca al usuario y a una compra editable. Cuando existe un cambio real, invalida atómicamente el intento de pago anterior, devuelve la misma reserva activa al carrito y sincroniza sus líneas con el contenido actualizado; Purchase no expone operaciones sobre líneas antes de la confirmación.

 `UserPurchaseLimitService` controla límites de compra y `CheckoutService` conserva el punto de entrada para controladores e integraciones.

--- a/app/Domains/Purchase/routes/api.php
+++ b/app/Domains/Purchase/routes/api.php
@@ -9,7 +9,6 @@ Route::prefix('tenants/{tenant:codigo}')->middleware('auth:sanctum')->group(func
    Route::get('compras/{compra}', [PurchaseController::class, 'show']);
    Route::patch('compras/{compra}/customer-data', [PurchaseController::class, 'updateCustomerData']);
    Route::post('compras/{compra}/payment-intent', [PurchaseController::class, 'paymentIntent']);
-    Route::post('compras/{compra}/complete', [PurchaseController::class, 'complete']);
    Route::post('compras/{compra}/review', [PurchaseController::class, 'submitForReview']);
    Route::post('compras/{compra}/cancel', [PurchaseController::class, 'cancel']);
 });
--- a/app/Domains/Staff/routes/api.php
+++ b/app/Domains/Staff/routes/api.php
@@ -6,5 +6,8 @@ use Illuminate\Support\Facades\Route;
 Route::prefix('v1/adminapp/tenant')
    ->middleware(['auth:sanctum', 'adminapp.tenant'])
    ->group(function (): void {
-        Route::apiResource('staff', AdminAppStaffController::class)->except('show');
+        Route::get('staff', [AdminAppStaffController::class, 'index']);
+        Route::post('staff', [AdminAppStaffController::class, 'store']);
+        Route::put('staff/{staff}', [AdminAppStaffController::class, 'update']);
+        Route::delete('staff/{staff}', [AdminAppStaffController::class, 'destroy']);
    });
--- a/app/Domains/StorageTest/Controllers/S3TestController.php
+++ b/app/Domains/StorageTest/Controllers/S3TestController.php
@@ -1,58 +0,0 @@
-<?php
-
-namespace App\Domains\StorageTest\Controllers;
-
-use App\Domains\Attachable\Services\AttachmentService;
-use App\Domains\StorageTest\Requests\GenerateS3TemporaryUrlRequest;
-use App\Domains\StorageTest\Requests\StoreS3TestFileRequest;
-use App\Domains\StorageTest\Services\S3TestService;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\JsonResponse;
-
-class S3TestController extends Controller
-{
-    public function __construct(
-        protected AttachmentService $attachmentService,
-        protected S3TestService $s3TestService,
-    ) {
-    }
-
-    public function store(StoreS3TestFileRequest $request): JsonResponse
-    {
-        $attachment = $this->attachmentService->store(
-            $request->file('file') ?? (string) $request->validated('file_base64'),
-            $request->validated('path'),
-        );
-
-        $temporaryUrl = $this->s3TestService->generateTemporaryUrl(
-            $attachment->path,
-            (int) $request->validated('expires_in_minutes', 10),
-        );
-
-        return response()->json(
-            [
-                'id' => $attachment->id,
-                'key' => $attachment->key,
-                'path' => $attachment->path,
-                'filename' => $attachment->filename,
-                'type' => $attachment->type->value,
-                'mime_type' => $attachment->mime_type,
-                'extension' => $attachment->extension,
-                'size' => $attachment->size,
-                'temporary_url' => $temporaryUrl['temporary_url'],
-                'temporary_url_expires_at' => $temporaryUrl['temporary_url_expires_at'],
-            ],
-            201,
-        );
-    }
-
-    public function temporaryUrl(GenerateS3TemporaryUrlRequest $request): JsonResponse
-    {
-        return response()->json(
-            $this->s3TestService->generateTemporaryUrl(
-                $request->validated('path'),
-                (int) $request->validated('expires_in_minutes', 10),
-            )
-        );
-    }
-}
--- a/app/Domains/StorageTest/Requests/GenerateS3TemporaryUrlRequest.php
+++ b/app/Domains/StorageTest/Requests/GenerateS3TemporaryUrlRequest.php
@@ -1,24 +0,0 @@
-<?php
-
-namespace App\Domains\StorageTest\Requests;
-
-use Illuminate\Foundation\Http\FormRequest;
-
-class GenerateS3TemporaryUrlRequest extends FormRequest
-{
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    /**
-     * @return array<string, array<int, string>>
-     */
-    public function rules(): array
-    {
-        return [
-            'path' => ['required', 'string', 'max:2048'],
-            'expires_in_minutes' => ['nullable', 'integer', 'min:1', 'max:1440'],
-        ];
-    }
-}
--- a/app/Domains/StorageTest/Requests/StoreS3TestFileRequest.php
+++ b/app/Domains/StorageTest/Requests/StoreS3TestFileRequest.php
@@ -1,26 +0,0 @@
-<?php
-
-namespace App\Domains\StorageTest\Requests;
-
-use Illuminate\Foundation\Http\FormRequest;
-
-class StoreS3TestFileRequest extends FormRequest
-{
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    /**
-     * @return array<string, array<int, string>>
-     */
-    public function rules(): array
-    {
-        return [
-            'file' => ['nullable', 'file', 'max:10240', 'required_without:file_base64'],
-            'file_base64' => ['nullable', 'string', 'required_without:file'],
-            'path' => ['required', 'string', 'max:2048'],
-            'expires_in_minutes' => ['nullable', 'integer', 'min:1', 'max:1440'],
-        ];
-    }
-}
--- a/app/Domains/StorageTest/Services/S3TestService.php
+++ b/app/Domains/StorageTest/Services/S3TestService.php
@@ -1,81 +0,0 @@
-<?php
-
-namespace App\Domains\StorageTest\Services;
-
-use Illuminate\Http\UploadedFile;
-use Illuminate\Support\Facades\Log;
-use Illuminate\Support\Facades\Storage;
-use Illuminate\Support\Str;
-use RuntimeException;
-
-class S3TestService
-{
-    /**
-     * @return array<string, int|string|null>
-     */
-    public function storeTestFile(
-        UploadedFile $file,
-        ?string $directory = null,
-        int $expiresInMinutes = 10,
-    ): array {
-        $directory = $this->normalizeDirectory($directory);
-        $disk = Storage::disk('s3');
-        $path = $disk->putFile($directory, $file);
-
-        if (! is_string($path) || $path === '') {
-            Log::error('S3 upload returned an empty path.', [
-                'disk' => 's3',
-                'directory' => $directory,
-                'original_name' => $file->getClientOriginalName(),
-                'mime_type' => $file->getClientMimeType(),
-                'size' => $file->getSize(),
-            ]);
-
-            throw new RuntimeException('No se pudo subir el archivo al disco s3.');
-        }
-
-        return [
-            'disk' => 's3',
-            'directory' => $directory,
-            'key' => $path,
-            'path' => $path,
-            'filename' => basename($path),
-            'original_name' => $file->getClientOriginalName(),
-            'mime_type' => $file->getClientMimeType(),
-            'extension' => $file->extension(),
-            'size' => $file->getSize(),
-            'temporary_url' => $disk->temporaryUrl($path, now()->addMinutes($expiresInMinutes)),
-            'temporary_url_expires_at' => now()->addMinutes($expiresInMinutes)->toIso8601String(),
-        ];
-    }
-
-    /**
-     * @return array<string, string>
-     */
-    public function generateTemporaryUrl(string $path, int $expiresInMinutes = 10): array
-    {
-        return [
-            'disk' => 's3',
-            'key' => $path,
-            'path' => $path,
-            'temporary_url' => $this->temporaryUrlForPath($path, $expiresInMinutes),
-            'temporary_url_expires_at' => now()->addMinutes($expiresInMinutes)->toIso8601String(),
-        ];
-    }
-
-    protected function temporaryUrlForPath(string $path, int $expiresInMinutes): string
-    {
-        return Storage::disk('s3')->temporaryUrl($path, now()->addMinutes($expiresInMinutes));
-    }
-
-    protected function normalizeDirectory(?string $directory): string
-    {
-        $directory = trim((string) $directory, '/');
-
-        if ($directory !== '') {
-            return $directory;
-        }
-
-        return 'testing/attachments/'.now()->format('Y/m/d').'/'.Str::uuid();
-    }
-}
--- a/app/Domains/StorageTest/documentacion/README.md
+++ b/app/Domains/StorageTest/documentacion/README.md
@@ -1,23 +0,0 @@
-# Dominio StorageTest
-
-## Propósito
-
-Expone operaciones técnicas para comprobar la escritura en S3 y la generación de URL temporales.
-
-## Componentes
-
- `S3TestController`: recibe solicitudes de carga y URL temporal.
- `S3TestService`: almacena un archivo de prueba y genera el enlace firmado.
- `StoreS3TestFileRequest`: valida la carga.
- `GenerateS3TemporaryUrlRequest`: valida ruta y tiempo de expiración.
-
-## Endpoints
-
-Bajo `/storage-test/s3`:
-
- `POST /upload`.
- `GET /temporary-url`.
-
-## Consideraciones
-
-Es infraestructura de diagnóstico, no una API funcional de archivos. Debe restringirse por entorno o autorización. Para adjuntos de negocio se debe usar el dominio `Attachable`.
--- a/app/Domains/StorageTest/routes/api.php
+++ b/app/Domains/StorageTest/routes/api.php
@@ -1,9 +0,0 @@
-<?php
-
-use App\Domains\StorageTest\Controllers\S3TestController;
-use Illuminate\Support\Facades\Route;
-
-Route::prefix('storage-test/s3')->group(function (): void {
-    Route::post('upload', [S3TestController::class, 'store']);
-    Route::get('temporary-url', [S3TestController::class, 'temporaryUrl']);
-});
--- a/app/Domains/Tenant/Controllers/AdminApp/WebsiteExtraController.php
+++ b/app/Domains/Tenant/Controllers/AdminApp/WebsiteExtraController.php
@@ -5,7 +5,6 @@ namespace App\Domains\Tenant\Controllers\AdminApp;
 use App\Domains\Auth\Models\User;
 use App\Domains\Tenant\Models\Tenant;
 use App\Domains\Tenant\Requests\AdminApp\UpdateWebsiteExtraRequest;
-use App\Domains\Tenant\Resources\AdminApp\WebsiteExtraResource;
 use App\Domains\Tenant\Resources\AdminApp\WebsiteExtrasResource;
 use App\Domains\Tenant\Services\TenantInformationService;
 use App\Domains\Tenant\Services\WebsiteExtraService;
@@ -26,20 +25,6 @@ class WebsiteExtraController extends Controller
        );
    }

-    public function showExtra(Request $request, string $websiteExtraCode): WebsiteExtraResource
-    {
-        $tenant = $this->loadTenant($request->user());
-        $definition = $this->websiteExtraService->definitionForTenant($tenant, $websiteExtraCode);
-        $websiteExtra = $tenant->websiteExtras
-            ->firstWhere('website_type_extra_id', $definition->id);
-
-        if (! $websiteExtra) {
-            abort(404);
-        }
-
-        return WebsiteExtraResource::make($websiteExtra);
-    }
-
    public function update(
        UpdateWebsiteExtraRequest $request,
        string $websiteExtraCode
--- a/app/Domains/Tenant/Controllers/TenantController.php
+++ b/app/Domains/Tenant/Controllers/TenantController.php
@@ -1,64 +0,0 @@
-<?php
-
-namespace App\Domains\Tenant\Controllers;
-
-use App\Domains\Tenant\Models\Tenant;
-use App\Domains\Tenant\Requests\StoreTenantRequest;
-use App\Domains\Tenant\Requests\UpdateTenantRequest;
-use App\Domains\Tenant\Resources\TenantResource;
-use App\Domains\Tenant\Services\TenantInformationService;
-use App\Domains\Tenant\Services\TenantService;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\JsonResponse;
-use Illuminate\Http\Response;
-
-class TenantController extends Controller
-{
-    public function __construct(
-        protected TenantService $tenantService,
-        protected TenantInformationService $tenantInformationService,
-    ) {}
-
-    public function index(): JsonResponse
-    {
-        $tenants = Tenant::query()
-            ->latest()
-            ->paginateFromRequest();
-
-        $this->tenantInformationService->loadMany($tenants->getCollection());
-
-        return TenantResource::collection($tenants)->response();
-    }
-
-    public function store(StoreTenantRequest $request): JsonResponse
-    {
-        $tenant = $this->tenantService->create($request->validated());
-
-        return TenantResource::make(
-            $this->tenantInformationService->load($tenant)
-        )->response()->setStatusCode(201);
-    }
-
-    public function show(Tenant $tenant): TenantResource
-    {
-        return TenantResource::make(
-            $this->tenantInformationService->load($tenant)
-        );
-    }
-
-    public function update(UpdateTenantRequest $request, Tenant $tenant): TenantResource
-    {
-        $tenant = $this->tenantService->update($tenant, $request->validated());
-
-        return TenantResource::make(
-            $this->tenantInformationService->load($tenant)
-        );
-    }
-
-    public function destroy(Tenant $tenant): Response
-    {
-        $tenant->delete();
-
-        return response()->noContent();
-    }
-}
--- a/app/Domains/Tenant/Requests/StoreTenantRequest.php
+++ b/app/Domains/Tenant/Requests/StoreTenantRequest.php
@@ -1,128 +0,0 @@
-<?php
-
-namespace App\Domains\Tenant\Requests;
-
-use App\Domains\Catalog\Enums\GroupLayout;
-use App\Domains\Catalog\Enums\ProductLayout;
-use App\Domains\Shared\Rules\ImageOrBase64Rule;
-use App\Domains\Tenant\Enums\CartEditingPolicy;
-use App\Domains\Tenant\Services\WebsiteExtraService;
-use App\Domains\Tenant\Support\TenantDomainNormalizer;
-use Closure;
-use Illuminate\Foundation\Http\FormRequest;
-use Illuminate\Validation\Rule;
-
-class StoreTenantRequest extends FormRequest
-{
-    protected bool $hasInvalidDomain = false;
-
-    protected bool $hasInvalidBasePath = false;
-
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    protected function prepareForValidation(): void
-    {
-        $rawDomain = $this->input('dominio');
-        $hasExplicitBasePath = $this->has('base_path');
-        $rawBasePath = $hasExplicitBasePath
-            ? $this->input('base_path')
-            : TenantDomainNormalizer::pathFromDomain($rawDomain);
-        $normalizedDomain = TenantDomainNormalizer::normalize($rawDomain);
-        $normalizedBasePath = TenantDomainNormalizer::normalizePath($rawBasePath);
-
-        $this->hasInvalidDomain = TenantDomainNormalizer::hasValue($rawDomain)
-            && $normalizedDomain === null;
-        $this->hasInvalidBasePath = ($hasExplicitBasePath && ! is_string($rawBasePath))
-            || $normalizedBasePath === null;
-
-        $this->merge([
-            'dominio' => $normalizedDomain,
-            'base_path' => $normalizedBasePath,
-        ]);
-    }
-
-    /**
-     * @return array<string, mixed>
-     */
-    public function rules(): array
-    {
-        $logoRule = ['required', new ImageOrBase64Rule];
-
-        return array_merge([
-            'client_id' => ['sometimes', 'integer', Rule::exists('clients', 'id')],
-            'codigo' => ['required', 'string', 'max:255', Rule::unique('tenants', 'codigo')],
-            'nombre' => ['required', 'string', 'max:255'],
-            'dominio' => [
-                'bail',
-                function (string $attribute, mixed $value, Closure $fail): void {
-                    if ($this->hasInvalidDomain) {
-                        $fail("The {$attribute} field must contain a valid domain or URL.");
-                    }
-                },
-                'required',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'dominio')
-                    ->where('base_path', $this->input('base_path')),
-            ],
-            'base_path' => [
-                'bail',
-                function (string $attribute, mixed $value, Closure $fail): void {
-                    if ($this->hasInvalidBasePath) {
-                        $fail("The {$attribute} field must contain a valid URL path.");
-                    }
-                },
-                'required',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'base_path')
-                    ->where('dominio', $this->input('dominio')),
-            ],
-            'site_title' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'address' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'phone' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'primary_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'secondary_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'danger_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'success_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'header_bg_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'footer_bg_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'header_logo' => $logoRule,
-            'footer_logo' => $logoRule,
-            'favicon' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'header_bg_image' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'footer_bg_image' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'social_media' => ['sometimes', 'array'],
-            'social_media.*.code' => [
-                'required',
-                'string',
-                'distinct',
-                Rule::exists('social_media', 'code'),
-            ],
-            'social_media.*.url' => ['required', 'url', 'max:2048'],
-            'social_media.*.orden' => ['sometimes', 'integer', 'min:0', 'distinct'],
-            'search_product_layout' => ['sometimes', Rule::enum(ProductLayout::class)],
-            'search_group_layout' => ['sometimes', Rule::enum(GroupLayout::class)],
-            'search_items_per_page' => ['sometimes', 'integer', 'min:4', 'max:48'],
-            'display_categories' => ['sometimes', 'boolean'],
-            'display_seach_bar' => ['sometimes', 'boolean'],
-            'display_cart' => ['sometimes', 'boolean'],
-            'cart_editing_policy' => ['sometimes', Rule::enum(CartEditingPolicy::class)],
-            'checkout_editing_policy' => [
-                'sometimes',
-                Rule::in([CartEditingPolicy::Disabled->value]),
-            ],
-            'display_cart_item_images' => ['sometimes', 'boolean'],
-            'scanner_category_validation_enabled' => ['sometimes', 'boolean'],
-            'website_type_code' => [
-                'required_with:extras',
-                'sometimes',
-                'string',
-                Rule::exists('website_type', 'codigo'),
-            ],
-        ], app(WebsiteExtraService::class)->requestRules($this->input('website_type_code')));
-    }
-}
--- a/app/Domains/Tenant/Requests/UpdateTenantRequest.php
+++ b/app/Domains/Tenant/Requests/UpdateTenantRequest.php
@@ -1,143 +0,0 @@
-<?php
-
-namespace App\Domains\Tenant\Requests;
-
-use App\Domains\Catalog\Enums\GroupLayout;
-use App\Domains\Catalog\Enums\ProductLayout;
-use App\Domains\Shared\Rules\ImageOrBase64Rule;
-use App\Domains\Tenant\Enums\CartEditingPolicy;
-use App\Domains\Tenant\Models\Tenant;
-use App\Domains\Tenant\Support\TenantDomainNormalizer;
-use Closure;
-use Illuminate\Foundation\Http\FormRequest;
-use Illuminate\Validation\Rule;
-
-class UpdateTenantRequest extends FormRequest
-{
-    protected bool $hasInvalidDomain = false;
-
-    protected bool $hasInvalidBasePath = false;
-
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    protected function prepareForValidation(): void
-    {
-        if ($this->has('dominio')) {
-            $rawDomain = $this->input('dominio');
-            $normalizedDomain = TenantDomainNormalizer::normalize($rawDomain);
-            $embeddedBasePath = TenantDomainNormalizer::pathFromDomain($rawDomain);
-
-            $this->hasInvalidDomain = TenantDomainNormalizer::hasValue($rawDomain)
-                && ($normalizedDomain === null || $embeddedBasePath === null);
-
-            $this->merge([
-                'dominio' => $normalizedDomain,
-            ]);
-
-            if (! $this->has('base_path') && $embeddedBasePath !== null && $embeddedBasePath !== '/') {
-                $this->merge(['base_path' => $embeddedBasePath]);
-            }
-        }
-
-        if ($this->has('base_path')) {
-            $rawBasePath = $this->input('base_path');
-            $normalizedBasePath = TenantDomainNormalizer::normalizePath($rawBasePath);
-
-            $this->hasInvalidBasePath = ! is_string($rawBasePath)
-                || $normalizedBasePath === null;
-
-            $this->merge(['base_path' => $normalizedBasePath]);
-        }
-    }
-
-    /**
-     * @return array<string, mixed>
-     */
-    public function rules(): array
-    {
-        /** @var Tenant|null $tenant */
-        $tenant = $this->route('tenant');
-        $domain = $this->input('dominio', $tenant?->dominio);
-        $basePath = $this->input('base_path', $tenant?->base_path ?? '/');
-
-        $logoRule = ['nullable', new ImageOrBase64Rule];
-
-        return [
-            'client_id' => ['sometimes', 'integer', Rule::exists('clients', 'id')],
-            'codigo' => [
-                'nullable',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'codigo')->ignore($tenant?->id),
-            ],
-            'nombre' => ['nullable', 'string', 'max:255'],
-            'dominio' => [
-                'bail',
-                function (string $attribute, mixed $value, Closure $fail): void {
-                    if ($this->hasInvalidDomain) {
-                        $fail("The {$attribute} field must contain a valid domain or URL.");
-                    }
-                },
-                'nullable',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'dominio')
-                    ->where('base_path', $basePath)
-                    ->ignore($tenant?->id),
-            ],
-            'base_path' => [
-                'bail',
-                function (string $attribute, mixed $value, Closure $fail): void {
-                    if ($this->hasInvalidBasePath) {
-                        $fail("The {$attribute} field must contain a valid URL path.");
-                    }
-                },
-                'nullable',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'base_path')
-                    ->where('dominio', $domain)
-                    ->ignore($tenant?->id),
-            ],
-            'site_title' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'address' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'phone' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'primary_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'secondary_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'danger_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'success_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'header_bg_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'footer_bg_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'header_logo' => $logoRule,
-            'footer_logo' => $logoRule,
-            'favicon' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'header_bg_image' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'footer_bg_image' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'social_media' => ['sometimes', 'array'],
-            'social_media.*.code' => [
-                'required',
-                'string',
-                'distinct',
-                Rule::exists('social_media', 'code'),
-            ],
-            'social_media.*.url' => ['required', 'url', 'max:2048'],
-            'social_media.*.orden' => ['sometimes', 'integer', 'min:0', 'distinct'],
-            'search_product_layout' => ['sometimes', Rule::enum(ProductLayout::class)],
-            'search_group_layout' => ['sometimes', Rule::enum(GroupLayout::class)],
-            'search_items_per_page' => ['sometimes', 'integer', 'min:4', 'max:48'],
-            'display_categories' => ['sometimes', 'boolean'],
-            'display_seach_bar' => ['sometimes', 'boolean'],
-            'display_cart' => ['sometimes', 'boolean'],
-            'cart_editing_policy' => ['sometimes', Rule::enum(CartEditingPolicy::class)],
-            'checkout_editing_policy' => [
-                'sometimes',
-                Rule::in([CartEditingPolicy::Disabled->value]),
-            ],
-            'display_cart_item_images' => ['sometimes', 'boolean'],
-            'scanner_category_validation_enabled' => ['sometimes', 'boolean'],
-        ];
-    }
-}
--- a/app/Domains/Tenant/Resources/AdminApp/WebsiteExtraResource.php
+++ b/app/Domains/Tenant/Resources/AdminApp/WebsiteExtraResource.php
@@ -1,86 +0,0 @@
-<?php
-
-namespace App\Domains\Tenant\Resources\AdminApp;
-
-use App\Domains\Attachable\Models\Attachment;
-use App\Domains\Attachable\Models\AttachmentCrop;
-use App\Domains\Tenant\Models\WebsiteExtra;
-use Illuminate\Http\Request;
-use Illuminate\Http\Resources\Json\JsonResource;
-
-/**
- * @mixin WebsiteExtra
- */
-class WebsiteExtraResource extends JsonResource
-{
-    /**
-     * @return array<string, mixed>
-     */
-    public function toArray(Request $request): array
-    {
-        return [
-            'codigo' => $this->websiteTypeExtra->codigo,
-            'nombre' => $this->websiteTypeExtra->nombre,
-            'descripcion' => $this->websiteTypeExtra->descripcion,
-            'is_required' => $this->websiteTypeExtra->is_required,
-            'is_enabled' => $this->is_enabled,
-            'request_rules' => $this->websiteTypeExtra->config_schema['request_rules'] ?? [],
-            'config' => $this->formatConfig(
-                $this->resolvedConfig(),
-                fn (Attachment $attachment): string => $attachment->key
-            ),
-            'resolved_config' => $this->formatConfig(
-                $this->resolvedAdminConfig(),
-                fn (Attachment $attachment): string => $attachment->getTemporaryUrl(1440)
-            ),
-        ];
-    }
-
-    private function resolvedAdminConfig(): mixed
-    {
-        $config = $this->resolvedConfig();
-
-        if (
-            $this->websiteTypeExtra->codigo !== 'heroConfig'
-            || ! is_array($config)
-            || ! ($config['background_image_id'] ?? null) instanceof Attachment
-        ) {
-            return $config;
-        }
-
-        $attachment = $config['background_image_id'];
-        $fullRange = ['start_percentage' => 0.0, 'end_percentage' => 100.0];
-        $crops = $attachment->cropVariants->keyBy('variant');
-        $config['background_image_id'] = [
-            'url' => $attachment->getTemporaryUrl(1440),
-            'crops' => collect(AttachmentCrop::VARIANTS)->mapWithKeys(
-                function (string $variant) use ($crops, $fullRange): array {
-                    $crop = $crops->get($variant);
-
-                    return [$variant => [
-                        'crop_horizontal' => $crop?->crop_horizontal ?? $fullRange,
-                        'crop_vertical' => $crop?->crop_vertical ?? $fullRange,
-                    ]];
-                }
-            )->all(),
-        ];
-
-        return $config;
-    }
-
-    private function formatConfig(mixed $value, callable $formatAttachment): mixed
-    {
-        if ($value instanceof Attachment) {
-            return $formatAttachment($value);
-        }
-
-        if (! is_array($value)) {
-            return $value;
-        }
-
-        return array_map(
-            fn (mixed $item): mixed => $this->formatConfig($item, $formatAttachment),
-            $value
-        );
-    }
-}
--- a/app/Domains/Tenant/routes/adminapp.php
+++ b/app/Domains/Tenant/routes/adminapp.php
@@ -7,7 +7,6 @@ Route::prefix('v1/adminapp/tenant')
    ->middleware(['auth:sanctum', 'adminapp.tenant'])
    ->group(function (): void {
        Route::get('website-extras', [WebsiteExtraController::class, 'show']);
-        Route::get('website-extras/{websiteExtraCode}', [WebsiteExtraController::class, 'showExtra']);
        Route::put('website-extras/{websiteExtraCode}', [WebsiteExtraController::class, 'update']);
        Route::patch('website-extras/{websiteExtraCode}/toggle', [WebsiteExtraController::class, 'toggle']);
    });
--- a/app/Domains/Tenant/routes/api.php
+++ b/app/Domains/Tenant/routes/api.php
@@ -1,8 +1,3 @@
 <?php

-use App\Domains\Tenant\Controllers\TenantController;
-use Illuminate\Support\Facades\Route;
-
-Route::apiResource('tenants', TenantController::class);
-
 require __DIR__.'/adminapp.php';
--- a/bootstrap/app.php
+++ b/bootstrap/app.php
@@ -1,6 +1,7 @@
 <?php

 use App\Domains\Auth\Exceptions\AccountLockedException;
+use App\Domains\Catalog\Exceptions\StockReservationExpiredException;
 use App\Domains\Purchase\Exceptions\InsufficientStockException;
 use App\Domains\Purchase\Exceptions\PurchaseExpiredException;
 use App\Domains\Purchase\Exceptions\PurchaseLimitExceededException;
@@ -113,6 +114,16 @@ return Application::configure(basePath: dirname(__DIR__))
                'message' => $exception->getMessage(),
            ], 422);
        });
+        $exceptions->render(function (StockReservationExpiredException $exception, Request $request) {
+            if (! $request->is('api/*')) {
+                return null;
+            }
+
+            return response()->json([
+                'code' => 'stock_reservation.expired',
+                'message' => $exception->getMessage(),
+            ], 422);
+        });
        $exceptions->render(function (ModelNotFoundException $exception, Request $request) {
            if (! $request->is('api/*')) {
                return null;
--- a/config/auth.php
+++ b/config/auth.php
@@ -96,7 +96,7 @@ return [
        'users' => [
            'provider' => 'users',
            'table' => env('AUTH_PASSWORD_RESET_TOKEN_TABLE', 'password_reset_tokens'),
-            'expire' => 60,
+            'expire' => (int) env('AUTH_PASSWORD_RESET_EXPIRATION_MINUTES', 60),
            'throttle' => 60,
        ],
    ],
--- a/config/purchase.php
+++ b/config/purchase.php
@@ -2,10 +2,4 @@

 return [
    'checkout_expiration_minutes' => (int) env('PURCHASE_CHECKOUT_EXPIRATION_MINUTES', 30),
-
-    'payment_expiration_minutes' => [
-        'qr' => (int) env('PURCHASE_QR_EXPIRATION_MINUTES', 15),
-        'telepagos' => (int) env('PURCHASE_TELEPAGOS_EXPIRATION_MINUTES', 30),
-        'transfer' => (int) env('PURCHASE_TRANSFER_EXPIRATION_MINUTES', 1440),
-    ],
 ];
--- a/database/migrations/2026_08_25_010000_add_expires_at_to_reset_password_attempts_table.php
+++ b/database/migrations/2026_08_25_010000_add_expires_at_to_reset_password_attempts_table.php
@@ -0,0 +1,32 @@
+<?php
+
+use App\Domains\Auth\Models\ResetPasswordAttempt;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('reset_password_attempts', function (Blueprint $table): void {
+            $table->timestamp('expires_at')->nullable()->after('status');
+        });
+
+        // Attempts created before this migration did not have an expiration instant.
+        DB::table('reset_password_attempts')
+            ->whereIn('status', [
+                ResetPasswordAttempt::STATUS_PENDING,
+                ResetPasswordAttempt::STATUS_VALIDATED,
+            ])
+            ->update(['status' => ResetPasswordAttempt::STATUS_EXPIRED]);
+    }
+
+    public function down(): void
+    {
+        Schema::table('reset_password_attempts', function (Blueprint $table): void {
+            $table->dropColumn('expires_at');
+        });
+    }
+};
--- a/database/migrations/2026_08_25_020000_centralize_stock_reservations.php
+++ b/database/migrations/2026_08_25_020000_centralize_stock_reservations.php
@@ -0,0 +1,180 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::rename('stock_reservations', 'stock_reservation_lines');
+
+        Schema::create('stock_reservations', function (Blueprint $table): void {
+            $table->id();
+            $table->string('status')->default('active');
+            $table->dateTime('expires_at')->nullable();
+            $table->dateTime('committed_at')->nullable();
+            $table->dateTime('released_at')->nullable();
+            $table->dateTime('expired_at')->nullable();
+            $table->string('release_reason')->nullable();
+            $table->timestamps();
+
+            $table->index(['status', 'expires_at']);
+        });
+
+        Schema::table('stock_reservation_lines', function (Blueprint $table): void {
+            $table->foreignId('stock_reservation_id')->nullable()->after('id');
+            $table->boolean('tracks_inventory')->default(true)->after('quantity');
+        });
+
+        Schema::table('carritos', function (Blueprint $table): void {
+            $table->foreignId('current_stock_reservation_id')->nullable()->after('current_purchase_id');
+        });
+
+        Schema::table('compras', function (Blueprint $table): void {
+            $table->foreignId('stock_reservation_id')->nullable()->after('cart_id');
+        });
+
+        $cartIdsByItem = DB::table('carrito_items')->pluck('cart_id', 'id');
+        $unlimitedInventoryIds = DB::table('catalog_items')
+            ->where('inventory_policy', 'unlimited')
+            ->whereNotNull('inventory_id')
+            ->pluck('inventory_id')
+            ->merge(
+                DB::table('variantes')
+                    ->join('catalog_items', 'catalog_items.id', '=', 'variantes.catalog_item_id')
+                    ->where('catalog_items.inventory_policy', 'unlimited')
+                    ->pluck('variantes.inventory_id'),
+            )
+            ->map(fn ($id): int => (int) $id)
+            ->unique();
+        $legacyRows = DB::table('stock_reservation_lines')->orderBy('id')->get();
+        $groups = $legacyRows->groupBy(function (object $row) use ($cartIdsByItem): string {
+            if ($row->purchase_id !== null) {
+                return 'purchase:'.$row->purchase_id;
+            }
+
+            $cartId = $row->cart_item_id === null ? null : $cartIdsByItem->get($row->cart_item_id);
+
+            return $cartId === null ? 'legacy:'.$row->id : 'cart:'.$cartId;
+        });
+
+        foreach ($groups as $key => $rows) {
+            $statuses = $rows->pluck('status');
+            $status = $statuses->contains('active')
+                ? 'active'
+                : ($statuses->contains('committed')
+                    ? 'committed'
+                    : ($statuses->contains('expired') ? 'expired' : 'released'));
+            $first = $rows->first();
+            $reservationId = DB::table('stock_reservations')->insertGetId([
+                'status' => $status,
+                'expires_at' => $status === 'active' ? $rows->pluck('expires_at')->filter()->max() : null,
+                'committed_at' => $status === 'committed' ? $rows->pluck('committed_at')->filter()->max() : null,
+                'released_at' => $status === 'released' ? $rows->pluck('released_at')->filter()->max() : null,
+                'expired_at' => $status === 'expired' ? $rows->pluck('released_at')->filter()->max() : null,
+                'release_reason' => null,
+                'created_at' => $first->created_at,
+                'updated_at' => $rows->pluck('updated_at')->filter()->max() ?? $first->updated_at,
+            ]);
+
+            foreach ($rows->groupBy('inventory_id') as $inventoryRows) {
+                $line = $inventoryRows->first();
+                DB::table('stock_reservation_lines')->where('id', $line->id)->update([
+                    'stock_reservation_id' => $reservationId,
+                    'quantity' => $inventoryRows->sum('quantity'),
+                    'tracks_inventory' => ! $unlimitedInventoryIds->contains((int) $line->inventory_id),
+                ]);
+                DB::table('stock_reservation_lines')
+                    ->whereIn('id', $inventoryRows->pluck('id')->skip(1))
+                    ->delete();
+            }
+
+            if (str_starts_with($key, 'purchase:')) {
+                $purchaseId = (int) substr($key, strlen('purchase:'));
+                DB::table('compras')->where('id', $purchaseId)->update([
+                    'stock_reservation_id' => $reservationId,
+                ]);
+                $cartId = DB::table('compras')->where('id', $purchaseId)->value('cart_id');
+                $isCurrent = $cartId !== null
+                    && (int) DB::table('carritos')->where('id', $cartId)->value('current_purchase_id') === $purchaseId;
+
+                if ($status === 'active' && $isCurrent) {
+                    DB::table('carritos')->where('id', $cartId)->update([
+                        'current_stock_reservation_id' => $reservationId,
+                    ]);
+                }
+            } elseif (str_starts_with($key, 'cart:') && $status === 'active') {
+                DB::table('carritos')->where('id', (int) substr($key, strlen('cart:')))->update([
+                    'current_stock_reservation_id' => $reservationId,
+                ]);
+            }
+        }
+
+        if (DB::getDriverName() !== 'sqlite') {
+            Schema::table('stock_reservation_lines', function (Blueprint $table): void {
+                $table->dropForeign('stock_reservations_cart_item_id_foreign');
+                $table->dropForeign('stock_reservations_purchase_id_foreign');
+                $table->dropUnique('stock_reservations_cart_item_id_inventory_id_unique');
+                $table->dropIndex('stock_reservations_purchase_id_status_index');
+                $table->dropIndex('stock_reservations_status_expires_at_index');
+            });
+        }
+
+        Schema::table('stock_reservation_lines', function (Blueprint $table): void {
+            $table->unsignedBigInteger('stock_reservation_id')->nullable(false)->change();
+            $table->dropColumn([
+                'cart_item_id',
+                'purchase_id',
+                'status',
+                'expires_at',
+                'committed_at',
+                'released_at',
+            ]);
+            $table->foreign('stock_reservation_id', 'reservation_lines_reservation_fk')
+                ->references('id')
+                ->on('stock_reservations')
+                ->cascadeOnDelete();
+            $table->unique(
+                ['stock_reservation_id', 'inventory_id'],
+                'reservation_lines_reservation_inventory_unique',
+            );
+        });
+
+        Schema::table('carritos', function (Blueprint $table): void {
+            $table->foreign('current_stock_reservation_id', 'carts_current_stock_reservation_fk')
+                ->references('id')
+                ->on('stock_reservations')
+                ->nullOnDelete();
+            $table->unique('current_stock_reservation_id', 'carts_current_stock_reservation_unique');
+        });
+
+        Schema::table('compras', function (Blueprint $table): void {
+            $table->foreign('stock_reservation_id', 'purchases_stock_reservation_fk')
+                ->references('id')
+                ->on('stock_reservations')
+                ->nullOnDelete();
+            $table->unique('stock_reservation_id', 'purchases_stock_reservation_unique');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('compras', function (Blueprint $table): void {
+            $table->dropUnique('purchases_stock_reservation_unique');
+            $table->dropForeign('purchases_stock_reservation_fk');
+            $table->dropColumn('stock_reservation_id');
+        });
+
+        Schema::table('carritos', function (Blueprint $table): void {
+            $table->dropUnique('carts_current_stock_reservation_unique');
+            $table->dropForeign('carts_current_stock_reservation_fk');
+            $table->dropColumn('current_stock_reservation_id');
+        });
+
+        Schema::dropIfExists('stock_reservation_lines');
+        Schema::dropIfExists('stock_reservations');
+    }
+};
--- a/database/migrations/2026_08_25_160000_make_stock_reservation_expiration_authoritative.php
+++ b/database/migrations/2026_08_25_160000_make_stock_reservation_expiration_authoritative.php
@@ -0,0 +1,51 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        DB::table('compras')
+            ->whereNotNull('stock_reservation_id')
+            ->orderBy('id')
+            ->chunkById(500, function ($purchases): void {
+                foreach ($purchases as $purchase) {
+                    DB::table('stock_reservations')
+                        ->where('id', $purchase->stock_reservation_id)
+                        ->where('status', 'active')
+                        ->update(['expires_at' => $purchase->expires_at]);
+                }
+            });
+
+        Schema::table('compras', function (Blueprint $table): void {
+            $table->dropIndex(['expires_at']);
+            $table->dropColumn('expires_at');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('compras', function (Blueprint $table): void {
+            $table->timestamp('expires_at')->nullable()->index()->after('payment_method');
+        });
+
+        DB::table('compras')
+            ->whereNotNull('stock_reservation_id')
+            ->orderBy('id')
+            ->chunkById(500, function ($purchases): void {
+                foreach ($purchases as $purchase) {
+                    DB::table('compras')
+                        ->where('id', $purchase->id)
+                        ->update([
+                            'expires_at' => DB::table('stock_reservations')
+                                ->where('id', $purchase->stock_reservation_id)
+                                ->value('expires_at'),
+                        ]);
+                }
+            });
+    }
+};
--- a/database/migrations/2026_08_25_170000_propagate_expired_stock_reservations.php
+++ b/database/migrations/2026_08_25_170000_propagate_expired_stock_reservations.php
@@ -0,0 +1,30 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        $expiredReservationIds = fn ($query) => $query
+            ->select('id')
+            ->from('stock_reservations')
+            ->where('status', 'expired');
+
+        DB::table('compras')
+            ->whereIn('status', ['created', 'pending_payment'])
+            ->whereIn('stock_reservation_id', $expiredReservationIds)
+            ->update(['status' => 'expired']);
+
+        DB::table('carritos')
+            ->whereIn('status', ['active', 'checkout'])
+            ->whereIn('current_stock_reservation_id', $expiredReservationIds)
+            ->update(['status' => 'expired']);
+    }
+
+    public function down(): void
+    {
+        // Terminal business states cannot be reversed without inventing their prior state.
+    }
+};
--- a/lang/en/api.php
+++ b/lang/en/api.php
@@ -12,6 +12,7 @@ return [
        'password_reset_invalid' => 'The password recovery request is invalid or has already been used.',
        'password_updated' => 'Password updated successfully.',
        'reset_code_invalid' => 'The code you entered is invalid.',
+        'reset_code_expired' => 'The password recovery code expired. Request a new one.',
        'reset_code_valid' => 'Code validated successfully.',
        'invalid_tenant_or_return_url' => 'The tenant or return URL is invalid.',
        'request_expired' => 'The authentication request expired. Please try again.',
@@ -34,6 +35,7 @@ return [
        'bundle_variant_forbidden' => 'A bundle cannot have a variant.',
        'empty_bundle' => 'The bundle has no components.',
        'variant_required' => 'You must select a variant for this item.',
+        'reservation_expired' => 'The stock reservation has expired. Use the active cart to continue.',
    ],
    'purchase' => [
        'expired' => 'The purchase has expired. Please start a new purchase.',
--- a/lang/es/api.php
+++ b/lang/es/api.php
@@ -12,6 +12,7 @@ return [
        'password_reset_invalid' => 'La solicitud de recuperación es inválida o ya fue utilizada.',
        'password_updated' => 'Contraseña modificada correctamente.',
        'reset_code_invalid' => 'El código ingresado es inválido.',
+        'reset_code_expired' => 'El código de recuperación expiró. Solicitá uno nuevo.',
        'reset_code_valid' => 'Código validado correctamente.',
        'invalid_tenant_or_return_url' => 'El tenant o la URL de retorno no son válidos.',
        'request_expired' => 'La solicitud de autenticación expiró. Intenta nuevamente.',
@@ -34,6 +35,7 @@ return [
        'bundle_variant_forbidden' => 'Un bundle no admite una variante.',
        'empty_bundle' => 'El bundle no tiene componentes.',
        'variant_required' => 'Debe seleccionar una variante para este ítem.',
+        'reservation_expired' => 'La reserva de stock venció. Usá el carrito activo para continuar.',
    ],
    'purchase' => [
        'expired' => "La compra venci\u{00F3}. Inici\u{00E1} una nueva compra.",
--- a/postman/attachable-s3-testing.postman_collection.json
+++ b/postman/attachable-s3-testing.postman_collection.json
@@ -1,95 +0,0 @@
-{
-  "info": {
-    "_postman_id": "8faefdb8-734a-4262-a3b6-4d49e56ea901",
-    "name": "Storage Test S3",
-    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
-  },
-  "variable": [
-    {
-      "key": "base_url",
-      "value": "http://127.0.0.1:8000"
-    },
-    {
-      "key": "expires_in_minutes",
-      "value": "10"
-    },
-    {
-      "key": "path",
-      "value": ""
-    }
-  ],
-  "item": [
-    {
-      "name": "Upload Test File",
-      "request": {
-        "method": "POST",
-        "header": [],
-        "body": {
-          "mode": "formdata",
-          "formdata": [
-            {
-              "key": "file",
-              "type": "file",
-              "src": []
-            },
-            {
-              "key": "directory",
-              "value": "testing/manual",
-              "type": "text"
-            },
-            {
-              "key": "expires_in_minutes",
-              "value": "{{expires_in_minutes}}",
-              "type": "text"
-            }
-          ]
-        },
-        "url": {
-          "raw": "{{base_url}}/api/storage-test/s3/upload",
-          "host": [
-            "{{base_url}}"
-          ],
-          "path": [
-            "api",
-            "storage-test",
-            "s3",
-            "upload"
-          ]
-        },
-        "description": "Sube un archivo al disco s3 y devuelve el path junto con una temporary_url."
-      },
-      "response": []
-    },
-    {
-      "name": "Generate Temporary URL",
-      "request": {
-        "method": "GET",
-        "header": [],
-        "url": {
-          "raw": "{{base_url}}/api/storage-test/s3/temporary-url?path={{path}}&expires_in_minutes={{expires_in_minutes}}",
-          "host": [
-            "{{base_url}}"
-          ],
-          "path": [
-            "api",
-            "storage-test",
-            "s3",
-            "temporary-url"
-          ],
-          "query": [
-            {
-              "key": "path",
-              "value": "{{path}}"
-            },
-            {
-              "key": "expires_in_minutes",
-              "value": "{{expires_in_minutes}}"
-            }
-          ]
-        },
-        "description": "Genera una URL temporal para un path ya existente en S3."
-      },
-      "response": []
-    }
-  ]
-}
--- a/postman/generate-shopit-collection.php
+++ b/postman/generate-shopit-collection.php
@@ -67,18 +67,7 @@ function bodyFor(string $method, string $uri): ?array
        'POST api/password/reset-attempts' => ['tenant_codigo' => '{{tenant_code}}', 'email' => '{{user_email}}'],
        'POST api/password/reset-attempts/validate' => ['email' => '{{user_email}}', 'codigo' => '{{reset_code}}'],
        'POST api/password/reset' => ['email' => '{{user_email}}', 'codigo' => '{{reset_code}}', 'password' => '{{user_password}}', 'password_confirmation' => '{{user_password}}'],
-        'POST api/clients' => ['code' => 'cliente-demo', 'name' => 'Cliente Demo'],
-        'PUT api/clients/{client}' => ['code' => 'cliente-demo', 'name' => 'Cliente Demo Actualizado'],
-        'PATCH api/clients/{client}' => ['name' => 'Cliente Demo Actualizado'],
-        'POST api/integrations' => ['integration_code' => 'telepagos', 'name' => 'Telepagos', 'url' => 'https://api.example.com', 'integration_data_schema' => ['api_key' => ['required', 'string']], 'requires_client_configuration' => true],
-        'PUT api/integrations/{integration}' => ['name' => 'Telepagos', 'url' => 'https://api.example.com', 'requires_client_configuration' => true],
        'PUT api/clients/{client}/integrations/{integration_code}' => ['integration_data' => ['api_key' => 'replace-me']],
-        'POST api/menues' => ['code' => 'demo', 'label' => 'Demo', 'parent_menu_code' => null, 'content_type' => 'static', 'static_content_schema' => ['title' => ['required', 'string']], 'route' => '/demo'],
-        'PUT api/menues/{menue}' => ['label' => 'Demo actualizado', 'route' => '/demo'],
-        'PATCH api/menues/{menue}' => ['label' => 'Demo actualizado'],
-        'POST api/{tenant_code}/menues/{menu_code}' => ['static_content' => ['title' => 'Contenido demo']],
-        'POST api/webhooks/telepagos/{client}' => ['id' => 'payment-id-demo'],
-        'POST api/{tenant_code}/mail-test/send' => ['to' => 'destinatario@example.com', 'subject' => 'Prueba ShopIt', 'message' => 'Correo de prueba enviado desde Postman.'],
        'POST api/tenants/{tenant:codigo}/cart/items' => ['catalog_item_id' => '{{catalog_item_id}}', 'variant_id' => '{{variant_id}}', 'cantidad' => 1],
        'PATCH api/tenants/{tenant:codigo}/cart/items/{cartItem}' => ['cantidad' => 2, 'variant_id' => '{{variant_id}}'],
        'POST api/tenants/{tenant:codigo}/catalog-items/{catalogItem}/variant-options' => ['selected_values' => ['color' => 'azul'], 'cart_item_id' => '{{cart_item_id}}'],
@@ -92,11 +81,8 @@ function bodyFor(string $method, string $uri): ?array
        'POST api/v1/adminapp/password/reset-attempts/validate' => ['email' => '{{admin_email}}', 'codigo' => '{{reset_code}}'],
        'POST api/v1/adminapp/password/reset' => ['email' => '{{admin_email}}', 'codigo' => '{{reset_code}}', 'password' => '{{admin_password}}', 'password_confirmation' => '{{admin_password}}'],
        'PUT api/v1/adminapp/tenant/event' => ['title' => 'Evento Demo', 'location' => 'Buenos Aires', 'dates' => [['date' => '2026-12-01', 'start_time' => '18:00', 'end_time' => '23:00']], 'social_media' => [['code' => 'instagram', 'url' => 'https://instagram.com/example', 'orden' => 0]]],
-        'POST api/v1/adminapp/tenant/featured-groups' => ['category_name' => 'Destacados', 'is_featured' => true],
-        'PUT api/v1/adminapp/tenant/featured-groups/{featuredGroup}' => ['category_name' => 'Destacados', 'is_featured' => true],
        'POST api/v1/adminapp/tenant/staff' => ['nombre_apellido' => 'Operador Demo', 'dni' => '30123456', 'email' => 'operador@example.com', 'category_ids' => [1]],
        'PUT api/v1/adminapp/tenant/staff/{staff}' => ['nombre_apellido' => 'Operador Demo', 'dni' => '30123456', 'email' => 'operador@example.com', 'category_ids' => [1]],
-        'PATCH api/v1/adminapp/tenant/staff/{staff}' => ['nombre_apellido' => 'Operador Demo', 'dni' => '30123456', 'email' => 'operador@example.com', 'category_ids' => [1]],
        'PUT api/v1/adminapp/tenant/website-extras/{websiteExtraCode}' => ['enabled' => true, 'content' => ['title' => 'Contenido demo']],
        'PATCH api/v1/adminapp/tenant/website-extras/{websiteExtraCode}/toggle' => ['enabled' => true],
        'POST api/v1/adminapp/tenant/accommodations' => ['variants' => [['title' => 'Habitación doble', 'description' => 'Dos personas', 'stock' => 10, 'price' => 100000]]],
@@ -162,10 +148,6 @@ function bodyFor(string $method, string $uri): ?array
        ]);
    }

-    if ($key === 'POST api/storage-test/s3/upload') {
-        return formDataBody(['path' => 'postman/test-file.png', 'expires_in_minutes' => '60'], ['file']);
-    }
-
    if ($key === 'POST api/v1/adminapp/tenant/desfile/entries/image') {
        return formDataBody(['is_enabled' => '1'], ['image']);
    }
@@ -194,7 +176,6 @@ function queryFor(string $uri): array
            ['key' => 'per_page', 'value' => '20'],
        ],
        'api/v1/scanner/tickets' => [['key' => 'q', 'value' => '', 'disabled' => true], ['key' => 'page', 'value' => '1'], ['key' => 'per_page', 'value' => '20']],
-        'api/storage-test/s3/temporary-url' => [['key' => 'path', 'value' => '{{s3_path}}'], ['key' => 'expires_in_minutes', 'value' => '60']],
        default => [],
    };
 }
@@ -213,14 +194,6 @@ function folderFor(string $uri, string $action): array
        return ['Scanner API', $domain];
    }

-    if (str_starts_with($uri, 'api/webhooks/')) {
-        return ['Webhooks', $domain];
-    }
-
-    if (in_array($domain, ['StorageTest', 'MailTest'], true)) {
-        return ['Developer Utilities', $domain];
-    }
-
    if (in_array($domain, ['Client', 'Integration', 'Menu', 'Tenant'], true) && ! str_contains($uri, '{tenant:codigo}')) {
        return ['Platform Management', $domain];
    }
@@ -268,8 +241,7 @@ function pathFor(string $uri): string
 {
    $variables = [
        'tenant:codigo' => 'tenant_code', 'tenant' => 'tenant_id', 'client' => 'client_id',
-        'integration_code' => 'integration_code', 'integration' => 'integration_id', 'menue' => 'menu_id',
-        'menu_code' => 'menu_code', 'tenant_code' => 'tenant_code', 'catalogItem' => 'catalog_item_id',
+        'integration_code' => 'integration_code', 'tenant_code' => 'tenant_code', 'catalogItem' => 'catalog_item_id',
        'featuredGroup' => 'featured_group_id', 'category' => 'category_id', 'cartItem' => 'cart_item_id',
        'compra' => 'purchase_id', 'item' => 'purchase_item_id', 'dominio' => 'tenant_domain',
        'sale' => 'sale_id', 'staff' => 'staff_id', 'websiteExtraCode' => 'website_extra_code',
@@ -420,14 +392,13 @@ $variables = [
    'admin_email' => 'admin@example.com', 'admin_password' => 'Password!123',
    'scanner_email' => 'scanner@example.com', 'scanner_password' => 'Password!123',
    'tenant_code' => 'demo', 'tenant_id' => '1', 'tenant_domain' => 'demo.test',
-    'client_id' => '1', 'integration_id' => '1', 'integration_code' => 'telepagos',
-    'menu_id' => '1', 'menu_code' => 'demo', 'catalog_item_id' => '1', 'variant_id' => '1',
+    'client_id' => '1', 'integration_code' => 'telepagos',
+    'catalog_item_id' => '1', 'variant_id' => '1',
    'category_id' => '1', 'featured_group_id' => '1', 'cart_id' => '1', 'cart_item_id' => '1',
    'purchase_id' => '1', 'purchase_item_id' => '1', 'sale_id' => '1', 'staff_id' => '1',
    'website_extra_code' => 'hero', 'accommodation_id' => '1', 'entry_id' => '1', 'food_id' => '1',
    'merchandise_id' => '1', 'ticket_uuid' => '00000000-0000-0000-0000-000000000000',
    'oauth_code' => '00000000-0000-0000-0000-000000000000', 'reset_code' => '1234',
-    's3_path' => 'postman/test-file.png',
 ];

 $collection = [
--- a/routes/api.php
+++ b/routes/api.php
@@ -3,15 +3,11 @@
 require __DIR__.'/../app/Domains/Auth/routes/api.php';
 require __DIR__.'/../app/Domains/Catalog/routes/api.php';
 require __DIR__.'/../app/Domains/Cart/routes/api.php';
-require __DIR__.'/../app/Domains/StorageTest/routes/api.php';
-require __DIR__.'/../app/Domains/MailTest/routes/api.php';
 require __DIR__.'/../app/Domains/Purchase/routes/api.php';
 require __DIR__.'/../app/Domains/Sale/routes/api.php';
 require __DIR__.'/../app/Domains/Bootstrap/routes/api.php';
 require __DIR__.'/../app/Domains/Tenant/routes/api.php';
-require __DIR__.'/../app/Domains/Client/routes/api.php';
 require __DIR__.'/../app/Domains/Integration/routes/api.php';
-require __DIR__.'/../app/Domains/Menu/routes/api.php';
 require __DIR__.'/../app/Domains/Ticket/routes/api.php';
 require __DIR__.'/../app/Domains/Event/routes/api.php';
 require __DIR__.'/../app/Domains/Forms/routes/api.php';
--- a/routes/console.php
+++ b/routes/console.php
@@ -15,7 +15,9 @@ Artisan::command('reservations:expire', function (): void {
    $expired = app(ExpireStockReservationsService::class)->expireOverdue();

    $this->info("Expired purchases: {$expired['purchases']}");
-    $this->info("Expired cart items: {$expired['cart_items']}");
+    $this->info("Expired cart reservations: {$expired['cart_reservations']}");
+    $this->info("Expired orphan reservations: {$expired['orphan_reservations']}");
+    $this->info("Failed reservations: {$expired['failed']}");
 })->purpose('Release expired stock reservations from purchases and abandoned carts');

 Schedule::command('reservations:expire')
--- a/tests/Feature/Auth/CreateResetPasswordAttemptControllerTest.php
+++ b/tests/Feature/Auth/CreateResetPasswordAttemptControllerTest.php
@@ -69,6 +69,10 @@ class CreateResetPasswordAttemptControllerTest extends TestCase
        $this->assertTrue($attempt->user->is($user));
        $this->assertMatchesRegularExpression('/^\d{4}$/', $attempt->codigo);
        $this->assertSame(ResetPasswordAttempt::STATUS_PENDING, $attempt->status);
+        $this->assertTrue($attempt->expires_at->between(
+            now()->addMinutes(59),
+            now()->addMinutes(60),
+        ));
        Event::assertDispatched(
            PasswordResetRequested::class,
            fn (PasswordResetRequested $event): bool => $event->attemptId === $attempt->id
--- a/tests/Feature/Auth/ResetPasswordAttemptTest.php
+++ b/tests/Feature/Auth/ResetPasswordAttemptTest.php
@@ -18,7 +18,9 @@ class ResetPasswordAttemptTest extends TestCase
            'id',
            'user_id',
            'codigo',
+            'reason',
            'status',
+            'expires_at',
        ], Schema::getColumnListing('reset_password_attempts'));
    }

@@ -28,12 +30,14 @@ class ResetPasswordAttemptTest extends TestCase

        $attempt = $user->resetPasswordAttempts()->create([
            'codigo' => '123456',
+            'expires_at' => now()->addHour(),
        ]);

        $this->assertSame(ResetPasswordAttempt::STATUS_PENDING, $attempt->status);
        $this->assertTrue($attempt->user->is($user));
        $this->assertTrue($user->resetPasswordAttempts->contains($attempt));
        $this->assertFalse($attempt->usesTimestamps());
+        $this->assertTrue($attempt->expires_at->isFuture());
        $this->assertArrayNotHasKey('codigo', $attempt->toArray());
    }

--- a/tests/Feature/Auth/ResetPasswordControllerTest.php
+++ b/tests/Feature/Auth/ResetPasswordControllerTest.php
@@ -99,6 +99,30 @@ class ResetPasswordControllerTest extends TestCase
        $this->assertSame(ResetPasswordAttempt::STATUS_USED, $attempt->fresh()->status);
    }

+    public function test_an_expired_validated_attempt_cannot_reset_the_password(): void
+    {
+        $user = User::factory()->create([
+            'email' => 'ada@example.com',
+            'password' => 'OldSecret!123',
+        ]);
+        $attempt = $user->resetPasswordAttempts()->create([
+            'codigo' => '1234',
+            'status' => ResetPasswordAttempt::STATUS_VALIDATED,
+            'expires_at' => now()->subSecond(),
+        ]);
+
+        $this->postJson('/api/password/reset', [
+            'email' => 'ada@example.com',
+            'codigo' => '1234',
+            'password' => 'NewSecret!456',
+            'password_confirmation' => 'NewSecret!456',
+        ])->assertUnprocessable()
+            ->assertJsonValidationErrors('codigo');
+
+        $this->assertTrue(Hash::check('OldSecret!123', $user->fresh()->password));
+        $this->assertSame(ResetPasswordAttempt::STATUS_EXPIRED, $attempt->fresh()->status);
+    }
+
    public function test_it_validates_password_confirmation_and_strength(): void
    {
        $this->postJson('/api/password/reset', [
--- a/tests/Feature/Auth/ValidateResetPasswordAttemptControllerTest.php
+++ b/tests/Feature/Auth/ValidateResetPasswordAttemptControllerTest.php
@@ -49,6 +49,27 @@ class ValidateResetPasswordAttemptControllerTest extends TestCase
        );
    }

+    public function test_it_expires_an_attempt_and_returns_the_expired_code_message(): void
+    {
+        $user = User::factory()->create(['email' => 'ada@example.com']);
+        $attempt = $user->resetPasswordAttempts()->create([
+            'codigo' => '1234',
+            'expires_at' => now()->subSecond(),
+        ]);
+
+        $this->postJson('/api/password/reset-attempts/validate', [
+            'email' => 'ada@example.com',
+            'codigo' => '1234',
+        ])->assertUnprocessable()
+            ->assertJsonValidationErrors('codigo')
+            ->assertJsonPath('errors.codigo.0', __('api.auth.reset_code_expired'));
+
+        $this->assertSame(
+            ResetPasswordAttempt::STATUS_EXPIRED,
+            $attempt->fresh()->status,
+        );
+    }
+
    public function test_it_rejects_an_expired_or_already_validated_attempt(): void
    {
        $user = User::factory()->create(['email' => 'ada@example.com']);
--- a/tests/Feature/Cart/CartControllerTest.php
+++ b/tests/Feature/Cart/CartControllerTest.php
@@ -5,10 +5,12 @@ namespace Tests\Feature\Cart;
 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\CatalogItem;
 use App\Domains\Catalog\Models\Inventory;
 use App\Domains\Catalog\Models\Variant;
+use App\Domains\Catalog\Services\CatalogService;
 use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Purchase\Models\PurchaseItem;
 use App\Domains\Tenant\Models\Tenant;
@@ -28,6 +30,81 @@ class CartControllerTest extends TestCase
        ]));
        $this->assertFalse(Schema::hasColumn('carrito_items', 'buyable_type'));
        $this->assertFalse(Schema::hasColumn('carrito_items', 'buyable_id'));
+        $this->assertTrue(Schema::hasColumns('stock_reservations', [
+            'status',
+            'expires_at',
+            'committed_at',
+            'released_at',
+            'expired_at',
+            'release_reason',
+        ]));
+        $this->assertFalse(Schema::hasColumn('stock_reservations', 'quantity'));
+        $this->assertTrue(Schema::hasColumns('stock_reservation_lines', [
+            'stock_reservation_id',
+            'inventory_id',
+            'quantity',
+            'tracks_inventory',
+        ]));
+        $this->assertTrue(Schema::hasColumn('carritos', 'current_stock_reservation_id'));
+        $this->assertTrue(Schema::hasColumn('compras', 'stock_reservation_id'));
+        $this->assertFalse(Schema::hasColumn('compras', 'expires_at'));
+    }
+
+    public function test_it_aggregates_shared_inventory_into_one_cart_reservation_line(): void
+    {
+        $tenant = $this->createTenant('acme');
+        $firstItem = $this->createDirectItem($tenant, 10, '10.00');
+        $secondItem = app(CatalogService::class)->create([
+            'tenant_code' => $tenant->codigo,
+            'type' => 'bundle',
+            'slug' => 'second-shared-item',
+            'nombre' => 'Second shared item',
+            'precio' => '20.00',
+            'components' => [[
+                'catalog_item_id' => $firstItem->id,
+                'quantity' => 1,
+            ]],
+        ]);
+
+        $firstResponse = $this->postJson('/api/tenants/acme/cart/items', [
+            'catalog_item_id' => $firstItem->id,
+            'cantidad' => 2,
+        ])->assertOk();
+        $guestToken = $firstResponse->getCookie('guest_token', false)?->getValue();
+
+        $this->call(
+            'POST',
+            '/api/tenants/acme/cart/items',
+            [],
+            ['guest_token' => $guestToken],
+            [],
+            ['HTTP_Accept' => 'application/json', 'CONTENT_TYPE' => 'application/json'],
+            json_encode([
+                'catalog_item_id' => $secondItem->id,
+                'cantidad' => 3,
+            ]),
+        )->assertOk();
+
+        $reservationId = (int) $firstResponse->json('data.id');
+        $reservationId = (int) Cart::query()
+            ->findOrFail($reservationId)
+            ->current_stock_reservation_id;
+
+        $this->assertDatabaseCount('stock_reservations', 1);
+        $this->assertDatabaseHas('stock_reservations', [
+            'id' => $reservationId,
+            'status' => 'active',
+        ]);
+        $this->assertDatabaseHas('stock_reservation_lines', [
+            'stock_reservation_id' => $reservationId,
+            'inventory_id' => $firstItem->inventory_id,
+            'quantity' => 5,
+        ]);
+        $this->assertDatabaseCount('stock_reservation_lines', 1);
+        $this->assertDatabaseHas('inventories', [
+            'id' => $firstItem->inventory_id,
+            'reserved_stock' => 5,
+        ]);
    }

    public function test_it_adds_a_catalog_item_without_a_variant(): void
@@ -74,9 +151,11 @@ class CartControllerTest extends TestCase
            'id' => $item->inventory_id,
            'reserved_stock' => 2,
        ]);
-        $this->assertDatabaseHas('stock_reservations', [
+        $this->assertDatabaseHas('stock_reservation_lines', [
            'inventory_id' => $item->inventory_id,
            'quantity' => 2,
+        ]);
+        $this->assertDatabaseHas('stock_reservations', [
            'status' => 'active',
        ]);
    }
@@ -96,38 +175,44 @@ class CartControllerTest extends TestCase
        ])->assertOk();

        $this->assertDatabaseHas('stock_reservations', [
-            'inventory_id' => $item->inventory_id,
-            'quantity' => 2,
            'status' => 'active',
            'expires_at' => $now->copy()->addMinutes(45)->toDateTimeString(),
        ]);
+        $this->assertDatabaseHas('stock_reservation_lines', [
+            'inventory_id' => $item->inventory_id,
+            'quantity' => 2,
+        ]);

        $this->travelBack();
    }

-    public function test_it_expires_abandoned_cart_reservations_and_removes_empty_carts(): void
+    public function test_it_expires_a_cart_reservation_and_automatically_replaces_the_cart(): void
    {
        config()->set('catalog.stock_reservation_expiration_minutes', 30);
        $tenant = $this->createTenant('acme');
+        $user = User::factory()->create();
        $item = $this->createDirectItem($tenant, 10, '49.90');

-        $response = $this->postJson('/api/tenants/acme/cart/items', [
-            'catalog_item_id' => $item->id,
-            'cantidad' => 2,
-        ])->assertOk();
+        $response = $this->actingAs($user, 'sanctum')
+            ->postJson('/api/tenants/acme/cart/items', [
+                'catalog_item_id' => $item->id,
+                'cantidad' => 2,
+            ])->assertOk();
        $cartId = $response->json('data.id');
        $cartItemId = $response->json('data.items.0.id');
+        $cart = Cart::query()->findOrFail($cartId);
+        $reservationId = $cart->current_stock_reservation_id;

        $this->artisan('reservations:expire')
            ->expectsOutput('Expired purchases: 0')
-            ->expectsOutput('Expired cart items: 0')
+            ->expectsOutput('Expired cart reservations: 0')
            ->assertSuccessful();

        $this->travel(31)->minutes();

        $this->artisan('reservations:expire')
            ->expectsOutput('Expired purchases: 0')
-            ->expectsOutput('Expired cart items: 1')
+            ->expectsOutput('Expired cart reservations: 1')
            ->assertSuccessful();

        $this->assertDatabaseHas('inventories', [
@@ -135,28 +220,141 @@ class CartControllerTest extends TestCase
            'real_stock' => 10,
            'reserved_stock' => 0,
        ]);
-        $this->assertDatabaseMissing('carrito_items', ['id' => $cartItemId]);
-        $this->assertSoftDeleted('carritos', [
+        $this->assertDatabaseHas('carrito_items', ['id' => $cartItemId]);
+        $this->assertDatabaseHas('carritos', [
            'id' => $cartId,
-            'status' => 'expired',
+            'status' => Cart::STATUS_EXPIRED,
+            'current_stock_reservation_id' => $reservationId,
+            'deleted_at' => null,
        ]);
        $this->assertDatabaseHas('stock_reservations', [
-            'inventory_id' => $item->inventory_id,
-            'cart_item_id' => null,
-            'purchase_id' => null,
-            'quantity' => 0,
+            'id' => $reservationId,
            'status' => 'expired',
            'expires_at' => null,
        ]);
+        $this->assertDatabaseHas('stock_reservation_lines', [
+            'inventory_id' => $item->inventory_id,
+            'quantity' => 2,
+        ]);
+
+        $currentCart = $this->getJson('/api/tenants/acme/cart')
+            ->assertOk()
+            ->assertJsonPath('data.status', Cart::STATUS_ACTIVE)
+            ->assertJsonPath('data.items', [])
+            ->assertJsonMissingPath('data.stock_reservation')
+            ->assertJsonMissingPath('data.current_stock_reservation_id');
+        $newCartId = $currentCart->json('data.id');
+
+        $this->assertNotSame($cartId, $newCartId);
+        $this->assertDatabaseHas('carritos', [
+            'id' => $cartId,
+            'status' => Cart::STATUS_ABANDONED,
+            'current_stock_reservation_id' => $reservationId,
+        ]);
+        $this->assertDatabaseHas('carritos', [
+            'id' => $newCartId,
+            'status' => Cart::STATUS_ACTIVE,
+            'current_stock_reservation_id' => null,
+        ]);
+
+        $this->postJson('/api/tenants/acme/cart/items', [
+            'catalog_item_id' => $item->id,
+            'cantidad' => 1,
+        ])
+            ->assertOk()
+            ->assertJsonPath('data.id', $newCartId)
+            ->assertJsonPath('data.items.0.cantidad', 1);

        $this->artisan('reservations:expire')
            ->expectsOutput('Expired purchases: 0')
-            ->expectsOutput('Expired cart items: 0')
+            ->expectsOutput('Expired cart reservations: 0')
            ->assertSuccessful();

        $this->travelBack();
    }

+    public function test_it_replaces_an_overdue_cart_before_the_expiration_job_runs(): void
+    {
+        config()->set('catalog.stock_reservation_expiration_minutes', 30);
+        $tenant = $this->createTenant('acme');
+        $user = User::factory()->create();
+        $item = $this->createDirectItem($tenant, 10, '49.90');
+
+        $original = $this->actingAs($user, 'sanctum')
+            ->postJson('/api/tenants/acme/cart/items', [
+                'catalog_item_id' => $item->id,
+                'cantidad' => 2,
+            ])->assertOk();
+        $originalCartId = $original->json('data.id');
+
+        $this->travel(31)->minutes();
+
+        $replacement = $this->postJson('/api/tenants/acme/cart/items', [
+            'catalog_item_id' => $item->id,
+            'cantidad' => 1,
+        ])
+            ->assertOk()
+            ->assertJsonPath('data.status', Cart::STATUS_ACTIVE)
+            ->assertJsonPath('data.items.0.cantidad', 1);
+
+        $this->assertNotSame($originalCartId, $replacement->json('data.id'));
+        $this->assertDatabaseHas('carritos', [
+            'id' => $originalCartId,
+            'status' => Cart::STATUS_ABANDONED,
+        ]);
+        $this->assertDatabaseHas('inventories', [
+            'id' => $item->inventory_id,
+            'reserved_stock' => 1,
+        ]);
+
+        $this->travelBack();
+    }
+
+    public function test_expired_cart_mutations_return_the_expiration_error_instead_of_not_found(): void
+    {
+        config()->set('catalog.stock_reservation_expiration_minutes', 30);
+        $tenant = $this->createTenant('acme');
+        $user = User::factory()->create();
+        [$item, $firstVariant] = $this->createVariantItem($tenant, 10, '49.90');
+        $secondInventory = Inventory::query()->create(['real_stock' => 10]);
+        $secondVariant = $item->variants()->create(['inventory_id' => $secondInventory->id]);
+
+        $cartItemId = $this->actingAs($user, 'sanctum')
+            ->postJson('/api/tenants/acme/cart/items', [
+                'catalog_item_id' => $item->id,
+                'variant_id' => $firstVariant->id,
+                'cantidad' => 2,
+            ])
+            ->assertOk()
+            ->json('data.items.0.id');
+
+        $this->travel(31)->minutes();
+
+        $expectedError = [
+            'code' => 'stock_reservation.expired',
+            'message' => __('api.cart.reservation_expired'),
+        ];
+
+        $this->patchJson("/api/tenants/acme/cart/items/{$cartItemId}", [
+            'cantidad' => 3,
+        ])
+            ->assertUnprocessable()
+            ->assertExactJson($expectedError);
+
+        $this->patchJson("/api/tenants/acme/cart/items/{$cartItemId}", [
+            'cantidad' => 2,
+            'variant_id' => $secondVariant->id,
+        ])
+            ->assertUnprocessable()
+            ->assertExactJson($expectedError);
+
+        $this->deleteJson("/api/tenants/acme/cart/items/{$cartItemId}")
+            ->assertUnprocessable()
+            ->assertExactJson($expectedError);
+
+        $this->travelBack();
+    }
+
    public function test_it_filters_item_images_when_the_tenant_disables_them(): void
    {
        $tenant = $this->createTenant('acme');
@@ -212,10 +410,11 @@ class CartControllerTest extends TestCase
            'id' => $variant->inventory_id,
            'reserved_stock' => 5,
        ]);
-        $this->assertDatabaseHas('stock_reservations', [
-            'cart_item_id' => $response->json('data.items.0.id'),
+        $this->assertDatabaseHas('stock_reservation_lines', [
            'inventory_id' => $variant->inventory_id,
            'quantity' => 5,
+        ]);
+        $this->assertDatabaseHas('stock_reservations', [
            'status' => 'active',
        ]);
    }
@@ -229,6 +428,7 @@ class CartControllerTest extends TestCase
        $this->createPurchaseItem($tenant, $user, $item, 1);

        $this->actingAs($user, 'sanctum')
+            ->withHeader('Accept-Language', 'es')
            ->postJson('/api/tenants/acme/cart/items', [
                'catalog_item_id' => $item->id,
                'cantidad' => 2,
@@ -237,6 +437,7 @@ class CartControllerTest extends TestCase
            ->assertJsonPath('data.items.0.cantidad', 2);

        $this->actingAs($user, 'sanctum')
+            ->withHeader('Accept-Language', 'es')
            ->postJson('/api/tenants/acme/cart/items', [
                'catalog_item_id' => $item->id,
                'cantidad' => 2,
@@ -381,10 +582,12 @@ class CartControllerTest extends TestCase
            'reserved_stock' => 0,
        ]);
        $this->assertDatabaseHas('stock_reservations', [
-            'cart_item_id' => null,
-            'inventory_id' => $variant->inventory_id,
-            'quantity' => 0,
            'status' => 'released',
+            'release_reason' => 'cart_empty',
+        ]);
+        $this->assertDatabaseHas('stock_reservation_lines', [
+            'inventory_id' => $variant->inventory_id,
+            'quantity' => 5,
        ]);
    }

--- a/tests/Feature/Catalog/BundleCatalogItemTest.php
+++ b/tests/Feature/Catalog/BundleCatalogItemTest.php
@@ -199,7 +199,7 @@ class BundleCatalogItemTest extends TestCase
            'email' => 'bundle@example.com',
        ]);
        $purchase->update(['payment_method' => 'transfer']);
-        $checkoutService->confirmPurchase($checkoutService->completePurchase($purchase));
+        $checkoutService->confirmPurchase($purchase);

        $this->assertDatabaseCount('compra_items', 1);
        $this->assertDatabaseHas('compra_items', [
--- a/tests/Feature/Catalog/OnTicketFeaturedGroupControllerTest.php
+++ b/tests/Feature/Catalog/OnTicketFeaturedGroupControllerTest.php
@@ -1,266 +0,0 @@
-<?php
-
-namespace Tests\Feature\Catalog;
-
-use App\Domains\Auth\Models\User;
-use App\Domains\Authorization\Enums\RoleCode;
-use App\Domains\Catalog\Enums\FeaturedGroupSource;
-use App\Domains\Catalog\Enums\GroupLayout;
-use App\Domains\Catalog\Enums\ProductLayout;
-use App\Domains\Catalog\Models\Category;
-use App\Domains\Catalog\Models\FeaturedGroup;
-use App\Domains\Tenant\Models\Tenant;
-use App\Domains\Tenant\Models\WebsiteType;
-use Database\Seeders\AuthorizationSeeder;
-use Illuminate\Foundation\Testing\RefreshDatabase;
-use Laravel\Sanctum\Sanctum;
-use Tests\TestCase;
-
-class OnTicketFeaturedGroupControllerTest extends TestCase
-{
-    use RefreshDatabase;
-
-    protected function setUp(): void
-    {
-        parent::setUp();
-
-        $this->seed(AuthorizationSeeder::class);
-        WebsiteType::query()->create([
-            'codigo' => 'onticket',
-            'nombre' => 'OnTicket',
-        ]);
-        WebsiteType::query()->create([
-            'codigo' => 'shopit',
-            'nombre' => 'Shopit',
-        ]);
-    }
-
-    public function test_authentication_is_required(): void
-    {
-        $this->getJson('/api/v1/adminapp/tenant/featured-groups')->assertUnauthorized();
-        $this->postJson('/api/v1/adminapp/tenant/featured-groups', $this->payload())
-            ->assertUnauthorized();
-        $this->putJson('/api/v1/adminapp/tenant/featured-groups/1', $this->payload())
-            ->assertUnauthorized();
-    }
-
-    public function test_index_returns_only_category_groups_for_the_onticket_tenant(): void
-    {
-        $tenant = $this->createTenant('acme');
-        $otherTenant = $this->createTenant('other');
-        $first = $this->createCategoryGroup($tenant, 'Food', order: 2);
-        $second = $this->createCategoryGroup($tenant, 'Tickets', order: 1);
-        $this->createCategoryGroup($otherTenant, 'Other tenant');
-        FeaturedGroup::query()->create([
-            'tenant_code' => $tenant->codigo,
-            'source_type' => FeaturedGroupSource::All,
-            'product_layout' => ProductLayout::Row,
-            'group_layout' => GroupLayout::Paginated,
-            'group_name' => 'All products',
-            'group_order' => 0,
-        ]);
-        Sanctum::actingAs($this->createAdminAppUser($tenant));
-
-        $this->getJson('/api/v1/adminapp/tenant/featured-groups')
-            ->assertOk()
-            ->assertJsonCount(2, 'data')
-            ->assertJsonPath('data.0.id', $second->id)
-            ->assertJsonPath('data.0.category_name', 'Tickets')
-            ->assertJsonPath('data.1.id', $first->id)
-            ->assertJsonMissing(['category_name' => 'Other tenant'])
-            ->assertJsonMissing(['group_name' => 'All products']);
-    }
-
-    public function test_store_creates_a_category_and_a_featured_horizontal_group(): void
-    {
-        $tenant = $this->createTenant('acme');
-        Sanctum::actingAs($this->createAdminAppUser($tenant));
-
-        $response = $this->postJson('/api/v1/adminapp/tenant/featured-groups', [
-            'category_name' => 'Food',
-            'is_featured' => true,
-        ])
-            ->assertCreated()
-            ->assertJsonPath('data.code', 'food')
-            ->assertJsonPath('data.category_name', 'Food')
-            ->assertJsonPath('data.group_name', 'Food')
-            ->assertJsonPath('data.is_featured', true)
-            ->assertJsonPath('data.type', 'category')
-            ->assertJsonPath('data.product_layout', 'row')
-            ->assertJsonPath('data.group_layout', 'paginated');
-
-        $categoryId = $response->json('data.category_id');
-        $this->assertDatabaseHas('categorias', [
-            'id' => $categoryId,
-            'tenant_code' => $tenant->codigo,
-            'nombre' => 'Food',
-        ]);
-        $this->assertDatabaseHas('featured_groups', [
-            'tenant_code' => $tenant->codigo,
-            'code' => 'food',
-            'source_type' => 'category',
-            'category_id' => $categoryId,
-            'product_layout' => 'row',
-            'group_layout' => 'paginated',
-            'group_name' => 'Food',
-        ]);
-    }
-
-    public function test_store_uses_column_with_cart_when_the_category_is_not_featured(): void
-    {
-        $tenant = $this->createTenant('acme');
-        Sanctum::actingAs($this->createAdminAppUser($tenant));
-
-        $this->postJson('/api/v1/adminapp/tenant/featured-groups', [
-            'category_name' => 'Parking',
-            'is_featured' => false,
-        ])
-            ->assertCreated()
-            ->assertJsonPath('data.is_featured', false)
-            ->assertJsonPath('data.product_layout', 'column_with_cart')
-            ->assertJsonPath('data.group_layout', 'paginated');
-    }
-
-    public function test_update_changes_the_category_and_group_together(): void
-    {
-        $tenant = $this->createTenant('acme');
-        $group = $this->createCategoryGroup($tenant, 'Old name', ProductLayout::ColumnWithCart);
-        Sanctum::actingAs($this->createAdminAppUser($tenant));
-
-        $this->putJson("/api/v1/adminapp/tenant/featured-groups/{$group->id}", [
-            'category_name' => 'New name',
-            'is_featured' => true,
-        ])
-            ->assertOk()
-            ->assertJsonPath('data.code', 'old-name')
-            ->assertJsonPath('data.category_name', 'New name')
-            ->assertJsonPath('data.group_name', 'New name')
-            ->assertJsonPath('data.is_featured', true)
-            ->assertJsonPath('data.product_layout', 'row')
-            ->assertJsonPath('data.group_layout', 'paginated');
-
-        $this->assertDatabaseHas('categorias', [
-            'id' => $group->category_id,
-            'nombre' => 'New name',
-        ]);
-        $this->assertDatabaseHas('featured_groups', [
-            'id' => $group->id,
-            'code' => 'old-name',
-            'group_name' => 'New name',
-            'product_layout' => 'row',
-            'group_layout' => 'paginated',
-        ]);
-    }
-
-    public function test_update_rejects_groups_from_another_tenant_or_source(): void
-    {
-        $tenant = $this->createTenant('acme');
-        $otherTenant = $this->createTenant('other');
-        $otherGroup = $this->createCategoryGroup($otherTenant, 'Other');
-        $allGroup = FeaturedGroup::query()->create([
-            'tenant_code' => $tenant->codigo,
-            'source_type' => FeaturedGroupSource::All,
-            'product_layout' => ProductLayout::Row,
-            'group_layout' => GroupLayout::Paginated,
-            'group_name' => 'All products',
-            'group_order' => 0,
-        ]);
-        Sanctum::actingAs($this->createAdminAppUser($tenant));
-
-        $this->putJson(
-            "/api/v1/adminapp/tenant/featured-groups/{$otherGroup->id}",
-            $this->payload(),
-        )->assertNotFound();
-        $this->putJson(
-            "/api/v1/adminapp/tenant/featured-groups/{$allGroup->id}",
-            $this->payload(),
-        )->assertNotFound();
-    }
-
-    public function test_name_and_featured_flag_are_required(): void
-    {
-        $tenant = $this->createTenant('acme');
-        Sanctum::actingAs($this->createAdminAppUser($tenant));
-
-        $this->postJson('/api/v1/adminapp/tenant/featured-groups', [
-            'category_name' => '',
-            'is_featured' => 'yes',
-        ])
-            ->assertUnprocessable()
-            ->assertJsonValidationErrors(['category_name', 'is_featured']);
-
-        $this->assertDatabaseCount('categorias', 0);
-        $this->assertDatabaseCount('featured_groups', 0);
-    }
-
-    public function test_the_controller_is_not_available_for_non_onticket_tenants(): void
-    {
-        $tenant = $this->createTenant('store', 'shopit');
-        Sanctum::actingAs($this->createAdminAppUser($tenant));
-
-        $this->getJson('/api/v1/adminapp/tenant/featured-groups')->assertNotFound();
-        $this->postJson('/api/v1/adminapp/tenant/featured-groups', $this->payload())
-            ->assertNotFound();
-    }
-
-    public function test_a_customer_cannot_manage_onticket_featured_groups(): void
-    {
-        Sanctum::actingAs(User::factory()->create([
-            'rol_codigo' => RoleCode::User->value,
-            'tenant_codigo' => null,
-        ]));
-
-        $this->getJson('/api/v1/adminapp/tenant/featured-groups')->assertForbidden();
-        $this->postJson('/api/v1/adminapp/tenant/featured-groups', $this->payload())
-            ->assertForbidden();
-    }
-
-    /** @return array{category_name: string, is_featured: bool} */
-    private function payload(): array
-    {
-        return [
-            'category_name' => 'Food',
-            'is_featured' => true,
-        ];
-    }
-
-    private function createTenant(string $code, string $websiteType = 'onticket'): Tenant
-    {
-        return Tenant::query()->create([
-            'codigo' => $code,
-            'nombre' => ucfirst($code),
-            'dominio' => "{$code}.test",
-            'website_type_code' => $websiteType,
-        ]);
-    }
-
-    private function createAdminAppUser(Tenant $tenant): User
-    {
-        return User::factory()->create([
-            'rol_codigo' => RoleCode::AdminApp->value,
-            'tenant_codigo' => $tenant->codigo,
-        ]);
-    }
-
-    private function createCategoryGroup(
-        Tenant $tenant,
-        string $name,
-        ProductLayout $productLayout = ProductLayout::Row,
-        int $order = 0,
-    ): FeaturedGroup {
-        $category = Category::query()->create([
-            'tenant_code' => $tenant->codigo,
-            'nombre' => $name,
-        ]);
-
-        return FeaturedGroup::query()->create([
-            'tenant_code' => $tenant->codigo,
-            'source_type' => FeaturedGroupSource::Category,
-            'category_id' => $category->id,
-            'product_layout' => $productLayout,
-            'group_layout' => GroupLayout::Paginated,
-            'group_name' => $name,
-            'group_order' => $order,
-        ]);
-    }
-}
--- a/Show More
+++ b/Show More