docs(stock): document centralized reservation flow

.env.example

@@ -8,7 +8,6 @@ PURCHASE_CHECKOUT_EXPIRATION_MINUTES=30
 PURCHASE_QR_EXPIRATION_MINUTES=15
 PURCHASE_TELEPAGOS_EXPIRATION_MINUTES=30
 PURCHASE_TRANSFER_EXPIRATION_MINUTES=1440
-PURCHASE_TRANSFER_CANDIDATE_AMOUNT_TOLERANCE_PERCENTAGE=5
 STOCK_RESERVATION_EXPIRATION_MINUTES=30
 FRONTEND_URLS=http://localhost:4200
 
@@ -32,7 +31,6 @@ 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
@@ -43,8 +41,6 @@ TELEPAGOS_LOG_LEVEL=info
 TELEPAGOS_LOG_DAYS=30
 COMMANDS_LOG_LEVEL=info
 COMMANDS_LOG_DAYS=30
-EMAILS_LOG_LEVEL=info
-EMAILS_LOG_DAYS=30
 
 DB_CONNECTION=mysql
 DB_HOST=127.0.0.1

app/Domains/Auth/Controllers/ValidateResetPasswordAttemptController.php

@@ -22,18 +22,10 @@ class ValidateResetPasswordAttemptController extends Controller
     {
         $data = $request->validated();
 
-        $result = $this->resetPasswordAttemptService->validateCode(
+        if (! $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'),
             ]);

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

app/Domains/Auth/Services/ResetPasswordAttemptService.php

@@ -12,12 +12,6 @@ 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,
@@ -152,12 +146,12 @@ class ResetPasswordAttemptService
         );
     }
 
-    public function validateCode(string $email, string $code): string
+    public function validateCode(string $email, string $code): bool
     {
         $emailFingerprint = $this->emailFingerprint($email);
 
         try {
-            return DB::transaction(function () use ($email, $code, $emailFingerprint): string {
+            return DB::transaction(function () use ($email, $code, $emailFingerprint): bool {
                 $user = User::query()
                     ->where('email', $email)
                     ->lockForUpdate()
@@ -175,27 +169,14 @@ class ResetPasswordAttemptService
                         'email_fingerprint' => $emailFingerprint,
                     ]);
 
-                    return self::CODE_INVALID;
+                    return false;
-                }
-
-                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 self::CODE_VALID;
+                return true;
             });
         } catch (Throwable $exception) {
             Log::error('Failed to validate password reset code.', [
@@ -233,19 +214,6 @@ 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;
@@ -302,7 +270,6 @@ class ResetPasswordAttemptService
             'codigo' => $this->generateCode(),
             'reason' => $reason,
             'status' => ResetPasswordAttempt::STATUS_PENDING,
-            'expires_at' => now()->addMinutes((int) config('auth.passwords.users.expire')),
         ]);
 
         return $attempt->getKey();

app/Domains/Bootstrap/Resources/AdminAppBootstrapResource.php

@@ -30,7 +30,6 @@ class AdminAppBootstrapResource extends JsonResource
             'login_header_footer_color' => $websiteType->login_header_footer_color,
             'site_logo' => $websiteType->siteLogo?->getTemporaryUrl(1440),
             'footer_logo' => $websiteType->footerLogo?->getTemporaryUrl(1440),
-            'favicon' => $websiteType->favicon?->getTemporaryUrl(1440),
         ];
     }
 }

app/Domains/Bootstrap/Services/AdminAppBootstrapService.php

@@ -11,7 +11,7 @@ class AdminAppBootstrapService
     {
         return [
             'website_type' => WebsiteType::query()
-                ->with(['siteLogo', 'footerLogo', 'favicon'])
+                ->with(['siteLogo', 'footerLogo'])
                 ->where('dominio', $domain)
                 ->firstOrFail(),
         ];

app/Domains/Bootstrap/Services/ScannerBootstrapService.php

@@ -11,7 +11,7 @@ class ScannerBootstrapService
     {
         return [
             'website_type' => WebsiteType::query()
-                ->with(['siteLogo', 'footerLogo', 'favicon'])
+                ->with(['siteLogo', 'footerLogo'])
                 ->where('scanner_domain', $domain)
                 ->firstOrFail(),
         ];

app/Domains/Cart/Models/Cart.php

@@ -38,16 +38,6 @@ 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';
@@ -129,7 +119,6 @@ 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)
@@ -194,7 +183,6 @@ class Cart extends Model
             $excludedPurchaseId,
         ): CartItem {
             $this->invalidateCurrentCheckout();
-            app(StockReservationService::class)->assertCartReservationUsable($this);
 
             /** @var CartItem $item */
             $item = $this->items()
@@ -296,7 +284,6 @@ class Cart extends Model
     {
         DB::transaction(function () use ($cartItemId): void {
             $this->invalidateCurrentCheckout();
-            app(StockReservationService::class)->assertCartReservationUsable($this);
 
             /** @var CartItem $item */
             $item = $this->items()
@@ -347,14 +334,10 @@ 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)->releaseForPurchase(

app/Domains/Cart/Services/CartService.php

@@ -4,12 +4,9 @@ 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;
@@ -25,7 +22,7 @@ class CartService
             return $this->makeEmptyCart($tenant);
         }
 
-        $cart = $this->resolveCart($tenant, $resolvedIdentity['identity']);
+        $cart = $this->findCart($tenant, $resolvedIdentity['identity']);
 
         if ($cart === null) {
             return $this->makeEmptyCart($tenant);
@@ -122,7 +119,7 @@ class CartService
     {
         $cart = new Cart([
             'tenant_codigo' => $tenant->codigo,
-            'status' => Cart::STATUS_ACTIVE,
+            'status' => 'active',
         ]);
 
         $cart->setRelation('items', collect());
@@ -223,14 +220,12 @@ class CartService
     {
         return Cart::query()
             ->where('tenant_codigo', $tenant->codigo)
-            ->where('origin', Cart::ORIGIN_USER)
+            ->where('status', 'active')
-            ->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();
     }
 
@@ -239,7 +234,7 @@ class CartService
      */
     protected function findCartOrFail(Tenant $tenant, array $identity): Cart
     {
-        $cart = $this->resolveCart($tenant, $identity, replaceExpired: false);
+        $cart = $this->findCart($tenant, $identity);
 
         if ($cart === null) {
             throw new NotFoundHttpException('Cart not found.');
@@ -252,73 +247,10 @@ 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' => Cart::STATUS_ACTIVE,
+            'status' => 'active',
-            'origin' => Cart::ORIGIN_USER,
         ];
 
         if ($identity['user_id'] !== null) {

app/Domains/Cart/Services/ExpireCartReservationsService.php

@@ -0,0 +1,86 @@
+<?php
+
+namespace App\Domains\Cart\Services;
+
+use App\Domains\Cart\Models\Cart;
+use App\Domains\Catalog\Models\StockReservation;
+use App\Domains\Catalog\Services\StockReservationService;
+use App\Domains\Purchase\Models\Purchase;
+use Illuminate\Support\Facades\DB;
+
+class ExpireCartReservationsService
+{
+    public function __construct(
+        private readonly StockReservationService $reservations,
+    ) {}
+
+    public function expireOverdue(): int
+    {
+        $expired = 0;
+        $lastReservationId = 0;
+
+        do {
+            $reservationIds = StockReservation::query()
+                ->where('status', StockReservation::STATUS_ACTIVE)
+                ->whereNotNull('expires_at')
+                ->where('expires_at', '<=', now())
+                ->where('id', '>', $lastReservationId)
+                ->whereHas('currentCart', fn ($query) => $query->where('status', 'active'))
+                ->whereDoesntHave('purchase', fn ($query) => $query->whereIn('status', [
+                    Purchase::STATUS_CREATED,
+                    Purchase::STATUS_PENDING_PAYMENT,
+                    Purchase::STATUS_IN_REVIEW,
+                ]))
+                ->orderBy('id')
+                ->limit(500)
+                ->pluck('id');
+
+            foreach ($reservationIds as $reservationId) {
+                $lastReservationId = (int) $reservationId;
+
+                if ($this->expireReservation($lastReservationId)) {
+                    $expired++;
+                }
+            }
+        } while ($reservationIds->count() === 500);
+
+        return $expired;
+    }
+
+    private function expireReservation(int $reservationId): bool
+    {
+        $cartId = Cart::query()
+            ->where('current_stock_reservation_id', $reservationId)
+            ->where('status', 'active')
+            ->value('id');
+        if ($cartId === null) {
+            return false;
+        }
+
+        return DB::transaction(function () use ($cartId, $reservationId): bool {
+            /** @var Cart|null $cart */
+            $cart = Cart::query()
+                ->whereKey($cartId)
+                ->where('current_stock_reservation_id', $reservationId)
+                ->where('status', 'active')
+                ->lockForUpdate()
+                ->first();
+            if ($cart === null) {
+                return false;
+            }
+
+            /** @var StockReservation|null $reservation */
+            $reservation = StockReservation::query()->lockForUpdate()->find($reservationId);
+            if ($reservation === null
+                || $reservation->status !== StockReservation::STATUS_ACTIVE
+                || $reservation->expires_at === null
+                || $reservation->expires_at->isFuture()) {
+                return false;
+            }
+
+            $this->reservations->expire($reservation);
+
+            return true;
+        });
+    }
+}

app/Domains/Cart/documentacion/README.md

@@ -12,6 +12,7 @@ Gestiona el carrito activo de un tenant tanto para visitantes como para usuarios
 ## Servicios
 
 - `CartService`: obtiene el carrito, modifica ítems y administra la cookie del token invitado.
+- `ExpireCartReservationsService`: libera como conjunto las reservas vencidas de carritos activos sin eliminar el contenido del carrito.
 - `GuestCartMergeService`: incorpora el carrito invitado al usuario cuando este se autentica.
 
 ## Endpoints
@@ -33,6 +34,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.
 
-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.
+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`, su reserva se libera con el motivo correspondiente y se crea otra para el carrito actualizado.
 
-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.
+El comando unificado `php artisan reservations:expire` procesa primero las compras vencidas y luego las reservas activas de carrito cuyo `expires_at` haya vencido. Se ejecuta cada minuto mediante el scheduler, conserva la reserva y sus líneas como historial, libera el stock como conjunto y deja intactos el carrito y sus ítems.

app/Domains/Catalog/Exceptions/StockReservationExpiredException.php

@@ -1,13 +0,0 @@
-<?php
-
-namespace App\Domains\Catalog\Exceptions;
-
-use RuntimeException;
-
-class StockReservationExpiredException extends RuntimeException
-{
-    public function __construct()
-    {
-        parent::__construct(__('api.cart.reservation_expired'));
-    }
-}

app/Domains/Catalog/Services/ExpireStockReservationsService.php

@@ -2,184 +2,50 @@
 
 namespace App\Domains\Catalog\Services;
 
-use App\Domains\Cart\Models\Cart;
+use App\Domains\Cart\Services\ExpireCartReservationsService;
-use App\Domains\Catalog\Models\StockReservation;
+use App\Domains\Purchase\Services\CheckoutService;
-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 ReleaseCheckoutService $purchases,
+        private readonly CheckoutService $checkout,
-        private readonly StockReservationService $reservations,
+        private readonly ExpireCartReservationsService $carts,
     ) {}
 
     /**
-     * @return array{purchases: int, cart_reservations: int, orphan_reservations: int, failed: int}
+     * @return array{purchases: int, cart_reservations: int}
      */
     public function expireOverdue(): array
     {
-        $summary = [
+        $expiredPurchases = null;
-            'purchases' => 0,
+        $expiredCartItems = null;
-            'cart_reservations' => 0,
-            'orphan_reservations' => 0,
-            'failed' => 0,
-        ];
-        $lastReservationId = 0;
 
-        do {
+        try {
-            $reservationIds = StockReservation::query()
+            $expiredPurchases = $this->checkout->expireOverduePurchases();
-                ->where('status', StockReservation::STATUS_ACTIVE)
+            $expiredCartItems = $this->carts->expireOverdue();
-                ->whereNotNull('expires_at')
-                ->where('expires_at', '<=', now())
-                ->where('id', '>', $lastReservationId)
-                ->orderBy('id')
-                ->limit(self::BATCH_SIZE)
-                ->pluck('id');
 
-            foreach ($reservationIds as $reservationId) {
+            Log::channel('commands')->info('Stock reservation cleanup completed.', [
-                $lastReservationId = (int) $reservationId;
+                'command' => 'reservations:expire',
+                'expired_purchases' => $expiredPurchases,
+                'expired_cart_reservations' => $expiredCartItems,
+                'total_expired' => $expiredPurchases + $expiredCartItems,
+            ]);
 
-                try {
+            return [
-                    $owner = $this->expireReservation($lastReservationId);
+                'purchases' => $expiredPurchases,
-                    if ($owner !== null) {
+                'cart_reservations' => $expiredCartItems,
-                        $summary[$owner]++;
+            ];
-                    }
+        } catch (Throwable $exception) {
-                } catch (Throwable $exception) {
+            Log::channel('commands')->error('Stock reservation cleanup failed.', [
-                    $summary['failed']++;
+                'command' => 'reservations:expire',
-                    Log::channel('commands')->error('Failed to expire overdue stock reservation.', [
+                'expired_purchases' => $expiredPurchases,
-                        'command' => 'reservations:expire',
+                'expired_cart_reservations' => $expiredCartItems,
-                        'stock_reservation_id' => $lastReservationId,
+                'exception' => $exception,
-                        'exception' => $exception,
+            ]);
-                    ]);
-                }
-            }
-        } while ($reservationIds->count() === self::BATCH_SIZE);
 
-        Log::channel('commands')->info('Stock reservation cleanup completed.', [
+            throw $exception;
-            '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();
     }
 }

app/Domains/Catalog/Services/StockReservationService.php

@@ -4,7 +4,6 @@ namespace App\Domains\Catalog\Services;
 
 use App\Domains\Cart\Models\Cart;
 use App\Domains\Cart\Models\CartItem;
-use App\Domains\Catalog\Exceptions\StockReservationExpiredException;
 use App\Domains\Catalog\Models\Inventory;
 use App\Domains\Catalog\Models\StockReservation;
 use App\Domains\Catalog\Models\StockReservationLine;
@@ -44,8 +43,13 @@ class StockReservationService
                 ? null
                 : StockReservation::query()->lockForUpdate()->find($lockedCart->current_stock_reservation_id);
 
-            if ($reservation !== null) {
+            if ($reservation !== null
-                $this->assertUsableCartReservation($reservation);
+                && $reservation->status === StockReservation::STATUS_ACTIVE
+                && $reservation->expires_at !== null
+                && $reservation->expires_at->isPast()) {
+                $this->finalizeLocked($reservation, StockReservation::STATUS_EXPIRED, null);
+                $lockedCart->update(['current_stock_reservation_id' => null]);
+                $reservation = null;
             }
 
             if ($requirements === []) {
@@ -63,7 +67,7 @@ class StockReservationService
                 return null;
             }
 
-            if ($reservation === null) {
+            if ($reservation === null || $reservation->status !== StockReservation::STATUS_ACTIVE) {
                 $reservation = StockReservation::query()->create([
                     'status' => StockReservation::STATUS_ACTIVE,
                     'expires_at' => $this->expiration(),
@@ -154,12 +158,9 @@ class StockReservationService
         });
     }
 
-    public function attachToPurchase(
+    public function attachToPurchase(Cart $cart, Purchase $purchase): StockReservation
-        Cart $cart,
+    {
-        Purchase $purchase,
+        return DB::transaction(function () use ($cart, $purchase): StockReservation {
-        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 */
@@ -171,7 +172,9 @@ class StockReservationService
 
             /** @var StockReservation $reservation */
             $reservation = StockReservation::query()->lockForUpdate()->findOrFail($lockedCart->current_stock_reservation_id);
-            $this->assertUsableCartReservation($reservation);
+            if ($reservation->status !== StockReservation::STATUS_ACTIVE) {
+                throw new \InvalidArgumentException('La reserva de stock no está activa.');
+            }
 
             $linkedPurchase = Purchase::query()
                 ->where('stock_reservation_id', $reservation->getKey())
@@ -182,7 +185,7 @@ class StockReservationService
             }
 
             $lockedPurchase->update(['stock_reservation_id' => $reservation->getKey()]);
-            $reservation->update(['expires_at' => $expiresAt]);
+            $reservation->update(['expires_at' => $lockedPurchase->expires_at]);
             $purchase->stock_reservation_id = $reservation->getKey();
             $cart->current_stock_reservation_id = $reservation->getKey();
 
@@ -207,9 +210,6 @@ class StockReservationService
             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()) {
@@ -264,50 +264,6 @@ class StockReservationService
         });
     }
 
-    public function returnToCart(Purchase $purchase, Cart $cart): StockReservation
-    {
-        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 ($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.');
-            }
-
-            /** @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');
-        });
-    }
-
-    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,
@@ -343,28 +299,16 @@ class StockReservationService
         });
     }
 
-    public function clearExpirationForReview(Purchase $purchase): void
+    public function syncPurchaseExpiration(Purchase $purchase): void
     {
-        DB::transaction(function () use ($purchase): void {
+        if ($purchase->stock_reservation_id === null) {
-            /** @var Purchase $purchase */
+            return;
-            $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 */
+        StockReservation::query()
-            $reservation = StockReservation::query()
+            ->whereKey($purchase->stock_reservation_id)
-                ->lockForUpdate()
+            ->where('status', StockReservation::STATUS_ACTIVE)
-                ->findOrFail($purchase->stock_reservation_id);
+            ->update(['expires_at' => $purchase->expires_at]);
-            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]);
-        });
     }
 
     /**
@@ -464,24 +408,9 @@ class StockReservationService
             'release_reason' => $status === StockReservation::STATUS_RELEASED ? $reason : null,
         ]);
 
-        if ($status === StockReservation::STATUS_RELEASED) {
+        Cart::query()
-            Cart::query()
+            ->where('current_stock_reservation_id', $reservation->getKey())
-                ->where('current_stock_reservation_id', $reservation->getKey())
+            ->update(['current_stock_reservation_id' => null]);
-                ->update(['current_stock_reservation_id' => null]);
-        }
-    }
-
-    private function assertUsableCartReservation(StockReservation $reservation): void
-    {
-        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

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` 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.
+- `StockReservation` representa la reserva completa de un carrito o checkout, con estados `active`, `committed`, `released` y `expired`. 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.
@@ -19,7 +19,6 @@ 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`: 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.
 

app/Domains/Desfile/Services/InvitationPurchaseProvisioner.php

@@ -5,7 +5,6 @@ namespace App\Domains\Desfile\Services;
 use DateTimeInterface;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Hash;
-use Illuminate\Support\Facades\Schema;
 use Illuminate\Support\Str;
 use RuntimeException;
 
@@ -23,7 +22,7 @@ class InvitationPurchaseProvisioner
     private const ALLOCATIONS = [
         ['sector' => 'A', 'row' => 1, 'first_seat' => 1, 'last_seat' => 16, 'type' => 'NORMAL'],
         ['sector' => 'A', 'row' => 3, 'first_seat' => 1, 'last_seat' => 14, 'type' => 'NORMAL'],
-        ['sector' => 'C', 'row' => 1, 'first_seat' => 1, 'last_seat' => 17, 'type' => 'VIP + LUNCH'],
+        ['sector' => 'C', 'row' => 1, 'first_seat' => 1, 'last_seat' => 16, 'type' => 'VIP + LUNCH'],
         ['sector' => 'C', 'row' => 3, 'first_seat' => 6, 'last_seat' => 7, 'type' => 'NORMAL'],
     ];
 
@@ -59,7 +58,7 @@ class InvitationPurchaseProvisioner
                         $allocation['type'],
                     );
 
-                    $purchaseItemId = $this->createPurchaseItem(
+                    $this->createPurchaseItem(
                         $purchaseId,
                         $catalogItem,
                         $variant,
@@ -71,7 +70,6 @@ class InvitationPurchaseProvisioner
                     );
                     $this->createTicketAndCommitStock(
                         $purchaseId,
-                        $purchaseItemId,
                         $userId,
                         (int) $catalogItem->id,
                         $variant,
@@ -146,6 +144,7 @@ class InvitationPurchaseProvisioner
         if ($purchaseId !== null) {
             DB::table('compras')->where('id', $purchaseId)->update([
                 'status' => 'paid',
+                'expires_at' => null,
                 'total' => 0,
                 'updated_at' => $now,
             ]);
@@ -159,6 +158,7 @@ class InvitationPurchaseProvisioner
             'cart_id' => null,
             'status' => 'paid',
             'payment_method' => self::PAYMENT_METHOD,
+            'expires_at' => null,
             'total' => 0,
             'dni' => null,
             'transfer_payer_dni' => null,
@@ -328,13 +328,12 @@ class InvitationPurchaseProvisioner
         int $seat,
         string $type,
         DateTimeInterface $now,
-    ): int {
+    ): void {
-        $existingId = DB::table('compra_items')
+        if (DB::table('compra_items')
             ->where('compra_id', $purchaseId)
             ->where('source_variant_id', $variant->id)
-            ->value('id');
+            ->exists()) {
-        if ($existingId !== null) {
+            return;
-            return (int) $existingId;
         }
 
         $attributes = [
@@ -344,7 +343,7 @@ class InvitationPurchaseProvisioner
             ['name' => 'Asiento', 'value' => (string) $seat],
         ];
 
-        return DB::table('compra_items')->insertGetId([
+        DB::table('compra_items')->insert([
             'compra_id' => $purchaseId,
             'source_catalog_item_id' => $catalogItem->id,
             'source_variant_id' => $variant->id,
@@ -370,18 +369,13 @@ class InvitationPurchaseProvisioner
 
     private function createTicketAndCommitStock(
         int $purchaseId,
-        int $purchaseItemId,
         int $userId,
         int $catalogItemId,
         object $variant,
         DateTimeInterface $now,
     ): void {
-        $purchaseReference = Schema::hasColumn('tickets', 'source_purchase_item_id')
-            ? ['source_purchase_item_id' => $purchaseItemId]
-            : ['source_purchase_id' => $purchaseId];
-
         if (DB::table('tickets')
-            ->where($purchaseReference)
+            ->where('source_purchase_id', $purchaseId)
             ->where('source_variant_id', $variant->id)
             ->exists()) {
             return;
@@ -402,6 +396,7 @@ class InvitationPurchaseProvisioner
         if ($reservationId === null) {
             $reservationId = DB::table('stock_reservations')->insertGetId([
                 'status' => 'committed',
+                'expires_at' => null,
                 'committed_at' => $now,
                 'released_at' => null,
                 'expired_at' => null,
@@ -428,7 +423,7 @@ class InvitationPurchaseProvisioner
             'ticket' => (string) Str::uuid(),
             'name' => null,
             'description' => null,
-            ...$purchaseReference,
+            'source_purchase_id' => $purchaseId,
             'source_catalog_item_id' => $catalogItemId,
             'source_variant_id' => $variant->id,
             'used_at' => null,

app/Domains/Forms/Controllers/AdminApp/TicketFilterFormController.php

@@ -1,20 +0,0 @@
-<?php
-
-namespace App\Domains\Forms\Controllers\AdminApp;
-
-use App\Domains\Forms\Resources\TicketFilterFormResource;
-use App\Domains\Forms\Services\TicketFilterFormService;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\Request;
-
-class TicketFilterFormController extends Controller
-{
-    public function __construct(private readonly TicketFilterFormService $formService) {}
-
-    public function __invoke(Request $request): TicketFilterFormResource
-    {
-        $tenant = $request->user('sanctum')->tenant()->firstOrFail();
-
-        return TicketFilterFormResource::make($this->formService->get($tenant));
-    }
-}

app/Domains/Forms/Controllers/AdminApp/TicketFormController.php

@@ -1,22 +0,0 @@
-<?php
-
-namespace App\Domains\Forms\Controllers\AdminApp;
-
-use App\Domains\Forms\Resources\TicketFormResource;
-use App\Domains\Forms\Services\TicketFormService;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\Request;
-
-class TicketFormController extends Controller
-{
-    public function __construct(protected TicketFormService $ticketFormService) {}
-
-    public function __invoke(Request $request): TicketFormResource
-    {
-        return TicketFormResource::make(
-            $this->ticketFormService->get(
-                $request->user('sanctum')->tenant()->firstOrFail()
-            )
-        );
-    }
-}

app/Domains/Forms/Resources/TicketFilterFormResource.php

@@ -1,21 +0,0 @@
-<?php
-
-namespace App\Domains\Forms\Resources;
-
-use Illuminate\Http\Request;
-use Illuminate\Http\Resources\Json\JsonResource;
-
-class TicketFilterFormResource extends JsonResource
-{
-    /** @return array<string, mixed> */
-    public function toArray(Request $request): array
-    {
-        return [
-            'code' => $this->resource['code'],
-            'action' => $this->resource['action'],
-            'method' => $this->resource['method'],
-            'fields' => $this->resource['fields'],
-            'columns' => $this->resource['columns'],
-        ];
-    }
-}

app/Domains/Forms/Resources/TicketFormResource.php

@@ -1,18 +0,0 @@
-<?php
-
-namespace App\Domains\Forms\Resources;
-
-use Illuminate\Http\Request;
-use Illuminate\Http\Resources\Json\JsonResource;
-
-class TicketFormResource extends JsonResource
-{
-    /** @return array<string, mixed> */
-    public function toArray(Request $request): array
-    {
-        return [
-            'statuses' => $this->resource['statuses'],
-            'categories' => $this->resource['categories'],
-        ];
-    }
-}

app/Domains/Forms/Services/SaleFormService.php

@@ -6,18 +6,27 @@ use App\Domains\Purchase\Models\Purchase;
 
 class SaleFormService
 {
-    /** @return array{statuses: list<array{value: string, label: string, real_statuses: list<string>}>} */
+    /** @return array{statuses: list<array{code: string, name: string}>} */
     public function get(): array
     {
+        $names = [
+            Purchase::STATUS_CREATED => 'Creada',
+            Purchase::STATUS_PENDING_PAYMENT => 'Esperando pago',
+            Purchase::STATUS_IN_REVIEW => 'En revisión',
+            Purchase::STATUS_PAID => 'Confirmada',
+            Purchase::STATUS_CANCELLED => 'Cancelada',
+            Purchase::STATUS_REJECTED => 'Rechazada',
+            Purchase::STATUS_EXPIRED => 'Vencida',
+            Purchase::STATUS_SUPERSEDED => 'Reemplazada',
+        ];
+
         return [
             'statuses' => array_map(
-                fn (string $code, array $definition): array => [
+                fn (string $status): array => [
-                    'value' => $code,
+                    'code' => $status,
-                    'label' => $definition['name'],
+                    'name' => $names[$status],
-                    'real_statuses' => $definition['statuses'],
                 ],
-                array_keys(Purchase::adminStatuses()),
+                Purchase::statuses(),
-                array_values(Purchase::adminStatuses()),
             ),
         ];
     }

app/Domains/Forms/Services/TicketFilterFormService.php

@@ -1,152 +0,0 @@
-<?php
-
-namespace App\Domains\Forms\Services;
-
-use App\Domains\Tenant\Models\Tenant;
-use App\Domains\Ticket\Models\Ticket;
-use App\Domains\Ticket\Services\AdminAppTicketColumnService;
-
-class TicketFilterFormService
-{
-    private const FIESTA_FUTBOL_INFANTIL = 'fiesta_futbol_infantil';
-
-    public function __construct(
-        private readonly TicketFormService $ticketFormService,
-        private readonly AdminAppTicketColumnService $columnService,
-    ) {}
-
-    /** @return array<string, mixed> */
-    public function get(Tenant $tenant): array
-    {
-        $fields = $this->commonFields();
-
-        if ($tenant->codigo === self::FIESTA_FUTBOL_INFANTIL) {
-            $fields = [
-                ...$this->fiestaFutbolInfantilFields($tenant),
-                ...$this->commonFields(includeDate: false),
-            ];
-        }
-
-        return [
-            'code' => 'tickets_filter',
-            'action' => '/api/v1/adminapp/tenant/tickets',
-            'method' => 'GET',
-            'fields' => $fields,
-            'columns' => $this->columnService->publicColumns($tenant),
-        ];
-    }
-
-    /** @return list<array<string, mixed>> */
-    private function fiestaFutbolInfantilFields(Tenant $tenant): array
-    {
-        $form = $this->ticketFormService->getForFilters($tenant);
-
-        return [
-            [
-                'name' => 'category',
-                'query_param' => 'category',
-                'label' => 'Categoría',
-                'type' => 'select',
-                'required' => false,
-                'default' => null,
-                'placeholder' => 'Categoría',
-                'options' => array_map(
-                    fn (array $category): array => [
-                        'value' => $category['value'],
-                        'label' => $category['label'],
-                        'children' => [
-                            [
-                                'field' => 'product',
-                                'disabled' => $category['products'] === [],
-                                'options' => array_map(
-                                    fn (array $product): array => [
-                                        'value' => $product['value'],
-                                        'label' => $product['label'],
-                                        'children' => [
-                                            [
-                                                'field' => 'type',
-                                                'disabled' => $product['types'] === [],
-                                                'options' => array_map(
-                                                    fn (array $type): array => [
-                                                        'value' => $type['value'],
-                                                        'label' => $type['label'],
-                                                        'children' => [[
-                                                            'field' => 'size',
-                                                            'disabled' => ($type['sizes'] ?? []) === [],
-                                                            'options' => $type['sizes'] ?? [],
-                                                        ]],
-                                                    ],
-                                                    $product['types'],
-                                                ),
-                                            ],
-                                        ],
-                                    ],
-                                    $category['products'],
-                                ),
-                            ],
-                            [
-                                'field' => 'date',
-                                'disabled' => ! in_array($category['value'], ['comidas', 'comida'], true),
-                                'options' => [],
-                            ],
-                        ],
-                    ],
-                    $form['categories'],
-                ),
-            ],
-            $this->dependentSelect('product', 'Producto', 'category'),
-            $this->dependentSelect('type', 'Tipo', 'product'),
-            $this->dependentSelect('size', 'Talle', 'type'),
-            [
-                ...$this->dependentSelect('date', 'Fecha', 'category'),
-                'type' => 'date',
-            ],
-        ];
-    }
-
-    /** @return list<array<string, mixed>> */
-    private function commonFields(bool $includeDate = true): array
-    {
-        return [
-            ...($includeDate ? [[
-                'name' => 'date',
-                'query_param' => 'date',
-                'label' => 'Fecha',
-                'type' => 'date',
-                'required' => false,
-                'default' => null,
-            ]] : []),
-            [
-                'name' => 'status',
-                'query_param' => 'status',
-                'label' => 'Estado',
-                'type' => 'select',
-                'required' => false,
-                'default' => null,
-                'placeholder' => 'Estado',
-                'options' => [
-                    ['value' => Ticket::STATUS_ACTIVE, 'label' => 'Activo'],
-                    ['value' => Ticket::STATUS_USED, 'label' => 'Usado'],
-                    ['value' => Ticket::STATUS_EXPIRED, 'label' => 'Vencido'],
-                ],
-            ],
-        ];
-    }
-
-    /** @return array<string, mixed> */
-    private function dependentSelect(string $name, string $label, string $dependency): array
-    {
-        return [
-            'name' => $name,
-            'query_param' => $name,
-            'label' => $label,
-            'type' => 'select',
-            'required' => false,
-            'default' => null,
-            'placeholder' => $label,
-            'depends_on' => $dependency,
-            'disabled' => true,
-            'options' => [],
-        ];
-    }
-}

app/Domains/Forms/Services/TicketFormService.php

@@ -1,400 +0,0 @@
-<?php
-
-namespace App\Domains\Forms\Services;
-
-use App\Domains\Catalog\Models\CatalogItem;
-use App\Domains\Catalog\Models\Variant;
-use App\Domains\Tenant\Models\Tenant;
-use App\Domains\Ticket\Models\Ticket;
-use Illuminate\Database\Eloquent\Collection;
-
-class TicketFormService
-{
-    private const PRODUCT = 'product';
-
-    /**
-     * @var array<string, array{label: string|null, product: string, type: string|null, order: int}>
-     */
-    private const CATEGORY_PRESENTATIONS = [
-        'entradas' => [
-            'label' => null,
-            'product' => self::PRODUCT,
-            'type' => null,
-            'order' => 1,
-        ],
-        'alojamientos' => [
-            'label' => 'Camping',
-            'product' => 'tipo_alojamiento',
-            'type' => null,
-            'order' => 2,
-        ],
-        'camping' => [
-            'label' => null,
-            'product' => 'tipo_alojamiento',
-            'type' => null,
-            'order' => 2,
-        ],
-        'comidas' => [
-            'label' => 'Comida',
-            'product' => 'event_date',
-            'type' => 'horario',
-            'order' => 3,
-        ],
-        'comida' => [
-            'label' => null,
-            'product' => 'event_date',
-            'type' => 'horario',
-            'order' => 3,
-        ],
-        'merchandising' => [
-            'label' => null,
-            'product' => self::PRODUCT,
-            'type' => 'color',
-            'order' => 4,
-        ],
-    ];
-
-    /**
-     * @var array<string, array{label: string|null, product: string, type: string|null, size: string|null, order: int}>
-     */
-    private const FILTER_CATEGORY_PRESENTATIONS = [
-        'entradas' => ['label' => null, 'product' => self::PRODUCT, 'type' => null, 'size' => null, 'order' => 1],
-        'alojamientos' => ['label' => 'Camping', 'product' => 'tipo_alojamiento', 'type' => null, 'size' => null, 'order' => 2],
-        'camping' => ['label' => null, 'product' => 'tipo_alojamiento', 'type' => null, 'size' => null, 'order' => 2],
-        'comidas' => ['label' => 'Comida', 'product' => 'horario', 'type' => 'servicio', 'size' => null, 'order' => 3],
-        'comida' => ['label' => null, 'product' => 'horario', 'type' => 'servicio', 'size' => null, 'order' => 3],
-        'merchandising' => ['label' => null, 'product' => self::PRODUCT, 'type' => 'color', 'size' => 'talle', 'order' => 4],
-    ];
-
-    /**
-     * @return array{
-     *     statuses: list<array{value: string, label: string}>,
-     *     categories: list<array{
-     *         value: string,
-     *         label: string,
-     *         products: list<array{
-     *             value: string,
-     *             label: string,
-     *             types: list<array{value: string, label: string}>
-     *         }>
-     *     }>
-     * }
-     */
-    public function get(Tenant $tenant): array
-    {
-        $items = CatalogItem::query()
-            ->where('tenant_code', $tenant->codigo)
-            ->where('has_tickets', true)
-            ->whereHas('category')
-            ->with($this->relations())
-            ->orderBy('group_order')
-            ->orderBy('nombre')
-            ->get();
-
-        return $this->build($items, self::CATEGORY_PRESENTATIONS);
-    }
-
-    /**
-     * Return active catalog options plus soft-deleted sources still referenced by
-     * tickets, so historical tickets never become impossible to filter.
-     *
-     * @return array{
-     *     statuses: list<array{value: string, label: string}>,
-     *     categories: list<array{
-     *         value: string,
-     *         label: string,
-     *         products: list<array{
-     *             value: string,
-     *             label: string,
-     *             types: list<array{value: string, label: string}>
-     *         }>
-     *     }>
-     * }
-     */
-    public function getForFilters(Tenant $tenant): array
-    {
-        $historicalVariantIds = Ticket::query()
-            ->where('tenant_code', $tenant->codigo)
-            ->whereNotNull('source_variant_id')
-            ->distinct()
-            ->pluck('source_variant_id')
-            ->map(fn ($id): int => (int) $id)
-            ->all();
-        $historicalCatalogItemIds = Ticket::query()
-            ->where('tenant_code', $tenant->codigo)
-            ->whereNotNull('source_catalog_item_id')
-            ->distinct()
-            ->pluck('source_catalog_item_id')
-            ->map(fn ($id): int => (int) $id)
-            ->merge(
-                Variant::withTrashed()
-                    ->whereKey($historicalVariantIds)
-                    ->pluck('catalog_item_id')
-                    ->map(fn ($id): int => (int) $id),
-            )
-            ->unique()
-            ->values()
-            ->all();
-
-        $items = CatalogItem::withTrashed()
-            ->where('tenant_code', $tenant->codigo)
-            ->whereHas('category')
-            ->where(function ($query) use ($historicalCatalogItemIds): void {
-                $query
-                    ->where(function ($activeQuery): void {
-                        $activeQuery
-                            ->whereNull('catalog_items.deleted_at')
-                            ->where('has_tickets', true);
-                    })
-                    ->orWhereIn('catalog_items.id', $historicalCatalogItemIds);
-            })
-            ->with([
-                'category',
-                'itemAttributes.attribute.options',
-                'variants' => fn ($query) => $query
-                    ->withTrashed()
-                    ->where(function ($variantQuery) use ($historicalVariantIds): void {
-                        $variantQuery
-                            ->whereNull('variantes.deleted_at')
-                            ->orWhereIn('variantes.id', $historicalVariantIds);
-                    }),
-                'variants.definitions.itemAttribute.attribute.options',
-                'variants.eventDates',
-                'variants.eventDate',
-            ])
-            ->orderBy('group_order')
-            ->orderBy('nombre')
-            ->get();
-
-        return $this->build($items, self::FILTER_CATEGORY_PRESENTATIONS, includeSizes: true);
-    }
-
-    /**
-     * @param  Collection<int, CatalogItem>  $items
-     * @return array{
-     *     statuses: list<array{value: string, label: string}>,
-     *     categories: list<array{
-     *         value: string,
-     *         label: string,
-     *         products: list<array{
-     *             value: string,
-     *             label: string,
-     *             types: list<array{value: string, label: string}>
-     *         }>
-     *     }>
-     * }
-     */
-    private function build(Collection $items, array $presentations, bool $includeSizes = false): array
-    {
-        $categories = [];
-
-        foreach ($items as $item) {
-            $sourceCategory = trim((string) $item->category?->nombre);
-            $categoryValue = mb_strtolower($sourceCategory);
-            $presentation = $presentations[$categoryValue] ?? [
-                'label' => null,
-                'product' => self::PRODUCT,
-                'type' => null,
-                'size' => null,
-                'order' => PHP_INT_MAX,
-            ];
-
-            $categories[$categoryValue] ??= [
-                'value' => $categoryValue,
-                'label' => $presentation['label'] ?? $sourceCategory,
-                'order' => $presentation['order'],
-                'products' => [],
-            ];
-
-            foreach ($this->products(
-                $item,
-                $presentation['product'],
-                $presentation['type'],
-                $presentation['size'] ?? null,
-            ) as $product) {
-                $productValue = $product['value'];
-                $existingProduct = $categories[$categoryValue]['products'][$productValue] ?? [
-                    'value' => $productValue,
-                    'label' => $product['label'],
-                    'types' => [],
-                    'sizes' => [],
-                ];
-
-                foreach ($product['types'] as $type) {
-                    $existingProduct['types'][$type['value']] = $type;
-                }
-
-                foreach ($product['sizes'] as $size) {
-                    $existingProduct['sizes'][$size['value']] = $size;
-                }
-
-                $categories[$categoryValue]['products'][$productValue] = $existingProduct;
-            }
-        }
-
-        uasort($categories, fn (array $left, array $right): int => $left['order'] <=> $right['order']
-            ?: $left['label'] <=> $right['label']);
-
-        return [
-            'statuses' => [
-                ['value' => Ticket::STATUS_ACTIVE, 'label' => 'Activo'],
-                ['value' => Ticket::STATUS_USED, 'label' => 'Usado'],
-                ['value' => Ticket::STATUS_EXPIRED, 'label' => 'Vencido'],
-            ],
-            'categories' => array_values(array_map(
-                fn (array $category): array => [
-                    'value' => $category['value'],
-                    'label' => $category['label'],
-                    'products' => array_values(array_map(
-                        fn (array $product): array => [
-                            'value' => $product['value'],
-                            'label' => $product['label'],
-                            'types' => array_values($product['types']),
-                            ...($includeSizes ? ['sizes' => array_values($product['sizes'])] : []),
-                        ],
-                        $category['products'],
-                    )),
-                ],
-                $categories,
-            )),
-        ];
-    }
-
-    /** @return list<string> */
-    private function relations(): array
-    {
-        return [
-            'category',
-            'itemAttributes.attribute.options',
-            'variants.definitions.itemAttribute.attribute.options',
-            'variants.eventDates',
-            'variants.eventDate',
-        ];
-    }
-
-    /**
-     * @return list<array{
-     *     value: string,
-     *     label: string,
-     *     types: list<array{value: string, label: string}>,
-     *     sizes: list<array{value: string, label: string}>
-     * }>
-     */
-    private function products(CatalogItem $item, string $productCode, ?string $typeCode, ?string $sizeCode): array
-    {
-        if ($productCode === self::PRODUCT) {
-            return [[
-                'value' => $item->slug,
-                'label' => $item->nombre,
-                'types' => $this->types($item, $typeCode, $sizeCode),
-                'sizes' => $this->types($item, $sizeCode),
-            ]];
-        }
-
-        $products = [];
-
-        foreach ($item->variants as $variant) {
-            foreach ($this->variantOptions($variant, $productCode) as $productOption) {
-                $productValue = $productOption['value'];
-                $products[$productValue] ??= [
-                    'value' => $productValue,
-                    'label' => $this->optionLabel($productOption['label'], $productCode),
-                    'types' => [],
-                    'sizes' => [],
-                ];
-
-                foreach ($this->variantOptions($variant, $typeCode) as $typeOption) {
-                    $this->mergeTypeOption(
-                        $products[$productValue]['types'],
-                        $typeOption,
-                        $variant,
-                        $sizeCode,
-                    );
-                }
-
-                foreach ($this->variantOptions($variant, $sizeCode) as $sizeOption) {
-                    $products[$productValue]['sizes'][$sizeOption['value']] = $sizeOption;
-                }
-            }
-        }
-
-        return array_values(array_map(
-            fn (array $product): array => [
-                'value' => $product['value'],
-                'label' => $product['label'],
-                'types' => array_values($product['types']),
-                'sizes' => array_values($product['sizes']),
-            ],
-            $products,
-        ));
-    }
-
-    /** @return list<array<string, mixed>> */
-    private function types(CatalogItem $item, ?string $typeCode, ?string $sizeCode = null): array
-    {
-        $types = [];
-
-        foreach ($item->variants as $variant) {
-            foreach ($this->variantOptions($variant, $typeCode) as $typeOption) {
-                $this->mergeTypeOption($types, $typeOption, $variant, $sizeCode);
-            }
-        }
-
-        return array_values(array_map(function (array $type) use ($sizeCode): array {
-            if ($sizeCode !== null) {
-                $type['sizes'] = array_values($type['sizes']);
-            }
-
-            return $type;
-        }, $types));
-    }
-
-    /**
-     * @param  array<string, array<string, mixed>>  $types
-     * @param  array{value: string, label: string}  $typeOption
-     */
-    private function mergeTypeOption(
-        array &$types,
-        array $typeOption,
-        Variant $variant,
-        ?string $sizeCode,
-    ): void {
-        $typeValue = $typeOption['value'];
-        $types[$typeValue] ??= [
-            ...$typeOption,
-            ...($sizeCode !== null ? ['sizes' => []] : []),
-        ];
-
-        foreach ($this->variantOptions($variant, $sizeCode) as $sizeOption) {
-            $types[$typeValue]['sizes'][$sizeOption['value']] = $sizeOption;
-        }
-    }
-
-    /** @return list<array{value: string, label: string}> */
-    private function variantOptions(Variant $variant, ?string $attributeCode): array
-    {
-        if ($attributeCode === null) {
-            return [];
-        }
-
-        $selection = $variant->selectionOptions($variant->catalogItem->itemAttributes)
-            ->get($attributeCode);
-
-        if ($selection === null) {
-            return [];
-        }
-
-        return array_is_list($selection) ? $selection : [$selection];
-    }
-
-    private function optionLabel(string $label, string $attributeCode): string
-    {
-        if ($attributeCode !== 'event_date') {
-            return $label;
-        }
-
-        [$day, $month] = array_pad(explode('/', $label), 2, null);
-
-        return $day !== null && $month !== null ? "{$day}/{$month}" : $label;
-    }
-}

app/Domains/Forms/documentacion/README.md

@@ -9,7 +9,6 @@ Provee catálogos y opciones auxiliares para construir formularios del panel adm
 - `EventFormService`: devuelve redes sociales disponibles y las URL configuradas para el tenant.
 - `SaleFormService`: expone los estados admitidos para compras con sus etiquetas de presentación.
 - `StaffFormService`: lista categorías raíz que pueden asignarse al personal del tenant.
-- `TicketFormService`: expone estados y opciones anidadas de categoría, producto y tipo para los tickets de Fiesta Fútbol Infantil.
 
 Cada servicio tiene un controlador invocable y un `JsonResource` específico. `SocialMediaOptionResource` representa las opciones de redes sociales.
 
@@ -20,7 +19,6 @@ Bajo `/v1/adminapp/forms`, con `auth:sanctum` y `adminapp.tenant`:
 - `GET /event`.
 - `GET /sale`.
 - `GET /staff`.
-- `GET /fiesta-futbol-infantil/ticket`: estados y jerarquía categoría → producto → tipo para filtros de tickets.
 - `GET /fiesta-futbol-infantil/merchandise`: opciones de color y talle del tenant para merchandising.
 
 ## Dependencias

app/Domains/Forms/routes/adminapp.php

@@ -5,8 +5,6 @@ use App\Domains\Forms\Controllers\AdminApp\FoodFormController;
 use App\Domains\Forms\Controllers\AdminApp\MerchandiseFormController;
 use App\Domains\Forms\Controllers\AdminApp\SaleFormController;
 use App\Domains\Forms\Controllers\AdminApp\StaffFormController;
-use App\Domains\Forms\Controllers\AdminApp\TicketFilterFormController;
-use App\Domains\Forms\Controllers\AdminApp\TicketFormController;
 use Illuminate\Support\Facades\Route;
 
 Route::prefix('v1/adminapp/forms')
@@ -15,13 +13,6 @@ Route::prefix('v1/adminapp/forms')
         Route::get('event', EventFormController::class);
         Route::get('sale', SaleFormController::class);
         Route::get('staff', StaffFormController::class);
-        Route::get('tickets-filter', TicketFilterFormController::class)
-            ->middleware('tenant.menu:adminapp.tickets')
-            ->name('adminapp.forms.tickets-filter');
-        Route::get(
-            'fiesta-futbol-infantil/ticket',
-            TicketFormController::class
-        );
         Route::get(
             'fiesta-futbol-infantil/merchandise',
             MerchandiseFormController::class

app/Domains/Integration/Services/MailService.php

@@ -3,8 +3,6 @@
 namespace App\Domains\Integration\Services;
 
 use App\Domains\Client\Models\Client;
-use App\Domains\Tenant\Models\Tenant;
-use App\Domains\Tenant\Models\WebsiteType;
 use Exception;
 use Illuminate\Contracts\Mail\Factory as MailFactory;
 use Illuminate\Contracts\Mail\Mailer;
@@ -72,35 +70,24 @@ class MailService extends BaseIntegrationService
         return [];
     }
 
-    /**
+    public function send(string|array $recipient, string $subject, string $content): void
-     * @param  array<int, array{data: string, name: string, mime: string}>  $attachments
+    {
-     */
-    public function send(
-        string|array $recipient,
-        string $subject,
-        string $content,
-        Tenant|WebsiteType|null $brand = null,
-        array $attachments = [],
-    ): void {
         if (! $this->mailer || ! $this->tenant) {
             throw new Exception('MailService no está configurado. Llamá a forTenant() o forClient() primero.');
         }
 
-        $brand ??= $this->tenant;
+        $this->tenant->loadMissing(['headerLogo', 'footerLogo']);
-        $branding = $this->brandingFor($brand);
 
         $html = Blade::render(
             <<<'BLADE'
-                <x-mail.branded-layout :branding="$branding" :header-logo-url="$headerLogoUrl" :footer-logo-url="$footerLogoUrl">
+                <x-mail.branded-layout :tenant="$tenant" :header-logo-url="$headerLogoUrl" :footer-logo-url="$footerLogoUrl">
                     {!! $content !!}
                 </x-mail.branded-layout>
                 BLADE,
             [
-                'branding' => $branding,
+                'tenant' => $this->tenant,
-                'headerLogoUrl' => $brand instanceof WebsiteType
+                'headerLogoUrl' => $this->tenant->headerLogo?->getTemporaryUrl(1440),
-                    ? $brand->siteLogo?->getTemporaryUrl(1440)
+                'footerLogoUrl' => $this->tenant->footerLogo?->getTemporaryUrl(1440),
-                    : $brand->headerLogo?->getTemporaryUrl(1440),
-                'footerLogoUrl' => $brand->footerLogo?->getTemporaryUrl(1440),
                 'content' => $content,
             ],
         );
@@ -109,14 +96,6 @@ class MailService extends BaseIntegrationService
             ->subject($subject)
             ->html($html);
 
-        foreach ($attachments as $attachment) {
-            $mail->attachData(
-                $attachment['data'],
-                $attachment['name'],
-                ['mime' => $attachment['mime']],
-            );
-        }
-
         $this->mailer->to($recipient)->send($mail);
     }
 
@@ -127,36 +106,6 @@ class MailService extends BaseIntegrationService
             : (string) config('mail.default');
     }
 
-    /** @return array{name: string, primary_color: string, body_color: string, background_color: string, surface_color: string, header_bg_color: string, footer_bg_color: string} */
-    private function brandingFor(Tenant|WebsiteType $brand): array
-    {
-        if ($brand instanceof WebsiteType) {
-            $brand->loadMissing(['siteLogo', 'footerLogo']);
-
-            return [
-                'name' => $brand->nombre,
-                'primary_color' => $brand->primary_color ?? '#FF7006',
-                'body_color' => $brand->body_color ?? '#666666',
-                'background_color' => $brand->background_color ?? '#f8f8f8',
-                'surface_color' => $brand->surface_color ?? '#ffffff',
-                'header_bg_color' => $brand->surface_color ?? '#ffffff',
-                'footer_bg_color' => $brand->login_header_footer_color ?? '#838383',
-            ];
-        }
-
-        $brand->loadMissing(['headerLogo', 'footerLogo']);
-
-        return [
-            'name' => $brand->nombre,
-            'primary_color' => $brand->primary_color ?? '#6376f3',
-            'body_color' => '#334155',
-            'background_color' => '#f1f5f9',
-            'surface_color' => '#ffffff',
-            'header_bg_color' => $brand->header_bg_color ?? '#ffffff',
-            'footer_bg_color' => $brand->footer_bg_color ?? '#334155',
-        ];
-    }
-
     public function onSetup(): void
     {
         if (! $this->mailer || ! $this->clientContext) {

app/Domains/Integration/Services/TelepagosWebhookService.php

@@ -7,10 +7,7 @@ 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 App\Domains\Purchase\Services\DniDistanceService;
 use Exception;
-use Illuminate\Database\Eloquent\Builder;
-use Illuminate\Database\Eloquent\Collection;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Log;
 
@@ -18,7 +15,6 @@ class TelepagosWebhookService
 {
     public function __construct(
         private readonly CheckoutService $checkoutService,
-        private readonly DniDistanceService $dniDistance,
     ) {}
 
     /**
@@ -45,6 +41,7 @@ class TelepagosWebhookService
 
             $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,
@@ -76,55 +73,24 @@ class TelepagosWebhookService
                 $dni = substr($cuit, 2, -1);
 
                 $tenantCodes = $client->tenants()->pluck('codigo');
-                $eligiblePurchases = Purchase::query()
+                $purchases = Purchase::whereIn('tenant_codigo', $tenantCodes)
-                    ->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('payment_method', 'transfer')
-
-                $purchases = (clone $eligiblePurchases)
                     ->where('total', $amount)
                     ->latest()
-                    ->get()
+                    ->get();
-                    ->filter(fn (Purchase $purchase): bool => $purchase->transfer_payer_dni !== null
-                        && $this->dniDistance->distance($dni, $purchase->transfer_payer_dni) === 0)
-                    ->values();
 
+                $paymentData['matched_purchase_ids'] = $purchases->pluck('id')->all();
                 $compra = $purchases->count() === 1 ? $purchases->first() : null;
 
                 if (! $compra) {
-                    $candidatePurchases = $this->findTransferCandidates(
+                    if ($purchases->count() > 1) {
-                        $eligiblePurchases,
+                        TelepagosPayment::create($paymentData);
-                        $dni,
-                        $amount,
-                    );
-                    if ($candidatePurchases->isNotEmpty()) {
-                        $payment = $this->storeTransferCandidates(
-                            $paymentData,
-                            $candidatePurchases,
-                            $dni,
-                            $amount,
-                        );
-
-                        Log::channel('telepagos')->info('Telepagos webhook: Transfer payment candidates found.', [
-                            'client_code' => $client->code,
-                            'cashin_id' => $cashinId,
-                            'telepagos_payment_id' => $payment->id,
-                            'amount' => $amount,
-                            'candidate_count' => $payment->candidates->count(),
-                            'candidates' => $payment->candidates
-                                ->map(fn ($candidate): array => [
-                                    'purchase_id' => $candidate->compra_id,
-                                    'match_reason' => $candidate->match_reason,
-                                    'dni_distance' => $candidate->dni_distance,
-                                    'amount_difference' => $candidate->amount_difference,
-                                    'confidence' => $candidate->confidence,
-                                ])
-                                ->all(),
-                        ]);
                     }
 
                     Log::channel('telepagos')->warning('Telepagos webhook: Expected exactly one matching purchase.', [
@@ -243,91 +209,4 @@ class TelepagosWebhookService
     {
         return number_format((float) $amount, 2, '.', '');
     }
-
-    /**
-     * @param  Builder<Purchase>  $eligiblePurchases
-     * @return Collection<int, Purchase>
-     */
-    private function findTransferCandidates(Builder $eligiblePurchases, string $dni, string $amount): Collection
-    {
-        $tolerancePercentage = max(
-            0,
-            (float) config('purchase.transfer_candidate_amount_tolerance_percentage', 5),
-        );
-        $numericAmount = (float) $amount;
-        $tolerance = $numericAmount * ($tolerancePercentage / 100);
-        $minimumAmount = $this->normalizeAmount(max(0, $numericAmount - $tolerance));
-        $maximumAmount = $this->normalizeAmount($numericAmount + $tolerance);
-
-        return (clone $eligiblePurchases)
-            ->whereBetween('total', [$minimumAmount, $maximumAmount])
-            ->latest()
-            ->get()
-            ->filter(function (Purchase $purchase) use ($dni, $amount): bool {
-                if ($purchase->transfer_payer_dni === null) {
-                    return false;
-                }
-
-                $purchaseAmount = $this->normalizeAmount($purchase->total);
-                $distance = $this->dniDistance->distance(
-                    $dni,
-                    (string) $purchase->transfer_payer_dni,
-                );
-
-                return $distance === 0
-                    || ($purchaseAmount === $amount && $distance <= 2);
-            })
-            ->values();
-    }
-
-    /**
-     * @param  array<string, mixed>  $paymentData
-     * @param  Collection<int, Purchase>  $candidatePurchases
-     */
-    private function storeTransferCandidates(
-        array $paymentData,
-        Collection $candidatePurchases,
-        string $dni,
-        string $amount,
-    ): TelepagosPayment {
-        return DB::transaction(function () use ($paymentData, $candidatePurchases, $dni, $amount): TelepagosPayment {
-            $payment = TelepagosPayment::create($paymentData);
-
-            $payment->candidates()->createMany(
-                $candidatePurchases
-                    ->map(function (Purchase $purchase) use ($dni, $amount): array {
-                        $purchaseAmount = $this->normalizeAmount($purchase->total);
-                        $dniDistance = $this->dniDistance->distance(
-                            $dni,
-                            (string) $purchase->transfer_payer_dni,
-                        );
-                        $dniMatches = $dniDistance === 0;
-                        $amountMatches = $purchaseAmount === $amount;
-
-                        return [
-                            'compra_id' => $purchase->id,
-                            'dni_matches' => $dniMatches,
-                            'dni_distance' => $dniDistance,
-                            'payment_dni' => $dni,
-                            'purchase_dni' => $purchase->transfer_payer_dni,
-                            'amount_matches' => $amountMatches,
-                            'payment_amount' => $amount,
-                            'purchase_amount' => $purchaseAmount,
-                            'amount_difference' => $this->normalizeAmount(
-                                abs((float) $purchaseAmount - (float) $amount),
-                            ),
-                            'match_reason' => $amountMatches
-                                ? ($dniMatches ? 'ambiguous_exact_match' : 'exact_amount_near_dni')
-                                : 'exact_dni_near_amount',
-                            'confidence' => $amountMatches
-                                ? ($dniMatches ? 'exact' : 'medium')
-                                : 'high',
-                        ];
-                    })
-                    ->all(),
-            );
-
-            return $payment->load('candidates');
-        });
-    }
 }

app/Domains/MailTest/Mailables/TestMail.php

@@ -28,21 +28,10 @@ class TestMail extends Mailable
     {
         $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),
             ],

app/Domains/Notification/Events/TicketsAvailable.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Domains\Notification\Events;
+
+use App\Domains\Purchase\Models\Purchase;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class TicketsAvailable
+{
+    use Dispatchable, SerializesModels;
+
+    /**
+     * @param  array<int, int>  $ticketIds
+     */
+    public function __construct(
+        public readonly Purchase $purchase,
+        public readonly array $ticketIds,
+    ) {}
+}

app/Domains/Notification/Listeners/SendPasswordResetEmail.php

@@ -6,6 +6,8 @@ use App\Domains\Notification\Events\PasswordResetRequested;
 use App\Domains\Notification\Services\NotificationMailService;
 use Illuminate\Contracts\Queue\ShouldQueueAfterCommit;
 use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Support\Facades\Log;
+use Throwable;
 
 class SendPasswordResetEmail implements ShouldQueueAfterCommit
 {
@@ -20,10 +22,21 @@ class SendPasswordResetEmail implements ShouldQueueAfterCommit
 
     public function handle(PasswordResetRequested $event): void
     {
-        app(NotificationMailService::class)->sendPasswordResetCode(
+        try {
-            $event->attemptId,
+            app(NotificationMailService::class)->sendPasswordResetCode(
-            $event->tenantCode,
+                $event->attemptId,
-            $event->channel,
+                $event->tenantCode,
-        );
+                $event->channel,
+            );
+        } catch (Throwable $exception) {
+            Log::error('Failed to send password reset email.', [
+                'attempt_id' => $event->attemptId,
+                'tenant_code' => $event->tenantCode,
+                'channel' => $event->channel,
+                'exception' => $exception,
+            ]);
+
+            throw $exception;
+        }
     }
 }

app/Domains/Notification/Listeners/SendPurchasePaidEmail.php

@@ -7,7 +7,7 @@ use App\Domains\Purchase\Events\PurchasePaid;
 use Illuminate\Contracts\Queue\ShouldQueueAfterCommit;
 use Illuminate\Queue\InteractsWithQueue;
 
-class SendPurchaseConfirmedEmail implements ShouldQueueAfterCommit
+class SendPurchasePaidEmail implements ShouldQueueAfterCommit
 {
     use InteractsWithQueue;
 
@@ -20,6 +20,6 @@ class SendPurchaseConfirmedEmail implements ShouldQueueAfterCommit
 
     public function handle(PurchasePaid $event): void
     {
-        app(NotificationMailService::class)->sendPurchaseConfirmed($event->purchaseId);
+        app(NotificationMailService::class)->sendPurchasePaid($event->purchase->getKey());
     }
 }

app/Domains/Notification/Listeners/SendTicketsAvailableEmail.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Domains\Notification\Listeners;
+
+use App\Domains\Notification\Events\TicketsAvailable;
+use App\Domains\Notification\Services\NotificationMailService;
+use Illuminate\Contracts\Queue\ShouldQueueAfterCommit;
+use Illuminate\Queue\InteractsWithQueue;
+
+class SendTicketsAvailableEmail implements ShouldQueueAfterCommit
+{
+    use InteractsWithQueue;
+
+    public string $queue = 'emails';
+
+    public int $tries = 3;
+
+    /** @var array<int, int> */
+    public array $backoff = [30, 120, 300];
+
+    public function handle(TicketsAvailable $event): void
+    {
+        app(NotificationMailService::class)->sendTicketsAvailable($event->purchase->getKey(), $event->ticketIds);
+    }
+}

app/Domains/Notification/Services/NotificationMailService.php

@@ -9,43 +9,28 @@ use App\Domains\Notification\Events\PasswordResetRequested;
 use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Tenant\Models\Tenant;
 use App\Domains\Ticket\Models\Ticket;
-use App\Domains\Ticket\Services\TicketPdfService;
 use App\Domains\Ticket\Services\TicketPresentationResolver;
-use Closure;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Log;
-use Throwable;
 
 class NotificationMailService
 {
     public function __construct(
         private readonly MailService $mailService,
-        private readonly TicketPdfService $ticketPdfService,
     ) {}
 
     public function sendWelcome(int $userId, string $tenantCode): void
     {
-        $this->sendLogged('welcome', [
+        $tenant = Tenant::query()->where('codigo', $tenantCode)->firstOrFail();
-            'user_id' => $userId,
+        $user = User::query()->findOrFail($userId);
-            'tenant_code' => $tenantCode,
-        ], function () use ($userId, $tenantCode): array {
-            $tenant = Tenant::query()->with('websiteType')->where('codigo', $tenantCode)->firstOrFail();
-            $user = User::query()->findOrFail($userId);
-            $brand = $tenant->websiteType ?? $tenant;
 
-            $this->mailService
+        $this->mailService
-                ->forTenant($tenantCode)
+            ->forTenant($tenantCode)
-                ->send(
+            ->send(
-                    $user->email,
+                $user->email,
-                    "Bienvenido a {$brand->nombre}",
+                "Bienvenido a {$tenant->nombre}",
-                    view('mail.notifications.welcome', compact('brand', 'user'))->render(),
+                view('mail.notifications.welcome', compact('tenant', 'user'))->render(),
-                    $brand,
+            );
-                );
-
-            return [
-                'brand_type' => $tenant->websiteType === null ? 'tenant' : 'website_type',
-            ];
-        });
     }
 
     public function sendPasswordResetCode(
@@ -53,160 +38,95 @@ class NotificationMailService
         string $tenantCode,
         string $channel = PasswordResetRequested::CHANNEL_STOREFRONT,
     ): void {
-        $context = [
+        $tenant = Tenant::query()
-            'attempt_id' => $attemptId,
+            ->with('websiteType')
-            'tenant_code' => $tenantCode,
+            ->where('codigo', $tenantCode)
-            'channel' => $channel,
+            ->firstOrFail();
-        ];
+        $attempt = ResetPasswordAttempt::query()
+            ->with('user')
+            ->findOrFail($attemptId);
 
-        $this->sendLogged('password_reset', $context, function () use ($attemptId, $tenantCode, $channel, $context): ?array {
+        if ($attempt->status !== ResetPasswordAttempt::STATUS_PENDING) {
-            $tenant = Tenant::query()
+            Log::warning('Password reset email was skipped because the attempt is no longer pending.', [
-                ->with('websiteType')
+                'attempt_id' => $attemptId,
-                ->where('codigo', $tenantCode)
+                'tenant_code' => $tenantCode,
-                ->firstOrFail();
+                'attempt_status' => $attempt->status,
-            $attempt = ResetPasswordAttempt::query()
+            ]);
-                ->with('user')
-                ->findOrFail($attemptId);
 
-            if ($attempt->status !== ResetPasswordAttempt::STATUS_PENDING) {
+            return;
-                $this->logSkipped('password_reset', array_merge($context, [
+        }
-                    'reason' => 'attempt_not_pending',
-                    'attempt_status' => $attempt->status,
-                    'user_id' => $attempt->user_id,
-                ]));
 
-                return null;
+        $recoveryDomain = match ($channel) {
-            }
+            PasswordResetRequested::CHANNEL_ADMINAPP => $tenant->websiteType?->dominio,
+            PasswordResetRequested::CHANNEL_SCANNER => $tenant->websiteType?->scanner_domain,
+            default => $tenant->dominio,
+        };
+        $recoveryBasePath = $channel === PasswordResetRequested::CHANNEL_STOREFRONT
+            && $tenant->base_path !== '/'
+                ? $tenant->base_path
+                : '';
+        $recoveryQuery = ['email' => $attempt->user->email];
+        if (
+            $channel === PasswordResetRequested::CHANNEL_SCANNER
+            && $attempt->reason === ResetPasswordAttempt::REASON_STAFF_CREATED
+        ) {
+            $recoveryQuery['code'] = $attempt->codigo;
+        }
+        $recoveryUrl = $recoveryDomain === null
+            ? null
+            : 'https://'.$recoveryDomain.$recoveryBasePath.'/recuperar-contrasena/codigo?'.http_build_query($recoveryQuery);
 
-            $recoveryDomain = match ($channel) {
+        $this->mailService
-                PasswordResetRequested::CHANNEL_ADMINAPP => $tenant->websiteType?->dominio,
+            ->forTenant($tenantCode)
-                PasswordResetRequested::CHANNEL_SCANNER => $tenant->websiteType?->scanner_domain,
+            ->send(
-                default => $tenant->dominio,
+                $attempt->user->email,
-            };
+                "Código para recuperar tu contraseña - {$tenant->nombre}",
-            $recoveryBasePath = $channel === PasswordResetRequested::CHANNEL_STOREFRONT
+                view('mail.notifications.password-reset', compact('tenant', 'attempt', 'recoveryUrl'))->render(),
-                && $tenant->base_path !== '/'
+            );
-                    ? $tenant->base_path
-                    : '';
-            $recoveryQuery = ['email' => $attempt->user->email];
-            if (
-                $channel === PasswordResetRequested::CHANNEL_SCANNER
-                && $attempt->reason === ResetPasswordAttempt::REASON_STAFF_CREATED
-            ) {
-                $recoveryQuery['code'] = $attempt->codigo;
-            }
-            $recoveryUrl = $recoveryDomain === null
-                ? null
-                : 'https://'.$recoveryDomain.$recoveryBasePath.'/recuperar-contrasena/codigo?'.http_build_query($recoveryQuery);
-            $brand = $tenant->websiteType ?? $tenant;
-
-            $this->mailService
-                ->forTenant($tenantCode)
-                ->send(
-                    $attempt->user->email,
-                    "Código para recuperar tu contraseña - {$brand->nombre}",
-                    view('mail.notifications.password-reset', [
-                        'attempt' => $attempt,
-                        'recoveryUrl' => $recoveryUrl,
-                        'brand' => $brand,
-                    ])->render(),
-                    $brand,
-                );
-
-            return [
-                'user_id' => $attempt->user_id,
-                'recovery_domain_available' => $recoveryDomain !== null,
-            ];
-        });
     }
 
-    public function sendPurchaseConfirmed(int $purchaseId): void
+    public function sendPurchasePaid(int $purchaseId): void
     {
-        $context = ['purchase_id' => $purchaseId];
+        $purchase = Purchase::query()
+            ->with(['tenant', 'user', 'items'])
+            ->findOrFail($purchaseId);
 
-        $this->sendLogged('purchase_confirmed', $context, function () use ($purchaseId, $context): ?array {
+        $this->mailService
-            $purchase = Purchase::query()
+            ->forTenant($purchase->tenant_codigo)
-                ->with(['tenant', 'user', 'items'])
+            ->send(
-                ->find($purchaseId);
+                $this->recipientFor($purchase),
+                "Pago confirmado - Compra #{$purchase->getKey()}",
+                view('mail.notifications.purchase-paid', compact('purchase'))->render(),
+            );
+    }
 
-            if ($purchase === null) {
+    /** @param array<int, int> $ticketIds */
-                $this->logSkipped('purchase_confirmed', array_merge($context, [
+    public function sendTicketsAvailable(int $purchaseId, array $ticketIds): void
-                    'reason' => 'purchase_not_found',
+    {
-                    'missing_model' => Purchase::class,
+        $purchase = Purchase::query()->with(['tenant', 'user'])->findOrFail($purchaseId);
-                ]));
+        /** @var Collection<int, Ticket> $tickets */
+        $tickets = Ticket::query()
+            ->where('tenant_code', $purchase->tenant_codigo)
+            ->where('user_id', $purchase->user_id)
+            ->whereKey($ticketIds)
+            ->with(TicketPresentationResolver::RELATIONS)
+            ->get();
 
-                return null;
+        if ($tickets->isEmpty()) {
-            }
+            return;
+        }
 
-            /** @var Collection<int, Ticket> $tickets */
+        $this->mailService
-            $tickets = $purchase->tickets()
+            ->forTenant($purchase->tenant_codigo)
-                ->where('tenant_code', $purchase->tenant_codigo)
+            ->send(
-                ->with(TicketPresentationResolver::RELATIONS)
+                $this->recipientFor($purchase),
-                ->get();
+                'Tus tickets ya están disponibles',
-            $attachments = $tickets->isEmpty()
+                view('mail.notifications.tickets-available', compact('purchase', 'tickets'))->render(),
-                ? []
+            );
-                : [[
-                    'data' => $this->ticketPdfService->contents($purchase->tenant, $tickets),
-                    'name' => $this->ticketPdfService->filename($tickets),
-                    'mime' => 'application/pdf',
-                ]];
-
-            $this->mailService
-                ->forTenant($purchase->tenant_codigo)
-                ->send(
-                    $this->recipientFor($purchase),
-                    "Compra confirmada - Compra #{$purchase->getKey()}",
-                    view('mail.notifications.purchase-confirmed', compact('purchase', 'tickets'))->render(),
-                    attachments: $attachments,
-                );
-
-            return [
-                'tenant_code' => $purchase->tenant_codigo,
-                'user_id' => $purchase->user_id,
-                'purchase_status' => $purchase->status,
-                'purchase_item_count' => $purchase->items->count(),
-                'ticket_count' => $tickets->count(),
-                'ticket_ids' => $tickets->modelKeys(),
-            ];
-        });
     }
 
     private function recipientFor(Purchase $purchase): string
     {
         return (string) ($purchase->email ?: $purchase->user?->email);
     }
-
-    /**
-     * @param  array<string, mixed>  $context
-     * @param  Closure(): (array<string, mixed>|null)  $send
-     */
-    private function sendLogged(string $emailType, array $context, Closure $send): void
-    {
-        try {
-            $resultContext = $send();
-
-            if ($resultContext === null) {
-                return;
-            }
-
-            Log::channel('emails')->info('Notification email sent.', array_merge($context, $resultContext, [
-                'email_type' => $emailType,
-                'mailer' => $this->mailService->mailerName(),
-            ]));
-        } catch (Throwable $exception) {
-            Log::channel('emails')->error('Notification email delivery failed.', array_merge($context, [
-                'email_type' => $emailType,
-                'exception' => $exception,
-            ]));
-
-            throw $exception;
-        }
-    }
-
-    /** @param array<string, mixed> $context */
-    private function logSkipped(string $emailType, array $context): void
-    {
-        Log::channel('emails')->warning('Notification email skipped.', array_merge($context, [
-            'email_type' => $emailType,
-        ]));
-    }
 }

app/Domains/Notification/documentacion/README.md

@@ -8,11 +8,12 @@ Orquesta notificaciones de negocio por correo a partir de eventos de otros domin
 
 - `UserRegistered`: dispara el correo de bienvenida.
 - `PasswordResetRequested`: envía el código de recuperación si el intento sigue pendiente.
-- `PurchasePaid`: envía la confirmación de compra y adjunta los tickets generados, cuando corresponde.
+- `PurchasePaid`: envía la confirmación de pago.
+- `TicketsAvailable`: informa y entrega la disponibilidad de tickets.
 
 ## Componentes
 
-Los listeners `SendWelcomeEmail`, `SendPasswordResetEmail` y `SendPurchaseConfirmedEmail` delegan en `NotificationMailService`. Este servicio carga el contexto necesario, renderiza las vistas y envía mediante `Integration/MailService`.
+Los listeners `SendWelcomeEmail`, `SendPasswordResetEmail`, `SendPurchasePaidEmail` y `SendTicketsAvailableEmail` delegan en `NotificationMailService`. Este servicio carga el contexto necesario, renderiza las vistas y envía mediante `Integration/MailService`.
 
 ## API y dependencias
 
@@ -22,6 +23,4 @@ No expone rutas HTTP. Consume datos de `Auth`, `Tenant`, `Purchase` y `Ticket`,
 
 - Los listeners reciben identificadores y vuelven a cargar los modelos, evitando transportar entidades obsoletas.
 - La recuperación no se envía si el intento dejó de estar pendiente.
-- Los correos de cuenta (bienvenida y recuperación de contraseña) usan la identidad visual del `WebsiteType` asociado al tenant, con fallback al tenant si no tiene uno configurado.
-- El correo transaccional de compra confirmada usa la identidad visual del tenant y adjunta un único PDF cuando la compra generó tickets.
 - Los handlers deben permanecer idempotentes o tolerantes a reintentos de cola.

app/Domains/Purchase/Controllers/PurchaseController.php

@@ -36,7 +36,6 @@ 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))
@@ -93,6 +92,7 @@ class PurchaseController extends Controller
         PaymentIntentRequest $request,
         Tenant $tenant,
         Purchase $compra,
+        CheckoutService $checkoutService,
         PurchaseStateGuard $purchaseState,
     ): JsonResponse {
         $compra = $this->resolveScopedPurchase($tenant, $request->user()->id, $compra);
@@ -101,12 +101,7 @@ class PurchaseController extends Controller
             ? preg_replace('/\D+/', '', (string) $request->validated('transfer_payer_dni'))
             : null;
 
-        $updated = DB::transaction(function () use (
+        $updated = DB::transaction(function () use ($compra, $method, $purchaseState, $transferPayerDni): bool {
-            $compra,
-            $method,
-            $purchaseState,
-            $transferPayerDni,
-        ): bool {
             /** @var Purchase|null $purchase */
             $purchase = Purchase::query()
                 ->whereKey($compra->getKey())
@@ -133,6 +128,9 @@ 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(),
             ];
 
@@ -152,6 +150,7 @@ class PurchaseController extends Controller
 
         $compra->refresh();
         $totalAmount = (float) $compra->total;
+        $checkoutService->syncReservationExpiration($compra);
 
         if ($method === 'transfer') {
             $telepagosService = new TelepagosIntegrationService;

app/Domains/Purchase/Events/PurchasePaid.php

@@ -2,6 +2,7 @@
 
 namespace App\Domains\Purchase\Events;
 
+use App\Domains\Purchase\Models\Purchase;
 use Illuminate\Foundation\Events\Dispatchable;
 use Illuminate\Queue\SerializesModels;
 
@@ -9,5 +10,5 @@ class PurchasePaid
 {
     use Dispatchable, SerializesModels;
 
-    public function __construct(public readonly int $purchaseId) {}
+    public function __construct(public readonly Purchase $purchase) {}
 }

app/Domains/Purchase/Models/Purchase.php

@@ -14,7 +14,6 @@ use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
-use Illuminate\Database\Eloquent\Relations\HasManyThrough;
 use Illuminate\Database\Eloquent\Relations\HasOne;
 use Illuminate\Support\Facades\DB;
 
@@ -25,6 +24,7 @@ use Illuminate\Support\Facades\DB;
     'user_id',
     'status',
     'payment_method',
+    'expires_at',
     'total',
     'dni',
     'transfer_payer_dni',
@@ -52,14 +52,6 @@ class Purchase extends Model
 
     public const STATUS_SUPERSEDED = 'superseded';
 
-    public const ADMIN_STATUS_INCOMPLETE = 'incomplete';
-
-    public const ADMIN_STATUS_AWAITING_PAYMENT = 'awaiting_payment';
-
-    public const ADMIN_STATUS_CONFIRMED = 'confirmed';
-
-    public const ADMIN_STATUS_CANCELLED = 'cancelled';
-
     /** @return list<string> */
     public static function statuses(): array
     {
@@ -75,68 +67,6 @@ class Purchase extends Model
         ];
     }
 
-    /**
-     * @return array<string, array{name: string, statuses: list<string>}>
-     */
-    public static function adminStatuses(): array
-    {
-        return [
-            self::ADMIN_STATUS_INCOMPLETE => [
-                'name' => 'Por completar datos',
-                'statuses' => [self::STATUS_CREATED],
-            ],
-            self::ADMIN_STATUS_AWAITING_PAYMENT => [
-                'name' => 'Esperando pago',
-                'statuses' => [self::STATUS_PENDING_PAYMENT, self::STATUS_IN_REVIEW],
-            ],
-            self::ADMIN_STATUS_CONFIRMED => [
-                'name' => 'Confirmado',
-                'statuses' => [self::STATUS_PAID],
-            ],
-            self::ADMIN_STATUS_CANCELLED => [
-                'name' => 'Anulado',
-                'statuses' => [
-                    self::STATUS_CANCELLED,
-                    self::STATUS_REJECTED,
-                    self::STATUS_EXPIRED,
-                    self::STATUS_SUPERSEDED,
-                ],
-            ],
-        ];
-    }
-
-    /** @return list<string> */
-    public static function adminStatusCodes(): array
-    {
-        return array_keys(self::adminStatuses());
-    }
-
-    /** @return list<string> */
-    public static function realStatusesForAdminStatus(string $adminStatus): array
-    {
-        return self::adminStatuses()[$adminStatus]['statuses'] ?? [];
-    }
-
-    public static function adminStatusFor(string $realStatus): ?string
-    {
-        foreach (self::adminStatuses() as $adminStatus => $definition) {
-            if (in_array($realStatus, $definition['statuses'], true)) {
-                return $adminStatus;
-            }
-        }
-
-        return null;
-    }
-
-    public static function adminStatusNameFor(string $realStatus): ?string
-    {
-        $adminStatus = self::adminStatusFor($realStatus);
-
-        return $adminStatus === null
-            ? null
-            : self::adminStatuses()[$adminStatus]['name'];
-    }
-
     protected $table = 'compras';
 
     /** @var array<int, string> */
@@ -150,6 +80,7 @@ class Purchase extends Model
             'cart_id' => 'integer',
             'stock_reservation_id' => 'integer',
             'user_id' => 'integer',
+            'expires_at' => 'datetime',
             'total' => 'decimal:2',
         ];
     }
@@ -186,15 +117,12 @@ class Purchase extends Model
         return $this->hasMany(PurchaseItem::class, 'compra_id');
     }
 
-    /** @return HasManyThrough<Ticket, PurchaseItem, $this> */
+    /**
-    public function tickets(): HasManyThrough
+     * @return HasMany<Ticket, $this>
+     */
+    public function tickets(): HasMany
     {
-        return $this->hasManyThrough(
+        return $this->hasMany(Ticket::class, 'source_purchase_id');
-            Ticket::class,
-            PurchaseItem::class,
-            'compra_id',
-            'source_purchase_item_id',
-        );
     }
 
     /** @return BelongsTo<StockReservation, $this> */
@@ -219,12 +147,6 @@ class Purchase extends Model
         return $this->hasMany(TelepagosPayment::class, 'compra_id');
     }
 
-    /** @return HasMany<TelepagosPaymentCandidate, $this> */
-    public function telepagosPaymentCandidates(): HasMany
-    {
-        return $this->hasMany(TelepagosPaymentCandidate::class, 'compra_id');
-    }
-
     public function getTotalAmount(): float
     {
         if ($this->total !== null) {
@@ -273,7 +195,7 @@ class Purchase extends Model
                 'status' => self::STATUS_PAID,
             ]);
 
-            PurchasePaid::dispatch($this->getKey());
+            PurchasePaid::dispatch($this);
         });
     }
 }

app/Domains/Purchase/Models/PurchaseItem.php

@@ -5,12 +5,10 @@ namespace App\Domains\Purchase\Models;
 use App\Domains\Attachable\Models\Attachment;
 use App\Domains\Catalog\Models\CatalogItem;
 use App\Domains\Catalog\Models\Variant;
-use App\Domains\Ticket\Models\Ticket;
 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([
     'compra_id',
@@ -58,12 +56,6 @@ class PurchaseItem extends Model
         return $this->belongsTo(Purchase::class, 'compra_id');
     }
 
-    /** @return HasMany<Ticket, $this> */
-    public function tickets(): HasMany
-    {
-        return $this->hasMany(Ticket::class, 'source_purchase_item_id');
-    }
-
     /** @return BelongsTo<Attachment, $this> */
     public function imageAttachment(): BelongsTo
     {

app/Domains/Purchase/Models/TelepagosPayment.php

@@ -6,10 +6,10 @@ 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([
     'compra_id',
+    'matched_purchase_ids',
     'cuit_buyer',
     'cvu_buyer',
     'amount',
@@ -30,6 +30,7 @@ class TelepagosPayment extends Model
     {
         return [
             'compra_id' => 'integer',
+            'matched_purchase_ids' => 'array',
             'amount' => 'decimal:2',
         ];
     }
@@ -41,10 +42,4 @@ class TelepagosPayment extends Model
     {
         return $this->belongsTo(Purchase::class, 'compra_id');
     }
-
-    /** @return HasMany<TelepagosPaymentCandidate, $this> */
-    public function candidates(): HasMany
-    {
-        return $this->hasMany(TelepagosPaymentCandidate::class, 'telepagos_payment_id');
-    }
 }

app/Domains/Purchase/Models/TelepagosPaymentCandidate.php

@@ -1,50 +0,0 @@
-<?php
-
-namespace App\Domains\Purchase\Models;
-
-use Illuminate\Database\Eloquent\Attributes\Fillable;
-use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
-
-#[Fillable([
-    'telepagos_payment_id',
-    'compra_id',
-    'dni_matches',
-    'dni_distance',
-    'payment_dni',
-    'purchase_dni',
-    'amount_matches',
-    'payment_amount',
-    'purchase_amount',
-    'amount_difference',
-    'match_reason',
-    'confidence',
-])]
-class TelepagosPaymentCandidate extends Model
-{
-    protected $table = 'telepagos_payment_candidates';
-
-    protected function casts(): array
-    {
-        return [
-            'telepagos_payment_id' => 'integer',
-            'compra_id' => 'integer',
-            'dni_matches' => 'boolean',
-            'dni_distance' => 'integer',
-            'amount_matches' => 'boolean',
-            'payment_amount' => 'decimal:2',
-            'purchase_amount' => 'decimal:2',
-            'amount_difference' => 'decimal:2',
-        ];
-    }
-
-    public function payment(): BelongsTo
-    {
-        return $this->belongsTo(TelepagosPayment::class, 'telepagos_payment_id');
-    }
-
-    public function purchase(): BelongsTo
-    {
-        return $this->belongsTo(Purchase::class, 'compra_id');
-    }
-}

app/Domains/Purchase/Resources/PurchaseResource.php

@@ -4,7 +4,6 @@ namespace App\Domains\Purchase\Resources;
 
 use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Purchase\Models\PurchaseItem;
-use App\Domains\Purchase\Models\TelepagosPaymentCandidate;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
 
@@ -18,15 +17,12 @@ 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();
         $ticketsCount = array_key_exists('tickets_count', $this->resource->getAttributes())
             ? (int) $this->resource->getAttribute('tickets_count')
             : null;
-        $paymentVerification = $this->resolvePaymentVerification();
 
         $subtotal = $items->isNotEmpty()
             ? $items->reduce(
@@ -52,11 +48,7 @@ class PurchaseResource extends JsonResource
             'created_at' => $this->created_at,
             'status' => $this->status,
             'payment_method' => $this->payment_method,
-            'expires_at' => $expiresAt,
+            'expires_at' => $this->expires_at,
-            '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,
@@ -66,7 +58,6 @@ class PurchaseResource extends JsonResource
             'items' => PurchaseItemResource::collection($items),
             'tickets_count' => $this->when($ticketsCount !== null, $ticketsCount),
             'has_generated_tickets' => $this->when($ticketsCount !== null, $ticketsCount > 0),
-            'payment_verification' => $this->when($paymentVerification !== null, $paymentVerification),
             'subtotal' => $this->formatMoney($subtotal),
             'total' => $this->formatMoney($total),
         ];
@@ -86,75 +77,4 @@ class PurchaseResource extends JsonResource
     {
         return number_format((float) ($amount ?? 0), 2, '.', '');
     }
-
-    /** @return array<string, mixed>|null */
-    private function resolvePaymentVerification(): ?array
-    {
-        if (
-            $this->status !== Purchase::STATUS_IN_REVIEW
-            || $this->payment_method !== 'transfer'
-            || ! $this->resource->relationLoaded('telepagosPaymentCandidates')
-        ) {
-            return null;
-        }
-
-        $candidates = $this->resource
-            ->getRelation('telepagosPaymentCandidates')
-            ->sort(fn (TelepagosPaymentCandidate $left, TelepagosPaymentCandidate $right): int => $this->comparePaymentCandidates($left, $right))
-            ->values();
-        /** @var TelepagosPaymentCandidate|null $primary */
-        $primary = $candidates->first();
-
-        return [
-            'status' => $primary === null ? 'pending' : 'candidate',
-            'candidate_count' => $candidates->count(),
-            'primary' => $primary === null ? null : [
-                'reason' => $primary->match_reason,
-                'dni_distance' => $primary->dni_distance,
-                'payment_amount' => $this->formatMoney($primary->payment_amount),
-                'purchase_amount' => $this->formatMoney($primary->purchase_amount),
-                'amount_difference' => $this->formatMoney($primary->amount_difference),
-                'confidence' => $primary->confidence,
-                'detected_at' => $primary->payment?->created_at?->toIso8601String(),
-            ],
-            'reasons' => $candidates
-                ->pluck('match_reason')
-                ->unique()
-                ->values()
-                ->all(),
-        ];
-    }
-
-    private function comparePaymentCandidates(
-        TelepagosPaymentCandidate $left,
-        TelepagosPaymentCandidate $right,
-    ): int {
-        $reasonComparison = $this->paymentCandidateRank($left->match_reason)
-            <=> $this->paymentCandidateRank($right->match_reason);
-
-        if ($reasonComparison !== 0) {
-            return $reasonComparison;
-        }
-
-        $differenceComparison = (float) $left->amount_difference <=> (float) $right->amount_difference;
-
-        if ($differenceComparison !== 0) {
-            return $differenceComparison;
-        }
-
-        $leftTimestamp = $left->payment?->created_at?->getTimestamp() ?? 0;
-        $rightTimestamp = $right->payment?->created_at?->getTimestamp() ?? 0;
-
-        return ($rightTimestamp <=> $leftTimestamp) ?: ($right->id <=> $left->id);
-    }
-
-    private function paymentCandidateRank(string $reason): int
-    {
-        return match ($reason) {
-            'ambiguous_exact_match' => 0,
-            'exact_dni_near_amount' => 1,
-            'exact_amount_near_dni' => 2,
-            default => 3,
-        };
-    }
 }

app/Domains/Purchase/Services/Checkout/CompleteCheckoutService.php

@@ -61,7 +61,10 @@ class CompleteCheckoutService
 
             $this->purchaseState->lockCurrentCart($purchase);
 
-            if ($purchase->status !== Purchase::STATUS_PENDING_PAYMENT) {
+            if (
+                $purchase->status !== Purchase::STATUS_PENDING_PAYMENT
+                || ($purchase->expires_at !== null && $purchase->expires_at->isPast())
+            ) {
                 throw ValidationException::withMessages([
                     'purchase' => __('api.purchase.not_available_for_review'),
                 ]);
@@ -69,8 +72,9 @@ class CompleteCheckoutService
 
             $purchase->update([
                 'status' => Purchase::STATUS_IN_REVIEW,
+                'expires_at' => null,
             ]);
-            $this->reservations->clearExpirationForReview($purchase);
+            $this->reservations->syncPurchaseExpiration($purchase);
 
             return $this->loadPurchase($purchase);
         });
@@ -191,7 +195,7 @@ class CompleteCheckoutService
 
     private function loadPurchase(Purchase $purchase): Purchase
     {
-        return $purchase->load(['items.imageAttachment', 'stockReservation']);
+        return $purchase->load(['items.imageAttachment']);
     }
 
     private function itemKey(int $catalogItemId, ?int $variantId): string

app/Domains/Purchase/Services/Checkout/PurchaseResponseLoader.php

@@ -8,15 +8,6 @@ class PurchaseResponseLoader
 {
     public function load(Purchase $purchase): Purchase
     {
-        $relations = ['tenant', 'items.imageAttachment', 'stockReservation'];
+        return $purchase->load(['tenant', 'items.imageAttachment']);
-
-        if (
-            $purchase->status === Purchase::STATUS_IN_REVIEW
-            && $purchase->payment_method === 'transfer'
-        ) {
-            $relations[] = 'telepagosPaymentCandidates.payment';
-        }
-
-        return $purchase->load($relations);
     }
 }

app/Domains/Purchase/Services/Checkout/ReleaseCheckoutService.php

@@ -5,10 +5,11 @@ 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
 {
@@ -31,6 +32,40 @@ 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,
@@ -43,16 +78,6 @@ class ReleaseCheckoutService
         ): Purchase {
             $purchase = $this->lockPurchase($purchase);
 
-            if ($purchase->status === Purchase::STATUS_EXPIRED
-                && $targetStatus === Purchase::STATUS_CANCELLED) {
-                return $this->loadPurchase($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);
@@ -75,39 +100,14 @@ class ReleaseCheckoutService
                 return $this->loadPurchase($purchase);
             }
 
-            $cart = $purchase->cart()->withTrashed()->lockForUpdate()->first();
-
-            // Leaving checkout is allowed at the exact instant the reservation
-            // expires. Finish the expiration while holding the purchase lock so
-            // the request is idempotent with the scheduled expiration job.
-            if ($targetStatus === Purchase::STATUS_CANCELLED
-                && $this->hasOverdueActiveReservation($purchase)) {
-                $targetStatus = Purchase::STATUS_EXPIRED;
-            }
-
-            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
-                && (! in_array($purchase->status, [
+                && ($purchase->expires_at === null || $purchase->expires_at->isFuture())
-                    Purchase::STATUS_CREATED,
-                    Purchase::STATUS_PENDING_PAYMENT,
-                ], true) || ! $this->hasOverdueActiveReservation($purchase))
             ) {
                 return $this->loadPurchase($purchase);
             }
 
-            $this->releasePurchaseReservations($purchase, $targetStatus, $cart);
+            $this->releasePurchaseReservations($purchase, $targetStatus);
 
             $purchase->update(['status' => $targetStatus]);
 
@@ -115,11 +115,9 @@ class ReleaseCheckoutService
         });
     }
 
-    private function releasePurchaseReservations(
+    private function releasePurchaseReservations(Purchase $purchase, string $targetStatus): void
-        Purchase $purchase,
+    {
-        string $targetStatus,
+        $cart = $purchase->cart()->withTrashed()->lockForUpdate()->first();
-        ?Cart $cart,
-    ): void {
         try {
             $this->reservations->releaseForPurchase(
                 $purchase,
@@ -142,40 +140,28 @@ class ReleaseCheckoutService
             return;
         }
 
-        if ($targetStatus === Purchase::STATUS_EXPIRED
+        if ($cart->status === 'active') {
-            && in_array($cart->status, [Cart::STATUS_ACTIVE, Cart::STATUS_CHECKOUT], true)) {
             Cart::query()
                 ->whereKey($cart->getKey())
                 ->where('current_purchase_id', $purchase->getKey())
-                ->where('current_stock_reservation_id', $purchase->stock_reservation_id)
                 ->update([
-                    'status' => Cart::STATUS_EXPIRED,
                     'current_purchase_id' => null,
+                    'current_stock_reservation_id' => null,
                 ]);
 
-            return;
+            if ($targetStatus === Purchase::STATUS_CANCELLED) {
-        }
+                $this->reservations->syncCart($cart);
-
+            }
-        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) {
+        if ($cart->status !== 'checkout') {
             return;
         }
 
         if (! $cart->trashed()) {
-            $cart->update(['status' => Cart::STATUS_CONVERTED]);
+            $cart->update(['status' => 'converted']);
             $cart->delete();
         }
     }
@@ -225,17 +211,6 @@ class ReleaseCheckoutService
 
     private function loadPurchase(Purchase $purchase): Purchase
     {
-        return $purchase->load(['items.imageAttachment', 'stockReservation']);
+        return $purchase->load(['items.imageAttachment']);
-    }
-
-    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();
     }
 }

app/Domains/Purchase/Services/Checkout/StartCheckoutService.php

@@ -4,7 +4,6 @@ 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;
@@ -13,7 +12,6 @@ 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;
@@ -206,7 +204,7 @@ class StartCheckoutService
             $cart->getKey(),
         );
         $cart->update(['current_purchase_id' => $purchase->getKey()]);
-        $this->reservations->attachToPurchase($cart, $purchase, $this->checkoutExpiration());
+        $this->reservations->attachToPurchase($cart, $purchase);
 
         $cartItems = $cart->items()->orderBy('id')->lockForUpdate()->get();
         $this->loadCartItems($cartItems);
@@ -272,7 +270,7 @@ class StartCheckoutService
             $cart->getKey(),
         );
         $cart->update(['current_purchase_id' => $purchase->getKey()]);
-        $this->reservations->attachToPurchase($cart, $purchase, $this->checkoutExpiration());
+        $this->reservations->attachToPurchase($cart, $purchase);
         $purchase->items()->createMany($this->snapshots->fromCartItems($cartItems));
 
         return $this->loadPurchase($purchase);
@@ -315,9 +313,17 @@ class StartCheckoutService
             Purchase::STATUS_CREATED,
             Purchase::STATUS_PENDING_PAYMENT,
         ], true)) {
-            $this->reservations->returnToCart($currentPurchase, $cart);
             $currentPurchase->update([
                 'status' => Purchase::STATUS_SUPERSEDED,
+                'expires_at' => null,
+            ]);
+            $this->reservations->releaseForPurchase(
+                $currentPurchase,
+                reason: StockReservationService::REASON_PURCHASE_SUPERSEDED,
+            );
+            $cart->update([
+                'current_purchase_id' => null,
+                'current_stock_reservation_id' => null,
             ]);
         }
 
@@ -330,11 +336,7 @@ class StartCheckoutService
             throw new NotFoundHttpException('Cart not found for tenant.');
         }
 
-        if ($cart->status === Cart::STATUS_EXPIRED) {
+        if ($cart->status !== 'active') {
-            throw new StockReservationExpiredException;
-        }
-
-        if ($cart->status !== Cart::STATUS_ACTIVE) {
             throw ValidationException::withMessages([
                 'cart_id' => __('api.purchase.inactive_cart'),
             ]);
@@ -408,17 +410,13 @@ 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
     {

app/Domains/Purchase/Services/CheckoutService.php

@@ -2,6 +2,7 @@
 
 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;
@@ -22,6 +23,7 @@ class CheckoutService
         private readonly EditCheckoutService $editor,
         private readonly CompleteCheckoutService $completer,
         private readonly ReleaseCheckoutService $releaser,
+        private readonly StockReservationService $reservations,
     ) {}
 
     /** @param array<string, mixed> $purchaseData */
@@ -75,4 +77,14 @@ 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);
+    }
 }

app/Domains/Purchase/Services/DniDistanceService.php

@@ -1,82 +0,0 @@
-<?php
-
-namespace App\Domains\Purchase\Services;
-
-/**
- * Measures likely DNI typing errors using the optimal-string-alignment
- * variant of the Damerau-Levenshtein distance.
- *
- * The returned value is the minimum number of single-character edits needed
- * to transform one DNI into the other. Supported edits are insertion,
- * deletion, substitution and transposition of two adjacent digits.
- */
-class DniDistanceService
-{
-    /**
-     * Calculate the edit distance between two normalized DNI strings.
-     *
-     * Each matrix cell [row][column] stores the minimum edits required to
-     * transform the first $row digits of $left into the first $column digits
-     * of $right. The bottom-right cell therefore contains the final distance.
-     */
-    public function distance(string $left, string $right): int
-    {
-        $left = $this->normalize($left);
-        $right = $this->normalize($right);
-        $leftLength = strlen($left);
-        $rightLength = strlen($right);
-        $matrix = [];
-
-        // Transforming a prefix into an empty string requires deleting every digit.
-        for ($row = 0; $row <= $leftLength; $row++) {
-            $matrix[$row] = [$row];
-        }
-
-        // Transforming an empty string into a prefix requires inserting every digit.
-        for ($column = 0; $column <= $rightLength; $column++) {
-            $matrix[0][$column] = $column;
-        }
-
-        for ($row = 1; $row <= $leftLength; $row++) {
-            for ($column = 1; $column <= $rightLength; $column++) {
-                $substitutionCost = $left[$row - 1] === $right[$column - 1] ? 0 : 1;
-                $deletionDistance = $matrix[$row - 1][$column] + 1;
-                $insertionDistance = $matrix[$row][$column - 1] + 1;
-                $substitutionDistance = $matrix[$row - 1][$column - 1] + $substitutionCost;
-
-                // Keep the cheapest way to align the two prefixes at this position.
-                $matrix[$row][$column] = min(
-                    $deletionDistance,
-                    $insertionDistance,
-                    $substitutionDistance,
-                );
-
-                // Count two adjacent inverted digits as one edit instead of two substitutions.
-                if (
-                    $row > 1
-                    && $column > 1
-                    && $left[$row - 1] === $right[$column - 2]
-                    && $left[$row - 2] === $right[$column - 1]
-                ) {
-                    $matrix[$row][$column] = min(
-                        $matrix[$row][$column],
-                        $matrix[$row - 2][$column - 2] + 1,
-                    );
-                }
-            }
-        }
-
-        return $matrix[$leftLength][$rightLength];
-    }
-
-    /**
-     * Keep only digits and left-pad seven-digit DNIs so comparisons preserve
-     * the leading zero that is present when the DNI is extracted from a CUIT.
-     */
-    public function normalize(string $dni): string
-    {
-        $digits = preg_replace('/\D+/', '', $dni) ?? '';
-
-        return str_pad($digits, 8, '0', STR_PAD_LEFT);
-    }
-}

app/Domains/Purchase/Services/PurchaseStateGuard.php

@@ -3,7 +3,6 @@
 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;
@@ -12,32 +11,15 @@ class PurchaseStateGuard
 {
     public function assertNotExpired(Purchase $purchase): void
     {
-        if ($purchase->status === Purchase::STATUS_EXPIRED) {
+        $hasExpiredStatus = $purchase->status === Purchase::STATUS_EXPIRED;
-            throw new PurchaseExpiredException;
+        $hasExpiredByTime = in_array($purchase->status, [
-        }
-
-        if (! in_array($purchase->status, [
             Purchase::STATUS_CREATED,
             Purchase::STATUS_PENDING_PAYMENT,
-        ], true)) {
+        ], true)
-            return;
+            && $purchase->expires_at !== null
-        }
+            && $purchase->expires_at->isPast();
 
-        /** @var StockReservation|null $reservation */
+        if ($hasExpiredStatus || $hasExpiredByTime) {
-        $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;
         }
     }

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`, y referencia la reserva que respaldó ese intento de checkout. No guarda un vencimiento propio: expira como consecuencia del vencimiento de su reserva.
+- `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.
 - `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.
@@ -18,13 +18,13 @@ Implementa el ciclo de compra y checkout: crea la cabecera de compra desde un ca
 - `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 o vence una compra y aplica sus efectos comerciales; el scanner unificado del dominio Catalog detecta las reservas pendientes de vencimiento.
+- `ReleaseCheckoutService`: cancela, vence y procesa vencimientos pendientes.
 - `SourceCartService`: sincroniza o finaliza el carrito de checkout asociado a la compra.
 - `CatalogSelectionResolver` y `PurchaseItemSnapshotFactory`: resuelven selecciones y generan snapshots.
 
-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.
+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.
 
-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.
+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, libera su reserva completa y crea otra para 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.
 

app/Domains/Sale/Controllers/AdminApp/SaleController.php

@@ -3,28 +3,24 @@
 namespace App\Domains\Sale\Controllers\AdminApp;
 
 use App\Domains\Sale\Requests\AdminAppSaleIndexRequest;
-use App\Domains\Sale\Requests\AdminAppSaleModificationIndexRequest;
 use App\Domains\Sale\Requests\AdminAppSaleModificationPdfRequest;
 use App\Domains\Sale\Requests\AdminAppSalePdfRequest;
 use App\Domains\Sale\Resources\AdminApp\SaleDetailResource;
 use App\Domains\Sale\Resources\AdminApp\SaleModificationResource;
 use App\Domains\Sale\Resources\AdminApp\SaleResource;
 use App\Domains\Sale\Resources\AdminApp\SaleTicketResource;
-use App\Domains\Sale\Services\AdminAppSaleExcelService;
 use App\Domains\Sale\Services\AdminAppSalePdfService;
 use App\Domains\Sale\Services\AdminAppSaleService;
 use App\Http\Controllers\Controller;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
 use Illuminate\Http\Response;
-use Symfony\Component\HttpFoundation\StreamedResponse;
 
 class SaleController extends Controller
 {
     public function __construct(
         protected AdminAppSaleService $saleService,
         protected AdminAppSalePdfService $salePdfService,
-        protected AdminAppSaleExcelService $saleExcelService,
     ) {}
 
     public function index(AdminAppSaleIndexRequest $request): AnonymousResourceCollection
@@ -68,13 +64,11 @@ class SaleController extends Controller
         return new SaleResource($this->saleService->cancel($tenant, $sale));
     }
 
-    public function modifications(
+    public function modifications(Request $request): AnonymousResourceCollection
-        AdminAppSaleModificationIndexRequest $request,
+    {
-    ): AnonymousResourceCollection {
         return SaleModificationResource::collection(
             $this->saleService->modifications(
-                $request->user()->tenant()->firstOrFail(),
+                $request->user()->tenant()->firstOrFail()
-                $request->validated(),
             )
         );
     }
@@ -96,30 +90,7 @@ class SaleController extends Controller
 
         return $this->salePdfService->downloadModifications(
             $tenant,
-            $this->saleService->modificationsForExport($tenant, $request->validated()),
+            $this->saleService->modificationsForExport($tenant),
-            $request->validated('timezone'),
-        );
-    }
-
-    public function downloadExcel(AdminAppSalePdfRequest $request): StreamedResponse
-    {
-        $tenant = $request->user()->tenant()->firstOrFail();
-
-        return $this->saleExcelService->downloadSales(
-            $tenant,
-            $this->saleService->salesForExport($tenant, $request->validated()),
-            $request->validated('timezone'),
-        );
-    }
-
-    public function downloadModificationsExcel(
-        AdminAppSaleModificationPdfRequest $request,
-    ): StreamedResponse {
-        $tenant = $request->user()->tenant()->firstOrFail();
-
-        return $this->saleExcelService->downloadModifications(
-            $tenant,
-            $this->saleService->modificationsForExport($tenant, $request->validated()),
             $request->validated('timezone'),
         );
     }

app/Domains/Sale/Requests/AdminAppSaleIndexRequest.php

@@ -20,7 +20,7 @@ class AdminAppSaleIndexRequest extends FormRequest
             'q' => ['sometimes', 'nullable', 'string', 'max:255'],
             'id' => ['sometimes', 'nullable', 'integer', 'min:1'],
             'sale_date' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
-            'status' => ['sometimes', 'nullable', 'string', Rule::in(Purchase::adminStatusCodes())],
+            'status' => ['sometimes', 'nullable', 'string', Rule::in(Purchase::statuses())],
             'sort_by' => ['sometimes', 'string', 'in:id,date,customer_name,quantity,status,total'],
             'sort_direction' => ['sometimes', 'string', 'in:asc,desc'],
             'page' => ['sometimes', 'integer', 'min:1'],

app/Domains/Sale/Requests/AdminAppSaleModificationIndexRequest.php

@@ -1,16 +0,0 @@
-<?php
-
-namespace App\Domains\Sale\Requests;
-
-class AdminAppSaleModificationIndexRequest extends AdminAppSaleIndexRequest
-{
-    /** @return array<string, list<string>> */
-    public function rules(): array
-    {
-        $rules = parent::rules();
-
-        unset($rules['sort_by'], $rules['sort_direction']);
-
-        return $rules;
-    }
-}

app/Domains/Sale/Requests/AdminAppSaleModificationPdfRequest.php

@@ -3,14 +3,19 @@
 namespace App\Domains\Sale\Requests;
 
 use App\Domains\Shared\Rules\ValidTimezone;
+use Illuminate\Foundation\Http\FormRequest;
 
-class AdminAppSaleModificationPdfRequest extends AdminAppSaleModificationIndexRequest
+class AdminAppSaleModificationPdfRequest extends FormRequest
 {
+    public function authorize(): bool
+    {
+        return true;
+    }
+
     /** @return array<string, list<string>> */
     public function rules(): array
     {
         return [
-            ...parent::rules(),
             'timezone' => ['required', 'string', new ValidTimezone],
         ];
     }

app/Domains/Sale/Resources/AdminApp/SaleModificationResource.php

@@ -23,12 +23,6 @@ class SaleModificationResource extends JsonResource
             'attribute' => $this->attribute,
             'old_value' => $this->old_value,
             'new_value' => $this->new_value,
-            'admin_status' => is_string($this->new_value)
-                ? Purchase::adminStatusFor($this->new_value)
-                : null,
-            'status_label' => is_string($this->new_value)
-                ? Purchase::adminStatusNameFor($this->new_value)
-                : null,
             'changed_at' => $this->changed_at->utc()->toIso8601String(),
             'date' => $this->changed_at->format('Y-m-d'),
             'time' => $this->changed_at->format('H:i:s'),
@@ -37,8 +31,6 @@ class SaleModificationResource extends JsonResource
                 'id' => $sale->id,
                 'customer_name' => $sale->nombre_apellido,
                 'status' => $sale->status,
-                'admin_status' => Purchase::adminStatusFor($sale->status),
-                'status_label' => Purchase::adminStatusNameFor($sale->status),
             ] : null,
             'modified_by' => $user ? [
                 'id' => $user->id,

app/Domains/Sale/Resources/AdminApp/SaleResource.php

@@ -20,8 +20,6 @@ class SaleResource extends JsonResource
             'customer_name' => $this->nombre_apellido,
             'quantity' => (int) ($this->quantity ?? 0),
             'status' => $this->status,
-            'admin_status' => Purchase::adminStatusFor($this->status),
-            'status_label' => Purchase::adminStatusNameFor($this->status),
             'total' => number_format((float) $this->total, 2, '.', ''),
             'tickets_count' => $ticketsCount,
             'has_generated_tickets' => $ticketsCount > 0,

app/Domains/Sale/Services/AdminAppSaleExcelService.php

@@ -1,206 +0,0 @@
-<?php
-
-namespace App\Domains\Sale\Services;
-
-use App\Domains\Logging\Models\ValueChange;
-use App\Domains\Purchase\Models\Purchase;
-use App\Domains\Tenant\Models\Tenant;
-use Illuminate\Support\Collection;
-use PhpOffice\PhpSpreadsheet\Cell\DataType;
-use PhpOffice\PhpSpreadsheet\Shared\Date;
-use PhpOffice\PhpSpreadsheet\Spreadsheet;
-use PhpOffice\PhpSpreadsheet\Style\Alignment;
-use PhpOffice\PhpSpreadsheet\Style\Fill;
-use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
-use Symfony\Component\HttpFoundation\StreamedResponse;
-
-class AdminAppSaleExcelService
-{
-    /** @param Collection<int, Purchase> $sales */
-    public function downloadSales(Tenant $tenant, Collection $sales, string $timeZone): StreamedResponse
-    {
-        $generatedAt = now();
-        $spreadsheet = $this->spreadsheet($tenant, 'Historial de ventas');
-        $sheet = $spreadsheet->getActiveSheet();
-        $sheet->setTitle('Ventas');
-        $sheet->fromArray([
-            'ID',
-            'Fecha',
-            'Cliente',
-            'Cantidad',
-            'Estado',
-            'Importe',
-            'Tickets',
-        ], null, 'A1');
-
-        foreach ($sales->values() as $index => $sale) {
-            $row = $index + 2;
-            $sheet->setCellValueExplicit("A{$row}", '#'.$sale->id, DataType::TYPE_STRING);
-            if ($sale->created_at) {
-                $sheet->setCellValue(
-                    "B{$row}",
-                    Date::dateTimeToExcel($sale->created_at->copy()->timezone($timeZone)),
-                );
-            }
-            $sheet->setCellValueExplicit(
-                "C{$row}",
-                $sale->nombre_apellido ?: 'Sin nombre',
-                DataType::TYPE_STRING,
-            );
-            $sheet->setCellValue("D{$row}", (int) ($sale->quantity ?? 0));
-            $sheet->setCellValue("E{$row}", $this->saleStatus($sale->status));
-            $sheet->setCellValue("F{$row}", (float) $sale->total);
-            $sheet->setCellValue("G{$row}", (int) ($sale->tickets_count ?? 0));
-        }
-
-        $lastRow = max(2, $sales->count() + 1);
-        $sheet->getStyle("B2:B{$lastRow}")->getNumberFormat()->setFormatCode('dd/mm/yyyy hh:mm');
-        $sheet->getStyle("F2:F{$lastRow}")->getNumberFormat()->setFormatCode('$ #,##0.00');
-        $this->formatSheet($spreadsheet, 'A1:G1', "A1:G{$lastRow}", [
-            'A' => 13,
-            'B' => 20,
-            'C' => 32,
-            'D' => 12,
-            'E' => 22,
-            'F' => 16,
-            'G' => 12,
-        ]);
-
-        return $this->download(
-            $spreadsheet,
-            'ventas_'.$tenant->codigo.'_'
-                .$generatedAt->copy()->timezone($timeZone)->format('Ymd_His').'.xlsx',
-        );
-    }
-
-    /** @param Collection<int, ValueChange> $modifications */
-    public function downloadModifications(
-        Tenant $tenant,
-        Collection $modifications,
-        string $timeZone,
-    ): StreamedResponse {
-        $generatedAt = now();
-        $spreadsheet = $this->spreadsheet($tenant, 'Historial de modificaciones de ventas');
-        $sheet = $spreadsheet->getActiveSheet();
-        $sheet->setTitle('Modificaciones');
-        $sheet->fromArray([
-            'Fecha',
-            'Hora',
-            'Venta',
-            'Cliente',
-            'Campo',
-            'Valor anterior',
-            'Valor nuevo',
-            'Modificado por',
-        ], null, 'A1');
-
-        foreach ($modifications->values() as $index => $modification) {
-            $row = $index + 2;
-            $changedAt = $modification->changed_at->copy()->timezone($timeZone);
-            $sale = $modification->trackable;
-            $sheet->setCellValue("A{$row}", Date::dateTimeToExcel($changedAt));
-            $sheet->setCellValue("B{$row}", Date::dateTimeToExcel($changedAt));
-            $sheet->setCellValueExplicit(
-                "C{$row}",
-                '#'.$modification->trackable_id,
-                DataType::TYPE_STRING,
-            );
-            $sheet->setCellValueExplicit(
-                "D{$row}",
-                $sale?->nombre_apellido ?: 'Sin nombre',
-                DataType::TYPE_STRING,
-            );
-            $sheet->setCellValueExplicit(
-                "E{$row}",
-                $modification->attribute,
-                DataType::TYPE_STRING,
-            );
-            $sheet->setCellValueExplicit(
-                "F{$row}",
-                $modification->old_value ?? '-',
-                DataType::TYPE_STRING,
-            );
-            $sheet->setCellValueExplicit(
-                "G{$row}",
-                $modification->new_value ?? '-',
-                DataType::TYPE_STRING,
-            );
-            $sheet->setCellValueExplicit(
-                "H{$row}",
-                $modification->user?->nombre_apellido ?? 'Sistema',
-                DataType::TYPE_STRING,
-            );
-        }
-
-        $lastRow = max(2, $modifications->count() + 1);
-        $sheet->getStyle("A2:A{$lastRow}")->getNumberFormat()->setFormatCode('dd/mm/yyyy');
-        $sheet->getStyle("B2:B{$lastRow}")->getNumberFormat()->setFormatCode('hh:mm:ss');
-        $this->formatSheet($spreadsheet, 'A1:H1', "A1:H{$lastRow}", [
-            'A' => 14,
-            'B' => 12,
-            'C' => 13,
-            'D' => 32,
-            'E' => 20,
-            'F' => 24,
-            'G' => 24,
-            'H' => 28,
-        ]);
-
-        return $this->download(
-            $spreadsheet,
-            'historial_modificaciones_'.$tenant->codigo.'_'
-                .$generatedAt->copy()->timezone($timeZone)->format('Ymd_His').'.xlsx',
-        );
-    }
-
-    private function spreadsheet(Tenant $tenant, string $title): Spreadsheet
-    {
-        $spreadsheet = new Spreadsheet;
-        $spreadsheet->getProperties()
-            ->setCreator('Shopit')
-            ->setTitle($title)
-            ->setSubject($tenant->nombre);
-
-        return $spreadsheet;
-    }
-
-    /** @param array<string, int> $widths */
-    private function formatSheet(
-        Spreadsheet $spreadsheet,
-        string $headerRange,
-        string $filterRange,
-        array $widths,
-    ): void {
-        $sheet = $spreadsheet->getActiveSheet();
-        $sheet->getStyle($headerRange)->applyFromArray([
-            'font' => ['bold' => true, 'color' => ['rgb' => 'FFFFFF']],
-            'fill' => [
-                'fillType' => Fill::FILL_SOLID,
-                'startColor' => ['rgb' => '26382E'],
-            ],
-            'alignment' => ['vertical' => Alignment::VERTICAL_CENTER],
-        ]);
-        $sheet->getRowDimension(1)->setRowHeight(24);
-        $sheet->freezePane('A2');
-        $sheet->setAutoFilter($filterRange);
-
-        foreach ($widths as $column => $width) {
-            $sheet->getColumnDimension($column)->setWidth($width);
-        }
-    }
-
-    private function download(Spreadsheet $spreadsheet, string $filename): StreamedResponse
-    {
-        return response()->streamDownload(function () use ($spreadsheet): void {
-            (new Xlsx($spreadsheet))->save('php://output');
-            $spreadsheet->disconnectWorksheets();
-        }, $filename, [
-            'Content-Type' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-        ]);
-    }
-
-    private function saleStatus(string $status): string
-    {
-        return Purchase::adminStatusNameFor($status) ?? $status;
-    }
-}

app/Domains/Sale/Services/AdminAppSaleService.php

@@ -92,24 +92,18 @@ class AdminAppSaleService
         return $this->salesQuery($tenant, $filters)->get();
     }
 
-    /**
+    /** @return LengthAwarePaginator<ValueChange> */
-     * @param  array<string, mixed>  $filters
+    public function modifications(Tenant $tenant): LengthAwarePaginator
-     * @return LengthAwarePaginator<ValueChange>
-     */
-    public function modifications(Tenant $tenant, array $filters = []): LengthAwarePaginator
     {
-        return $this->modificationsQuery($tenant, $filters)
+        return $this->modificationsQuery($tenant)
             ->paginateFromRequest()
             ->withQueryString();
     }
 
-    /**
+    /** @return Collection<int, ValueChange> */
-     * @param  array<string, mixed>  $filters
+    public function modificationsForExport(Tenant $tenant): Collection
-     * @return Collection<int, ValueChange>
-     */
-    public function modificationsForExport(Tenant $tenant, array $filters = []): Collection
     {
-        return $this->modificationsQuery($tenant, $filters)->get();
+        return $this->modificationsQuery($tenant)->get();
     }
 
     /** @param array<string, mixed> $filters */
@@ -132,6 +126,7 @@ class AdminAppSaleService
 
         return Purchase::query()
             ->where('tenant_codigo', $tenant->codigo)
+            ->where('status', '!=', Purchase::STATUS_SUPERSEDED)
             ->when($filters['q'] ?? null, function (Builder $query, string $search): void {
                 $term = trim($search);
 
@@ -149,10 +144,12 @@ class AdminAppSaleService
             )
             ->when(
                 $filters['status'] ?? null,
-                fn (Builder $query, string $status): Builder => $query->whereIn(
+                fn (Builder $query, string $status): Builder => $status === Purchase::STATUS_PENDING_PAYMENT
-                    'status',
+                    ? $query->whereIn('status', [
-                    Purchase::realStatusesForAdminStatus($status),
+                        Purchase::STATUS_PENDING_PAYMENT,
-                )
+                        Purchase::STATUS_IN_REVIEW,
+                    ])
+                    : $query->where('status', $status)
             )
             ->select('compras.*')
             ->selectRaw(
@@ -165,50 +162,12 @@ class AdminAppSaleService
             ->when($sortBy !== 'id', fn (Builder $query): Builder => $query->orderByDesc('id'));
     }
 
-    /**
+    /** @return Builder<ValueChange> */
-     * @param  array<string, mixed>  $filters
+    protected function modificationsQuery(Tenant $tenant): Builder
-     * @return Builder<ValueChange>
-     */
-    protected function modificationsQuery(Tenant $tenant, array $filters): Builder
     {
         return ValueChange::query()
             ->where('tenant_code', $tenant->codigo)
             ->where('trackable_type', (new Purchase)->getMorphClass())
-            ->when($filters['q'] ?? null, function (Builder $query, string $search): void {
-                $term = trim($search);
-
-                $query->where(function (Builder $query) use ($term): void {
-                    $query
-                        ->where('trackable_id', 'like', "%{$term}%")
-                        ->orWhereHasMorph(
-                            'trackable',
-                            [Purchase::class],
-                            function (Builder $sales) use ($term): void {
-                                $sales
-                                    ->where('nombre_apellido', 'like', "%{$term}%")
-                                    ->orWhere('created_at', 'like', "%{$term}%");
-                            },
-                        );
-                });
-            })
-            ->when(
-                $filters['id'] ?? null,
-                fn (Builder $query, int $id): Builder => $query->where('trackable_id', $id)
-            )
-            ->when(
-                $filters['sale_date'] ?? null,
-                fn (Builder $query, string $date): Builder => $query->whereHasMorph(
-                    'trackable',
-                    [Purchase::class],
-                    fn (Builder $sales): Builder => $sales->whereDate('created_at', $date),
-                )
-            )
-            ->when(
-                $filters['status'] ?? null,
-                fn (Builder $query, string $status): Builder => $query
-                    ->where('attribute', 'status')
-                    ->whereIn('new_value', Purchase::realStatusesForAdminStatus($status))
-            )
             ->with(['trackable', 'user'])
             ->orderByDesc('changed_at')
             ->orderByDesc('id');

app/Domains/Sale/documentacion/README.md

@@ -8,9 +8,7 @@ Provee consultas administrativas y exportaciones de ventas confirmadas, además
 
 - `AdminAppSaleService`: pagina ventas, calcula totales y obtiene colecciones para exportación; también consulta modificaciones.
 - `AdminAppSalePdfService`: genera descargas PDF de ventas y de cambios.
-- `AdminAppSaleExcelService`: genera descargas Excel de ventas y de cambios.
+- `AdminAppSaleIndexRequest`: valida filtros del listado y la exportación.
-- `AdminAppSaleIndexRequest`: valida filtros del listado y la exportación de ventas.
-- `AdminAppSaleModificationIndexRequest`: valida los filtros compartidos por el historial y sus exportaciones.
 - `SaleResource` y `SaleModificationResource`: representan ventas e historial para AdminApp.
 - `SaleController`: entrada HTTP del panel.
 
@@ -18,8 +16,8 @@ Provee consultas administrativas y exportaciones de ventas confirmadas, además
 
 Bajo `/v1/adminapp/tenant`, protegidos por `auth:sanctum` y `adminapp.tenant`:
 
-- `GET /sales`, `GET /sales/pdf` y `GET /sales/excel`.
+- `GET /sales` y `GET /sales/pdf`.
-- `GET /sales/modifications`, `GET /sales/modifications/pdf` y `GET /sales/modifications/excel`.
+- `GET /sales/modifications` y `GET /sales/modifications/pdf`.
 
 ## Dependencias
 
@@ -27,6 +25,4 @@ Consume compras de `Purchase`, datos del tenant y entradas de `Logging`. No es d
 
 ## Consideraciones
 
-La consulta paginada y la colección de exportación deben aplicar los mismos filtros para evitar diferencias entre pantalla, PDF y Excel.
+La consulta paginada y la colección de exportación deben aplicar los mismos filtros para evitar diferencias entre pantalla y PDF.
-
-El historial comparte con ventas los filtros de búsqueda, ID, fecha de venta y estado. En el historial, el estado se evalúa sobre `ValueChange.new_value`: representa el resultado de esa modificación y no el estado actual de la venta.

app/Domains/Sale/routes/adminapp.php

@@ -8,10 +8,8 @@ Route::prefix('v1/adminapp/tenant')
     ->group(function (): void {
         Route::get('sales', [SaleController::class, 'index']);
         Route::get('sales/pdf', [SaleController::class, 'downloadPdf']);
-        Route::get('sales/excel', [SaleController::class, 'downloadExcel']);
         Route::get('sales/modifications', [SaleController::class, 'modifications']);
         Route::get('sales/modifications/pdf', [SaleController::class, 'downloadModificationsPdf']);
-        Route::get('sales/modifications/excel', [SaleController::class, 'downloadModificationsExcel']);
         Route::post('sales/{sale}/confirm', [SaleController::class, 'confirm'])->whereNumber('sale');
         Route::post('sales/{sale}/cancel', [SaleController::class, 'cancel'])->whereNumber('sale');
         Route::get('sales/{sale}/tickets', [SaleController::class, 'tickets'])->whereNumber('sale');

app/Domains/Tenant/Services/WebsiteTypeService.php

@@ -82,7 +82,6 @@ class WebsiteTypeService
                     && $previousLogo->id !== $websiteType->site_logo
                     && $previousLogo->id !== $websiteType->footer_logo
                     && $previousLogo->id !== $websiteType->favicon_id
-                    && ! $this->isReferencedByWebsiteType($previousLogo)
                 ) {
                     $this->attachmentService->delete($previousLogo);
                 }
@@ -91,16 +90,4 @@ class WebsiteTypeService
             return $websiteType;
         });
     }
-
-    private function isReferencedByWebsiteType(Attachment $attachment): bool
-    {
-        return WebsiteType::query()
-            ->where(function ($query) use ($attachment): void {
-                $query
-                    ->where('site_logo', $attachment->id)
-                    ->orWhere('footer_logo', $attachment->id)
-                    ->orWhere('favicon_id', $attachment->id);
-            })
-            ->exists();
-    }
 }

app/Domains/Ticket/Controllers/AdminApp/TicketController.php

@@ -1,53 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Controllers\AdminApp;
-
-use App\Domains\Ticket\Requests\AdminAppTicketExportRequest;
-use App\Domains\Ticket\Requests\AdminAppTicketIndexRequest;
-use App\Domains\Ticket\Resources\AdminApp\AdminAppTicketCollection;
-use App\Domains\Ticket\Services\AdminAppTicketExcelService;
-use App\Domains\Ticket\Services\AdminAppTicketPdfService;
-use App\Domains\Ticket\Services\AdminAppTicketService;
-use App\Http\Controllers\Controller;
-use Illuminate\Http\Response;
-use Symfony\Component\HttpFoundation\StreamedResponse;
-
-class TicketController extends Controller
-{
-    public function __construct(
-        private readonly AdminAppTicketService $ticketService,
-        private readonly AdminAppTicketPdfService $ticketPdfService,
-        private readonly AdminAppTicketExcelService $ticketExcelService,
-    ) {}
-
-    public function index(AdminAppTicketIndexRequest $request): AdminAppTicketCollection
-    {
-        $tenant = $request->user()->tenant()->firstOrFail();
-
-        return new AdminAppTicketCollection(
-            $this->ticketService->search($tenant, $request->validated())
-        );
-    }
-
-    public function downloadPdf(AdminAppTicketExportRequest $request): Response
-    {
-        $tenant = $request->user()->tenant()->firstOrFail();
-
-        return $this->ticketPdfService->download(
-            $tenant,
-            $this->ticketService->ticketsForExport($tenant, $request->validated()),
-            $request->validated('timezone'),
-        );
-    }
-
-    public function downloadExcel(AdminAppTicketExportRequest $request): StreamedResponse
-    {
-        $tenant = $request->user()->tenant()->firstOrFail();
-
-        return $this->ticketExcelService->download(
-            $tenant,
-            $this->ticketService->ticketsForExport($tenant, $request->validated()),
-            $request->validated('timezone'),
-        );
-    }
-}

app/Domains/Ticket/Listeners/GenerateTicketsForPaidPurchase.php

@@ -3,8 +3,8 @@
 namespace App\Domains\Ticket\Listeners;
 
 use App\Domains\Catalog\Models\CatalogItem;
+use App\Domains\Notification\Events\TicketsAvailable;
 use App\Domains\Purchase\Events\PurchasePaid;
-use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Ticket\Exceptions\TicketGenerationException;
 use App\Domains\Ticket\Services\TicketGeneratorService;
 
@@ -16,10 +16,13 @@ class GenerateTicketsForPaidPurchase
 
     public function handle(PurchasePaid $event): void
     {
-        $purchase = Purchase::query()
+        $purchase = $event->purchase
+            ->newQuery()
             ->with(['user', 'items'])
-            ->findOrFail($event->purchaseId);
+            ->findOrFail($event->purchase->getKey());
         $user = $purchase->user;
+        $ticketIds = [];
+
         foreach ($purchase->items as $purchaseItem) {
             $catalogItem = CatalogItem::query()
                 ->where('tenant_code', $purchase->tenant_codigo)
@@ -37,13 +40,19 @@ class GenerateTicketsForPaidPurchase
                 throw TicketGenerationException::purchaseWithoutUser($purchase);
             }
 
-            $this->ticketGenerator->generate(
+            $generatedTickets = $this->ticketGenerator->generate(
                 $catalogItem,
                 $user,
                 $purchaseItem->cantidad,
                 $purchaseItem->source_variant_id,
-                $purchaseItem->getKey(),
+                $purchase->getKey(),
             );
+
+            array_push($ticketIds, ...$generatedTickets->pluck('id')->all());
+        }
+
+        if ($ticketIds !== []) {
+            TicketsAvailable::dispatch($purchase, $ticketIds);
         }
     }
 

app/Domains/Ticket/Models/Ticket.php

@@ -5,7 +5,7 @@ namespace App\Domains\Ticket\Models;
 use App\Domains\Auth\Models\User;
 use App\Domains\Catalog\Models\CatalogItem;
 use App\Domains\Catalog\Models\Variant;
-use App\Domains\Purchase\Models\PurchaseItem;
+use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Tenant\Models\Tenant;
 use App\Domains\Ticket\Services\ResolvedTicketValidity;
 use App\Domains\Ticket\Services\ResolvedValidityGroup;
@@ -21,7 +21,7 @@ use Illuminate\Support\Collection;
 #[Fillable([
     'tenant_code',
     'ticket',
-    'source_purchase_item_id',
+    'source_purchase_id',
     'source_catalog_item_id',
     'source_variant_id',
     'used_at',
@@ -56,7 +56,7 @@ class Ticket extends Model
         return [
             'source_catalog_item_id' => 'integer',
             'source_variant_id' => 'integer',
-            'source_purchase_item_id' => 'integer',
+            'source_purchase_id' => 'integer',
             'used_at' => 'datetime',
             'scanner_user_id' => 'integer',
             'user_id' => 'integer',
@@ -81,10 +81,10 @@ class Ticket extends Model
         return $this->belongsTo(User::class, 'scanner_user_id');
     }
 
-    /** @return BelongsTo<PurchaseItem, $this> */
+    /** @return BelongsTo<Purchase, $this> */
-    public function sourcePurchaseItem(): BelongsTo
+    public function sourcePurchase(): BelongsTo
     {
-        return $this->belongsTo(PurchaseItem::class, 'source_purchase_item_id');
+        return $this->belongsTo(Purchase::class, 'source_purchase_id');
     }
 
     /** @return BelongsTo<CatalogItem, $this> */

app/Domains/Ticket/Requests/AdminAppTicketExportRequest.php

@@ -1,17 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Requests;
-
-use App\Domains\Shared\Rules\ValidTimezone;
-
-class AdminAppTicketExportRequest extends AdminAppTicketIndexRequest
-{
-    /** @return array<string, mixed> */
-    public function rules(): array
-    {
-        return [
-            ...parent::rules(),
-            'timezone' => ['required', 'string', new ValidTimezone],
-        ];
-    }
-}

app/Domains/Ticket/Requests/AdminAppTicketIndexRequest.php

@@ -1,47 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Requests;
-
-use App\Domains\Ticket\Models\Ticket;
-use App\Domains\Ticket\Services\AdminAppTicketColumnService;
-use Illuminate\Foundation\Http\FormRequest;
-use Illuminate\Validation\Rule;
-
-class AdminAppTicketIndexRequest extends FormRequest
-{
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    /** @return array<string, list<string>> */
-    public function rules(): array
-    {
-        $tenant = $this->user()?->tenant()->first();
-        $sortableKeys = $tenant === null
-            ? []
-            : app(AdminAppTicketColumnService::class)->sortableKeys($tenant);
-
-        return [
-            'q' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'category' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'product' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'type' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'date' => ['sometimes', 'nullable', 'date_format:Y-m-d'],
-            'size' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'status' => [
-                'sometimes',
-                'nullable',
-                Rule::in([
-                    Ticket::STATUS_ACTIVE,
-                    Ticket::STATUS_USED,
-                    Ticket::STATUS_EXPIRED,
-                ]),
-            ],
-            'page' => ['sometimes', 'integer', 'min:1'],
-            'per_page' => ['sometimes', 'integer', 'min:1', 'max:100'],
-            'sort_by' => ['sometimes', 'nullable', 'string', Rule::in($sortableKeys)],
-            'sort_direction' => ['sometimes', 'nullable', 'string', Rule::in(['asc', 'desc'])],
-        ];
-    }
-}

app/Domains/Ticket/Resources/AdminApp/AdminAppTicketCollection.php

@@ -1,34 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Resources\AdminApp;
-
-use App\Domains\Ticket\Services\AdminAppTicketResult;
-use Illuminate\Http\Request;
-use Illuminate\Http\Resources\Json\ResourceCollection;
-
-class AdminAppTicketCollection extends ResourceCollection
-{
-    /** @var class-string<AdminAppTicketResource> */
-    public $collects = AdminAppTicketResource::class;
-
-    private readonly int $scannedTickets;
-
-    private readonly int $totalTickets;
-
-    public function __construct(AdminAppTicketResult $result)
-    {
-        parent::__construct($result->tickets);
-
-        $this->scannedTickets = $result->scannedTickets;
-        $this->totalTickets = $result->totalTickets;
-    }
-
-    /** @return array{scanned_tickets: int, total_tickets: int} */
-    public function with(Request $request): array
-    {
-        return [
-            'scanned_tickets' => $this->scannedTickets,
-            'total_tickets' => $this->totalTickets,
-        ];
-    }
-}

app/Domains/Ticket/Resources/AdminApp/AdminAppTicketResource.php

@@ -1,25 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Resources\AdminApp;
-
-use App\Domains\Ticket\Models\Ticket;
-use App\Domains\Ticket\Resources\TicketResource;
-use App\Domains\Ticket\Services\AdminAppTicketRowService;
-use Illuminate\Http\Request;
-
-/** @mixin Ticket */
-class AdminAppTicketResource extends TicketResource
-{
-    /** @return array<string, mixed> */
-    public function toArray(Request $request): array
-    {
-        $rowService = app(AdminAppTicketRowService::class);
-        $details = $rowService->details($this->resource);
-
-        return [
-            ...parent::toArray($request),
-            ...$details,
-            'values' => $rowService->values($this->resource, $details),
-        ];
-    }
-}

app/Domains/Ticket/Services/AdminAppTicketColumnService.php

@@ -1,103 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Services;
-
-use App\Domains\Tenant\Models\Tenant;
-
-class AdminAppTicketColumnService
-{
-    private const FIESTA_FUTBOL_INFANTIL = 'fiesta_futbol_infantil';
-
-    /** @return list<array{key: string, label: string, type: string, sortable: bool, sort_param: string, width: string, excel_width: int}> */
-    public function columns(Tenant $tenant): array
-    {
-        $keys = $tenant->codigo === self::FIESTA_FUTBOL_INFANTIL
-            ? ['order_number', 'category', 'product', 'type', 'date', 'size', 'amount', 'client', 'id', 'status', 'scanned_by']
-            : ['order_number', 'product', 'amount', 'client', 'id', 'status', 'scanned_by'];
-
-        $columns = array_map(fn (string $key): array => $this->definitions()[$key], $keys);
-
-        if ($tenant->codigo === self::FIESTA_FUTBOL_INFANTIL) {
-            $columns = array_map(function (array $column): array {
-                if (in_array($column['key'], ['product', 'type', 'date', 'size'], true)) {
-                    $column['sortable'] = false;
-                }
-
-                return $column;
-            }, $columns);
-        } else {
-            $widths = [
-                'order_number' => '11%',
-                'product' => '15%',
-                'amount' => '10%',
-                'client' => '15%',
-                'id' => '8%',
-                'status' => '8%',
-                'scanned_by' => '11%',
-            ];
-            $columns = array_map(function (array $column) use ($widths): array {
-                $column['width'] = $widths[$column['key']];
-
-                return $column;
-            }, $columns);
-        }
-
-        return $columns;
-    }
-
-    /** @return list<array{key: string, label: string, type: string, sortable: bool, sort_param: string, width: string}> */
-    public function publicColumns(Tenant $tenant): array
-    {
-        return array_map(function (array $column): array {
-            unset($column['excel_width']);
-
-            return $column;
-        }, $this->columns($tenant));
-    }
-
-    /** @return list<string> */
-    public function sortableKeys(Tenant $tenant): array
-    {
-        return array_values(array_map(
-            fn (array $column): string => $column['sort_param'],
-            array_filter($this->columns($tenant), fn (array $column): bool => $column['sortable']),
-        ));
-    }
-
-    /** @return array<string, array{key: string, label: string, type: string, sortable: bool, sort_param: string, width: string, excel_width: int}> */
-    private function definitions(): array
-    {
-        return [
-            'order_number' => $this->column('order_number', 'N° de orden', 'order_number', '10.5%', 14),
-            'category' => $this->column('category', 'Categoría', 'text', '11%', 18),
-            'product' => $this->column('product', 'Producto', 'text', '11%', 22),
-            'type' => $this->column('type', 'Tipo', 'text', '8%', 18),
-            'date' => $this->column('date', 'Fecha', 'text', '7%', 14),
-            'size' => $this->column('size', 'Talle', 'text', '6%', 12),
-            'amount' => $this->column('amount', 'Importe', 'currency', '8%', 15),
-            'client' => $this->column('client', 'Cliente', 'text', '11%', 30),
-            'id' => $this->column('id', 'ID', 'text', '6%', 12),
-            'status' => $this->column('status', 'Estado', 'status', '7%', 13),
-            'scanned_by' => $this->column('scanned_by', 'Escaneado por', 'text', '8%', 28),
-        ];
-    }
-
-    /** @return array{key: string, label: string, type: string, sortable: bool, sort_param: string, width: string, excel_width: int} */
-    private function column(
-        string $key,
-        string $label,
-        string $type,
-        string $width,
-        int $excelWidth,
-    ): array {
-        return [
-            'key' => $key,
-            'label' => $label,
-            'type' => $type,
-            'sortable' => true,
-            'sort_param' => $key,
-            'width' => $width,
-            'excel_width' => $excelWidth,
-        ];
-    }
-}

app/Domains/Ticket/Services/AdminAppTicketExcelService.php

@@ -1,105 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Services;
-
-use App\Domains\Tenant\Models\Tenant;
-use App\Domains\Ticket\Models\Ticket;
-use Carbon\CarbonInterface;
-use Illuminate\Support\Collection;
-use PhpOffice\PhpSpreadsheet\Cell\Coordinate;
-use PhpOffice\PhpSpreadsheet\Cell\DataType;
-use PhpOffice\PhpSpreadsheet\Shared\Date;
-use PhpOffice\PhpSpreadsheet\Spreadsheet;
-use PhpOffice\PhpSpreadsheet\Style\Alignment;
-use PhpOffice\PhpSpreadsheet\Style\Fill;
-use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
-use Symfony\Component\HttpFoundation\StreamedResponse;
-
-class AdminAppTicketExcelService
-{
-    public function __construct(
-        private readonly AdminAppTicketReportService $reportService,
-        private readonly AdminAppTicketColumnService $columnService,
-    ) {}
-
-    /** @param Collection<int, Ticket> $tickets */
-    public function download(Tenant $tenant, Collection $tickets, string $timeZone): StreamedResponse
-    {
-        $generatedAt = now();
-        $rows = $this->reportService->rows($tickets);
-        $columns = $this->columnService->columns($tenant);
-        $spreadsheet = new Spreadsheet;
-        $spreadsheet->getProperties()
-            ->setCreator('Shopit')
-            ->setTitle('Listado de tickets')
-            ->setSubject($tenant->nombre);
-        $sheet = $spreadsheet->getActiveSheet();
-        $sheet->setTitle('Tickets');
-        $sheet->fromArray([array_column($columns, 'label')], null, 'A1');
-
-        foreach ($rows as $index => $ticket) {
-            $row = $index + 2;
-            foreach ($columns as $columnIndex => $column) {
-                $coordinate = Coordinate::stringFromColumnIndex($columnIndex + 1).$row;
-                $value = $ticket[$column['key']] ?? null;
-
-                if ($column['type'] === 'currency' && $value !== null) {
-                    $sheet->setCellValue($coordinate, (float) $value);
-
-                    continue;
-                }
-
-                if ($column['type'] === 'date' && $value instanceof CarbonInterface) {
-                    $sheet->setCellValue(
-                        $coordinate,
-                        Date::dateTimeToExcel($value->copy()->timezone($timeZone)),
-                    );
-
-                    continue;
-                }
-
-                $sheet->setCellValueExplicit(
-                    $coordinate,
-                    $this->reportService->displayValue($value, $column['type'], $timeZone),
-                    DataType::TYPE_STRING,
-                );
-            }
-        }
-
-        $lastRow = max(2, $rows->count() + 1);
-        $lastColumn = Coordinate::stringFromColumnIndex(count($columns));
-        foreach ($columns as $columnIndex => $column) {
-            $letter = Coordinate::stringFromColumnIndex($columnIndex + 1);
-            if ($column['type'] === 'currency') {
-                $sheet->getStyle("{$letter}2:{$letter}{$lastRow}")
-                    ->getNumberFormat()->setFormatCode('$ #,##0.00');
-            }
-            if ($column['type'] === 'date') {
-                $sheet->getStyle("{$letter}2:{$letter}{$lastRow}")
-                    ->getNumberFormat()->setFormatCode('dd/mm/yyyy hh:mm');
-            }
-            $sheet->getColumnDimension($letter)->setWidth($column['excel_width']);
-        }
-        $sheet->getStyle("A1:{$lastColumn}1")->applyFromArray([
-            'font' => ['bold' => true, 'color' => ['rgb' => 'FFFFFF']],
-            'fill' => [
-                'fillType' => Fill::FILL_SOLID,
-                'startColor' => ['rgb' => '26382E'],
-            ],
-            'alignment' => ['vertical' => Alignment::VERTICAL_CENTER],
-        ]);
-        $sheet->getRowDimension(1)->setRowHeight(24);
-        $sheet->freezePane('A2');
-        $sheet->setAutoFilter("A1:{$lastColumn}{$lastRow}");
-
-        $filename = 'tickets_'.$tenant->codigo.'_'
-            .$generatedAt->copy()->timezone($timeZone)->format('Ymd_His').'.xlsx';
-
-        return response()->streamDownload(function () use ($spreadsheet): void {
-            (new Xlsx($spreadsheet))->save('php://output');
-            $spreadsheet->disconnectWorksheets();
-        }, $filename, [
-            'Content-Type' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-        ]);
-    }
-}

app/Domains/Ticket/Services/AdminAppTicketPdfService.php

@@ -1,56 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Services;
-
-use App\Domains\Tenant\Models\Tenant;
-use App\Domains\Ticket\Models\Ticket;
-use Barryvdh\DomPDF\Facade\Pdf;
-use Barryvdh\DomPDF\PDF as DomPdf;
-use Illuminate\Http\Response;
-use Illuminate\Support\Collection;
-
-class AdminAppTicketPdfService
-{
-    public function __construct(
-        private readonly AdminAppTicketReportService $reportService,
-        private readonly AdminAppTicketColumnService $columnService,
-    ) {}
-
-    /** @param Collection<int, Ticket> $tickets */
-    public function download(Tenant $tenant, Collection $tickets, string $timeZone): Response
-    {
-        $generatedAt = now();
-        $columns = $this->columnService->columns($tenant);
-        $rows = $this->reportService->rows($tickets);
-        $pdf = Pdf::loadView('pdf.adminapp.tickets', [
-            'tenant' => $tenant,
-            'columns' => $columns,
-            'tickets' => $this->reportService->displayRows($rows, $columns, $timeZone),
-            'generatedAt' => $generatedAt,
-            'timeZone' => $timeZone,
-        ])->setPaper('a3', 'landscape');
-
-        $this->addPageNumbers($pdf);
-
-        return $pdf->download(
-            'tickets_'.$tenant->codigo.'_'
-            .$generatedAt->copy()->timezone($timeZone)->format('Ymd_His').'.pdf'
-        );
-    }
-
-    private function addPageNumbers(DomPdf $pdf): void
-    {
-        $pdf->render();
-        $domPdf = $pdf->getDomPDF();
-        $font = $domPdf->getFontMetrics()->getFont('DejaVu Sans');
-
-        $domPdf->getCanvas()->page_text(
-            565,
-            805,
-            'Página {PAGE_NUM} de {PAGE_COUNT}',
-            $font,
-            7,
-            [0.48, 0.52, 0.49],
-        );
-    }
-}

app/Domains/Ticket/Services/AdminAppTicketReportService.php

@@ -1,35 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Services;
-
-use App\Domains\Ticket\Models\Ticket;
-use Illuminate\Support\Collection;
-
-class AdminAppTicketReportService
-{
-    public function __construct(private readonly AdminAppTicketRowService $rowService) {}
-
-    /**
-     * @param  Collection<int, Ticket>  $tickets
-     * @return Collection<int, array<string, mixed>>
-     */
-    public function rows(Collection $tickets): Collection
-    {
-        return $this->rowService->rows($tickets);
-    }
-
-    /**
-     * @param  Collection<int, array<string, mixed>>  $rows
-     * @param  list<array<string, mixed>>  $columns
-     * @return Collection<int, array<string, string>>
-     */
-    public function displayRows(Collection $rows, array $columns, string $timeZone): Collection
-    {
-        return $this->rowService->displayRows($rows, $columns, $timeZone);
-    }
-
-    public function displayValue(mixed $value, string $type, string $timeZone): string
-    {
-        return $this->rowService->displayValue($value, $type, $timeZone);
-    }
-}

app/Domains/Ticket/Services/AdminAppTicketResult.php

@@ -1,16 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Services;
-
-use App\Domains\Ticket\Models\Ticket;
-use Illuminate\Pagination\LengthAwarePaginator;
-
-final readonly class AdminAppTicketResult
-{
-    /** @param LengthAwarePaginator<Ticket> $tickets */
-    public function __construct(
-        public LengthAwarePaginator $tickets,
-        public int $scannedTickets,
-        public int $totalTickets,
-    ) {}
-}

app/Domains/Ticket/Services/AdminAppTicketRowService.php

@@ -1,210 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Services;
-
-use App\Domains\Catalog\Models\ItemAttribute;
-use App\Domains\Ticket\Models\Ticket;
-use Illuminate\Support\Collection;
-
-class AdminAppTicketRowService
-{
-    private const FIESTA_FUTBOL_INFANTIL = 'fiesta_futbol_infantil';
-
-    private const CATEGORY_PRESENTATIONS = [
-        'alojamientos' => ['category' => 'Camping', 'product' => 'tipo_alojamiento', 'type' => null, 'date' => null, 'size' => null],
-        'camping' => ['category' => null, 'product' => 'tipo_alojamiento', 'type' => null, 'date' => null, 'size' => null],
-        'entradas' => ['category' => null, 'product' => 'product', 'type' => null, 'date' => null, 'size' => null],
-        'comidas' => ['category' => 'Comida', 'product' => 'horario', 'type' => 'servicio', 'date' => 'event_date', 'size' => null],
-        'comida' => ['category' => null, 'product' => 'horario', 'type' => 'servicio', 'date' => 'event_date', 'size' => null],
-        'merchandising' => ['category' => null, 'product' => 'product', 'type' => 'color', 'date' => null, 'size' => 'talle'],
-    ];
-
-    /** @return array<string, mixed> */
-    public function details(Ticket $ticket): array
-    {
-        $purchaseItem = $ticket->sourcePurchaseItem;
-
-        return [
-            'source_purchase_item_id' => $ticket->source_purchase_item_id,
-            'order_number' => $purchaseItem?->compra_id,
-            'product' => $purchaseItem?->item_nombre
-                ?? $ticket->sourceCatalogItem?->nombre
-                ?? $ticket->name,
-            'amount' => $purchaseItem?->precio_unitario,
-            'client' => $purchaseItem?->purchase?->nombre_apellido ?? $ticket->user?->nombre_apellido,
-            'status' => $ticket->status,
-            'scanned_by' => $ticket->scannerUser?->nombre_apellido,
-            'variant_properties' => $this->variantProperties($ticket),
-        ];
-    }
-
-    /** @param array<string, mixed>|null $details */
-    public function values(Ticket $ticket, ?array $details = null): array
-    {
-        $details ??= $this->details($ticket);
-        $presentation = $this->presentation($ticket, $details);
-
-        return [
-            'order_number' => $details['order_number'],
-            'category' => $presentation['category'],
-            'product' => $presentation['product'],
-            'type' => $presentation['type'],
-            'date' => $presentation['date'],
-            'size' => $presentation['size'],
-            'amount' => $details['amount'] === null ? null : (float) $details['amount'],
-            'client' => $details['client'] ?? 'Sin nombre',
-            'id' => $ticket->id,
-            'status' => $details['status'],
-            'scanned_by' => $details['scanned_by'] ?? '-',
-        ];
-    }
-
-    /**
-     * @param  Collection<int, Ticket>  $tickets
-     * @return Collection<int, array<string, mixed>>
-     */
-    public function rows(Collection $tickets): Collection
-    {
-        return $tickets->values()->map(fn (Ticket $ticket): array => $this->values($ticket));
-    }
-
-    /**
-     * @param  Collection<int, array<string, mixed>>  $rows
-     * @param  list<array<string, mixed>>  $columns
-     * @return Collection<int, array<string, string>>
-     */
-    public function displayRows(Collection $rows, array $columns, string $timeZone): Collection
-    {
-        return $rows->map(fn (array $row): array => collect($columns)
-            ->mapWithKeys(fn (array $column): array => [
-                $column['key'] => $this->displayValue(
-                    $row[$column['key']] ?? null,
-                    $column['type'],
-                    $timeZone,
-                ),
-            ])
-            ->all());
-    }
-
-    public function displayValue(mixed $value, string $type, string $timeZone): string
-    {
-        if ($value === null || $value === '') {
-            return '-';
-        }
-
-        return match ($type) {
-            'order_number' => '#'.$value,
-            'currency' => '$'.number_format((float) $value, 2, ',', '.'),
-            'status' => match ((string) $value) {
-                Ticket::STATUS_USED => 'Usado',
-                Ticket::STATUS_EXPIRED => 'Vencido',
-                default => 'Activo',
-            },
-            default => (string) $value,
-        };
-    }
-
-    /** @param array<string, mixed> $details */
-    private function presentation(Ticket $ticket, array $details): array
-    {
-        $sourceCategory = trim((string) ($ticket->sourceCatalogItem?->category?->nombre ?? '')) ?: '-';
-
-        if ($ticket->tenant_code !== self::FIESTA_FUTBOL_INFANTIL) {
-            return [
-                'category' => $sourceCategory,
-                'product' => (string) ($details['product'] ?: $ticket->name ?: '-'),
-                'type' => $this->allPropertyLabels($details) ?: '-',
-                'date' => '-',
-                'size' => '-',
-            ];
-        }
-
-        $configuration = self::CATEGORY_PRESENTATIONS[mb_strtolower($sourceCategory)] ?? null;
-        if ($configuration === null) {
-            return [
-                'category' => $sourceCategory,
-                'product' => (string) ($details['product'] ?: $ticket->name ?: '-'),
-                'type' => $this->allPropertyLabels($details) ?: '-',
-                'date' => '-',
-                'size' => '-',
-            ];
-        }
-
-        return [
-            'category' => $configuration['category'] ?? $sourceCategory,
-            'product' => $configuration['product'] === 'product'
-                ? (string) ($details['product'] ?: $ticket->name ?: '-')
-                : ($this->propertyLabels($details, $configuration['product']) ?: '-'),
-            'type' => $configuration['type'] === null
-                ? '-'
-                : ($this->propertyLabels($details, $configuration['type']) ?: '-'),
-            'date' => $configuration['date'] === null
-                ? '-'
-                : ($this->propertyLabels($details, $configuration['date']) ?: '-'),
-            'size' => $configuration['size'] === null
-                ? '-'
-                : ($this->propertyLabels($details, $configuration['size']) ?: '-'),
-        ];
-    }
-
-    /** @param array<string, mixed> $details */
-    private function propertyLabels(array $details, string $code): string
-    {
-        $property = collect($details['variant_properties'] ?? [])->firstWhere('code', $code);
-        $labels = collect($property['values'] ?? [])->pluck('label')->filter();
-
-        if ($code === 'event_date') {
-            $labels = $labels->map(function (string $label): string {
-                [$day, $month] = array_pad(explode('/', $label), 2, null);
-
-                return $day !== null && $month !== null ? "{$day}/{$month}" : $label;
-            });
-        }
-
-        return $labels->implode(', ');
-    }
-
-    /** @param array<string, mixed> $details */
-    private function allPropertyLabels(array $details): string
-    {
-        return collect($details['variant_properties'] ?? [])
-            ->flatMap(fn (array $property): array => $property['values'] ?? [])
-            ->pluck('label')
-            ->filter()
-            ->implode(', ');
-    }
-
-    /** @return list<array{code: string, label: string, values: list<array{value: string, label: string}>}> */
-    private function variantProperties(Ticket $ticket): array
-    {
-        $variant = $ticket->sourceVariant;
-        if ($variant === null) {
-            return [];
-        }
-
-        $itemAttributes = $variant->definitions
-            ->map(fn ($definition) => $definition->itemAttribute)
-            ->filter()
-            ->merge($variant->catalogItem?->itemAttributes ?? collect())
-            ->unique('id')
-            ->values();
-
-        return $variant->selectionOptions($itemAttributes)
-            ->map(function (array $selection, string $attributeCode) use ($itemAttributes): array {
-                $itemAttribute = $itemAttributes->first(
-                    fn (ItemAttribute $itemAttribute): bool => $itemAttribute->attribute?->codigo
-                        === $attributeCode,
-                );
-                $values = array_is_list($selection) ? $selection : [$selection];
-
-                return [
-                    'code' => $attributeCode,
-                    'label' => $itemAttribute?->attribute?->nombre
-                        ?? ($attributeCode === 'event_date' ? 'Fecha' : $attributeCode),
-                    'values' => array_values($values),
-                ];
-            })
-            ->values()
-            ->all();
-    }
-}

app/Domains/Ticket/Services/AdminAppTicketService.php

@@ -1,403 +0,0 @@
-<?php
-
-namespace App\Domains\Ticket\Services;
-
-use App\Domains\Auth\Models\User;
-use App\Domains\Purchase\Models\PurchaseItem;
-use App\Domains\Tenant\Models\Tenant;
-use App\Domains\Ticket\Models\Ticket;
-use Illuminate\Database\Eloquent\Builder;
-use Illuminate\Pagination\LengthAwarePaginator;
-use Illuminate\Support\Collection;
-
-class AdminAppTicketService
-{
-    private const RELATIONS = [
-        ...TicketValidityResolver::RELATIONS,
-        ...TicketPresentationResolver::RELATIONS,
-        'user',
-        'scannerUser',
-        'sourceCatalogItem.category',
-        'sourcePurchaseItem.purchase',
-    ];
-
-    public function __construct(
-        private readonly AdminAppTicketColumnService $columnService,
-        private readonly AdminAppTicketRowService $rowService,
-    ) {}
-
-    /**
-     * @param  array{q?: string|null, category?: string|null, product?: string|null, type?: string|null, date?: string|null, size?: string|null, status?: string|null, page?: int, per_page?: int, sort_by?: string|null, sort_direction?: string|null}  $filters
-     */
-    public function search(Tenant $tenant, array $filters = []): AdminAppTicketResult
-    {
-        $query = $this->baseQuery($tenant, $filters);
-        $countQuery = clone $query;
-
-        $databaseSorted = $this->applyDatabaseSort($query, $tenant, $filters);
-
-        if (($filters['sort_by'] ?? null) && ! $databaseSorted) {
-            $matchingTickets = (clone $query)
-                ->with(self::RELATIONS)
-                ->get();
-            $matchingTickets = $this->sortTickets($matchingTickets, $tenant, $filters);
-            $tickets = $this->paginate($matchingTickets, $filters);
-            $scannedTickets = $matchingTickets->whereNotNull('used_at')->count();
-        } else {
-            $tickets = (clone $query)
-                ->with(self::RELATIONS)
-                ->when(! $databaseSorted, fn (Builder $query): Builder => $query->orderByDesc('id'))
-                ->paginateFromRequest()
-                ->withQueryString();
-            $scannedTickets = $countQuery->whereNotNull('used_at')->count();
-        }
-
-        return new AdminAppTicketResult(
-            tickets: $tickets,
-            scannedTickets: $scannedTickets,
-            totalTickets: $tickets->total(),
-        );
-    }
-
-    /**
-     * @param  array{q?: string|null, category?: string|null, product?: string|null, type?: string|null, date?: string|null, size?: string|null, status?: string|null, sort_by?: string|null, sort_direction?: string|null}  $filters
-     * @return Collection<int, Ticket>
-     */
-    public function ticketsForExport(Tenant $tenant, array $filters = []): Collection
-    {
-        $query = $this->baseQuery($tenant, $filters);
-        $databaseSorted = $this->applyDatabaseSort($query, $tenant, $filters);
-        $tickets = $query
-            ->with(self::RELATIONS)
-            ->when(! $databaseSorted, fn (Builder $query): Builder => $query->orderByDesc('id'))
-            ->get();
-
-        return $databaseSorted ? $tickets : $this->sortTickets($tickets, $tenant, $filters);
-    }
-
-    /**
-     * @param  array{q?: string|null, category?: string|null, product?: string|null, type?: string|null, date?: string|null, size?: string|null, status?: string|null, page?: int, per_page?: int}  $filters
-     * @return Builder<Ticket>
-     */
-    private function baseQuery(Tenant $tenant, array $filters): Builder
-    {
-        $search = trim((string) ($filters['q'] ?? ''));
-
-        $query = Ticket::query()
-            ->where('tenant_code', $tenant->codigo)
-            ->when($search !== '', function (Builder $query) use ($search): void {
-                $this->applySearchFilter($query, $search);
-            })
-            ->when($filters['category'] ?? null, function (Builder $query, string $category): void {
-                $query->whereHas('sourceCatalogItem.category', fn (Builder $categoryQuery): Builder => $categoryQuery
-                    ->whereRaw('LOWER(nombre) = ?', [mb_strtolower(trim($category))]));
-            })
-            ->when($filters['product'] ?? null, function (Builder $query, string $product) use ($filters): void {
-                $this->applyProductFilter($query, (string) ($filters['category'] ?? ''), $product);
-            })
-            ->when($filters['type'] ?? null, function (Builder $query, string $type) use ($filters): void {
-                $this->applyTypeFilter($query, (string) ($filters['category'] ?? ''), $type);
-            })
-            ->when($filters['date'] ?? null, function (Builder $query, string $date) use ($tenant): void {
-                if ($tenant->codigo === 'fiesta_futbol_infantil') {
-                    $this->applyEventDateFilter($query, $date);
-
-                    return;
-                }
-
-                $query->whereHas('sourcePurchaseItem.purchase', fn (Builder $purchaseQuery): Builder => $purchaseQuery
-                    ->whereDate('created_at', $date));
-            })
-            ->when($filters['size'] ?? null, function (Builder $query, string $size) use ($filters): void {
-                $this->applySizeFilter($query, (string) ($filters['category'] ?? ''), $size);
-            });
-
-        $this->applyStatusFilter($query, $filters['status'] ?? null);
-
-        return $query;
-    }
-
-    /** @param Builder<Ticket> $query */
-    private function applySearchFilter(Builder $query, string $search): void
-    {
-        $containsPattern = '%'.mb_strtolower($search).'%';
-        $amount = $this->searchAmount($search);
-
-        $query->where(function (Builder $searchQuery) use ($search, $containsPattern, $amount): void {
-            $searchQuery
-                ->where(function (Builder $clientQuery) use ($containsPattern): void {
-                    $clientQuery
-                        ->whereHas('sourcePurchaseItem.purchase', fn (Builder $purchaseQuery): Builder => $purchaseQuery
-                            ->whereRaw('LOWER(nombre_apellido) LIKE ?', [$containsPattern]))
-                        ->orWhere(function (Builder $fallbackClientQuery) use ($containsPattern): void {
-                            $fallbackClientQuery
-                                ->where(function (Builder $missingPurchaseClientQuery): void {
-                                    $missingPurchaseClientQuery
-                                        ->whereDoesntHave('sourcePurchaseItem.purchase')
-                                        ->orWhereHas('sourcePurchaseItem.purchase', fn (Builder $purchaseQuery): Builder => $purchaseQuery
-                                            ->whereNull('nombre_apellido'));
-                                })
-                                ->whereHas('user', fn (Builder $userQuery): Builder => $userQuery
-                                    ->whereRaw('LOWER(nombre_apellido) LIKE ?', [$containsPattern]));
-                        });
-                })
-                ->orWhereHas('scannerUser', fn (Builder $scannerQuery): Builder => $scannerQuery
-                    ->whereRaw('LOWER(nombre_apellido) LIKE ?', [$containsPattern]));
-
-            if (ctype_digit($search)) {
-                $searchQuery
-                    ->orWhere('tickets.id', (int) $search)
-                    ->orWhereHas('sourcePurchaseItem', fn (Builder $purchaseItemQuery): Builder => $purchaseItemQuery
-                        ->where('compra_id', (int) $search));
-            }
-
-            if ($amount !== null) {
-                $searchQuery->orWhereHas('sourcePurchaseItem', fn (Builder $purchaseItemQuery): Builder => $purchaseItemQuery
-                    ->where('precio_unitario', $amount));
-            }
-        });
-    }
-
-    private function searchAmount(string $search): ?string
-    {
-        $value = preg_replace('/[\s$]/u', '', trim($search));
-        if ($value === null || $value === '') {
-            return null;
-        }
-
-        if (preg_match('/^\d{1,3}(?:\.\d{3})+(?:,\d{1,2})?$/', $value) === 1) {
-            $value = str_replace(['.', ','], ['', '.'], $value);
-        } elseif (preg_match('/^\d{1,3}(?:,\d{3})+(?:\.\d{1,2})?$/', $value) === 1) {
-            $value = str_replace(',', '', $value);
-        } elseif (preg_match('/^\d+(?:[.,]\d{1,2})?$/', $value) === 1) {
-            $value = str_replace(',', '.', $value);
-        } else {
-            return null;
-        }
-
-        return number_format((float) $value, 2, '.', '');
-    }
-
-    /** @param Builder<Ticket> $query */
-    private function applyProductFilter(Builder $query, string $category, string $product): void
-    {
-        $category = $this->normalizedCategory($category);
-
-        if (in_array($category, ['alojamientos', 'camping'], true)) {
-            $this->whereVariantDefinition($query, 'tipo_alojamiento', $product);
-
-            return;
-        }
-
-        if (in_array($category, ['comidas', 'comida'], true)) {
-            $this->whereVariantDefinition($query, 'horario', $product);
-
-            return;
-        }
-
-        $query->whereHas('sourceCatalogItem', fn (Builder $itemQuery): Builder => $itemQuery
-            ->where('slug', $product));
-    }
-
-    /** @param Builder<Ticket> $query */
-    private function applyTypeFilter(Builder $query, string $category, string $type): void
-    {
-        $attribute = match ($this->normalizedCategory($category)) {
-            'comidas', 'comida' => 'servicio',
-            'merchandising' => 'color',
-            default => null,
-        };
-
-        if ($attribute !== null) {
-            $this->whereVariantDefinition($query, $attribute, $type);
-        }
-    }
-
-    /** @param Builder<Ticket> $query */
-    private function applyEventDateFilter(Builder $query, string $date): void
-    {
-        $query
-            ->whereHas('sourceCatalogItem.category', fn (Builder $categoryQuery): Builder => $categoryQuery
-                ->whereRaw('LOWER(nombre) IN (?, ?)', ['comidas', 'comida']))
-            ->whereHas('sourceVariant', function (Builder $variantQuery) use ($date): void {
-                $variantQuery->where(function (Builder $dateQuery) use ($date): void {
-                    $dateQuery
-                        ->whereHas('eventDate', fn (Builder $eventDateQuery): Builder => $eventDateQuery
-                            ->whereDate('date', $date))
-                        ->orWhereHas('eventDates', fn (Builder $eventDateQuery): Builder => $eventDateQuery
-                            ->whereDate('date', $date));
-                });
-            });
-    }
-
-    /** @param Builder<Ticket> $query */
-    private function applySizeFilter(Builder $query, string $category, string $size): void
-    {
-        if ($this->normalizedCategory($category) === 'merchandising') {
-            $this->whereVariantDefinition($query, 'talle', $size);
-        }
-    }
-
-    /** @param Builder<Ticket> $query */
-    private function whereVariantDefinition(Builder $query, string $attribute, string $value): void
-    {
-        $query->whereHas('sourceVariant.definitions', fn (Builder $definitionQuery): Builder => $definitionQuery
-            ->where('value', $value)
-            ->whereHas('itemAttribute.attribute', fn (Builder $attributeQuery): Builder => $attributeQuery
-                ->where('codigo', $attribute)));
-    }
-
-    /** @param Builder<Ticket> $query */
-    private function applyStatusFilter(Builder $query, ?string $status): void
-    {
-        if ($status === null || $status === '') {
-            return;
-        }
-
-        if ($status === Ticket::STATUS_USED) {
-            $query->whereNotNull('used_at');
-
-            return;
-        }
-
-        $matchingIds = (clone $query)
-            ->whereNull('used_at')
-            ->with(TicketValidityResolver::RELATIONS)
-            ->get()
-            ->filter(fn (Ticket $ticket): bool => $ticket->status === $status)
-            ->pluck('id');
-
-        $query->whereIn('tickets.id', $matchingIds);
-    }
-
-    private function normalizedCategory(string $category): string
-    {
-        return mb_strtolower(trim($category));
-    }
-
-    /**
-     * @param  Builder<Ticket>  $query
-     * @param  array{sort_by?: string|null, sort_direction?: string|null}  $filters
-     */
-    private function applyDatabaseSort(Builder $query, Tenant $tenant, array $filters): bool
-    {
-        $sortBy = (string) ($filters['sort_by'] ?? '');
-        if ($sortBy === '') {
-            return false;
-        }
-
-        $direction = ($filters['sort_direction'] ?? 'asc') === 'desc' ? 'desc' : 'asc';
-
-        $sortExpression = match ($sortBy) {
-            'order_number' => $this->purchaseItemColumnQuery('compra_id'),
-            'id' => 'tickets.id',
-            'amount' => $this->purchaseItemColumnQuery('precio_unitario'),
-            'scanned_by' => User::query()
-                ->select('nombre_apellido')
-                ->whereColumn('users.id', 'tickets.scanner_user_id'),
-            'product' => $tenant->codigo === 'fiesta_futbol_infantil'
-                ? null
-                : $this->purchaseItemColumnQuery('item_nombre'),
-            default => null,
-        };
-
-        if ($sortExpression === null) {
-            return false;
-        }
-
-        $query->orderBy($sortExpression, $direction)->orderByDesc('tickets.id');
-
-        return true;
-    }
-
-    /** @return Builder<PurchaseItem> */
-    private function purchaseItemColumnQuery(string $column): Builder
-    {
-        return PurchaseItem::query()
-            ->select($column)
-            ->whereColumn('compra_items.id', 'tickets.source_purchase_item_id')
-            ->limit(1);
-    }
-
-    /**
-     * @param  Collection<int, Ticket>  $tickets
-     * @param  array{sort_by?: string|null, sort_direction?: string|null}  $filters
-     * @return Collection<int, Ticket>
-     */
-    private function sortTickets(Collection $tickets, Tenant $tenant, array $filters): Collection
-    {
-        $sortBy = (string) ($filters['sort_by'] ?? '');
-        if ($sortBy === '') {
-            return $tickets;
-        }
-
-        $column = collect($this->columnService->columns($tenant))
-            ->firstWhere('sort_param', $sortBy);
-        if ($column === null) {
-            return $tickets;
-        }
-
-        $direction = ($filters['sort_direction'] ?? 'asc') === 'desc' ? -1 : 1;
-        $values = $tickets->mapWithKeys(fn (Ticket $ticket): array => [
-            $ticket->getKey() => $this->rowService->values($ticket)[$column['key']] ?? null,
-        ]);
-
-        return $tickets->sort(function (Ticket $left, Ticket $right) use ($column, $direction, $values): int {
-            $leftValue = $values->get($left->getKey());
-            $rightValue = $values->get($right->getKey());
-
-            if ($leftValue === null || $leftValue === '') {
-                return $rightValue === null || $rightValue === '' ? $right->id <=> $left->id : 1;
-            }
-            if ($rightValue === null || $rightValue === '') {
-                return -1;
-            }
-
-            $comparison = $this->compareValues($leftValue, $rightValue, $column['type']);
-
-            return $comparison === 0
-                ? $right->id <=> $left->id
-                : $comparison * $direction;
-        })->values();
-    }
-
-    private function compareValues(mixed $left, mixed $right, string $type): int
-    {
-        if (in_array($type, ['currency', 'order_number'], true)) {
-            return (float) $left <=> (float) $right;
-        }
-
-        if ($type === 'date') {
-            $leftTimestamp = $left instanceof \DateTimeInterface ? $left->getTimestamp() : strtotime((string) $left);
-            $rightTimestamp = $right instanceof \DateTimeInterface ? $right->getTimestamp() : strtotime((string) $right);
-
-            return $leftTimestamp <=> $rightTimestamp;
-        }
-
-        if ($type === 'status') {
-            $left = $this->rowService->displayValue($left, $type, 'UTC');
-            $right = $this->rowService->displayValue($right, $type, 'UTC');
-        }
-
-        return strnatcasecmp((string) $left, (string) $right);
-    }
-
-    /**
-     * @param  Collection<int, Ticket>  $tickets
-     * @param  array{page?: int, per_page?: int}  $filters
-     * @return LengthAwarePaginator<Ticket>
-     */
-    private function paginate(Collection $tickets, array $filters): LengthAwarePaginator
-    {
-        $page = (int) ($filters['page'] ?? 1);
-        $perPage = (int) ($filters['per_page'] ?? 15);
-
-        return (new LengthAwarePaginator(
-            $tickets->forPage($page, $perPage)->values(),
-            $tickets->count(),
-            $perPage,
-            $page,
-            ['path' => request()->url()],
-        ))->withQueryString();
-    }
-}

app/Domains/Ticket/Services/TicketGeneratorService.php

@@ -23,13 +23,13 @@ class TicketGeneratorService
         User $user,
         int $quantity = 1,
         ?int $sourceVariantId = null,
-        ?int $sourcePurchaseItemId = null,
+        ?int $sourcePurchaseId = null,
     ): Collection {
         if ($quantity < 1) {
             throw TicketGenerationException::invalidQuantity();
         }
 
-        return DB::transaction(function () use ($catalogItem, $user, $quantity, $sourceVariantId, $sourcePurchaseItemId): Collection {
+        return DB::transaction(function () use ($catalogItem, $user, $quantity, $sourceVariantId, $sourcePurchaseId): Collection {
             $targets = $this->resolveTargets(
                 $catalogItem,
                 $quantity,
@@ -37,7 +37,7 @@ class TicketGeneratorService
             );
 
             return $targets->map(function (array $target) use (
-                $sourcePurchaseItemId,
+                $sourcePurchaseId,
                 $user,
             ): Ticket {
                 $item = $target['catalog_item'];
@@ -45,7 +45,7 @@ class TicketGeneratorService
                 $ticket = Ticket::query()->create([
                     'tenant_code' => $item->tenant_code,
                     'ticket' => (string) Str::uuid(),
-                    'source_purchase_item_id' => $sourcePurchaseItemId,
+                    'source_purchase_id' => $sourcePurchaseId,
                     'source_catalog_item_id' => $item->getKey(),
                     'source_variant_id' => $variant?->getKey(),
                     'used_at' => null,

app/Domains/Ticket/Services/TicketPdfService.php

@@ -5,7 +5,6 @@ namespace App\Domains\Ticket\Services;
 use App\Domains\Tenant\Models\Tenant;
 use App\Domains\Ticket\Models\Ticket;
 use Barryvdh\DomPDF\Facade\Pdf;
-use Barryvdh\DomPDF\PDF as DomPdf;
 use Endroid\QrCode\ErrorCorrectionLevel;
 use Endroid\QrCode\QrCode;
 use Endroid\QrCode\Writer\PngWriter;
@@ -20,36 +19,12 @@ class TicketPdfService
      * @param  Collection<int, Ticket>  $tickets
      */
     public function download(Tenant $tenant, Collection $tickets): Response
-    {
-        return $this->pdf($tenant, $tickets)->download($this->filename($tickets));
-    }
-
-    /**
-     * @param  Collection<int, Ticket>  $tickets
-     */
-    public function contents(Tenant $tenant, Collection $tickets): string
-    {
-        return $this->pdf($tenant, $tickets)->output();
-    }
-
-    /**
-     * @param  Collection<int, Ticket>  $tickets
-     */
-    public function filename(Collection $tickets): string
-    {
-        return 'tickets_'.$tickets->pluck('id')->implode('_').'.pdf';
-    }
-
-    /**
-     * @param  Collection<int, Ticket>  $tickets
-     */
-    private function pdf(Tenant $tenant, Collection $tickets): DomPdf
     {
         $tenant->loadMissing('headerLogo');
         $primaryColor = $this->color($tenant->primary_color, '#009933');
         $headerBackgroundColor = $this->color($tenant->header_bg_color, $primaryColor);
 
-        return Pdf::loadView('pdf.tickets', [
+        $pdf = Pdf::loadView('pdf.tickets', [
             'tenant' => $tenant,
             'tickets' => $tickets,
             'logoDataUri' => $this->logoDataUri($tenant),
@@ -60,6 +35,10 @@ class TicketPdfService
                 fn (Ticket $ticket): array => [$ticket->id => $this->qrCodeDataUri($ticket->ticket)]
             ),
         ])->setPaper('a4');
+
+        $ticketIds = $tickets->pluck('id')->implode('_');
+
+        return $pdf->download("tickets_{$ticketIds}.pdf");
     }
 
     private function qrCodeDataUri(string $value): string

app/Domains/Ticket/documentacion/README.md

@@ -6,8 +6,7 @@ Genera, valida, consulta y exporta entradas asociadas a compras pagadas de produ
 
 ## Modelo
 
-- `Ticket`: pertenece a tenant y usuario, y conserva referencias al ítem de compra que lo generó, producto,
+- `Ticket`: pertenece a tenant y usuario, y conserva referencias a compra, producto, variante y usuario escáner.
-  variante y usuario escáner. La compra se obtiene a través de su ítem.
 - El nombre y la descripción se calculan dinámicamente desde el producto y la variante; los tickets no
   persisten una copia de esos textos.
 - `ValidityTime`: define ventanas absolutas o relativas de vigencia para fechas de evento y opciones de atributos.
@@ -22,7 +21,7 @@ vigente, vencido o usado, y resuelve sus fechas efectivas de inicio y fin sin pe
 1. `Purchase` emite `PurchasePaid` al confirmarse el pago.
 2. `GenerateTicketsForPaidPurchase` atiende el evento.
 3. `TicketGeneratorService` crea los tickets requeridos según ítems, cantidades y vigencia.
-4. `Notification` envía la confirmación de compra después de la generación y adjunta los tickets cuando existen.
+4. El flujo puede emitir disponibilidad para que `Notification` informe al comprador.
 
 ## Endpoints
 
@@ -31,12 +30,6 @@ Bajo `/tenants/{tenant:codigo}`, protegidos por `auth:sanctum`:
 - `GET /tickets`.
 - `POST /tickets/pdf`.
 
-Bajo `/v1/adminapp/tenant`, protegido por `auth:sanctum`, `adminapp.tenant` y el menú
-`adminapp.tickets`:
-
-- `GET /tickets`, paginado y con búsqueda opcional mediante `q`. La respuesta incluye
-  `scanned_tickets` y `total_tickets` para el tenant autenticado.
-
 `TicketPdfService` genera la descarga y `TicketResource`/`ValidityTimeResource` definen las respuestas.
 
 ## Dependencias y reglas

app/Domains/Ticket/routes/adminapp.php

@@ -1,18 +0,0 @@
-<?php
-
-use App\Domains\Ticket\Controllers\AdminApp\TicketController;
-use Illuminate\Support\Facades\Route;
-
-Route::prefix('v1/adminapp/tenant')
-    ->middleware(['auth:sanctum', 'adminapp.tenant'])
-    ->group(function (): void {
-        Route::get('tickets', [TicketController::class, 'index'])
-            ->middleware('tenant.menu:adminapp.tickets')
-            ->name('adminapp.tickets.index');
-        Route::get('tickets/pdf', [TicketController::class, 'downloadPdf'])
-            ->middleware('tenant.menu:adminapp.tickets')
-            ->name('adminapp.tickets.pdf');
-        Route::get('tickets/excel', [TicketController::class, 'downloadExcel'])
-            ->middleware('tenant.menu:adminapp.tickets')
-            ->name('adminapp.tickets.excel');
-    });

app/Domains/Ticket/routes/api.php

@@ -11,4 +11,3 @@ Route::prefix('tenants/{tenant:codigo}')
     });
 
 require __DIR__.'/scanner.php';
-require __DIR__.'/adminapp.php';

app/Providers/AppServiceProvider.php

@@ -3,9 +3,11 @@
 namespace App\Providers;
 
 use App\Domains\Notification\Events\PasswordResetRequested;
+use App\Domains\Notification\Events\TicketsAvailable;
 use App\Domains\Notification\Events\UserRegistered;
 use App\Domains\Notification\Listeners\SendPasswordResetEmail;
-use App\Domains\Notification\Listeners\SendPurchaseConfirmedEmail;
+use App\Domains\Notification\Listeners\SendPurchasePaidEmail;
+use App\Domains\Notification\Listeners\SendTicketsAvailableEmail;
 use App\Domains\Notification\Listeners\SendWelcomeEmail;
 use App\Domains\Purchase\Events\PurchasePaid;
 use App\Domains\Ticket\Listeners\GenerateTicketsForPaidPurchase;
@@ -31,8 +33,9 @@ class AppServiceProvider extends ServiceProvider
      */
     public function boot(): void
     {
+        Event::listen(PurchasePaid::class, SendPurchasePaidEmail::class);
         Event::listen(PurchasePaid::class, GenerateTicketsForPaidPurchase::class);
-        Event::listen(PurchasePaid::class, SendPurchaseConfirmedEmail::class);
+        Event::listen(TicketsAvailable::class, SendTicketsAvailableEmail::class);
         Event::listen(UserRegistered::class, SendWelcomeEmail::class);
         Event::listen(PasswordResetRequested::class, SendPasswordResetEmail::class);
 

bootstrap/app.php

@@ -1,7 +1,6 @@
 <?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;
@@ -114,16 +113,6 @@ 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;

composer.json

@@ -6,16 +6,15 @@
     "keywords": ["laravel", "framework"],
     "license": "MIT",
     "require": {
-        "php": "^8.3",
         "ext-gd": "*",
+        "php": "^8.3",
         "barryvdh/laravel-dompdf": "^3.1",
         "endroid/qr-code": "^6.1",
         "laravel/framework": "^13.8",
         "laravel/sanctum": "^4.3",
         "laravel/socialite": "^5.29",
         "laravel/tinker": "^3.0",
-        "league/flysystem-aws-s3-v3": "^3.0",
+        "league/flysystem-aws-s3-v3": "^3.0"
-        "phpoffice/phpspreadsheet": "^5.9"
     },
     "require-dev": {
         "fakerphp/faker": "^1.23",

composer.lock

@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "a593ab47d99b233f75851dbb7ea50479",
+    "content-hash": "ce185c60c617846be30ae694f0cf6e9c",
     "packages": [
         {
             "name": "aws/aws-crt-php",
@@ -417,82 +417,6 @@
             ],
             "time": "2024-02-09T16:56:22+00:00"
         },
-        {
-            "name": "composer/pcre",
-            "version": "3.4.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/composer/pcre.git",
-                "reference": "d5a341b3fb61f3001970940afb1d332968a183ed"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/composer/pcre/zipball/d5a341b3fb61f3001970940afb1d332968a183ed",
-                "reference": "d5a341b3fb61f3001970940afb1d332968a183ed",
-                "shasum": ""
-            },
-            "require": {
-                "php": "^7.4 || ^8.0"
-            },
-            "conflict": {
-                "phpstan/phpstan": "<2.2.2"
-            },
-            "require-dev": {
-                "phpstan/phpstan": "^2",
-                "phpstan/phpstan-deprecation-rules": "^2",
-                "phpstan/phpstan-strict-rules": "^2",
-                "phpunit/phpunit": "^9"
-            },
-            "type": "library",
-            "extra": {
-                "phpstan": {
-                    "includes": [
-                        "extension.neon"
-                    ]
-                },
-                "branch-alias": {
-                    "dev-main": "3.x-dev"
-                }
-            },
-            "autoload": {
-                "psr-4": {
-                    "Composer\\Pcre\\": "src"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Jordi Boggiano",
-                    "email": "j.boggiano@seld.be",
-                    "homepage": "http://seld.be"
-                }
-            ],
-            "description": "PCRE wrapping library that offers type-safe preg_* replacements.",
-            "keywords": [
-                "PCRE",
-                "preg",
-                "regex",
-                "regular expression"
-            ],
-            "support": {
-                "issues": "https://github.com/composer/pcre/issues",
-                "source": "https://github.com/composer/pcre/tree/3.4.0"
-            },
-            "funding": [
-                {
-                    "url": "https://packagist.com",
-                    "type": "custom"
-                },
-                {
-                    "url": "https://github.com/composer",
-                    "type": "github"
-                }
-            ],
-            "time": "2026-06-07T11:47:49+00:00"
-        },
         {
             "name": "dasprid/enum",
             "version": "1.0.7",
@@ -3000,191 +2924,6 @@
             ],
             "time": "2026-03-08T20:05:35+00:00"
         },
-        {
-            "name": "maennchen/zipstream-php",
-            "version": "3.2.2",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/maennchen/ZipStream-PHP.git",
-                "reference": "77bebeb4c6c340bb3c11c843b2cffd8bbfde4d5e"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/maennchen/ZipStream-PHP/zipball/77bebeb4c6c340bb3c11c843b2cffd8bbfde4d5e",
-                "reference": "77bebeb4c6c340bb3c11c843b2cffd8bbfde4d5e",
-                "shasum": ""
-            },
-            "require": {
-                "ext-mbstring": "*",
-                "ext-zlib": "*",
-                "php-64bit": "^8.3"
-            },
-            "require-dev": {
-                "brianium/paratest": "^7.7",
-                "ext-zip": "*",
-                "friendsofphp/php-cs-fixer": "^3.86",
-                "guzzlehttp/guzzle": "^7.5",
-                "mikey179/vfsstream": "^1.6",
-                "php-coveralls/php-coveralls": "^2.5",
-                "phpunit/phpunit": "^12.0",
-                "vimeo/psalm": "^6.0"
-            },
-            "suggest": {
-                "guzzlehttp/psr7": "^2.4",
-                "psr/http-message": "^2.0"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "ZipStream\\": "src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Paul Duncan",
-                    "email": "pabs@pablotron.org"
-                },
-                {
-                    "name": "Jonatan Männchen",
-                    "email": "jonatan@maennchen.ch"
-                },
-                {
-                    "name": "Jesse Donat",
-                    "email": "donatj@gmail.com"
-                },
-                {
-                    "name": "András Kolesár",
-                    "email": "kolesar@kolesar.hu"
-                }
-            ],
-            "description": "ZipStream is a library for dynamically streaming dynamic zip files from PHP without writing to the disk at all on the server.",
-            "keywords": [
-                "stream",
-                "zip"
-            ],
-            "support": {
-                "issues": "https://github.com/maennchen/ZipStream-PHP/issues",
-                "source": "https://github.com/maennchen/ZipStream-PHP/tree/3.2.2"
-            },
-            "funding": [
-                {
-                    "url": "https://github.com/maennchen",
-                    "type": "github"
-                }
-            ],
-            "time": "2026-04-11T18:38:28+00:00"
-        },
-        {
-            "name": "markbaker/complex",
-            "version": "3.0.2",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/MarkBaker/PHPComplex.git",
-                "reference": "95c56caa1cf5c766ad6d65b6344b807c1e8405b9"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/MarkBaker/PHPComplex/zipball/95c56caa1cf5c766ad6d65b6344b807c1e8405b9",
-                "reference": "95c56caa1cf5c766ad6d65b6344b807c1e8405b9",
-                "shasum": ""
-            },
-            "require": {
-                "php": "^7.2 || ^8.0"
-            },
-            "require-dev": {
-                "dealerdirect/phpcodesniffer-composer-installer": "dev-master",
-                "phpcompatibility/php-compatibility": "^9.3",
-                "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
-                "squizlabs/php_codesniffer": "^3.7"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "Complex\\": "classes/src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Mark Baker",
-                    "email": "mark@lange.demon.co.uk"
-                }
-            ],
-            "description": "PHP Class for working with complex numbers",
-            "homepage": "https://github.com/MarkBaker/PHPComplex",
-            "keywords": [
-                "complex",
-                "mathematics"
-            ],
-            "support": {
-                "issues": "https://github.com/MarkBaker/PHPComplex/issues",
-                "source": "https://github.com/MarkBaker/PHPComplex/tree/3.0.2"
-            },
-            "time": "2022-12-06T16:21:08+00:00"
-        },
-        {
-            "name": "markbaker/matrix",
-            "version": "3.0.1",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/MarkBaker/PHPMatrix.git",
-                "reference": "728434227fe21be27ff6d86621a1b13107a2562c"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/MarkBaker/PHPMatrix/zipball/728434227fe21be27ff6d86621a1b13107a2562c",
-                "reference": "728434227fe21be27ff6d86621a1b13107a2562c",
-                "shasum": ""
-            },
-            "require": {
-                "php": "^7.1 || ^8.0"
-            },
-            "require-dev": {
-                "dealerdirect/phpcodesniffer-composer-installer": "dev-master",
-                "phpcompatibility/php-compatibility": "^9.3",
-                "phpdocumentor/phpdocumentor": "2.*",
-                "phploc/phploc": "^4.0",
-                "phpmd/phpmd": "2.*",
-                "phpunit/phpunit": "^7.0 || ^8.0 || ^9.0",
-                "sebastian/phpcpd": "^4.0",
-                "squizlabs/php_codesniffer": "^3.7"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "Matrix\\": "classes/src/"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Mark Baker",
-                    "email": "mark@demon-angel.eu"
-                }
-            ],
-            "description": "PHP Class for working with matrices",
-            "homepage": "https://github.com/MarkBaker/PHPMatrix",
-            "keywords": [
-                "mathematics",
-                "matrix",
-                "vector"
-            ],
-            "support": {
-                "issues": "https://github.com/MarkBaker/PHPMatrix/issues",
-                "source": "https://github.com/MarkBaker/PHPMatrix/tree/3.0.1"
-            },
-            "time": "2022-12-02T22:17:43+00:00"
-        },
         {
             "name": "masterminds/html5",
             "version": "2.10.1",
@@ -3947,115 +3686,6 @@
             },
             "time": "2020-10-15T08:29:30+00:00"
         },
-        {
-            "name": "phpoffice/phpspreadsheet",
-            "version": "5.9.0",
-            "source": {
-                "type": "git",
-                "url": "https://github.com/PHPOffice/PhpSpreadsheet.git",
-                "reference": "05e99ebf61238a70227b4d9cc02d0030d34f6339"
-            },
-            "dist": {
-                "type": "zip",
-                "url": "https://api.github.com/repos/PHPOffice/PhpSpreadsheet/zipball/05e99ebf61238a70227b4d9cc02d0030d34f6339",
-                "reference": "05e99ebf61238a70227b4d9cc02d0030d34f6339",
-                "shasum": ""
-            },
-            "require": {
-                "composer/pcre": "^1||^2||^3",
-                "ext-ctype": "*",
-                "ext-dom": "*",
-                "ext-fileinfo": "*",
-                "ext-filter": "*",
-                "ext-gd": "*",
-                "ext-iconv": "*",
-                "ext-libxml": "*",
-                "ext-mbstring": "*",
-                "ext-simplexml": "*",
-                "ext-xml": "*",
-                "ext-xmlreader": "*",
-                "ext-xmlwriter": "*",
-                "ext-zip": "*",
-                "ext-zlib": "*",
-                "maennchen/zipstream-php": "^2.1 || ^3.0",
-                "markbaker/complex": "^3.0",
-                "markbaker/matrix": "^3.0",
-                "php": "^8.2",
-                "psr/simple-cache": "^1.0 || ^2.0 || ^3.0"
-            },
-            "require-dev": {
-                "dealerdirect/phpcodesniffer-composer-installer": "dev-main",
-                "dompdf/dompdf": "^2.0 || ^3.0",
-                "ext-intl": "*",
-                "friendsofphp/php-cs-fixer": "^3.2",
-                "mitoteam/jpgraph": "^10.5",
-                "mpdf/mpdf": "^8.1.1",
-                "phpcompatibility/php-compatibility": "^9.3",
-                "phpstan/phpstan": "^1.1 || ^2.0",
-                "phpstan/phpstan-deprecation-rules": "^1.0 || ^2.0",
-                "phpstan/phpstan-phpunit": "^1.0 || ^2.0",
-                "phpunit/phpunit": "^10.5 || ^11.0",
-                "squizlabs/php_codesniffer": "^3.7",
-                "tecnickcom/tcpdf": "^6.5"
-            },
-            "suggest": {
-                "dompdf/dompdf": "Option for rendering PDF with PDF Writer",
-                "ext-intl": "PHP Internationalization Functions, required for NumberFormat Wizard and StringHelper::setLocale()",
-                "mitoteam/jpgraph": "Option for rendering charts, or including charts with PDF or HTML Writers",
-                "mpdf/mpdf": "Option for rendering PDF with PDF Writer",
-                "tecnickcom/tcpdf": "Option for rendering PDF with PDF Writer"
-            },
-            "type": "library",
-            "autoload": {
-                "psr-4": {
-                    "PhpOffice\\PhpSpreadsheet\\": "src/PhpSpreadsheet"
-                }
-            },
-            "notification-url": "https://packagist.org/downloads/",
-            "license": [
-                "MIT"
-            ],
-            "authors": [
-                {
-                    "name": "Maarten Balliauw",
-                    "homepage": "https://blog.maartenballiauw.be"
-                },
-                {
-                    "name": "Mark Baker",
-                    "homepage": "https://markbakeruk.net"
-                },
-                {
-                    "name": "Franck Lefevre",
-                    "homepage": "https://rootslabs.net"
-                },
-                {
-                    "name": "Erik Tilt"
-                },
-                {
-                    "name": "Adrien Crivelli"
-                },
-                {
-                    "name": "Owen Leibman"
-                }
-            ],
-            "description": "PHPSpreadsheet - Read, Create and Write Spreadsheet documents in PHP - Spreadsheet engine",
-            "homepage": "https://github.com/PHPOffice/PhpSpreadsheet",
-            "keywords": [
-                "OpenXML",
-                "excel",
-                "gnumeric",
-                "ods",
-                "php",
-                "spreadsheet",
-                "xls",
-                "xlsx"
-            ],
-            "support": {
-                "issues": "https://github.com/PHPOffice/PhpSpreadsheet/issues",
-                "source": "https://github.com/PHPOffice/PhpSpreadsheet/tree/5.9.0"
-            },
-            "time": "2026-07-12T19:17:39+00:00"
-        },
         {
             "name": "phpoption/phpoption",
             "version": "1.9.5",
@@ -10208,8 +9838,8 @@
     "prefer-stable": true,
     "prefer-lowest": false,
     "platform": {
-        "php": "^8.3",
+        "ext-gd": "*",
-        "ext-gd": "*"
+        "php": "^8.3"
     },
     "platform-dev": {},
     "plugin-api-version": "2.9.0"

config/auth.php

@@ -96,7 +96,7 @@ return [
         'users' => [
             'provider' => 'users',
             'table' => env('AUTH_PASSWORD_RESET_TOKEN_TABLE', 'password_reset_tokens'),
-            'expire' => (int) env('AUTH_PASSWORD_RESET_EXPIRATION_MINUTES', 60),
+            'expire' => 60,
             'throttle' => 60,
         ],
     ],

config/logging.php

@@ -89,14 +89,6 @@ return [
             'replace_placeholders' => true,
         ],
 
-        'emails' => [
-            'driver' => 'daily',
-            'path' => storage_path('logs/emails/emails.log'),
-            'level' => env('EMAILS_LOG_LEVEL', 'info'),
-            'days' => env('EMAILS_LOG_DAYS', 30),
-            'replace_placeholders' => true,
-        ],
-
         'slack' => [
             'driver' => 'slack',
             'url' => env('LOG_SLACK_WEBHOOK_URL'),

config/purchase.php

@@ -8,9 +8,4 @@ return [
         'telepagos' => (int) env('PURCHASE_TELEPAGOS_EXPIRATION_MINUTES', 30),
         'transfer' => (int) env('PURCHASE_TRANSFER_EXPIRATION_MINUTES', 1440),
     ],
-
-    'transfer_candidate_amount_tolerance_percentage' => (float) env(
-        'PURCHASE_TRANSFER_CANDIDATE_AMOUNT_TOLERANCE_PERCENTAGE',
-        5,
-    ),
 ];

database/migrations/2026_08_25_010000_add_expires_at_to_reset_password_attempts_table.php

@@ -1,32 +0,0 @@
-<?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');
-        });
-    }
-};

database/migrations/2026_08_25_160000_make_stock_reservation_expiration_authoritative.php

@@ -1,51 +0,0 @@
-<?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'),
-                        ]);
-                }
-            });
-    }
-};

database/migrations/2026_08_25_170000_propagate_expired_stock_reservations.php

@@ -1,30 +0,0 @@
-<?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.
-    }
-};

database/migrations/2026_08_26_000000_set_website_type_favicon.php

@@ -1,96 +0,0 @@
-<?php
-
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\Storage;
-use Illuminate\Support\Str;
-
-return new class extends Migration
-{
-    private const FILENAME = 'onticket_favicon.svg';
-
-    /** @var list<string> */
-    private const WEBSITE_TYPE_CODES = ['shopit', 'onticket'];
-
-    public function up(): void
-    {
-        $websiteTypes = DB::table('website_type')
-            ->whereIn('codigo', self::WEBSITE_TYPE_CODES)
-            ->get(['codigo', 'favicon_id']);
-
-        if ($websiteTypes->isEmpty()) {
-            return;
-        }
-
-        $faviconIds = $websiteTypes
-            ->pluck('favicon_id')
-            ->filter()
-            ->unique()
-            ->values();
-
-        if (
-            $faviconIds->count() === 1
-            && DB::table('attachments')
-                ->where('id', $faviconIds->first())
-                ->where('filename', self::FILENAME)
-                ->exists()
-            && $websiteTypes->every(
-                fn (object $websiteType): bool => $websiteType->favicon_id === $faviconIds->first()
-            )
-        ) {
-            return;
-        }
-
-        $sourcePath = public_path('images/website_types/'.self::FILENAME);
-
-        if (! is_file($sourcePath)) {
-            throw new RuntimeException("Favicon not found at path: {$sourcePath}");
-        }
-
-        $contents = file_get_contents($sourcePath);
-
-        if ($contents === false) {
-            throw new RuntimeException("Could not read favicon at path: {$sourcePath}");
-        }
-
-        $key = (string) Str::uuid();
-        $storedPath = "website-types/{$key}.svg";
-
-        if (! Storage::disk('s3')->put($storedPath, $contents)) {
-            throw new RuntimeException("Could not store favicon at path: {$storedPath}");
-        }
-
-        try {
-            DB::transaction(function () use ($contents, $key, $storedPath): void {
-                $attachmentId = DB::table('attachments')->insertGetId([
-                    'key' => $key,
-                    'path' => $storedPath,
-                    'filename' => self::FILENAME,
-                    'type' => 'image',
-                    'mime_type' => 'image/svg+xml',
-                    'extension' => 'svg',
-                    'size' => strlen($contents),
-                    'created_at' => now(),
-                    'updated_at' => now(),
-                ]);
-
-                DB::table('website_type')
-                    ->whereIn('codigo', self::WEBSITE_TYPE_CODES)
-                    ->update([
-                        'favicon_id' => $attachmentId,
-                        'updated_at' => now(),
-                    ]);
-            });
-        } catch (Throwable $throwable) {
-            Storage::disk('s3')->delete($storedPath);
-
-            throw $throwable;
-        }
-    }
-
-    public function down(): void
-    {
-        // The shared attachment may be in use outside these website types.
-        // Keep this data migration irreversible to avoid deleting an active asset.
-    }
-};

database/migrations/2026_08_27_000000_create_telepagos_payment_candidates_table.php

@@ -1,141 +0,0 @@
-<?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::create('telepagos_payment_candidates', function (Blueprint $table) {
-            $table->id();
-            $table->foreignId('telepagos_payment_id')
-                ->constrained('telepagos_payments')
-                ->cascadeOnDelete();
-            $table->foreignId('compra_id')->constrained('compras')->cascadeOnDelete();
-            $table->boolean('dni_matches');
-            $table->boolean('amount_matches');
-            $table->decimal('payment_amount', 10, 2);
-            $table->decimal('purchase_amount', 10, 2);
-            $table->decimal('amount_difference', 10, 2);
-            $table->string('match_reason');
-            $table->string('confidence');
-            $table->timestamps();
-
-            $table->unique(
-                ['telepagos_payment_id', 'compra_id'],
-                'telepagos_payment_candidate_unique',
-            );
-        });
-
-        $this->migrateExistingCandidates();
-
-        Schema::table('telepagos_payments', function (Blueprint $table) {
-            $table->dropColumn('matched_purchase_ids');
-        });
-    }
-
-    public function down(): void
-    {
-        Schema::table('telepagos_payments', function (Blueprint $table) {
-            $table->json('matched_purchase_ids')->nullable()->after('compra_id');
-        });
-
-        DB::table('telepagos_payments')
-            ->whereNull('compra_id')
-            ->orderBy('id')
-            ->each(function (object $payment): void {
-                $candidateIds = DB::table('telepagos_payment_candidates')
-                    ->where('telepagos_payment_id', $payment->id)
-                    ->pluck('compra_id')
-                    ->all();
-
-                if ($candidateIds !== []) {
-                    DB::table('telepagos_payments')
-                        ->where('id', $payment->id)
-                        ->update(['matched_purchase_ids' => json_encode($candidateIds)]);
-                }
-            });
-
-        Schema::dropIfExists('telepagos_payment_candidates');
-    }
-
-    private function migrateExistingCandidates(): void
-    {
-        DB::table('telepagos_payments')
-            ->whereNull('compra_id')
-            ->whereNotNull('matched_purchase_ids')
-            ->orderBy('id')
-            ->each(function (object $payment): void {
-                $candidateIds = json_decode((string) $payment->matched_purchase_ids, true);
-
-                if (! is_array($candidateIds)) {
-                    return;
-                }
-
-                $paymentAmount = number_format((float) $payment->amount, 2, '.', '');
-                $payerDni = $payment->cuit_buyer
-                    ? substr((string) $payment->cuit_buyer, 2, -1)
-                    : null;
-
-                foreach ($candidateIds as $candidateId) {
-                    $purchase = DB::table('compras')->find($candidateId);
-
-                    if ($purchase === null) {
-                        continue;
-                    }
-
-                    $purchaseAmount = number_format((float) $purchase->total, 2, '.', '');
-                    $dniMatches = $payerDni !== null && $purchase->transfer_payer_dni === $payerDni;
-                    $amountMatches = $purchaseAmount === $paymentAmount;
-
-                    DB::table('telepagos_payment_candidates')->insertOrIgnore([
-                        'telepagos_payment_id' => $payment->id,
-                        'compra_id' => $purchase->id,
-                        'dni_matches' => $dniMatches,
-                        'amount_matches' => $amountMatches,
-                        'payment_amount' => $paymentAmount,
-                        'purchase_amount' => $purchaseAmount,
-                        'amount_difference' => number_format(
-                            abs((float) $purchaseAmount - (float) $paymentAmount),
-                            2,
-                            '.',
-                            '',
-                        ),
-                        'match_reason' => $this->matchReason($dniMatches, $amountMatches),
-                        'confidence' => $this->confidence($dniMatches, $amountMatches),
-                        'created_at' => $payment->created_at,
-                        'updated_at' => $payment->updated_at,
-                    ]);
-                }
-            });
-    }
-
-    private function matchReason(bool $dniMatches, bool $amountMatches): string
-    {
-        if ($dniMatches && $amountMatches) {
-            return 'ambiguous_exact_match';
-        }
-
-        if ($dniMatches) {
-            return 'exact_dni_near_amount';
-        }
-
-        if ($amountMatches) {
-            return 'exact_amount_different_dni';
-        }
-
-        return 'legacy_candidate';
-    }
-
-    private function confidence(bool $dniMatches, bool $amountMatches): string
-    {
-        if ($dniMatches && $amountMatches) {
-            return 'exact';
-        }
-
-        return $dniMatches ? 'high' : 'medium';
-    }
-};

database/migrations/2026_08_27_010000_add_dni_distance_to_telepagos_payment_candidates.php

@@ -1,61 +0,0 @@
-<?php
-
-use App\Domains\Purchase\Services\DniDistanceService;
-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('telepagos_payment_candidates', function (Blueprint $table) {
-            $table->unsignedTinyInteger('dni_distance')->nullable()->after('dni_matches');
-            $table->string('payment_dni', 8)->nullable()->after('dni_distance');
-            $table->string('purchase_dni', 8)->nullable()->after('payment_dni');
-        });
-
-        $dniDistance = new DniDistanceService;
-
-        DB::table('telepagos_payment_candidates as candidate')
-            ->join('telepagos_payments as payment', 'payment.id', '=', 'candidate.telepagos_payment_id')
-            ->join('compras as purchase', 'purchase.id', '=', 'candidate.compra_id')
-            ->select([
-                'candidate.id',
-                'candidate.match_reason',
-                'payment.cuit_buyer',
-                'purchase.transfer_payer_dni',
-            ])
-            ->orderBy('candidate.id')
-            ->each(function (object $candidate) use ($dniDistance): void {
-                if ($candidate->cuit_buyer === null || $candidate->transfer_payer_dni === null) {
-                    return;
-                }
-
-                $payerDni = substr((string) $candidate->cuit_buyer, 2, -1);
-                $distance = $dniDistance->distance($payerDni, (string) $candidate->transfer_payer_dni);
-
-                if ($candidate->match_reason === 'exact_amount_different_dni' && $distance > 2) {
-                    DB::table('telepagos_payment_candidates')->where('id', $candidate->id)->delete();
-
-                    return;
-                }
-
-                DB::table('telepagos_payment_candidates')
-                    ->where('id', $candidate->id)
-                    ->update([
-                        'dni_distance' => $distance,
-                        'payment_dni' => $payerDni,
-                        'purchase_dni' => $candidate->transfer_payer_dni,
-                    ]);
-            });
-    }
-
-    public function down(): void
-    {
-        Schema::table('telepagos_payment_candidates', function (Blueprint $table) {
-            $table->dropColumn(['dni_distance', 'payment_dni', 'purchase_dni']);
-        });
-    }
-};

database/migrations/2026_08_27_020000_rename_near_dni_candidate_reason.php

@@ -1,21 +0,0 @@
-<?php
-
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Support\Facades\DB;
-
-return new class extends Migration
-{
-    public function up(): void
-    {
-        DB::table('telepagos_payment_candidates')
-            ->where('match_reason', 'exact_amount_different_dni')
-            ->update(['match_reason' => 'exact_amount_near_dni']);
-    }
-
-    public function down(): void
-    {
-        DB::table('telepagos_payment_candidates')
-            ->where('match_reason', 'exact_amount_near_dni')
-            ->update(['match_reason' => 'exact_amount_different_dni']);
-    }
-};

database/migrations/2026_08_28_000000_add_fiesta_futbol_infantil_tickets_adminapp_menu.php

@@ -1,82 +0,0 @@
-<?php
-
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Support\Facades\DB;
-
-return new class extends Migration
-{
-    private const MENU_CODE = 'adminapp.tickets';
-
-    private const TENANT_CODE = 'fiesta_futbol_infantil';
-
-    public function up(): void
-    {
-        if (! DB::table('menues')->where('code', 'main.adminapp')->exists()) {
-            // Reference data is added by seeders on fresh installations.
-            return;
-        }
-
-        $now = now();
-
-        DB::transaction(function () use ($now): void {
-            DB::table('menues')->updateOrInsert(
-                ['code' => self::MENU_CODE],
-                [
-                    'label' => 'Tickets',
-                    'parent_menu_code' => 'main.adminapp',
-                    'content_type' => 'dynamic',
-                    'static_content_schema' => null,
-                    'route' => '/admin/tickets',
-                    'created_at' => $now,
-                    'updated_at' => $now,
-                ],
-            );
-
-            DB::table('tenants_menues')
-                ->where('menu_code', self::MENU_CODE)
-                ->where('tenant_code', '!=', self::TENANT_CODE)
-                ->delete();
-
-            if (DB::table('tenants')->where('codigo', self::TENANT_CODE)->exists()) {
-                DB::table('tenants_menues')->updateOrInsert(
-                    [
-                        'tenant_code' => self::TENANT_CODE,
-                        'menu_code' => self::MENU_CODE,
-                    ],
-                    [
-                        'static_content' => null,
-                        'created_at' => $now,
-                        'updated_at' => $now,
-                    ],
-                );
-            }
-
-            DB::table('roles')
-                ->whereIn('codigo', ['admin', 'adminapp'])
-                ->pluck('codigo')
-                ->each(function (string $roleCode): void {
-                    DB::table('roles_menues')->updateOrInsert([
-                        'rol_codigo' => $roleCode,
-                        'menu_codigo' => self::MENU_CODE,
-                    ]);
-                });
-        });
-    }
-
-    public function down(): void
-    {
-        DB::transaction(function (): void {
-            DB::table('tenants_menues')
-                ->where('menu_code', self::MENU_CODE)
-                ->delete();
-
-            DB::table('roles_menues')
-                ->where('menu_codigo', self::MENU_CODE)
-                ->delete();
-
-            DB::table('menues')
-                ->where('code', self::MENU_CODE)
-                ->delete();
-        });
-    }
-};

database/migrations/2026_09_02_000000_add_source_purchase_item_id_to_tickets.php

@@ -1,94 +0,0 @@
-<?php
-
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
-use Illuminate\Support\Collection;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\Schema;
-
-return new class extends Migration
-{
-    public function up(): void
-    {
-        Schema::table('tickets', function (Blueprint $table): void {
-            $table->foreignId('source_purchase_item_id')
-                ->nullable()
-                ->after('source_purchase_id')
-                ->constrained('compra_items')
-                ->cascadeOnUpdate()
-                ->nullOnDelete();
-        });
-
-        DB::table('tickets')
-            ->whereNotNull('source_purchase_id')
-            ->whereNull('source_purchase_item_id')
-            ->orderBy('id')
-            ->chunkById(500, function (Collection $tickets): void {
-                $purchaseIds = $tickets->pluck('source_purchase_id')->unique()->values();
-                $itemsByPurchase = DB::table('compra_items')
-                    ->whereIn('compra_id', $purchaseIds)
-                    ->get(['id', 'compra_id', 'source_catalog_item_id', 'source_variant_id'])
-                    ->groupBy('compra_id');
-                $bundleIds = $itemsByPurchase->flatten(1)
-                    ->pluck('source_catalog_item_id')
-                    ->filter()
-                    ->unique()
-                    ->values();
-                $componentsByBundle = DB::table('bundle_components')
-                    ->whereIn('bundle_catalog_item_id', $bundleIds)
-                    ->get([
-                        'bundle_catalog_item_id',
-                        'component_catalog_item_id',
-                        'component_variant_id',
-                    ])
-                    ->groupBy('bundle_catalog_item_id');
-
-                foreach ($tickets as $ticket) {
-                    $candidates = collect($itemsByPurchase->get($ticket->source_purchase_id, []))
-                        ->filter(function (object $item) use ($ticket, $componentsByBundle): bool {
-                            if ($this->sameCatalogTarget($item, $ticket)) {
-                                return true;
-                            }
-
-                            return collect($componentsByBundle->get($item->source_catalog_item_id, []))
-                                ->contains(fn (object $component): bool => $this->sameBundleTarget($component, $ticket));
-                        })
-                        ->pluck('id')
-                        ->unique()
-                        ->values();
-
-                    if ($candidates->count() === 1) {
-                        DB::table('tickets')->where('id', $ticket->id)->update([
-                            'source_purchase_item_id' => $candidates->sole(),
-                        ]);
-                    }
-                }
-            });
-    }
-
-    public function down(): void
-    {
-        Schema::table('tickets', function (Blueprint $table): void {
-            $table->dropConstrainedForeignId('source_purchase_item_id');
-        });
-    }
-
-    private function sameCatalogTarget(object $item, object $ticket): bool
-    {
-        return (int) $item->source_catalog_item_id === (int) $ticket->source_catalog_item_id
-            && $this->sameNullableId($item->source_variant_id, $ticket->source_variant_id);
-    }
-
-    private function sameBundleTarget(object $component, object $ticket): bool
-    {
-        return (int) $component->component_catalog_item_id === (int) $ticket->source_catalog_item_id
-            && $this->sameNullableId($component->component_variant_id, $ticket->source_variant_id);
-    }
-
-    private function sameNullableId(mixed $left, mixed $right): bool
-    {
-        return $left === null || $right === null
-            ? $left === null && $right === null
-            : (int) $left === (int) $right;
-    }
-};

database/migrations/2026_09_02_010000_remove_source_purchase_id_from_tickets.php

@@ -1,73 +0,0 @@
-<?php
-
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
-use Illuminate\Support\Collection;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Facades\Schema;
-
-return new class extends Migration
-{
-    public function up(): void
-    {
-        $unresolved = DB::table('tickets')
-            ->whereNotNull('source_purchase_id')
-            ->whereNull('source_purchase_item_id')
-            ->orderBy('id')
-            ->limit(20)
-            ->pluck('id');
-
-        if ($unresolved->isNotEmpty()) {
-            throw new RuntimeException(
-                'No se puede eliminar tickets.source_purchase_id: hay tickets sin un compra_item inequívoco. '
-                .'IDs: '.$unresolved->implode(', ')
-            );
-        }
-
-        $inconsistent = DB::table('tickets')
-            ->join('compra_items', 'compra_items.id', '=', 'tickets.source_purchase_item_id')
-            ->whereNotNull('tickets.source_purchase_id')
-            ->whereColumn('tickets.source_purchase_id', '!=', 'compra_items.compra_id')
-            ->orderBy('tickets.id')
-            ->limit(20)
-            ->pluck('tickets.id');
-
-        if ($inconsistent->isNotEmpty()) {
-            throw new RuntimeException(
-                'No se puede eliminar tickets.source_purchase_id: hay referencias de compra inconsistentes. '
-                .'IDs: '.$inconsistent->implode(', ')
-            );
-        }
-
-        Schema::table('tickets', function (Blueprint $table): void {
-            $table->dropConstrainedForeignId('source_purchase_id');
-        });
-    }
-
-    public function down(): void
-    {
-        Schema::table('tickets', function (Blueprint $table): void {
-            $table->foreignId('source_purchase_id')
-                ->nullable()
-                ->after('description')
-                ->constrained('compras')
-                ->cascadeOnUpdate()
-                ->nullOnDelete();
-        });
-
-        DB::table('tickets')
-            ->whereNotNull('source_purchase_item_id')
-            ->orderBy('id')
-            ->chunkById(500, function (Collection $tickets): void {
-                $purchaseIdsByItem = DB::table('compra_items')
-                    ->whereIn('id', $tickets->pluck('source_purchase_item_id'))
-                    ->pluck('compra_id', 'id');
-
-                foreach ($tickets as $ticket) {
-                    DB::table('tickets')->where('id', $ticket->id)->update([
-                        'source_purchase_id' => $purchaseIdsByItem->get($ticket->source_purchase_item_id),
-                    ]);
-                }
-            });
-    }
-};

database/migrations/2026_09_02_020000_restrict_deletion_of_purchase_items_with_tickets.php

@@ -1,38 +0,0 @@
-<?php
-
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
-use Illuminate\Support\Facades\Schema;
-
-return new class extends Migration
-{
-    public function up(): void
-    {
-        Schema::table('tickets', function (Blueprint $table): void {
-            $table->dropForeign(['source_purchase_item_id']);
-        });
-
-        Schema::table('tickets', function (Blueprint $table): void {
-            $table->foreign('source_purchase_item_id')
-                ->references('id')
-                ->on('compra_items')
-                ->cascadeOnUpdate()
-                ->restrictOnDelete();
-        });
-    }
-
-    public function down(): void
-    {
-        Schema::table('tickets', function (Blueprint $table): void {
-            $table->dropForeign(['source_purchase_item_id']);
-        });
-
-        Schema::table('tickets', function (Blueprint $table): void {
-            $table->foreign('source_purchase_item_id')
-                ->references('id')
-                ->on('compra_items')
-                ->cascadeOnUpdate()
-                ->nullOnDelete();
-        });
-    }
-};

database/seeders/DesfilePuraTendenciaSeeder.php

@@ -191,7 +191,6 @@ class DesfilePuraTendenciaSeeder extends Seeder
 
         FeaturedGroup::query()->create([
             'tenant_code' => self::TENANT_CODE,
-            'code' => 'entradas',
             'source_type' => FeaturedGroupSource::All,
             'category_id' => null,
             'product_layout' => ProductLayout::TicketSelector,

database/seeders/FiestaFutbolInfantilProductSeeder.php

@@ -144,7 +144,6 @@ class FiestaFutbolInfantilProductSeeder extends Seeder
 
         FeaturedGroup::query()->create([
             'tenant_code' => $tenant->codigo,
-            'code' => 'productos',
             'source_type' => FeaturedGroupSource::All,
             'category_id' => null,
             'product_layout' => ProductLayout::Row,

database/seeders/MenuSeeder.php

@@ -78,12 +78,6 @@ class MenuSeeder extends Seeder
                 'parent_menu_code' => 'main.adminapp',
                 'route' => '/admin/staff',
             ],
-            [
-                'code' => 'adminapp.tickets',
-                'label' => 'Tickets',
-                'parent_menu_code' => 'main.adminapp',
-                'route' => '/admin/tickets',
-            ],
             [
                 'code' => 'adminapp.fiesta-futbol-infantil.entradas',
                 'label' => 'Entradas',
@@ -276,7 +270,6 @@ class MenuSeeder extends Seeder
             'fiesta_futbol_infantil',
         ];
         $fiestaCategoryMenuCodes = [
-            'adminapp.tickets',
             'adminapp.fiesta-futbol-infantil.entradas',
             'adminapp.fiesta-futbol-infantil.alojamientos',
             'adminapp.fiesta-futbol-infantil.merchandising',