feat(ticketing): add entry reservations management for admin app

- Introduced new routes for entry reservations in admin app, including form, index, store, and download functionalities.
- Created a migration to add the "Reserva de Tickets" menu item to the admin app.
- Updated MenuSeeder to include the new menu item for ticket reservations.
- Developed a PDF view for entry reservations.
- Implemented tests for the EntryReservationController and EntryReservationService to ensure proper functionality and access control.
- Refactored test setup to use a dedicated schema creation trait for better isolation and maintainability.

app/Domains/Commerce/Catalog/Models/CatalogItem.php

@@ -2,14 +2,15 @@
 
 namespace App\Domains\Commerce\Catalog\Models;
 
-use App\Shared\Attachable\Models\Attachment;
 use App\Domains\Commerce\Catalog\Enums\CatalogItemType;
 use App\Domains\Commerce\Catalog\Enums\InventoryPolicy;
 use App\Domains\Commerce\Catalog\Enums\InventorySubject;
 use App\Domains\Commerce\Catalog\Services\CatalogInventoryService;
 use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Event\Models\Event;
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
+use App\Shared\Attachable\Models\Attachment;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -147,6 +148,12 @@ class CatalogItem extends Model
         return $this->hasMany(Ticket::class, 'source_catalog_item_id');
     }
 
+    /** @return HasMany<EntryReservation, $this> */
+    public function entryReservations(): HasMany
+    {
+        return $this->hasMany(EntryReservation::class);
+    }
+
     /** @return BelongsToMany<Attribute, $this> */
     public function attributes(): BelongsToMany
     {
@@ -237,7 +244,7 @@ class CatalogItem extends Model
                         ->whereHas(
                             'inventory',
                             fn (Builder $inventoryQuery): Builder => $inventoryQuery
-                                ->whereColumn('inventories.real_stock', '>', 'inventories.reserved_stock')
+                                ->whereRaw('inventories.real_stock > inventories.reserved_stock + inventories.entry_reserved_stock')
                         )
                 )
                 ->orWhere(function (Builder $directItemQuery): void {
@@ -249,7 +256,7 @@ class CatalogItem extends Model
                                 ->orWhereHas(
                                     'inventory',
                                     fn (Builder $availableInventoryQuery): Builder => $availableInventoryQuery
-                                        ->whereColumn('inventories.real_stock', '>', 'inventories.reserved_stock')
+                                        ->whereRaw('inventories.real_stock > inventories.reserved_stock + inventories.entry_reserved_stock')
                                 );
                         });
                 });
@@ -264,9 +271,15 @@ class CatalogItem extends Model
     /** @return Collection<int, Variant> */
     public function visibleVariants(?int $includedVariantId = null): Collection
     {
+        $this->variants
+            ->filter(fn (Variant $variant): bool => $variant->exists)
+            ->loadMissing('entryReservations');
+
         return $this->variants
             ->each(fn (Variant $variant) => $variant->setRelation('catalogItem', $this))
             ->filter(fn (Variant $variant): bool => $variant->hasOnlyActiveEventDates()
+                && (! $variant->relationLoaded('entryReservations')
+                    || $variant->entryReservations->isEmpty())
                 && (($includedVariantId !== null && $variant->id === $includedVariantId)
                     || ($variant->isSellable() && (
                         $this->inventory_policy === InventoryPolicy::Unlimited

app/Domains/Commerce/Catalog/Models/Inventory.php

@@ -12,6 +12,7 @@ use Illuminate\Database\Eloquent\Relations\HasOne;
     'sold_units',
     'refunded_units',
     'reserved_stock',
+    'entry_reserved_stock',
     'real_stock',
 ])]
 class Inventory extends Model
@@ -35,6 +36,7 @@ class Inventory extends Model
             'sold_units' => 'integer',
             'refunded_units' => 'integer',
             'reserved_stock' => 'integer',
+            'entry_reserved_stock' => 'integer',
             'real_stock' => 'integer',
         ];
     }
@@ -59,7 +61,26 @@ class Inventory extends Model
 
     public function availableStock(): int
     {
-        return max(0, $this->real_stock - $this->reserved_stock);
+        return max(0, $this->real_stock - $this->reserved_stock - $this->entry_reserved_stock);
+    }
+
+    public function reserveEntry(int $amount, bool $tracksInventory): void
+    {
+        if ($amount < 1 || ($tracksInventory && $this->availableStock() < $amount)) {
+            throw new \InvalidArgumentException('No hay stock disponible para la reserva de entradas.');
+        }
+        $this->entry_reserved_stock += $amount;
+        $this->save();
+    }
+
+    public function releaseEntry(int $amount): void
+    {
+        if ($amount < 1 || $this->entry_reserved_stock < $amount) {
+            throw new \InvalidArgumentException('La cantidad de entradas reservadas no es válida.');
+        }
+
+        $this->entry_reserved_stock -= $amount;
+        $this->save();
     }
 
     public function reserve(int $amount, bool $tracksInventory): void
@@ -92,7 +113,7 @@ class Inventory extends Model
             throw new \InvalidArgumentException('La cantidad reservada no alcanza para confirmar la compra.');
         }
 
-        if ($tracksInventory && $this->real_stock < $amount) {
+        if ($tracksInventory && $this->real_stock - $this->entry_reserved_stock < $amount) {
             throw new \InvalidArgumentException('No hay suficiente stock real para confirmar la compra.');
         }
 

app/Domains/Commerce/Catalog/Models/Variant.php

@@ -2,9 +2,10 @@
 
 namespace App\Domains\Commerce\Catalog\Models;
 
-use App\Shared\Attachable\Models\Attachment;
 use App\Domains\Ticketing\Event\Models\EventDate;
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
+use App\Shared\Attachable\Models\Attachment;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
@@ -74,6 +75,12 @@ class Variant extends Model
         return $this->hasMany(Ticket::class, 'source_variant_id');
     }
 
+    /** @return HasMany<EntryReservation, $this> */
+    public function entryReservations(): HasMany
+    {
+        return $this->hasMany(EntryReservation::class);
+    }
+
     /** @return BelongsTo<Inventory, $this> */
     public function inventory(): BelongsTo
     {

app/Domains/Commerce/Catalog/Services/CatalogInventoryService.php

@@ -153,7 +153,7 @@ class CatalogInventoryService
 
                 if ($operation === 'commit'
                     && $requirement['tracks_inventory']
-                    && $inventory->real_stock < $requiredQuantity) {
+                    && $inventory->real_stock - $inventory->entry_reserved_stock < $requiredQuantity) {
                     throw new \InvalidArgumentException('No hay suficiente stock real para confirmar la compra.');
                 }
             }

app/Domains/Commerce/Catalog/Services/CatalogService.php

@@ -2,8 +2,6 @@
 
 namespace App\Domains\Commerce\Catalog\Services;
 
-use App\Shared\Attachable\Models\Attachment;
-use App\Shared\Attachable\Services\AttachmentService;
 use App\Domains\Commerce\Catalog\Enums\CatalogItemType;
 use App\Domains\Commerce\Catalog\Models\Attribute;
 use App\Domains\Commerce\Catalog\Models\CatalogItem;
@@ -11,8 +9,10 @@ use App\Domains\Commerce\Catalog\Models\Category;
 use App\Domains\Commerce\Catalog\Models\Inventory;
 use App\Domains\Commerce\Catalog\Models\ItemAttribute;
 use App\Domains\Commerce\Catalog\Models\Variant;
-use App\Domains\Ticketing\Event\Models\EventDate;
 use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Event\Models\EventDate;
+use App\Shared\Attachable\Models\Attachment;
+use App\Shared\Attachable\Services\AttachmentService;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Pagination\LengthAwarePaginator;
 use Illuminate\Support\Facades\DB;
@@ -286,9 +286,11 @@ class CatalogService
         int $perPage,
         int $page,
     ): LengthAwarePaginator {
+        $categoryIds = $this->categoryAndDescendantIds($tenant, $category);
+
         return CatalogItem::query()
             ->forTenantCatalog($tenant)
-            ->where('category_id', $category->id)
+            ->whereIn('category_id', $categoryIds)
             ->whereAvailable()
             ->with([
                 'attachments',
@@ -306,6 +308,34 @@ class CatalogService
             ->paginate(perPage: $perPage, pageName: 'page', page: $page);
     }
 
+    /** @return array<int, int> */
+    private function categoryAndDescendantIds(Tenant $tenant, Category $category): array
+    {
+        $childrenByParent = Category::query()
+            ->where('tenant_code', $tenant->codigo)
+            ->get(['id', 'categoria_id'])
+            ->groupBy('categoria_id');
+
+        $categoryIds = [];
+        $pendingIds = [$category->id];
+
+        while ($pendingIds !== []) {
+            $categoryId = array_shift($pendingIds);
+
+            if (isset($categoryIds[$categoryId])) {
+                continue;
+            }
+
+            $categoryIds[$categoryId] = $categoryId;
+
+            foreach ($childrenByParent->get($categoryId, collect()) as $child) {
+                $pendingIds[] = $child->id;
+            }
+        }
+
+        return array_values($categoryIds);
+    }
+
     public function delete(CatalogItem $catalogItem): void
     {
         DB::transaction(function () use ($catalogItem): void {

app/Domains/Commerce/Catalog/Services/StockReservationService.php

@@ -225,7 +225,7 @@ class StockReservationService
                 $inventory = $inventories->get($line->inventory_id)
                     ?? throw new \InvalidArgumentException('No se encontró el inventario reservado.');
                 if ($inventory->reserved_stock < $line->quantity
-                    || ($line->tracks_inventory && $inventory->real_stock < $line->quantity)) {
+                    || ($line->tracks_inventory && $inventory->real_stock - $inventory->entry_reserved_stock < $line->quantity)) {
                     throw new \InvalidArgumentException('La reserva de stock no alcanza para confirmar la compra.');
                 }
             }

app/Domains/Commerce/Catalog/Services/VariantReplacementService.php

@@ -8,6 +8,7 @@ use App\Domains\Commerce\Catalog\Models\StockReservation;
 use App\Domains\Commerce\Catalog\Models\StockReservationLine;
 use App\Domains\Commerce\Catalog\Models\Variant;
 use App\Domains\Ticketing\Event\Models\EventDate;
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
 use Illuminate\Support\Collection;
 
 class VariantReplacementService
@@ -190,6 +191,7 @@ class VariantReplacementService
             'sold_units' => $sourceInventory->sold_units,
             'refunded_units' => $sourceInventory->refunded_units,
             'reserved_stock' => $reservedStock,
+            'entry_reserved_stock' => $sourceInventory->entry_reserved_stock,
             'real_stock' => $sourceInventory->real_stock,
         ]);
 
@@ -198,7 +200,9 @@ class VariantReplacementService
                 ->whereKey($activeLines->modelKeys())
                 ->update(['inventory_id' => $replacementInventory->getKey()]);
         }
-        $sourceInventory->update(['reserved_stock' => 0]);
+        EntryReservation::query()->where('inventory_id', $sourceInventory->id)
+            ->update(['inventory_id' => $replacementInventory->id]);
+        $sourceInventory->update(['reserved_stock' => 0, 'entry_reserved_stock' => 0]);
 
         return $replacementInventory;
     }
@@ -235,6 +239,7 @@ class VariantReplacementService
         $destinationInventory->update([
             'real_stock' => $destinationInventory->real_stock + $sourceInventory->real_stock,
             'reserved_stock' => $destinationInventory->reserved_stock + $sourceInventory->reserved_stock,
+            'entry_reserved_stock' => $destinationInventory->entry_reserved_stock + $sourceInventory->entry_reserved_stock,
             'sold_units' => $destinationInventory->sold_units + $sourceInventory->sold_units,
             'refunded_units' => $destinationInventory->refunded_units + $sourceInventory->refunded_units,
         ]);
@@ -243,9 +248,12 @@ class VariantReplacementService
                 ->whereKey($activeLines->modelKeys())
                 ->update(['inventory_id' => $destinationInventory->getKey()]);
         }
+        EntryReservation::query()->where('inventory_id', $sourceInventory->id)
+            ->update(['inventory_id' => $destinationInventory->id]);
         $sourceInventory->update([
             'real_stock' => 0,
             'reserved_stock' => 0,
+            'entry_reserved_stock' => 0,
             'sold_units' => 0,
             'refunded_units' => 0,
         ]);

app/Domains/Commerce/Purchase/Controllers/PurchaseController.php

@@ -2,7 +2,6 @@
 
 namespace App\Domains\Commerce\Purchase\Controllers;
 
-use App\Shared\Integration\Services\TelepagosIntegrationService;
 use App\Domains\Commerce\Purchase\Models\Purchase;
 use App\Domains\Commerce\Purchase\Requests\PaymentIntentRequest;
 use App\Domains\Commerce\Purchase\Requests\StartCheckoutRequest;
@@ -13,6 +12,7 @@ use App\Domains\Commerce\Purchase\Services\CheckoutService;
 use App\Domains\Commerce\Purchase\Services\PurchaseStateGuard;
 use App\Domains\Core\Tenant\Models\Tenant;
 use App\Http\Controllers\Controller;
+use App\Shared\Integration\Services\TelepagosIntegrationService;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
@@ -151,11 +151,14 @@ class PurchaseController extends Controller
         }
 
         $compra->refresh();
+        $compra->loadMissing('event');
         $totalAmount = (float) $compra->total;
 
         if ($method === 'transfer') {
             $telepagosService = new TelepagosIntegrationService;
-            $telepagosService->forTenant($tenant->codigo);
+            $compra->event
+                ? $telepagosService->forEvent($compra->event)
+                : $telepagosService->forTenant($tenant->codigo);
 
             try {
                 $accountInfo = $telepagosService->getAccountInfo();
@@ -191,7 +194,9 @@ class PurchaseController extends Controller
 
         if ($method === 'qr') {
             $telepagosService = new TelepagosIntegrationService;
-            $telepagosService->forTenant($tenant->codigo);
+            $compra->event
+                ? $telepagosService->forEvent($compra->event)
+                : $telepagosService->forTenant($tenant->codigo);
 
             try {
                 Log::channel('telepagos')->info('Generating Telepagos QR.', [

app/Domains/Commerce/Purchase/Models/Purchase.php

@@ -2,13 +2,14 @@
 
 namespace App\Domains\Commerce\Purchase\Models;
 
-use App\Domains\Core\Auth\Models\User;
 use App\Domains\Commerce\Cart\Models\Cart;
 use App\Domains\Commerce\Catalog\Models\StockReservation;
-use App\Shared\Logging\Models\Concerns\LogsValueChanges;
 use App\Domains\Commerce\Purchase\Events\PurchasePaid;
+use App\Domains\Core\Auth\Models\User;
 use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Event\Models\Event;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
+use App\Shared\Logging\Models\Concerns\LogsValueChanges;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
@@ -21,6 +22,7 @@ use Illuminate\Support\Facades\DB;
 #[Fillable([
     'cart_id',
     'stock_reservation_id',
+    'event_id',
     'tenant_codigo',
     'user_id',
     'status',
@@ -149,6 +151,7 @@ class Purchase extends Model
         return [
             'cart_id' => 'integer',
             'stock_reservation_id' => 'integer',
+            'event_id' => 'integer',
             'user_id' => 'integer',
             'total' => 'decimal:2',
         ];
@@ -162,6 +165,12 @@ class Purchase extends Model
         return $this->belongsTo(Tenant::class, 'tenant_codigo', 'codigo');
     }
 
+    /** @return BelongsTo<Event, $this> */
+    public function event(): BelongsTo
+    {
+        return $this->belongsTo(Event::class);
+    }
+
     /**
      * @return BelongsTo<User, $this>
      */

app/Domains/Commerce/Purchase/Resources/PurchaseResource.php

@@ -36,11 +36,11 @@ class PurchaseResource extends JsonResource
                 === StorefrontWebsiteType::CHECKOUT_SUMMARY_EVENT;
         /** @var Event|null $checkoutEvent */
         $checkoutEvent = $usesEventSummary
-            ? $items
+            ? ($this->event ?? $items
                 ->map(fn (PurchaseItem $item) => $item->sourceCatalogItem?->event)
                 ->filter()
                 ->unique('id')
-                ->first()
+                ->first())
             : null;
 
         $subtotal = $items->isNotEmpty()
@@ -62,6 +62,7 @@ class PurchaseResource extends JsonResource
         return [
             'id' => $this->id,
             'cart_id' => $this->cart_id,
+            'event_id' => $this->event_id,
             'tenant_codigo' => $this->tenant_codigo,
             'user_id' => $this->user_id,
             'created_at' => $this->created_at,

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

@@ -14,6 +14,7 @@ class PurchaseResponseLoader
             === StorefrontWebsiteType::CHECKOUT_SUMMARY_EVENT;
         $relations = [
             'tenant',
+            'event.attachment',
             'items.sourceCatalogItem.event.attachment',
             'stockReservation',
         ];

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

@@ -206,6 +206,7 @@ class StartCheckoutService
                 fn (array $line): float => $line['selection']->getPrice() * $line['quantity'],
             ),
             $cart->getKey(),
+            $cartItems->first()?->catalogItem?->event_id,
         );
         $cart->update(['current_purchase_id' => $purchase->getKey()]);
         $this->reservations->attachToPurchase($cart, $purchase, $this->checkoutExpiration());
@@ -273,6 +274,7 @@ class StartCheckoutService
             $purchaseData,
             $cart->getTotalAmount(),
             $cart->getKey(),
+            $cartItems->first()?->catalogItem?->event_id,
         );
         $cart->update(['current_purchase_id' => $purchase->getKey()]);
         $this->reservations->attachToPurchase($cart, $purchase, $this->checkoutExpiration());
@@ -410,10 +412,12 @@ class StartCheckoutService
         array $purchaseData,
         float $total,
         ?int $cartId,
+        ?int $eventId,
     ): Purchase {
         return Purchase::query()->create([
             ...$purchaseData,
             'cart_id' => $cartId,
+            'event_id' => $eventId,
             'tenant_codigo' => $tenant->codigo,
             'user_id' => $userId,
             'status' => Purchase::STATUS_CREATED,

app/Domains/Commerce/Purchase/Services/PurchaseRefundSummaryService.php

@@ -8,12 +8,14 @@ use Illuminate\Database\Eloquent\Builder;
 
 class PurchaseRefundSummaryService
 {
-    public function totalForTenant(Tenant $tenant): string
+    public function totalForTenant(Tenant $tenant, ?int $eventId = null): string
     {
         $total = TicketRefund::query()
             ->whereHas(
                 'purchaseItem.purchase',
-                fn (Builder $query): Builder => $query->where('tenant_codigo', $tenant->codigo)
+                fn (Builder $query): Builder => $query
+                    ->where('tenant_codigo', $tenant->codigo)
+                    ->when($eventId !== null, fn (Builder $query): Builder => $query->where('event_id', $eventId))
             )
             ->sum('amount');
 

app/Domains/Commerce/Purchase/Services/TenantTransactionResetService.php

@@ -25,6 +25,8 @@ class TenantTransactionResetService
             'carts' => $scope['cart_ids']->count(),
             'cart_items' => $scope['cart_item_ids']->count(),
             'tickets' => DB::table('tickets')->where('tenant_code', $tenantCode)->count(),
+            'entry_reservations' => DB::table('entry_reservations')
+                ->whereIn('catalog_item_id', DB::table('catalog_items')->where('tenant_code', $tenantCode)->select('id'))->count(),
             'stock_reservations' => $this->reservationQuery($scope)->count(),
             'purchase_changes' => DB::table('value_changes')
                 ->where('tenant_code', $tenantCode)
@@ -47,6 +49,9 @@ class TenantTransactionResetService
             $telepagosQr = DB::table('telepagos_qr')->whereIn('compra_id', $scope['purchase_ids'])->count();
             $summary = [
                 'stock_reservations_deleted' => $this->reservationQuery($scope)->delete(),
+                'entry_reservations_deleted' => DB::table('entry_reservations')
+                    ->whereIn('catalog_item_id', DB::table('catalog_items')->where('tenant_code', $tenantCode)->select('id'))->delete(),
+                'entry_reservation_batches_deleted' => DB::table('reservation_batches')->where('tenant_code', $tenantCode)->delete(),
                 'tickets_deleted' => DB::table('tickets')->where('tenant_code', $tenantCode)->delete(),
                 'purchase_changes_deleted' => DB::table('value_changes')
                     ->where('tenant_code', $tenantCode)
@@ -67,6 +72,7 @@ class TenantTransactionResetService
                 ->update([
                     'real_stock' => DB::raw('real_stock + sold_units - refunded_units'),
                     'reserved_stock' => 0,
+                    'entry_reserved_stock' => 0,
                     'sold_units' => 0,
                     'refunded_units' => 0,
                 ]);

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

@@ -32,10 +32,10 @@ class SaleController extends Controller
         $tenant = $request->user()->tenant()->firstOrFail();
 
         return SaleResource::collection(
-            $this->saleService->sales($tenant, $request->validated())
+            $this->saleService->sales($tenant, $request->validated(), $request->user()->event_id)
         )->additional([
-            'confirmed_sales_total' => $this->saleService->confirmedSalesTotal($tenant),
-            'refunded_total' => $this->saleService->refundedTotal($tenant),
+            'confirmed_sales_total' => $this->saleService->confirmedSalesTotal($tenant, $request->user()->event_id),
+            'refunded_total' => $this->saleService->refundedTotal($tenant, $request->user()->event_id),
         ]);
     }
 
@@ -43,7 +43,7 @@ class SaleController extends Controller
     {
         $tenant = $request->user()->tenant()->firstOrFail();
 
-        return new SaleDetailResource($this->saleService->detail($tenant, $sale));
+        return new SaleDetailResource($this->saleService->detail($tenant, $sale, $request->user()->event_id));
     }
 
     public function tickets(Request $request, int $sale): AnonymousResourceCollection
@@ -51,7 +51,7 @@ class SaleController extends Controller
         $tenant = $request->user()->tenant()->firstOrFail();
 
         return SaleTicketResource::collection(
-            $this->saleService->tickets($tenant, $sale)
+            $this->saleService->tickets($tenant, $sale, $request->user()->event_id)
         );
     }
 
@@ -59,14 +59,14 @@ class SaleController extends Controller
     {
         $tenant = $request->user()->tenant()->firstOrFail();
 
-        return new SaleResource($this->saleService->confirm($tenant, $sale));
+        return new SaleResource($this->saleService->confirm($tenant, $sale, $request->user()->event_id));
     }
 
     public function cancel(Request $request, int $sale): SaleResource
     {
         $tenant = $request->user()->tenant()->firstOrFail();
 
-        return new SaleResource($this->saleService->cancel($tenant, $sale));
+        return new SaleResource($this->saleService->cancel($tenant, $sale, $request->user()->event_id));
     }
 
     public function modifications(
@@ -76,6 +76,7 @@ class SaleController extends Controller
             $this->saleService->modifications(
                 $request->user()->tenant()->firstOrFail(),
                 $request->validated(),
+                $request->user()->event_id,
             )
         );
     }
@@ -86,7 +87,7 @@ class SaleController extends Controller
 
         return $this->salePdfService->downloadSales(
             $tenant,
-            $this->saleService->salesForExport($tenant, $request->validated()),
+            $this->saleService->salesForExport($tenant, $request->validated(), $request->user()->event_id),
             $request->validated('timezone'),
         );
     }
@@ -97,7 +98,7 @@ class SaleController extends Controller
 
         return $this->salePdfService->downloadModifications(
             $tenant,
-            $this->saleService->modificationsForExport($tenant, $request->validated()),
+            $this->saleService->modificationsForExport($tenant, $request->validated(), $request->user()->event_id),
             $request->validated('timezone'),
         );
     }
@@ -108,7 +109,7 @@ class SaleController extends Controller
 
         return $this->saleExcelService->downloadSales(
             $tenant,
-            $this->saleService->salesForExport($tenant, $request->validated()),
+            $this->saleService->salesForExport($tenant, $request->validated(), $request->user()->event_id),
             $request->validated('timezone'),
         );
     }
@@ -120,7 +121,7 @@ class SaleController extends Controller
 
         return $this->saleExcelService->downloadModifications(
             $tenant,
-            $this->saleService->modificationsForExport($tenant, $request->validated()),
+            $this->saleService->modificationsForExport($tenant, $request->validated(), $request->user()->event_id),
             $request->validated('timezone'),
         );
     }

app/Domains/Commerce/Sale/Services/AdminAppSaleService.php

@@ -2,7 +2,6 @@
 
 namespace App\Domains\Commerce\Sale\Services;
 
-use App\Shared\Logging\Models\ValueChange;
 use App\Domains\Commerce\Purchase\Models\Purchase;
 use App\Domains\Commerce\Purchase\Services\CheckoutService;
 use App\Domains\Commerce\Purchase\Services\PurchaseRefundSummaryService;
@@ -10,6 +9,7 @@ use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
 use App\Domains\Ticketing\Ticket\Services\TicketPresentationResolver;
 use App\Domains\Ticketing\Ticket\Services\TicketValidityResolver;
+use App\Shared\Logging\Models\ValueChange;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Pagination\LengthAwarePaginator;
 use Illuminate\Support\Collection;
@@ -21,19 +21,18 @@ class AdminAppSaleService
         protected PurchaseRefundSummaryService $refundSummaryService,
     ) {}
 
-    public function confirmedSalesTotal(Tenant $tenant): string
+    public function confirmedSalesTotal(Tenant $tenant, ?int $eventId = null): string
     {
-        $total = Purchase::query()
-            ->where('tenant_codigo', $tenant->codigo)
+        $total = $this->purchasesQuery($tenant, $eventId)
             ->where('status', Purchase::STATUS_PAID)
             ->sum('total');
 
         return number_format((float) $total, 2, '.', '');
     }
 
-    public function refundedTotal(Tenant $tenant): string
+    public function refundedTotal(Tenant $tenant, ?int $eventId = null): string
     {
-        return $this->refundSummaryService->totalForTenant($tenant);
+        return $this->refundSummaryService->totalForTenant($tenant, $eventId);
     }
 
     /**
@@ -47,43 +46,42 @@ class AdminAppSaleService
      * }  $filters
      * @return LengthAwarePaginator<Purchase>
      */
-    public function sales(Tenant $tenant, array $filters = []): LengthAwarePaginator
+    public function sales(Tenant $tenant, array $filters = [], ?int $eventId = null): LengthAwarePaginator
     {
-        return $this->salesQuery($tenant, $filters)
+        return $this->salesQuery($tenant, $filters, $eventId)
             ->paginateFromRequest()
             ->withQueryString();
     }
 
-    public function detail(Tenant $tenant, int $saleId): Purchase
+    public function detail(Tenant $tenant, int $saleId, ?int $eventId = null): Purchase
     {
-        return Purchase::query()
-            ->where('tenant_codigo', $tenant->codigo)
+        return $this->purchasesQuery($tenant, $eventId)
             ->with('items')
             ->findOrFail($saleId);
     }
 
     /** @return Collection<int, Ticket> */
-    public function tickets(Tenant $tenant, int $saleId): Collection
+    public function tickets(Tenant $tenant, int $saleId, ?int $eventId = null): Collection
     {
-        return $this->findForTenant($tenant, $saleId)
+        return $this->findForTenant($tenant, $saleId, $eventId)
             ->tickets()
             ->with([...TicketValidityResolver::RELATIONS, ...TicketPresentationResolver::RELATIONS, 'refund'])
             ->orderBy('id')
             ->get();
     }
 
-    public function confirm(Tenant $tenant, int $saleId): Purchase
+    public function confirm(Tenant $tenant, int $saleId, ?int $eventId = null): Purchase
     {
-        $sale = $this->findForTenant($tenant, $saleId);
+        $sale = $this->findForTenant($tenant, $saleId, $eventId);
 
         return $this->saleForResponse(
             $this->checkoutService->confirmPaidPurchase($sale)
         );
     }
 
-    public function cancel(Tenant $tenant, int $saleId): Purchase
+    public function cancel(Tenant $tenant, int $saleId, ?int $eventId = null): Purchase
     {
-        $sale = $this->findForTenant($tenant, $saleId);
+        $sale = $this->findForTenant($tenant, $saleId, $eventId);
 
         return $this->saleForResponse(
             $this->checkoutService->cancelPurchaseFromAdmin($sale)
@@ -94,18 +92,18 @@ class AdminAppSaleService
      * @param  array<string, mixed>  $filters
      * @return Collection<int, Purchase>
      */
-    public function salesForExport(Tenant $tenant, array $filters = []): Collection
+    public function salesForExport(Tenant $tenant, array $filters = [], ?int $eventId = null): Collection
     {
-        return $this->salesQuery($tenant, $filters)->get();
+        return $this->salesQuery($tenant, $filters, $eventId)->get();
     }
 
     /**
      * @param  array<string, mixed>  $filters
      * @return LengthAwarePaginator<ValueChange>
      */
-    public function modifications(Tenant $tenant, array $filters = []): LengthAwarePaginator
+    public function modifications(Tenant $tenant, array $filters = [], ?int $eventId = null): LengthAwarePaginator
     {
-        return $this->modificationsQuery($tenant, $filters)
+        return $this->modificationsQuery($tenant, $filters, $eventId)
             ->paginateFromRequest()
             ->withQueryString();
     }
@@ -114,13 +112,13 @@ class AdminAppSaleService
      * @param  array<string, mixed>  $filters
      * @return Collection<int, ValueChange>
      */
-    public function modificationsForExport(Tenant $tenant, array $filters = []): Collection
+    public function modificationsForExport(Tenant $tenant, array $filters = [], ?int $eventId = null): Collection
     {
-        return $this->modificationsQuery($tenant, $filters)->get();
+        return $this->modificationsQuery($tenant, $filters, $eventId)->get();
     }
 
     /** @param array<string, mixed> $filters */
-    protected function salesQuery(Tenant $tenant, array $filters): Builder
+    protected function salesQuery(Tenant $tenant, array $filters, ?int $eventId = null): Builder
     {
         $sortColumns = [
             'id' => 'id',
@@ -137,8 +135,7 @@ class AdminAppSaleService
             ? $requestedDirection
             : 'desc';
 
-        return Purchase::query()
-            ->where('tenant_codigo', $tenant->codigo)
+        return $this->purchasesQuery($tenant, $eventId)
             ->when($filters['q'] ?? null, function (Builder $query, string $search): void {
                 $term = trim($search);
 
@@ -176,11 +173,18 @@ class AdminAppSaleService
      * @param  array<string, mixed>  $filters
      * @return Builder<ValueChange>
      */
-    protected function modificationsQuery(Tenant $tenant, array $filters): Builder
+    protected function modificationsQuery(Tenant $tenant, array $filters, ?int $eventId = null): Builder
     {
         return ValueChange::query()
             ->where('tenant_code', $tenant->codigo)
             ->where('trackable_type', (new Purchase)->getMorphClass())
+            ->when($eventId !== null, fn (Builder $query): Builder => $query->whereHasMorph(
+                'trackable',
+                [Purchase::class],
+                fn (Builder $sales): Builder => $sales
+                    ->where('tenant_codigo', $tenant->codigo)
+                    ->where('event_id', $eventId),
+            ))
             ->when($filters['q'] ?? null, function (Builder $query, string $search): void {
                 $term = trim($search);
 
@@ -221,11 +225,18 @@ class AdminAppSaleService
             ->orderByDesc('id');
     }
 
-    protected function findForTenant(Tenant $tenant, int $saleId): Purchase
+    protected function findForTenant(Tenant $tenant, int $saleId, ?int $eventId = null): Purchase
+    {
+        return $this->purchasesQuery($tenant, $eventId)
+            ->findOrFail($saleId);
+    }
+
+    /** @return Builder<Purchase> */
+    protected function purchasesQuery(Tenant $tenant, ?int $eventId): Builder
     {
         return Purchase::query()
             ->where('tenant_codigo', $tenant->codigo)
-            ->findOrFail($saleId);
+            ->when($eventId !== null, fn (Builder $query): Builder => $query->where('event_id', $eventId));
     }
 
     protected function saleForResponse(Purchase $sale): Purchase

app/Domains/Commerce/Sale/documentacion/README.md

@@ -29,4 +29,8 @@ Consume compras de `Purchase`, datos del tenant y entradas de `Logging`. No es d
 
 La consulta paginada y la colección de exportación deben aplicar los mismos filtros para evitar diferencias entre pantalla, PDF y Excel.
 
+Cuando el usuario autenticado tiene `event_id`, el controlador lo pasa al servicio como alcance obligatorio para ventas, totales, historial y exportaciones. El alcance se combina con el tenant y no se obtiene de los filtros enviados por el cliente. Los administradores sin `event_id` conservan el alcance del tenant.
+
+El detalle, los tickets de una venta, la confirmación y la cancelación buscan la compra dentro del mismo alcance. Una venta de otro evento o sin evento devuelve 404 para un administrador con `event_id`, antes de ejecutar cualquier acción en `CheckoutService`.
+
 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/Core/Administrator/Controllers/AdminAppAdministratorController.php

@@ -20,6 +20,7 @@ class AdminAppAdministratorController extends Controller
         return AdministratorResource::collection($this->administratorService->list(
             $request->user()->tenant()->firstOrFail(),
             $request->string('search')->trim()->toString() ?: null,
+            $request->user()->event_id,
         ));
     }
 
@@ -28,6 +29,7 @@ class AdminAppAdministratorController extends Controller
         return AdministratorResource::make($this->administratorService->create(
             $request->user()->tenant()->firstOrFail(),
             $request->validated(),
+            $request->user()->event_id,
         ));
     }
 
@@ -37,6 +39,7 @@ class AdminAppAdministratorController extends Controller
             $request->user()->tenant()->firstOrFail(),
             $administrator,
             $request->validated(),
+            $request->user()->event_id,
         ));
     }
 

app/Domains/Core/Administrator/Resources/AdministratorResource.php

@@ -18,6 +18,7 @@ class AdministratorResource extends JsonResource
             'dni' => $this->dni,
             'email' => $this->email,
             'rol_codigo' => $this->rol_codigo,
+            'event_id' => $this->event_id,
             'role' => $this->whenLoaded('role', fn () => [
                 'codigo' => $this->role?->codigo,
                 'nombre' => $this->role?->nombre,

app/Domains/Core/Administrator/Services/AdministratorService.php

@@ -19,9 +19,9 @@ class AdministratorService
     public function __construct(private readonly ResetPasswordAttemptService $resetPasswordAttemptService) {}
 
     /** @return Collection<int, User> */
-    public function list(Tenant $tenant, ?string $search = null): Collection
+    public function list(Tenant $tenant, ?string $search = null, ?int $eventId = null): Collection
     {
-        return $this->query($tenant)->with('role')
+        return $this->query($tenant, $eventId)->with('role')
             ->when($search, fn (Builder $query, string $search) => $query->where(function (Builder $query) use ($search): void {
                 $query->where('nombre_apellido', 'like', "%{$search}%")
                     ->orWhere('dni', 'like', "%{$search}%")
@@ -31,14 +31,15 @@ class AdministratorService
     }
 
     /** @param array<string, mixed> $data */
-    public function create(Tenant $tenant, array $data): User
+    public function create(Tenant $tenant, array $data, ?int $eventId = null): User
     {
-        return DB::transaction(function () use ($tenant, $data): User {
+        return DB::transaction(function () use ($tenant, $data, $eventId): User {
             $administrator = User::query()->create([
                 ...$this->attributes($data),
                 'password' => Str::random(64),
                 'rol_codigo' => RoleCode::AdminApp->value,
                 'tenant_codigo' => $tenant->codigo,
+                'event_id' => $eventId,
             ]);
             $this->resetPasswordAttemptService->createForAdminAppEmail(
                 $administrator->email,
@@ -50,10 +51,10 @@ class AdministratorService
     }
 
     /** @param array<string, mixed> $data */
-    public function update(Tenant $tenant, int $administratorId, array $data): User
+    public function update(Tenant $tenant, int $administratorId, array $data, ?int $eventId = null): User
     {
-        return DB::transaction(function () use ($tenant, $administratorId, $data): User {
-            $administrator = $this->query($tenant)->lockForUpdate()->findOrFail($administratorId);
+        return DB::transaction(function () use ($tenant, $administratorId, $data, $eventId): User {
+            $administrator = $this->query($tenant, $eventId)->lockForUpdate()->findOrFail($administratorId);
             $administrator->update($this->attributes($data));
 
             return $administrator->load('role');
@@ -66,11 +67,11 @@ class AdministratorService
             // Serialize deletions for this tenant, including requests already authenticated
             // when another administrator removes their account.
             Tenant::query()->whereKey($tenant->getKey())->lockForUpdate()->firstOrFail();
-            $administrator = $this->query($tenant)->lockForUpdate()->findOrFail($administratorId);
+            $administrator = $this->query($tenant, $actor->event_id)->lockForUpdate()->findOrFail($administratorId);
             if ($administrator->is($actor)) {
                 throw ValidationException::withMessages(['administrator' => 'No podés eliminar tu propio usuario.']);
             }
-            $activeAdministrators = $this->query($tenant)->lockForUpdate()->get();
+            $activeAdministrators = $this->query($tenant, $actor->event_id)->lockForUpdate()->get();
             if ($activeAdministrators->count() <= 1) {
                 throw ValidationException::withMessages(['administrator' => 'El tenant debe conservar al menos un administrador.']);
             }
@@ -80,10 +81,11 @@ class AdministratorService
         });
     }
 
-    private function query(Tenant $tenant): Builder
+    private function query(Tenant $tenant, ?int $eventId = null): Builder
     {
         return User::query()->where('tenant_codigo', $tenant->codigo)
-            ->where('rol_codigo', RoleCode::AdminApp->value);
+            ->where('rol_codigo', RoleCode::AdminApp->value)
+            ->when($eventId !== null, fn (Builder $query): Builder => $query->where('event_id', $eventId));
     }
 
     /** @param array<string, mixed> $data

app/Domains/Core/Administrator/documentacion/README.md

@@ -55,6 +55,8 @@ No agrega tablas ni migraciones. No modifica el CRUD de escáneres ni el fronten
 
 ## Verificación
 
+Cuando el actor tiene `event_id`, los nuevos administradores heredan su evento y el listado, la búsqueda, la edición y la baja se limitan a ese evento dentro del tenant. La comprobación de administradores activos también usa ese alcance. El evento se toma del usuario autenticado, no del cuerpo de la solicitud; sin `event_id` se conserva el comportamiento por tenant.
+
 `php artisan test tests/Feature/Administrator/AdministratorControllerTest.php`
 
 Las pruebas cubren CRUD, normalización y unicidad del email, establecimiento de

app/Domains/Core/Auth/Models/User.php

@@ -2,11 +2,12 @@
 
 namespace App\Domains\Core\Auth\Models;
 
+use App\Domains\Commerce\Catalog\Models\Category;
 use App\Domains\Core\Authorization\Enums\RoleCode;
 use App\Domains\Core\Authorization\Models\Role;
-use App\Domains\Commerce\Catalog\Models\Category;
-use App\Domains\Ticketing\Event\Models\EventDateChangeView;
 use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Event\Models\Event;
+use App\Domains\Ticketing\Event\Models\EventDateChangeView;
 use App\Domains\Ticketing\Ticket\Models\ScanAttempt;
 use Database\Factories\UserFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
@@ -20,7 +21,7 @@ use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
 use Laravel\Sanctum\HasApiTokens;
 
-#[Fillable(['nombre_apellido', 'email', 'password', 'dni', 'telefono', 'google_id', 'rol_codigo', 'tenant_codigo'])]
+#[Fillable(['nombre_apellido', 'email', 'password', 'dni', 'telefono', 'google_id', 'rol_codigo', 'tenant_codigo', 'event_id'])]
 #[Hidden(['password', 'remember_token', 'active_email', 'active_google_id'])]
 class User extends Authenticatable
 {
@@ -86,6 +87,12 @@ class User extends Authenticatable
         return $this->belongsTo(Tenant::class, 'tenant_codigo', 'codigo');
     }
 
+    /** @return BelongsTo<Event, $this> */
+    public function event(): BelongsTo
+    {
+        return $this->belongsTo(Event::class);
+    }
+
     /** @return BelongsToMany<Category, $this> */
     public function scanCategories(): BelongsToMany
     {
@@ -103,6 +110,7 @@ class User extends Authenticatable
     protected function casts(): array
     {
         return [
+            'event_id' => 'integer',
             'email_verified_at' => 'datetime',
             'password' => 'hashed',
             'failed_login_attempts' => 'integer',

app/Domains/Core/Auth/Resources/UserResource.php

@@ -24,6 +24,7 @@ class UserResource extends JsonResource
             'telefono' => $this->telefono,
             'rol_codigo' => $this->rol_codigo,
             'tenant_codigo' => $this->tenant_codigo,
+            'event_id' => $this->event_id,
             'categories' => $this->whenLoaded('scanCategories', fn () => $this->scanCategories
                 ->map(fn ($category) => [
                     'id' => $category->id,

app/Domains/Core/Client/Models/Client.php

@@ -2,8 +2,9 @@
 
 namespace App\Domains\Core\Client\Models;
 
-use App\Shared\Integration\Models\ClientIntegration;
 use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Event\Models\Event;
+use App\Shared\Integration\Models\ClientIntegration;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
@@ -22,6 +23,12 @@ class Client extends Model
         return $this->hasMany(Tenant::class);
     }
 
+    /** @return HasMany<Event, $this> */
+    public function events(): HasMany
+    {
+        return $this->hasMany(Event::class);
+    }
+
     /** @return HasMany<ClientIntegration, $this> */
     public function integrations(): HasMany
     {

app/Domains/Core/Staff/Controllers/AdminAppStaffController.php

@@ -26,6 +26,7 @@ class AdminAppStaffController extends Controller
         return StaffResource::collection($this->staffService->list(
             $request->user()->tenant()->firstOrFail(),
             $request->string('search')->trim()->toString() ?: null,
+            $request->user()->event_id,
         ));
     }
 
@@ -34,6 +35,7 @@ class AdminAppStaffController extends Controller
         return StaffResource::make($this->staffService->create(
             $request->user()->tenant()->firstOrFail(),
             $request->validated(),
+            $request->user()->event_id,
         ));
     }
 
@@ -43,12 +45,13 @@ class AdminAppStaffController extends Controller
             $request->user()->tenant()->firstOrFail(),
             $staff,
             $request->validated(),
+            $request->user()->event_id,
         ));
     }
 
     public function destroy(Request $request, int $staff): Response
     {
-        $this->staffService->delete($request->user()->tenant()->firstOrFail(), $staff);
+        $this->staffService->delete($request->user()->tenant()->firstOrFail(), $staff, $request->user()->event_id);
 
         return response()->noContent();
     }
@@ -60,6 +63,7 @@ class AdminAppStaffController extends Controller
         $scanner = $this->staffService->find(
             $request->user()->tenant()->firstOrFail(),
             $staff,
+            $request->user()->event_id,
         );
 
         return ScanAttemptResource::collection(

app/Domains/Core/Staff/Resources/StaffResource.php

@@ -18,6 +18,7 @@ class StaffResource extends JsonResource
             'dni' => $this->dni,
             'email' => $this->email,
             'rol_codigo' => $this->rol_codigo,
+            'event_id' => $this->event_id,
             'role' => $this->whenLoaded('role', fn () => [
                 'codigo' => $this->role?->codigo,
                 'nombre' => $this->role?->nombre,

app/Domains/Core/Staff/Services/StaffService.php

@@ -2,11 +2,11 @@
 
 namespace App\Domains\Core\Staff\Services;
 
+use App\Domains\Commerce\Catalog\Models\Category;
 use App\Domains\Core\Auth\Models\ResetPasswordAttempt;
 use App\Domains\Core\Auth\Models\User;
 use App\Domains\Core\Auth\Services\ResetPasswordAttemptService;
 use App\Domains\Core\Authorization\Enums\RoleCode;
-use App\Domains\Commerce\Catalog\Models\Category;
 use App\Domains\Core\Tenant\Models\Tenant;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Collection;
@@ -22,9 +22,9 @@ class StaffService
     ) {}
 
     /** @return Collection<int, User> */
-    public function list(Tenant $tenant, ?string $search = null): Collection
+    public function list(Tenant $tenant, ?string $search = null, ?int $eventId = null): Collection
     {
-        return $this->staffQuery($tenant)
+        return $this->staffQuery($tenant, $eventId)
             ->with(['role', 'scanCategories' => fn ($query) => $query->orderBy('nombre')])
             ->when($search, function (Builder $query, string $search): void {
                 $query->where(function (Builder $query) use ($search): void {
@@ -52,18 +52,19 @@ class StaffService
     }
 
     /** @param array<string, mixed> $data */
-    public function create(Tenant $tenant, array $data): User
+    public function create(Tenant $tenant, array $data, ?int $eventId = null): User
     {
         $categoryIds = $this->categoryIdsFor($tenant, $data);
         $this->assertCategoriesBelongToTenant($tenant, $categoryIds);
 
-        return DB::transaction(function () use ($tenant, $data, $categoryIds): User {
+        return DB::transaction(function () use ($tenant, $data, $categoryIds, $eventId): User {
             $staff = User::query()->create([
                 ...Arr::only($data, ['nombre_apellido', 'dni', 'email']),
                 'email' => mb_strtolower(trim((string) $data['email'])),
                 'password' => Str::random(64),
                 'rol_codigo' => RoleCode::Scanner->value,
                 'tenant_codigo' => $tenant->codigo,
+                'event_id' => $eventId,
             ]);
             $staff->scanCategories()->sync($categoryIds);
             $this->resetPasswordAttemptService->createForScannerEmail(
@@ -76,9 +77,9 @@ class StaffService
     }
 
     /** @param array<string, mixed> $data */
-    public function update(Tenant $tenant, int $staffId, array $data): User
+    public function update(Tenant $tenant, int $staffId, array $data, ?int $eventId = null): User
     {
-        $staff = $this->find($tenant, $staffId);
+        $staff = $this->find($tenant, $staffId, $eventId);
         $categoryIds = $this->categoryIdsFor($tenant, $data);
         $this->assertCategoriesBelongToTenant($tenant, $categoryIds);
 
@@ -92,9 +93,9 @@ class StaffService
         });
     }
 
-    public function delete(Tenant $tenant, int $staffId): void
+    public function delete(Tenant $tenant, int $staffId, ?int $eventId = null): void
     {
-        $staff = $this->find($tenant, $staffId);
+        $staff = $this->find($tenant, $staffId, $eventId);
 
         DB::transaction(function () use ($staff): void {
             $staff->tokens()->delete();
@@ -102,16 +103,17 @@ class StaffService
         });
     }
 
-    public function find(Tenant $tenant, int $staffId): User
+    public function find(Tenant $tenant, int $staffId, ?int $eventId = null): User
     {
-        return $this->staffQuery($tenant)->findOrFail($staffId);
+        return $this->staffQuery($tenant, $eventId)->findOrFail($staffId);
     }
 
-    private function staffQuery(Tenant $tenant): Builder
+    private function staffQuery(Tenant $tenant, ?int $eventId = null): Builder
     {
         return User::query()
             ->where('tenant_codigo', $tenant->codigo)
-            ->where('rol_codigo', RoleCode::Scanner->value);
+            ->where('rol_codigo', RoleCode::Scanner->value)
+            ->when($eventId !== null, fn (Builder $query): Builder => $query->where('event_id', $eventId));
     }
 
     /**

app/Domains/Core/Staff/documentacion/README.md

@@ -18,3 +18,5 @@ Recurso REST `/v1/adminapp/tenant/staff`, excepto detalle individual, protegido
 ## Dependencias y reglas
 
 Usa `Auth/User` como entidad de personal, `Authorization` para su rol, `Catalog/Category` para asignaciones y `Tenant` para aislamiento. Toda búsqueda, edición o borrado debe comprobar que el usuario pertenece al tenant autenticado.
+
+Si el administrador autenticado tiene `event_id`, el alta de scanners hereda ese valor y las búsquedas, ediciones, bajas y consultas de intentos de escaneo se limitan a personal del mismo evento. El cliente no puede elegir ni cambiar el evento. Sin `event_id`, se mantiene el alcance por tenant.

app/Domains/Ticketing/Desfile/Controllers/DesfileEntryReservationController.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Controllers;
+
+use App\Domains\Ticketing\Desfile\Requests\ExportEntryReservationsRequest;
+use App\Domains\Ticketing\Desfile\Requests\IndexEntryReservationsRequest;
+use App\Domains\Ticketing\Desfile\Requests\StoreEntryReservationsRequest;
+use App\Domains\Ticketing\Desfile\Resources\EntryReservationResource;
+use App\Domains\Ticketing\Desfile\Services\DesfileEntryReservationService;
+use App\Domains\Ticketing\Desfile\Services\EntryReservationExcelService;
+use App\Domains\Ticketing\Desfile\Services\EntryReservationPdfService;
+use App\Domains\Ticketing\Ticket\Services\TicketPdfService;
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+use Illuminate\Http\Response;
+use Symfony\Component\HttpFoundation\StreamedResponse;
+
+class DesfileEntryReservationController extends Controller
+{
+    public function index(IndexEntryReservationsRequest $request, DesfileEntryReservationService $service): AnonymousResourceCollection
+    {
+        return EntryReservationResource::collection(
+            $service->reservations($request->user(), $request->validated()),
+        );
+    }
+
+    public function downloadPdf(
+        ExportEntryReservationsRequest $request,
+        DesfileEntryReservationService $service,
+        EntryReservationPdfService $pdf,
+    ): Response {
+        $user = $request->user();
+
+        return $pdf->download(
+            $user->tenant()->firstOrFail(),
+            $service->reservationsForExport($user, $request->validated()),
+            $request->validated('timezone'),
+        );
+    }
+
+    public function downloadExcel(
+        ExportEntryReservationsRequest $request,
+        DesfileEntryReservationService $service,
+        EntryReservationExcelService $excel,
+    ): StreamedResponse {
+        $user = $request->user();
+
+        return $excel->download(
+            $user->tenant()->firstOrFail(),
+            $service->reservationsForExport($user, $request->validated()),
+            $request->validated('timezone'),
+        );
+    }
+
+    public function downloadTicketPdf(
+        IndexEntryReservationsRequest $request,
+        int $reservation,
+        DesfileEntryReservationService $service,
+        TicketPdfService $pdf,
+    ): Response {
+        $user = $request->user();
+
+        return $pdf->download(
+            $user->tenant()->firstOrFail(),
+            collect([$service->reservationTicket($user, $reservation)]),
+        );
+    }
+
+    public function store(StoreEntryReservationsRequest $request, DesfileEntryReservationService $service): AnonymousResourceCollection
+    {
+        return EntryReservationResource::collection($service->reserve(
+            $request->user(), $request->validated('idempotency_key'), $request->validated('rows'),
+        ));
+    }
+
+    public function destroy(
+        IndexEntryReservationsRequest $request,
+        int $reservation,
+        DesfileEntryReservationService $service,
+    ): Response {
+        $service->cancel($request->user(), $reservation);
+
+        return response()->noContent();
+    }
+}

app/Domains/Ticketing/Desfile/Requests/ExportEntryReservationsRequest.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Requests;
+
+use App\Shared\Rules\ValidTimezone;
+
+class ExportEntryReservationsRequest extends IndexEntryReservationsRequest
+{
+    public function rules(): array
+    {
+        return [
+            ...parent::rules(),
+            'timezone' => ['required', 'string', new ValidTimezone],
+        ];
+    }
+}

app/Domains/Ticketing/Desfile/Requests/IndexEntryReservationsRequest.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Requests;
+
+use App\Domains\Ticketing\Ticket\Enums\EntryReservationPaymentType;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class IndexEntryReservationsRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return $this->user()?->tenant_codigo === 'desfile_pura_tendencia';
+    }
+
+    public function rules(): array
+    {
+        return [
+            'tipo_pago' => ['sometimes', 'nullable', Rule::enum(EntryReservationPaymentType::class)],
+            'page' => ['sometimes', 'integer', 'min:1'],
+            'per_page' => ['sometimes', 'integer', 'min:1', 'max:100'],
+        ];
+    }
+}

app/Domains/Ticketing/Desfile/Requests/StoreEntryReservationsRequest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Requests;
+
+use App\Domains\Ticketing\Ticket\Enums\EntryReservationPaymentType;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class StoreEntryReservationsRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return $this->user()?->tenant_codigo === 'desfile_pura_tendencia';
+    }
+
+    public function rules(): array
+    {
+        return [
+            'idempotency_key' => ['required', 'uuid'],
+            'rows' => ['required', 'array', 'min:1', 'max:100'],
+            'rows.*' => ['required', 'array:variant_id,tipo_pago'],
+            'rows.*.variant_id' => ['required', 'integer', 'min:1', 'distinct'],
+            'rows.*.tipo_pago' => ['required', Rule::enum(EntryReservationPaymentType::class)],
+        ];
+    }
+}

app/Domains/Ticketing/Desfile/Resources/EntryReservationResource.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class EntryReservationResource extends JsonResource
+{
+    public function toArray(Request $request): array
+    {
+        $selection = $this->relationLoaded('variant')
+            ? $this->variant->selectionOptions()
+            : collect();
+
+        return [
+            'id' => $this->id,
+            'catalog_item_id' => $this->catalog_item_id,
+            'variant_id' => $this->variant_id,
+            'ticket_id' => $this->ticket_id,
+            'fecha_reserva' => $this->fecha_reserva->toIso8601String(),
+            'tipo_pago' => $this->tipo_pago->value,
+            'tipo_pago_label' => $this->tipo_pago->label(),
+            'importe' => $this->importe,
+            'entrada' => [
+                'tipo' => $this->selectionLabel($selection->get('tipo')),
+                'sector' => $this->selectionLabel($selection->get('sector')),
+                'fila' => $this->selectionLabel($selection->get('fila')),
+                'asiento' => $this->selectionLabel($selection->get('asiento')),
+            ],
+        ];
+    }
+
+    private function selectionLabel(mixed $selection): ?string
+    {
+        if (! is_array($selection)) {
+            return null;
+        }
+
+        if (array_is_list($selection)) {
+            $labels = collect($selection)->pluck('label')->filter()->implode(', ');
+
+            return $labels !== '' ? $labels : null;
+        }
+
+        return isset($selection['label']) ? (string) $selection['label'] : null;
+    }
+}

app/Domains/Ticketing/Desfile/Services/DesfileEntryReservationPolicy.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Services;
+
+use App\Domains\Ticketing\Ticket\Services\EntryReservationPolicy;
+use Illuminate\Validation\ValidationException;
+
+class DesfileEntryReservationPolicy implements EntryReservationPolicy
+{
+    public function validate(array $selections): void
+    {
+        $errors = [];
+        $seen = [];
+
+        foreach ($selections as $index => $selection) {
+            $variant = $selection['variant'];
+            if ($variant === null || $selection['inventory'] === null
+                || isset($seen[$variant->id])
+                || $variant->entryReservations()->lockForUpdate()->get()->isNotEmpty()) {
+                $errors["rows.{$index}.variant_id"] = 'La entrada ya no está disponible.';
+            }
+            if ($variant !== null) {
+                $seen[$variant->id] = true;
+            }
+        }
+
+        if ($errors !== []) {
+            throw ValidationException::withMessages($errors);
+        }
+    }
+}

app/Domains/Ticketing/Desfile/Services/DesfileEntryReservationService.php

@@ -0,0 +1,123 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Services;
+
+use App\Domains\Commerce\Catalog\Models\CatalogItem;
+use App\Domains\Commerce\Catalog\Models\Variant;
+use App\Domains\Core\Auth\Models\User;
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
+use App\Domains\Ticketing\Ticket\Models\Ticket;
+use App\Domains\Ticketing\Ticket\Services\EntryReservationService as TicketEntryReservationService;
+use Illuminate\Pagination\LengthAwarePaginator;
+use Illuminate\Support\Collection;
+use Illuminate\Validation\ValidationException;
+
+/** Adapts the Desfile API and seat rules to the catalog-based reservation workflow. */
+class DesfileEntryReservationService
+{
+    private const SELECTION_RELATIONS = [
+        'variant.catalogItem.itemAttributes.attribute.options',
+        'variant.definitions.itemAttribute.attribute.options',
+        'variant.eventDates',
+        'variant.eventDate',
+    ];
+
+    public function __construct(
+        private readonly TicketEntryReservationService $reservations,
+        private readonly DesfileEntryReservationPolicy $policy,
+    ) {}
+
+    /**
+     * @param  array{tipo_pago?: string|null, page?: int, per_page?: int}  $filters
+     * @return LengthAwarePaginator<EntryReservation>
+     */
+    public function reservations(User $user, array $filters = []): LengthAwarePaginator
+    {
+        $result = $this->reservations->reservations($user, [
+            ...$filters, 'catalog_item_id' => $this->entryId($user),
+        ]);
+        $result->getCollection()->loadMissing(self::SELECTION_RELATIONS);
+
+        return $result;
+    }
+
+    /**
+     * @param  array{tipo_pago?: string|null}  $filters
+     * @return Collection<int, EntryReservation>
+     */
+    public function reservationsForExport(User $user, array $filters = []): Collection
+    {
+        return $this->reservations->reservationsForExport($user, [
+            ...$filters, 'catalog_item_id' => $this->entryId($user),
+        ])->loadMissing(self::SELECTION_RELATIONS);
+    }
+
+    public function reservationTicket(User $user, int $reservationId): Ticket
+    {
+        return $this->reservations->reservationTicket($user, $reservationId, $this->entryId($user));
+    }
+
+    public function cancel(User $user, int $reservationId): void
+    {
+        $this->reservations->cancel($user, $reservationId, $this->entryId($user));
+    }
+
+    /** @param list<array{variant_id: int, tipo_pago: string}> $rows */
+    public function reserve(User $user, string $key, array $rows): Collection
+    {
+        $this->authorize($user);
+        $entry = CatalogItem::query()->where('tenant_code', $user->tenant_codigo)
+            ->where('slug', 'entrada')->firstOrFail();
+        $catalogRows = array_map(fn (array $row): array => [
+            ...$row, 'catalog_item_id' => $entry->id,
+        ], $rows);
+
+        try {
+            return $this->reservations->reserve($user, $key, $catalogRows, $this->policy)
+                ->loadMissing(self::SELECTION_RELATIONS);
+        } catch (ValidationException $exception) {
+            // Keep the row fields used by the form and describe the selected seat.
+            $variants = $entry->variants()->whereKey(array_column($rows, 'variant_id'))
+                ->with(['definitions.itemAttribute.attribute.options'])->get()->keyBy('id');
+            $errors = [];
+            foreach ($exception->errors() as $field => $messages) {
+                if (preg_match('/^rows\.(\d+)\.variant_id$/', $field, $match)) {
+                    $index = (int) $match[1];
+                    $label = $this->entryLabel($variants->get($rows[$index]['variant_id'] ?? null), $index);
+                    $messages = array_map(fn (string $message): string => $label.': '.$message, $messages);
+                }
+                $errors[$field] = $messages;
+            }
+
+            throw ValidationException::withMessages($errors);
+        }
+    }
+
+    private function authorize(User $user): void
+    {
+        abort_unless($user->tenant_codigo === 'desfile_pura_tendencia', 403);
+    }
+
+    private function entryId(User $user): int
+    {
+        $this->authorize($user);
+
+        // Historical reservations remain accessible when the active event changes.
+        // A missing entry must not remove the catalog filter from the generic query.
+        return CatalogItem::query()->where('tenant_code', $user->tenant_codigo)
+            ->where('slug', 'entrada')->value('id') ?? -1;
+    }
+
+    private function entryLabel(?Variant $variant, int $index): string
+    {
+        if ($variant === null) {
+            return 'Entrada '.($index + 1);
+        }
+
+        $values = $variant->selectionValues();
+
+        return collect(['tipo' => 'Tipo', 'sector' => 'Sector', 'fila' => 'Fila', 'asiento' => 'Asiento'])
+            ->map(fn (string $label, string $key): string => $label.': '.($values->get($key) ?? 'sin especificar'))
+            ->implode(', ');
+    }
+}

app/Domains/Ticketing/Desfile/Services/EntryReservationExcelService.php

@@ -0,0 +1,91 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Services;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
+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 EntryReservationExcelService
+{
+    public function __construct(private readonly EntryReservationReportService $report) {}
+
+    /** @param Collection<int, EntryReservation> $reservations */
+    public function download(Tenant $tenant, Collection $reservations, string $timeZone): StreamedResponse
+    {
+        $generatedAt = now();
+        $rows = $this->report->rows($reservations);
+        $spreadsheet = new Spreadsheet;
+        $spreadsheet->getProperties()
+            ->setCreator('Shopit')
+            ->setTitle('Reservas de entradas')
+            ->setSubject($tenant->nombre);
+        $sheet = $spreadsheet->getActiveSheet();
+        $sheet->setTitle('Reservas');
+        $sheet->fromArray([
+            'Tipo',
+            'Sector',
+            'Fila',
+            'Asiento',
+            'ID',
+            'Fecha',
+            'Importe',
+            'Pago',
+        ], null, 'A1');
+
+        foreach ($rows as $index => $reservation) {
+            $row = $index + 2;
+            foreach (['A' => 'tipo', 'B' => 'sector', 'C' => 'fila', 'D' => 'asiento'] as $column => $key) {
+                $sheet->setCellValueExplicit("{$column}{$row}", $reservation[$key], DataType::TYPE_STRING);
+            }
+            $sheet->setCellValueExplicit(
+                "E{$row}",
+                $reservation['ticket_id'] === null ? '-' : (string) $reservation['ticket_id'],
+                DataType::TYPE_STRING,
+            );
+            $sheet->setCellValue(
+                "F{$row}",
+                Date::dateTimeToExcel($reservation['fecha_reserva']->copy()->timezone($timeZone)),
+            );
+            if ($reservation['importe'] !== null) {
+                $sheet->setCellValue("G{$row}", (float) $reservation['importe']);
+            }
+            $sheet->setCellValueExplicit("H{$row}", $reservation['pago'], DataType::TYPE_STRING);
+        }
+
+        $lastRow = max(2, $rows->count() + 1);
+        $sheet->getStyle("F2:F{$lastRow}")->getNumberFormat()->setFormatCode('dd/mm/yyyy hh:mm');
+        $sheet->getStyle("G2:G{$lastRow}")->getNumberFormat()->setFormatCode('$ #,##0.00');
+        $sheet->getStyle('A1:H1')->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:H{$lastRow}");
+        foreach (['A' => 20, 'B' => 22, 'C' => 12, 'D' => 12, 'E' => 16, 'F' => 20, 'G' => 16, 'H' => 18] as $column => $width) {
+            $sheet->getColumnDimension($column)->setWidth($width);
+        }
+
+        $filename = 'reservas_entradas_'.$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/Ticketing/Desfile/Services/EntryReservationPdfService.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Services;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
+use Barryvdh\DomPDF\Facade\Pdf;
+use Barryvdh\DomPDF\PDF as DomPdf;
+use Illuminate\Http\Response;
+use Illuminate\Support\Collection;
+
+class EntryReservationPdfService
+{
+    public function __construct(private readonly EntryReservationReportService $report) {}
+
+    /** @param Collection<int, EntryReservation> $reservations */
+    public function download(Tenant $tenant, Collection $reservations, string $timeZone): Response
+    {
+        $generatedAt = now();
+        $rows = $this->report->rows($reservations);
+        $pdf = Pdf::loadView('pdf.adminapp.desfile-entry-reservations', [
+            'tenant' => $tenant,
+            'reservations' => $rows,
+            'generatedAt' => $generatedAt,
+            'timeZone' => $timeZone,
+        ])->setPaper('a4', 'landscape');
+
+        $this->addPageNumbers($pdf);
+
+        return $pdf->download(
+            'reservas_entradas_'.$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(
+            385,
+            575,
+            'Página {PAGE_NUM} de {PAGE_COUNT}',
+            $font,
+            7,
+            [0.48, 0.52, 0.49],
+        );
+    }
+}

app/Domains/Ticketing/Desfile/Services/EntryReservationReportService.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Services;
+
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
+use Illuminate\Support\Collection;
+
+class EntryReservationReportService
+{
+    /**
+     * @param  Collection<int, EntryReservation>  $reservations
+     * @return Collection<int, array<string, mixed>>
+     */
+    public function rows(Collection $reservations): Collection
+    {
+        return $reservations->values()->map(function (EntryReservation $reservation): array {
+            $selection = $reservation->variant->selectionOptions();
+
+            return [
+                'tipo' => $this->selectionLabel($selection->get('tipo')),
+                'sector' => $this->selectionLabel($selection->get('sector')),
+                'fila' => $this->selectionLabel($selection->get('fila')),
+                'asiento' => $this->selectionLabel($selection->get('asiento')),
+                'ticket_id' => $reservation->ticket_id,
+                'fecha_reserva' => $reservation->fecha_reserva,
+                'importe' => $reservation->importe,
+                'pago' => $reservation->tipo_pago->label(),
+            ];
+        });
+    }
+
+    private function selectionLabel(mixed $selection): string
+    {
+        if (! is_array($selection)) {
+            return '-';
+        }
+
+        if (array_is_list($selection)) {
+            return collect($selection)->pluck('label')->filter()->implode(', ') ?: '-';
+        }
+
+        return isset($selection['label']) ? (string) $selection['label'] : '-';
+    }
+}

app/Domains/Ticketing/Desfile/Services/EntryService.php

@@ -2,13 +2,13 @@
 
 namespace App\Domains\Ticketing\Desfile\Services;
 
-use App\Shared\Attachable\Models\Attachment;
-use App\Shared\Attachable\Services\AttachmentService;
 use App\Domains\Commerce\Catalog\Models\CatalogItem;
 use App\Domains\Commerce\Catalog\Models\Inventory;
 use App\Domains\Commerce\Catalog\Models\ItemAttribute;
 use App\Domains\Commerce\Catalog\Models\Variant;
 use App\Domains\Core\Tenant\Models\Tenant;
+use App\Shared\Attachable\Models\Attachment;
+use App\Shared\Attachable\Services\AttachmentService;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Http\UploadedFile;
 use Illuminate\Support\Collection;
@@ -254,7 +254,7 @@ class EntryService
     {
         $inventory = $variant->inventory;
 
-        if (($inventory?->reserved_stock ?? 0) > 0 || ($inventory?->sold_units ?? 0) > 0) {
+        if (($inventory?->reserved_stock ?? 0) > 0 || ($inventory?->entry_reserved_stock ?? 0) > 0 || ($inventory?->sold_units ?? 0) > 0) {
             throw ValidationException::withMessages([
                 $key => [
                     'No se puede modificar ni eliminar un asiento con ventas o reservas.',

app/Domains/Ticketing/Desfile/Services/InvitationPurchaseProvisioner.php

@@ -393,7 +393,7 @@ class InvitationPurchaseProvisioner
 
         $inventory = DB::table('inventories')->where('id', $variant->inventory_id)->lockForUpdate()->first();
 
-        if ($inventory === null || $inventory->real_stock < 1 || $inventory->reserved_stock > 0) {
+        if ($inventory === null || $inventory->real_stock < 1 || $inventory->reserved_stock > 0 || ($inventory->entry_reserved_stock ?? 0) > 0) {
             throw new RuntimeException("El asiento {$variant->descripcion} ya no está disponible.");
         }
 

app/Domains/Ticketing/Desfile/routes/api.php

@@ -1,8 +1,30 @@
 <?php
 
+use App\Domains\Ticketing\Desfile\Controllers\DesfileEntryReservationController;
 use App\Domains\Ticketing\Desfile\Controllers\EntryController;
 use Illuminate\Support\Facades\Route;
 
+Route::get('v1/adminapp/tenant/desfile/entry-reservations', [DesfileEntryReservationController::class, 'index'])
+    ->middleware(['auth:sanctum', 'adminapp.tenant', 'tenant.menu:adminapp.desfile.reservas'])
+    ->name('adminapp.desfile.entry-reservations.index');
+Route::get('v1/adminapp/tenant/desfile/entry-reservations/pdf', [DesfileEntryReservationController::class, 'downloadPdf'])
+    ->middleware(['auth:sanctum', 'adminapp.tenant', 'tenant.menu:adminapp.desfile.reservas'])
+    ->name('adminapp.desfile.entry-reservations.pdf');
+Route::get('v1/adminapp/tenant/desfile/entry-reservations/excel', [DesfileEntryReservationController::class, 'downloadExcel'])
+    ->middleware(['auth:sanctum', 'adminapp.tenant', 'tenant.menu:adminapp.desfile.reservas'])
+    ->name('adminapp.desfile.entry-reservations.excel');
+Route::get('v1/adminapp/tenant/desfile/entry-reservations/{reservation}/ticket/pdf', [DesfileEntryReservationController::class, 'downloadTicketPdf'])
+    ->whereNumber('reservation')
+    ->middleware(['auth:sanctum', 'adminapp.tenant', 'tenant.menu:adminapp.desfile.reservas'])
+    ->name('adminapp.desfile.entry-reservations.ticket.pdf');
+Route::post('v1/adminapp/tenant/desfile/entry-reservations', [DesfileEntryReservationController::class, 'store'])
+    ->middleware(['auth:sanctum', 'adminapp.tenant', 'tenant.menu:adminapp.desfile.reservas'])
+    ->name('adminapp.desfile.entry-reservations.store');
+Route::delete('v1/adminapp/tenant/desfile/entry-reservations/{reservation}', [DesfileEntryReservationController::class, 'destroy'])
+    ->whereNumber('reservation')
+    ->middleware(['auth:sanctum', 'adminapp.tenant', 'tenant.menu:adminapp.desfile.reservas'])
+    ->name('adminapp.desfile.entry-reservations.destroy');
+
 Route::prefix('v1/adminapp/tenant/desfile')
     ->middleware(['auth:sanctum', 'adminapp.tenant', 'tenant.menu:adminapp.desfile.entradas'])
     ->group(function (): void {

app/Domains/Ticketing/Event/Models/Event.php

@@ -3,6 +3,7 @@
 namespace App\Domains\Ticketing\Event\Models;
 
 use App\Domains\Commerce\Catalog\Models\CatalogItem;
+use App\Domains\Core\Client\Models\Client;
 use App\Domains\Core\Tenant\Models\SocialMedia;
 use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
@@ -14,14 +15,14 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
-#[Fillable(['tenant_code', 'slug', 'event_category_id', 'title', 'subtitle', 'description', 'location', 'exact_location', 'date_text', 'published_at', 'attachment_id'])]
+#[Fillable(['client_id', 'tenant_code', 'slug', 'event_category_id', 'title', 'subtitle', 'description', 'location', 'exact_location', 'date_text', 'published_at', 'attachment_id'])]
 class Event extends Model
 {
     use HasFactory;
 
     protected function casts(): array
     {
-        return ['published_at' => 'datetime', 'exact_location' => 'array'];
+        return ['client_id' => 'integer', 'published_at' => 'datetime', 'exact_location' => 'array'];
     }
 
     /** @return BelongsTo<Tenant, $this> */
@@ -30,6 +31,17 @@ class Event extends Model
         return $this->belongsTo(Tenant::class, 'tenant_code', 'codigo');
     }
 
+    /** @return BelongsTo<Client, $this> */
+    public function client(): BelongsTo
+    {
+        return $this->belongsTo(Client::class);
+    }
+
+    public function effectiveClient(): Client
+    {
+        return $this->client ?? $this->tenant->client;
+    }
+
     /** @return BelongsTo<EventCategory, $this> */
     public function eventCategory(): BelongsTo
     {

app/Domains/Ticketing/Ticket/Controllers/AdminApp/EntryReservationController.php

@@ -0,0 +1,94 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Controllers\AdminApp;
+
+use App\Domains\Ticketing\Ticket\Requests\ExportEntryReservationsRequest;
+use App\Domains\Ticketing\Ticket\Requests\IndexEntryReservationsRequest;
+use App\Domains\Ticketing\Ticket\Requests\StoreEntryReservationsRequest;
+use App\Domains\Ticketing\Ticket\Resources\EntryReservationFormResource;
+use App\Domains\Ticketing\Ticket\Resources\EntryReservationResource;
+use App\Domains\Ticketing\Ticket\Services\EntryReservationExcelService;
+use App\Domains\Ticketing\Ticket\Services\EntryReservationFormService;
+use App\Domains\Ticketing\Ticket\Services\EntryReservationPdfService;
+use App\Domains\Ticketing\Ticket\Services\EntryReservationService;
+use App\Domains\Ticketing\Ticket\Services\TicketPdfService;
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+use Illuminate\Http\Response;
+use Symfony\Component\HttpFoundation\StreamedResponse;
+
+class EntryReservationController extends Controller
+{
+    public function form(IndexEntryReservationsRequest $request, EntryReservationFormService $service): EntryReservationFormResource
+    {
+        return new EntryReservationFormResource($service->get(
+            $request->user()->tenant()->firstOrFail(), $request->user()->event_id,
+        ));
+    }
+
+    public function index(IndexEntryReservationsRequest $request, EntryReservationService $service): AnonymousResourceCollection
+    {
+        return EntryReservationResource::collection(
+            $service->reservations($request->user(), $request->validated()),
+        );
+    }
+
+    public function downloadPdf(
+        ExportEntryReservationsRequest $request,
+        EntryReservationService $service,
+        EntryReservationPdfService $pdf,
+    ): Response {
+        $user = $request->user();
+
+        return $pdf->download(
+            $user->tenant()->firstOrFail(),
+            $service->reservationsForExport($user, $request->validated()),
+            $request->validated('timezone'),
+        );
+    }
+
+    public function downloadExcel(
+        ExportEntryReservationsRequest $request,
+        EntryReservationService $service,
+        EntryReservationExcelService $excel,
+    ): StreamedResponse {
+        $user = $request->user();
+
+        return $excel->download(
+            $user->tenant()->firstOrFail(),
+            $service->reservationsForExport($user, $request->validated()),
+            $request->validated('timezone'),
+        );
+    }
+
+    public function downloadTicketPdf(
+        IndexEntryReservationsRequest $request,
+        int $reservation,
+        EntryReservationService $service,
+        TicketPdfService $pdf,
+    ): Response {
+        $user = $request->user();
+
+        return $pdf->download(
+            $user->tenant()->firstOrFail(),
+            collect([$service->reservationTicket($user, $reservation)]),
+        );
+    }
+
+    public function store(StoreEntryReservationsRequest $request, EntryReservationService $service): AnonymousResourceCollection
+    {
+        return EntryReservationResource::collection($service->reserve(
+            $request->user(), $request->validated('idempotency_key'), $request->validated('rows'),
+        ));
+    }
+
+    public function destroy(
+        IndexEntryReservationsRequest $request,
+        int $reservation,
+        EntryReservationService $service,
+    ): Response {
+        $service->cancel($request->user(), $reservation);
+
+        return response()->noContent();
+    }
+}

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

@@ -29,7 +29,7 @@ class TicketController extends Controller
         $tenant = $request->user()->tenant()->firstOrFail();
 
         return new AdminAppTicketCollection(
-            $this->ticketService->search($tenant, $request->validated())
+            $this->ticketService->search($tenant, $request->validated(), $request->user()->event_id)
         );
     }
 
@@ -37,7 +37,7 @@ class TicketController extends Controller
     {
         $tenant = $request->user()->tenant()->firstOrFail();
 
-        return new AdminAppTicketResource($this->ticketService->cancel($tenant, $ticket));
+        return new AdminAppTicketResource($this->ticketService->cancel($tenant, $ticket, $request->user()->event_id));
     }
 
     public function calculateRefund(Request $request, int $ticket): AdminAppTicketRefundCalculationResource
@@ -45,7 +45,7 @@ class TicketController extends Controller
         $tenant = $request->user()->tenant()->firstOrFail();
 
         return new AdminAppTicketRefundCalculationResource(
-            $this->ticketService->calculateRefund($tenant, $ticket)
+            $this->ticketService->calculateRefund($tenant, $ticket, $request->user()->event_id)
         );
     }
 
@@ -69,7 +69,7 @@ class TicketController extends Controller
 
         return $this->ticketPdfService->download(
             $tenant,
-            $this->ticketService->ticketsForExport($tenant, $request->validated()),
+            $this->ticketService->ticketsForExport($tenant, $request->validated(), $request->user()->event_id),
             $request->validated('timezone'),
         );
     }
@@ -80,7 +80,7 @@ class TicketController extends Controller
 
         return $this->ticketExcelService->download(
             $tenant,
-            $this->ticketService->ticketsForExport($tenant, $request->validated()),
+            $this->ticketService->ticketsForExport($tenant, $request->validated(), $request->user()->event_id),
             $request->validated('timezone'),
         );
     }

app/Domains/Ticketing/Ticket/Enums/EntryReservationPaymentType.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Enums;
+
+enum EntryReservationPaymentType: string
+{
+    case Free = 'sin_cargo';
+    case Other = 'otro_metodo';
+
+    public function label(): string
+    {
+        return match ($this) {
+            self::Free => 'Sin cargo',
+            self::Other => 'Otro método',
+        };
+    }
+
+    /** @return list<array{value: string, label: string}> */
+    public static function options(): array
+    {
+        return array_map(
+            fn (self $type): array => [
+                'value' => $type->value,
+                'label' => $type->label(),
+            ],
+            self::cases(),
+        );
+    }
+}

app/Domains/Ticketing/Ticket/Models/EntryReservation.php

@@ -0,0 +1,87 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Models;
+
+use App\Domains\Commerce\Catalog\Models\CatalogItem;
+use App\Domains\Commerce\Catalog\Models\Inventory;
+use App\Domains\Commerce\Catalog\Models\Variant;
+use App\Domains\Ticketing\Ticket\Enums\EntryReservationPaymentType;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+use Illuminate\Validation\ValidationException;
+
+#[Fillable([
+    'catalog_item_id',
+    'variant_id',
+    'ticket_id',
+    'inventory_id',
+    'batch_id',
+    'fecha_reserva',
+    'importe',
+    'tipo_pago',
+])]
+class EntryReservation extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'entry_reservations';
+
+    protected function casts(): array
+    {
+        return [
+            'catalog_item_id' => 'integer',
+            'variant_id' => 'integer',
+            'fecha_reserva' => 'datetime',
+            'importe' => 'decimal:2',
+            'tipo_pago' => EntryReservationPaymentType::class,
+        ];
+    }
+
+    protected static function booted(): void
+    {
+        static::saving(function (self $reservation): void {
+            if ($reservation->variant_id === null) {
+                return;
+            }
+
+            $variant = Variant::withTrashed()->findOrFail($reservation->variant_id);
+            // Existing variant-based callers can keep creating reservations as before.
+            $reservation->catalog_item_id ??= $variant->catalog_item_id;
+            if ($reservation->catalog_item_id !== $variant->catalog_item_id) {
+                throw ValidationException::withMessages([
+                    'variant_id' => 'La variante no pertenece al ítem del catálogo seleccionado.',
+                ]);
+            }
+        });
+    }
+
+    /** @return BelongsTo<CatalogItem, $this> */
+    public function catalogItem(): BelongsTo
+    {
+        return $this->belongsTo(CatalogItem::class)->withTrashed();
+    }
+
+    /** @return BelongsTo<ReservationBatch, $this> */
+    public function batch(): BelongsTo
+    {
+        return $this->belongsTo(ReservationBatch::class, 'batch_id');
+    }
+
+    /** @return BelongsTo<Variant, $this> */
+    public function variant(): BelongsTo
+    {
+        return $this->belongsTo(Variant::class)->withTrashed();
+    }
+
+    public function ticket(): BelongsTo
+    {
+        return $this->belongsTo(Ticket::class);
+    }
+
+    public function inventory(): BelongsTo
+    {
+        return $this->belongsTo(Inventory::class);
+    }
+}

app/Domains/Ticketing/Ticket/Models/ReservationBatch.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Models;
+
+use App\Domains\Core\Auth\Models\User;
+use App\Domains\Core\Tenant\Models\Tenant;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+#[Fillable(['user_id', 'tenant_code', 'idempotency_key', 'request_hash'])]
+class ReservationBatch extends Model
+{
+    protected function casts(): array
+    {
+        return ['user_id' => 'integer'];
+    }
+
+    /** @return BelongsTo<User, $this> */
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class)->withTrashed();
+    }
+
+    /** @return BelongsTo<Tenant, $this> */
+    public function tenant(): BelongsTo
+    {
+        return $this->belongsTo(Tenant::class, 'tenant_code', 'codigo');
+    }
+
+    /** @return HasMany<EntryReservation, $this> */
+    public function reservations(): HasMany
+    {
+        return $this->hasMany(EntryReservation::class, 'batch_id');
+    }
+}

app/Domains/Ticketing/Ticket/Models/Ticket.php

@@ -192,7 +192,9 @@ class Ticket extends Model
 
     public function can_refund(): bool
     {
-        return $this->is_active() && $this->allow_refund();
+        return $this->is_active()
+            && $this->allow_refund()
+            && ! $this->hasEntryReservation();
     }
 
     public function canRefund(): bool
@@ -235,6 +237,12 @@ class Ticket extends Model
         return $this->hasOne(TicketRefund::class);
     }
 
+    /** @return HasOne<EntryReservation, $this> */
+    public function entryReservation(): HasOne
+    {
+        return $this->hasOne(EntryReservation::class);
+    }
+
     /** @return BelongsTo<CatalogItem, $this> */
     public function sourceCatalogItem(): BelongsTo
     {
@@ -247,6 +255,15 @@ class Ticket extends Model
         return $this->belongsTo(Variant::class, 'source_variant_id')->withTrashed();
     }
 
+    private function hasEntryReservation(): bool
+    {
+        if ($this->relationLoaded('entryReservation')) {
+            return $this->getRelation('entryReservation') instanceof EntryReservation;
+        }
+
+        return $this->exists && $this->entryReservation()->exists();
+    }
+
     public function isValid(): bool
     {
         if ($this->hasTerminalStatus() || $this->used_at !== null) {

app/Domains/Ticketing/Ticket/Requests/AdminAppTicketIndexRequest.php

@@ -3,6 +3,7 @@
 namespace App\Domains\Ticketing\Ticket\Requests;
 
 use App\Domains\Ticketing\Ticket\Models\Ticket;
+use App\Domains\Ticketing\Ticket\Services\AdminAppTicketAttributeService;
 use App\Domains\Ticketing\Ticket\Services\AdminAppTicketColumnService;
 use Illuminate\Foundation\Http\FormRequest;
 use Illuminate\Validation\Rule;
@@ -22,7 +23,7 @@ class AdminAppTicketIndexRequest extends FormRequest
             ? []
             : app(AdminAppTicketColumnService::class)->sortableKeys($tenant);
 
-        return [
+        $rules = [
             'q' => ['sometimes', 'nullable', 'string', 'max:255'],
             'category' => ['sometimes', 'nullable', 'string', 'max:255'],
             'product' => ['sometimes', 'nullable', 'string', 'max:255'],
@@ -39,5 +40,18 @@ class AdminAppTicketIndexRequest extends FormRequest
             'sort_by' => ['sometimes', 'nullable', 'string', Rule::in($sortableKeys)],
             'sort_direction' => ['sometimes', 'nullable', 'string', Rule::in(['asc', 'desc'])],
         ];
+
+        if ($tenant !== null) {
+            foreach (app(AdminAppTicketAttributeService::class)->attributes($tenant) as $attribute) {
+                $rules[$attribute['code']] = [
+                    'sometimes',
+                    'nullable',
+                    'string',
+                    Rule::in(array_column($attribute['options'], 'value')),
+                ];
+            }
+        }
+
+        return $rules;
     }
 }

app/Domains/Ticketing/Ticket/Requests/ExportEntryReservationsRequest.php

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

app/Domains/Ticketing/Ticket/Requests/IndexEntryReservationsRequest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Requests;
+
+use App\Domains\Ticketing\Ticket\Enums\EntryReservationPaymentType;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class IndexEntryReservationsRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return $this->user()?->tenant_codigo === 'onticket';
+    }
+
+    public function rules(): array
+    {
+        return [
+            'catalog_item_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
+            'variant_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
+            'tipo_pago' => ['sometimes', 'nullable', Rule::enum(EntryReservationPaymentType::class)],
+            'page' => ['sometimes', 'integer', 'min:1'],
+            'per_page' => ['sometimes', 'integer', 'min:1', 'max:100'],
+        ];
+    }
+}

app/Domains/Ticketing/Ticket/Requests/StoreEntryReservationsRequest.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Requests;
+
+use App\Domains\Ticketing\Ticket\Enums\EntryReservationPaymentType;
+use Illuminate\Validation\Rule;
+
+class StoreEntryReservationsRequest extends IndexEntryReservationsRequest
+{
+    public function rules(): array
+    {
+        return [
+            'idempotency_key' => ['required', 'uuid'],
+            'rows' => ['required', 'array', 'list', 'min:1', 'max:100'],
+            'rows.*' => ['required', 'array:catalog_item_id,variant_id,tipo_pago'],
+            'rows.*.catalog_item_id' => ['required', 'integer', 'min:1'],
+            'rows.*.variant_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
+            'rows.*.tipo_pago' => ['required', Rule::enum(EntryReservationPaymentType::class)],
+        ];
+    }
+}

app/Domains/Ticketing/Ticket/Resources/EntryReservationFormResource.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class EntryReservationFormResource extends JsonResource
+{
+    public function toArray(Request $request): array
+    {
+        return $this->resource;
+    }
+}

app/Domains/Ticketing/Ticket/Resources/EntryReservationResource.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class EntryReservationResource extends JsonResource
+{
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'catalog_item_id' => $this->catalog_item_id,
+            'variant_id' => $this->variant_id,
+            'catalog_item' => ['id' => $this->catalog_item_id, 'name' => $this->catalogItem?->nombre],
+            'variant' => $this->variant === null ? null : [
+                'id' => $this->variant_id,
+                'label' => $this->variant->getSelectionLabel(),
+            ],
+            'ticket_id' => $this->ticket_id,
+            'fecha_reserva' => $this->fecha_reserva->toIso8601String(),
+            'tipo_pago' => $this->tipo_pago->value,
+            'tipo_pago_label' => $this->tipo_pago->label(),
+            'importe' => $this->importe,
+        ];
+    }
+}

app/Domains/Ticketing/Ticket/Services/AdminAppTicketAttributeService.php

@@ -0,0 +1,92 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Services;
+
+use App\Domains\Commerce\Catalog\Models\CatalogItem;
+use App\Domains\Core\Tenant\Models\Tenant;
+use Illuminate\Database\Eloquent\Builder;
+
+class AdminAppTicketAttributeService
+{
+    private const DESFILE_PURA_TENDENCIA = 'desfile_pura_tendencia';
+
+    /**
+     * @return list<array{
+     *     code: string,
+     *     label: string,
+     *     options: list<array{value: string, label: string}>
+     * }>
+     */
+    public function attributes(Tenant $tenant): array
+    {
+        if ($tenant->codigo !== self::DESFILE_PURA_TENDENCIA) {
+            return [];
+        }
+
+        $items = CatalogItem::withTrashed()
+            ->where('tenant_code', $tenant->codigo)
+            ->where(function (Builder $query): void {
+                $query
+                    ->where(function (Builder $activeQuery): void {
+                        $activeQuery
+                            ->whereNull('catalog_items.deleted_at')
+                            ->where('has_tickets', true);
+                    })
+                    ->orWhereHas('sourceTickets');
+            })
+            ->with([
+                'itemAttributes' => fn ($query) => $query->orderBy('sort_order')->orderBy('id'),
+                'itemAttributes.attribute.options',
+                'variants' => fn ($query) => $query
+                    ->withTrashed()
+                    ->where(fn (Builder $variantQuery): Builder => $variantQuery
+                        ->whereNull('variantes.deleted_at')
+                        ->orWhereHas('sourceTickets'))
+                    ->orderBy('id'),
+                'variants.definitions.itemAttribute.attribute.options',
+            ])
+            ->get();
+
+        $attributes = [];
+
+        foreach ($items as $item) {
+            foreach ($item->itemAttributes as $itemAttribute) {
+                $attribute = $itemAttribute->attribute;
+                if ($attribute === null) {
+                    continue;
+                }
+
+                $code = $attribute->codigo;
+                $attributes[$code] ??= [
+                    'code' => $code,
+                    'label' => $itemAttribute->ticket_label ?: $attribute->nombre,
+                    'sort_order' => $itemAttribute->sort_order,
+                    'options' => [],
+                ];
+
+                foreach ($item->variants as $variant) {
+                    $definition = $variant->definitions->firstWhere('item_attribute_id', $itemAttribute->id);
+                    if ($definition === null) {
+                        continue;
+                    }
+
+                    $value = (string) $definition->value;
+                    $option = $attribute->options->firstWhere('value', $value);
+                    $attributes[$code]['options'][$value] = [
+                        'value' => $value,
+                        'label' => (string) ($option?->label ?: $value),
+                    ];
+                }
+            }
+        }
+
+        uasort($attributes, fn (array $left, array $right): int => $left['sort_order'] <=> $right['sort_order']
+            ?: $left['label'] <=> $right['label']);
+
+        return array_values(array_map(fn (array $attribute): array => [
+            'code' => $attribute['code'],
+            'label' => $attribute['label'],
+            'options' => array_values($attribute['options']),
+        ], $attributes));
+    }
+}

app/Domains/Ticketing/Ticket/Services/AdminAppTicketColumnService.php

@@ -8,9 +8,17 @@ class AdminAppTicketColumnService
 {
     private const FIESTA_FUTBOL_INFANTIL = 'fiesta_futbol_infantil';
 
+    private const DESFILE_PURA_TENDENCIA = 'desfile_pura_tendencia';
+
+    public function __construct(private readonly AdminAppTicketAttributeService $attributeService) {}
+
     /** @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
     {
+        if ($tenant->codigo === self::DESFILE_PURA_TENDENCIA) {
+            return $this->desfileColumns($tenant);
+        }
+
         $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'];
@@ -45,6 +53,31 @@ class AdminAppTicketColumnService
         return $columns;
     }
 
+    /** @return list<array{key: string, label: string, type: string, sortable: bool, sort_param: string, width: string, excel_width: int}> */
+    private function desfileColumns(Tenant $tenant): array
+    {
+        $attributeColumns = array_map(fn (array $attribute): array => [
+            'key' => $attribute['code'],
+            'label' => $attribute['label'],
+            'type' => 'text',
+            'sortable' => false,
+            'sort_param' => $attribute['code'],
+            'width' => '8%',
+            'excel_width' => 15,
+        ], $this->attributeService->attributes($tenant));
+
+        return [
+            $this->definitions()['order_number'],
+            $this->definitions()['product'],
+            ...$attributeColumns,
+            $this->definitions()['amount'],
+            $this->definitions()['client'],
+            $this->definitions()['id'],
+            $this->definitions()['status'],
+            $this->definitions()['scanned_by'],
+        ];
+    }
+
     /** @return list<array{key: string, label: string, type: string, sortable: bool, sort_param: string, width: string}> */
     public function publicColumns(Tenant $tenant): array
     {

app/Domains/Ticketing/Ticket/Services/AdminAppTicketRowService.php

@@ -11,6 +11,8 @@ class AdminAppTicketRowService
 {
     private const FIESTA_FUTBOL_INFANTIL = 'fiesta_futbol_infantil';
 
+    private const DESFILE_PURA_TENDENCIA = 'desfile_pura_tendencia';
+
     private const CATEGORY_PRESENTATIONS = [
         'alojamientos' => ['category' => 'Camping', 'product' => 'tipo_alojamiento', 'type' => null, 'size' => null],
         'camping' => ['category' => null, 'product' => 'tipo_alojamiento', 'type' => null, 'size' => null],
@@ -25,31 +27,65 @@ class AdminAppTicketRowService
     {
         $purchaseItem = $ticket->sourcePurchaseItem;
         $refund = $ticket->refund;
+        $variantProperties = $this->variantProperties($ticket);
 
         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,
+            'product' => $this->productName($ticket, $purchaseItem?->item_nombre, $variantProperties),
+            'amount' => $purchaseItem?->precio_unitario ?? $ticket->entryReservation?->importe,
             'refund_type' => $refund?->type,
             'refund_type_label' => $refund?->typeLabel(),
             'client' => $purchaseItem?->purchase?->nombre_apellido ?? $ticket->user?->nombre_apellido,
             'status' => $ticket->status,
             'scanned_by' => $ticket->scannerUser?->nombre_apellido,
-            'variant_properties' => $this->variantProperties($ticket),
+            'variant_properties' => $variantProperties,
             'allow_refund' => $ticket->allow_refund(),
         ];
     }
 
+    /**
+     * @param  list<array{code: string, label: string, values: list<array{value: string, label: string}>}>  $properties
+     */
+    private function productName(Ticket $ticket, ?string $snapshotName, array $properties): string
+    {
+        $baseName = $ticket->sourceCatalogItem?->nombre ?: $ticket->name;
+
+        if ($ticket->tenant_code !== self::DESFILE_PURA_TENDENCIA) {
+            return $snapshotName ?: $baseName;
+        }
+
+        $seatDescription = collect(['sector', 'fila', 'asiento'])
+            ->map(function (string $code) use ($properties): ?string {
+                $property = collect($properties)->firstWhere('code', $code);
+                $values = collect($property['values'] ?? [])->pluck('label')->filter()->implode(', ');
+
+                return $property === null || $values === ''
+                    ? null
+                    : $property['label'].' '.$values;
+            })
+            ->filter()
+            ->implode(', ');
+
+        return $seatDescription === '' ? ($snapshotName ?: $baseName) : "{$baseName} ({$seatDescription})";
+    }
+
     /** @param array<string, mixed>|null $details */
     public function values(Ticket $ticket, ?array $details = null): array
     {
         $details ??= $this->details($ticket);
         $presentation = $this->presentation($ticket, $details);
+        $attributeValues = collect($details['variant_properties'] ?? [])
+            ->mapWithKeys(fn (array $property): array => [
+                $property['code'] => collect($property['values'] ?? [])
+                    ->pluck('label')
+                    ->filter()
+                    ->implode(', ') ?: '-',
+            ])
+            ->all();
 
         return [
+            ...$attributeValues,
             'order_number' => $details['order_number'],
             'category' => $presentation['category'],
             'product' => $presentation['product'],

app/Domains/Ticketing/Ticket/Services/AdminAppTicketService.php

@@ -2,12 +2,12 @@
 
 namespace App\Domains\Ticketing\Ticket\Services;
 
-use App\Domains\Core\Auth\Models\User;
 use App\Domains\Commerce\Catalog\Enums\InventoryPolicy;
 use App\Domains\Commerce\Catalog\Models\Inventory;
 use App\Domains\Commerce\Catalog\Models\Variant;
 use App\Domains\Commerce\Purchase\Models\PurchaseItem;
 use App\Domains\Commerce\Purchase\Services\PurchaseRefundSummaryService;
+use App\Domains\Core\Auth\Models\User;
 use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
 use App\Domains\Ticketing\Ticket\Models\TicketRefund;
@@ -27,11 +27,13 @@ class AdminAppTicketService
         'scannerUser',
         'sourceCatalogItem.category',
         'sourcePurchaseItem.purchase',
+        'entryReservation',
         'refund.createdBy',
     ];
 
     public function __construct(
         private readonly AdminAppTicketColumnService $columnService,
+        private readonly AdminAppTicketAttributeService $attributeService,
         private readonly AdminAppTicketRowService $rowService,
         private readonly PurchaseRefundSummaryService $refundSummaryService,
     ) {}
@@ -39,9 +41,9 @@ class AdminAppTicketService
     /**
      * @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
+    public function search(Tenant $tenant, array $filters = [], ?int $eventId = null): AdminAppTicketResult
     {
-        $query = $this->baseQuery($tenant, $filters);
+        $query = $this->baseQuery($tenant, $filters, $eventId);
         $countQuery = clone $query;
 
         $databaseSorted = $this->applyDatabaseSort($query, $tenant, $filters);
@@ -75,7 +77,7 @@ class AdminAppTicketService
             tickets: $tickets,
             scannedTickets: $scannedTickets,
             totalTickets: $totalTickets,
-            refundedTotal: $this->refundSummaryService->totalForTenant($tenant),
+            refundedTotal: $this->refundSummaryService->totalForTenant($tenant, $eventId),
         );
     }
 
@@ -83,9 +85,9 @@ class AdminAppTicketService
      * @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
+    public function ticketsForExport(Tenant $tenant, array $filters = [], ?int $eventId = null): Collection
     {
-        $query = $this->baseQuery($tenant, $filters);
+        $query = $this->baseQuery($tenant, $filters, $eventId);
         $databaseSorted = $this->applyDatabaseSort($query, $tenant, $filters);
         $tickets = $query
             ->with(self::RELATIONS)
@@ -95,11 +97,10 @@ class AdminAppTicketService
         return $databaseSorted ? $tickets : $this->sortTickets($tickets, $tenant, $filters);
     }
 
-    public function cancel(Tenant $tenant, int $ticketId): Ticket
+    public function cancel(Tenant $tenant, int $ticketId, ?int $eventId = null): Ticket
     {
-        return DB::transaction(function () use ($tenant, $ticketId): Ticket {
-            $ticket = Ticket::query()
-                ->where('tenant_code', $tenant->codigo)
+        return DB::transaction(function () use ($tenant, $ticketId, $eventId): Ticket {
+            $ticket = $this->ticketsQuery($tenant, $eventId)
                 ->lockForUpdate()
                 ->findOrFail($ticketId);
 
@@ -122,10 +123,9 @@ class AdminAppTicketService
      *     partial: string|null,
      * }
      */
-    public function calculateRefund(Tenant $tenant, int $ticketId): array
+    public function calculateRefund(Tenant $tenant, int $ticketId, ?int $eventId = null): array
     {
-        $ticket = Ticket::query()
-            ->where('tenant_code', $tenant->codigo)
+        $ticket = $this->ticketsQuery($tenant, $eventId)
             ->findOrFail($ticketId);
 
         if (! $ticket->can_refund()) {
@@ -173,14 +173,13 @@ class AdminAppTicketService
         string $refundType,
         ?User $createdBy = null,
     ): Ticket {
-        $this->ensureRefundIsAllowed($tenant, $refundType);
-
         return DB::transaction(function () use ($tenant, $ticketId, $refundType, $createdBy): Ticket {
-            $ticket = Ticket::query()
-                ->where('tenant_code', $tenant->codigo)
+            $ticket = $this->ticketsQuery($tenant, $createdBy?->event_id)
                 ->lockForUpdate()
                 ->findOrFail($ticketId);
 
+            $this->ensureRefundIsAllowed($tenant, $refundType);
+
             if (! $ticket->can_refund()) {
                 if ($ticket->status !== Ticket::STATUS_ACTIVE) {
                     throw ValidationException::withMessages([
@@ -312,12 +311,11 @@ class AdminAppTicketService
      * @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
+    private function baseQuery(Tenant $tenant, array $filters, ?int $eventId = null): Builder
     {
         $search = trim((string) ($filters['q'] ?? ''));
 
-        $query = Ticket::query()
-            ->where('tenant_code', $tenant->codigo)
+        $query = $this->ticketsQuery($tenant, $eventId)
             ->when($search !== '', function (Builder $query) use ($search): void {
                 $this->applySearchFilter($query, $search);
             })
@@ -347,9 +345,24 @@ class AdminAppTicketService
 
         $this->applyStatusFilter($query, $filters['status'] ?? null);
 
+        foreach ($this->attributeService->attributes($tenant) as $attribute) {
+            $value = $filters[$attribute['code']] ?? null;
+            if ($value !== null && $value !== '') {
+                $this->whereVariantDefinition($query, $attribute['code'], (string) $value);
+            }
+        }
+
         return $query;
     }
 
+    /** @return Builder<Ticket> */
+    private function ticketsQuery(Tenant $tenant, ?int $eventId): Builder
+    {
+        return Ticket::query()
+            ->where('tenant_code', $tenant->codigo)
+            ->when($eventId !== null, fn (Builder $query): Builder => $query->where('tickets.event_id', $eventId));
+    }
+
     /** @param Builder<Ticket> $query */
     private function applySearchFilter(Builder $query, string $search): void
     {

app/Domains/Ticketing/Ticket/Services/EntryReservationExcelService.php

@@ -0,0 +1,89 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Services;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
+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 EntryReservationExcelService
+{
+    public function __construct(private readonly EntryReservationReportService $report) {}
+
+    /** @param Collection<int, EntryReservation> $reservations */
+    public function download(Tenant $tenant, Collection $reservations, string $timeZone): StreamedResponse
+    {
+        $generatedAt = now();
+        $rows = $this->report->rows($reservations);
+        $spreadsheet = new Spreadsheet;
+        $spreadsheet->getProperties()
+            ->setCreator('Shopit')
+            ->setTitle('Reservas de tickets')
+            ->setSubject($tenant->nombre);
+        $sheet = $spreadsheet->getActiveSheet();
+        $sheet->setTitle('Reservas');
+        $sheet->fromArray([
+            'Ítem',
+            'Variante',
+            'ID',
+            'Fecha',
+            'Importe',
+            'Pago',
+        ], null, 'A1');
+
+        foreach ($rows as $index => $reservation) {
+            $row = $index + 2;
+            foreach (['A' => 'item', 'B' => 'variant'] as $column => $key) {
+                $sheet->setCellValueExplicit("{$column}{$row}", $reservation[$key], DataType::TYPE_STRING);
+            }
+            $sheet->setCellValueExplicit(
+                "C{$row}",
+                $reservation['ticket_id'] === null ? '-' : (string) $reservation['ticket_id'],
+                DataType::TYPE_STRING,
+            );
+            $sheet->setCellValue(
+                "D{$row}",
+                Date::dateTimeToExcel($reservation['fecha_reserva']->copy()->timezone($timeZone)),
+            );
+            if ($reservation['importe'] !== null) {
+                $sheet->setCellValue("E{$row}", (float) $reservation['importe']);
+            }
+            $sheet->setCellValueExplicit("F{$row}", $reservation['pago'], DataType::TYPE_STRING);
+        }
+
+        $lastRow = max(2, $rows->count() + 1);
+        $sheet->getStyle("D2:D{$lastRow}")->getNumberFormat()->setFormatCode('dd/mm/yyyy hh:mm');
+        $sheet->getStyle("E2:E{$lastRow}")->getNumberFormat()->setFormatCode('$ #,##0.00');
+        $sheet->getStyle('A1:F1')->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:F{$lastRow}");
+        foreach (['A' => 30, 'B' => 60, 'C' => 16, 'D' => 20, 'E' => 16, 'F' => 18] as $column => $width) {
+            $sheet->getColumnDimension($column)->setWidth($width);
+        }
+
+        $filename = 'reservas_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/Ticketing/Ticket/Services/EntryReservationFormService.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Services;
+
+use App\Domains\Commerce\Catalog\Enums\InventoryPolicy;
+use App\Domains\Commerce\Catalog\Models\CatalogItem;
+use App\Domains\Commerce\Catalog\Models\Variant;
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Ticket\Enums\EntryReservationPaymentType;
+use Illuminate\Database\Eloquent\Builder;
+
+class EntryReservationFormService
+{
+    public function get(Tenant $tenant, ?int $eventId = null): array
+    {
+        $items = CatalogItem::query()->where('tenant_code', $tenant->codigo)->where('has_tickets', true)
+            ->when($eventId !== null, fn (Builder $query) => $query->where('event_id', $eventId))
+            ->with([
+                'inventory', 'itemAttributes.attribute.options',
+                'variants' => fn ($query) => $query->orderBy('id'),
+                'variants.inventory', 'variants.definitions.itemAttribute.attribute.options',
+                'variants.eventDates', 'variants.eventDate',
+            ])->orderBy('nombre')->orderBy('id')->get();
+
+        $filterItems = $items->map(fn (CatalogItem $item): array => [
+            'id' => $item->id, 'name' => $item->nombre,
+            'variants' => $item->variants->map(function (Variant $variant) use ($item): array {
+                $variant->setRelation('catalogItem', $item);
+
+                return ['id' => $variant->id, 'label' => $variant->getSelectionLabel()];
+            })->values()->all(),
+        ])->values()->all();
+
+        $reservationEventId = $eventId ?? $tenant->active_event_id;
+        $available = $items->filter(fn (CatalogItem $item): bool => ! $item->isBundle()
+            && $item->isSaleOpen()
+            && ($reservationEventId === null || $item->event_id === $reservationEventId))
+            ->map(function (CatalogItem $item): ?array {
+                $tracked = $item->inventory_policy !== InventoryPolicy::Unlimited;
+                $requiresVariant = $item->variants->isNotEmpty();
+                $variants = $item->variants->filter(function (Variant $variant) use ($item, $tracked): bool {
+                    $variant->setRelation('catalogItem', $item);
+
+                    return $variant->isSellable()
+                        && (! $tracked || ($variant->inventory?->availableStock() ?? 0) > 0);
+                })->map(fn (Variant $variant): array => [
+                    'id' => $variant->id, 'label' => $variant->getSelectionLabel(),
+                    'price' => $variant->getPrice(),
+                    'available_stock' => $tracked ? $variant->inventory->availableStock() : null,
+                ])->values()->all();
+                if (($requiresVariant && $variants === [])
+                    || (! $requiresVariant && $tracked && ($item->inventory?->availableStock() ?? 0) <= 0)) {
+                    return null;
+                }
+
+                return [
+                    'id' => $item->id, 'name' => $item->nombre, 'price' => $item->getPrice(),
+                    'requires_variant' => $requiresVariant, 'variants' => $variants,
+                    'available_stock' => $tracked ? $item->inventory?->availableStock() : null,
+                ];
+            })->filter()->values()->all();
+
+        return ['payment_types' => EntryReservationPaymentType::options(), 'items' => $available, 'filter_items' => $filterItems];
+    }
+}

app/Domains/Ticketing/Ticket/Services/EntryReservationPdfService.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Services;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
+use Barryvdh\DomPDF\Facade\Pdf;
+use Barryvdh\DomPDF\PDF as DomPdf;
+use Illuminate\Http\Response;
+use Illuminate\Support\Collection;
+
+class EntryReservationPdfService
+{
+    public function __construct(private readonly EntryReservationReportService $report) {}
+
+    /** @param Collection<int, EntryReservation> $reservations */
+    public function download(Tenant $tenant, Collection $reservations, string $timeZone): Response
+    {
+        $generatedAt = now();
+        $rows = $this->report->rows($reservations);
+        $pdf = Pdf::loadView('pdf.adminapp.entry-reservations', [
+            'tenant' => $tenant,
+            'reservations' => $rows,
+            'generatedAt' => $generatedAt,
+            'timeZone' => $timeZone,
+        ])->setPaper('a4', 'landscape');
+
+        $this->addPageNumbers($pdf);
+
+        return $pdf->download(
+            'reservas_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(
+            385,
+            575,
+            'Página {PAGE_NUM} de {PAGE_COUNT}',
+            $font,
+            7,
+            [0.48, 0.52, 0.49],
+        );
+    }
+}

app/Domains/Ticketing/Ticket/Services/EntryReservationPolicy.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Services;
+
+use App\Domains\Commerce\Catalog\Models\CatalogItem;
+use App\Domains\Commerce\Catalog\Models\Inventory;
+use App\Domains\Commerce\Catalog\Models\Variant;
+use Illuminate\Validation\ValidationException;
+
+interface EntryReservationPolicy
+{
+    /**
+     * Validate additional rules after selections are resolved and locked, before
+     * stock or tickets change. Idempotent replays do not run this validation.
+     *
+     * @param  array<int, array{item: CatalogItem, variant: Variant|null, inventory: Inventory|null}>  $selections
+     *
+     * @throws ValidationException
+     */
+    public function validate(array $selections): void;
+}

app/Domains/Ticketing/Ticket/Services/EntryReservationReportService.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Services;
+
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
+use Illuminate\Support\Collection;
+
+class EntryReservationReportService
+{
+    public function rows(Collection $reservations): Collection
+    {
+        return $reservations->values()->map(fn (EntryReservation $reservation): array => [
+            'item' => $reservation->catalogItem?->nombre ?? '-',
+            'variant' => $reservation->variant?->getSelectionLabel() ?? 'Sin variante',
+            'ticket_id' => $reservation->ticket_id,
+            'fecha_reserva' => $reservation->fecha_reserva,
+            'importe' => $reservation->importe,
+            'pago' => $reservation->tipo_pago->label(),
+        ]);
+    }
+}

app/Domains/Ticketing/Ticket/Services/EntryReservationService.php

@@ -0,0 +1,313 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Services;
+
+use App\Domains\Commerce\Catalog\Enums\InventoryPolicy;
+use App\Domains\Commerce\Catalog\Models\CatalogItem;
+use App\Domains\Commerce\Catalog\Models\Inventory;
+use App\Domains\Commerce\Catalog\Models\Variant;
+use App\Domains\Core\Auth\Models\User;
+use App\Domains\Ticketing\Ticket\Enums\EntryReservationPaymentType;
+use App\Domains\Ticketing\Ticket\Exceptions\TicketGenerationException;
+use App\Domains\Ticketing\Ticket\Models\EntryReservation;
+use App\Domains\Ticketing\Ticket\Models\ReservationBatch;
+use App\Domains\Ticketing\Ticket\Models\Ticket;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Collection;
+use Illuminate\Pagination\LengthAwarePaginator;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Validator;
+use Illuminate\Validation\Rule;
+use Illuminate\Validation\ValidationException;
+
+/** Application workflow for one ticket per selected catalog item / variant. */
+class EntryReservationService
+{
+    private const SELECTION_RELATIONS = [
+        'catalogItem',
+        'variant.catalogItem.itemAttributes.attribute.options',
+        'variant.definitions.itemAttribute.attribute.options',
+        'variant.eventDates',
+        'variant.eventDate',
+    ];
+
+    public function __construct(private readonly TicketGeneratorService $tickets) {}
+
+    /**
+     * @param  array{catalog_item_id?: int, variant_id?: int, tipo_pago?: string|null, page?: int, per_page?: int}  $filters
+     * @return LengthAwarePaginator<EntryReservation>
+     */
+    public function reservations(User $user, array $filters = []): LengthAwarePaginator
+    {
+        return $this->reservationsQuery($user, $filters)
+            ->paginate(perPage: $filters['per_page'] ?? 15, page: $filters['page'] ?? 1)
+            ->withQueryString();
+    }
+
+    /**
+     * @param  array{catalog_item_id?: int, variant_id?: int, tipo_pago?: string|null}  $filters
+     * @return Collection<int, EntryReservation>
+     */
+    public function reservationsForExport(User $user, array $filters = []): Collection
+    {
+        return $this->reservationsQuery($user, $filters)->get();
+    }
+
+    public function reservationTicket(User $user, int $reservationId, ?int $catalogItemId = null): Ticket
+    {
+        $reservation = $this->reservationsQuery($user, ['catalog_item_id' => $catalogItemId])
+            ->whereKey($reservationId)->whereNotNull('ticket_id')
+            ->with(['ticket' => fn ($query) => $query->with([
+                ...TicketValidityResolver::RELATIONS,
+                ...TicketPresentationResolver::RELATIONS,
+            ])])->firstOrFail();
+
+        return $reservation->ticket;
+    }
+
+    public function cancel(User $user, int $reservationId, ?int $catalogItemId = null): void
+    {
+        DB::transaction(function () use ($user, $reservationId, $catalogItemId): void {
+            $reservation = $this->reservationsQuery($user, ['catalog_item_id' => $catalogItemId])
+                ->whereKey($reservationId)->lockForUpdate()->firstOrFail();
+
+            if ($reservation->ticket_id !== null) {
+                $ticket = Ticket::query()->whereKey($reservation->ticket_id)->lockForUpdate()->firstOrFail();
+                if (! $ticket->can_cancel()) {
+                    throw ValidationException::withMessages([
+                        'status' => 'El ticket debe estar activo para poder cancelar la reserva.',
+                    ]);
+                }
+                $ticket->markAsCancelled();
+                $ticket->save();
+            }
+
+            if ($reservation->inventory_id !== null) {
+                $inventory = Inventory::query()->whereKey($reservation->inventory_id)->lockForUpdate()->firstOrFail();
+                $inventory->releaseEntry(1);
+            }
+            $reservation->delete();
+        }, 3);
+    }
+
+    /**
+     * Each row reserves one unit. Prices and inventory are resolved on the server.
+     *
+     * @param  list<array{catalog_item_id: int, variant_id?: int|null, tipo_pago: string}>  $rows
+     * @return Collection<int, EntryReservation>
+     */
+    public function reserve(User $user, string $key, array $rows, ?EntryReservationPolicy $policy = null): Collection
+    {
+        $validated = Validator::make(['idempotency_key' => $key, 'rows' => $rows], [
+            'idempotency_key' => ['required', 'uuid'],
+            'rows' => ['required', 'array', 'list', 'min:1', 'max:100'],
+            'rows.*' => ['required', 'array:catalog_item_id,variant_id,tipo_pago'],
+            'rows.*.catalog_item_id' => ['required', 'integer', 'min:1'],
+            'rows.*.variant_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
+            'rows.*.tipo_pago' => ['required', Rule::enum(EntryReservationPaymentType::class)],
+        ])->validate();
+        $rows = array_map(fn (array $row): array => [
+            'catalog_item_id' => (int) $row['catalog_item_id'],
+            'variant_id' => isset($row['variant_id']) ? (int) $row['variant_id'] : null,
+            'tipo_pago' => $row['tipo_pago'],
+        ], $validated['rows']);
+        $hash = $this->requestHash($rows);
+
+        return DB::transaction(function () use ($user, $key, $rows, $hash, $policy): Collection {
+            User::query()->whereKey($user->id)->lockForUpdate()->firstOrFail();
+            $tenant = $user->tenant()->firstOrFail();
+            $batch = ReservationBatch::query()->where('user_id', $user->id)
+                ->where('idempotency_key', $key)->lockForUpdate()->first();
+            if ($batch !== null) {
+                abort_unless($batch->tenant_code === $tenant->codigo && $this->matchesBatch($batch, $rows, $hash),
+                    409, 'La clave de envío ya fue utilizada con otra selección.');
+
+                // A scope change must not expose any part of a previously submitted batch.
+                if ($user->event_id !== null) {
+                    abort_if($batch->reservations()->withTrashed()
+                        ->whereDoesntHave('catalogItem', fn (Builder $query) => $query
+                            ->where('tenant_code', $user->tenant_codigo)
+                            ->where('event_id', $user->event_id))
+                        ->exists(), 403);
+                }
+
+                return $batch->reservations()->with([...self::SELECTION_RELATIONS, 'ticket'])->orderBy('id')->get();
+            }
+
+            $eventId = $user->event_id ?? $tenant->active_event_id;
+            $items = CatalogItem::query()->where('tenant_code', $tenant->codigo)
+                ->when($eventId !== null, fn (Builder $query) => $query->where('event_id', $eventId))
+                ->whereKey(array_column($rows, 'catalog_item_id'))->orderBy('id')->lockForUpdate()->get()->keyBy('id');
+            $variants = Variant::query()->whereIn('catalog_item_id', $items->keys())
+                ->whereKey(array_filter(array_column($rows, 'variant_id')))
+                ->orderBy('id')->lockForUpdate()->get()->keyBy('id');
+            $variants->load(['eventDates', 'eventDate']);
+            $inventoryIds = $items->pluck('inventory_id')->merge($variants->pluck('inventory_id'))->filter()->unique();
+            $inventories = Inventory::query()->whereKey($inventoryIds)->orderBy('id')->lockForUpdate()->get()->keyBy('id');
+            $selections = [];
+            $requirements = [];
+            $errors = [];
+
+            foreach ($rows as $index => $row) {
+                $item = $items->get($row['catalog_item_id']);
+                $variant = $row['variant_id'] !== null ? $variants->get($row['variant_id']) : null;
+                $field = $this->selectionField($row, $index);
+                if ($item === null || ! $item->has_tickets || ! $item->isSaleOpen()) {
+                    $errors[$field] = 'El ítem no está disponible para reservar tickets en este catálogo.';
+
+                    continue;
+                }
+                if ($item->isBundle()) {
+                    $errors[$field] = 'Seleccioná el ítem que emite el ticket; los paquetes requieren reservar sus componentes.';
+
+                    continue;
+                }
+                if ($row['variant_id'] !== null) {
+                    if ($variant === null || $variant->catalog_item_id !== $item->id) {
+                        $errors[$field] = 'La variante no pertenece al ítem del catálogo seleccionado.';
+
+                        continue;
+                    }
+                    $variant->setRelation('catalogItem', $item);
+                    if (! $variant->isSellable()) {
+                        $errors[$field] = 'La variante ya no está disponible.';
+
+                        continue;
+                    }
+                } elseif ($item->variants()->exists()) {
+                    $errors["rows.{$index}.variant_id"] = 'Seleccioná una variante del ítem del catálogo.';
+
+                    continue;
+                }
+
+                $selection = $variant ?? $item;
+                $inventory = $inventories->get($selection->inventory_id);
+                $tracked = $item->inventory_policy !== InventoryPolicy::Unlimited;
+                if ($inventory === null && ($selection->inventory_id !== null || $tracked)) {
+                    $errors[$field] = 'La selección no tiene un inventario disponible.';
+
+                    continue;
+                }
+                $selection->setRelation('inventory', $inventory);
+                $selections[$index] = ['item' => $item, 'variant' => $variant, 'inventory' => $inventory];
+                if ($inventory !== null) {
+                    $requirement = $requirements[$inventory->id] ?? ['quantity' => 0, 'tracked' => false];
+                    $requirements[$inventory->id] = [
+                        'quantity' => $requirement['quantity'] + 1,
+                        'tracked' => $requirement['tracked'] || $tracked,
+                    ];
+                }
+            }
+            if ($errors !== []) {
+                throw ValidationException::withMessages($errors);
+            }
+
+            $policy?->validate($selections);
+
+            foreach ($requirements as $inventoryId => $requirement) {
+                if ($requirement['tracked'] && $inventories[$inventoryId]->availableStock() < $requirement['quantity']) {
+                    foreach ($selections as $index => $selection) {
+                        if ($selection['inventory']?->id === $inventoryId) {
+                            $errors[$this->selectionField($rows[$index], $index)] = 'No hay stock suficiente para reservar la selección.';
+                        }
+                    }
+                }
+            }
+            if ($errors !== []) {
+                throw ValidationException::withMessages($errors);
+            }
+
+            $batch = ReservationBatch::query()->create([
+                'user_id' => $user->id, 'tenant_code' => $tenant->codigo,
+                'idempotency_key' => $key, 'request_hash' => $hash,
+            ]);
+            foreach ($requirements as $inventoryId => $requirement) {
+                $inventories[$inventoryId]->reserveEntry($requirement['quantity'], $requirement['tracked']);
+            }
+
+            $reservations = new Collection;
+            foreach ($selections as $index => $selection) {
+                $item = $selection['item'];
+                $variant = $selection['variant'];
+                try {
+                    $ticket = $this->tickets->generate($item, $user, 1, $variant?->id)->sole();
+                } catch (TicketGenerationException $exception) {
+                    throw ValidationException::withMessages([
+                        $this->selectionField($rows[$index], $index) => 'No se pudo emitir el ticket. '.$exception->getMessage(),
+                    ]);
+                }
+                $payment = EntryReservationPaymentType::from($rows[$index]['tipo_pago']);
+                $reservation = EntryReservation::query()->create([
+                    'batch_id' => $batch->id, 'ticket_id' => $ticket->id,
+                    'catalog_item_id' => $variant?->catalog_item_id ?? $item->id,
+                    'variant_id' => $variant?->id, 'inventory_id' => $selection['inventory']?->id,
+                    'fecha_reserva' => now(), 'tipo_pago' => $payment,
+                    'importe' => $payment === EntryReservationPaymentType::Free ? 0 : ($variant ?? $item)->getPrice(),
+                ]);
+                $reservations->push($reservation->setRelation('ticket', $ticket)
+                    ->setRelation('catalogItem', $item)->setRelation('variant', $variant));
+            }
+
+            return $reservations->loadMissing(self::SELECTION_RELATIONS);
+        }, 3);
+    }
+
+    /** @param array<string, mixed> $filters */
+    private function reservationsQuery(User $user, array $filters = []): Builder
+    {
+        abort_unless($user->tenant_codigo !== null && $user->tenant_codigo !== '', 403);
+
+        return EntryReservation::query()
+            ->whereHas('catalogItem', fn (Builder $query) => $query->where('tenant_code', $user->tenant_codigo)
+                ->when($user->event_id !== null, fn (Builder $query) => $query->where('event_id', $user->event_id)))
+            ->when($filters['catalog_item_id'] ?? null, fn (Builder $query, int $id) => $query->where('catalog_item_id', $id))
+            ->when($filters['variant_id'] ?? null, fn (Builder $query, int $id) => $query->where('variant_id', $id))
+            ->when($filters['tipo_pago'] ?? null, fn (Builder $query, string $type) => $query->where('tipo_pago', $type))
+            ->with(self::SELECTION_RELATIONS)
+            ->orderByDesc('fecha_reserva')->orderByDesc('id');
+    }
+
+    /** @param array{variant_id: int|null} $row */
+    private function selectionField(array $row, int $index): string
+    {
+        return "rows.{$index}.".($row['variant_id'] !== null ? 'variant_id' : 'catalog_item_id');
+    }
+
+    /** @param list<array{catalog_item_id: int, variant_id: int|null, tipo_pago: string}> $rows */
+    private function requestHash(array $rows): string
+    {
+        $normalized = collect($rows)->sortBy([
+            ['catalog_item_id', 'asc'], ['variant_id', 'asc'], ['tipo_pago', 'asc'],
+        ])->values()->all();
+
+        return hash('sha256', json_encode($normalized, JSON_THROW_ON_ERROR));
+    }
+
+    /** @param list<array{catalog_item_id: int, variant_id: int|null, tipo_pago: string}> $rows */
+    private function matchesBatch(ReservationBatch $batch, array $rows, string $hash): bool
+    {
+        if (hash_equals($batch->request_hash, $hash)) {
+            return true;
+        }
+        if (collect($rows)->contains(fn (array $row) => $row['variant_id'] === null)) {
+            return false;
+        }
+
+        // Older batches fingerprinted variant and payment only. Check the persisted
+        // catalog IDs too, so compatibility cannot replay a different catalog item.
+        $legacyRows = collect($rows)->map(fn (array $row) => [
+            'variant_id' => $row['variant_id'], 'tipo_pago' => $row['tipo_pago'],
+        ])->sortBy('variant_id')->values()->all();
+        $legacyHash = hash('sha256', json_encode($legacyRows, JSON_THROW_ON_ERROR));
+        if (! hash_equals($batch->request_hash, $legacyHash)) {
+            return false;
+        }
+        $storedRows = $batch->reservations()->withTrashed()->get()->map(fn (EntryReservation $reservation) => [
+            'catalog_item_id' => $reservation->catalog_item_id,
+            'variant_id' => $reservation->variant_id,
+            'tipo_pago' => $reservation->tipo_pago->value,
+        ])->all();
+
+        return hash_equals($this->requestHash($storedRows), $hash);
+    }
+}

app/Domains/Ticketing/Ticket/documentacion/README.md

@@ -89,6 +89,10 @@ Bajo `/v1/adminapp/tenant`, protegido por `auth:sanctum`, `adminapp.tenant` y el
 
 `TicketPdfService` genera la descarga y `TicketResource`/`ValidityTimeResource` definen las respuestas.
 
+Si el administrador autenticado tiene `event_id`, las consultas de Tickets y sus exportaciones se limitan a `tickets.event_id` dentro del tenant. Los contadores usan el mismo alcance y el total reembolsado se limita a las compras del evento. Sin `event_id`, se conserva el alcance por tenant.
+
+La cancelación, el cálculo de reembolso y el reembolso buscan el ticket dentro de ese alcance antes de validar o ejecutar la operación. Un ticket de otro evento o sin evento devuelve 404 para un administrador con evento asignado. El alcance se obtiene del usuario autenticado, no de los parámetros del cliente.
+
 ## Dependencias y reglas
 
 Depende de `Purchase`, `Catalog`, `Tenant` y `Auth`. La generación debe ser idempotente ante reintentos del evento. `TicketNotAvailableException` y `TicketGenerationException` separan indisponibilidad de errores de generación.

app/Domains/Ticketing/Ticket/routes/adminapp.php

@@ -1,11 +1,24 @@
 <?php
 
+use App\Domains\Ticketing\Ticket\Controllers\AdminApp\EntryReservationController;
 use App\Domains\Ticketing\Ticket\Controllers\AdminApp\TicketController;
 use Illuminate\Support\Facades\Route;
 
 Route::prefix('v1/adminapp/tenant')
     ->middleware(['auth:sanctum', 'adminapp.tenant'])
     ->group(function (): void {
+        Route::prefix('entry-reservations')->middleware('tenant.menu:adminapp.ticket-reservations')
+            ->group(function (): void {
+                Route::get('form', [EntryReservationController::class, 'form'])->name('adminapp.entry-reservations.form');
+                Route::get('/', [EntryReservationController::class, 'index'])->name('adminapp.entry-reservations.index');
+                Route::post('/', [EntryReservationController::class, 'store'])->name('adminapp.entry-reservations.store');
+                Route::get('pdf', [EntryReservationController::class, 'downloadPdf'])->name('adminapp.entry-reservations.pdf');
+                Route::get('excel', [EntryReservationController::class, 'downloadExcel'])->name('adminapp.entry-reservations.excel');
+                Route::get('{reservation}/ticket/pdf', [EntryReservationController::class, 'downloadTicketPdf'])
+                    ->whereNumber('reservation')->name('adminapp.entry-reservations.ticket.pdf');
+                Route::delete('{reservation}', [EntryReservationController::class, 'destroy'])
+                    ->whereNumber('reservation')->name('adminapp.entry-reservations.destroy');
+            });
         Route::get('tickets', [TicketController::class, 'index'])
             ->middleware('tenant.menu:adminapp.tickets')
             ->name('adminapp.tickets.index');

app/Shared/Forms/Controllers/AdminApp/DesfileEntryReservationFormController.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Shared\Forms\Controllers\AdminApp;
+
+use App\Http\Controllers\Controller;
+use App\Shared\Forms\Resources\DesfileEntryReservationFormResource;
+use App\Shared\Forms\Services\DesfileEntryReservationFormService;
+use Illuminate\Http\Request;
+
+class DesfileEntryReservationFormController extends Controller
+{
+    public function __construct(
+        private readonly DesfileEntryReservationFormService $formService,
+    ) {}
+
+    public function __invoke(Request $request): DesfileEntryReservationFormResource
+    {
+        return DesfileEntryReservationFormResource::make(
+            $this->formService->get($request->user()->tenant()->firstOrFail()),
+        );
+    }
+}

app/Shared/Forms/Resources/DesfileEntryReservationFormResource.php

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

app/Shared/Forms/Services/DesfileEntryReservationFormService.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Shared\Forms\Services;
+
+use App\Domains\Commerce\Catalog\Models\CatalogItem;
+use App\Domains\Commerce\Catalog\Models\Variant;
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Ticket\Enums\EntryReservationPaymentType;
+
+class DesfileEntryReservationFormService
+{
+    /** @return array<string, mixed> */
+    public function get(Tenant $tenant): array
+    {
+        $entry = CatalogItem::query()->forTenantCatalog($tenant)->where('slug', 'entrada')
+            ->with([
+                'variants' => fn ($query) => $query->orderBy('id'),
+                'variants.inventory',
+                'variants.definitions.itemAttribute.attribute',
+                'variants.eventDates',
+                'variants.eventDate',
+            ])->first();
+        $variants = $entry?->visibleVariants()
+            ->map(function (Variant $variant): array {
+                $values = $variant->selectionValues();
+
+                return [
+                    'id' => $variant->id,
+                    'tipo' => (string) $values->get('tipo'),
+                    'sector' => (string) $values->get('sector'),
+                    'fila' => (string) $values->get('fila'),
+                    'asiento' => (string) $values->get('asiento'),
+                    'price' => $variant->getPrice(),
+                ];
+            })->values() ?? collect();
+
+        return [
+            'payment_types' => EntryReservationPaymentType::options(),
+            'fields' => collect(['tipo' => 'Tipo', 'sector' => 'Sector', 'fila' => 'Fila', 'asiento' => 'Asiento'])
+                ->map(fn (string $label, string $key): array => [
+                    'key' => $key,
+                    'label' => $label,
+                    'options' => $variants->pluck($key)->unique()->sort(SORT_NATURAL)->values()
+                        ->map(fn (string $value): array => ['value' => $value, 'label' => $value])->all(),
+                ])->values()->all(),
+            'variants' => $variants->all(),
+        ];
+    }
+}

app/Shared/Forms/Services/TicketFilterFormService.php

@@ -4,15 +4,19 @@ namespace App\Shared\Forms\Services;
 
 use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
+use App\Domains\Ticketing\Ticket\Services\AdminAppTicketAttributeService;
 use App\Domains\Ticketing\Ticket\Services\AdminAppTicketColumnService;
 
 class TicketFilterFormService
 {
     private const FIESTA_FUTBOL_INFANTIL = 'fiesta_futbol_infantil';
 
+    private const DESFILE_PURA_TENDENCIA = 'desfile_pura_tendencia';
+
     public function __construct(
         private readonly TicketFormService $ticketFormService,
         private readonly AdminAppTicketColumnService $columnService,
+        private readonly AdminAppTicketAttributeService $attributeService,
     ) {}
 
     /** @return array<string, mixed> */
@@ -27,6 +31,13 @@ class TicketFilterFormService
             ];
         }
 
+        if ($tenant->codigo === self::DESFILE_PURA_TENDENCIA) {
+            $fields = [
+                ...$this->desfileFields($tenant),
+                ...$this->commonFields(),
+            ];
+        }
+
         return [
             'code' => 'tickets_filter',
             'action' => '/api/v1/adminapp/tenant/tickets',
@@ -36,6 +47,21 @@ class TicketFilterFormService
         ];
     }
 
+    /** @return list<array<string, mixed>> */
+    private function desfileFields(Tenant $tenant): array
+    {
+        return array_map(fn (array $attribute): array => [
+            'name' => $attribute['code'],
+            'query_param' => $attribute['code'],
+            'label' => $attribute['label'],
+            'type' => 'select',
+            'required' => false,
+            'default' => null,
+            'placeholder' => $attribute['label'],
+            'options' => $attribute['options'],
+        ], $this->attributeService->attributes($tenant));
+    }
+
     /** @return list<array<string, mixed>> */
     private function fiestaFutbolInfantilFields(Tenant $tenant): array
     {

app/Shared/Forms/routes/adminapp.php

@@ -1,5 +1,6 @@
 <?php
 
+use App\Shared\Forms\Controllers\AdminApp\DesfileEntryReservationFormController;
 use App\Shared\Forms\Controllers\AdminApp\EntryFormController;
 use App\Shared\Forms\Controllers\AdminApp\EventFormController;
 use App\Shared\Forms\Controllers\AdminApp\FoodFormController;
@@ -14,6 +15,11 @@ Route::prefix('v1/adminapp/forms')
     ->middleware(['auth:sanctum', 'adminapp.tenant'])
     ->group(function (): void {
         Route::get('event', EventFormController::class);
+        Route::get(
+            'desfile/entry-reservation',
+            DesfileEntryReservationFormController::class
+        )->middleware('tenant.menu:adminapp.desfile.reservas')
+            ->name('adminapp.forms.desfile.entry-reservation');
         Route::get('sale', SaleFormController::class);
         Route::get('staff', StaffFormController::class);
         Route::get('tickets-filter', TicketFilterFormController::class)

app/Shared/Integration/Services/BaseIntegrationService.php

@@ -3,11 +3,12 @@
 namespace App\Shared\Integration\Services;
 
 use App\Domains\Core\Client\Models\Client;
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Event\Models\Event;
+use App\Shared\Integration\Models\AdminWebsiteTypeIntegration;
 use App\Shared\Integration\Models\ClientIntegration;
 use App\Shared\Integration\Models\Integration;
 use App\Shared\Integration\Models\IntegrationInstance;
-use App\Shared\Integration\Models\AdminWebsiteTypeIntegration;
-use App\Domains\Core\Tenant\Models\Tenant;
 use Exception;
 use Illuminate\Http\Client\PendingRequest;
 use Illuminate\Support\Facades\Http;
@@ -86,6 +87,17 @@ abstract class BaseIntegrationService
         return $this;
     }
 
+    public function forEvent(Event $event): self
+    {
+        $event->loadMissing(['client', 'tenant.client']);
+        $this->tenant = $event->tenant;
+        $this->tenantCode = $event->tenant_code;
+        $this->clientContext = $event->effectiveClient();
+        $this->loadIntegration();
+
+        return $this;
+    }
+
     /**
      * Load the integration definition and its effective instance configuration.
      *

app/Shared/Integration/Services/MailService.php

@@ -3,8 +3,9 @@
 namespace App\Shared\Integration\Services;
 
 use App\Domains\Core\Client\Models\Client;
-use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Core\Tenant\Models\AdminWebsiteType;
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Event\Models\Event;
 use Exception;
 use Illuminate\Contracts\Mail\Factory as MailFactory;
 use Illuminate\Contracts\Mail\Mailer;
@@ -39,14 +40,7 @@ class MailService extends BaseIntegrationService
     public function forTenant(string $tenantCode): self
     {
         parent::forTenant($tenantCode);
-
-        if ($this->integrationInstance) {
-            $this->mailer = $this->resolveMailer();
-            $this->usesInstanceMailer = true;
-        } else {
-            $this->mailer = $this->mailFactory->mailer();
-            $this->usesInstanceMailer = false;
-        }
+        $this->configureMailer();
 
         return $this;
     }
@@ -55,16 +49,30 @@ class MailService extends BaseIntegrationService
     {
         parent::forClient($client);
         $this->tenant = $this->clientContext?->tenants()->first();
+        $this->configureMailer();
 
+        return $this;
+    }
+
+    public function forEvent(Event $event): self
+    {
+        parent::forEvent($event);
+        $this->configureMailer();
+
+        return $this;
+    }
+
+    private function configureMailer(): void
+    {
         if ($this->integrationInstance) {
             $this->mailer = $this->resolveMailer();
             $this->usesInstanceMailer = true;
-        } else {
-            $this->mailer = $this->mailFactory->mailer();
-            $this->usesInstanceMailer = false;
+
+            return;
         }
 
-        return $this;
+        $this->mailer = $this->mailFactory->mailer();
+        $this->usesInstanceMailer = false;
     }
 
     public function getHeaders(): array
@@ -83,7 +91,7 @@ class MailService extends BaseIntegrationService
         array $attachments = [],
     ): void {
         if (! $this->mailer || ! $this->tenant) {
-            throw new Exception('MailService no está configurado. Llamá a forTenant() o forClient() primero.');
+            throw new Exception('MailService no está configurado. Llamá a forTenant(), forClient() o forEvent() primero.');
         }
 
         $brand ??= $this->tenant;
@@ -160,7 +168,7 @@ class MailService extends BaseIntegrationService
     public function onSetup(): void
     {
         if (! $this->mailer || ! $this->clientContext) {
-            throw new Exception('MailService no está configurado. Llamá a forTenant() o forClient() primero.');
+            throw new Exception('MailService no está configurado. Llamá a forTenant(), forClient() o forEvent() primero.');
         }
 
         $recipient = $this->getIntegrationSetting('MAIL_FROM_ADDRESS');

app/Shared/Integration/Services/TelepagosIntegrationService.php

@@ -46,7 +46,7 @@ class TelepagosIntegrationService extends BaseIntegrationService
     public function getToken(): string
     {
         if (! $this->integrationInstance) {
-            throw new Exception('Client integration is not loaded. Call forTenant() or forClient() first.');
+            throw new Exception('Client integration is not loaded. Call forTenant(), forClient(), or forEvent() first.');
         }
 
         $cacheKey = $this->integrationInstance->tokenCacheKey();

app/Shared/Integration/Services/TelepagosWebhookService.php

@@ -2,12 +2,12 @@
 
 namespace App\Shared\Integration\Services;
 
-use App\Domains\Core\Client\Models\Client;
 use App\Domains\Commerce\Purchase\Models\Purchase;
 use App\Domains\Commerce\Purchase\Models\TelepagosPayment;
 use App\Domains\Commerce\Purchase\Models\TelepagosQr;
 use App\Domains\Commerce\Purchase\Services\CheckoutService;
 use App\Domains\Commerce\Purchase\Services\DniDistanceService;
+use App\Domains\Core\Client\Models\Client;
 use Exception;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Collection;
@@ -75,9 +75,30 @@ class TelepagosWebhookService
 
                 $dni = substr($cuit, 2, -1);
 
-                $tenantCodes = $client->tenants()->pluck('codigo');
                 $eligiblePurchases = Purchase::query()
-                    ->whereIn('tenant_codigo', $tenantCodes)
+                    ->where(function (Builder $purchases) use ($client): void {
+                        $purchases
+                            ->whereHas('event', function (Builder $events) use ($client): void {
+                                $events
+                                    ->where('client_id', $client->id)
+                                    ->orWhere(function (Builder $fallback) use ($client): void {
+                                        $fallback
+                                            ->whereNull('client_id')
+                                            ->whereHas(
+                                                'tenant',
+                                                fn (Builder $tenants): Builder => $tenants->where('client_id', $client->id),
+                                            );
+                                    });
+                            })
+                            ->orWhere(function (Builder $legacy) use ($client): void {
+                                $legacy
+                                    ->whereNull('event_id')
+                                    ->whereHas(
+                                        'tenant',
+                                        fn (Builder $tenants): Builder => $tenants->where('client_id', $client->id),
+                                    );
+                            });
+                    })
                     ->whereIn('status', [
                         Purchase::STATUS_CREATED,
                         Purchase::STATUS_PENDING_PAYMENT,
@@ -170,7 +191,7 @@ class TelepagosWebhookService
                     return;
                 }
 
-                if (! $client->tenants()->where('codigo', $compra->tenant_codigo)->exists()) {
+                if (! $this->purchaseBelongsToClient($compra, $client)) {
                     Log::channel('telepagos')->warning('Telepagos webhook: Purchase does not belong to client.', [
                         'client_code' => $client->code,
                         'cashin_id' => $cashinId,
@@ -244,6 +265,16 @@ class TelepagosWebhookService
         return number_format((float) $amount, 2, '.', '');
     }
 
+    private function purchaseBelongsToClient(Purchase $purchase, Client $client): bool
+    {
+        $purchase->loadMissing(['event.client', 'event.tenant.client', 'tenant.client']);
+
+        $effectiveClient = $purchase->event?->effectiveClient()
+            ?? $purchase->tenant?->client;
+
+        return $effectiveClient?->is($client) ?? false;
+    }
+
     /**
      * @param  Builder<Purchase>  $eligiblePurchases
      * @return Collection<int, Purchase>

app/Shared/Notification/Services/NotificationMailService.php

@@ -2,16 +2,16 @@
 
 namespace App\Shared\Notification\Services;
 
+use App\Domains\Commerce\Purchase\Models\Purchase;
 use App\Domains\Core\Auth\Models\ResetPasswordAttempt;
 use App\Domains\Core\Auth\Models\User;
-use App\Shared\Integration\Services\MailService;
-use App\Shared\Notification\Events\PasswordResetRequested;
-use App\Domains\Commerce\Purchase\Models\Purchase;
 use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
 use App\Domains\Ticketing\Ticket\Services\TicketPdfService;
 use App\Domains\Ticketing\Ticket\Services\TicketPresentationResolver;
 use App\Domains\Ticketing\Ticket\Services\TicketValidityResolver;
+use App\Shared\Integration\Services\MailService;
+use App\Shared\Notification\Events\PasswordResetRequested;
 use Closure;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Log;
@@ -158,7 +158,7 @@ class NotificationMailService
         $context = ['purchase_id' => $purchaseId];
 
         $purchase = Purchase::query()
-            ->with(['tenant', 'user', 'items'])
+            ->with(['event', 'tenant', 'user', 'items'])
             ->find($purchaseId);
 
         if ($purchase === null) {
@@ -197,8 +197,7 @@ class NotificationMailService
                         'mime' => 'application/pdf',
                     ]];
 
-                $this->mailService
-                    ->forTenant($purchase->tenant_codigo)
+                $this->mailForPurchase($purchase)
                     ->send(
                         $recipient,
                         "Compra confirmada - Compra #{$purchase->getKey()}",
@@ -286,7 +285,6 @@ class NotificationMailService
                 $context,
                 $recipient,
                 function () use (
-                    $tenantCode,
                     $purchase,
                     $recipient,
                     $previousDate,
@@ -295,8 +293,7 @@ class NotificationMailService
                 ): array {
                     $brand = $purchase->tenant;
 
-                    $this->mailService
-                        ->forTenant($tenantCode)
+                    $this->mailForPurchase($purchase)
                         ->send(
                             $recipient,
                             "Tu evento fue reprogramado - N° de Orden #{$purchase->getKey()}",
@@ -387,7 +384,6 @@ class NotificationMailService
                 $context,
                 $recipient,
                 function () use (
-                    $tenantCode,
                     $purchase,
                     $recipient,
                     $date,
@@ -396,8 +392,7 @@ class NotificationMailService
                 ): array {
                     $brand = $purchase->tenant;
 
-                    $this->mailService
-                        ->forTenant($tenantCode)
+                    $this->mailForPurchase($purchase)
                         ->send(
                             $recipient,
                             "Una fecha de tu evento fue suspendida - N° de Orden #{$purchase->getKey()}",
@@ -421,10 +416,17 @@ class NotificationMailService
     {
         return Purchase::query()
             ->where('tenant_codigo', $tenantCode)
-            ->with(['tenant', 'user'])
+            ->with(['event', 'tenant', 'user'])
             ->find($purchaseId);
     }
 
+    private function mailForPurchase(Purchase $purchase): MailService
+    {
+        return $purchase->event
+            ? $this->mailService->forEvent($purchase->event)
+            : $this->mailService->forTenant($purchase->tenant_codigo);
+    }
+
     private function recipientFor(Purchase $purchase): string
     {
         return (string) ($purchase->email ?: $purchase->user?->email);

database/migrations/2026_09_23_000000_add_desfile_ticket_reservation_adminapp_menu.php

@@ -0,0 +1,82 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    private const MENU_CODE = 'adminapp.desfile.reservas';
+
+    private const TENANT_CODE = 'desfile_pura_tendencia';
+
+    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' => 'Reserva de Tickets',
+                    'parent_menu_code' => 'main.adminapp',
+                    'content_type' => 'dynamic',
+                    'static_content_schema' => null,
+                    'route' => '/admin/desfile/reservas',
+                    '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_23_010000_create_desfile_entry_reservations_table.php

@@ -0,0 +1,29 @@
+<?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::create('desfile_entry_reservations', function (Blueprint $table): void {
+            $table->id();
+            $table->foreignId('variant_id')
+                ->constrained('variantes')
+                ->restrictOnDelete();
+            $table->timestamp('fecha_reserva');
+            $table->decimal('importe', 10, 2)->nullable();
+            $table->string('tipo_pago', 24);
+            $table->timestamps();
+
+            $table->index(['fecha_reserva', 'tipo_pago']);
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::dropIfExists('desfile_entry_reservations');
+    }
+};

database/migrations/2026_09_24_000000_add_administrative_entry_reservation_stock.php

@@ -0,0 +1,43 @@
+<?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('inventories', function (Blueprint $table): void {
+            $table->unsignedInteger('entry_reserved_stock')->default(0);
+        });
+        Schema::create('desfile_reservation_batches', function (Blueprint $table): void {
+            $table->id();
+            $table->foreignId('user_id')->constrained('users')->restrictOnDelete();
+            $table->string('tenant_code');
+            $table->uuid('idempotency_key');
+            $table->string('request_hash', 64);
+            $table->timestamps();
+            $table->unique(['user_id', 'idempotency_key']);
+        });
+        Schema::table('desfile_entry_reservations', function (Blueprint $table): void {
+            $table->foreignId('batch_id')->nullable()->constrained('desfile_reservation_batches')->restrictOnDelete();
+            $table->foreignId('ticket_id')->nullable()->unique()->constrained('tickets')->restrictOnDelete();
+            $table->foreignId('inventory_id')->nullable()->constrained('inventories')->restrictOnDelete();
+        });
+        // Legacy reservations remain excluded by visibleVariants(). Their past stock
+        // movements cannot be inferred safely; only new reservations use this counter.
+    }
+
+    public function down(): void
+    {
+        Schema::table('desfile_entry_reservations', function (Blueprint $table): void {
+            $table->dropConstrainedForeignId('batch_id');
+            $table->dropUnique(['ticket_id']);
+            $table->dropConstrainedForeignId('ticket_id');
+            $table->dropConstrainedForeignId('inventory_id');
+        });
+        Schema::dropIfExists('desfile_reservation_batches');
+        Schema::table('inventories', fn (Blueprint $table) => $table->dropColumn('entry_reserved_stock'));
+    }
+};

database/migrations/2026_09_24_000000_provision_mutual_smep_tenant.php

@@ -0,0 +1,326 @@
+<?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 CLIENT_CODE = 'mutual_smep';
+
+    private const TENANT_CODE = 'mutual_smep';
+
+    private const EXCLUDED_MENU_CODES = [
+        'account.tickets',
+        'adminapp.tickets',
+        'adminapp.fiesta-futbol-infantil.entradas',
+        'adminapp.fiesta-futbol-infantil.alojamientos',
+        'adminapp.fiesta-futbol-infantil.merchandising',
+        'adminapp.fiesta-futbol-infantil.comida',
+        'adminapp.desfile.entradas',
+        'event.index',
+        'event.category',
+        'event.detail',
+    ];
+
+    /** @var list<string> */
+    private array $storedPaths = [];
+
+    public function up(): void
+    {
+        if (DB::table('tenants')->where('codigo', self::TENANT_CODE)->exists()) {
+            return;
+        }
+
+        if (
+            ! DB::table('admin_website_types')->where('codigo', 'shopit')->exists()
+            || ! DB::table('storefront_website_types')->where('codigo', 'shopit')->exists()
+        ) {
+            // Fresh installations provision website-type reference data separately.
+            return;
+        }
+
+        try {
+            DB::transaction(function (): void {
+                $clientId = $this->clientId();
+                $headerLogoId = $this->storeImage(
+                    'images/tennants/mutual_smep/mutual_smep_header.png',
+                    'mutual_smep_header.png',
+                );
+                $footerLogoId = $this->storeImage(
+                    'images/tennants/mutual_smep/mutual_smep_footer.png',
+                    'mutual_smep_footer.png',
+                );
+                $faviconId = $this->storeImage(
+                    'images/tennants/mutual_smep/mutual_smep_favicon.png',
+                    'mutual_smep_favicon.png',
+                );
+                $now = now();
+
+                DB::table('tenants')->insert([
+                    'client_id' => $clientId,
+                    'codigo' => self::TENANT_CODE,
+                    'nombre' => 'Mutual SMEP',
+                    'timezone' => 'America/Argentina/Buenos_Aires',
+                    'dominio' => 'mutual-smep.localhost',
+                    'base_path' => '/',
+                    'site_title' => 'Tienda Mutual SMEP',
+                    'address' => 'San Lorenzo 1543, Rosario, Santa Fe',
+                    'phone' => '+54 9 341 247-4530',
+                    'primary_color' => '#4A7FF5',
+                    'secondary_color' => '#0051A4',
+                    'danger_color' => '#FF8888',
+                    'success_color' => '#198754',
+                    'header_bg_color' => '#FFFFFF',
+                    'footer_bg_color' => '#0051A4',
+                    'header_logo_id' => $headerLogoId,
+                    'footer_logo_id' => $footerLogoId,
+                    'favicon_id' => $faviconId,
+                    'admin_website_type_code' => 'shopit',
+                    'storefront_website_type_code' => 'shopit',
+                    'display_categories' => true,
+                    'display_seach_bar' => true,
+                    'display_cart' => true,
+                    'cart_editing_policy' => 'quantity_and_remove',
+                    'checkout_editing_policy' => 'disabled',
+                    'created_at' => $now,
+                    'updated_at' => $now,
+                ]);
+
+                $this->assignSocialMedia($now);
+                $this->assignMenus($now);
+            });
+        } catch (Throwable $throwable) {
+            Storage::disk('s3')->delete($this->storedPaths);
+
+            throw $throwable;
+        }
+    }
+
+    public function down(): void
+    {
+        $tenant = DB::table('tenants')
+            ->where('codigo', self::TENANT_CODE)
+            ->first(['id', 'client_id', 'header_logo_id', 'footer_logo_id', 'favicon_id']);
+
+        if ($tenant === null) {
+            return;
+        }
+
+        $attachmentIds = collect([
+            $tenant->header_logo_id,
+            $tenant->footer_logo_id,
+            $tenant->favicon_id,
+        ])->filter()->unique()->values();
+        $storedPaths = DB::table('attachments')
+            ->whereIn('id', $attachmentIds)
+            ->pluck('path')
+            ->all();
+
+        DB::transaction(function () use ($tenant, $attachmentIds): void {
+            DB::table('tenant_social_media')
+                ->where('tenant_code', self::TENANT_CODE)
+                ->delete();
+            DB::table('tenants_menues')
+                ->where('tenant_code', self::TENANT_CODE)
+                ->delete();
+            DB::table('tenants')
+                ->where('id', $tenant->id)
+                ->delete();
+            DB::table('attachments')
+                ->whereIn('id', $attachmentIds)
+                ->delete();
+
+            $clientHasTenants = DB::table('tenants')
+                ->where('client_id', $tenant->client_id)
+                ->exists();
+
+            if (! $clientHasTenants) {
+                DB::table('clients')
+                    ->where('id', $tenant->client_id)
+                    ->where('code', self::CLIENT_CODE)
+                    ->delete();
+            }
+        });
+
+        Storage::disk('s3')->delete($storedPaths);
+    }
+
+    private function clientId(): int
+    {
+        $clientId = DB::table('clients')->where('code', self::CLIENT_CODE)->value('id');
+
+        if ($clientId !== null) {
+            DB::table('clients')->where('id', $clientId)->update([
+                'name' => 'Mutual SMEP',
+                'updated_at' => now(),
+            ]);
+
+            return (int) $clientId;
+        }
+
+        return (int) DB::table('clients')->insertGetId([
+            'code' => self::CLIENT_CODE,
+            'name' => 'Mutual SMEP',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+    }
+
+    private function assignSocialMedia(DateTimeInterface $now): void
+    {
+        $socialMedia = [
+            [
+                'code' => 'instagram',
+                'icon' => 'fa-brands fa-instagram',
+                'name' => 'Instagram',
+                'url' => 'https://www.instagram.com/mutualsmep/',
+                'orden' => 0,
+            ],
+            [
+                'code' => 'facebook',
+                'icon' => 'fa-brands fa-facebook',
+                'name' => 'Facebook',
+                'url' => 'https://www.facebook.com/smeprosario',
+                'orden' => 1,
+            ],
+            [
+                'code' => 'whatsapp',
+                'icon' => 'fa-brands fa-whatsapp',
+                'name' => 'WhatsApp',
+                'url' => 'https://wa.me/5493412474530',
+                'orden' => 2,
+            ],
+        ];
+
+        foreach ($socialMedia as $network) {
+            DB::table('social_media')->insertOrIgnore([
+                'code' => $network['code'],
+                'icon' => $network['icon'],
+                'name' => $network['name'],
+                'created_at' => $now,
+                'updated_at' => $now,
+            ]);
+
+            DB::table('tenant_social_media')->insertOrIgnore([
+                'tenant_code' => self::TENANT_CODE,
+                'social_media_code' => $network['code'],
+                'url' => $network['url'],
+                'orden' => $network['orden'],
+                'created_at' => $now,
+                'updated_at' => $now,
+            ]);
+        }
+    }
+
+    private function assignMenus(DateTimeInterface $now): void
+    {
+        DB::table('menues')
+            ->whereNotIn('code', self::EXCLUDED_MENU_CODES)
+            ->pluck('code')
+            ->each(function (string $menuCode) use ($now): void {
+                $staticContent = match ($menuCode) {
+                    'help.faq' => $this->frequentlyAskedQuestions(),
+                    'help.contact' => $this->contactContent(),
+                    default => null,
+                };
+
+                DB::table('tenants_menues')->updateOrInsert(
+                    [
+                        'tenant_code' => self::TENANT_CODE,
+                        'menu_code' => $menuCode,
+                    ],
+                    [
+                        'static_content' => $staticContent === null
+                            ? null
+                            : json_encode($staticContent, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
+                        'created_at' => $now,
+                        'updated_at' => $now,
+                    ],
+                );
+            });
+    }
+
+    /** @return list<array{pregunta: string, respuesta: string, is_active: bool}> */
+    private function frequentlyAskedQuestions(): array
+    {
+        return [
+            [
+                'pregunta' => '¿Hay algún límite de compra?',
+                'respuesta' => 'La cantidad disponible depende del stock de cada producto.',
+                'is_active' => true,
+            ],
+            [
+                'pregunta' => '¿Cuáles son los medios de pago disponibles?',
+                'respuesta' => 'Podés consultar y seleccionar los medios de pago habilitados al finalizar tu compra.',
+                'is_active' => false,
+            ],
+            [
+                'pregunta' => '¿Cómo puedo recibir asesoramiento antes de comprar?',
+                'respuesta' => 'Podés comunicarte con Mutual SMEP por WhatsApp al +54 9 341 247-4530.',
+                'is_active' => false,
+            ],
+        ];
+    }
+
+    /** @return array<string, mixed> */
+    private function contactContent(): array
+    {
+        return [
+            'whatsapp' => [
+                'whatsapp_url' => 'https://wa.me/5493412474530',
+                'whatsapp_label' => 'Chateá con Mutual SMEP',
+            ],
+            'phone' => '+54 9 341 247-4530',
+            'locations' => [
+                'rosario' => [
+                    'label' => 'Rosario',
+                    'addresses' => [
+                        [
+                            'label' => 'Mutual SMEP',
+                            'address' => 'San Lorenzo 1543, Rosario, Santa Fe',
+                            'coordinates' => [-32.9431184, -60.6437991],
+                        ],
+                    ],
+                ],
+            ],
+        ];
+    }
+
+    private function storeImage(string $relativePath, string $filename): int
+    {
+        $sourcePath = public_path($relativePath);
+
+        if (! is_file($sourcePath)) {
+            throw new RuntimeException("Image not found at path: {$sourcePath}");
+        }
+
+        $contents = file_get_contents($sourcePath);
+
+        if ($contents === false) {
+            throw new RuntimeException("Could not read image at path: {$sourcePath}");
+        }
+
+        $key = (string) Str::uuid();
+        $storedPath = 'tenants/'.self::TENANT_CODE."/{$key}.png";
+
+        if (! Storage::disk('s3')->put($storedPath, $contents)) {
+            throw new RuntimeException("Could not store image at path: {$storedPath}");
+        }
+
+        $this->storedPaths[] = $storedPath;
+
+        return DB::table('attachments')->insertGetId([
+            'key' => $key,
+            'path' => $storedPath,
+            'filename' => $filename,
+            'type' => 'image',
+            'mime_type' => 'image/png',
+            'extension' => 'png',
+            'size' => strlen($contents),
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+    }
+};

database/migrations/2026_09_24_010000_add_soft_deletes_to_desfile_entry_reservations_table.php

@@ -0,0 +1,22 @@
+<?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('desfile_entry_reservations', function (Blueprint $table): void {
+            $table->softDeletes();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('desfile_entry_reservations', function (Blueprint $table): void {
+            $table->dropSoftDeletes();
+        });
+    }
+};

database/migrations/2026_09_24_010000_seed_mutual_smep_categories.php

@@ -0,0 +1,141 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    private const TENANT_CODE = 'mutual_smep';
+
+    /** @var array<string, list<string>> */
+    private const CATEGORIES = [
+        'Dormitorio y Blanco' => [
+            'Colchones',
+            'Bases y Sommiers',
+            'Acolchados y Edredones',
+            'Frazadas y Mantas',
+            'Infantil y Cuna',
+        ],
+        'Electrodomésticos' => [
+            'Heladeras',
+            'Lavarropas y Secarropas',
+            'Cocinas',
+            'Microondas',
+            'Hornos Eléctricos',
+            'Calefones y Termotanques',
+            'Purificadores y Extractores de Cocina',
+            'Preparación de Alimentos',
+            'Café y Desayuno',
+            'Freidoras y Cocción',
+            'Cuidado Personal',
+            'Limpieza y Planchado',
+        ],
+        'Climatización' => [
+            'Aires Acondicionados',
+            'Calefactores a Gas con Salida',
+            'Calefactores a Gas sin Salida',
+            'Calefacción Eléctrica',
+        ],
+        'Tecnología' => [
+            'Celulares',
+            'Notebooks',
+            'Smart TV',
+            'Audio',
+            'Accesorios de Computación',
+            'Soportes para TV',
+        ],
+        'Bicicletas y Aire Libre' => [
+            'Bicicletas Infantiles',
+            'Bicicletas para Adultos',
+            'Piletas',
+        ],
+        'Bazar' => [
+            'Termos',
+        ],
+    ];
+
+    public function up(): void
+    {
+        if (! DB::table('tenants')->where('codigo', self::TENANT_CODE)->exists()) {
+            return;
+        }
+
+        DB::transaction(function (): void {
+            foreach (self::CATEGORIES as $parentName => $subcategoryNames) {
+                $parentId = $this->upsertCategory($parentName, null);
+
+                foreach ($subcategoryNames as $subcategoryName) {
+                    $this->upsertCategory($subcategoryName, $parentId);
+                }
+            }
+        });
+    }
+
+    public function down(): void
+    {
+        DB::transaction(function (): void {
+            foreach (self::CATEGORIES as $parentName => $subcategoryNames) {
+                $parentId = DB::table('categorias')
+                    ->where('tenant_code', self::TENANT_CODE)
+                    ->where('nombre', $parentName)
+                    ->whereNull('categoria_id')
+                    ->value('id');
+
+                if ($parentId === null) {
+                    continue;
+                }
+
+                $subcategoryIds = DB::table('categorias')
+                    ->where('tenant_code', self::TENANT_CODE)
+                    ->where('categoria_id', $parentId)
+                    ->whereIn('nombre', $subcategoryNames)
+                    ->pluck('id');
+
+                foreach ($subcategoryIds as $subcategoryId) {
+                    $hasChildren = DB::table('categorias')
+                        ->where('categoria_id', $subcategoryId)
+                        ->exists();
+
+                    if (! $hasChildren) {
+                        DB::table('categorias')->where('id', $subcategoryId)->delete();
+                    }
+                }
+
+                $hasChildren = DB::table('categorias')
+                    ->where('categoria_id', $parentId)
+                    ->exists();
+
+                if (! $hasChildren) {
+                    DB::table('categorias')->where('id', $parentId)->delete();
+                }
+            }
+        });
+    }
+
+    private function upsertCategory(string $name, ?int $parentId): int
+    {
+        $categoryId = DB::table('categorias')
+            ->where('tenant_code', self::TENANT_CODE)
+            ->where('nombre', $name)
+            ->value('id');
+
+        if ($categoryId !== null) {
+            DB::table('categorias')->where('id', $categoryId)->update([
+                'categoria_id' => $parentId,
+                'is_enabled' => true,
+                'updated_at' => now(),
+            ]);
+
+            return (int) $categoryId;
+        }
+
+        return (int) DB::table('categorias')->insertGetId([
+            'tenant_code' => self::TENANT_CODE,
+            'categoria_id' => $parentId,
+            'nombre' => $name,
+            'is_enabled' => true,
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+    }
+};

database/migrations/2026_09_24_020000_seed_mutual_smep_attributes.php

@@ -0,0 +1,139 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    private const TENANT_CODE = 'mutual_smep';
+
+    /** @var list<array<string, mixed>> */
+    private const ATTRIBUTES = [
+        [
+            'codigo' => 'color',
+            'nombre' => 'Color',
+            'metadata_schema' => [
+                'hex' => ['type' => 'string'],
+            ],
+            'options' => [
+                ['value' => 'Negro', 'label' => 'Negro', 'metadata' => ['hex' => '#000000']],
+                ['value' => 'Blanco', 'label' => 'Blanco', 'metadata' => ['hex' => '#FFFFFF']],
+                ['value' => 'Gris', 'label' => 'Gris', 'metadata' => ['hex' => '#808080']],
+                ['value' => 'Plata', 'label' => 'Plata', 'metadata' => ['hex' => '#C0C0C0']],
+                ['value' => 'Azul', 'label' => 'Azul', 'metadata' => ['hex' => '#0000FF']],
+                ['value' => 'Rojo', 'label' => 'Rojo', 'metadata' => ['hex' => '#DC3545']],
+                ['value' => 'Rosa', 'label' => 'Rosa', 'metadata' => ['hex' => '#FFC0CB']],
+                ['value' => 'Multicolor', 'label' => 'Multicolor'],
+            ],
+        ],
+        [
+            'codigo' => 'medida_cama',
+            'nombre' => 'Medida',
+            'options' => [
+                ['value' => 'Cuna', 'label' => 'Cuna'],
+                ['value' => '1 Plaza', 'label' => '1 Plaza'],
+                ['value' => '1 1/2 Plazas', 'label' => '1 1/2 Plazas'],
+                ['value' => '2 Plazas', 'label' => '2 Plazas'],
+                ['value' => '2 1/2 Plazas', 'label' => '2 1/2 Plazas'],
+                ['value' => 'Queen', 'label' => 'Queen'],
+                ['value' => 'King', 'label' => 'King'],
+            ],
+        ],
+        [
+            'codigo' => 'almacenamiento',
+            'nombre' => 'Almacenamiento',
+            'options' => [
+                ['value' => '128 GB', 'label' => '128 GB'],
+                ['value' => '256 GB', 'label' => '256 GB'],
+                ['value' => '512 GB', 'label' => '512 GB'],
+                ['value' => '1 TB', 'label' => '1 TB'],
+            ],
+        ],
+        [
+            'codigo' => 'memoria_ram',
+            'nombre' => 'Memoria RAM',
+            'options' => [
+                ['value' => '4 GB', 'label' => '4 GB'],
+                ['value' => '8 GB', 'label' => '8 GB'],
+                ['value' => '16 GB', 'label' => '16 GB'],
+            ],
+        ],
+        [
+            'codigo' => 'rodado',
+            'nombre' => 'Rodado',
+            'options' => [
+                ['value' => '16', 'label' => '16'],
+                ['value' => '26', 'label' => '26'],
+                ['value' => '29', 'label' => '29'],
+            ],
+        ],
+    ];
+
+    public function up(): void
+    {
+        if (! DB::table('tenants')->where('codigo', self::TENANT_CODE)->exists()) {
+            return;
+        }
+
+        DB::transaction(function (): void {
+            foreach (self::ATTRIBUTES as $definition) {
+                $attributeId = $this->upsertAttribute($definition);
+
+                DB::table('attribute_options')->where('attribute_id', $attributeId)->delete();
+
+                foreach ($definition['options'] as $index => $option) {
+                    DB::table('attribute_options')->insert([
+                        'attribute_id' => $attributeId,
+                        'value' => $option['value'],
+                        'label' => $option['label'],
+                        'sort_order' => $index + 1,
+                        'metadata' => isset($option['metadata'])
+                            ? json_encode($option['metadata'], JSON_THROW_ON_ERROR)
+                            : null,
+                        'created_at' => now(),
+                        'updated_at' => now(),
+                    ]);
+                }
+            }
+        });
+    }
+
+    public function down(): void
+    {
+        DB::table('attribute')
+            ->where('tenant_codigo', self::TENANT_CODE)
+            ->whereIn('codigo', array_column(self::ATTRIBUTES, 'codigo'))
+            ->delete();
+    }
+
+    /** @param array<string, mixed> $definition */
+    private function upsertAttribute(array $definition): int
+    {
+        $attributeId = DB::table('attribute')
+            ->where('tenant_codigo', self::TENANT_CODE)
+            ->where('codigo', $definition['codigo'])
+            ->value('id');
+        $values = [
+            'nombre' => $definition['nombre'],
+            'is_required' => false,
+            'metadata_schema' => isset($definition['metadata_schema'])
+                ? json_encode($definition['metadata_schema'], JSON_THROW_ON_ERROR)
+                : null,
+            'type' => 'select',
+            'updated_at' => now(),
+        ];
+
+        if ($attributeId !== null) {
+            DB::table('attribute')->where('id', $attributeId)->update($values);
+
+            return (int) $attributeId;
+        }
+
+        return (int) DB::table('attribute')->insertGetId([
+            'tenant_codigo' => self::TENANT_CODE,
+            'codigo' => $definition['codigo'],
+            ...$values,
+            'created_at' => now(),
+        ]);
+    }
+};

database/migrations/2026_09_24_030000_seed_mutual_smep_catalog.php

@@ -0,0 +1,462 @@
+<?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 TENANT_CODE = 'mutual_smep';
+
+    private const MANIFEST = 'data/mutual_smep_catalog_v1.json';
+
+    private const STORAGE_PREFIX = 'tenants/mutual_smep/catalog-v2/';
+
+    private const LEGACY_STORAGE_PREFIX = 'tenants/mutual_smep/catalog-v1/';
+
+    private const BRAND_MARKER = 'Provisioned by Mutual SMEP catalog migration v1.';
+
+    /** @var list<array{code: string, category: string}> */
+    private const FEATURED_GROUPS = [
+        ['code' => 'smep-dormitorio-y-blanco', 'category' => 'Dormitorio y Blanco'],
+        ['code' => 'smep-electrodomesticos', 'category' => 'Electrodomésticos'],
+        ['code' => 'smep-climatizacion', 'category' => 'Climatización'],
+        ['code' => 'smep-tecnologia', 'category' => 'Tecnología'],
+        ['code' => 'smep-bicicletas-y-aire-libre', 'category' => 'Bicicletas y Aire Libre'],
+        ['code' => 'smep-bazar', 'category' => 'Bazar'],
+    ];
+
+    private const HIGHLIGHTED_GROUP_CODE = 'productos-destacados-smep';
+
+    private const CATEGORY_FEATURED_ITEM_LIMIT = 6;
+
+    /** @var list<string> */
+    private const HIGHLIGHTED_PRODUCT_SLUGS = [
+        'acolchado-kavanagh-simil-plumon-reversible',
+        'acolchado-sense-duo-bitono-corderito',
+        'colchon-inducol-constanza',
+        'edredon-lisboa-jean-cartier',
+        'frazada-kavanagh-premium-soft',
+        'kit-edredon-alaska-corderito',
+        'motorola-g15',
+        'smart-tv-noblex-50-dr50-x8500-google-tv',
+        'heladera-gafa-hgf-368afp-330-lt-color-plata',
+        'cafetera-express-atma-ceat-5418p-1-litro',
+        'split-3300-w-tcl-taca-3300fcsa-frio-calor',
+        'bicicleta-venzo-loki-r29-fd-21-v-shimano',
+        'termo-stanley-1-l-adventure-go-to-con-tapon',
+    ];
+
+    /** @var list<string> */
+    private array $storedPaths = [];
+
+    public function up(): void
+    {
+        if (! DB::table('tenants')->where('codigo', self::TENANT_CODE)->exists()) {
+            throw new RuntimeException("Tenant '".self::TENANT_CODE."' not found.");
+        }
+
+        $manifest = $this->manifest();
+        $slugs = array_column($manifest['items'], 'slug');
+        $existingSlug = DB::table('catalog_items')
+            ->where('tenant_code', self::TENANT_CODE)
+            ->whereIn('slug', $slugs)
+            ->value('slug');
+
+        if ($existingSlug !== null) {
+            throw new RuntimeException("Catalog item '{$existingSlug}' already exists for Mutual SMEP.");
+        }
+
+        try {
+            DB::transaction(function () use ($manifest): void {
+                $brandIds = [];
+                $categoryIds = [];
+                $attributeIds = [];
+
+                foreach ($manifest['items'] as $order => $item) {
+                    $brandId = $this->brandId($item['brand'], $brandIds);
+                    $categoryId = $this->categoryId(
+                        $item['parent_category'],
+                        $item['category'],
+                        $categoryIds,
+                    );
+                    $hasVariants = $item['variants'] !== [];
+                    $inventoryId = $hasVariants
+                        ? null
+                        : $this->createInventory((int) $item['stock']);
+                    $catalogItemId = DB::table('catalog_items')->insertGetId([
+                        'tenant_code' => self::TENANT_CODE,
+                        'category_id' => $categoryId,
+                        'brand_id' => $brandId,
+                        'inventory_id' => $inventoryId,
+                        'type' => 'standard',
+                        'slug' => $item['slug'],
+                        'nombre' => $item['name'],
+                        'group_order' => $order + 1,
+                        'descripcion' => $item['description'],
+                        'precio' => $item['price'],
+                        'inventory_policy' => 'tracked',
+                        'inventory_subject' => 'product',
+                        'has_tickets' => false,
+                    ]);
+
+                    $this->attachImages($catalogItemId, null, $item['images']);
+
+                    if (! $hasVariants) {
+                        continue;
+                    }
+
+                    $itemAttributeIds = [];
+                    foreach ($item['attribute_codes'] as $attributeOrder => $attributeCode) {
+                        $attributeId = $this->attributeId($attributeCode, $attributeIds);
+                        $itemAttributeIds[$attributeCode] = DB::table('item_attributes')->insertGetId([
+                            'catalog_item_id' => $catalogItemId,
+                            'attribute_id' => $attributeId,
+                            'allow_multi_select' => false,
+                            'sort_order' => $attributeOrder + 1,
+                            'show_in_selector' => true,
+                            'ticket_label' => null,
+                            'created_at' => now(),
+                            'updated_at' => now(),
+                        ]);
+                    }
+
+                    foreach ($item['variants'] as $variant) {
+                        $variantId = DB::table('variantes')->insertGetId([
+                            'catalog_item_id' => $catalogItemId,
+                            'inventory_id' => $this->createInventory((int) $variant['stock']),
+                            'descripcion' => $variant['description'],
+                            'precio' => $variant['price'],
+                        ]);
+
+                        foreach ($variant['values'] as $attributeCode => $value) {
+                            $itemAttributeId = $itemAttributeIds[$attributeCode] ?? null;
+
+                            if ($itemAttributeId === null) {
+                                throw new RuntimeException(
+                                    "Attribute '{$attributeCode}' is not assigned to '{$item['slug']}'."
+                                );
+                            }
+
+                            DB::table('variant_values')->insert([
+                                'variant_id' => $variantId,
+                                'item_attribute_id' => $itemAttributeId,
+                                'value' => $value,
+                                'created_at' => now(),
+                                'updated_at' => now(),
+                            ]);
+                        }
+
+                        $this->attachImages($catalogItemId, $variantId, $variant['images']);
+                    }
+                }
+
+                $this->createFeaturedGroups();
+            });
+        } catch (Throwable $throwable) {
+            Storage::disk('s3')->delete($this->storedPaths);
+
+            throw $throwable;
+        }
+    }
+
+    public function down(): void
+    {
+        $manifest = $this->manifest();
+        $catalogItemIds = DB::table('catalog_items')
+            ->where('tenant_code', self::TENANT_CODE)
+            ->whereIn('slug', array_column($manifest['items'], 'slug'))
+            ->pluck('id');
+        $variantInventoryIds = DB::table('variantes')
+            ->whereIn('catalog_item_id', $catalogItemIds)
+            ->pluck('inventory_id');
+        $itemInventoryIds = DB::table('catalog_items')
+            ->whereIn('id', $catalogItemIds)
+            ->whereNotNull('inventory_id')
+            ->pluck('inventory_id');
+        $attachmentIds = DB::table('catalog_items_attachments')
+            ->whereIn('catalog_item_id', $catalogItemIds)
+            ->pluck('attachment_id')
+            ->unique()
+            ->values();
+        $storedPaths = DB::table('attachments')
+            ->whereIn('id', $attachmentIds)
+            ->where(fn ($query) => $query
+                ->where('path', 'like', self::STORAGE_PREFIX.'%')
+                ->orWhere('path', 'like', self::LEGACY_STORAGE_PREFIX.'%'))
+            ->pluck('path')
+            ->all();
+
+        DB::transaction(function () use (
+            $catalogItemIds,
+            $variantInventoryIds,
+            $itemInventoryIds,
+            $attachmentIds,
+        ): void {
+            DB::table('featured_groups')
+                ->where('tenant_code', self::TENANT_CODE)
+                ->whereIn('code', [
+                    self::HIGHLIGHTED_GROUP_CODE,
+                    ...array_column(self::FEATURED_GROUPS, 'code'),
+                ])
+                ->delete();
+            DB::table('catalog_items')->whereIn('id', $catalogItemIds)->delete();
+            DB::table('inventories')
+                ->whereIn('id', $variantInventoryIds->merge($itemInventoryIds)->unique())
+                ->delete();
+            DB::table('attachments')->whereIn('id', $attachmentIds)->delete();
+            DB::table('brands')
+                ->where('tenant_codigo', self::TENANT_CODE)
+                ->where('descripcion', self::BRAND_MARKER)
+                ->whereNotExists(fn ($query) => $query
+                    ->selectRaw('1')
+                    ->from('catalog_items')
+                    ->whereColumn('catalog_items.brand_id', 'brands.id'))
+                ->delete();
+        });
+
+        Storage::disk('s3')->delete($storedPaths);
+    }
+
+    /** @return array<string, mixed> */
+    private function manifest(): array
+    {
+        $path = database_path(self::MANIFEST);
+
+        if (! is_file($path)) {
+            throw new RuntimeException("Mutual SMEP catalog manifest not found: {$path}");
+        }
+
+        $manifest = json_decode(
+            (string) file_get_contents($path),
+            true,
+            flags: JSON_THROW_ON_ERROR,
+        );
+
+        if (
+            ($manifest['version'] ?? null) !== 1
+            || ($manifest['tenant_code'] ?? null) !== self::TENANT_CODE
+            || count($manifest['items'] ?? []) !== 142
+            || ($manifest['image_count'] ?? null) !== 511
+        ) {
+            throw new RuntimeException('Mutual SMEP catalog manifest is invalid.');
+        }
+
+        return $manifest;
+    }
+
+    /** @param array<string, int> $cache */
+    private function brandId(?string $name, array &$cache): ?int
+    {
+        if ($name === null) {
+            return null;
+        }
+
+        if (isset($cache[$name])) {
+            return $cache[$name];
+        }
+
+        $brandId = DB::table('brands')
+            ->where('tenant_codigo', self::TENANT_CODE)
+            ->where('nombre', $name)
+            ->value('id');
+
+        if ($brandId === null) {
+            $brandId = DB::table('brands')->insertGetId([
+                'tenant_codigo' => self::TENANT_CODE,
+                'nombre' => $name,
+                'descripcion' => self::BRAND_MARKER,
+                'created_at' => now(),
+                'updated_at' => now(),
+            ]);
+        }
+
+        return $cache[$name] = (int) $brandId;
+    }
+
+    /** @param array<string, int> $cache */
+    private function categoryId(string $parentName, string $name, array &$cache): int
+    {
+        $key = "{$parentName}|{$name}";
+
+        if (isset($cache[$key])) {
+            return $cache[$key];
+        }
+
+        $parentId = DB::table('categorias')
+            ->where('tenant_code', self::TENANT_CODE)
+            ->where('nombre', $parentName)
+            ->whereNull('categoria_id')
+            ->value('id');
+        $categoryId = $parentId === null
+            ? null
+            : DB::table('categorias')
+                ->where('tenant_code', self::TENANT_CODE)
+                ->where('categoria_id', $parentId)
+                ->where('nombre', $name)
+                ->value('id');
+
+        if ($categoryId === null) {
+            throw new RuntimeException("Category '{$parentName} > {$name}' not found for Mutual SMEP.");
+        }
+
+        return $cache[$key] = (int) $categoryId;
+    }
+
+    /** @param array<string, int> $cache */
+    private function attributeId(string $code, array &$cache): int
+    {
+        if (isset($cache[$code])) {
+            return $cache[$code];
+        }
+
+        $attributeId = DB::table('attribute')
+            ->where('tenant_codigo', self::TENANT_CODE)
+            ->where('codigo', $code)
+            ->value('id');
+
+        if ($attributeId === null) {
+            throw new RuntimeException("Attribute '{$code}' not found for Mutual SMEP.");
+        }
+
+        return $cache[$code] = (int) $attributeId;
+    }
+
+    private function createInventory(int $stock): int
+    {
+        return (int) DB::table('inventories')->insertGetId([
+            'sold_units' => 0,
+            'refunded_units' => 0,
+            'reserved_stock' => 0,
+            'real_stock' => $stock,
+        ]);
+    }
+
+    private function createFeaturedGroups(): void
+    {
+        $this->createHighlightedGroup();
+
+        foreach (self::FEATURED_GROUPS as $order => $group) {
+            $categoryId = DB::table('categorias')
+                ->where('tenant_code', self::TENANT_CODE)
+                ->whereNull('categoria_id')
+                ->where('nombre', $group['category'])
+                ->value('id');
+
+            if ($categoryId === null) {
+                throw new RuntimeException("Parent category '{$group['category']}' not found for Mutual SMEP.");
+            }
+
+            $featuredGroupId = DB::table('featured_groups')->insertGetId([
+                'tenant_code' => self::TENANT_CODE,
+                'code' => $group['code'],
+                'source_type' => 'manual',
+                'category_id' => $categoryId,
+                'product_layout' => 'column_with_image',
+                'group_layout' => 'carousel',
+                'group_name' => $group['category'],
+                'group_order' => $order + 2,
+            ]);
+
+            $catalogItemIds = DB::table('catalog_items')
+                ->join('categorias', 'categorias.id', '=', 'catalog_items.category_id')
+                ->where('catalog_items.tenant_code', self::TENANT_CODE)
+                ->where('categorias.tenant_code', self::TENANT_CODE)
+                ->where('categorias.categoria_id', $categoryId)
+                ->orderBy('catalog_items.group_order')
+                ->orderBy('catalog_items.id')
+                ->limit(self::CATEGORY_FEATURED_ITEM_LIMIT)
+                ->pluck('catalog_items.id');
+
+            foreach ($catalogItemIds as $itemOrder => $catalogItemId) {
+                DB::table('featured_items')->insert([
+                    'featured_group_id' => $featuredGroupId,
+                    'catalog_item_id' => $catalogItemId,
+                    'order' => $itemOrder + 1,
+                ]);
+            }
+        }
+    }
+
+    private function createHighlightedGroup(): void
+    {
+        $featuredGroupId = DB::table('featured_groups')->insertGetId([
+            'tenant_code' => self::TENANT_CODE,
+            'code' => self::HIGHLIGHTED_GROUP_CODE,
+            'source_type' => 'manual',
+            'category_id' => null,
+            'product_layout' => 'column_with_image',
+            'group_layout' => 'carousel',
+            'group_name' => 'Productos destacados',
+            'group_order' => 1,
+        ]);
+
+        $catalogItemIds = DB::table('catalog_items')
+            ->where('tenant_code', self::TENANT_CODE)
+            ->whereIn('slug', self::HIGHLIGHTED_PRODUCT_SLUGS)
+            ->pluck('id', 'slug');
+
+        foreach (self::HIGHLIGHTED_PRODUCT_SLUGS as $order => $slug) {
+            $catalogItemId = $catalogItemIds->get($slug);
+
+            if ($catalogItemId === null) {
+                throw new RuntimeException("Highlighted product '{$slug}' not found for Mutual SMEP.");
+            }
+
+            DB::table('featured_items')->insert([
+                'featured_group_id' => $featuredGroupId,
+                'catalog_item_id' => $catalogItemId,
+                'order' => $order + 1,
+            ]);
+        }
+    }
+
+    /** @param list<string> $images */
+    private function attachImages(int $catalogItemId, ?int $variantId, array $images): void
+    {
+        foreach ($images as $order => $relativePath) {
+            $sourcePath = public_path($relativePath);
+
+            if (! is_file($sourcePath)) {
+                throw new RuntimeException("Catalog image not found: {$sourcePath}");
+            }
+
+            $contents = file_get_contents($sourcePath);
+            if ($contents === false) {
+                throw new RuntimeException("Catalog image could not be read: {$sourcePath}");
+            }
+
+            $catalogRelativePath = Str::after(
+                str_replace('\\', '/', $relativePath),
+                'images/tennants/mutual_smep/catalog/',
+            );
+            $storedPath = self::STORAGE_PREFIX.$catalogRelativePath;
+
+            if (! Storage::disk('s3')->put($storedPath, $contents)) {
+                throw new RuntimeException("Catalog image could not be stored: {$storedPath}");
+            }
+
+            $this->storedPaths[] = $storedPath;
+            $attachmentId = DB::table('attachments')->insertGetId([
+                'key' => (string) Str::uuid(),
+                'path' => $storedPath,
+                'filename' => basename($relativePath),
+                'type' => 'image',
+                'mime_type' => 'image/webp',
+                'extension' => 'webp',
+                'size' => strlen($contents),
+                'created_at' => now(),
+                'updated_at' => now(),
+            ]);
+
+            DB::table('catalog_items_attachments')->insert([
+                'catalog_item_id' => $catalogItemId,
+                'variant_id' => $variantId,
+                'attachment_id' => $attachmentId,
+                'orden' => $order,
+                'is_enabled' => true,
+            ]);
+        }
+    }
+};

database/migrations/2026_09_24_040000_seed_mutual_smep_carousel.php

@@ -0,0 +1,140 @@
+<?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 TENANT_CODE = 'mutual_smep';
+
+    private const EXTRA_CODE = 'carousel';
+
+    private const IMAGE_DIRECTORY = 'images/tennants/mutual_smep/carousel';
+
+    private const STORAGE_PREFIX = 'tenants/mutual_smep/extras/carousel-v1/';
+
+    /** @var list<string> */
+    private const IMAGES = [
+        '01-tecnologia.webp',
+        '02-hogar.webp',
+        '03-vida-activa.webp',
+        '04-descanso.webp',
+    ];
+
+    /** @var list<string> */
+    private array $storedPaths = [];
+
+    public function up(): void
+    {
+        $tenant = DB::table('tenants')
+            ->where('codigo', self::TENANT_CODE)
+            ->first(['codigo', 'storefront_website_type_code']);
+
+        if ($tenant === null) {
+            return;
+        }
+
+        $extraId = DB::table('storefront_website_type_extras')
+            ->where('storefront_website_type_code', $tenant->storefront_website_type_code)
+            ->where('codigo', self::EXTRA_CODE)
+            ->value('id');
+
+        if ($extraId === null || DB::table('websites_extras')->where([
+            'website_code' => self::TENANT_CODE,
+            'website_type_extra_id' => $extraId,
+        ])->exists()) {
+            return;
+        }
+
+        try {
+            DB::transaction(function () use ($extraId): void {
+                $attachmentIds = [];
+
+                foreach (self::IMAGES as $filename) {
+                    $attachmentIds[] = $this->storeImage($filename);
+                }
+
+                DB::table('websites_extras')->insert([
+                    'website_code' => self::TENANT_CODE,
+                    'website_type_extra_id' => $extraId,
+                    'config' => json_encode($attachmentIds, JSON_THROW_ON_ERROR),
+                    'is_enabled' => true,
+                    'created_at' => now(),
+                    'updated_at' => now(),
+                ]);
+            });
+        } catch (Throwable $throwable) {
+            Storage::disk('s3')->delete($this->storedPaths);
+
+            throw $throwable;
+        }
+    }
+
+    public function down(): void
+    {
+        $attachments = DB::table('attachments')
+            ->where('path', 'like', self::STORAGE_PREFIX.'%')
+            ->get(['id', 'path']);
+
+        if ($attachments->isEmpty()) {
+            return;
+        }
+
+        $attachmentIds = $attachments->pluck('id')->map(fn ($id): int => (int) $id)->all();
+        $extraId = DB::table('storefront_website_type_extras')
+            ->where('storefront_website_type_code', 'shopit')
+            ->where('codigo', self::EXTRA_CODE)
+            ->value('id');
+
+        DB::transaction(function () use ($attachmentIds, $extraId): void {
+            if ($extraId !== null) {
+                DB::table('websites_extras')
+                    ->where('website_code', self::TENANT_CODE)
+                    ->where('website_type_extra_id', $extraId)
+                    ->where('config', json_encode($attachmentIds, JSON_THROW_ON_ERROR))
+                    ->delete();
+            }
+
+            DB::table('attachments')->whereIn('id', $attachmentIds)->delete();
+        });
+
+        Storage::disk('s3')->delete($attachments->pluck('path')->all());
+    }
+
+    private function storeImage(string $filename): int
+    {
+        $sourcePath = public_path(self::IMAGE_DIRECTORY."/{$filename}");
+
+        if (! is_file($sourcePath)) {
+            throw new RuntimeException("Carousel image not found: {$sourcePath}");
+        }
+
+        $contents = file_get_contents($sourcePath);
+
+        if ($contents === false) {
+            throw new RuntimeException("Carousel image could not be read: {$sourcePath}");
+        }
+
+        $storedPath = self::STORAGE_PREFIX.$filename;
+
+        if (! Storage::disk('s3')->put($storedPath, $contents)) {
+            throw new RuntimeException("Carousel image could not be stored: {$storedPath}");
+        }
+
+        $this->storedPaths[] = $storedPath;
+
+        return (int) DB::table('attachments')->insertGetId([
+            'key' => (string) Str::uuid(),
+            'path' => $storedPath,
+            'filename' => $filename,
+            'type' => 'image',
+            'mime_type' => 'image/webp',
+            'extension' => 'webp',
+            'size' => strlen($contents),
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+    }
+};

database/migrations/2026_09_24_050000_limit_mutual_smep_category_featured_groups.php

@@ -0,0 +1,88 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    private const TENANT_CODE = 'mutual_smep';
+
+    private const ITEM_LIMIT = 6;
+
+    /** @var array<string, string> */
+    private const GROUPS = [
+        'smep-dormitorio-y-blanco' => 'Dormitorio y Blanco',
+        'smep-electrodomesticos' => 'Electrodomésticos',
+        'smep-climatizacion' => 'Climatización',
+        'smep-tecnologia' => 'Tecnología',
+        'smep-bicicletas-y-aire-libre' => 'Bicicletas y Aire Libre',
+        'smep-bazar' => 'Bazar',
+    ];
+
+    public function up(): void
+    {
+        foreach (array_keys(self::GROUPS) as $code) {
+            $groupId = DB::table('featured_groups')
+                ->where('tenant_code', self::TENANT_CODE)
+                ->where('code', $code)
+                ->value('id');
+
+            if ($groupId === null) {
+                continue;
+            }
+
+            $keptItemIds = DB::table('featured_items')
+                ->where('featured_group_id', $groupId)
+                ->orderBy('order')
+                ->orderBy('id')
+                ->limit(self::ITEM_LIMIT)
+                ->pluck('id');
+
+            DB::table('featured_items')
+                ->where('featured_group_id', $groupId)
+                ->when(
+                    $keptItemIds->isNotEmpty(),
+                    fn ($query) => $query->whereNotIn('id', $keptItemIds),
+                )
+                ->delete();
+        }
+    }
+
+    public function down(): void
+    {
+        foreach (self::GROUPS as $code => $parentCategoryName) {
+            $groupId = DB::table('featured_groups')
+                ->where('tenant_code', self::TENANT_CODE)
+                ->where('code', $code)
+                ->value('id');
+            $parentCategoryId = DB::table('categorias')
+                ->where('tenant_code', self::TENANT_CODE)
+                ->whereNull('categoria_id')
+                ->where('nombre', $parentCategoryName)
+                ->value('id');
+
+            if ($groupId === null || $parentCategoryId === null) {
+                continue;
+            }
+
+            $catalogItemIds = DB::table('catalog_items')
+                ->join('categorias', 'categorias.id', '=', 'catalog_items.category_id')
+                ->where('catalog_items.tenant_code', self::TENANT_CODE)
+                ->where('categorias.tenant_code', self::TENANT_CODE)
+                ->where('categorias.categoria_id', $parentCategoryId)
+                ->orderBy('catalog_items.group_order')
+                ->orderBy('catalog_items.id')
+                ->pluck('catalog_items.id');
+
+            DB::table('featured_items')->where('featured_group_id', $groupId)->delete();
+
+            foreach ($catalogItemIds as $order => $catalogItemId) {
+                DB::table('featured_items')->insert([
+                    'featured_group_id' => $groupId,
+                    'catalog_item_id' => $catalogItemId,
+                    'order' => $order + 1,
+                ]);
+            }
+        }
+    }
+};

database/migrations/2026_09_24_060000_optimize_mutual_smep_catalog_images.php

@@ -0,0 +1,112 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+
+return new class extends Migration
+{
+    private const TENANT_CODE = 'mutual_smep';
+
+    private const LEGACY_PREFIX = 'tenants/mutual_smep/catalog-v1/';
+
+    private const OPTIMIZED_PREFIX = 'tenants/mutual_smep/catalog-v2/';
+
+    private const LOCAL_PREFIX = 'images/tennants/mutual_smep/catalog/';
+
+    public function up(): void
+    {
+        $attachments = $this->attachments(self::LEGACY_PREFIX);
+        $uploadedPaths = [];
+
+        try {
+            foreach ($attachments as $attachment) {
+                $relativePath = Str::after($attachment->path, self::LEGACY_PREFIX);
+                $localPath = public_path(self::LOCAL_PREFIX.$relativePath);
+
+                if (! is_file($localPath)) {
+                    throw new RuntimeException("Optimized catalog image not found: {$localPath}");
+                }
+
+                $contents = file_get_contents($localPath);
+                if ($contents === false) {
+                    throw new RuntimeException("Optimized catalog image could not be read: {$localPath}");
+                }
+
+                $optimizedPath = self::OPTIMIZED_PREFIX.$relativePath;
+                if (! Storage::disk('s3')->put($optimizedPath, $contents)) {
+                    throw new RuntimeException("Optimized catalog image could not be stored: {$optimizedPath}");
+                }
+
+                $uploadedPaths[] = $optimizedPath;
+                $attachment->optimized_path = $optimizedPath;
+                $attachment->optimized_size = strlen($contents);
+            }
+
+            DB::transaction(function () use ($attachments): void {
+                foreach ($attachments as $attachment) {
+                    DB::table('attachments')->where('id', $attachment->id)->update([
+                        'path' => $attachment->optimized_path,
+                        'size' => $attachment->optimized_size,
+                        'updated_at' => now(),
+                    ]);
+                }
+            });
+        } catch (Throwable $throwable) {
+            Storage::disk('s3')->delete($uploadedPaths);
+
+            throw $throwable;
+        }
+    }
+
+    public function down(): void
+    {
+        $attachments = $this->attachments(self::OPTIMIZED_PREFIX)
+            ->filter(function (object $attachment): bool {
+                $relativePath = Str::after($attachment->path, self::OPTIMIZED_PREFIX);
+                $legacyPath = self::LEGACY_PREFIX.$relativePath;
+
+                if (! Storage::disk('s3')->exists($legacyPath)) {
+                    return false;
+                }
+
+                $attachment->legacy_path = $legacyPath;
+                $attachment->legacy_size = Storage::disk('s3')->size($legacyPath);
+
+                return true;
+            })
+            ->values();
+
+        DB::transaction(function () use ($attachments): void {
+            foreach ($attachments as $attachment) {
+                DB::table('attachments')->where('id', $attachment->id)->update([
+                    'path' => $attachment->legacy_path,
+                    'size' => $attachment->legacy_size,
+                    'updated_at' => now(),
+                ]);
+            }
+        });
+
+        Storage::disk('s3')->delete($attachments->pluck('path')->all());
+    }
+
+    private function attachments(string $prefix): Collection
+    {
+        return DB::table('attachments')
+            ->join(
+                'catalog_items_attachments',
+                'catalog_items_attachments.attachment_id',
+                '=',
+                'attachments.id',
+            )
+            ->join('catalog_items', 'catalog_items.id', '=', 'catalog_items_attachments.catalog_item_id')
+            ->where('catalog_items.tenant_code', self::TENANT_CODE)
+            ->where('attachments.path', 'like', $prefix.'%')
+            ->select('attachments.id', 'attachments.path', 'attachments.size')
+            ->distinct()
+            ->orderBy('attachments.id')
+            ->get();
+    }
+};

database/migrations/2026_09_25_000000_associate_adminapp_tickets_menu_with_desfile.php

@@ -0,0 +1,43 @@
+<?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 = 'desfile_pura_tendencia';
+
+    public function up(): void
+    {
+        if (
+            ! DB::table('menues')->where('code', self::MENU_CODE)->exists()
+            || ! DB::table('tenants')->where('codigo', self::TENANT_CODE)->exists()
+        ) {
+            return;
+        }
+
+        $now = now();
+
+        DB::table('tenants_menues')->updateOrInsert(
+            [
+                'tenant_code' => self::TENANT_CODE,
+                'menu_code' => self::MENU_CODE,
+            ],
+            [
+                'static_content' => null,
+                'created_at' => $now,
+                'updated_at' => $now,
+            ],
+        );
+    }
+
+    public function down(): void
+    {
+        DB::table('tenants_menues')
+            ->where('tenant_code', self::TENANT_CODE)
+            ->where('menu_code', self::MENU_CODE)
+            ->delete();
+    }
+};

database/migrations/2026_09_28_000000_add_client_id_to_events.php

@@ -0,0 +1,26 @@
+<?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('events', function (Blueprint $table): void {
+            $table->foreignId('client_id')
+                ->nullable()
+                ->after('id')
+                ->constrained('clients')
+                ->restrictOnDelete();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('events', function (Blueprint $table): void {
+            $table->dropConstrainedForeignId('client_id');
+        });
+    }
+};

database/migrations/2026_09_28_000100_add_event_id_to_compras.php

@@ -0,0 +1,44 @@
+<?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::table('compras', function (Blueprint $table): void {
+            $table->foreignId('event_id')
+                ->nullable()
+                ->after('tenant_codigo')
+                ->constrained('events')
+                ->nullOnDelete();
+        });
+
+        DB::table('compras')
+            ->orderBy('id')
+            ->each(function (object $purchase): void {
+                $eventIds = DB::table('compra_items')
+                    ->join('catalog_items', 'catalog_items.id', '=', 'compra_items.source_catalog_item_id')
+                    ->where('compra_items.compra_id', $purchase->id)
+                    ->whereNotNull('catalog_items.event_id')
+                    ->distinct()
+                    ->pluck('catalog_items.event_id');
+
+                if ($eventIds->count() === 1) {
+                    DB::table('compras')
+                        ->where('id', $purchase->id)
+                        ->update(['event_id' => $eventIds->first()]);
+                }
+            });
+    }
+
+    public function down(): void
+    {
+        Schema::table('compras', function (Blueprint $table): void {
+            $table->dropConstrainedForeignId('event_id');
+        });
+    }
+};

database/migrations/2026_09_28_000200_assign_arrufo_event_to_pyme_rural_client.php

@@ -0,0 +1,42 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    private const EVENT_TITLE = '26.º Fiesta de la Tradición y 4.º Encuentro de Agrupaciones Gauchas';
+
+    public function up(): void
+    {
+        $clientId = DB::table('clients')
+            ->where('code', 'pyme_rural')
+            ->value('id');
+
+        if ($clientId === null) {
+            return;
+        }
+
+        DB::table('events')
+            ->where('tenant_code', 'onticket')
+            ->where('title', self::EVENT_TITLE)
+            ->update(['client_id' => $clientId]);
+    }
+
+    public function down(): void
+    {
+        $clientId = DB::table('clients')
+            ->where('code', 'pyme_rural')
+            ->value('id');
+
+        if ($clientId === null) {
+            return;
+        }
+
+        DB::table('events')
+            ->where('tenant_code', 'onticket')
+            ->where('title', self::EVENT_TITLE)
+            ->where('client_id', $clientId)
+            ->update(['client_id' => null]);
+    }
+};

database/migrations/2026_10_01_000000_add_event_id_to_users_table.php

@@ -0,0 +1,28 @@
+<?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('users', function (Blueprint $table): void {
+            $table->foreignId('event_id')
+                ->nullable()
+                ->after('tenant_codigo')
+                ->constrained('events')
+                ->cascadeOnUpdate()
+                ->restrictOnDelete();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('users', function (Blueprint $table): void {
+            $table->dropForeign(['event_id']);
+            $table->dropColumn('event_id');
+        });
+    }
+};

database/migrations/2026_10_02_000000_generalize_ticket_reservations.php

@@ -0,0 +1,53 @@
+<?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
+    {
+        // Validate before changing the schema, including soft-deleted reservations.
+        if (DB::table('desfile_entry_reservations as reservations')
+            ->leftJoin('variantes', 'variantes.id', '=', 'reservations.variant_id')
+            ->leftJoin('catalog_items', 'catalog_items.id', '=', 'variantes.catalog_item_id')
+            ->whereNull('catalog_items.id')->exists()) {
+            throw new LogicException('No se puede determinar el catálogo de todas las reservas existentes.');
+        }
+
+        Schema::rename('desfile_reservation_batches', 'reservation_batches');
+        Schema::rename('desfile_entry_reservations', 'entry_reservations');
+
+        Schema::table('entry_reservations', function (Blueprint $table): void {
+            $table->foreignId('catalog_item_id')->nullable()
+                ->constrained('catalog_items')->restrictOnDelete();
+            $table->unsignedBigInteger('variant_id')->nullable()->change();
+        });
+
+        DB::table('entry_reservations')->update([
+            'catalog_item_id' => DB::raw('(SELECT catalog_item_id FROM variantes WHERE variantes.id = entry_reservations.variant_id)'),
+        ]);
+
+        Schema::table('entry_reservations', function (Blueprint $table): void {
+            $table->unsignedBigInteger('catalog_item_id')->nullable(false)->change();
+        });
+    }
+
+    public function down(): void
+    {
+        // The old schema cannot represent tickets without variants. Never discard them.
+        if (DB::table('entry_reservations')->whereNull('variant_id')->exists()) {
+            throw new LogicException('No se puede revertir mientras existan reservas sin variante.');
+        }
+
+        Schema::table('entry_reservations', function (Blueprint $table): void {
+            $table->dropConstrainedForeignId('catalog_item_id');
+            $table->unsignedBigInteger('variant_id')->nullable(false)->change();
+        });
+
+        Schema::rename('entry_reservations', 'desfile_entry_reservations');
+        Schema::rename('reservation_batches', 'desfile_reservation_batches');
+    }
+};

database/migrations/2026_10_02_010000_add_ticket_reservations_adminapp_menu.php

@@ -0,0 +1,82 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    private const MENU_CODE = 'adminapp.ticket-reservations';
+
+    private const TENANT_CODE = 'onticket';
+
+    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' => 'Reserva de Tickets',
+                    'parent_menu_code' => 'main.adminapp',
+                    'content_type' => 'dynamic',
+                    'static_content_schema' => null,
+                    'route' => '/admin/ticket-reservations',
+                    '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/scripts/build_mutual_smep_catalog_assets.php

@@ -0,0 +1,311 @@
+<?php
+
+declare(strict_types=1);
+
+const CATALOG_IMAGE_MAX_DIMENSION = 960;
+const CATALOG_IMAGE_WEBP_QUALITY = 76;
+
+$sourceRoot = 'C:\\Users\\ncoronel\\Documents\\catalogo_smep_limpio';
+$projectRoot = dirname(__DIR__, 2);
+$assetRoot = $projectRoot.'/public/images/tennants/mutual_smep/catalog';
+$manifestPath = $projectRoot.'/database/data/mutual_smep_catalog_v1.json';
+$defaultStock = 10;
+
+if (! is_dir($sourceRoot)) {
+    throw new RuntimeException("Source catalog not found: {$sourceRoot}");
+}
+
+/** @return array{0: string, 1: string} */
+function catalogDestination(string $source, string $name): array
+{
+    return match ($source) {
+        'acolchados-frazadas-y-edredon' => preg_match('/^(Frazada|Manta)/iu', $name)
+            ? ['Dormitorio y Blanco', 'Frazadas y Mantas']
+            : ['Dormitorio y Blanco', 'Acolchados y Edredones'],
+        'acolchados-y-sabanas-infantil' => ['Dormitorio y Blanco', 'Infantil y Cuna'],
+        'base-sommier-1-pl-0-80x1-90', 'base-sommier-2-pl-1-40x1-90' => ['Dormitorio y Blanco', 'Bases y Sommiers'],
+        'colchon-1-plaza-0-80x1-90', 'colchon-2-plazas-1-40x1-90' => str_starts_with(mb_strtolower($name), 'soporte')
+            ? ['Tecnología', 'Soportes para TV']
+            : ['Dormitorio y Blanco', 'Colchones'],
+        'aires-acondicionados' => ['Climatización', 'Aires Acondicionados'],
+        'calefaccion-con-salida-al-ext' => ['Climatización', 'Calefactores a Gas con Salida'],
+        'calefactor-sin-salida-al-ext' => ['Climatización', 'Calefactores a Gas sin Salida'],
+        'calefaccion-electrica' => ['Climatización', 'Calefacción Eléctrica'],
+        'calefones-y-termotanques' => ['Electrodomésticos', 'Calefones y Termotanques'],
+        'heladeras' => ['Electrodomésticos', 'Heladeras'],
+        'lavarropas-automaticos' => ['Electrodomésticos', 'Lavarropas y Secarropas'],
+        'cocinas' => ['Electrodomésticos', 'Cocinas'],
+        'purificador-de-aire' => ['Electrodomésticos', 'Purificadores y Extractores de Cocina'],
+        'microondas-y-hornos-electricos' => str_starts_with(mb_strtolower($name), 'horno')
+            ? ['Electrodomésticos', 'Hornos Eléctricos']
+            : ['Electrodomésticos', 'Microondas'],
+        'electrodomesticos-pequenos' => smallApplianceCategory($name),
+        'celulares' => ['Tecnología', 'Celulares'],
+        'notebooks-y-tablets' => ['Tecnología', 'Notebooks'],
+        'smart-tv' => str_starts_with(mb_strtolower($name), 'soporte')
+            ? ['Tecnología', 'Soportes para TV']
+            : ['Tecnología', 'Smart TV'],
+        'tecnologia' => preg_match('/^(Mouse|Teclado)/iu', $name)
+            ? ['Tecnología', 'Accesorios de Computación']
+            : ['Tecnología', 'Audio'],
+        'bicicletas' => preg_match('/\bR16\b/iu', $name)
+            ? ['Bicicletas y Aire Libre', 'Bicicletas Infantiles']
+            : ['Bicicletas y Aire Libre', 'Bicicletas para Adultos'],
+        'piletas' => ['Bicicletas y Aire Libre', 'Piletas'],
+        'bazar' => ['Bazar', 'Termos'],
+        default => throw new RuntimeException("Unmapped source category: {$source}"),
+    };
+}
+
+/** @return array{0: string, 1: string} */
+function smallApplianceCategory(string $name): array
+{
+    return match (true) {
+        preg_match('/^(Cafetera|Pava eléctrica|Tostadora)/iu', $name) === 1 => ['Electrodomésticos', 'Café y Desayuno'],
+        preg_match('/^(Freidora|Waflera|Pochoclera)/iu', $name) === 1 => ['Electrodomésticos', 'Freidoras y Cocción'],
+        preg_match('/^(Secador|Cortacabello|Cortabarba)/iu', $name) === 1 => ['Electrodomésticos', 'Cuidado Personal'],
+        preg_match('/^(Lustraspiradora|Plancha)/iu', $name) === 1 => ['Electrodomésticos', 'Limpieza y Planchado'],
+        default => ['Electrodomésticos', 'Preparación de Alimentos'],
+    };
+}
+
+function productBrand(string $name): ?string
+{
+    if (preg_match('/\bJC\b/u', $name)) {
+        return 'Jean Cartier';
+    }
+
+    if (mb_stripos($name, 'Liliana') !== false) {
+        return 'Liliana';
+    }
+
+    foreach ([
+        'Rosario Central', 'Jean Cartier', 'King Koil', 'Fire Bird', 'Xtrike Me',
+        'Whitenblack', 'Electrolux', 'Kavanagh', 'Pelopincho', 'Suavegom',
+        'Motorola', 'Samsung', 'Xiaomi', 'Moulinex', 'Peabody', 'Philips',
+        'Florencia', 'Kohinoor', 'Inducol', 'Longvie', 'Stanley', 'Noblex',
+        'Moonki', 'Lenovo', 'Piero', 'Eskabe', 'Oster', 'Drean', 'Gafa', 'Atma',
+        'Spar', 'Stark', 'Venzo', 'Havit', 'Acer', 'ASUS', 'MSI', 'Philco',
+        'Gama', 'GIGO', 'Ross', 'Nakan', 'TCL', 'BGH', 'JBL', 'TST', 'GBS', 'BLU',
+    ] as $brand) {
+        if (mb_stripos($name, $brand) !== false) {
+            return $brand;
+        }
+    }
+
+    return null;
+}
+
+/** @return array{key: string, name: string, values: array<string, string>}|null */
+function variantGroup(string $name): ?array
+{
+    $measure = bedMeasureValue($name);
+    $groups = [
+        '/(?:Kavanagh.*[Ss][ií]mil plumón reversible|[Ss][ií]mil plumón reversible.*Kavanagh)/iu' => ['acolchado-kavanagh-simil-plumon-reversible', 'Acolchado Kavanagh Símil Plumón Reversible'],
+        '/Edredón.*Lisboa/iu' => ['edredon-lisboa-jean-cartier', 'Edredón Lisboa Jean Cartier'],
+        '/Sense Dúo Bitono con corderito/iu' => ['acolchado-sense-duo-bitono-corderito', 'Acolchado Sense Dúo Bitono con Corderito'],
+        '/Frazada polar.*Kavanagh Premium Soft/iu' => ['frazada-kavanagh-premium-soft', 'Frazada Kavanagh Premium Soft'],
+        '/Kit Edredón.*Alaska.*corderito/iu' => ['kit-edredon-alaska-corderito', 'Kit Edredón Alaska con Corderito'],
+        '/Colch[oó]n Inducol Constanza/iu' => ['colchon-inducol-constanza', 'Colchón Inducol Constanza'],
+    ];
+
+    foreach ($groups as $pattern => [$key, $itemName]) {
+        if ($measure !== null && preg_match($pattern, $name)) {
+            return [
+                'key' => $key,
+                'name' => $itemName,
+                'values' => ['medida_cama' => $measure],
+            ];
+        }
+    }
+
+    if (preg_match('/Motorola G15\s+4\/(256|512)\s*GB/iu', $name, $match)) {
+        return [
+            'key' => 'motorola-g15',
+            'name' => 'Motorola G15',
+            'values' => [
+                'memoria_ram' => '4 GB',
+                'almacenamiento' => "{$match[1]} GB",
+            ],
+        ];
+    }
+
+    return null;
+}
+
+function bedMeasureValue(string $name): ?string
+{
+    return match (true) {
+        preg_match('/\bcuna\b/iu', $name) === 1 => 'Cuna',
+        preg_match('/\bKing\b/iu', $name) === 1 => 'King',
+        preg_match('/\bQueen\b/iu', $name) === 1 => 'Queen',
+        preg_match('/2\s*1\/2\s*pl/iu', $name) === 1 => '2 1/2 Plazas',
+        preg_match('/1\s*1\/2\s*pl/iu', $name) === 1 => '1 1/2 Plazas',
+        preg_match('/1[,.]40\s*x?\s*1[,.]90|140x190|140x24/iu', $name) === 1 => '2 Plazas',
+        preg_match('/0[,.](80|90)\s*x?\s*1[,.]90|080x|090x|0,8x/iu', $name) === 1 => '1 Plaza',
+        default => null,
+    };
+}
+
+function compressCatalogImage(string $source, string $destination): void
+{
+    $sourceImage = @imagecreatefromjpeg($source);
+    if ($sourceImage === false) {
+        throw new RuntimeException("Unable to read JPEG image: {$source}");
+    }
+
+    $width = imagesx($sourceImage);
+    $height = imagesy($sourceImage);
+    $scale = min(1, CATALOG_IMAGE_MAX_DIMENSION / max($width, $height));
+    $targetWidth = max(1, (int) round($width * $scale));
+    $targetHeight = max(1, (int) round($height * $scale));
+    $targetImage = imagecreatetruecolor($targetWidth, $targetHeight);
+
+    if ($targetImage === false) {
+        throw new RuntimeException("Unable to allocate image: {$source}");
+    }
+
+    imagefill($targetImage, 0, 0, imagecolorallocate($targetImage, 255, 255, 255));
+    imagecopyresampled(
+        $targetImage,
+        $sourceImage,
+        0,
+        0,
+        0,
+        0,
+        $targetWidth,
+        $targetHeight,
+        $width,
+        $height,
+    );
+
+    $destinationDirectory = dirname($destination);
+    if (! is_dir($destinationDirectory) && ! mkdir($destinationDirectory, 0777, true) && ! is_dir($destinationDirectory)) {
+        throw new RuntimeException("Unable to create directory: {$destinationDirectory}");
+    }
+
+    if (! imagewebp($targetImage, $destination, CATALOG_IMAGE_WEBP_QUALITY)) {
+        throw new RuntimeException("Unable to write WebP image: {$destination}");
+    }
+}
+
+$rawProducts = [];
+$jsonFiles = glob($sourceRoot.'\\*\\*.json') ?: [];
+sort($jsonFiles);
+
+foreach ($jsonFiles as $jsonFile) {
+    $data = json_decode((string) file_get_contents($jsonFile), true, flags: JSON_THROW_ON_ERROR);
+    $sourceCategory = (string) $data['categoria']['slug'];
+
+    foreach ($data['productos'] as $product) {
+        [$parentCategory, $category] = catalogDestination($sourceCategory, $product['nombre']);
+        $images = [];
+
+        foreach ($product['imagenes'] as $relativeImage) {
+            $sourceImage = dirname($jsonFile).'/'.str_replace('/', DIRECTORY_SEPARATOR, $relativeImage);
+            $basename = pathinfo($relativeImage, PATHINFO_FILENAME).'.webp';
+            $publicRelativePath = "images/tennants/mutual_smep/catalog/{$sourceCategory}/{$basename}";
+            $destination = $projectRoot.'/public/'.$publicRelativePath;
+            compressCatalogImage($sourceImage, $destination);
+            $images[] = $publicRelativePath;
+        }
+
+        $rawProducts[] = [
+            'source_slug' => $product['slug'],
+            'name' => $product['nombre'],
+            'description' => $product['descripcion'] ?? null,
+            'price' => (float) $product['precio']['importe'],
+            'brand' => productBrand($product['nombre']),
+            'parent_category' => $parentCategory,
+            'category' => $category,
+            'images' => $images,
+            'variant_group' => variantGroup($product['nombre']),
+        ];
+    }
+}
+
+$items = [];
+
+foreach ($rawProducts as $product) {
+    $group = $product['variant_group'];
+
+    if ($group === null) {
+        $items[$product['source_slug']] = [
+            'slug' => $product['source_slug'],
+            'name' => $product['name'],
+            'description' => $product['description'],
+            'price' => $product['price'],
+            'stock' => $defaultStock,
+            'brand' => $product['brand'],
+            'parent_category' => $product['parent_category'],
+            'category' => $product['category'],
+            'images' => $product['images'],
+            'attribute_codes' => [],
+            'variants' => [],
+        ];
+
+        continue;
+    }
+
+    $key = $group['key'];
+    if (! isset($items[$key])) {
+        $items[$key] = [
+            'slug' => $key,
+            'name' => $group['name'],
+            'description' => $product['description'],
+            'price' => $product['price'],
+            'stock' => null,
+            'brand' => $product['brand'],
+            'parent_category' => $product['parent_category'],
+            'category' => $product['category'],
+            'images' => [],
+            'attribute_codes' => [],
+            'variants' => [],
+        ];
+    }
+
+    $items[$key]['price'] = min($items[$key]['price'], $product['price']);
+    $items[$key]['description'] ??= $product['description'];
+    $items[$key]['brand'] ??= $product['brand'];
+    $items[$key]['attribute_codes'] = array_values(array_unique([
+        ...$items[$key]['attribute_codes'],
+        ...array_keys($group['values']),
+    ]));
+    $items[$key]['variants'][] = [
+        'source_slug' => $product['source_slug'],
+        'description' => $product['description'],
+        'price' => $product['price'],
+        'stock' => $defaultStock,
+        'values' => $group['values'],
+        'images' => $product['images'],
+    ];
+}
+
+ksort($items);
+
+$manifest = [
+    'version' => 1,
+    'tenant_code' => 'mutual_smep',
+    'default_stock' => $defaultStock,
+    'source_product_count' => count($rawProducts),
+    'catalog_item_count' => count($items),
+    'image_count' => array_sum(array_map(fn (array $product): int => count($product['images']), $rawProducts)),
+    'items' => array_values($items),
+];
+
+$manifestDirectory = dirname($manifestPath);
+if (! is_dir($manifestDirectory) && ! mkdir($manifestDirectory, 0777, true) && ! is_dir($manifestDirectory)) {
+    throw new RuntimeException("Unable to create directory: {$manifestDirectory}");
+}
+
+file_put_contents(
+    $manifestPath,
+    json_encode($manifest, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR).PHP_EOL,
+);
+
+echo json_encode([
+    'manifest' => $manifestPath,
+    'source_products' => count($rawProducts),
+    'catalog_items' => count($items),
+    'images' => $manifest['image_count'],
+], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES), PHP_EOL;

database/seeders/AttributeSeeder.php

@@ -3,10 +3,10 @@
 namespace Database\Seeders;
 
 use App\Domains\Commerce\Catalog\Models\Attribute;
-use App\Shared\Enums\FieldType;
 use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Ticket\Enums\ValidityTimeType;
 use App\Domains\Ticketing\Ticket\Models\ValidityTime;
+use App\Shared\Enums\FieldType;
 use Illuminate\Database\Seeder;
 
 class AttributeSeeder extends Seeder
@@ -25,6 +25,10 @@ class AttributeSeeder extends Seeder
                 continue;
             }
 
+            if ($tenant->codigo === 'mutual_smep') {
+                continue;
+            }
+
             $this->seedAttribute($tenant, [
                 'codigo' => 'color',
                 'nombre' => 'Color',

database/seeders/DatabaseSeeder.php

@@ -29,7 +29,9 @@ class DatabaseSeeder extends Seeder
             TenantSeeder::class,
             DesfilePuraTendenciaSeeder::class,
             AttributeSeeder::class,
+            MutualSmepAttributeSeeder::class,
             CategorySeeder::class,
+            MutualSmepCategorySeeder::class,
             BrandSeeder::class,
             ProductCatalogFromImagesSeeder::class,
             FiestaFutbolInfantilProductSeeder::class,

database/seeders/FiestaTradicionArrufoSeeder.php

@@ -6,6 +6,7 @@ use App\Domains\Commerce\Catalog\Enums\InventoryPolicy;
 use App\Domains\Commerce\Catalog\Models\Attribute;
 use App\Domains\Commerce\Catalog\Models\CatalogItem;
 use App\Domains\Commerce\Catalog\Services\CatalogService;
+use App\Domains\Core\Client\Models\Client;
 use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Event\Models\Event;
 use App\Shared\Attachable\Services\AttachmentService;
@@ -35,6 +36,12 @@ class FiestaTradicionArrufoSeeder extends Seeder
             throw new RuntimeException("Tenant 'onticket' no encontrado.");
         }
 
+        $client = Client::query()->where('code', 'pyme_rural')->first();
+
+        if ($client === null) {
+            throw new RuntimeException("Client 'pyme_rural' no encontrado.");
+        }
+
         Attribute::query()->firstOrCreate(
             ['tenant_codigo' => $tenant->codigo, 'codigo' => 'event_date'],
             ['nombre' => 'Fecha', 'type' => FieldType::EventDate, 'is_required' => true],
@@ -45,6 +52,7 @@ class FiestaTradicionArrufoSeeder extends Seeder
             ['published_at' => now()],
         );
         $event->update([
+            'client_id' => $client->id,
             'subtitle' => 'Una noche para celebrar nuestras raíces y mantener viva la tradición gaucha.',
             'description' => 'La 26.º Fiesta de la Tradición y 4.º Encuentro de Agrupaciones Gauchas reunirá a agrupaciones, artesanos, pilcheros y público en general para compartir una jornada dedicada a nuestras costumbres y cultura.'
                 ."\n\n".'Un encuentro para disfrutar de la tradición, la identidad gaucha y el espíritu de camaradería, en el Predio de Doma del Club Unión Deportiva Arrufó.'

database/seeders/MenuSeeder.php

@@ -100,6 +100,12 @@ class MenuSeeder extends Seeder
                 'parent_menu_code' => 'main.adminapp',
                 'route' => '/admin/tickets',
             ],
+            [
+                'code' => 'adminapp.ticket-reservations',
+                'label' => 'Reserva de Tickets',
+                'parent_menu_code' => 'main.adminapp',
+                'route' => '/admin/ticket-reservations',
+            ],
             [
                 'code' => 'adminapp.fiesta-futbol-infantil.entradas',
                 'label' => 'Entradas',
@@ -130,6 +136,12 @@ class MenuSeeder extends Seeder
                 'parent_menu_code' => 'main.adminapp',
                 'route' => '/admin/desfile/entradas',
             ],
+            [
+                'code' => 'adminapp.desfile.reservas',
+                'label' => 'Reserva de Tickets',
+                'parent_menu_code' => 'main.adminapp',
+                'route' => '/admin/desfile/reservas',
+            ],
             [
                 'code' => 'account',
                 'label' => 'Mi cuenta',
@@ -290,9 +302,12 @@ class MenuSeeder extends Seeder
         $helpTenantCodes = [
             'sonder',
             'fiesta_futbol_infantil',
+            'mutual_smep',
+        ];
+        $ticketAdminMenuCodes = [
+            'adminapp.tickets',
         ];
         $fiestaCategoryMenuCodes = [
-            'adminapp.tickets',
             'adminapp.fiesta-futbol-infantil.entradas',
             'adminapp.fiesta-futbol-infantil.alojamientos',
             'adminapp.fiesta-futbol-infantil.merchandising',
@@ -306,8 +321,10 @@ class MenuSeeder extends Seeder
         ];
         $desfileMenuCodes = [
             'adminapp.desfile.entradas',
+            'adminapp.desfile.reservas',
         ];
         $onTicketMenuCodes = [
+            'adminapp.ticket-reservations',
             'event.index',
             'event.category',
             'event.detail',
@@ -356,6 +373,42 @@ class MenuSeeder extends Seeder
                 ],
             ],
         ];
+        $mutualSmepFrequentlyAskedQuestions = [
+            [
+                'pregunta' => '¿Hay algún límite de compra?',
+                'respuesta' => 'La cantidad disponible depende del stock de cada producto.',
+                'is_active' => true,
+            ],
+            [
+                'pregunta' => '¿Cuáles son los medios de pago disponibles?',
+                'respuesta' => 'Podés consultar y seleccionar los medios de pago habilitados al finalizar tu compra.',
+                'is_active' => false,
+            ],
+            [
+                'pregunta' => '¿Cómo puedo recibir asesoramiento antes de comprar?',
+                'respuesta' => 'Podés comunicarte con Mutual SMEP por WhatsApp al +54 9 341 247-4530.',
+                'is_active' => false,
+            ],
+        ];
+        $mutualSmepContactContent = [
+            'whatsapp' => [
+                'whatsapp_url' => 'https://wa.me/5493412474530',
+                'whatsapp_label' => 'Chateá con Mutual SMEP',
+            ],
+            'phone' => '+54 9 341 247-4530',
+            'locations' => [
+                'rosario' => [
+                    'label' => 'Rosario',
+                    'addresses' => [
+                        [
+                            'label' => 'Mutual SMEP',
+                            'address' => 'San Lorenzo 1543, Rosario, Santa Fe',
+                            'coordinates' => [-32.9431184, -60.6437991],
+                        ],
+                    ],
+                ],
+            ],
+        ];
 
         foreach ($tenants as $tenant) {
             $menuCodes = $allMenus;
@@ -372,6 +425,10 @@ class MenuSeeder extends Seeder
                 $menuCodes = array_diff($menuCodes, $helpMenuCodes);
             }
 
+            if (! in_array($tenant->codigo, ['fiesta_futbol_infantil', 'desfile_pura_tendencia'], true)) {
+                $menuCodes = array_diff($menuCodes, $ticketAdminMenuCodes);
+            }
+
             if ($tenant->codigo !== 'fiesta_futbol_infantil') {
                 $menuCodes = array_diff($menuCodes, $fiestaCategoryMenuCodes);
             } else {
@@ -393,10 +450,14 @@ class MenuSeeder extends Seeder
 
             if (in_array($tenant->codigo, $helpTenantCodes, true)) {
                 $tenant->menues()->updateExistingPivot('help.faq', [
-                    'static_content' => $frequentlyAskedQuestions,
+                    'static_content' => $tenant->codigo === 'mutual_smep'
+                        ? $mutualSmepFrequentlyAskedQuestions
+                        : $frequentlyAskedQuestions,
                 ]);
                 $tenant->menues()->updateExistingPivot('help.contact', [
-                    'static_content' => $contactContent,
+                    'static_content' => $tenant->codigo === 'mutual_smep'
+                        ? $mutualSmepContactContent
+                        : $contactContent,
                 ]);
             }
         }