feat: enhance address handling with coordinates and integrate into event resources

feat(migration): create addresses and tenant_addresses tables
feat(migration): add data migration for copying contact menu addresses
test: add ContactAddressesTest for address and tenant address functionality

ShopIt_API_Postman_Collection.json

@@ -2470,45 +2470,6 @@
                             },
                             "response": []
                         },
-                        {
-                            "name": "Create Tenant",
-                            "request": {
-                                "method": "POST",
-                                "header": [
-                                    {
-                                        "key": "Accept",
-                                        "value": "application/json",
-                                        "type": "text"
-                                    },
-                                    {
-                                        "key": "Content-Type",
-                                        "value": "application/json",
-                                        "type": "text"
-                                    }
-                                ],
-                                "description": "Ruta Laravel: `POST /api/tenants`\n\nControlador: `App\\Domains\\Tenant\\Controllers\\TenantController@store`",
-                                "url": {
-                                    "raw": "{{base_url}}/api/tenants",
-                                    "host": [
-                                        "{{base_url}}"
-                                    ],
-                                    "path": [
-                                        "api",
-                                        "tenants"
-                                    ]
-                                },
-                                "body": {
-                                    "mode": "raw",
-                                    "raw": "{\n    \"client_id\": {{client_id}},\n    \"codigo\": \"{{tenant_code}}\",\n    \"nombre\": \"Tenant Demo\",\n    \"dominio\": \"{{tenant_domain}}\",\n    \"site_title\": \"ShopIt Demo\",\n    \"primary_color\": \"#111827\",\n    \"secondary_color\": \"#2563EB\",\n    \"danger_color\": \"#DC2626\",\n    \"success_color\": \"#16A34A\",\n    \"header_bg_color\": \"#FFFFFF\",\n    \"footer_bg_color\": \"#111827\",\n    \"header_logo\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\",\n    \"footer_logo\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\",\n    \"search_product_layout\": \"column_with_image\",\n    \"search_group_layout\": \"paginated\",\n    \"search_items_per_page\": 12,\n    \"display_categories\": true,\n    \"display_seach_bar\": true,\n    \"display_cart\": true,\n    \"cart_editing_policy\": \"full\",\n    \"admin_website_type_code\": \"shopit\",\n    \"storefront_website_type_code\": \"shopit\"\n}",
-                                    "options": {
-                                        "raw": {
-                                            "language": "json"
-                                        }
-                                    }
-                                }
-                            },
-                            "response": []
-                        },
                         {
                             "name": "Get Tenant",
                             "request": {
@@ -2535,86 +2496,6 @@
                             },
                             "response": []
                         },
-                        {
-                            "name": "Update Tenant (PUT)",
-                            "request": {
-                                "method": "PUT",
-                                "header": [
-                                    {
-                                        "key": "Accept",
-                                        "value": "application/json",
-                                        "type": "text"
-                                    },
-                                    {
-                                        "key": "Content-Type",
-                                        "value": "application/json",
-                                        "type": "text"
-                                    }
-                                ],
-                                "description": "Ruta Laravel: `PUT /api/tenants/{tenant}`\n\nControlador: `App\\Domains\\Tenant\\Controllers\\TenantController@update`",
-                                "url": {
-                                    "raw": "{{base_url}}/api/tenants/{{tenant_id}}",
-                                    "host": [
-                                        "{{base_url}}"
-                                    ],
-                                    "path": [
-                                        "api",
-                                        "tenants",
-                                        "{{tenant_id}}"
-                                    ]
-                                },
-                                "body": {
-                                    "mode": "raw",
-                                    "raw": "{\n    \"nombre\": \"Tenant Demo Actualizado\",\n    \"site_title\": \"ShopIt Demo\",\n    \"primary_color\": \"#111827\",\n    \"cart_editing_policy\": \"full\"\n}",
-                                    "options": {
-                                        "raw": {
-                                            "language": "json"
-                                        }
-                                    }
-                                }
-                            },
-                            "response": []
-                        },
-                        {
-                            "name": "Update Tenant (PATCH)",
-                            "request": {
-                                "method": "PATCH",
-                                "header": [
-                                    {
-                                        "key": "Accept",
-                                        "value": "application/json",
-                                        "type": "text"
-                                    },
-                                    {
-                                        "key": "Content-Type",
-                                        "value": "application/json",
-                                        "type": "text"
-                                    }
-                                ],
-                                "description": "Ruta Laravel: `PATCH /api/tenants/{tenant}`\n\nControlador: `App\\Domains\\Tenant\\Controllers\\TenantController@update`",
-                                "url": {
-                                    "raw": "{{base_url}}/api/tenants/{{tenant_id}}",
-                                    "host": [
-                                        "{{base_url}}"
-                                    ],
-                                    "path": [
-                                        "api",
-                                        "tenants",
-                                        "{{tenant_id}}"
-                                    ]
-                                },
-                                "body": {
-                                    "mode": "raw",
-                                    "raw": "{\n    \"nombre\": \"Tenant Demo Actualizado\",\n    \"site_title\": \"ShopIt Demo\",\n    \"primary_color\": \"#111827\",\n    \"cart_editing_policy\": \"full\"\n}",
-                                    "options": {
-                                        "raw": {
-                                            "language": "json"
-                                        }
-                                    }
-                                }
-                            },
-                            "response": []
-                        },
                         {
                             "name": "Delete Tenant",
                             "request": {

app/Domains/Commerce/Catalog/Enums/InventoryMovementOperation.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Domains\Commerce\Catalog\Enums;
+
+enum InventoryMovementOperation: string
+{
+    case StockInitialized = 'stock_initialized';
+    case StockIncreased = 'stock_increased';
+    case StockDecreased = 'stock_decreased';
+    case StockReserved = 'stock_reserved';
+    case StockReleased = 'stock_released';
+    case PurchaseCommitted = 'purchase_committed';
+    case StockRefunded = 'stock_refunded';
+    case EntryStockReserved = 'entry_stock_reserved';
+    case EntryStockReleased = 'entry_stock_released';
+    case InventoryReset = 'inventory_reset';
+    case InventoryTransferred = 'inventory_transferred';
+}

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

@@ -2,7 +2,6 @@
 
 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;
@@ -10,6 +9,7 @@ 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\Ticket;
+use App\Shared\Attachable\Models\Attachment;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -19,6 +19,7 @@ use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\Schema;
 
 #[Fillable([
     'tenant_code',
@@ -213,10 +214,14 @@ class CatalogItem extends Model
     /** @param Builder<CatalogItem> $query */
     public function scopeWhereAvailable(Builder $query): Builder
     {
+        $availableInventory = static fn (Builder $inventoryQuery): Builder => Schema::hasColumn('inventories', 'available_stock')
+            ? $inventoryQuery->where('inventories.available_stock', '>', 0)
+            : $inventoryQuery->whereRaw('inventories.real_stock > inventories.reserved_stock + inventories.entry_reserved_stock');
+
         return $query->where(function (Builder $query): void {
             $query->whereNull('catalog_items.sales_end_at')
                 ->orWhere('catalog_items.sales_end_at', '>', now());
-        })->where(function (Builder $query): void {
+        })->where(function (Builder $query) use ($availableInventory): void {
             $query
                 ->where(function (Builder $unlimitedQuery): void {
                     $unlimitedQuery
@@ -236,20 +241,18 @@ class CatalogItem extends Model
                         ->whereNull('replaced_by_variant_id')
                         ->whereHas(
                             'inventory',
-                            fn (Builder $inventoryQuery): Builder => $inventoryQuery
+                            $availableInventory
-                                ->whereColumn('inventories.real_stock', '>', 'inventories.reserved_stock')
                         )
                 )
-                ->orWhere(function (Builder $directItemQuery): void {
+                ->orWhere(function (Builder $directItemQuery) use ($availableInventory): void {
                     $directItemQuery
                         ->whereDoesntHave('variants')
-                        ->where(function (Builder $inventoryQuery): void {
+                        ->where(function (Builder $inventoryQuery) use ($availableInventory): void {
                             $inventoryQuery
                                 ->whereNull('catalog_items.inventory_id')
                                 ->orWhereHas(
                                     'inventory',
-                                    fn (Builder $availableInventoryQuery): Builder => $availableInventoryQuery
+                                    $availableInventory
-                                        ->whereColumn('inventories.real_stock', '>', 'inventories.reserved_stock')
                                 );
                         });
                 });
@@ -264,9 +267,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('desfileEntryReservations');
+
         return $this->variants
             ->each(fn (Variant $variant) => $variant->setRelation('catalogItem', $this))
             ->filter(fn (Variant $variant): bool => $variant->hasOnlyActiveEventDates()
+                && (! $variant->relationLoaded('desfileEntryReservations')
+                    || $variant->desfileEntryReservations->isEmpty())
                 && (($includedVariantId !== null && $variant->id === $includedVariantId)
                     || ($variant->isSellable() && (
                         $this->inventory_policy === InventoryPolicy::Unlimited

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

@@ -2,16 +2,23 @@
 
 namespace App\Domains\Commerce\Catalog\Models;
 
+use App\Domains\Commerce\Catalog\Enums\InventoryMovementOperation;
+use App\Domains\Core\Auth\Models\User;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\HasOne;
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Validation\ValidationException;
 
 #[Fillable([
     'sold_units',
     'refunded_units',
     'reserved_stock',
+    'entry_reserved_stock',
     'real_stock',
 ])]
 class Inventory extends Model
@@ -35,7 +42,9 @@ class Inventory extends Model
             'sold_units' => 'integer',
             'refunded_units' => 'integer',
             'reserved_stock' => 'integer',
+            'entry_reserved_stock' => 'integer',
             'real_stock' => 'integer',
+            'available_stock' => 'integer',
         ];
     }
 
@@ -57,51 +66,295 @@ class Inventory extends Model
         return $this->hasMany(StockReservationLine::class);
     }
 
+    /** @return HasMany<InventoryMovement, $this> */
+    public function movements(): HasMany
+    {
+        return $this->hasMany(InventoryMovement::class);
+    }
+
     public function availableStock(): int
     {
-        return max(0, $this->real_stock - $this->reserved_stock);
+        if (! array_key_exists('available_stock', $this->attributes)) {
+            return max(0, $this->real_stock - $this->reserved_stock - ($this->entry_reserved_stock ?? 0));
+        }
+
+        return (int) $this->getAttribute('available_stock');
+    }
+
+    public function reserveEntry(int $amount, bool $tracksInventory): void
+    {
+        $this->mutate(
+            InventoryMovementOperation::EntryStockReserved,
+            ['entry_reserved_stock' => $amount],
+            function (self $inventory) use ($amount, $tracksInventory): void {
+                if ($amount < 1 || ($tracksInventory && $inventory->availableStock() < $amount)) {
+                    throw new \InvalidArgumentException('No hay stock disponible para la reserva de entradas.');
+                }
+            },
+        );
+    }
+
+    public function releaseEntry(int $amount): void
+    {
+        $this->mutate(
+            InventoryMovementOperation::EntryStockReleased,
+            ['entry_reserved_stock' => -$amount],
+            function (self $inventory) use ($amount): void {
+                if ($amount < 1 || $inventory->entry_reserved_stock < $amount) {
+                    throw new \InvalidArgumentException('La cantidad de entradas reservadas no es válida.');
+                }
+            },
+        );
     }
 
     public function reserve(int $amount, bool $tracksInventory): void
     {
+        $this->mutate(
+            InventoryMovementOperation::StockReserved,
+            ['reserved_stock' => $amount],
+            function (self $inventory) use ($amount, $tracksInventory): void {
                 if ($amount < 0) {
                     throw new \InvalidArgumentException('La cantidad a reservar debe ser positiva.');
                 }
-
+                if ($tracksInventory && $inventory->availableStock() < $amount) {
-        if ($tracksInventory && $this->availableStock() < $amount) {
                     throw new \InvalidArgumentException('No hay suficiente stock disponible para reservar.');
                 }
-
+            },
-        $this->reserved_stock += $amount;
+        );
-        $this->save();
     }
 
     public function release(int $amount): void
     {
-        if ($amount < 0 || $this->reserved_stock < $amount) {
+        $this->mutate(
+            InventoryMovementOperation::StockReleased,
+            ['reserved_stock' => -$amount],
+            function (self $inventory) use ($amount): void {
+                if ($amount < 0 || $inventory->reserved_stock < $amount) {
                     throw new \InvalidArgumentException('La cantidad reservada no es válida.');
                 }
-
+            },
-        $this->reserved_stock -= $amount;
+        );
-        $this->save();
     }
 
     public function buy(int $amount, bool $tracksInventory): void
     {
-        if ($amount < 0 || $this->reserved_stock < $amount) {
+        $counterDeltas = ['reserved_stock' => -$amount, 'sold_units' => $amount];
+        if (! array_key_exists('available_stock', $this->attributes) && $tracksInventory) {
+            $counterDeltas['real_stock'] = -$amount;
+        }
+
+        $this->mutate(
+            InventoryMovementOperation::PurchaseCommitted,
+            $counterDeltas,
+            function (self $inventory) use ($amount, $tracksInventory): void {
+                if ($amount < 0 || $inventory->reserved_stock < $amount) {
                     throw new \InvalidArgumentException('La cantidad reservada no alcanza para confirmar la compra.');
                 }
-
+                if ($tracksInventory && $inventory->availableStock() < 0) {
-        if ($tracksInventory && $this->real_stock < $amount) {
                     throw new \InvalidArgumentException('No hay suficiente stock real para confirmar la compra.');
                 }
-
+            },
-        if ($tracksInventory) {
+        );
-            $this->real_stock -= $amount;
     }
 
-        $this->reserved_stock -= $amount;
+    public function adjustAvailableStock(
-        $this->sold_units += $amount;
+        int $delta,
+        ?User $responsibleUser = null,
+        ?string $idempotencyKey = null,
+    ): void {
+        if ($delta === 0) {
+            return;
+        }
+
+        $operation = $delta > 0
+            ? InventoryMovementOperation::StockIncreased
+            : InventoryMovementOperation::StockDecreased;
+
+        $this->mutate(
+            $operation,
+            ['real_stock' => $delta],
+            function (self $inventory) use ($delta): void {
+                if ($inventory->real_stock + $delta < 0 || $inventory->availableStock() + $delta < 0) {
+                    throw ValidationException::withMessages([
+                        'stock_difference' => ['El ajuste dejaría el stock en un valor inválido.'],
+                    ]);
+                }
+            },
+            $responsibleUser,
+            $idempotencyKey,
+        );
+    }
+
+    public function refundStock(int $amount, ?User $responsibleUser = null): void
+    {
+        $counterDeltas = ['refunded_units' => $amount];
+        if (! array_key_exists('available_stock', $this->attributes)) {
+            $counterDeltas['real_stock'] = $amount;
+        }
+
+        $this->mutate(
+            InventoryMovementOperation::StockRefunded,
+            $counterDeltas,
+            function () use ($amount): void {
+                if ($amount < 1) {
+                    throw new \InvalidArgumentException('La cantidad devuelta debe ser positiva.');
+                }
+            },
+            $responsibleUser,
+        );
+    }
+
+    public function commitDirectSale(int $amount, bool $tracksInventory = true): void
+    {
+        $this->mutate(
+            InventoryMovementOperation::PurchaseCommitted,
+            ['sold_units' => $amount],
+            function (self $inventory) use ($amount, $tracksInventory): void {
+                if ($amount < 1 || ($tracksInventory && $inventory->availableStock() < $amount)) {
+                    throw new \InvalidArgumentException('No hay suficiente stock para confirmar la compra.');
+                }
+            },
+        );
+    }
+
+    public function recordInitialization(?User $responsibleUser = null): void
+    {
+        $this->recordCurrentState(InventoryMovementOperation::StockInitialized, $responsibleUser);
+    }
+
+    public function recordTransferInitialization(?User $responsibleUser = null): void
+    {
+        $this->recordCurrentState(InventoryMovementOperation::InventoryTransferred, $responsibleUser);
+    }
+
+    /** @param array<string, int> $counterDeltas */
+    public function transferCounters(array $counterDeltas, ?User $responsibleUser = null): void
+    {
+        $counterDeltas = array_filter($counterDeltas, fn (int $delta): bool => $delta !== 0);
+        if ($counterDeltas === []) {
+            return;
+        }
+
+        $this->mutate(
+            InventoryMovementOperation::InventoryTransferred,
+            $counterDeltas,
+            function (self $inventory) use ($counterDeltas): void {
+                foreach ($counterDeltas as $counter => $delta) {
+                    if ((int) $inventory->getAttribute($counter) + $delta < 0) {
+                        throw new \LogicException("El traslado dejaría {$counter} en un valor negativo.");
+                    }
+                }
+            },
+            $responsibleUser,
+        );
+    }
+
+    private function recordCurrentState(
+        InventoryMovementOperation $operation,
+        ?User $responsibleUser,
+    ): void {
+        if (! Schema::hasTable('inventory_movements')) {
+            return;
+        }
+
+        $this->refresh();
+        $counterDeltas = array_filter([
+            'real_stock' => $this->real_stock,
+            'sold_units' => $this->sold_units,
+            'reserved_stock' => $this->reserved_stock,
+            'entry_reserved_stock' => $this->entry_reserved_stock,
+            'refunded_units' => $this->refunded_units,
+        ], fn (int $delta): bool => $delta !== 0);
+
+        $this->movements()->create([
+            'operation' => $operation,
+            'available_stock_delta' => $this->availableStock(),
+            'available_stock_before' => 0,
+            'available_stock_after' => $this->availableStock(),
+            'counter_deltas' => $counterDeltas,
+            'responsible_user_id' => $responsibleUser?->getKey() ?? Auth::id(),
+        ]);
+    }
+
+    public function resetTransactionCounters(?User $responsibleUser = null): void
+    {
+        $this->refresh();
+        $counterDeltas = array_filter([
+            'sold_units' => -$this->sold_units,
+            'reserved_stock' => -$this->reserved_stock,
+            'entry_reserved_stock' => -$this->entry_reserved_stock,
+            'refunded_units' => -$this->refunded_units,
+        ], fn (int $delta): bool => $delta !== 0);
+
+        if ($counterDeltas === []) {
+            return;
+        }
+
+        $this->mutate(
+            InventoryMovementOperation::InventoryReset,
+            $counterDeltas,
+            static function (): void {},
+            $responsibleUser,
+        );
+    }
+
+    /**
+     * @param  array<string, int>  $counterDeltas
+     * @param  callable(self): void  $validate
+     */
+    private function mutate(
+        InventoryMovementOperation $operation,
+        array $counterDeltas,
+        callable $validate,
+        ?User $responsibleUser = null,
+        ?string $idempotencyKey = null,
+    ): void {
+        DB::transaction(function () use ($operation, $counterDeltas, $validate, $responsibleUser, $idempotencyKey): void {
+            /** @var self $inventory */
+            $inventory = self::query()->lockForUpdate()->findOrFail($this->getKey());
+            $this->setRawAttributes($inventory->getAttributes(), true);
+
+            $recordsMovements = Schema::hasTable('inventory_movements');
+            if ($recordsMovements && $idempotencyKey !== null) {
+                $existing = $this->movements()
+                    ->where('idempotency_key', $idempotencyKey)
+                    ->first();
+                if ($existing !== null) {
+                    if ($existing->counter_deltas !== $counterDeltas) {
+                        throw ValidationException::withMessages([
+                            'stock_adjustment_id' => ['La operación ya fue utilizada con otro ajuste.'],
+                        ]);
+                    }
+
+                    return;
+                }
+            }
+
+            $validate($this);
+            $counterDeltas = array_filter($counterDeltas, fn (int $delta): bool => $delta !== 0);
+            if ($counterDeltas === []) {
+                return;
+            }
+
+            $availableBefore = $this->availableStock();
+            foreach ($counterDeltas as $counter => $delta) {
+                $this->setAttribute($counter, (int) $this->getAttribute($counter) + $delta);
+            }
             $this->save();
+            $this->refresh();
+
+            $availableAfter = $this->availableStock();
+            if ($recordsMovements) {
+                $this->movements()->create([
+                    'operation' => $operation,
+                    'available_stock_delta' => $availableAfter - $availableBefore,
+                    'available_stock_before' => $availableBefore,
+                    'available_stock_after' => $availableAfter,
+                    'counter_deltas' => $counterDeltas,
+                    'responsible_user_id' => $responsibleUser?->getKey() ?? Auth::id(),
+                    'idempotency_key' => $idempotencyKey,
+                ]);
+            }
+        });
     }
 }

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

@@ -0,0 +1,45 @@
+<?php
+
+namespace App\Domains\Commerce\Catalog\Models;
+
+use App\Domains\Commerce\Catalog\Enums\InventoryMovementOperation;
+use App\Domains\Core\Auth\Models\User;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+#[Fillable([
+    'inventory_id',
+    'operation',
+    'available_stock_delta',
+    'available_stock_before',
+    'available_stock_after',
+    'counter_deltas',
+    'responsible_user_id',
+    'idempotency_key',
+])]
+class InventoryMovement extends Model
+{
+    protected function casts(): array
+    {
+        return [
+            'operation' => InventoryMovementOperation::class,
+            'available_stock_delta' => 'integer',
+            'available_stock_before' => 'integer',
+            'available_stock_after' => 'integer',
+            'counter_deltas' => 'array',
+        ];
+    }
+
+    /** @return BelongsTo<Inventory, $this> */
+    public function inventory(): BelongsTo
+    {
+        return $this->belongsTo(Inventory::class);
+    }
+
+    /** @return BelongsTo<User, $this> */
+    public function responsibleUser(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'responsible_user_id');
+    }
+}

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\Desfile\Models\EntryReservation;
 use App\Domains\Ticketing\Event\Models\EventDate;
 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 desfileEntryReservations(): HasMany
+    {
+        return $this->hasMany(EntryReservation::class);
+    }
+
     /** @return BelongsTo<Inventory, $this> */
     public function inventory(): BelongsTo
     {

app/Domains/Commerce/Catalog/Resources/CatalogItemDetailResource.php

@@ -7,8 +7,8 @@ use App\Domains\Commerce\Catalog\Models\CatalogItem;
 use App\Domains\Commerce\Catalog\Models\ItemAttribute;
 use App\Domains\Commerce\Catalog\Models\Variant;
 use App\Domains\Commerce\Catalog\Services\CatalogItemAllowanceService;
-use App\Shared\Enums\FieldType;
 use App\Domains\Ticketing\Ticket\Resources\ValidityTimeResource;
+use App\Shared\Enums\FieldType;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
 use Illuminate\Support\Collection;
@@ -140,7 +140,7 @@ class CatalogItemDetailResource extends JsonResource
                 'validity_time_id' => $option->validity_time_id,
                 'validity_time' => $option->validityTime === null
                     ? null
-                    : ValidityTimeResource::make($option->validityTime),
+                    : ValidityTimeResource::make($option->validityTime, $this->tenant->timezone),
                 'metadata' => $option->metadata,
             ])
             ->values();

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

@@ -64,6 +64,7 @@ class CatalogInventoryService
             $selection->loadMissing('variants.inventory');
 
             return $selection->variants
+                ->each(fn (Variant $variant) => $variant->setRelation('catalogItem', $selection))
                 ->filter(fn (Variant $variant): bool => $variant->isSellable())
                 ->unique(fn (Variant $variant): string => $variant->inventory_id === null
                     ? 'object:'.spl_object_id($variant->inventory)
@@ -153,7 +154,7 @@ class CatalogInventoryService
 
                 if ($operation === 'commit'
                     && $requirement['tracks_inventory']
-                    && $inventory->real_stock < $requiredQuantity) {
+                    && $inventory->availableStock() < 0) {
                     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 {
@@ -340,9 +370,12 @@ class CatalogService
 
     private function createInventory(int $realStock): Inventory
     {
-        return Inventory::query()->create([
+        $inventory = Inventory::query()->create([
             'real_stock' => $realStock,
         ]);
+        $inventory->recordInitialization();
+
+        return $inventory;
     }
 
     /**

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->availableStock() < 0)) {
                     throw new \InvalidArgumentException('La reserva de stock no alcanza para confirmar la compra.');
                 }
             }

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

@@ -7,6 +7,7 @@ use App\Domains\Commerce\Catalog\Models\Inventory;
 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\Desfile\Models\EntryReservation;
 use App\Domains\Ticketing\Event\Models\EventDate;
 use Illuminate\Support\Collection;
 
@@ -190,15 +191,22 @@ 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,
         ]);
+        $replacementInventory->recordTransferInitialization();
 
         if ($activeLines->isNotEmpty()) {
             StockReservationLine::query()
                 ->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->transferCounters([
+            'reserved_stock' => -$sourceInventory->reserved_stock,
+            'entry_reserved_stock' => -$sourceInventory->entry_reserved_stock,
+        ]);
 
         return $replacementInventory;
     }
@@ -232,23 +240,25 @@ class VariantReplacementService
             throw new \LogicException('El inventario reservado de la variante es inconsistente.');
         }
 
-        $destinationInventory->update([
+        $transferredCounters = [
-            'real_stock' => $destinationInventory->real_stock + $sourceInventory->real_stock,
+            'real_stock' => $sourceInventory->real_stock,
-            'reserved_stock' => $destinationInventory->reserved_stock + $sourceInventory->reserved_stock,
+            'reserved_stock' => $sourceInventory->reserved_stock,
-            'sold_units' => $destinationInventory->sold_units + $sourceInventory->sold_units,
+            'entry_reserved_stock' => $sourceInventory->entry_reserved_stock,
-            'refunded_units' => $destinationInventory->refunded_units + $sourceInventory->refunded_units,
+            'sold_units' => $sourceInventory->sold_units,
-        ]);
+            'refunded_units' => $sourceInventory->refunded_units,
+        ];
+        $destinationInventory->transferCounters($transferredCounters);
         if ($activeLines->isNotEmpty()) {
             StockReservationLine::query()
                 ->whereKey($activeLines->modelKeys())
                 ->update(['inventory_id' => $destinationInventory->getKey()]);
         }
-        $sourceInventory->update([
+        EntryReservation::query()->where('inventory_id', $sourceInventory->id)
-            'real_stock' => 0,
+            ->update(['inventory_id' => $destinationInventory->id]);
-            'reserved_stock' => 0,
+        $sourceInventory->transferCounters(array_map(
-            'sold_units' => 0,
+            fn (int $value): int => -$value,
-            'refunded_units' => 0,
+            $transferredCounters,
-        ]);
+        ));
     }
 
     /** @return list<string> */

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/TenantTransactionResetService.php

@@ -2,6 +2,7 @@
 
 namespace App\Domains\Commerce\Purchase\Services;
 
+use App\Domains\Commerce\Catalog\Models\Inventory;
 use App\Domains\Commerce\Purchase\Models\Purchase;
 use Illuminate\Database\Query\Builder;
 use Illuminate\Support\Collection;
@@ -25,6 +26,9 @@ 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('desfile_entry_reservations')
+                ->whereIn('variant_id', DB::table('variantes')->whereIn('catalog_item_id',
+                    DB::table('catalog_items')->where('tenant_code', $tenantCode)->select('id'))->select('id'))->count(),
             'stock_reservations' => $this->reservationQuery($scope)->count(),
             'purchase_changes' => DB::table('value_changes')
                 ->where('tenant_code', $tenantCode)
@@ -47,6 +51,10 @@ 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('desfile_entry_reservations')
+                    ->whereIn('variant_id', DB::table('variantes')->whereIn('catalog_item_id',
+                        DB::table('catalog_items')->where('tenant_code', $tenantCode)->select('id'))->select('id'))->delete(),
+                'entry_reservation_batches_deleted' => DB::table('desfile_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)
@@ -62,14 +70,12 @@ class TenantTransactionResetService
                 'users_preserved' => DB::table('users')->where('tenant_codigo', $tenantCode)->count(),
             ];
 
-            DB::table('inventories')
+            Inventory::query()
-                ->whereIn('id', $scope['inventory_ids'])
+                ->whereKey($scope['inventory_ids'])
-                ->update([
+                ->orderBy('id')
-                    'real_stock' => DB::raw('real_stock + sold_units - refunded_units'),
+                ->lockForUpdate()
-                    'reserved_stock' => 0,
+                ->get()
-                    'sold_units' => 0,
+                ->each(fn (Inventory $inventory) => $inventory->resetTransactionCounters());
-                    'refunded_units' => 0,
-                ]);
 
             return $summary;
         });

app/Domains/Core/Address/Models/Address.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Domains\Core\Address\Models;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Event\Models\Event;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class Address extends Model
+{
+    protected $fillable = ['label', 'address_text', 'latitude', 'longitude'];
+
+    protected function casts(): array
+    {
+        return [
+            'latitude' => 'decimal:7',
+            'longitude' => 'decimal:7',
+        ];
+    }
+
+    /** @return array{latitude: float, longitude: float}|null */
+    public function coordinates(): ?array
+    {
+        if ($this->latitude === null || $this->longitude === null) {
+            return null;
+        }
+
+        return ['latitude' => (float) $this->latitude, 'longitude' => (float) $this->longitude];
+    }
+
+    /** @return HasMany<Event, $this> */
+    public function events(): HasMany
+    {
+        return $this->hasMany(Event::class);
+    }
+
+    /** @return BelongsToMany<Tenant, $this> */
+    public function tenants(): BelongsToMany
+    {
+        return $this->belongsToMany(Tenant::class, 'tenant_addresses', 'address_id', 'tenant_codigo', 'id', 'codigo')
+            ->using(TenantAddress::class)
+            ->withPivot(['id', 'is_main'])
+            ->withTimestamps();
+    }
+}

app/Domains/Core/Address/Models/TenantAddress.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Domains\Core\Address\Models;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\Pivot;
+
+class TenantAddress extends Pivot
+{
+    protected $table = 'tenant_addresses';
+
+    public $incrementing = true;
+
+    protected $fillable = ['tenant_codigo', 'address_id', 'is_main'];
+
+    protected function casts(): array
+    {
+        return ['is_main' => 'boolean'];
+    }
+
+    /** @return BelongsTo<Tenant, $this> */
+    public function tenant(): BelongsTo
+    {
+        return $this->belongsTo(Tenant::class, 'tenant_codigo', 'codigo');
+    }
+
+    /** @return BelongsTo<Address, $this> */
+    public function address(): BelongsTo
+    {
+        return $this->belongsTo(Address::class);
+    }
+}

app/Domains/Core/Address/Resources/AddressResource.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Domains\Core\Address\Resources;
+
+use App\Domains\Core\Address\Models\Address;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+/** @mixin Address */
+class AddressResource extends JsonResource
+{
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'label' => $this->label,
+            'address_text' => $this->address_text,
+            'latitude' => $this->latitude === null ? null : (float) $this->latitude,
+            'longitude' => $this->longitude === null ? null : (float) $this->longitude,
+        ];
+    }
+}

app/Domains/Core/Bootstrap/Services/TenantBootstrapService.php

@@ -33,7 +33,11 @@ class TenantBootstrapService
             $tenant,
             [
                 'eventDateChanges',
-                'menues' => fn ($query) => $query->whereHas(
+                'menues' => fn ($query) => $query
+                    ->where(fn ($query) => $query
+                        ->where('menues.code', 'help.contact')
+                        ->orWhere('tenants_menues.is_enabled', true))
+                    ->whereHas(
                         'roles',
                         fn ($query) => $query->where('codigo', RoleCode::User->value)
                     ),

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/Menu/Models/Menu.php

@@ -76,7 +76,7 @@ class Menu extends Model
             'codigo'
         )
             ->using(TenantMenu::class)
-            ->withPivot('static_content')
+            ->withPivot('static_content', 'is_enabled')
             ->withTimestamps();
     }
 

app/Domains/Core/Menu/Models/TenantMenu.php

@@ -16,12 +16,14 @@ class TenantMenu extends Pivot
         'tenant_code',
         'menu_code',
         'static_content',
+        'is_enabled',
     ];
 
     protected function casts(): array
     {
         return [
             'static_content' => 'array',
+            'is_enabled' => 'boolean',
         ];
     }
 

app/Domains/Core/Tenant/Controllers/AdminApp/BrandController.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Domains\Core\Tenant\Controllers\AdminApp;
+
+use App\Domains\Core\Tenant\Requests\AdminApp\UpdateBrandRequest;
+use App\Domains\Core\Tenant\Resources\AdminApp\BrandResource;
+use App\Domains\Core\Tenant\Services\BrandService;
+use App\Domains\Core\Tenant\Services\TenantInformationService;
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+
+class BrandController extends Controller
+{
+    public function show(Request $request, TenantInformationService $tenantInformationService): BrandResource
+    {
+        $tenant = $request->user()->tenant()->firstOrFail();
+
+        return BrandResource::make($tenantInformationService->load($tenant));
+    }
+
+    public function update(
+        UpdateBrandRequest $request,
+        BrandService $brandService,
+        TenantInformationService $tenantInformationService,
+    ): BrandResource {
+        $tenant = $request->user()->tenant()->firstOrFail();
+        $brandService->update($tenant, $request->validated());
+
+        return BrandResource::make($tenantInformationService->load($tenant->fresh()));
+    }
+}

app/Domains/Core/Tenant/Controllers/AdminApp/HelpMenuController.php

@@ -0,0 +1,90 @@
+<?php
+
+namespace App\Domains\Core\Tenant\Controllers\AdminApp;
+
+use App\Domains\Core\Tenant\Requests\AdminApp\UpdateHelpMenuContentRequest;
+use App\Http\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class HelpMenuController extends Controller
+{
+    private const MENU_CODES = [
+        'help.faq',
+        'help.terms-and-conditions',
+    ];
+
+    public function index(Request $request): JsonResponse
+    {
+        $tenant = $request->user()->tenant()->firstOrFail();
+        $menus = $tenant->menues()
+            ->whereIn('menues.code', self::MENU_CODES)
+            ->get()
+            ->keyBy('code');
+
+        return response()->json([
+            'data' => collect(self::MENU_CODES)->mapWithKeys(
+                fn (string $code): array => [$code => [
+                    'code' => $code,
+                    'is_enabled' => (bool) ($menus->get($code)?->pivot?->is_enabled ?? false),
+                    'static_content' => $menus->get($code)?->pivot?->static_content
+                        ?? $this->emptyContent($code),
+                ]]
+            ),
+        ]);
+    }
+
+    public function toggle(
+        Request $request,
+        string $menuCode,
+    ): JsonResponse {
+        abort_unless(in_array($menuCode, self::MENU_CODES, true), 404);
+
+        $tenant = $request->user()->tenant()->firstOrFail();
+        $tenantMenu = $tenant->menues()
+            ->where('menues.code', $menuCode)
+            ->firstOrFail();
+        $isEnabled = ! $tenantMenu->pivot->is_enabled;
+
+        $tenant->menues()->updateExistingPivot($menuCode, [
+            'is_enabled' => $isEnabled,
+        ]);
+
+        return response()->json([
+            'data' => [
+                'code' => $tenantMenu->code,
+                'is_enabled' => $isEnabled,
+            ],
+        ]);
+    }
+
+    public function updateContent(
+        UpdateHelpMenuContentRequest $request,
+        string $menuCode,
+    ): JsonResponse {
+        abort_unless(in_array($menuCode, self::MENU_CODES, true), 404);
+
+        $tenant = $request->user()->tenant()->firstOrFail();
+        $tenantMenu = $tenant->menues()
+            ->where('menues.code', $menuCode)
+            ->firstOrFail();
+        $staticContent = $request->validated('static_content');
+
+        $tenant->menues()->updateExistingPivot($menuCode, [
+            'static_content' => $staticContent,
+        ]);
+
+        return response()->json([
+            'data' => [
+                'code' => $tenantMenu->code,
+                'is_enabled' => (bool) $tenantMenu->pivot->is_enabled,
+                'static_content' => $staticContent,
+            ],
+        ]);
+    }
+
+    private function emptyContent(string $menuCode): array
+    {
+        return $menuCode === 'help.faq' ? [] : ['html' => ''];
+    }
+}

app/Domains/Core/Tenant/Controllers/TenantController.php

@@ -3,11 +3,8 @@
 namespace App\Domains\Core\Tenant\Controllers;
 
 use App\Domains\Core\Tenant\Models\Tenant;
-use App\Domains\Core\Tenant\Requests\StoreTenantRequest;
-use App\Domains\Core\Tenant\Requests\UpdateTenantRequest;
 use App\Domains\Core\Tenant\Resources\TenantResource;
 use App\Domains\Core\Tenant\Services\TenantInformationService;
-use App\Domains\Core\Tenant\Services\TenantService;
 use App\Http\Controllers\Controller;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Response;
@@ -15,7 +12,6 @@ use Illuminate\Http\Response;
 class TenantController extends Controller
 {
     public function __construct(
-        protected TenantService $tenantService,
         protected TenantInformationService $tenantInformationService,
     ) {}
 
@@ -30,15 +26,6 @@ class TenantController extends Controller
         return TenantResource::collection($tenants)->response();
     }
 
-    public function store(StoreTenantRequest $request): JsonResponse
-    {
-        $tenant = $this->tenantService->create($request->validated());
-
-        return TenantResource::make(
-            $this->tenantInformationService->load($tenant)
-        )->response()->setStatusCode(201);
-    }
-
     public function show(Tenant $tenant): TenantResource
     {
         return TenantResource::make(
@@ -46,15 +33,6 @@ class TenantController extends Controller
         );
     }
 
-    public function update(UpdateTenantRequest $request, Tenant $tenant): TenantResource
-    {
-        $tenant = $this->tenantService->update($tenant, $request->validated());
-
-        return TenantResource::make(
-            $this->tenantInformationService->load($tenant)
-        );
-    }
-
     public function destroy(Tenant $tenant): Response
     {
         $tenant->delete();

app/Domains/Core/Tenant/Models/Tenant.php

@@ -2,32 +2,36 @@
 
 namespace App\Domains\Core\Tenant\Models;
 
-use App\Shared\Attachable\Models\Attachment;
 use App\Domains\Commerce\Catalog\Enums\GroupLayout;
 use App\Domains\Commerce\Catalog\Enums\ProductLayout;
 use App\Domains\Commerce\Catalog\Models\CatalogItem;
 use App\Domains\Commerce\Catalog\Models\Category;
+use App\Domains\Core\Address\Models\Address;
+use App\Domains\Core\Address\Models\TenantAddress;
 use App\Domains\Core\Client\Models\Client;
-use App\Domains\Ticketing\Event\Models\EventDate;
-use App\Domains\Ticketing\Event\Models\EventDateChange;
-use App\Domains\Ticketing\Event\Models\Event;
-use App\Domains\Ticketing\Event\Models\EventCategory;
 use App\Domains\Core\Menu\Models\Menu;
 use App\Domains\Core\Menu\Models\TenantMenu;
 use App\Domains\Core\Tenant\Enums\CartEditingPolicy;
+use App\Domains\Ticketing\Event\Models\Event;
+use App\Domains\Ticketing\Event\Models\EventCategory;
+use App\Domains\Ticketing\Event\Models\EventDate;
+use App\Domains\Ticketing\Event\Models\EventDateChange;
 use App\Domains\Ticketing\Ticket\Models\ScanAttempt;
+use App\Shared\Attachable\Models\Attachment;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\HasOneThrough;
 use Illuminate\Support\Facades\Schema;
 
 #[Fillable([
     'client_id',
     'codigo',
     'nombre',
+    'timezone',
     'dominio',
     'base_path',
     'site_title',
@@ -66,7 +70,10 @@ class Tenant extends Model
 {
     use HasFactory;
 
+    public const DEFAULT_TIMEZONE = 'America/Argentina/Buenos_Aires';
+
     protected $attributes = [
+        'timezone' => self::DEFAULT_TIMEZONE,
         'base_path' => '/',
         'search_product_layout' => ProductLayout::ColumnWithImage->value,
         'search_group_layout' => GroupLayout::Paginated->value,
@@ -304,6 +311,23 @@ class Tenant extends Model
         return $this->hasMany(WebsiteExtra::class, 'website_code', 'codigo');
     }
 
+    /** @return BelongsToMany<Address, $this> */
+    public function addresses(): BelongsToMany
+    {
+        return $this->belongsToMany(Address::class, 'tenant_addresses', 'tenant_codigo', 'address_id', 'codigo', 'id')
+            ->using(TenantAddress::class)
+            ->withPivot(['id', 'is_main'])
+            ->withTimestamps()
+            ->orderByPivot('id');
+    }
+
+    /** @return HasOneThrough<Address, TenantAddress, $this> */
+    public function mainAddress(): HasOneThrough
+    {
+        return $this->hasOneThrough(Address::class, TenantAddress::class, 'tenant_codigo', 'id', 'codigo', 'address_id')
+            ->where('tenant_addresses.is_main', true);
+    }
+
     public function menues(): BelongsToMany
     {
         return $this->belongsToMany(
@@ -315,7 +339,7 @@ class Tenant extends Model
             'code'
         )
             ->using(TenantMenu::class)
-            ->withPivot('static_content')
+            ->withPivot('static_content', 'is_enabled')
             ->withTimestamps();
     }
 }

app/Domains/Core/Tenant/Requests/AdminApp/UpdateBrandRequest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Domains\Core\Tenant\Requests\AdminApp;
+
+use App\Shared\Rules\CroppedImageOrBase64Rule;
+use App\Shared\Rules\ImageOrBase64Rule;
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateBrandRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /** @return array<string, mixed> */
+    public function rules(): array
+    {
+        $shopit = $this->user()->tenant()->firstOrFail()->storefront_website_type_code === 'shopit';
+
+        return [
+            'nombre' => ['required', 'string', 'max:255'],
+            'primary_color' => ['required', 'regex:/^#[0-9a-fA-F]{6}$/'],
+            'footer_bg_color' => ['required', 'regex:/^#[0-9a-fA-F]{6}$/'],
+            'header_logo' => ['present', 'nullable', new ImageOrBase64Rule],
+            'footer_logo' => ['present', 'nullable', new ImageOrBase64Rule],
+            'banner_images' => [$shopit ? 'present' : 'prohibited', 'array', 'max:10'],
+            'banner_images.*' => ['required', new CroppedImageOrBase64Rule],
+        ];
+    }
+}

app/Domains/Core/Tenant/Requests/AdminApp/UpdateHelpMenuContentRequest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Domains\Core\Tenant\Requests\AdminApp;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateHelpMenuContentRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /** @return array<string, mixed> */
+    public function rules(): array
+    {
+        return match ($this->route('menuCode')) {
+            'help.faq' => [
+                'static_content' => ['required', 'array'],
+                'static_content.*.pregunta' => ['required', 'string'],
+                'static_content.*.respuesta' => ['required', 'string'],
+                'static_content.*.is_active' => ['required', 'boolean'],
+            ],
+            'help.terms-and-conditions' => [
+                'static_content' => ['required', 'array'],
+                'static_content.html' => ['present', 'nullable', 'string'],
+            ],
+            default => [],
+        };
+    }
+}

app/Domains/Core/Tenant/Requests/StoreTenantRequest.php

@@ -1,139 +0,0 @@
-<?php
-
-namespace App\Domains\Core\Tenant\Requests;
-
-use App\Domains\Commerce\Catalog\Enums\GroupLayout;
-use App\Domains\Commerce\Catalog\Enums\ProductLayout;
-use App\Shared\Rules\ImageOrBase64Rule;
-use App\Domains\Core\Tenant\Enums\CartEditingPolicy;
-use App\Domains\Core\Tenant\Services\WebsiteExtraService;
-use App\Domains\Core\Tenant\Support\TenantDomainNormalizer;
-use Closure;
-use Illuminate\Foundation\Http\FormRequest;
-use Illuminate\Validation\Rule;
-
-class StoreTenantRequest extends FormRequest
-{
-    protected bool $hasInvalidDomain = false;
-
-    protected bool $hasInvalidBasePath = false;
-
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    protected function prepareForValidation(): void
-    {
-        $rawDomain = $this->input('dominio');
-        $hasExplicitBasePath = $this->has('base_path');
-        $rawBasePath = $hasExplicitBasePath
-            ? $this->input('base_path')
-            : TenantDomainNormalizer::pathFromDomain($rawDomain);
-        $normalizedDomain = TenantDomainNormalizer::normalize($rawDomain);
-        $normalizedBasePath = TenantDomainNormalizer::normalizePath($rawBasePath);
-
-        $this->hasInvalidDomain = TenantDomainNormalizer::hasValue($rawDomain)
-            && $normalizedDomain === null;
-        $this->hasInvalidBasePath = ($hasExplicitBasePath && ! is_string($rawBasePath))
-            || $normalizedBasePath === null;
-
-        $this->merge([
-            'dominio' => $normalizedDomain,
-            'base_path' => $normalizedBasePath,
-        ]);
-    }
-
-    /**
-     * @return array<string, mixed>
-     */
-    public function rules(): array
-    {
-        $logoRule = ['required', new ImageOrBase64Rule];
-
-        return array_merge([
-            'client_id' => ['sometimes', 'integer', Rule::exists('clients', 'id')],
-            'codigo' => ['required', 'string', 'max:255', Rule::unique('tenants', 'codigo')],
-            'nombre' => ['required', 'string', 'max:255'],
-            'dominio' => [
-                'bail',
-                function (string $attribute, mixed $value, Closure $fail): void {
-                    if ($this->hasInvalidDomain) {
-                        $fail("The {$attribute} field must contain a valid domain or URL.");
-                    }
-                },
-                'required',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'dominio')
-                    ->where('base_path', $this->input('base_path')),
-            ],
-            'base_path' => [
-                'bail',
-                function (string $attribute, mixed $value, Closure $fail): void {
-                    if ($this->hasInvalidBasePath) {
-                        $fail("The {$attribute} field must contain a valid URL path.");
-                    }
-                },
-                'required',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'base_path')
-                    ->where('dominio', $this->input('dominio')),
-            ],
-            'site_title' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'address' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'phone' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'primary_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'secondary_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'danger_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'success_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'header_bg_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'footer_bg_color' => ['required', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'header_logo' => $logoRule,
-            'footer_logo' => $logoRule,
-            'favicon' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'header_bg_image' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'footer_bg_image' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'social_media' => ['sometimes', 'array'],
-            'social_media.*.code' => [
-                'required',
-                'string',
-                'distinct',
-                Rule::exists('social_media', 'code'),
-            ],
-            'social_media.*.url' => ['required', 'url', 'max:2048'],
-            'social_media.*.orden' => ['sometimes', 'integer', 'min:0', 'distinct'],
-            'search_product_layout' => ['sometimes', Rule::enum(ProductLayout::class)],
-            'search_group_layout' => ['sometimes', Rule::enum(GroupLayout::class)],
-            'search_items_per_page' => ['sometimes', 'integer', 'min:4', 'max:48'],
-            'display_categories' => ['sometimes', 'boolean'],
-            'display_seach_bar' => ['sometimes', 'boolean'],
-            'display_cart' => ['sometimes', 'boolean'],
-            'cart_editing_policy' => ['sometimes', Rule::enum(CartEditingPolicy::class)],
-            'checkout_editing_policy' => [
-                'sometimes',
-                Rule::in([CartEditingPolicy::Disabled->value]),
-            ],
-            'display_cart_item_images' => ['sometimes', 'boolean'],
-            'scanner_category_validation_enabled' => ['sometimes', 'boolean'],
-            'allow_ticket_refund' => ['sometimes', 'boolean'],
-            'allow_ticket_total_refund' => ['sometimes', 'boolean'],
-            'allow_ticket_partial_refund' => ['sometimes', 'boolean'],
-            'ticket_partial_refund_percentage' => [
-                'sometimes',
-                'numeric',
-                'decimal:0,2',
-                'min:0',
-                'max:99.99',
-            ],
-            'storefront_website_type_code' => [
-                'required_with:extras',
-                'sometimes',
-                'string',
-                Rule::exists('storefront_website_types', 'codigo'),
-            ],
-            'admin_website_type_code' => ['sometimes', 'nullable', 'string', Rule::exists('admin_website_types', 'codigo')],
-        ], app(WebsiteExtraService::class)->requestRules($this->input('storefront_website_type_code')));
-    }
-}

app/Domains/Core/Tenant/Requests/UpdateTenantRequest.php

@@ -1,165 +0,0 @@
-<?php
-
-namespace App\Domains\Core\Tenant\Requests;
-
-use App\Domains\Commerce\Catalog\Enums\GroupLayout;
-use App\Domains\Commerce\Catalog\Enums\ProductLayout;
-use App\Shared\Rules\ImageOrBase64Rule;
-use App\Domains\Core\Tenant\Enums\CartEditingPolicy;
-use App\Domains\Core\Tenant\Models\Tenant;
-use App\Domains\Core\Tenant\Support\TenantDomainNormalizer;
-use Closure;
-use Illuminate\Foundation\Http\FormRequest;
-use Illuminate\Validation\Rule;
-
-class UpdateTenantRequest extends FormRequest
-{
-    protected bool $hasInvalidDomain = false;
-
-    protected bool $hasInvalidBasePath = false;
-
-    public function authorize(): bool
-    {
-        return true;
-    }
-
-    protected function prepareForValidation(): void
-    {
-        if ($this->has('dominio')) {
-            $rawDomain = $this->input('dominio');
-            $normalizedDomain = TenantDomainNormalizer::normalize($rawDomain);
-            $embeddedBasePath = TenantDomainNormalizer::pathFromDomain($rawDomain);
-
-            $this->hasInvalidDomain = TenantDomainNormalizer::hasValue($rawDomain)
-                && ($normalizedDomain === null || $embeddedBasePath === null);
-
-            $this->merge([
-                'dominio' => $normalizedDomain,
-            ]);
-
-            if (! $this->has('base_path') && $embeddedBasePath !== null && $embeddedBasePath !== '/') {
-                $this->merge(['base_path' => $embeddedBasePath]);
-            }
-        }
-
-        if ($this->has('base_path')) {
-            $rawBasePath = $this->input('base_path');
-            $normalizedBasePath = TenantDomainNormalizer::normalizePath($rawBasePath);
-
-            $this->hasInvalidBasePath = ! is_string($rawBasePath)
-                || $normalizedBasePath === null;
-
-            $this->merge(['base_path' => $normalizedBasePath]);
-        }
-    }
-
-    /**
-     * @return array<string, mixed>
-     */
-    public function rules(): array
-    {
-        /** @var Tenant|null $tenant */
-        $tenant = $this->route('tenant');
-        $domain = $this->input('dominio', $tenant?->dominio);
-        $basePath = $this->input('base_path', $tenant?->base_path ?? '/');
-
-        $logoRule = ['nullable', new ImageOrBase64Rule];
-
-        return [
-            'client_id' => ['sometimes', 'integer', Rule::exists('clients', 'id')],
-            'codigo' => [
-                'nullable',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'codigo')->ignore($tenant?->id),
-            ],
-            'nombre' => ['nullable', 'string', 'max:255'],
-            'dominio' => [
-                'bail',
-                function (string $attribute, mixed $value, Closure $fail): void {
-                    if ($this->hasInvalidDomain) {
-                        $fail("The {$attribute} field must contain a valid domain or URL.");
-                    }
-                },
-                'nullable',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'dominio')
-                    ->where('base_path', $basePath)
-                    ->ignore($tenant?->id),
-            ],
-            'base_path' => [
-                'bail',
-                function (string $attribute, mixed $value, Closure $fail): void {
-                    if ($this->hasInvalidBasePath) {
-                        $fail("The {$attribute} field must contain a valid URL path.");
-                    }
-                },
-                'nullable',
-                'string',
-                'max:255',
-                Rule::unique('tenants', 'base_path')
-                    ->where('dominio', $domain)
-                    ->ignore($tenant?->id),
-            ],
-            'site_title' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'address' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'phone' => ['sometimes', 'nullable', 'string', 'max:255'],
-            'primary_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'secondary_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'danger_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'success_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'header_bg_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'footer_bg_color' => ['nullable', 'string', 'regex:/^#([a-fA-F0-9]{3,4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/'],
-            'header_logo' => $logoRule,
-            'footer_logo' => $logoRule,
-            'favicon' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'header_bg_image' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'footer_bg_image' => ['sometimes', 'nullable', new ImageOrBase64Rule],
-            'social_media' => ['sometimes', 'array'],
-            'social_media.*.code' => [
-                'required',
-                'string',
-                'distinct',
-                Rule::exists('social_media', 'code'),
-            ],
-            'social_media.*.url' => ['required', 'url', 'max:2048'],
-            'social_media.*.orden' => ['sometimes', 'integer', 'min:0', 'distinct'],
-            'search_product_layout' => ['sometimes', Rule::enum(ProductLayout::class)],
-            'search_group_layout' => ['sometimes', Rule::enum(GroupLayout::class)],
-            'search_items_per_page' => ['sometimes', 'integer', 'min:4', 'max:48'],
-            'display_categories' => ['sometimes', 'boolean'],
-            'display_seach_bar' => ['sometimes', 'boolean'],
-            'display_cart' => ['sometimes', 'boolean'],
-            'cart_editing_policy' => ['sometimes', Rule::enum(CartEditingPolicy::class)],
-            'checkout_editing_policy' => [
-                'sometimes',
-                Rule::in([CartEditingPolicy::Disabled->value]),
-            ],
-            'display_cart_item_images' => ['sometimes', 'boolean'],
-            'scanner_category_validation_enabled' => ['sometimes', 'boolean'],
-            'allow_ticket_refund' => ['sometimes', 'boolean'],
-            'allow_ticket_total_refund' => ['sometimes', 'boolean'],
-            'allow_ticket_partial_refund' => ['sometimes', 'boolean'],
-            'ticket_partial_refund_percentage' => [
-                'sometimes',
-                'numeric',
-                'decimal:0,2',
-                'min:0',
-                'max:99.99',
-            ],
-            'admin_website_type_code' => ['sometimes', 'nullable', 'string', Rule::exists('admin_website_types', 'codigo')],
-            'storefront_website_type_code' => [
-                'sometimes',
-                'nullable',
-                'string',
-                Rule::exists('storefront_website_types', 'codigo'),
-                function (string $attribute, mixed $value, Closure $fail) use ($tenant): void {
-                    if ($tenant && $value !== $tenant->storefront_website_type_code && $tenant->websiteExtras()->exists()) {
-                        $fail('The storefront website type cannot be changed while the tenant has extras.');
-                    }
-                },
-            ],
-        ];
-    }
-}

app/Domains/Core/Tenant/Resources/AdminApp/BrandResource.php

@@ -0,0 +1,104 @@
+<?php
+
+namespace App\Domains\Core\Tenant\Resources\AdminApp;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Shared\Attachable\Models\Attachment;
+use App\Shared\Attachable\Models\AttachmentCrop;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+/** @mixin Tenant */
+class BrandResource extends JsonResource
+{
+    /** @return array<string, mixed> */
+    public function toArray(Request $request): array
+    {
+        return [
+            'nombre' => $this->nombre,
+            'primary_color' => $this->primary_color,
+            'header_bg_color' => $this->header_bg_color,
+            'footer_color' => $this->footerColor(),
+            'header_logo' => $this->headerLogo?->getTemporaryUrl(1440),
+            'header_logo_key' => $this->headerLogo?->key,
+            'footer_logo' => $this->footerLogo?->getTemporaryUrl(1440),
+            'footer_logo_key' => $this->footerLogo?->key,
+            'can_edit_carousel' => $this->canEditCarousel(),
+            'banner_images' => $this->bannerImages(),
+        ];
+    }
+
+    private function footerColor(): string
+    {
+        $footerColor = strtolower(trim((string) $this->footer_bg_color));
+        $primaryColor = strtolower(trim((string) $this->primary_color));
+
+        if ($footerColor !== '' && $footerColor === $primaryColor) {
+            return 'primary';
+        }
+
+        if (in_array($footerColor, ['#000', '#000000', 'black'], true)) {
+            return 'black';
+        }
+
+        if ($footerColor === '' || in_array($footerColor, ['#fff', '#ffffff', 'white'], true)) {
+            return 'white';
+        }
+
+        return 'primary';
+    }
+
+    /** @return array<int, array<string, mixed>> */
+    private function bannerImages(): array
+    {
+        if (! $this->canEditCarousel()) {
+            return [];
+        }
+
+        $extra = $this->websiteExtras->first(
+            fn ($extra) => $extra->is_enabled && $extra->websiteTypeExtra->codigo === 'carousel'
+        );
+
+        if ($extra === null) {
+            return [];
+        }
+
+        $images = $extra->resolvedConfig();
+
+        if (! is_array($images)) {
+            return [];
+        }
+
+        return collect($images)
+            ->filter(fn ($image) => $image instanceof Attachment)
+            ->map(function (Attachment $image): array {
+                $desktopCrop = $image->cropVariants
+                    ->firstWhere('variant', AttachmentCrop::DESKTOP);
+
+                return [
+                    'key' => $image->key,
+                    'url' => ($desktopCrop?->croppedAttachment ?? $image)->getTemporaryUrl(1440),
+                    'original_url' => $image->getTemporaryUrl(1440),
+                    'crop' => $desktopCrop === null ? null : [
+                        'crop_horizontal' => $desktopCrop->crop_horizontal,
+                        'crop_vertical' => $desktopCrop->crop_vertical,
+                    ],
+                ];
+            })
+            ->values()
+            ->all();
+    }
+
+    private function canEditCarousel(): bool
+    {
+        if ($this->storefront_website_type_code !== 'shopit') {
+            return false;
+        }
+
+        $extra = $this->websiteExtras->first(
+            fn ($extra) => $extra->websiteTypeExtra->codigo === 'carousel'
+        );
+
+        return $extra === null || $extra->is_enabled;
+    }
+}

app/Domains/Core/Tenant/Resources/TenantAddressResource.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace App\Domains\Core\Tenant\Resources;
+
+use App\Domains\Core\Address\Resources\AddressResource;
+use Illuminate\Http\Request;
+
+class TenantAddressResource extends AddressResource
+{
+    public function toArray(Request $request): array
+    {
+        return [...parent::toArray($request), 'is_main' => (bool) $this->pivot->is_main];
+    }
+}

app/Domains/Core/Tenant/Resources/TenantResource.php

@@ -3,6 +3,7 @@
 namespace App\Domains\Core\Tenant\Resources;
 
 use App\Domains\Commerce\Catalog\Models\Category;
+use App\Domains\Core\Address\Resources\AddressResource;
 use App\Domains\Core\Menu\Models\Menu;
 use App\Domains\Core\Tenant\Models\StorefrontWebsiteType;
 use App\Domains\Core\Tenant\Models\Tenant;
@@ -35,11 +36,14 @@ class TenantResource extends JsonResource
             'client_id' => $this->client_id,
             'codigo' => $this->codigo,
             'nombre' => $this->nombre,
+            'timezone' => $this->timezone,
             'dominio' => $this->dominio,
             'base_path' => $this->base_path,
             'site_title' => $this->site_title ?? 'ShopitFront',
             'asset_url' => config('filesystems.disks.s3.url'),
             'address' => $this->address,
+            'addresses' => $this->whenLoaded('addresses', fn () => TenantAddressResource::collection($this->addresses)),
+            'main_address' => $this->whenLoaded('mainAddress', fn () => AddressResource::make($this->mainAddress)),
             'phone' => $this->phone,
             'favicon' => $this->favicon?->getTemporaryUrl(1440),
             'primary_color' => $this->primary_color,
@@ -126,6 +130,7 @@ class TenantResource extends JsonResource
             'subtitle' => $event->subtitle,
             'description' => $event->description,
             'location' => $event->location,
+            'address' => AddressResource::make($event->address),
             'date_text' => $event->date_text,
             'dates' => $event->dates
                 ->filter(fn (EventDate $date): bool => $date->rescheduled_to_event_date_id === null)

app/Domains/Core/Tenant/Services/AdminWebsiteTypeService.php

@@ -2,9 +2,10 @@
 
 namespace App\Domains\Core\Tenant\Services;
 
+use App\Domains\Core\Tenant\Models\AdminWebsiteType;
+use App\Domains\Core\Tenant\Models\Tenant;
 use App\Shared\Attachable\Models\Attachment;
 use App\Shared\Attachable\Services\AttachmentService;
-use App\Domains\Core\Tenant\Models\AdminWebsiteType;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
 

app/Domains/Core/Tenant/Services/BrandService.php

@@ -0,0 +1,165 @@
+<?php
+
+namespace App\Domains\Core\Tenant\Services;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Shared\Attachable\Enums\AttachmentType;
+use App\Shared\Attachable\Models\Attachment;
+use App\Shared\Attachable\Services\AttachmentService;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Support\Str;
+use Illuminate\Validation\ValidationException;
+use Throwable;
+
+class BrandService
+{
+    public function __construct(
+        private readonly AttachmentService $attachmentService,
+        private readonly WebsiteExtraService $websiteExtraService,
+    ) {}
+
+    /** @param array<string, mixed> $data */
+    public function update(Tenant $tenant, array $data): void
+    {
+        $carousel = $tenant->storefront_website_type_code === 'shopit'
+            ? $tenant->websiteExtras()->whereHas('websiteTypeExtra',
+                fn ($query) => $query->where('codigo', 'carousel'))->first()
+            : null;
+        $allowedBannerIds = is_array($carousel?->config) ? $carousel->config : [];
+        if ($carousel !== null && ! $carousel->is_enabled && ($data['banner_images'] ?? []) !== []) {
+            throw ValidationException::withMessages(['banner_images' => 'El carrusel está deshabilitado.']);
+        }
+        $seen = [];
+
+        foreach (['header_logo' => $tenant->header_logo_id, 'footer_logo' => $tenant->footer_logo_id] as $field => $id) {
+            $this->existingImage($data[$field], $id === null ? [] : [$id], $field);
+        }
+        foreach ($data['banner_images'] ?? [] as $index => $item) {
+            $image = is_array($item) ? $item['image'] : $item;
+            $attachment = $this->existingImage($image, $allowedBannerIds, "banner_images.{$index}");
+            if ($attachment !== null) {
+                if (isset($seen[$attachment->id])) {
+                    throw ValidationException::withMessages(["banner_images.{$index}" => 'La imagen está repetida.']);
+                }
+                $seen[$attachment->id] = true;
+            }
+        }
+
+        $created = [];
+
+        try {
+            DB::transaction(function () use ($tenant, $data, $carousel, &$created): void {
+                $header = $this->logo($data['header_logo'], $tenant->header_logo_id, $tenant, $created);
+                $footer = $this->logo($data['footer_logo'], $tenant->footer_logo_id, $tenant, $created);
+
+                $tenant->update([
+                    'nombre' => trim($data['nombre']),
+                    'primary_color' => $data['primary_color'],
+                    'footer_bg_color' => $data['footer_bg_color'],
+                    'header_logo_id' => $header?->id,
+                    'footer_logo_id' => $footer?->id,
+                ]);
+
+                if ($tenant->storefront_website_type_code !== 'shopit'
+                    || ($carousel !== null && ! $carousel->is_enabled)) {
+                    return;
+                }
+
+                $definition = $this->websiteExtraService->definitionForTenant($tenant, 'carousel');
+                $ids = [];
+                $recrops = [];
+                foreach ($data['banner_images'] as $item) {
+                    $image = is_array($item) ? $item['image'] : $item;
+                    $attachment = $this->existingImage($image, $carousel?->config ?? [], 'banner_images');
+                    $crops = $this->crops($item);
+
+                    if ($attachment === null) {
+                        $attachment = $crops === null
+                            ? $this->attachmentService->store($image, "tenants/{$tenant->codigo}/extras/carousel")
+                            : $this->attachmentService->storeCroppedImageVariants(
+                                $image, "tenants/{$tenant->codigo}/extras/carousel", $crops
+                            );
+                        $created[] = $attachment;
+                    } elseif ($crops !== null) {
+                        $recrops[] = [$attachment, $crops];
+                    }
+                    $ids[] = $attachment->id;
+                }
+
+                $tenant->websiteExtras()->updateOrCreate(
+                    ['website_type_extra_id' => $definition->id],
+                    ['config' => $ids]
+                );
+
+                foreach ($recrops as [$attachment, $crops]) {
+                    $this->attachmentService->updateImageCropVariants($attachment, $crops);
+                }
+            });
+        } catch (Throwable $error) {
+            foreach ($created as $attachment) {
+                $paths = [$attachment->path];
+                foreach ($attachment->cropVariants as $crop) {
+                    if ($crop->croppedAttachment !== null) {
+                        $paths[] = $crop->croppedAttachment->path;
+                    }
+                }
+                Storage::disk('s3')->delete($paths);
+            }
+            throw $error;
+        }
+    }
+
+    /** @param array<int, int> $allowedIds */
+    private function existingImage(mixed $value, array $allowedIds, string $field): ?Attachment
+    {
+        if (! is_string($value) || ! Str::isUuid($value)) {
+            return null;
+        }
+
+        $attachment = Attachment::query()->where('key', $value)->first();
+        if ($attachment === null || $attachment->type !== AttachmentType::Image
+            || ! in_array($attachment->id, $allowedIds, true)) {
+            throw ValidationException::withMessages([$field => 'La imagen no pertenece a esta marca.']);
+        }
+
+        return $attachment;
+    }
+
+    /** @param array<int, Attachment> $created */
+    private function logo(mixed $value, ?int $currentId, Tenant $tenant, array &$created): ?Attachment
+    {
+        if ($value === null) {
+            return null;
+        }
+
+        $existing = $this->existingImage($value, $currentId === null ? [] : [$currentId], 'logo');
+        if ($existing !== null) {
+            return $existing;
+        }
+
+        $attachment = $this->attachmentService->store($value, "tenants/{$tenant->codigo}/logos");
+        $created[] = $attachment;
+
+        return $attachment;
+    }
+
+    /** @return array<string, array<string, mixed>>|null */
+    private function crops(mixed $item): ?array
+    {
+        if (! is_array($item)) {
+            return null;
+        }
+
+        if (! isset($item['crop_horizontal'], $item['crop_vertical'])) {
+            return null;
+        }
+
+        $crop = [
+            'crop_horizontal' => $item['crop_horizontal'],
+            'crop_vertical' => $item['crop_vertical'],
+        ];
+
+        return ['desktop' => $crop, 'mobile' => $crop];
+    }
+}

app/Domains/Core/Tenant/Services/TenantAddressService.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Domains\Core\Tenant\Services;
+
+use App\Domains\Core\Address\Models\Address;
+use App\Domains\Core\Tenant\Models\Tenant;
+use Illuminate\Support\Facades\DB;
+
+class TenantAddressService
+{
+    public function setMainAddress(Tenant $tenant, Address $address): void
+    {
+        DB::transaction(function () use ($tenant, $address): void {
+            // Serialize changes for this tenant, including when it has no principal address yet.
+            Tenant::query()->where('codigo', $tenant->codigo)->lockForUpdate()->firstOrFail();
+            $tenant->addresses()->where('addresses.id', $address->id)->firstOrFail();
+
+            DB::table('tenant_addresses')->where('tenant_codigo', $tenant->codigo)
+                ->where('is_main', true)->update(['is_main' => false, 'updated_at' => now()]);
+            $tenant->addresses()->updateExistingPivot($address->id, ['is_main' => true]);
+        });
+
+        $tenant->unsetRelation('addresses');
+        $tenant->unsetRelation('mainAddress');
+    }
+}

app/Domains/Core/Tenant/Services/TenantInformationService.php

@@ -18,9 +18,12 @@ class TenantInformationService
         'footerBackgroundImage',
         'storefrontWebsiteType',
         'socialMedia',
+        'addresses',
+        'mainAddress',
         'websiteExtras.websiteTypeExtra',
         'activeEvent.dates',
         'activeEvent.socialMedia',
+        'activeEvent.address',
     ];
 
     /**

app/Domains/Core/Tenant/Services/TenantProvisioningService.php

@@ -0,0 +1,125 @@
+<?php
+
+namespace App\Domains\Core\Tenant\Services;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Shared\Attachable\Models\Attachment;
+use App\Shared\Attachable\Services\AttachmentService;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+
+/**
+ * Internal provisioning used by migrations and seeders.
+ *
+ * General tenant writes are intentionally not exposed through the HTTP API.
+ */
+class TenantProvisioningService
+{
+    public function __construct(
+        protected AttachmentService $attachmentService,
+        protected WebsiteExtraService $websiteExtraService,
+    ) {}
+
+    /** @param array<string, mixed> $data */
+    public function create(array $data): Tenant
+    {
+        return DB::transaction(function () use ($data): Tenant {
+            $images = [
+                'header_logo' => $data['header_logo'] ?? null,
+                'footer_logo' => $data['footer_logo'] ?? null,
+                'favicon' => $data['favicon'] ?? null,
+                'header_bg_image' => $data['header_bg_image'] ?? null,
+                'footer_bg_image' => $data['footer_bg_image'] ?? null,
+            ];
+            $socialMedia = $data['social_media'] ?? [];
+            $extras = $data['extras'] ?? [];
+
+            unset(
+                $data['header_logo'],
+                $data['footer_logo'],
+                $data['favicon'],
+                $data['header_bg_image'],
+                $data['footer_bg_image'],
+                $data['social_media'],
+                $data['extras'],
+            );
+
+            foreach ($images as $key => $image) {
+                $data[$key.'_id'] = $this->storeTenantImage($image);
+            }
+
+            /** @var Tenant $tenant */
+            $tenant = Tenant::query()->create($data);
+            $this->syncSocialMedia($tenant, $socialMedia);
+
+            foreach ($extras as $code => $config) {
+                $this->websiteExtraService->updateForTenant($tenant, $code, $config);
+            }
+
+            return $tenant;
+        });
+    }
+
+    /** @param array<string, mixed> $data */
+    public function update(Tenant $tenant, array $data): Tenant
+    {
+        return DB::transaction(function () use ($tenant, $data): Tenant {
+            $imageKeys = [
+                'header_logo',
+                'footer_logo',
+                'favicon',
+                'header_bg_image',
+                'footer_bg_image',
+            ];
+            $hasSocialMedia = array_key_exists('social_media', $data);
+            $socialMedia = $data['social_media'] ?? [];
+            unset($data['social_media']);
+
+            foreach ($imageKeys as $key) {
+                if (! array_key_exists($key, $data)) {
+                    continue;
+                }
+
+                $data[$key.'_id'] = $this->storeTenantImage($data[$key]);
+                unset($data[$key]);
+            }
+
+            $tenant->update($data);
+
+            if ($hasSocialMedia) {
+                $this->syncSocialMedia($tenant, $socialMedia);
+            }
+
+            return $tenant->refresh();
+        });
+    }
+
+    /** @param array<int, array{code: string, url: string, orden?: int}> $socialMedia */
+    private function syncSocialMedia(Tenant $tenant, array $socialMedia): void
+    {
+        $associations = [];
+
+        foreach (array_values($socialMedia) as $index => $item) {
+            $associations[$item['code']] = [
+                'url' => $item['url'],
+                'orden' => $item['orden'] ?? $index,
+            ];
+        }
+
+        $tenant->socialMedia()->sync($associations);
+        $tenant->unsetRelation('socialMedia');
+    }
+
+    private function storeTenantImage(mixed $image): ?int
+    {
+        if (! $image) {
+            return null;
+        }
+
+        $attachment = is_string($image) && Str::isUuid($image)
+            ? Attachment::query()->where('key', $image)->first()
+            : $this->attachmentService->store($image, 'tenants');
+
+        return $attachment?->id;
+    }
+}

app/Domains/Core/Tenant/Services/TenantService.php

@@ -1,198 +0,0 @@
-<?php
-
-namespace App\Domains\Core\Tenant\Services;
-
-use App\Shared\Attachable\Models\Attachment;
-use App\Shared\Attachable\Services\AttachmentService;
-use App\Domains\Core\Tenant\Models\Tenant;
-use Illuminate\Support\Facades\DB;
-use Illuminate\Support\Str;
-
-class TenantService
-{
-    public function __construct(
-        protected AttachmentService $attachmentService,
-        protected WebsiteExtraService $websiteExtraService,
-    ) {}
-
-    /**
-     * Create a new tenant and store its logos.
-     *
-     * @param  array<string, mixed>  $data
-     */
-    public function create(array $data): Tenant
-    {
-        return DB::transaction(function () use ($data): Tenant {
-            $headerLogo = $data['header_logo'] ?? null;
-            $footerLogo = $data['footer_logo'] ?? null;
-            $favicon = $data['favicon'] ?? null;
-            $headerBackgroundImage = $data['header_bg_image'] ?? null;
-            $footerBackgroundImage = $data['footer_bg_image'] ?? null;
-            $socialMedia = $data['social_media'] ?? [];
-            $extras = $data['extras'] ?? [];
-
-            unset(
-                $data['header_logo'],
-                $data['footer_logo'],
-                $data['favicon'],
-                $data['header_bg_image'],
-                $data['footer_bg_image'],
-                $data['social_media'],
-                $data['extras'],
-            );
-
-            $headerAttachmentId = null;
-            if ($headerLogo) {
-                $attachment = Str::isUuid($headerLogo)
-                    ? Attachment::query()->where('key', $headerLogo)->first()
-                    : $this->attachmentService->store($headerLogo, 'tenants');
-
-                if ($attachment) {
-                    $headerAttachmentId = $attachment->id;
-                }
-            }
-
-            $footerAttachmentId = null;
-            if ($footerLogo) {
-                $attachment = Str::isUuid($footerLogo)
-                    ? Attachment::query()->where('key', $footerLogo)->first()
-                    : $this->attachmentService->store($footerLogo, 'tenants');
-
-                if ($attachment) {
-                    $footerAttachmentId = $attachment->id;
-                }
-            }
-
-            $data['header_logo_id'] = $headerAttachmentId;
-            $data['footer_logo_id'] = $footerAttachmentId;
-            $data['favicon_id'] = $this->storeTenantImage($favicon);
-            $data['header_bg_image_id'] = $this->storeTenantImage($headerBackgroundImage);
-            $data['footer_bg_image_id'] = $this->storeTenantImage($footerBackgroundImage);
-
-            /** @var Tenant $tenant */
-            $tenant = Tenant::query()->create($data);
-            $this->syncSocialMedia($tenant, $socialMedia);
-            $this->websiteExtraService->createForTenant($tenant, $extras);
-
-            return $tenant;
-        });
-    }
-
-    /**
-     * Update an existing tenant and store new logos if uploaded.
-     *
-     * @param  array<string, mixed>  $data
-     */
-    public function update(Tenant $tenant, array $data): Tenant
-    {
-        return DB::transaction(function () use ($tenant, $data): Tenant {
-            $hasHeaderLogoKey = array_key_exists('header_logo', $data);
-            $hasFooterLogoKey = array_key_exists('footer_logo', $data);
-            $hasFaviconKey = array_key_exists('favicon', $data);
-            $hasHeaderBackgroundImageKey = array_key_exists('header_bg_image', $data);
-            $hasFooterBackgroundImageKey = array_key_exists('footer_bg_image', $data);
-            $hasSocialMediaKey = array_key_exists('social_media', $data);
-            $headerLogo = $data['header_logo'] ?? null;
-            $footerLogo = $data['footer_logo'] ?? null;
-            $favicon = $data['favicon'] ?? null;
-            $headerBackgroundImage = $data['header_bg_image'] ?? null;
-            $footerBackgroundImage = $data['footer_bg_image'] ?? null;
-            $socialMedia = $data['social_media'] ?? [];
-
-            unset(
-                $data['header_logo'],
-                $data['footer_logo'],
-                $data['favicon'],
-                $data['header_bg_image'],
-                $data['footer_bg_image'],
-                $data['social_media']
-            );
-
-            $tenant->fill($data);
-
-            if ($hasHeaderLogoKey) {
-                if ($headerLogo) {
-                    $attachment = Str::isUuid($headerLogo)
-                        ? Attachment::query()->where('key', $headerLogo)->first()
-                        : $this->attachmentService->store($headerLogo, 'tenants');
-
-                    if ($attachment) {
-                        $tenant->header_logo_id = $attachment->id;
-                    } else {
-                        $tenant->header_logo_id = null;
-                    }
-                } else {
-                    $tenant->header_logo_id = null;
-                }
-            }
-
-            if ($hasFooterLogoKey) {
-                if ($footerLogo) {
-                    $attachment = Str::isUuid($footerLogo)
-                        ? Attachment::query()->where('key', $footerLogo)->first()
-                        : $this->attachmentService->store($footerLogo, 'tenants');
-
-                    if ($attachment) {
-                        $tenant->footer_logo_id = $attachment->id;
-                    } else {
-                        $tenant->footer_logo_id = null;
-                    }
-                } else {
-                    $tenant->footer_logo_id = null;
-                }
-            }
-
-            if ($hasFaviconKey) {
-                $tenant->favicon_id = $this->storeTenantImage($favicon);
-            }
-
-            if ($hasHeaderBackgroundImageKey) {
-                $tenant->header_bg_image_id = $this->storeTenantImage($headerBackgroundImage);
-            }
-
-            if ($hasFooterBackgroundImageKey) {
-                $tenant->footer_bg_image_id = $this->storeTenantImage($footerBackgroundImage);
-            }
-
-            $tenant->save();
-
-            if ($hasSocialMediaKey) {
-                $this->syncSocialMedia($tenant, $socialMedia);
-            }
-
-            return $tenant;
-        });
-    }
-
-    /**
-     * @param  array<int, array{code: string, url: string, orden?: int}>  $socialMedia
-     */
-    private function syncSocialMedia(Tenant $tenant, array $socialMedia): void
-    {
-        $owner = $tenant->activeEvent ?? $tenant;
-        $associations = [];
-
-        foreach (array_values($socialMedia) as $index => $item) {
-            $associations[$item['code']] = [
-                'url' => $item['url'],
-                'orden' => $item['orden'] ?? $index,
-            ];
-        }
-
-        $owner->socialMedia()->sync($associations);
-        $owner->unsetRelation('socialMedia');
-    }
-
-    private function storeTenantImage(mixed $image): ?int
-    {
-        if (! $image) {
-            return null;
-        }
-
-        $attachment = is_string($image) && Str::isUuid($image)
-            ? Attachment::query()->where('key', $image)->first()
-            : $this->attachmentService->store($image, 'tenants');
-
-        return $attachment?->id;
-    }
-}

app/Domains/Core/Tenant/Services/WebsiteExtraService.php

@@ -2,16 +2,14 @@
 
 namespace App\Domains\Core\Tenant\Services;
 
+use App\Domains\Core\Tenant\Models\StorefrontWebsiteTypeExtra;
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Core\Tenant\Models\WebsiteExtra;
 use App\Shared\Attachable\Enums\AttachmentType;
 use App\Shared\Attachable\Models\Attachment;
 use App\Shared\Attachable\Services\AttachmentService;
 use App\Shared\Rules\CroppedImageOrBase64Rule;
 use App\Shared\Rules\ImageOrBase64Rule;
-use App\Domains\Core\Tenant\Models\Tenant;
-use App\Domains\Core\Tenant\Models\WebsiteExtra;
-use App\Domains\Core\Tenant\Models\StorefrontWebsiteType;
-use App\Domains\Core\Tenant\Models\StorefrontWebsiteTypeExtra;
-use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
 use Illuminate\Validation\ValidationException;
@@ -21,109 +19,6 @@ class WebsiteExtraService
 {
     public function __construct(protected AttachmentService $attachmentService) {}
 
-    /**
-     * Build the request rules declared by the selected website type.
-     *
-     * @return array<string, mixed>
-     */
-    public function requestRules(?string $websiteTypeCode): array
-    {
-        if (! is_string($websiteTypeCode) || $websiteTypeCode === '') {
-            return [
-                'extras' => ['prohibited'],
-            ];
-        }
-
-        $definitions = $this->definitionsFor($websiteTypeCode);
-        $allowedCodes = $definitions->pluck('codigo')->all();
-        $hasRequiredExtras = $definitions->contains(
-            fn (StorefrontWebsiteTypeExtra $definition): bool => $definition->is_required
-        );
-
-        $rules = [
-            'extras' => [
-                $hasRequiredExtras ? 'required' : 'sometimes',
-                'array',
-                function (string $attribute, mixed $value, \Closure $fail) use ($allowedCodes): void {
-                    if (! is_array($value)) {
-                        return;
-                    }
-
-                    $unknownCodes = array_diff(array_keys($value), $allowedCodes);
-
-                    if ($unknownCodes !== []) {
-                        $fail(
-                            'The '.$attribute.' field contains extras not supported by the website type: '
-                            .implode(', ', $unknownCodes).'.'
-                        );
-                    }
-                },
-            ],
-        ];
-
-        foreach ($definitions as $definition) {
-            $schemaRules = $definition->config_schema['request_rules'] ?? [];
-            $rootRules = $this->compileRules($schemaRules['$'] ?? []);
-            $rootRules = array_values(array_filter(
-                $rootRules,
-                fn (mixed $rule): bool => ! in_array($rule, ['required', 'sometimes'], true)
-            ));
-            array_unshift($rootRules, $definition->is_required ? 'required' : 'sometimes');
-
-            $rules["extras.{$definition->codigo}"] = $rootRules;
-
-            foreach ($schemaRules as $path => $pathRules) {
-                if ($path === '$') {
-                    continue;
-                }
-
-                $rules[$this->requestAttribute($definition->codigo, $path)] = $this->compileRules($pathRules);
-            }
-        }
-
-        return $rules;
-    }
-
-    /**
-     * Transform and persist each extra selected for a tenant.
-     *
-     * @param  array<string, mixed>  $extras
-     */
-    public function createForTenant(Tenant $tenant, array $extras): void
-    {
-        if ($extras === []) {
-            return;
-        }
-
-        $definitions = $this->definitionsFor((string) $tenant->storefront_website_type_code)
-            ->keyBy('codigo');
-
-        foreach ($extras as $name => $config) {
-            /** @var StorefrontWebsiteTypeExtra|null $definition */
-            $definition = $definitions->get($name);
-
-            if (! $definition) {
-                throw ValidationException::withMessages([
-                    'extras' => ["The extra {$name} is not supported by the selected website type."],
-                ]);
-            }
-
-            $requestRoot = "extras.{$definition->codigo}";
-            $transformedConfig = $this->applyTransforms(
-                $tenant,
-                $definition,
-                $config,
-                $requestRoot
-            );
-            $tenant->websiteExtras()->create([
-                'website_type_extra_id' => $definition->id,
-                'config' => $transformedConfig,
-            ]);
-        }
-
-        $tenant->unsetRelation('websiteExtras');
-    }
-
     /**
      * Build request rules for one extra addressed by its stable code.
      *
@@ -201,19 +96,6 @@ class WebsiteExtraService
             ->firstOrFail();
     }
 
-    /**
-     * @return Collection<int, StorefrontWebsiteTypeExtra>
-     */
-    private function definitionsFor(string $websiteTypeCode): Collection
-    {
-        $websiteType = StorefrontWebsiteType::query()
-            ->where('codigo', $websiteTypeCode)
-            ->with('extras')
-            ->first();
-
-        return $websiteType?->extras ?? collect();
-    }
-
     /**
      * @param  string|array<int, mixed>  $rules
      * @return array<int, mixed>
@@ -232,11 +114,6 @@ class WebsiteExtraService
         );
     }
 
-    private function requestAttribute(string $extraCode, string $path): string
-    {
-        return $this->configAttribute("extras.{$extraCode}", $path);
-    }
-
     private function configAttribute(string $root, string $path): string
     {
         if ($path === '$') {

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

@@ -15,7 +15,6 @@ Es la raíz del modelo multi-tenant. Gestiona organizaciones/sitios, tipos de we
 
 ## Servicios
 
-- `TenantService`: crea y actualiza tenants, incluyendo sus recursos asociados.
 - `TenantInformationService`: carga un tenant y las relaciones requeridas por cada contexto.
 - `AdminWebsiteTypeService`: crea o actualiza los tipos de admin y su marca.
 - `WebsiteExtraService`: construye reglas dinámicas, crea, actualiza y habilita/deshabilita extras.
@@ -25,7 +24,8 @@ El par `(dominio, base_path)` es único. Un mismo dominio puede alojar el tenant
 
 ## Endpoints
 
-- Recurso REST público/administrativo `/tenants`.
+- `GET /tenants`, `GET /tenants/{codigo}` y `DELETE /tenants/{codigo}`.
+- La creación y actualización general de tenants se administran mediante seeders o base de datos; no se exponen por API.
 - Bajo `/v1/adminapp/tenant/website-extras`, con autenticación y contexto de tenant: consulta general, detalle, actualización y activación/desactivación.
 
 ## Dependencias y reglas

app/Domains/Core/Tenant/routes/adminapp.php

@@ -1,11 +1,18 @@
 <?php
 
+use App\Domains\Core\Tenant\Controllers\AdminApp\BrandController;
+use App\Domains\Core\Tenant\Controllers\AdminApp\HelpMenuController;
 use App\Domains\Core\Tenant\Controllers\AdminApp\WebsiteExtraController;
 use Illuminate\Support\Facades\Route;
 
 Route::prefix('v1/adminapp/tenant')
     ->middleware(['auth:sanctum', 'adminapp.tenant'])
     ->group(function (): void {
+        Route::get('brand', [BrandController::class, 'show']);
+        Route::put('brand', [BrandController::class, 'update']);
+        Route::get('help-menus', [HelpMenuController::class, 'index']);
+        Route::patch('help-menus/{menuCode}/toggle', [HelpMenuController::class, 'toggle']);
+        Route::put('help-menus/{menuCode}/content', [HelpMenuController::class, 'updateContent']);
         Route::get('website-extras', [WebsiteExtraController::class, 'show']);
         Route::get('website-extras/{websiteExtraCode}', [WebsiteExtraController::class, 'showExtra']);
         Route::put('website-extras/{websiteExtraCode}', [WebsiteExtraController::class, 'update']);

app/Domains/Core/Tenant/routes/api.php

@@ -3,6 +3,6 @@
 use App\Domains\Core\Tenant\Controllers\TenantController;
 use Illuminate\Support\Facades\Route;
 
-Route::apiResource('tenants', TenantController::class);
+Route::apiResource('tenants', TenantController::class)->except(['store', 'update']);
 
 require __DIR__.'/adminapp.php';

app/Domains/Ticketing/Desfile/Controllers/EntryReservationController.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\EntryReservationExcelService;
+use App\Domains\Ticketing\Desfile\Services\EntryReservationPdfService;
+use App\Domains\Ticketing\Desfile\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 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/Desfile/Enums/EntryReservationPaymentType.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\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/Desfile/Models/EntryReservation.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Models;
+
+use App\Domains\Commerce\Catalog\Models\Inventory;
+use App\Domains\Commerce\Catalog\Models\Variant;
+use App\Domains\Ticketing\Desfile\Enums\EntryReservationPaymentType;
+use App\Domains\Ticketing\Ticket\Models\Ticket;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+#[Fillable([
+    'variant_id',
+    'ticket_id',
+    'inventory_id',
+    'batch_id',
+    'fecha_reserva',
+    'importe',
+    'tipo_pago',
+])]
+class EntryReservation extends Model
+{
+    use SoftDeletes;
+
+    protected $table = 'desfile_entry_reservations';
+
+    protected function casts(): array
+    {
+        return [
+            'variant_id' => 'integer',
+            'fecha_reserva' => 'datetime',
+            'importe' => 'decimal:2',
+            'tipo_pago' => EntryReservationPaymentType::class,
+        ];
+    }
+
+    /** @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/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\Desfile\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\Desfile\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,47 @@
+<?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,
+            '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/EntryReservationExcelService.php

@@ -0,0 +1,91 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\Services;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Desfile\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\Desfile\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\Desfile\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/EntryReservationService.php

@@ -0,0 +1,240 @@
+<?php
+
+namespace App\Domains\Ticketing\Desfile\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\Desfile\Enums\EntryReservationPaymentType;
+use App\Domains\Ticketing\Desfile\Models\EntryReservation;
+use App\Domains\Ticketing\Ticket\Exceptions\TicketGenerationException;
+use App\Domains\Ticketing\Ticket\Models\Ticket;
+use App\Domains\Ticketing\Ticket\Services\TicketGeneratorService;
+use App\Domains\Ticketing\Ticket\Services\TicketPresentationResolver;
+use App\Domains\Ticketing\Ticket\Services\TicketValidityResolver;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Pagination\LengthAwarePaginator;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Validation\ValidationException;
+
+class EntryReservationService
+{
+    public function __construct(private readonly TicketGeneratorService $tickets) {}
+
+    /**
+     * @param  array{tipo_pago?: string|null, page?: int, per_page?: int}  $filters
+     * @return LengthAwarePaginator<EntryReservation>
+     */
+    public function reservations(User $user, array $filters = []): LengthAwarePaginator
+    {
+        abort_unless($user->tenant_codigo === 'desfile_pura_tendencia', 403);
+
+        return $this->reservationsQuery($user, $filters)
+            ->paginate(
+                perPage: $filters['per_page'] ?? 15,
+                pageName: 'page',
+                page: $filters['page'] ?? 1,
+            )
+            ->withQueryString();
+    }
+
+    /**
+     * @param  array{tipo_pago?: string|null}  $filters
+     * @return Collection<int, EntryReservation>
+     */
+    public function reservationsForExport(User $user, array $filters = []): Collection
+    {
+        abort_unless($user->tenant_codigo === 'desfile_pura_tendencia', 403);
+
+        return $this->reservationsQuery($user, $filters)->get();
+    }
+
+    public function reservationTicket(User $user, int $reservationId): Ticket
+    {
+        abort_unless($user->tenant_codigo === 'desfile_pura_tendencia', 403);
+
+        $reservation = EntryReservation::query()
+            ->whereKey($reservationId)
+            ->whereNotNull('ticket_id')
+            ->whereHas('variant.catalogItem', fn (Builder $query): Builder => $query
+                ->where('tenant_code', $user->tenant_codigo)
+                ->where('slug', 'entrada'))
+            ->with(['ticket' => fn ($query) => $query->with([
+                ...TicketValidityResolver::RELATIONS,
+                ...TicketPresentationResolver::RELATIONS,
+            ])])
+            ->firstOrFail();
+
+        return $reservation->ticket;
+    }
+
+    public function cancel(User $user, int $reservationId): void
+    {
+        abort_unless($user->tenant_codigo === 'desfile_pura_tendencia', 403);
+
+        DB::transaction(function () use ($user, $reservationId): void {
+            $reservation = EntryReservation::query()
+                ->whereKey($reservationId)
+                ->whereHas('variant.catalogItem', fn (Builder $query): Builder => $query
+                    ->where('tenant_code', $user->tenant_codigo)
+                    ->where('slug', 'entrada'))
+                ->lockForUpdate()
+                ->firstOrFail();
+
+            if ($reservation->ticket_id !== null) {
+                $ticket = Ticket::query()->lockForUpdate()->findOrFail($reservation->ticket_id);
+
+                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()->lockForUpdate()->findOrFail($reservation->inventory_id);
+                $inventory->releaseEntry(1);
+            }
+
+            $reservation->delete();
+        }, 3);
+    }
+
+    /** @param array{tipo_pago?: string|null} $filters */
+    private function reservationsQuery(User $user, array $filters = []): Builder
+    {
+        return EntryReservation::query()
+            ->whereHas('variant.catalogItem', fn (Builder $query): Builder => $query
+                ->where('tenant_code', $user->tenant_codigo)
+                ->where('slug', 'entrada'))
+            ->when(
+                $filters['tipo_pago'] ?? null,
+                fn (Builder $query, string $paymentType): Builder => $query->where('tipo_pago', $paymentType),
+            )
+            ->with([
+                'variant.catalogItem.itemAttributes.attribute.options',
+                'variant.definitions.itemAttribute.attribute.options',
+                'variant.eventDates',
+                'variant.eventDate',
+            ])
+            ->orderByDesc('fecha_reserva')
+            ->orderByDesc('id');
+    }
+
+    /** @param list<array{variant_id: int, tipo_pago: string}> $rows */
+    public function reserve(User $user, string $key, array $rows): Collection
+    {
+        abort_unless($user->tenant_codigo === 'desfile_pura_tendencia', 403);
+        $normalized = collect($rows)->map(fn (array $row): array => [
+            'variant_id' => (int) $row['variant_id'], 'tipo_pago' => $row['tipo_pago'],
+        ])->sortBy('variant_id')->values()->all();
+        $hash = hash('sha256', json_encode($normalized, JSON_THROW_ON_ERROR));
+
+        return DB::transaction(function () use ($user, $key, $rows, $hash): Collection {
+            // Serialize retries by the same administrator, including the first insert.
+            User::query()->whereKey($user->id)->lockForUpdate()->firstOrFail();
+            $batch = DB::table('desfile_reservation_batches')
+                ->where('user_id', $user->id)->where('idempotency_key', $key)->lockForUpdate()->first();
+            if ($batch !== null) {
+                abort_unless($batch->tenant_code === $user->tenant_codigo && hash_equals($batch->request_hash, $hash), 409,
+                    'La clave de envío ya fue utilizada con otras entradas.');
+
+                return EntryReservation::query()->where('batch_id', $batch->id)->with('ticket')->orderBy('id')->get();
+            }
+
+            $tenant = $user->tenant()->firstOrFail();
+            $entry = CatalogItem::query()->forTenantCatalog($tenant)->where('slug', 'entrada')
+                ->lockForUpdate()->firstOrFail();
+            $ids = array_column($rows, 'variant_id');
+            $variants = $entry->variants()->whereKey($ids)->orderBy('id')->lockForUpdate()->get();
+            $inventories = Inventory::query()->whereKey($variants->pluck('inventory_id')->filter()->unique())
+                ->orderBy('id')->lockForUpdate()->get()->keyBy('id');
+            $variants->load([
+                'eventDates', 'eventDate',
+                'desfileEntryReservations' => fn ($query) => $query->lockForUpdate(),
+            ]);
+            foreach ($variants as $variant) {
+                $variant->setRelation('inventory', $inventories->get($variant->inventory_id));
+            }
+            $entry->setRelation('variants', $variants);
+            $available = $entry->visibleVariants()->keyBy('id');
+            $requirements = [];
+            $errors = [];
+            foreach ($rows as $index => $row) {
+                $variant = $available->get($row['variant_id']);
+                if ($variant === null || $variant->inventory === null) {
+                    $errors["rows.{$index}.variant_id"] = $this->entryLabel($variants->firstWhere('id', $row['variant_id']), $index).': la entrada ya no está disponible.';
+
+                    continue;
+                }
+                $requirements[$variant->inventory_id] = ($requirements[$variant->inventory_id] ?? 0) + 1;
+            }
+            if ($errors !== []) {
+                throw ValidationException::withMessages($errors);
+            }
+            $tracked = $entry->inventory_policy !== InventoryPolicy::Unlimited;
+            foreach ($requirements as $inventoryId => $quantity) {
+                if ($tracked && $inventories[$inventoryId]->availableStock() < $quantity) {
+                    foreach ($rows as $index => $row) {
+                        $variant = $available[$row['variant_id']];
+                        if ($variant->inventory_id === $inventoryId) {
+                            $errors["rows.{$index}.variant_id"] = $this->entryLabel($variant, $index).': no hay stock suficiente para reservar las entradas seleccionadas.';
+                        }
+                    }
+                }
+            }
+            if ($errors !== []) {
+                throw ValidationException::withMessages($errors);
+            }
+
+            $batchId = DB::table('desfile_reservation_batches')->insertGetId([
+                'user_id' => $user->id, 'tenant_code' => $tenant->codigo,
+                'idempotency_key' => $key, 'request_hash' => $hash,
+                'created_at' => now(), 'updated_at' => now(),
+            ]);
+            foreach ($requirements as $inventoryId => $quantity) {
+                $inventories[$inventoryId]->reserveEntry($quantity, $tracked);
+            }
+            $reservations = collect();
+            foreach ($rows as $index => $row) {
+                $variant = $available[$row['variant_id']];
+                $payment = EntryReservationPaymentType::from($row['tipo_pago']);
+                try {
+                    $ticket = $this->tickets->generate($entry, $user, 1, $variant->id)->sole();
+                } catch (TicketGenerationException $exception) {
+                    throw ValidationException::withMessages([
+                        "rows.{$index}.variant_id" => $this->entryLabel($variant, $index).': no se pudo emitir el ticket. '.$exception->getMessage(),
+                    ]);
+                }
+                $reservation = EntryReservation::query()->create([
+                    'batch_id' => $batchId, 'ticket_id' => $ticket->id,
+                    'variant_id' => $variant->id, 'inventory_id' => $variant->inventory_id,
+                    'fecha_reserva' => now(), 'tipo_pago' => $payment,
+                    'importe' => $payment === EntryReservationPaymentType::Free ? 0 : $variant->getPrice(),
+                ]);
+                $reservations->push($reservation->setRelation('ticket', $ticket));
+            }
+
+            return $reservations;
+        }, 3);
+    }
+
+    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/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

@@ -2,6 +2,7 @@
 
 namespace App\Domains\Ticketing\Desfile\Services;
 
+use App\Domains\Commerce\Catalog\Models\Inventory;
 use DateTimeInterface;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Hash;
@@ -393,14 +394,22 @@ class InvitationPurchaseProvisioner
 
         $inventory = DB::table('inventories')->where('id', $variant->inventory_id)->lockForUpdate()->first();
 
-        if ($inventory === null || $inventory->real_stock < 1 || $inventory->reserved_stock > 0) {
+        $available = $inventory?->available_stock
+            ?? ($inventory === null ? 0 : $inventory->real_stock - $inventory->reserved_stock - ($inventory->entry_reserved_stock ?? 0));
+        if ($available < 1) {
             throw new RuntimeException("El asiento {$variant->descripcion} ya no está disponible.");
         }
 
+        if (property_exists($inventory, 'available_stock')) {
+            Inventory::query()->findOrFail($inventory->id)->commitDirectSale(1);
+        } else {
+            // This provisioner is also used by historical migrations that run
+            // before generated availability and the movement ledger exist.
             DB::table('inventories')->where('id', $inventory->id)->update([
                 'real_stock' => $inventory->real_stock - 1,
                 'sold_units' => $inventory->sold_units + 1,
             ]);
+        }
 
         $reservationId = DB::table('compras')->where('id', $purchaseId)->value('stock_reservation_id');
         if ($reservationId === null) {

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

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

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

@@ -2,9 +2,12 @@
 
 namespace App\Domains\Ticketing\Event\Models;
 
+use App\Domains\Commerce\Catalog\Models\CatalogItem;
+use App\Domains\Core\Address\Models\Address;
+use App\Domains\Core\Client\Models\Client;
 use App\Domains\Core\Tenant\Models\SocialMedia;
 use App\Domains\Core\Tenant\Models\Tenant;
-use App\Domains\Commerce\Catalog\Models\CatalogItem;
+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;
@@ -13,14 +16,14 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
-#[Fillable(['tenant_code', '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', 'address_id', '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', 'address_id' => 'integer', 'published_at' => 'datetime', 'exact_location' => 'array'];
     }
 
     /** @return BelongsTo<Tenant, $this> */
@@ -29,6 +32,23 @@ 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);
+    }
+
+    /** @return BelongsTo<Address, $this> */
+    public function address(): BelongsTo
+    {
+        return $this->belongsTo(Address::class);
+    }
+
+    public function effectiveClient(): Client
+    {
+        return $this->client ?? $this->tenant->client;
+    }
+
     /** @return BelongsTo<EventCategory, $this> */
     public function eventCategory(): BelongsTo
     {
@@ -53,6 +73,12 @@ class Event extends Model
         return $this->hasMany(CatalogItem::class)->whereAvailable()->orderBy('group_order')->orderBy('id');
     }
 
+    /** @return HasMany<Ticket, $this> */
+    public function tickets(): HasMany
+    {
+        return $this->hasMany(Ticket::class);
+    }
+
     /** @return BelongsToMany<SocialMedia, $this> */
     public function socialMedia(): BelongsToMany
     {

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

@@ -3,10 +3,10 @@
 namespace App\Domains\Ticketing\Event\Models;
 
 use App\Domains\Commerce\Catalog\Models\Variant;
+use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Event\Enums\EventDateStatus;
 use App\Domains\Ticketing\Event\Services\EffectiveEventDateResolver;
 use App\Domains\Ticketing\Event\Services\EventDateTextFormatter;
-use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Ticket\Enums\ValidityTimeType;
 use App\Domains\Ticketing\Ticket\Models\ValidityTime;
 use Carbon\CarbonInterface;
@@ -131,12 +131,12 @@ class EventDate extends Model
 
     public function startsAt(): CarbonInterface
     {
-        return Carbon::parse($this->date->format('Y-m-d').' '.$this->time_start);
+        return Carbon::parse($this->date->format('Y-m-d').' '.$this->time_start, $this->tenant->timezone);
     }
 
     public function endsAt(): CarbonInterface
     {
-        $endsAt = Carbon::parse($this->date->format('Y-m-d').' '.$this->time_end);
+        $endsAt = Carbon::parse($this->date->format('Y-m-d').' '.$this->time_end, $this->tenant->timezone);
 
         return $endsAt->lessThanOrEqualTo($this->startsAt())
             ? $endsAt->addDay()
@@ -184,8 +184,8 @@ class EventDate extends Model
 
     private function syncValidityTime(): void
     {
-        $startsAt = $this->startsAt();
+        $startsAt = $this->startsAt()->utc();
-        $expiresAt = $this->endsAt();
+        $expiresAt = $this->endsAt()->utc();
 
         $attributes = [
             'type' => ValidityTimeType::FixedWindow,

app/Domains/Ticketing/Event/Resources/EventResource.php

@@ -2,8 +2,9 @@
 
 namespace App\Domains\Ticketing\Event\Resources;
 
-use App\Domains\Ticketing\Event\Services\EventDateGroupingService;
+use App\Domains\Core\Address\Resources\AddressResource;
 use App\Domains\Ticketing\Event\Models\Event;
+use App\Domains\Ticketing\Event\Services\EventDateGroupingService;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
 
@@ -17,9 +18,11 @@ class EventResource extends JsonResource
 
         return [
             'id' => $this->id,
+            'slug' => $this->slug,
             'title' => $this->title,
             'subtitle' => $this->subtitle,
             'description' => $this->description,
+            'address' => AddressResource::make($this->address),
             'location' => $this->location,
             'exact_location' => $this->exact_location,
             'date_text' => $this->date_text,

app/Domains/Ticketing/Event/Resources/PublicEventResource.php

@@ -5,7 +5,7 @@ namespace App\Domains\Ticketing\Event\Resources;
 use App\Domains\Commerce\Catalog\Enums\InventoryPolicy;
 use App\Domains\Commerce\Catalog\Models\CatalogItem;
 use App\Domains\Commerce\Catalog\Models\Variant;
-use Illuminate\Support\Carbon;
+use App\Domains\Core\Address\Resources\AddressResource;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
 
@@ -15,10 +15,12 @@ class PublicEventResource extends JsonResource
     {
         return [
             'id' => $this->id,
+            'slug' => $this->slug,
             'event_category_id' => $this->event_category_id,
             'title' => $this->title,
             'subtitle' => $this->subtitle,
             'description' => $this->description,
+            'address' => AddressResource::make($this->address),
             'location' => $this->location,
             'exact_location' => $this->exact_location,
             'date_text' => $this->date_text,
@@ -29,10 +31,7 @@ class PublicEventResource extends JsonResource
                     return null;
                 }
 
-                return Carbon::parse(
+                return $first->startsAt()->toISOString();
-                    $first->date->format('Y-m-d').' '.$first->time_start,
-                    config('app.event_timezone'),
-                )->toISOString();
             }),
             'dates' => $this->whenLoaded('dates', fn () => $this->dates->map(fn ($date): array => [
                 'id' => $date->id,
@@ -52,8 +51,7 @@ class PublicEventResource extends JsonResource
                     'description' => $item->descripcion,
                     'price' => $item->precio,
                     'image' => $item->attachments->first()?->getTemporaryUrl(1440),
-                    'requires_selection' => $item->itemAttributes->contains(fn ($attribute): bool =>
+                    'requires_selection' => $item->itemAttributes->contains(fn ($attribute): bool => $attribute->show_in_selector && $attribute->attribute?->codigo !== 'event_date'),
-                        $attribute->show_in_selector && $attribute->attribute?->codigo !== 'event_date'),
                     'maximum_quantity' => $item->inventory_policy === InventoryPolicy::Unlimited
                         ? null
                         : $item->availableStock(),

app/Domains/Ticketing/Event/Services/EventAddressService.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Domains\Ticketing\Event\Services;
+
+use App\Domains\Core\Address\Models\Address;
+use App\Domains\Ticketing\Event\Models\Event;
+
+class EventAddressService
+{
+    /** Called inside the event update transaction, after validating the legacy location fields. */
+    public function syncLocation(Event $event, bool $coordinatesProvided = false): void
+    {
+        $address = $event->address;
+        $coordinates = $coordinatesProvided || $address === null ? $event->exact_location : $address->coordinates();
+        $values = [
+            'address_text' => $event->location,
+            'latitude' => $coordinates['latitude'] ?? null,
+            'longitude' => $coordinates['longitude'] ?? null,
+        ];
+
+        if ($address !== null && ! (clone $address)->fill($values)->isDirty()) {
+            return;
+        }
+
+        // Editing one event must not change the location of another event or a tenant.
+        if ($address === null || $address->tenants()->exists()
+            || $address->events()->where('events.id', '!=', $event->id)->exists()) {
+            $address = Address::create(['label' => $address?->label ?? 'Ubicación del evento', ...$values]);
+            $event->address()->associate($address);
+            $event->save();
+        } else {
+            $address->update($values);
+        }
+
+        $event->setRelation('address', $address);
+    }
+}

app/Domains/Ticketing/Event/Services/EventService.php

@@ -2,18 +2,18 @@
 
 namespace App\Domains\Ticketing\Event\Services;
 
-use App\Domains\Core\Auth\Models\User;
 use App\Domains\Commerce\Cart\Services\InvalidateEventDateCartsService;
 use App\Domains\Commerce\Catalog\Models\Variant;
 use App\Domains\Commerce\Catalog\Services\StockReservationService;
 use App\Domains\Commerce\Catalog\Services\VariantReplacementService;
+use App\Domains\Core\Auth\Models\User;
+use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Event\Enums\EventDateChangeType;
 use App\Domains\Ticketing\Event\Events\EventDateRescheduled;
 use App\Domains\Ticketing\Event\Events\EventDateSuspended;
+use App\Domains\Ticketing\Event\Models\Event;
 use App\Domains\Ticketing\Event\Models\EventDate;
 use App\Domains\Ticketing\Event\Models\EventDateChange;
-use App\Domains\Ticketing\Event\Models\Event;
-use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\DB;
@@ -32,11 +32,12 @@ class EventService
         private readonly AffectedEventDatePurchaseResolver $affectedPurchaseResolver,
         private readonly VariantReplacementService $variantReplacementService,
         private readonly InvalidateEventDateCartsService $invalidateEventDateCarts,
+        private readonly EventAddressService $eventAddressService,
     ) {}
 
     public function forTenant(Tenant $tenant): Event
     {
-        return $tenant->activeEvent->load(['dates.validityTime', 'socialMedia']);
+        return $tenant->activeEvent->load(['dates.validityTime', 'socialMedia', 'address']);
     }
 
     /** @param array<string, mixed> $data */
@@ -49,6 +50,7 @@ class EventService
                 'location' => $data['location'],
                 ...array_intersect_key($data, ['attachment_id' => true, 'exact_location' => true]),
             ]);
+            $this->eventAddressService->syncLocation($event, array_key_exists('exact_location', $data));
             $tenant->update([
                 ...array_intersect_key($data, array_flip([
                     'allow_ticket_refund',
@@ -64,7 +66,7 @@ class EventService
                 $this->syncLegacyContact($event, $data['contact']);
             }
 
-            return $event->load(['dates.validityTime', 'socialMedia']);
+            return $event->load(['dates.validityTime', 'socialMedia', 'address']);
         });
     }
 

app/Domains/Ticketing/Event/Services/PublicEventService.php

@@ -23,11 +23,12 @@ class PublicEventService
             $query->where(function ($query) use ($term): void {
                 $query->where('title', 'like', '%'.$term.'%')
                     ->orWhere('subtitle', 'like', '%'.$term.'%')
-                    ->orWhere('location', 'like', '%'.$term.'%');
+                    ->orWhereHas('address', fn ($query) => $query->where('address_text', 'like', '%'.$term.'%'))
+                    ->orWhere(fn ($query) => $query->whereNull('address_id')->where('location', 'like', '%'.$term.'%'));
             });
         }
 
-        return $query->with('attachment')->orderByDesc('published_at')->orderByDesc('id')->paginate(15, ['*'], 'page', $page);
+        return $query->with(['attachment', 'address'])->orderByDesc('published_at')->orderByDesc('id')->paginate(15, ['*'], 'page', $page);
     }
 
     public function find(Tenant $tenant, Event $event): Event
@@ -38,6 +39,7 @@ class PublicEventService
 
         return $event->load([
             'attachment',
+            'address',
             'dates' => fn ($query) => $query->whereNull('rescheduled_to_event_date_id')->whereNull('suspended_at'),
             'socialMedia',
             'catalogItems.attachments',

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

@@ -13,6 +13,32 @@ mediante `event_id`. El catálogo `social_media` define las plataformas;
 `exact_location` guarda opcionalmente un objeto JSON con `latitude` (-90 a 90)
 y `longitude` (-180 a 180). `location` sigue siendo la dirección legible.
 
+`events.address_id` es una referencia opcional a `addresses.id`: `Event::address()`
+obtiene su dirección y `Address::events()` permite reutilizar una dirección en varios
+eventos. Al borrar una dirección, el vínculo queda en `NULL` y se conserva el evento.
+
+La migración `2026_09_30_000200_add_address_id_to_events` agrega el vínculo.
+`2026_09_30_000300_copy_event_locations_to_addresses` copia `location` a
+`address_text` y las coordenadas de `exact_location` a `latitude` y `longitude`, con
+el label `Ubicación del evento`. Solo copia eventos sin `address_id` y con texto de
+ubicación; no modifica los campos ni los timestamps originales, ni vincula la
+dirección al tenant. Si faltan texto y coordenadas, el vínculo queda en `NULL`.
+Los datos inválidos, incluidas coordenadas sin texto de dirección, detienen la
+copia y revierten las inserciones para evitar una migración parcial. Las migraciones
+deben ejecutarse explícitamente por quien administra la base.
+
+Las respuestas públicas, administrativas y el evento del bootstrap incluyen
+`address` con `id`, `label`, `address_text`, `latitude` y `longitude`. Las coordenadas
+se serializan como números o `null`. Los campos anteriores de la respuesta conservan
+sus valores originales; el frontend lee la ubicación y coordenadas desde `address`.
+El guardado administrativo de
+`location` y `exact_location` también actualiza `addresses`; si una dirección está
+compartida con otro evento o con un tenant, se crea una copia para el evento editado.
+El tenant devuelve `addresses` con `is_main` y `main_address`. El storefront usa
+todas las direcciones en contacto, la principal en el footer y la propia del evento
+en sus tarjetas, cabecera y mapa. Solo se agregan al mapa las direcciones con ambas
+coordenadas.
+
 La migración `2026_09_18_000500_restore_events` crea un evento por cada tenant que
 tenía datos de evento o fechas, y migra las fechas y redes correspondientes.
 `2026_09_18_000600_associate_active_event_social_media` copia al evento activo las

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

@@ -6,9 +6,9 @@ use Illuminate\Support\Facades\Route;
 
 require __DIR__.'/adminapp.php';
 
-Route::prefix('tenants/{tenant:codigo}')->group(function (): void {
+Route::prefix('tenants/{tenant:codigo}')->scopeBindings()->group(function (): void {
     Route::get('events', [PublicEventController::class, 'index']);
-    Route::get('events/{event}', [PublicEventController::class, 'show']);
+    Route::get('events/{event:slug}', [PublicEventController::class, 'show']);
 });
 
 Route::middleware('auth:sanctum')->post(

app/Domains/Ticketing/FiestaFutbolInfantil/Controllers/AccommodationController.php

@@ -28,6 +28,7 @@ class AccommodationController extends Controller
             $this->accommodationService->upsertMany(
                 $tenant,
                 $request->validated('variants'),
+                $request->validated('stock_adjustment_id'),
             )
         );
     }

app/Domains/Ticketing/FiestaFutbolInfantil/Controllers/EntryController.php

@@ -29,6 +29,7 @@ class EntryController extends Controller
         $entries = $this->entryService->upsertMany(
             $tenant,
             $request->validated('entries'),
+            $request->validated('stock_adjustment_id'),
         );
 
         return EntryResource::collection($entries)

app/Domains/Ticketing/FiestaFutbolInfantil/Controllers/FoodController.php

@@ -29,6 +29,7 @@ class FoodController extends Controller
             $this->foodService->upsertMany(
                 $tenant,
                 $request->validated('variants'),
+                $request->validated('stock_adjustment_id'),
             )
         );
     }
@@ -39,6 +40,7 @@ class FoodController extends Controller
             $this->foodService->updateHistoricalStock(
                 $request->user()->tenant()->firstOrFail(),
                 $request->validated('variants'),
+                $request->validated('stock_adjustment_id'),
             )
         );
     }

app/Domains/Ticketing/FiestaFutbolInfantil/Controllers/MerchandiseController.php

@@ -28,6 +28,7 @@ class MerchandiseController extends Controller
         $items = $this->merchandiseService->upsertMany(
             $tenant,
             $request->validated('items'),
+            $request->validated('stock_adjustment_id'),
         );
 
         return MerchandiseResource::collection($items)

app/Domains/Ticketing/FiestaFutbolInfantil/Requests/UpdateHistoricalFoodStockRequest.php

@@ -16,9 +16,10 @@ class UpdateHistoricalFoodStockRequest extends FormRequest
     {
         return [
             'variants' => ['required', 'array', 'min:1', 'max:500'],
-            'variants.*' => ['required', 'array:id,stock'],
+            'stock_adjustment_id' => ['nullable', 'uuid'],
+            'variants.*' => ['required', 'array:id,stock_difference'],
             'variants.*.id' => ['required', 'integer', 'distinct'],
-            'variants.*.stock' => ['required', 'integer', 'min:0'],
+            'variants.*.stock_difference' => ['required', 'integer'],
         ];
     }
 }

app/Domains/Ticketing/FiestaFutbolInfantil/Requests/UpsertAccommodationVariantsRequest.php

@@ -3,6 +3,7 @@
 namespace App\Domains\Ticketing\FiestaFutbolInfantil\Requests;
 
 use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Validator;
 
 class UpsertAccommodationVariantsRequest extends FormRequest
 {
@@ -16,12 +17,42 @@ class UpsertAccommodationVariantsRequest extends FormRequest
     {
         return [
             'variants' => ['required', 'array', 'min:1', 'max:500'],
-            'variants.*' => ['required', 'array:id,title,description,stock,price'],
+            'stock_adjustment_id' => ['nullable', 'uuid'],
+            'variants.*' => ['required', 'array:id,title,description,stock,stock_difference,price'],
             'variants.*.id' => ['sometimes', 'nullable', 'integer', 'distinct'],
             'variants.*.title' => ['required', 'string', 'max:255'],
             'variants.*.description' => ['sometimes', 'nullable', 'string'],
-            'variants.*.stock' => ['required', 'integer', 'min:0'],
+            'variants.*.stock' => ['sometimes', 'integer', 'min:0'],
+            'variants.*.stock_difference' => ['sometimes', 'integer'],
             'variants.*.price' => ['required', 'numeric', 'min:0', 'max:99999999.99'],
         ];
     }
+
+    /** @return array<int, callable> */
+    public function after(): array
+    {
+        return [
+            function (Validator $validator): void {
+                foreach ($this->input('variants', []) as $index => $variant) {
+                    if (! is_array($variant)) {
+                        continue;
+                    }
+
+                    if (isset($variant['id']) && ! array_key_exists('stock_difference', $variant)) {
+                        $validator->errors()->add(
+                            "variants.{$index}.stock_difference",
+                            'La diferencia de stock es obligatoria al actualizar una variante.',
+                        );
+                    }
+
+                    if (! isset($variant['id']) && ! array_key_exists('stock', $variant)) {
+                        $validator->errors()->add(
+                            "variants.{$index}.stock",
+                            'El stock inicial es obligatorio al crear una variante.',
+                        );
+                    }
+                }
+            },
+        ];
+    }
 }

app/Domains/Ticketing/FiestaFutbolInfantil/Requests/UpsertEntriesRequest.php

@@ -20,7 +20,8 @@ class UpsertEntriesRequest extends FormRequest
 
         return [
             'entries' => ['required', 'array', 'min:1', 'max:100'],
-            'entries.*' => ['required', 'array:id,title,description,event_date_ids,stock,price'],
+            'stock_adjustment_id' => ['nullable', 'uuid'],
+            'entries.*' => ['required', 'array:id,title,description,event_date_ids,stock,stock_difference,price'],
             'entries.*.id' => [
                 'sometimes',
                 'nullable',
@@ -46,7 +47,8 @@ class UpsertEntriesRequest extends FormRequest
                     fn ($query) => $query->where('tenant_code', $tenantCode)
                 ),
             ],
-            'entries.*.stock' => ['required', 'integer', 'min:0'],
+            'entries.*.stock' => ['sometimes', 'integer', 'min:0'],
+            'entries.*.stock_difference' => ['sometimes', 'integer'],
             'entries.*.price' => ['required', 'numeric', 'min:0', 'max:99999999.99'],
         ];
     }
@@ -61,6 +63,20 @@ class UpsertEntriesRequest extends FormRequest
                         continue;
                     }
 
+                    if (isset($entry['id']) && ! array_key_exists('stock_difference', $entry)) {
+                        $validator->errors()->add(
+                            "entries.{$index}.stock_difference",
+                            'La diferencia de stock es obligatoria al actualizar una entrada.',
+                        );
+                    }
+
+                    if (! isset($entry['id']) && ! array_key_exists('stock', $entry)) {
+                        $validator->errors()->add(
+                            "entries.{$index}.stock",
+                            'El stock inicial es obligatorio al crear una entrada.',
+                        );
+                    }
+
                     $dateIds = $entry['event_date_ids'] ?? [];
 
                     if (! is_array($dateIds)) {

app/Domains/Ticketing/FiestaFutbolInfantil/Requests/UpsertFoodVariantsRequest.php

@@ -20,7 +20,8 @@ class UpsertFoodVariantsRequest extends FormRequest
 
         return [
             'variants' => ['required', 'array', 'min:1', 'max:500'],
-            'variants.*' => ['required', 'array:id,event_date_id,schedule,service,description,stock,price'],
+            'stock_adjustment_id' => ['nullable', 'uuid'],
+            'variants.*' => ['required', 'array:id,event_date_id,schedule,service,description,stock,stock_difference,price'],
             'variants.*.id' => ['sometimes', 'nullable', 'integer', 'distinct'],
             'variants.*.event_date_id' => [
                 'required',
@@ -32,7 +33,8 @@ class UpsertFoodVariantsRequest extends FormRequest
             'variants.*.schedule' => ['required', 'string', 'max:255'],
             'variants.*.service' => ['required', 'string', 'max:255'],
             'variants.*.description' => ['sometimes', 'nullable', 'string'],
-            'variants.*.stock' => ['required', 'integer', 'min:0'],
+            'variants.*.stock' => ['sometimes', 'integer', 'min:0'],
+            'variants.*.stock_difference' => ['sometimes', 'integer'],
             'variants.*.price' => ['required', 'numeric', 'min:0', 'max:99999999.99'],
         ];
     }
@@ -49,6 +51,20 @@ class UpsertFoodVariantsRequest extends FormRequest
                         continue;
                     }
 
+                    if (isset($variant['id']) && ! array_key_exists('stock_difference', $variant)) {
+                        $validator->errors()->add(
+                            "variants.{$index}.stock_difference",
+                            'La diferencia de stock es obligatoria al actualizar una variante.',
+                        );
+                    }
+
+                    if (! isset($variant['id']) && ! array_key_exists('stock', $variant)) {
+                        $validator->errors()->add(
+                            "variants.{$index}.stock",
+                            'El stock inicial es obligatorio al crear una variante.',
+                        );
+                    }
+
                     $key = implode('|', [
                         $variant['event_date_id'] ?? '',
                         mb_strtolower(trim((string) ($variant['schedule'] ?? ''))),

app/Domains/Ticketing/FiestaFutbolInfantil/Requests/UpsertMerchandiseRequest.php

@@ -4,6 +4,7 @@ namespace App\Domains\Ticketing\FiestaFutbolInfantil\Requests;
 
 use Illuminate\Foundation\Http\FormRequest;
 use Illuminate\Validation\Rule;
+use Illuminate\Validation\Validator;
 
 class UpsertMerchandiseRequest extends FormRequest
 {
@@ -39,12 +40,49 @@ class UpsertMerchandiseRequest extends FormRequest
             'items.*.description' => ['sometimes', 'nullable', 'string'],
             'items.*.max_units_per_user' => ['required', 'integer', 'min:1'],
             'items.*.variants' => ['required', 'array', 'min:1', 'max:500'],
-            'items.*.variants.*' => ['required', 'array:id,color,size,stock,price'],
+            'stock_adjustment_id' => ['nullable', 'uuid'],
+            'items.*.variants.*' => ['required', 'array:id,color,size,stock,stock_difference,price'],
             'items.*.variants.*.id' => ['sometimes', 'nullable', 'integer', 'distinct'],
             'items.*.variants.*.color' => ['required', 'string', 'max:255'],
             'items.*.variants.*.size' => ['required', 'string', 'max:255'],
-            'items.*.variants.*.stock' => ['required', 'integer', 'min:0'],
+            'items.*.variants.*.stock' => ['sometimes', 'integer', 'min:0'],
+            'items.*.variants.*.stock_difference' => ['sometimes', 'integer'],
             'items.*.variants.*.price' => ['required', 'numeric', 'min:0', 'max:99999999.99'],
         ];
     }
+
+    /** @return array<int, callable> */
+    public function after(): array
+    {
+        return [
+            function (Validator $validator): void {
+                foreach ($this->input('items', []) as $itemIndex => $item) {
+                    if (! is_array($item)) {
+                        continue;
+                    }
+
+                    foreach ($item['variants'] ?? [] as $variantIndex => $variant) {
+                        if (! is_array($variant)) {
+                            continue;
+                        }
+
+                        $prefix = "items.{$itemIndex}.variants.{$variantIndex}";
+                        if (isset($variant['id']) && ! array_key_exists('stock_difference', $variant)) {
+                            $validator->errors()->add(
+                                "{$prefix}.stock_difference",
+                                'La diferencia de stock es obligatoria al actualizar una variante.',
+                            );
+                        }
+
+                        if (! isset($variant['id']) && ! array_key_exists('stock', $variant)) {
+                            $validator->errors()->add(
+                                "{$prefix}.stock",
+                                'El stock inicial es obligatorio al crear una variante.',
+                            );
+                        }
+                    }
+                }
+            },
+        ];
+    }
 }

app/Domains/Ticketing/FiestaFutbolInfantil/Resources/AccommodationResource.php

@@ -37,7 +37,7 @@ class AccommodationResource extends JsonResource
                     'title' => $options->get($value)?->label ?? $value,
                     'value' => $value,
                     'description' => $variant->descripcion,
-                    'stock' => $variant->inventory->real_stock,
+                    'stock' => $variant->inventory->availableStock(),
                     'price' => number_format($variant->getPrice(), 2, '.', ''),
                 ];
             })->values(),

app/Domains/Ticketing/FiestaFutbolInfantil/Resources/EntryResource.php

@@ -33,7 +33,7 @@ class EntryResource extends JsonResource
             'title' => $this->nombre,
             'description' => $this->descripcion,
             'event_date_ids' => $variant->selectedEventDates()->pluck('id')->values(),
-            'stock' => $variant->inventory->real_stock,
+            'stock' => $variant->inventory->availableStock(),
             'price' => $this->precio,
         ];
     }

app/Domains/Ticketing/FiestaFutbolInfantil/Resources/FoodResource.php

@@ -81,7 +81,7 @@ class FoodResource extends JsonResource
             'schedule' => $values->get('horario'),
             'service' => $values->get('servicio'),
             'description' => $variant->descripcion,
-            'stock' => $variant->inventory->real_stock,
+            'stock' => $variant->inventory->availableStock(),
             'price' => number_format($variant->getPrice(), 2, '.', ''),
         ];
     }

app/Domains/Ticketing/FiestaFutbolInfantil/Resources/MerchandiseResource.php

@@ -44,7 +44,7 @@ class MerchandiseResource extends JsonResource
                     'color_value' => $colorValue,
                     'size' => $sizeOptions->get($sizeValue)?->label ?? $sizeValue,
                     'size_value' => $sizeValue,
-                    'stock' => $variant->inventory->real_stock,
+                    'stock' => $variant->inventory->availableStock(),
                     'price' => number_format($variant->getPrice(), 2, '.', ''),
                 ];
             })->values(),

app/Domains/Ticketing/FiestaFutbolInfantil/Services/AccommodationService.php

@@ -39,9 +39,9 @@ class AccommodationService
     /**
      * @param  array<int, array<string, mixed>>  $variants
      */
-    public function upsertMany(Tenant $tenant, array $variants): CatalogItem
+    public function upsertMany(Tenant $tenant, array $variants, ?string $stockAdjustmentId = null): CatalogItem
     {
-        return DB::transaction(function () use ($tenant, $variants): CatalogItem {
+        return DB::transaction(function () use ($tenant, $variants, $stockAdjustmentId): CatalogItem {
             $attribute = $this->attribute($tenant);
             $accommodation = $this->accommodation($tenant, $variants);
             $itemAttribute = $accommodation->itemAttributes()->firstOrCreate(
@@ -70,7 +70,7 @@ class AccommodationService
                 if ($variant === null) {
                     $this->createVariant($attribute, $accommodation, $itemAttribute, $data);
                 } else {
-                    $this->updateVariant($attribute, $variant, $itemAttribute, $data, $index);
+                    $this->updateVariant($attribute, $variant, $itemAttribute, $data, $index, $stockAdjustmentId);
                 }
             }
 
@@ -169,7 +169,7 @@ class AccommodationService
             'title' => trim($variant['title']),
             'value' => $this->valueCode($variant['title']),
             'description' => $variant['description'] ?? null,
-            'stock' => (int) $variant['stock'],
+            ...(array_key_exists('stock', $variant) ? ['stock' => (int) $variant['stock']] : []),
         ])->all();
     }
 
@@ -212,6 +212,7 @@ class AccommodationService
         $this->createOption($attribute, $data['value'], $data['title']);
 
         $inventory = Inventory::query()->create(['real_stock' => $data['stock']]);
+        $inventory->recordInitialization();
         $variant = $accommodation->variants()->create([
             'inventory_id' => $inventory->id,
             'descripcion' => $data['description'],
@@ -230,20 +231,13 @@ class AccommodationService
         ItemAttribute $itemAttribute,
         array $data,
         int $index,
+        ?string $stockAdjustmentId,
     ): void {
         $inventory = Inventory::query()
             ->whereKey($variant->inventory_id)
             ->lockForUpdate()
             ->firstOrFail();
 
-        if ($data['stock'] < $inventory->reserved_stock) {
-            throw ValidationException::withMessages([
-                "variants.{$index}.stock" => [
-                    'El stock no puede ser menor que la cantidad actualmente reservada.',
-                ],
-            ]);
-        }
-
         $definition = $variant->definitions
             ->firstWhere('item_attribute_id', $itemAttribute->id);
         $option = $definition === null
@@ -263,7 +257,10 @@ class AccommodationService
             'descripcion' => $data['description'],
             'precio' => $data['price'],
         ]);
-        $inventory->update(['real_stock' => $data['stock']]);
+        $inventory->adjustAvailableStock(
+            (int) $data['stock_difference'],
+            idempotencyKey: $stockAdjustmentId,
+        );
         $variant->definitions()->updateOrCreate(
             ['item_attribute_id' => $itemAttribute->id],
             ['value' => $data['value']],

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

@@ -43,18 +43,18 @@ class EntryService
      * @param  array<int, array<string, mixed>>  $entries
      * @return Collection<int, CatalogItem>
      */
-    public function upsertMany(Tenant $tenant, array $entries): Collection
+    public function upsertMany(Tenant $tenant, array $entries, ?string $stockAdjustmentId = null): Collection
     {
-        return DB::transaction(function () use ($tenant, $entries): Collection {
+        return DB::transaction(function () use ($tenant, $entries, $stockAdjustmentId): Collection {
             $reservedSlugs = [];
             $category = Category::query()->firstOrCreate([
                 'tenant_code' => $tenant->codigo,
                 'nombre' => 'Entradas',
             ]);
 
-            return collect($entries)->map(function (array $entry, int $index) use ($tenant, $category, &$reservedSlugs): CatalogItem {
+            return collect($entries)->map(function (array $entry, int $index) use ($tenant, $category, $stockAdjustmentId, &$reservedSlugs): CatalogItem {
                 if (isset($entry['id'])) {
-                    return $this->update($tenant, $category, $entry, $index);
+                    return $this->update($tenant, $category, $entry, $index, $stockAdjustmentId);
                 }
 
                 $slug = $this->uniqueSlug($tenant, $entry['title'], $reservedSlugs);
@@ -92,7 +92,7 @@ class EntryService
     }
 
     /** @param array<string, mixed> $entry */
-    private function update(Tenant $tenant, Category $category, array $entry, int $index): CatalogItem
+    private function update(Tenant $tenant, Category $category, array $entry, int $index, ?string $stockAdjustmentId): CatalogItem
     {
         $catalogItem = CatalogItem::query()
             ->whereKey($entry['id'])
@@ -121,14 +121,6 @@ class EntryService
             ->lockForUpdate()
             ->firstOrFail();
 
-        if ((int) $entry['stock'] < $inventory->reserved_stock) {
-            throw ValidationException::withMessages([
-                "entries.{$index}.stock" => [
-                    'El stock no puede ser menor que la cantidad actualmente reservada.',
-                ],
-            ]);
-        }
-
         $eventDateIds = collect($entry['event_date_ids'])
             ->map(fn ($id): int => (int) $id)
             ->unique()
@@ -149,7 +141,10 @@ class EntryService
         $catalogItem->itemAttributes()
             ->whereHas('attribute', fn ($query) => $query->where('codigo', 'event_date'))
             ->update(['allow_multi_select' => true]);
-        $inventory->update(['real_stock' => $entry['stock']]);
+        $inventory->adjustAvailableStock(
+            (int) $entry['stock_difference'],
+            idempotencyKey: $stockAdjustmentId,
+        );
 
         return $catalogItem->load([
             'variants.inventory',

app/Domains/Ticketing/FiestaFutbolInfantil/Services/FoodService.php

@@ -11,9 +11,9 @@ use App\Domains\Commerce\Catalog\Models\Inventory;
 use App\Domains\Commerce\Catalog\Models\ItemAttribute;
 use App\Domains\Commerce\Catalog\Models\Variant;
 use App\Domains\Commerce\Catalog\Services\CatalogService;
+use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Event\Enums\EventDateStatus;
 use App\Domains\Ticketing\Event\Models\EventDate;
-use App\Domains\Core\Tenant\Models\Tenant;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Validation\ValidationException;
@@ -50,9 +50,9 @@ class FoodService
     /**
      * @param  array<int, array<string, mixed>>  $variants
      */
-    public function upsertMany(Tenant $tenant, array $variants): CatalogItem
+    public function upsertMany(Tenant $tenant, array $variants, ?string $stockAdjustmentId = null): CatalogItem
     {
-        return DB::transaction(function () use ($tenant, $variants): CatalogItem {
+        return DB::transaction(function () use ($tenant, $variants, $stockAdjustmentId): CatalogItem {
             $attributes = $this->attributes($tenant);
             $food = $this->food($tenant, $variants);
             $itemAttributes = $this->itemAttributes($food, $attributes);
@@ -85,7 +85,7 @@ class FoodService
                 if ($variant === null) {
                     $this->createVariant($food, $itemAttributes, $data);
                 } else {
-                    $this->updateVariant($variant, $itemAttributes, $data, $index);
+                    $this->updateVariant($variant, $itemAttributes, $data, $index, $stockAdjustmentId);
                 }
             }
 
@@ -113,11 +113,11 @@ class FoodService
     }
 
     /**
-     * @param  array<int, array{id: int, stock: int}>  $variants
+     * @param  array<int, array{id: int, stock_difference: int}>  $variants
      */
-    public function updateHistoricalStock(Tenant $tenant, array $variants): CatalogItem
+    public function updateHistoricalStock(Tenant $tenant, array $variants, ?string $stockAdjustmentId = null): CatalogItem
     {
-        return DB::transaction(function () use ($tenant, $variants): CatalogItem {
+        return DB::transaction(function () use ($tenant, $variants, $stockAdjustmentId): CatalogItem {
             $food = CatalogItem::query()
                 ->forTenantCatalog($tenant)
                 ->where('slug', 'comida')
@@ -142,17 +142,11 @@ class FoodService
                     ]);
                 }
 
-                $stock = (int) $data['stock'];
                 $inventory = $this->inventoryForHistoricalStockUpdate($variant);
-                if ($stock < $inventory->reserved_stock) {
+                $inventory->adjustAvailableStock(
-                    throw ValidationException::withMessages([
+                    (int) $data['stock_difference'],
-                        "variants.{$index}.stock" => [
+                    idempotencyKey: $stockAdjustmentId,
-                            'El stock no puede ser menor que la cantidad actualmente reservada.',
+                );
-                        ],
-                    ]);
-                }
-
-                $inventory->update(['real_stock' => $stock]);
             }
 
             return $this->current($tenant) ?? $food;
@@ -181,6 +175,7 @@ class FoodService
             'reserved_stock' => 0,
             'real_stock' => $inventory->real_stock,
         ]);
+        $historicalInventory->recordTransferInitialization();
         $variant->update(['inventory_id' => $historicalInventory->getKey()]);
 
         return $historicalInventory;
@@ -301,7 +296,7 @@ class FoodService
                 'schedule' => $schedule->value,
                 'service' => $service->value,
                 'description' => (string) ($variant['description'] ?? ''),
-                'stock' => (int) $variant['stock'],
+                ...(array_key_exists('stock', $variant) ? ['stock' => (int) $variant['stock']] : []),
             ];
         })->all();
     }
@@ -384,6 +379,7 @@ class FoodService
     private function createVariant(CatalogItem $food, Collection $itemAttributes, array $data): void
     {
         $inventory = Inventory::query()->create(['real_stock' => $data['stock']]);
+        $inventory->recordInitialization();
         $variant = $food->variants()->create([
             'event_date_id' => $data['event_date_id'],
             'inventory_id' => $inventory->id,
@@ -400,27 +396,23 @@ class FoodService
         Collection $itemAttributes,
         array $data,
         int $index,
+        ?string $stockAdjustmentId,
     ): void {
         $inventory = Inventory::query()
             ->whereKey($variant->inventory_id)
             ->lockForUpdate()
             ->firstOrFail();
 
-        if ($data['stock'] < $inventory->reserved_stock) {
-            throw ValidationException::withMessages([
-                "variants.{$index}.stock" => [
-                    'El stock no puede ser menor que la cantidad actualmente reservada.',
-                ],
-            ]);
-        }
-
         $variant->update([
             'event_date_id' => $data['event_date_id'],
             'descripcion' => $data['description'],
             'precio' => $data['price'],
         ]);
         $variant->eventDates()->sync([$data['event_date_id']]);
-        $inventory->update(['real_stock' => $data['stock']]);
+        $inventory->adjustAvailableStock(
+            (int) $data['stock_difference'],
+            idempotencyKey: $stockAdjustmentId,
+        );
         $this->syncDefinitions($variant, $itemAttributes, $data);
     }
 

app/Domains/Ticketing/FiestaFutbolInfantil/Services/MerchandiseService.php

@@ -43,9 +43,9 @@ class MerchandiseService
      * @param  array<int, array<string, mixed>>  $items
      * @return Collection<int, CatalogItem>
      */
-    public function upsertMany(Tenant $tenant, array $items): Collection
+    public function upsertMany(Tenant $tenant, array $items, ?string $stockAdjustmentId = null): Collection
     {
-        return DB::transaction(function () use ($tenant, $items): Collection {
+        return DB::transaction(function () use ($tenant, $items, $stockAdjustmentId): Collection {
             $attributes = $this->attributes($tenant);
             $category = Category::query()->firstOrCreate([
                 'tenant_code' => $tenant->codigo,
@@ -57,6 +57,7 @@ class MerchandiseService
                 $tenant,
                 $attributes,
                 $category,
+                $stockAdjustmentId,
                 &$reservedSlugs,
             ): CatalogItem {
                 $item = isset($data['id'])
@@ -101,7 +102,7 @@ class MerchandiseService
                     if ($variant === null) {
                         $this->createVariant($item, $itemAttributes, $variantData);
                     } else {
-                        $this->updateVariant($variant, $itemAttributes, $variantData, $index, $variantIndex);
+                        $this->updateVariant($variant, $itemAttributes, $variantData, $index, $variantIndex, $stockAdjustmentId);
                     }
                 }
 
@@ -244,7 +245,7 @@ class MerchandiseService
                 ...$variant,
                 'color' => $color->value,
                 'size' => $size->value,
-                'stock' => (int) $variant['stock'],
+                ...(array_key_exists('stock', $variant) ? ['stock' => (int) $variant['stock']] : []),
             ];
         })->all();
     }
@@ -342,6 +343,7 @@ class MerchandiseService
         array $data,
     ): void {
         $inventory = Inventory::query()->create(['real_stock' => $data['stock']]);
+        $inventory->recordInitialization();
         $variant = $item->variants()->create([
             'inventory_id' => $inventory->id,
             'precio' => $data['price'],
@@ -359,22 +361,18 @@ class MerchandiseService
         array $data,
         int $itemIndex,
         int $variantIndex,
+        ?string $stockAdjustmentId,
     ): void {
         $inventory = Inventory::query()
             ->whereKey($variant->inventory_id)
             ->lockForUpdate()
             ->firstOrFail();
 
-        if ($data['stock'] < $inventory->reserved_stock) {
-            throw ValidationException::withMessages([
-                "items.{$itemIndex}.variants.{$variantIndex}.stock" => [
-                    'El stock no puede ser menor que la cantidad actualmente reservada.',
-                ],
-            ]);
-        }
-
         $variant->update(['precio' => $data['price']]);
-        $inventory->update(['real_stock' => $data['stock']]);
+        $inventory->adjustAvailableStock(
+            (int) $data['stock_difference'],
+            idempotencyKey: $stockAdjustmentId,
+        );
         $this->syncDefinitions($variant, $itemAttributes, $data);
     }
 

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

@@ -19,48 +19,48 @@ Route::prefix('v1/adminapp/tenant')
                 ->middleware("tenant.menu:{$menuCode}");
         };
 
-        $visibilityRoutes('entries', 'entries', 'adminapp.fiesta-futbol-infantil.entradas');
+        $visibilityRoutes('entries', 'entries', 'onticket.adminapp.fiesta-futbol-infantil.entradas');
-        $visibilityRoutes('foods', 'foods', 'adminapp.fiesta-futbol-infantil.comida');
+        $visibilityRoutes('foods', 'foods', 'onticket.adminapp.fiesta-futbol-infantil.comida');
-        $visibilityRoutes('accommodations', 'accommodations', 'adminapp.fiesta-futbol-infantil.alojamientos');
+        $visibilityRoutes('accommodations', 'accommodations', 'onticket.adminapp.fiesta-futbol-infantil.alojamientos');
-        $visibilityRoutes('merchandise', 'merchandise', 'adminapp.fiesta-futbol-infantil.merchandising');
+        $visibilityRoutes('merchandise', 'merchandise', 'onticket.adminapp.fiesta-futbol-infantil.merchandising');
 
         Route::get('entries', [EntryController::class, 'index'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.entradas')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.entradas')
             ->name('adminapp.fiesta-futbol-infantil.entries.index');
         Route::post('entries', [EntryController::class, 'store'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.entradas')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.entradas')
             ->name('adminapp.fiesta-futbol-infantil.entries.store');
         Route::delete('entries/{entry}', [EntryController::class, 'destroy'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.entradas')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.entradas')
             ->name('adminapp.fiesta-futbol-infantil.entries.destroy');
         Route::get('foods', [FoodController::class, 'index'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.comida')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.comida')
             ->name('adminapp.fiesta-futbol-infantil.foods.index');
         Route::post('foods', [FoodController::class, 'store'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.comida')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.comida')
             ->name('adminapp.fiesta-futbol-infantil.foods.store');
         Route::patch('foods/history-stock', [FoodController::class, 'updateHistoricalStock'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.comida')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.comida')
             ->name('adminapp.fiesta-futbol-infantil.foods.history-stock.update');
         Route::delete('foods/{food}', [FoodController::class, 'destroy'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.comida')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.comida')
             ->name('adminapp.fiesta-futbol-infantil.foods.destroy');
         Route::get('accommodations', [AccommodationController::class, 'index'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.alojamientos')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.alojamientos')
             ->name('adminapp.fiesta-futbol-infantil.accommodations.index');
         Route::post('accommodations', [AccommodationController::class, 'store'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.alojamientos')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.alojamientos')
             ->name('adminapp.fiesta-futbol-infantil.accommodations.store');
         Route::delete('accommodations/{accommodation}', [AccommodationController::class, 'destroy'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.alojamientos')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.alojamientos')
             ->name('adminapp.fiesta-futbol-infantil.accommodations.destroy');
         Route::get('merchandise', [MerchandiseController::class, 'index'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.merchandising')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.merchandising')
             ->name('adminapp.fiesta-futbol-infantil.merchandise.index');
         Route::post('merchandise', [MerchandiseController::class, 'store'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.merchandising')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.merchandising')
             ->name('adminapp.fiesta-futbol-infantil.merchandise.store');
         Route::delete('merchandise/{merchandise}', [MerchandiseController::class, 'destroy'])
-            ->middleware('tenant.menu:adminapp.fiesta-futbol-infantil.merchandising')
+            ->middleware('tenant.menu:onticket.adminapp.fiesta-futbol-infantil.merchandising')
             ->name('adminapp.fiesta-futbol-infantil.merchandise.destroy');
     });

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

@@ -6,31 +6,47 @@ use App\Domains\Core\Tenant\Models\Tenant;
 use App\Domains\Ticketing\Ticket\Exceptions\TicketNotAvailableException;
 use App\Domains\Ticketing\Ticket\Models\Ticket;
 use App\Domains\Ticketing\Ticket\Requests\DownloadTicketsPdfRequest;
+use App\Domains\Ticketing\Ticket\Requests\ListTicketsRequest;
+use App\Domains\Ticketing\Ticket\Resources\TicketEventResource;
 use App\Domains\Ticketing\Ticket\Resources\TicketResource;
 use App\Domains\Ticketing\Ticket\Services\TicketPdfService;
 use App\Domains\Ticketing\Ticket\Services\TicketPresentationResolver;
 use App\Domains\Ticketing\Ticket\Services\TicketValidityResolver;
+use App\Domains\Ticketing\Ticket\Services\UserTicketQueryService;
 use App\Http\Controllers\Controller;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
 use Illuminate\Http\Response;
 
 class TicketController extends Controller
 {
-    public function __construct(private readonly TicketPdfService $ticketPdfService) {}
+    public function __construct(
+        private readonly TicketPdfService $ticketPdfService,
+        private readonly UserTicketQueryService $userTickets,
+    ) {}
 
-    public function index(Request $request, Tenant $tenant): JsonResponse
+    public function index(ListTicketsRequest $request, Tenant $tenant): JsonResponse
     {
-        $tickets = Ticket::query()
+        $eventId = $request->validated('event_id');
-            ->where('tenant_code', $tenant->codigo)
+        $tickets = $this->userTickets->tickets(
-            ->where('user_id', $request->user()->getKey())
+            $tenant,
-            ->with([...TicketValidityResolver::RELATIONS, ...TicketPresentationResolver::RELATIONS])
+            $request->user(),
-            ->orderByDesc('id')
+            $eventId === null ? null : (int) $eventId,
-            ->get();
+        );
 
         return TicketResource::collection($tickets)->response();
     }
 
+    public function events(Request $request, Tenant $tenant): AnonymousResourceCollection
+    {
+        abort_unless($tenant->storefront_website_type_code === 'onticket_multi_event', 404);
+
+        return TicketEventResource::collection(
+            $this->userTickets->events($tenant, $request->user())
+        );
+    }
+
     public function downloadPdf(DownloadTicketsPdfRequest $request, Tenant $tenant): Response
     {
         $ticketIds = $request->validated('ticket_ids');

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

@@ -2,16 +2,18 @@
 
 namespace App\Domains\Ticketing\Ticket\Models;
 
-use App\Domains\Core\Auth\Models\User;
 use App\Domains\Commerce\Catalog\Models\CatalogItem;
 use App\Domains\Commerce\Catalog\Models\Variant;
-use App\Shared\Logging\Models\Concerns\LogsValueChanges;
 use App\Domains\Commerce\Purchase\Models\PurchaseItem;
+use App\Domains\Core\Auth\Models\User;
 use App\Domains\Core\Tenant\Models\Tenant;
+use App\Domains\Ticketing\Desfile\Models\EntryReservation;
+use App\Domains\Ticketing\Event\Models\Event;
 use App\Domains\Ticketing\Ticket\Services\ResolvedTicketValidity;
 use App\Domains\Ticketing\Ticket\Services\ResolvedValidityGroup;
 use App\Domains\Ticketing\Ticket\Services\TicketPresentationResolver;
 use App\Domains\Ticketing\Ticket\Services\TicketValidityResolver;
+use App\Shared\Logging\Models\Concerns\LogsValueChanges;
 use Carbon\CarbonInterface;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -24,6 +26,7 @@ use Illuminate\Validation\ValidationException;
 
 #[Fillable([
     'tenant_code',
+    'event_id',
     'ticket',
     'source_purchase_item_id',
     'source_catalog_item_id',
@@ -75,6 +78,7 @@ class Ticket extends Model
     protected function casts(): array
     {
         return [
+            'event_id' => 'integer',
             'source_catalog_item_id' => 'integer',
             'source_variant_id' => 'integer',
             'source_purchase_item_id' => 'integer',
@@ -136,6 +140,12 @@ class Ticket extends Model
         return $this->belongsTo(Tenant::class, 'tenant_code', 'codigo');
     }
 
+    /** @return BelongsTo<Event, $this> */
+    public function event(): BelongsTo
+    {
+        return $this->belongsTo(Event::class);
+    }
+
     public function allow_refund(): bool
     {
         return $this->tenant?->allow_refund() ?? false;
@@ -183,7 +193,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
@@ -226,6 +238,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
     {
@@ -238,6 +256,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/Models/ValidityTime.php

@@ -47,30 +47,42 @@ class ValidityTime extends Model
 
     public function startsAt(
         ?CarbonInterface $at = null,
+        string $timezone = 'UTC',
     ): ?CarbonInterface {
         if ($this->type === ValidityTimeType::FixedWindow) {
             return $this->fixed_starts_at;
         }
 
-        return $this->atCurrentDate($this->start_time, $at);
+        return $this->atCurrentDate($this->start_time, $at, $timezone);
     }
 
     public function expiresAt(
         ?CarbonInterface $at = null,
+        string $timezone = 'UTC',
     ): ?CarbonInterface {
         if ($this->type === ValidityTimeType::FixedWindow) {
             return $this->fixed_expires_at;
         }
 
-        return $this->atCurrentDate($this->end_time, $at);
+        return $this->atCurrentDate($this->end_time, $at, $timezone);
     }
 
     public function isValid(
         ?CarbonInterface $at = null,
+        string $timezone = 'UTC',
     ): bool {
         $at ??= now();
-        $startsAt = $this->startsAt($at);
+        $startsAt = $this->startsAt($at, $timezone);
-        $expiresAt = $this->expiresAt($at);
+        $expiresAt = $this->expiresAt($at, $timezone);
+
+        if ($this->type === ValidityTimeType::TimeWindow
+            && $startsAt !== null && $expiresAt !== null && $expiresAt->lessThanOrEqualTo($startsAt)) {
+            if ($at->lessThan($expiresAt)) {
+                $startsAt = $startsAt->subDay();
+            } else {
+                $expiresAt = $expiresAt->addDay();
+            }
+        }
 
         return ($startsAt === null || $startsAt->lessThanOrEqualTo($at))
             && ($expiresAt === null || $expiresAt->greaterThan($at));
@@ -79,6 +91,7 @@ class ValidityTime extends Model
     private function atCurrentDate(
         ?string $time,
         ?CarbonInterface $at,
+        string $timezone,
     ): ?CarbonInterface {
         if ($time === null) {
             return null;
@@ -86,8 +99,9 @@ class ValidityTime extends Model
 
         $at ??= now();
         $localDate = CarbonImmutable::instance($at)
+            ->setTimezone($timezone)
             ->format('Y-m-d');
 
-        return CarbonImmutable::parse($localDate.' '.$time);
+        return CarbonImmutable::parse($localDate.' '.$time, $timezone);
     }
 }

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/ListTicketsRequest.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Requests;
+
+use App\Domains\Core\Tenant\Models\Tenant;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class ListTicketsRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /** @return array<string, mixed> */
+    public function rules(): array
+    {
+        /** @var Tenant $tenant */
+        $tenant = $this->route('tenant');
+
+        return [
+            'event_id' => [
+                'sometimes',
+                'integer',
+                Rule::exists('events', 'id')->where('tenant_code', $tenant->codigo),
+            ],
+        ];
+    }
+}

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

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Resources;
+
+use App\Domains\Ticketing\Event\Models\Event;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+/** @mixin Event */
+class TicketEventResource extends JsonResource
+{
+    /** @return array<string, mixed> */
+    public function toArray(Request $request): array
+    {
+        return [
+            'id' => $this->id,
+            'title' => $this->title,
+            'image' => $this->attachment?->getTemporaryUrl(1440),
+        ];
+    }
+}

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

@@ -15,6 +15,7 @@ class TicketResource extends JsonResource
         return [
             'id' => $this->id,
             'tenant_code' => $this->tenant_code,
+            'event_id' => $this->event_id,
             'ticket' => $this->ticket,
             'status' => $this->status,
             'status_label' => $this->status_label,

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

@@ -10,6 +10,11 @@ use Illuminate\Http\Resources\Json\JsonResource;
 /** @mixin ValidityTime */
 class ValidityTimeResource extends JsonResource
 {
+    public function __construct($resource, private readonly string $timezone = 'UTC')
+    {
+        parent::__construct($resource);
+    }
+
     /** @return array<string, mixed> */
     public function toArray(Request $request): array
     {
@@ -27,7 +32,7 @@ class ValidityTimeResource extends JsonResource
         return [
             'id' => $this->id,
             'type' => $this->type->value,
-            'is_valid' => $this->isValid(),
+            'is_valid' => $this->isValid(timezone: $this->timezone),
             ...array_filter($fields, fn (mixed $value): bool => $value !== null),
         ];
     }

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
+            'product' => $this->productName($ticket, $purchaseItem?->item_nombre, $variantProperties),
-                ?? $ticket->sourceCatalogItem?->nombre
+            'amount' => $purchaseItem?->precio_unitario ?? $ticket->entryReservation?->importe,
-                ?? $ticket->name,
-            'amount' => $purchaseItem?->precio_unitario,
             '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,
     ) {}
@@ -226,13 +228,13 @@ class AdminAppTicketService
                 'amount' => number_format($refundAmount, 2, '.', ''),
             ]);
 
-            $this->restoreInventory($ticket, $purchaseItem);
+            $this->restoreInventory($ticket, $purchaseItem, $createdBy);
 
             return $ticket->refresh()->load(self::RELATIONS);
         });
     }
 
-    private function restoreInventory(Ticket $ticket, PurchaseItem $purchaseItem): void
+    private function restoreInventory(Ticket $ticket, PurchaseItem $purchaseItem, ?User $createdBy): void
     {
         $catalogItem = $ticket->sourceCatalogItem;
         if ($catalogItem === null) {
@@ -270,11 +272,7 @@ class AdminAppTicketService
             throw ValidationException::withMessages(['ticket' => 'No se encontró el inventario del ticket.']);
         }
 
-        if ($catalogItem->inventory_policy === InventoryPolicy::Tracked) {
+        $inventory->refundStock(1, $createdBy);
-            $inventory->real_stock++;
-        }
-        $inventory->refunded_units++;
-        $inventory->save();
     }
 
     private function refundedAmountForPurchaseItem(PurchaseItem $purchaseItem): float
@@ -347,6 +345,13 @@ 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;
     }
 

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

@@ -2,6 +2,7 @@
 
 namespace App\Domains\Ticketing\Ticket\Services;
 
+use App\Domains\Commerce\Catalog\Models\Inventory;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Log;
 use RuntimeException;
@@ -64,14 +65,9 @@ class BackfillRefundedUnitsService
                 }, 'refunds.id', 'id');
 
             foreach ($counts as $inventoryId => $count) {
-                $updates = ['refunded_units' => DB::raw('refunded_units + '.$count['refunded'])];
+                $inventory = Inventory::query()->lockForUpdate()->find($inventoryId)
-                if (($count['stock'] ?? 0) > 0) {
+                    ?? throw new RuntimeException("No se encontró el inventario {$inventoryId} para reponerlo.");
-                    $updates['real_stock'] = DB::raw('real_stock + '.$count['stock']);
+                $inventory->refundStock($count['refunded']);
-                }
-
-                if (DB::table('inventories')->where('id', $inventoryId)->update($updates) !== 1) {
-                    throw new RuntimeException("No se encontró el inventario {$inventoryId} para reponerlo.");
-                }
             }
 
             $refundedUnitsAdded = array_sum(array_column($counts, 'refunded'));
@@ -82,7 +78,8 @@ class BackfillRefundedUnitsService
                 'bundles_skipped' => $bundlesSkipped,
                 'inventories_updated' => count($counts),
                 'refunded_units_added' => $refundedUnitsAdded,
-                'real_stock_added' => array_sum(array_column($counts, 'stock')),
+                'real_stock_added' => 0,
+                'available_stock_added' => $refundedUnitsAdded,
             ];
         });
 

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

@@ -0,0 +1,65 @@
+<?php
+
+namespace App\Domains\Ticketing\Ticket\Services;
+
+use Carbon\CarbonImmutable;
+use DateTimeZone;
+use Illuminate\Support\Facades\DB;
+use InvalidArgumentException;
+
+class ConvertValidityTimesToUtcService
+{
+    /**
+     * @param  array<int, int>  $ids
+     * @return array<int, array<string, mixed>>
+     */
+    public function run(array $ids, string $timezone, bool $apply = false, bool $all = false, bool $reverse = false): array
+    {
+        if (! in_array($timezone, DateTimeZone::listIdentifiers(DateTimeZone::ALL_WITH_BC), true)) {
+            throw new InvalidArgumentException('Zona horaria inválida.');
+        }
+        if ($all === ($ids !== [])) {
+            throw new InvalidArgumentException('Indicar --all o --ids, exclusivamente una opción.');
+        }
+
+        return DB::transaction(function () use ($ids, $timezone, $apply, $all, $reverse): array {
+            $query = DB::table('validity_times')->orderBy('id');
+            $all ? $query->where('type', 'fixed_window') : $query->whereIn('id', $ids);
+            if ($apply) {
+                $query->lockForUpdate();
+            }
+            $rows = $query->get();
+            if (! $all && $rows->count() !== count(array_unique($ids))) {
+                throw new InvalidArgumentException('Uno o más IDs no existen.');
+            }
+            if ($rows->contains(fn ($row): bool => $row->type !== 'fixed_window')) {
+                throw new InvalidArgumentException('Sólo se admiten IDs de fixed_window.');
+            }
+            $source = $reverse ? 'UTC' : $timezone;
+            $target = $reverse ? $timezone : 'UTC';
+            $result = [];
+            foreach ($rows as $row) {
+                $convert = fn (?string $value): ?string => $value === null
+                    ? null
+                    : CarbonImmutable::parse($value, $source)->setTimezone($target)->format('Y-m-d H:i:s');
+                $start = $convert($row->fixed_starts_at);
+                $end = $convert($row->fixed_expires_at);
+                $result[] = [
+                    'id' => $row->id,
+                    'original_start' => $row->fixed_starts_at,
+                    'original_end' => $row->fixed_expires_at,
+                    'result_start' => $start,
+                    'result_end' => $end,
+                ];
+                if ($apply) {
+                    DB::table('validity_times')->where('id', $row->id)->update([
+                        'fixed_starts_at' => $start,
+                        'fixed_expires_at' => $end,
+                    ]);
+                }
+            }
+
+            return $result;
+        });
+    }
+}