feat(sale): implement modifications filtering and validation for admin sales

commit 6ae625d4fdc11989950ef0678db62fdb52be7c8c
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Sep 2 09:46:18 2026 -0300

    refactor(tickets): enhance search functionality for tickets by client names and formatted amounts

commit 098e525d32be9cb6487bc01a3d120aa0f2386a15
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Sep 2 09:09:30 2026 -0300

    fix(tickets): protect referenced purchase items

commit 210db17f2f6a6a4a509297b773a2b5d3e3149a3d
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Sep 2 08:59:24 2026 -0300

    test(tickets): cover purchase item references

commit 6a004713c4bad622dfa5e26394458925db1cb5a7
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Sep 2 08:59:02 2026 -0300

    refactor(tickets): reference purchase items directly

app/Domains/Desfile/Services/InvitationPurchaseProvisioner.php

@@ -5,6 +5,7 @@ namespace App\Domains\Desfile\Services;
 use DateTimeInterface;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Facades\Schema;
 use Illuminate\Support\Str;
 use RuntimeException;
 
@@ -58,7 +59,7 @@ class InvitationPurchaseProvisioner
                         $allocation['type'],
                     );
 
-                    $this->createPurchaseItem(
+                    $purchaseItemId = $this->createPurchaseItem(
                         $purchaseId,
                         $catalogItem,
                         $variant,
@@ -70,6 +71,7 @@ class InvitationPurchaseProvisioner
                     );
                     $this->createTicketAndCommitStock(
                         $purchaseId,
+                        $purchaseItemId,
                         $userId,
                         (int) $catalogItem->id,
                         $variant,
@@ -326,12 +328,13 @@ class InvitationPurchaseProvisioner
         int $seat,
         string $type,
         DateTimeInterface $now,
-    ): void {
+    ): int {
-        if (DB::table('compra_items')
+        $existingId = DB::table('compra_items')
             ->where('compra_id', $purchaseId)
             ->where('source_variant_id', $variant->id)
-            ->exists()) {
+            ->value('id');
-            return;
+        if ($existingId !== null) {
+            return (int) $existingId;
         }
 
         $attributes = [
@@ -341,7 +344,7 @@ class InvitationPurchaseProvisioner
             ['name' => 'Asiento', 'value' => (string) $seat],
         ];
 
-        DB::table('compra_items')->insert([
+        return DB::table('compra_items')->insertGetId([
             'compra_id' => $purchaseId,
             'source_catalog_item_id' => $catalogItem->id,
             'source_variant_id' => $variant->id,
@@ -367,13 +370,18 @@ class InvitationPurchaseProvisioner
 
     private function createTicketAndCommitStock(
         int $purchaseId,
+        int $purchaseItemId,
         int $userId,
         int $catalogItemId,
         object $variant,
         DateTimeInterface $now,
     ): void {
+        $purchaseReference = Schema::hasColumn('tickets', 'source_purchase_item_id')
+            ? ['source_purchase_item_id' => $purchaseItemId]
+            : ['source_purchase_id' => $purchaseId];
+
         if (DB::table('tickets')
-            ->where('source_purchase_id', $purchaseId)
+            ->where($purchaseReference)
             ->where('source_variant_id', $variant->id)
             ->exists()) {
             return;
@@ -420,7 +428,7 @@ class InvitationPurchaseProvisioner
             'ticket' => (string) Str::uuid(),
             'name' => null,
             'description' => null,
-            'source_purchase_id' => $purchaseId,
+            ...$purchaseReference,
             'source_catalog_item_id' => $catalogItemId,
             'source_variant_id' => $variant->id,
             'used_at' => null,

app/Domains/Forms/Services/SaleFormService.php

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

app/Domains/Notification/Services/NotificationMailService.php

@@ -138,8 +138,7 @@ class NotificationMailService
             }
 
             /** @var Collection<int, Ticket> $tickets */
-            $tickets = Ticket::query()
+            $tickets = $purchase->tickets()
-                ->where('source_purchase_id', $purchase->getKey())
                 ->where('tenant_code', $purchase->tenant_codigo)
                 ->with(TicketPresentationResolver::RELATIONS)
                 ->get();

app/Domains/Purchase/Models/Purchase.php

@@ -14,6 +14,7 @@ use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\HasManyThrough;
 use Illuminate\Database\Eloquent\Relations\HasOne;
 use Illuminate\Support\Facades\DB;
 
@@ -51,6 +52,14 @@ class Purchase extends Model
 
     public const STATUS_SUPERSEDED = 'superseded';
 
+    public const ADMIN_STATUS_INCOMPLETE = 'incomplete';
+
+    public const ADMIN_STATUS_AWAITING_PAYMENT = 'awaiting_payment';
+
+    public const ADMIN_STATUS_CONFIRMED = 'confirmed';
+
+    public const ADMIN_STATUS_CANCELLED = 'cancelled';
+
     /** @return list<string> */
     public static function statuses(): array
     {
@@ -66,6 +75,68 @@ class Purchase extends Model
         ];
     }
 
+    /**
+     * @return array<string, array{name: string, statuses: list<string>}>
+     */
+    public static function adminStatuses(): array
+    {
+        return [
+            self::ADMIN_STATUS_INCOMPLETE => [
+                'name' => 'Por completar datos',
+                'statuses' => [self::STATUS_CREATED],
+            ],
+            self::ADMIN_STATUS_AWAITING_PAYMENT => [
+                'name' => 'Esperando pago',
+                'statuses' => [self::STATUS_PENDING_PAYMENT, self::STATUS_IN_REVIEW],
+            ],
+            self::ADMIN_STATUS_CONFIRMED => [
+                'name' => 'Confirmado',
+                'statuses' => [self::STATUS_PAID],
+            ],
+            self::ADMIN_STATUS_CANCELLED => [
+                'name' => 'Anulado',
+                'statuses' => [
+                    self::STATUS_CANCELLED,
+                    self::STATUS_REJECTED,
+                    self::STATUS_EXPIRED,
+                    self::STATUS_SUPERSEDED,
+                ],
+            ],
+        ];
+    }
+
+    /** @return list<string> */
+    public static function adminStatusCodes(): array
+    {
+        return array_keys(self::adminStatuses());
+    }
+
+    /** @return list<string> */
+    public static function realStatusesForAdminStatus(string $adminStatus): array
+    {
+        return self::adminStatuses()[$adminStatus]['statuses'] ?? [];
+    }
+
+    public static function adminStatusFor(string $realStatus): ?string
+    {
+        foreach (self::adminStatuses() as $adminStatus => $definition) {
+            if (in_array($realStatus, $definition['statuses'], true)) {
+                return $adminStatus;
+            }
+        }
+
+        return null;
+    }
+
+    public static function adminStatusNameFor(string $realStatus): ?string
+    {
+        $adminStatus = self::adminStatusFor($realStatus);
+
+        return $adminStatus === null
+            ? null
+            : self::adminStatuses()[$adminStatus]['name'];
+    }
+
     protected $table = 'compras';
 
     /** @var array<int, string> */
@@ -115,12 +186,15 @@ class Purchase extends Model
         return $this->hasMany(PurchaseItem::class, 'compra_id');
     }
 
-    /**
+    /** @return HasManyThrough<Ticket, PurchaseItem, $this> */
-     * @return HasMany<Ticket, $this>
+    public function tickets(): HasManyThrough
-     */
-    public function tickets(): HasMany
     {
-        return $this->hasMany(Ticket::class, 'source_purchase_id');
+        return $this->hasManyThrough(
+            Ticket::class,
+            PurchaseItem::class,
+            'compra_id',
+            'source_purchase_item_id',
+        );
     }
 
     /** @return BelongsTo<StockReservation, $this> */

app/Domains/Purchase/Models/PurchaseItem.php

@@ -5,10 +5,12 @@ namespace App\Domains\Purchase\Models;
 use App\Domains\Attachable\Models\Attachment;
 use App\Domains\Catalog\Models\CatalogItem;
 use App\Domains\Catalog\Models\Variant;
+use App\Domains\Ticket\Models\Ticket;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 
 #[Fillable([
     'compra_id',
@@ -56,6 +58,12 @@ class PurchaseItem extends Model
         return $this->belongsTo(Purchase::class, 'compra_id');
     }
 
+    /** @return HasMany<Ticket, $this> */
+    public function tickets(): HasMany
+    {
+        return $this->hasMany(Ticket::class, 'source_purchase_item_id');
+    }
+
     /** @return BelongsTo<Attachment, $this> */
     public function imageAttachment(): BelongsTo
     {

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

@@ -43,6 +43,11 @@ class ReleaseCheckoutService
         ): Purchase {
             $purchase = $this->lockPurchase($purchase);
 
+            if ($purchase->status === Purchase::STATUS_EXPIRED
+                && $targetStatus === Purchase::STATUS_CANCELLED) {
+                return $this->loadPurchase($purchase);
+            }
+
             if ($purchase->status === Purchase::STATUS_EXPIRED
                 && $targetStatus !== Purchase::STATUS_EXPIRED) {
                 throw new PurchaseExpiredException;
@@ -72,6 +77,14 @@ class ReleaseCheckoutService
 
             $cart = $purchase->cart()->withTrashed()->lockForUpdate()->first();
 
+            // Leaving checkout is allowed at the exact instant the reservation
+            // expires. Finish the expiration while holding the purchase lock so
+            // the request is idempotent with the scheduled expiration job.
+            if ($targetStatus === Purchase::STATUS_CANCELLED
+                && $this->hasOverdueActiveReservation($purchase)) {
+                $targetStatus = Purchase::STATUS_EXPIRED;
+            }
+
             if ($targetStatus === Purchase::STATUS_CANCELLED
                 && $cart?->status === 'active'
                 && in_array($purchase->status, [

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

@@ -3,6 +3,7 @@
 namespace App\Domains\Sale\Controllers\AdminApp;
 
 use App\Domains\Sale\Requests\AdminAppSaleIndexRequest;
+use App\Domains\Sale\Requests\AdminAppSaleModificationIndexRequest;
 use App\Domains\Sale\Requests\AdminAppSaleModificationPdfRequest;
 use App\Domains\Sale\Requests\AdminAppSalePdfRequest;
 use App\Domains\Sale\Resources\AdminApp\SaleDetailResource;
@@ -67,11 +68,13 @@ class SaleController extends Controller
         return new SaleResource($this->saleService->cancel($tenant, $sale));
     }
 
-    public function modifications(Request $request): AnonymousResourceCollection
+    public function modifications(
-    {
+        AdminAppSaleModificationIndexRequest $request,
+    ): AnonymousResourceCollection {
         return SaleModificationResource::collection(
             $this->saleService->modifications(
-                $request->user()->tenant()->firstOrFail()
+                $request->user()->tenant()->firstOrFail(),
+                $request->validated(),
             )
         );
     }
@@ -93,7 +96,7 @@ class SaleController extends Controller
 
         return $this->salePdfService->downloadModifications(
             $tenant,
-            $this->saleService->modificationsForExport($tenant),
+            $this->saleService->modificationsForExport($tenant, $request->validated()),
             $request->validated('timezone'),
         );
     }
@@ -116,7 +119,7 @@ class SaleController extends Controller
 
         return $this->saleExcelService->downloadModifications(
             $tenant,
-            $this->saleService->modificationsForExport($tenant),
+            $this->saleService->modificationsForExport($tenant, $request->validated()),
             $request->validated('timezone'),
         );
     }

app/Domains/Sale/Requests/AdminAppSaleIndexRequest.php

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

app/Domains/Sale/Requests/AdminAppSaleModificationIndexRequest.php

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

app/Domains/Sale/Requests/AdminAppSaleModificationPdfRequest.php

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

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

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

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

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

app/Domains/Sale/Services/AdminAppSaleExcelService.php

@@ -201,11 +201,6 @@ class AdminAppSaleExcelService
 
     private function saleStatus(string $status): string
     {
-        return match ($status) {
+        return Purchase::adminStatusNameFor($status) ?? $status;
-            Purchase::STATUS_PAID => 'Confirmado',
-            Purchase::STATUS_CREATED => 'Por completar datos',
-            Purchase::STATUS_PENDING_PAYMENT, Purchase::STATUS_IN_REVIEW => 'Esperando pago',
-            default => 'Anulado',
-        };
     }
 }

app/Domains/Sale/Services/AdminAppSaleService.php

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

app/Domains/Sale/documentacion/README.md

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

app/Domains/Ticket/Listeners/GenerateTicketsForPaidPurchase.php

@@ -42,7 +42,7 @@ class GenerateTicketsForPaidPurchase
                 $user,
                 $purchaseItem->cantidad,
                 $purchaseItem->source_variant_id,
-                $purchase->getKey(),
+                $purchaseItem->getKey(),
             );
         }
     }

app/Domains/Ticket/Models/Ticket.php

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

app/Domains/Ticket/Services/AdminAppTicketRowService.php

@@ -3,7 +3,6 @@
 namespace App\Domains\Ticket\Services;
 
 use App\Domains\Catalog\Models\ItemAttribute;
-use App\Domains\Purchase\Models\PurchaseItem;
 use App\Domains\Ticket\Models\Ticket;
 use Illuminate\Support\Collection;
 
@@ -23,16 +22,16 @@ class AdminAppTicketRowService
     /** @return array<string, mixed> */
     public function details(Ticket $ticket): array
     {
-        $purchaseItem = $this->sourcePurchaseItem($ticket);
+        $purchaseItem = $ticket->sourcePurchaseItem;
 
         return [
-            'source_purchase_id' => $ticket->source_purchase_id,
+            'source_purchase_item_id' => $ticket->source_purchase_item_id,
-            'order_number' => $ticket->source_purchase_id,
+            'order_number' => $purchaseItem?->compra_id,
             'product' => $purchaseItem?->item_nombre
                 ?? $ticket->sourceCatalogItem?->nombre
                 ?? $ticket->name,
             'amount' => $purchaseItem?->precio_unitario,
-            'client' => $ticket->sourcePurchase?->nombre_apellido ?? $ticket->user?->nombre_apellido,
+            'client' => $purchaseItem?->purchase?->nombre_apellido ?? $ticket->user?->nombre_apellido,
             'status' => $ticket->status,
             'scanned_by' => $ticket->scannerUser?->nombre_apellido,
             'variant_properties' => $this->variantProperties($ticket),
@@ -175,18 +174,6 @@ class AdminAppTicketRowService
             ->implode(', ');
     }
 
-    private function sourcePurchaseItem(Ticket $ticket): ?PurchaseItem
-    {
-        return $ticket->sourcePurchase?->items->first(function (PurchaseItem $item) use ($ticket): bool {
-            if ($ticket->source_variant_id !== null) {
-                return $item->source_variant_id === $ticket->source_variant_id;
-            }
-
-            return $item->source_catalog_item_id === $ticket->source_catalog_item_id
-                && $item->source_variant_id === null;
-        });
-    }
-
     /** @return list<array{code: string, label: string, values: list<array{value: string, label: string}>}> */
     private function variantProperties(Ticket $ticket): array
     {

app/Domains/Ticket/Services/AdminAppTicketService.php

@@ -18,7 +18,7 @@ class AdminAppTicketService
         'user',
         'scannerUser',
         'sourceCatalogItem.category',
-        'sourcePurchase.items',
+        'sourcePurchaseItem.purchase',
     ];
 
     public function __construct(
@@ -86,13 +86,7 @@ class AdminAppTicketService
         $query = Ticket::query()
             ->where('tenant_code', $tenant->codigo)
             ->when($search !== '', function (Builder $query) use ($search): void {
-                $query->when(
+                $this->applySearchFilter($query, $search);
-                    ctype_digit($search),
-                    fn (Builder $searchQuery): Builder => $searchQuery
-                        ->where('tickets.id', (int) $search),
-                    fn (Builder $searchQuery): Builder => $searchQuery
-                        ->where('ticket', 'like', "%{$search}%"),
-                );
             })
             ->when($filters['category'] ?? null, function (Builder $query, string $category): void {
                 $query->whereHas('sourceCatalogItem.category', fn (Builder $categoryQuery): Builder => $categoryQuery
@@ -111,7 +105,7 @@ class AdminAppTicketService
                     return;
                 }
 
-                $query->whereHas('sourcePurchase', fn (Builder $purchaseQuery): Builder => $purchaseQuery
+                $query->whereHas('sourcePurchaseItem.purchase', fn (Builder $purchaseQuery): Builder => $purchaseQuery
                     ->whereDate('created_at', $date));
             })
             ->when($filters['size'] ?? null, function (Builder $query, string $size) use ($filters): void {
@@ -123,6 +117,67 @@ class AdminAppTicketService
         return $query;
     }
 
+    /** @param Builder<Ticket> $query */
+    private function applySearchFilter(Builder $query, string $search): void
+    {
+        $containsPattern = '%'.mb_strtolower($search).'%';
+        $amount = $this->searchAmount($search);
+
+        $query->where(function (Builder $searchQuery) use ($search, $containsPattern, $amount): void {
+            $searchQuery
+                ->where(function (Builder $clientQuery) use ($containsPattern): void {
+                    $clientQuery
+                        ->whereHas('sourcePurchaseItem.purchase', fn (Builder $purchaseQuery): Builder => $purchaseQuery
+                            ->whereRaw('LOWER(nombre_apellido) LIKE ?', [$containsPattern]))
+                        ->orWhere(function (Builder $fallbackClientQuery) use ($containsPattern): void {
+                            $fallbackClientQuery
+                                ->where(function (Builder $missingPurchaseClientQuery): void {
+                                    $missingPurchaseClientQuery
+                                        ->whereDoesntHave('sourcePurchaseItem.purchase')
+                                        ->orWhereHas('sourcePurchaseItem.purchase', fn (Builder $purchaseQuery): Builder => $purchaseQuery
+                                            ->whereNull('nombre_apellido'));
+                                })
+                                ->whereHas('user', fn (Builder $userQuery): Builder => $userQuery
+                                    ->whereRaw('LOWER(nombre_apellido) LIKE ?', [$containsPattern]));
+                        });
+                })
+                ->orWhereHas('scannerUser', fn (Builder $scannerQuery): Builder => $scannerQuery
+                    ->whereRaw('LOWER(nombre_apellido) LIKE ?', [$containsPattern]));
+
+            if (ctype_digit($search)) {
+                $searchQuery
+                    ->orWhere('tickets.id', (int) $search)
+                    ->orWhereHas('sourcePurchaseItem', fn (Builder $purchaseItemQuery): Builder => $purchaseItemQuery
+                        ->where('compra_id', (int) $search));
+            }
+
+            if ($amount !== null) {
+                $searchQuery->orWhereHas('sourcePurchaseItem', fn (Builder $purchaseItemQuery): Builder => $purchaseItemQuery
+                    ->where('precio_unitario', $amount));
+            }
+        });
+    }
+
+    private function searchAmount(string $search): ?string
+    {
+        $value = preg_replace('/[\s$]/u', '', trim($search));
+        if ($value === null || $value === '') {
+            return null;
+        }
+
+        if (preg_match('/^\d{1,3}(?:\.\d{3})+(?:,\d{1,2})?$/', $value) === 1) {
+            $value = str_replace(['.', ','], ['', '.'], $value);
+        } elseif (preg_match('/^\d{1,3}(?:,\d{3})+(?:\.\d{1,2})?$/', $value) === 1) {
+            $value = str_replace(',', '', $value);
+        } elseif (preg_match('/^\d+(?:[.,]\d{1,2})?$/', $value) === 1) {
+            $value = str_replace(',', '.', $value);
+        } else {
+            return null;
+        }
+
+        return number_format((float) $value, 2, '.', '');
+    }
+
     /** @param Builder<Ticket> $query */
     private function applyProductFilter(Builder $query, string $category, string $product): void
     {
@@ -234,15 +289,15 @@ class AdminAppTicketService
         $direction = ($filters['sort_direction'] ?? 'asc') === 'desc' ? 'desc' : 'asc';
 
         $sortExpression = match ($sortBy) {
-            'order_number' => 'tickets.source_purchase_id',
+            'order_number' => $this->purchaseItemColumnQuery('compra_id'),
             'id' => 'tickets.id',
-            'amount' => $this->purchaseItemSortQuery('precio_unitario'),
+            'amount' => $this->purchaseItemColumnQuery('precio_unitario'),
             'scanned_by' => User::query()
                 ->select('nombre_apellido')
                 ->whereColumn('users.id', 'tickets.scanner_user_id'),
             'product' => $tenant->codigo === 'fiesta_futbol_infantil'
                 ? null
-                : $this->purchaseItemSortQuery('item_nombre'),
+                : $this->purchaseItemColumnQuery('item_nombre'),
             default => null,
         };
 
@@ -256,25 +311,11 @@ class AdminAppTicketService
     }
 
     /** @return Builder<PurchaseItem> */
-    private function purchaseItemSortQuery(string $column): Builder
+    private function purchaseItemColumnQuery(string $column): Builder
     {
         return PurchaseItem::query()
             ->select($column)
-            ->whereColumn('compra_items.compra_id', 'tickets.source_purchase_id')
+            ->whereColumn('compra_items.id', 'tickets.source_purchase_item_id')
-            ->where(function (Builder $query): void {
-                $query
-                    ->where(function (Builder $variantQuery): void {
-                        $variantQuery
-                            ->whereNotNull('tickets.source_variant_id')
-                            ->whereColumn('compra_items.source_variant_id', 'tickets.source_variant_id');
-                    })
-                    ->orWhere(function (Builder $itemQuery): void {
-                        $itemQuery
-                            ->whereNull('tickets.source_variant_id')
-                            ->whereNull('compra_items.source_variant_id')
-                            ->whereColumn('compra_items.source_catalog_item_id', 'tickets.source_catalog_item_id');
-                    });
-            })
             ->limit(1);
     }
 

app/Domains/Ticket/Services/TicketGeneratorService.php

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

app/Domains/Ticket/documentacion/README.md

@@ -6,7 +6,8 @@ Genera, valida, consulta y exporta entradas asociadas a compras pagadas de produ
 
 ## Modelo
 
-- `Ticket`: pertenece a tenant y usuario, y conserva referencias a compra, producto, variante y usuario escáner.
+- `Ticket`: pertenece a tenant y usuario, y conserva referencias al ítem de compra que lo generó, producto,
+  variante y usuario escáner. La compra se obtiene a través de su ítem.
 - El nombre y la descripción se calculan dinámicamente desde el producto y la variante; los tickets no
   persisten una copia de esos textos.
 - `ValidityTime`: define ventanas absolutas o relativas de vigencia para fechas de evento y opciones de atributos.

database/migrations/2026_09_02_000000_add_source_purchase_item_id_to_tickets.php

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

database/migrations/2026_09_02_010000_remove_source_purchase_id_from_tickets.php

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

database/migrations/2026_09_02_020000_restrict_deletion_of_purchase_items_with_tickets.php

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

resources/views/pdf/adminapp/sales.blade.php

@@ -47,11 +47,7 @@
                     <td>{{ $sale->created_at?->copy()->timezone($timeZone)->format('d/m/Y H:i') ?? '-' }}</td>
                     <td>{{ $sale->nombre_apellido ?: 'Sin nombre' }}</td>
                     <td class="center">{{ (int) ($sale->quantity ?? 0) }}</td>
-                    <td>{{ match ($sale->status) {
+                    <td>{{ \App\Domains\Purchase\Models\Purchase::adminStatusNameFor($sale->status) ?? $sale->status }}</td>
-                        'paid' => 'Confirmado',
-                        'created', 'pending_payment' => 'Esperando pago',
-                        default => 'Anulado',
-                    } }}</td>
                     <td class="number">${{ number_format((float) $sale->total, 2, ',', '.') }}</td>
                     <td class="center">{{ (int) ($sale->tickets_count ?? 0) }}</td>
                 </tr>

tests/Feature/Forms/AdminAppSaleFormControllerTest.php

@@ -2,6 +2,8 @@
 
 namespace Tests\Feature\Forms;
 
+use App\Domains\Attachable\Enums\AttachmentType;
+use App\Domains\Attachable\Models\Attachment;
 use App\Domains\Auth\Models\User;
 use App\Domains\Authorization\Enums\RoleCode;
 use App\Domains\Purchase\Models\Purchase;
@@ -34,12 +36,7 @@ class AdminAppSaleFormControllerTest extends TestCase
 
     public function test_an_adminapp_user_can_get_the_sale_form(): void
     {
-        $tenant = Tenant::query()->create([
+        $tenant = $this->createTenant('acme');
-            'codigo' => 'acme',
-            'nombre' => 'Acme',
-            'dominio' => 'acme.test',
-            'website_type_code' => 'onticket',
-        ]);
         Sanctum::actingAs(User::factory()->create([
             'rol_codigo' => RoleCode::AdminApp->value,
             'tenant_codigo' => $tenant->codigo,
@@ -47,13 +44,15 @@ class AdminAppSaleFormControllerTest extends TestCase
 
         $this->getJson('/api/v1/adminapp/forms/sale')
             ->assertOk()
-            ->assertJsonCount(count(Purchase::statuses()), 'data.statuses')
+            ->assertJsonCount(count(Purchase::adminStatusCodes()), 'data.statuses')
-            ->assertJsonPath('data.statuses.0.code', Purchase::STATUS_CREATED)
+            ->assertJsonPath('data.statuses.0.value', Purchase::ADMIN_STATUS_INCOMPLETE)
-            ->assertJsonPath('data.statuses.0.name', 'Creada')
+            ->assertJsonPath('data.statuses.0.label', 'Por completar datos')
-            ->assertJsonPath('data.statuses.1.code', Purchase::STATUS_PENDING_PAYMENT)
+            ->assertJsonPath('data.statuses.0.real_statuses.0', Purchase::STATUS_CREATED)
-            ->assertJsonPath('data.statuses.2.code', Purchase::STATUS_IN_REVIEW)
+            ->assertJsonPath('data.statuses.1.value', Purchase::ADMIN_STATUS_AWAITING_PAYMENT)
-            ->assertJsonPath('data.statuses.3.code', Purchase::STATUS_PAID)
+            ->assertJsonPath('data.statuses.1.real_statuses.0', Purchase::STATUS_PENDING_PAYMENT)
-            ->assertJsonPath('data.statuses.6.code', Purchase::STATUS_EXPIRED);
+            ->assertJsonPath('data.statuses.1.real_statuses.1', Purchase::STATUS_IN_REVIEW)
+            ->assertJsonPath('data.statuses.2.value', Purchase::ADMIN_STATUS_CONFIRMED)
+            ->assertJsonPath('data.statuses.3.value', Purchase::ADMIN_STATUS_CANCELLED);
     }
 
     public function test_a_customer_cannot_get_the_sale_form(): void
@@ -65,4 +64,34 @@ class AdminAppSaleFormControllerTest extends TestCase
 
         $this->getJson('/api/v1/adminapp/forms/sale')->assertForbidden();
     }
+
+    private function createTenant(string $code): Tenant
+    {
+        $headerLogo = $this->createAttachment("{$code}-header");
+        $footerLogo = $this->createAttachment("{$code}-footer");
+
+        return Tenant::query()->create([
+            'codigo' => $code,
+            'nombre' => ucfirst($code),
+            'dominio' => "{$code}.test",
+            'primary_color' => '#000000',
+            'secondary_color' => '#ffffff',
+            'danger_color' => '#dc3545',
+            'header_bg_color' => '#ffffff',
+            'footer_bg_color' => '#000000',
+            'header_logo_id' => $headerLogo->id,
+            'footer_logo_id' => $footerLogo->id,
+            'website_type_code' => 'onticket',
+        ]);
+    }
+
+    private function createAttachment(string $name): Attachment
+    {
+        return Attachment::query()->create([
+            'path' => "test/{$name}.png",
+            'filename' => "{$name}.png",
+            'type' => AttachmentType::Image,
+            'mime_type' => 'image/png',
+        ]);
+    }
 }

tests/Feature/Notification/NotificationMailServiceTest.php

@@ -161,7 +161,7 @@ class NotificationMailServiceTest extends TestCase
             'precio' => 25,
             'has_tickets' => true,
         ]);
-        $purchase->items()->create([
+        $purchaseItem = $purchase->items()->create([
             'source_catalog_item_id' => $catalogItem->id,
             'nombre' => 'Entrada',
             'descripcion' => 'Entrada general',
@@ -175,7 +175,7 @@ class NotificationMailServiceTest extends TestCase
         $ticket = Ticket::query()->create([
             'tenant_code' => $this->tenant->codigo,
             'ticket' => fake()->uuid(),
-            'source_purchase_id' => $purchase->id,
+            'source_purchase_item_id' => $purchaseItem->id,
             'source_catalog_item_id' => $catalogItem->id,
             'user_id' => $this->user->id,
         ]);

tests/Feature/Purchase/StorePurchaseTest.php

@@ -10,6 +10,7 @@ use App\Domains\Catalog\Enums\InventoryPolicy;
 use App\Domains\Catalog\Models\CatalogItem;
 use App\Domains\Catalog\Models\Category;
 use App\Domains\Catalog\Models\Inventory;
+use App\Domains\Catalog\Models\StockReservation;
 use App\Domains\Catalog\Models\Variant;
 use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Purchase\Services\CheckoutService;
@@ -714,11 +715,11 @@ class StorePurchaseTest extends TestCase
 
         $this->actingAs($user, 'sanctum')
             ->postJson("/api/tenants/sonder/compras/{$purchase->id}/cancel")
-            ->assertUnprocessable()
+            ->assertOk()
-            ->assertJsonPath('code', 'purchase.expired');
+            ->assertJsonPath('data.status', Purchase::STATUS_EXPIRED);
     }
 
-    public function test_an_overdue_purchase_cannot_be_cancelled_before_the_expiration_job_runs(): void
+    public function test_leaving_an_overdue_purchase_expires_it_before_the_expiration_job_runs(): void
     {
         $this->createTenant('sonder', 'Sonder', 'sonder.com.ar');
         $user = User::factory()->create();
@@ -728,20 +729,17 @@ class StorePurchaseTest extends TestCase
 
         $this->actingAs($user, 'sanctum')
             ->postJson("/api/tenants/sonder/compras/{$purchase->id}/cancel")
-            ->assertUnprocessable()
+            ->assertOk()
-            ->assertExactJson([
+            ->assertJsonPath('data.status', Purchase::STATUS_EXPIRED);
-                'code' => 'stock_reservation.expired',
-                'message' => __('api.cart.reservation_expired'),
-            ]);
 
         $this->assertDatabaseHas('compras', [
             'id' => $purchase->id,
-            'status' => Purchase::STATUS_CREATED,
+            'status' => Purchase::STATUS_EXPIRED,
             'stock_reservation_id' => $purchase->stock_reservation_id,
         ]);
         $this->assertDatabaseHas('stock_reservations', [
             'id' => $purchase->stock_reservation_id,
-            'status' => 'active',
+            'status' => StockReservation::STATUS_EXPIRED,
         ]);
     }
 

tests/Feature/Sale/AdminAppSaleControllerTest.php

@@ -2,6 +2,8 @@
 
 namespace Tests\Feature\Sale;
 
+use App\Domains\Attachable\Enums\AttachmentType;
+use App\Domains\Attachable\Models\Attachment;
 use App\Domains\Auth\Models\User;
 use App\Domains\Authorization\Enums\RoleCode;
 use App\Domains\Cart\Models\Cart;
@@ -9,6 +11,8 @@ use App\Domains\Cart\Models\CartItem;
 use App\Domains\Catalog\Models\CatalogItem;
 use App\Domains\Catalog\Models\Inventory;
 use App\Domains\Catalog\Models\Variant;
+use App\Domains\Logging\Enums\ValueChangeActorType;
+use App\Domains\Logging\Models\ValueChange;
 use App\Domains\Purchase\Events\PurchasePaid;
 use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Purchase\Models\PurchaseItem;
@@ -34,6 +38,96 @@ class AdminAppSaleControllerTest extends TestCase
         WebsiteType::query()->create(['codigo' => 'onticket', 'nombre' => 'OnTicket']);
     }
 
+    public function test_sale_modifications_use_sale_filters_and_resulting_status(): void
+    {
+        $tenant = $this->createTenant('acme');
+        $otherTenant = $this->createTenant('other');
+        $admin = $this->createAdminAppUser($tenant);
+        Sanctum::actingAs($admin);
+
+        $sale = Purchase::query()->create([
+            'tenant_codigo' => $tenant->codigo,
+            'nombre_apellido' => 'Ana Pérez',
+            'status' => Purchase::STATUS_CANCELLED,
+            'total' => '10000.00',
+        ]);
+        Purchase::query()->whereKey($sale->id)->update([
+            'created_at' => '2026-08-04 10:00:00',
+        ]);
+
+        $otherSale = Purchase::query()->create([
+            'tenant_codigo' => $tenant->codigo,
+            'nombre_apellido' => 'Otro cliente',
+            'status' => Purchase::STATUS_PAID,
+            'total' => '20000.00',
+        ]);
+        Purchase::query()->whereKey($otherSale->id)->update([
+            'created_at' => '2026-08-05 10:00:00',
+        ]);
+
+        $confirmedChange = ValueChange::query()->create([
+            'tenant_code' => $tenant->codigo,
+            'trackable_type' => $sale->getMorphClass(),
+            'trackable_id' => $sale->id,
+            'attribute' => 'status',
+            'old_value' => Purchase::STATUS_PENDING_PAYMENT,
+            'new_value' => Purchase::STATUS_PAID,
+            'changed_at' => '2026-08-06 10:00:00',
+            'actor_type' => ValueChangeActorType::User,
+            'user_id' => $admin->id,
+        ]);
+        ValueChange::query()->create([
+            'tenant_code' => $tenant->codigo,
+            'trackable_type' => $sale->getMorphClass(),
+            'trackable_id' => $sale->id,
+            'attribute' => 'status',
+            'old_value' => Purchase::STATUS_PAID,
+            'new_value' => Purchase::STATUS_CANCELLED,
+            'changed_at' => '2026-08-07 10:00:00',
+            'actor_type' => ValueChangeActorType::User,
+            'user_id' => $admin->id,
+        ]);
+        ValueChange::query()->create([
+            'tenant_code' => $tenant->codigo,
+            'trackable_type' => $otherSale->getMorphClass(),
+            'trackable_id' => $otherSale->id,
+            'attribute' => 'status',
+            'old_value' => Purchase::STATUS_PENDING_PAYMENT,
+            'new_value' => Purchase::STATUS_PAID,
+            'changed_at' => '2026-08-08 10:00:00',
+            'actor_type' => ValueChangeActorType::System,
+        ]);
+        ValueChange::query()->create([
+            'tenant_code' => $otherTenant->codigo,
+            'trackable_type' => $sale->getMorphClass(),
+            'trackable_id' => $sale->id,
+            'attribute' => 'status',
+            'old_value' => Purchase::STATUS_PENDING_PAYMENT,
+            'new_value' => Purchase::STATUS_PAID,
+            'changed_at' => '2026-08-09 10:00:00',
+            'actor_type' => ValueChangeActorType::System,
+        ]);
+
+        $this->getJson('/api/v1/adminapp/tenant/sales/modifications?'.http_build_query([
+            'q' => 'Ana',
+            'id' => $sale->id,
+            'sale_date' => '2026-08-04',
+            'status' => Purchase::ADMIN_STATUS_CONFIRMED,
+        ]))
+            ->assertOk()
+            ->assertJsonCount(1, 'data')
+            ->assertJsonPath('data.0.id', $confirmedChange->id)
+            ->assertJsonPath('data.0.new_value', Purchase::STATUS_PAID)
+            ->assertJsonPath('data.0.admin_status', Purchase::ADMIN_STATUS_CONFIRMED);
+
+        $this->getJson('/api/v1/adminapp/tenant/sales/modifications?status='.
+            Purchase::ADMIN_STATUS_CANCELLED)
+            ->assertOk()
+            ->assertJsonCount(1, 'data')
+            ->assertJsonPath('data.0.sale_id', $sale->id)
+            ->assertJsonPath('data.0.new_value', Purchase::STATUS_CANCELLED);
+    }
+
     public function test_sales_list_uses_purchase_item_snapshots_for_every_status(): void
     {
         $tenant = $this->createTenant('acme');
@@ -64,6 +158,7 @@ class AdminAppSaleControllerTest extends TestCase
         PurchaseItem::query()->create([
             'compra_id' => $createdPurchase->id,
             'source_catalog_item_id' => $catalogItem->id,
+            'nombre' => $catalogItem->nombre,
             'item_nombre' => $catalogItem->nombre,
             'cantidad' => 3,
             'precio_unitario' => '10000.00',
@@ -88,6 +183,7 @@ class AdminAppSaleControllerTest extends TestCase
         PurchaseItem::query()->create([
             'compra_id' => $pendingPurchase->id,
             'source_catalog_item_id' => $catalogItem->id,
+            'nombre' => $catalogItem->nombre,
             'item_nombre' => $catalogItem->nombre,
             'cantidad' => 4,
             'precio_unitario' => '10000.00',
@@ -102,6 +198,7 @@ class AdminAppSaleControllerTest extends TestCase
         PurchaseItem::query()->create([
             'compra_id' => $paidPurchase->id,
             'source_catalog_item_id' => $catalogItem->id,
+            'nombre' => $catalogItem->nombre,
             'item_nombre' => $catalogItem->nombre,
             'cantidad' => 2,
             'precio_unitario' => '10000.00',
@@ -116,6 +213,7 @@ class AdminAppSaleControllerTest extends TestCase
         PurchaseItem::query()->create([
             'compra_id' => $supersededPurchase->id,
             'source_catalog_item_id' => $catalogItem->id,
+            'nombre' => $catalogItem->nombre,
             'item_nombre' => $catalogItem->nombre,
             'cantidad' => 5,
             'precio_unitario' => '10000.00',
@@ -124,17 +222,25 @@ class AdminAppSaleControllerTest extends TestCase
 
         $this->getJson('/api/v1/adminapp/tenant/sales?sort_by=id&sort_direction=asc')
             ->assertOk()
-            ->assertJsonCount(3, 'data')
+            ->assertJsonCount(4, 'data')
             ->assertJsonPath('data.0.id', $createdPurchase->id)
             ->assertJsonPath('data.0.quantity', 3)
+            ->assertJsonPath('data.0.admin_status', Purchase::ADMIN_STATUS_INCOMPLETE)
+            ->assertJsonPath('data.0.status_label', 'Por completar datos')
             ->assertJsonPath('data.1.id', $pendingPurchase->id)
             ->assertJsonPath('data.1.quantity', 4)
+            ->assertJsonPath('data.1.admin_status', Purchase::ADMIN_STATUS_AWAITING_PAYMENT)
+            ->assertJsonPath('data.1.status_label', 'Esperando pago')
             ->assertJsonPath('data.2.id', $paidPurchase->id)
-            ->assertJsonPath('data.2.quantity', 2);
+            ->assertJsonPath('data.2.quantity', 2)
+            ->assertJsonPath('data.2.admin_status', Purchase::ADMIN_STATUS_CONFIRMED)
+            ->assertJsonPath('data.2.status_label', 'Confirmado')
+            ->assertJsonPath('data.3.id', $supersededPurchase->id)
+            ->assertJsonPath('data.3.admin_status', Purchase::ADMIN_STATUS_CANCELLED)
+            ->assertJsonPath('data.3.status_label', 'Anulado');
 
         $this->getJson('/api/v1/adminapp/tenant/sales?status='.Purchase::STATUS_SUPERSEDED)
-            ->assertOk()
+            ->assertUnprocessable();
-            ->assertJsonCount(0, 'data');
     }
 
     public function test_authentication_is_required_to_read_a_sale_detail(): void
@@ -142,7 +248,7 @@ class AdminAppSaleControllerTest extends TestCase
         $this->getJson('/api/v1/adminapp/tenant/sales/1')->assertUnauthorized();
     }
 
-    public function test_pending_payment_filter_also_returns_purchases_in_review(): void
+    public function test_awaiting_payment_filter_returns_every_mapped_real_status(): void
     {
         $tenant = $this->createTenant('acme');
         Sanctum::actingAs($this->createAdminAppUser($tenant));
@@ -160,13 +266,41 @@ class AdminAppSaleControllerTest extends TestCase
             'status' => Purchase::STATUS_PAID,
         ]);
 
-        $this->getJson('/api/v1/adminapp/tenant/sales?status=pending_payment&sort_by=id&sort_direction=asc')
+        $this->getJson('/api/v1/adminapp/tenant/sales?status=awaiting_payment&sort_by=id&sort_direction=asc')
             ->assertOk()
             ->assertJsonCount(2, 'data')
             ->assertJsonPath('data.0.id', $pendingPurchase->id)
             ->assertJsonPath('data.1.id', $reviewPurchase->id);
     }
 
+    public function test_cancelled_filter_returns_every_visible_mapped_real_status(): void
+    {
+        $tenant = $this->createTenant('acme');
+        Sanctum::actingAs($this->createAdminAppUser($tenant));
+
+        foreach ([
+            Purchase::STATUS_CANCELLED,
+            Purchase::STATUS_REJECTED,
+            Purchase::STATUS_EXPIRED,
+            Purchase::STATUS_SUPERSEDED,
+        ] as $status) {
+            Purchase::query()->create([
+                'tenant_codigo' => $tenant->codigo,
+                'status' => $status,
+            ]);
+        }
+        Purchase::query()->create([
+            'tenant_codigo' => $tenant->codigo,
+            'status' => Purchase::STATUS_PAID,
+        ]);
+
+        $this->getJson('/api/v1/adminapp/tenant/sales?status=cancelled')
+            ->assertOk()
+            ->assertJsonCount(4, 'data')
+            ->assertJsonPath('data.0.admin_status', Purchase::ADMIN_STATUS_CANCELLED)
+            ->assertJsonPath('data.0.status_label', 'Anulado');
+    }
+
     public function test_an_adminapp_user_can_read_a_sale_detail_from_its_tenant(): void
     {
         $tenant = $this->createTenant('acme');
@@ -233,6 +367,7 @@ class AdminAppSaleControllerTest extends TestCase
         $purchaseItem = PurchaseItem::query()->create([
             'compra_id' => $purchase->id,
             'source_catalog_item_id' => $catalogItem->id,
+            'nombre' => $catalogItem->nombre,
             'item_nombre' => $catalogItem->nombre,
             'cantidad' => 2,
             'precio_unitario' => '12500.00',
@@ -336,17 +471,28 @@ class AdminAppSaleControllerTest extends TestCase
             'precio' => 20000,
             'has_tickets' => true,
         ]);
+        $purchaseItem = $purchase->items()->create([
+            'source_catalog_item_id' => $catalogItem->id,
+            'nombre' => $catalogItem->nombre,
+            'descripcion' => $catalogItem->descripcion,
+            'slug' => $catalogItem->slug,
+            'item_nombre' => $catalogItem->nombre,
+            'variant_attributes' => [],
+            'cantidad' => 2,
+            'precio_unitario' => 10000,
+            'total' => 20000,
+        ]);
         $firstTicket = Ticket::query()->create([
             'tenant_code' => $tenant->codigo,
             'ticket' => '11111111-1111-4111-8111-111111111111',
-            'source_purchase_id' => $purchase->id,
+            'source_purchase_item_id' => $purchaseItem->id,
             'source_catalog_item_id' => $catalogItem->id,
             'user_id' => $admin->id,
         ]);
         $usedTicket = Ticket::query()->create([
             'tenant_code' => $tenant->codigo,
             'ticket' => '22222222-2222-4222-8222-222222222222',
-            'source_purchase_id' => $purchase->id,
+            'source_purchase_item_id' => $purchaseItem->id,
             'source_catalog_item_id' => $catalogItem->id,
             'used_at' => now()->subMinute(),
             'user_id' => $admin->id,
@@ -468,6 +614,7 @@ class AdminAppSaleControllerTest extends TestCase
         PurchaseItem::query()->create([
             'compra_id' => $purchase->id,
             'source_catalog_item_id' => $catalogItem->id,
+            'nombre' => $catalogItem->nombre,
             'item_nombre' => $catalogItem->nombre,
             'cantidad' => 2,
             'precio_unitario' => '10000.00',
@@ -563,14 +710,34 @@ class AdminAppSaleControllerTest extends TestCase
 
     private function createTenant(string $code): Tenant
     {
+        $headerLogo = $this->createAttachment("{$code}-header");
+        $footerLogo = $this->createAttachment("{$code}-footer");
+
         return Tenant::query()->create([
             'codigo' => $code,
             'nombre' => ucfirst($code),
             'dominio' => "{$code}.test",
+            'primary_color' => '#000000',
+            'secondary_color' => '#ffffff',
+            'danger_color' => '#dc3545',
+            'header_bg_color' => '#ffffff',
+            'footer_bg_color' => '#000000',
+            'header_logo_id' => $headerLogo->id,
+            'footer_logo_id' => $footerLogo->id,
             'website_type_code' => 'onticket',
         ]);
     }
 
+    private function createAttachment(string $name): Attachment
+    {
+        return Attachment::query()->create([
+            'path' => "test/{$name}.png",
+            'filename' => "{$name}.png",
+            'type' => AttachmentType::Image,
+            'mime_type' => 'image/png',
+        ]);
+    }
+
     private function createAdminAppUser(Tenant $tenant): User
     {
         return User::factory()->create([

tests/Feature/Seeders/DesfilePuraTendenciaSeederTest.php

@@ -297,7 +297,7 @@ class DesfilePuraTendenciaSeederTest extends TestCase
             ->where('total', 0)
             ->count());
         $this->assertSame(49, DB::table('tickets')
-            ->where('source_purchase_id', $purchase->id)
+            ->whereIn('source_purchase_item_id', (clone $items)->pluck('id'))
             ->where('user_id', $user->id)
             ->where('source_catalog_item_id', $catalogItemId)
             ->count());

tests/Feature/Ticket/AdminAppTicketControllerTest.php

@@ -79,7 +79,7 @@ class AdminAppTicketControllerTest extends TestCase
             ->assertJsonPath('meta.total', 1);
     }
 
-    public function test_it_supports_id_and_uuid_search(): void
+    public function test_it_searches_by_id_and_does_not_search_by_uuid(): void
     {
         $tenant = $this->createTenant('fiesta_futbol_infantil');
         $admin = $this->createAdminAppUser($tenant);
@@ -95,9 +95,98 @@ class AdminAppTicketControllerTest extends TestCase
             ->assertJsonPath('data.0.id', $matching->id);
 
         $this->getJson('/api/v1/adminapp/tenant/tickets?q='.substr($matching->ticket, 0, 8))
+            ->assertOk()
+            ->assertJsonCount(0, 'data');
+    }
+
+    public function test_it_searches_by_visible_client_and_scanner_names(): void
+    {
+        $tenant = $this->createTenant('fiesta_futbol_infantil');
+        $admin = $this->createAdminAppUser($tenant);
+        $client = User::factory()->create([
+            'tenant_codigo' => $tenant->codigo,
+            'nombre_apellido' => 'María Cliente',
+        ]);
+        $scanner = $this->createAdminAppUser($tenant);
+        $scanner->update(['nombre_apellido' => 'Carlos Inspector']);
+        $this->grantTicketsMenu($tenant);
+        Sanctum::actingAs($admin);
+
+        $clientTicket = $this->createTicket($tenant, $client);
+        $scannerTicket = $this->createTicket($tenant, $admin, [
+            'scanner_user_id' => $scanner->id,
+            'used_at' => now(),
+        ]);
+        $this->createTicket($tenant, $admin);
+
+        $this->getJson('/api/v1/adminapp/tenant/tickets?'.http_build_query(['q' => 'maría']))
             ->assertOk()
             ->assertJsonCount(1, 'data')
-            ->assertJsonPath('data.0.ticket', $matching->ticket);
+            ->assertJsonPath('data.0.id', $clientTicket->id);
+
+        $this->getJson('/api/v1/adminapp/tenant/tickets?'.http_build_query(['q' => 'INSPECTOR']))
+            ->assertOk()
+            ->assertJsonCount(1, 'data')
+            ->assertJsonPath('data.0.id', $scannerTicket->id);
+    }
+
+    public function test_it_searches_by_order_number_and_formatted_unit_amount(): void
+    {
+        $tenant = $this->createTenant('fiesta_futbol_infantil');
+        $admin = $this->createAdminAppUser($tenant);
+        $this->grantTicketsMenu($tenant);
+        Sanctum::actingAs($admin);
+
+        foreach (range(1, 10) as $number) {
+            $this->createPurchase($tenant, $admin, now()->subMinutes($number)->toDateTimeString());
+        }
+
+        $item = CatalogItem::query()->create([
+            'tenant_code' => $tenant->codigo,
+            'slug' => 'entrada-busqueda',
+            'nombre' => 'Entrada búsqueda',
+            'precio' => '1234.50',
+        ]);
+        $purchase = Purchase::query()->create([
+            'tenant_codigo' => $tenant->codigo,
+            'user_id' => $admin->id,
+            'status' => Purchase::STATUS_PAID,
+            'nombre_apellido' => 'Cliente de la compra',
+            'total' => '1234.50',
+        ]);
+        $purchaseItem = PurchaseItem::query()->create([
+            'compra_id' => $purchase->id,
+            'source_catalog_item_id' => $item->id,
+            'nombre' => $item->nombre,
+            'descripcion' => '',
+            'slug' => $item->slug,
+            'item_nombre' => $item->nombre,
+            'cantidad' => 1,
+            'precio_unitario' => '1234.50',
+            'total' => '1234.50',
+        ]);
+        $matching = $this->createTicket($tenant, $admin, [
+            'source_purchase_item_id' => $purchaseItem->id,
+            'source_catalog_item_id' => $item->id,
+        ]);
+        $this->createTicket($tenant, $admin);
+
+        $this->getJson("/api/v1/adminapp/tenant/tickets?q={$purchase->id}")
+            ->assertOk()
+            ->assertJsonCount(1, 'data')
+            ->assertJsonPath('data.0.id', $matching->id);
+
+        $this->getJson('/api/v1/adminapp/tenant/tickets?'.http_build_query(['q' => 'cliente de la compra']))
+            ->assertOk()
+            ->assertJsonCount(1, 'data')
+            ->assertJsonPath('data.0.id', $matching->id);
+
+        foreach (['1234,50', '$1.234,50', '1,234.50'] as $amount) {
+            $this->getJson('/api/v1/adminapp/tenant/tickets?'.http_build_query(['q' => $amount]))
+                ->assertOk()
+                ->assertJsonCount(1, 'data')
+                ->assertJsonPath('data.0.id', $matching->id);
+        }
     }
 
     public function test_it_sorts_by_ticket_id_before_paginating(): void
@@ -219,7 +308,7 @@ class AdminAppTicketControllerTest extends TestCase
             'nombre_apellido' => 'Nombre Apellido',
             'total' => '8000.00',
         ]);
-        PurchaseItem::query()->create([
+        $purchaseItem = PurchaseItem::query()->create([
             'compra_id' => $purchase->id,
             'source_catalog_item_id' => $item->id,
             'source_variant_id' => $variant->id,
@@ -232,7 +321,7 @@ class AdminAppTicketControllerTest extends TestCase
             'total' => '8000.00',
         ]);
         $ticket = $this->createTicket($tenant, $admin, [
-            'source_purchase_id' => $purchase->id,
+            'source_purchase_item_id' => $purchaseItem->id,
             'source_catalog_item_id' => $item->id,
             'source_variant_id' => $variant->id,
             'scanner_user_id' => $admin->id,
@@ -242,6 +331,7 @@ class AdminAppTicketControllerTest extends TestCase
         $this->getJson('/api/v1/adminapp/tenant/tickets')
             ->assertOk()
             ->assertJsonPath('data.0.id', $ticket->id)
+            ->assertJsonPath('data.0.source_purchase_item_id', $purchaseItem->id)
             ->assertJsonPath('data.0.order_number', $purchase->id)
             ->assertJsonPath('data.0.product', 'Remera')
             ->assertJsonPath('data.0.amount', '8000.00')
@@ -289,20 +379,23 @@ class AdminAppTicketControllerTest extends TestCase
 
         $matchingPurchase = $this->createPurchase($tenant, $admin, '2026-08-20 10:00:00');
         $otherPurchase = $this->createPurchase($tenant, $admin, '2026-08-21 10:00:00');
+        $dinnerItem = $this->createPurchaseItem($matchingPurchase, $food, $dinner);
+        $lunchItem = $this->createPurchaseItem($matchingPurchase, $food, $lunch);
+        $otherDinnerItem = $this->createPurchaseItem($otherPurchase, $food, $otherDinner);
         $matching = $this->createTicket($tenant, $admin, [
-            'source_purchase_id' => $matchingPurchase->id,
+            'source_purchase_item_id' => $dinnerItem->id,
             'source_catalog_item_id' => $food->id,
             'source_variant_id' => $dinner->id,
             'used_at' => now(),
         ]);
         $this->createTicket($tenant, $admin, [
-            'source_purchase_id' => $matchingPurchase->id,
+            'source_purchase_item_id' => $lunchItem->id,
             'source_catalog_item_id' => $food->id,
             'source_variant_id' => $lunch->id,
             'used_at' => now(),
         ]);
         $this->createTicket($tenant, $admin, [
-            'source_purchase_id' => $otherPurchase->id,
+            'source_purchase_item_id' => $otherDinnerItem->id,
             'source_catalog_item_id' => $food->id,
             'source_variant_id' => $otherDinner->id,
             'used_at' => now(),
@@ -494,6 +587,22 @@ class AdminAppTicketControllerTest extends TestCase
         return $purchase;
     }
 
+    private function createPurchaseItem(Purchase $purchase, CatalogItem $item, Variant $variant): PurchaseItem
+    {
+        return $purchase->items()->create([
+            'source_catalog_item_id' => $item->id,
+            'source_variant_id' => $variant->id,
+            'nombre' => $item->nombre,
+            'descripcion' => $item->descripcion,
+            'slug' => $item->slug,
+            'item_nombre' => $item->nombre,
+            'variant_attributes' => [],
+            'cantidad' => 1,
+            'precio_unitario' => 0,
+            'total' => 0,
+        ]);
+    }
+
     private function grantTicketsMenu(Tenant $tenant): void
     {
         $menu = Menu::query()->create([

tests/Feature/Ticket/TicketGeneratorServiceTest.php

@@ -19,6 +19,7 @@ use App\Domains\Ticket\Exceptions\TicketGenerationException;
 use App\Domains\Ticket\Models\ValidityTime;
 use App\Domains\Ticket\Services\TicketGeneratorService;
 use Illuminate\Database\Eloquent\Collection as EloquentCollection;
+use Illuminate\Database\QueryException;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Carbon;
 use Illuminate\Support\Facades\Queue;
@@ -246,14 +247,59 @@ class TicketGeneratorServiceTest extends TestCase
         $purchase = $this->createPurchase($item, 1, $variant->id);
 
         $purchase->markAsPaid();
+        $purchaseItem = $purchase->items()->sole();
 
         $this->assertDatabaseHas('tickets', [
-            'source_purchase_id' => $purchase->id,
+            'source_purchase_item_id' => $purchaseItem->id,
             'source_catalog_item_id' => $item->id,
             'source_variant_id' => $variant->id,
         ]);
     }
 
+    public function test_bundle_tickets_reference_the_purchase_item_that_generated_them(): void
+    {
+        $component = $this->createTicketableItem('bundle-component');
+        $bundle = $this->createBundle('purchased-bundle');
+        $bundle->bundleComponents()->create([
+            'component_catalog_item_id' => $component->id,
+            'quantity' => 2,
+        ]);
+        $purchase = $this->createPurchase($bundle, 2);
+        $purchaseItem = $purchase->items()->sole();
+
+        $purchase->markAsPaid();
+
+        $this->assertCount(4, $purchaseItem->tickets);
+        $this->assertTrue($purchaseItem->tickets->every(
+            fn ($ticket): bool => $ticket->source_purchase_item_id === $purchaseItem->id
+                && $ticket->source_catalog_item_id === $component->id
+        ));
+        $this->assertCount(4, $purchase->tickets);
+    }
+
+    public function test_a_purchase_item_that_generated_tickets_cannot_be_deleted(): void
+    {
+        $item = $this->createTicketableItem('protected-purchase-item');
+        $purchase = $this->createPurchase($item, 1);
+        $purchase->markAsPaid();
+        $purchaseItem = $purchase->items()->sole();
+
+        $this->expectException(QueryException::class);
+
+        $purchaseItem->delete();
+    }
+
+    public function test_a_purchase_with_generated_tickets_cannot_be_deleted(): void
+    {
+        $item = $this->createTicketableItem('protected-purchase');
+        $purchase = $this->createPurchase($item, 1);
+        $purchase->markAsPaid();
+
+        $this->expectException(QueryException::class);
+
+        $purchase->delete();
+    }
+
     public function test_event_date_and_time_window_are_combined_in_the_same_and_group(): void
     {
         $item = $this->createTicketableItem('scheduled-meal');

tests/Unit/Forms/SaleFormServiceTest.php

@@ -8,20 +8,27 @@ use PHPUnit\Framework\TestCase;
 
 class SaleFormServiceTest extends TestCase
 {
-    public function test_it_returns_every_purchase_status_as_a_form_option(): void
+    public function test_it_returns_admin_statuses_with_their_real_statuses(): void
     {
         $form = (new SaleFormService)->get();
 
-        $this->assertSame(Purchase::statuses(), array_column($form['statuses'], 'code'));
+        $this->assertSame(Purchase::adminStatusCodes(), array_column($form['statuses'], 'value'));
         $this->assertSame([
-            'Creada',
+            'Por completar datos',
             'Esperando pago',
-            'En revisión',
+            'Confirmado',
-            'Confirmada',
+            'Anulado',
-            'Cancelada',
+        ], array_column($form['statuses'], 'label'));
-            'Rechazada',
+        $this->assertSame([
-            'Vencida',
+            [Purchase::STATUS_CREATED],
-            'Reemplazada',
+            [Purchase::STATUS_PENDING_PAYMENT, Purchase::STATUS_IN_REVIEW],
-        ], array_column($form['statuses'], 'name'));
+            [Purchase::STATUS_PAID],
+            [
+                Purchase::STATUS_CANCELLED,
+                Purchase::STATUS_REJECTED,
+                Purchase::STATUS_EXPIRED,
+                Purchase::STATUS_SUPERSEDED,
+            ],
+        ], array_column($form['statuses'], 'real_statuses'));
     }
 }

tests/Unit/Purchase/PurchaseAdminStatusTest.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace Tests\Unit\Purchase;
+
+use App\Domains\Purchase\Models\Purchase;
+use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\TestCase;
+
+class PurchaseAdminStatusTest extends TestCase
+{
+    #[DataProvider('statusMappings')]
+    public function test_it_maps_real_statuses_to_admin_statuses(
+        string $realStatus,
+        string $adminStatus,
+        string $adminStatusName,
+    ): void {
+        $this->assertSame($adminStatus, Purchase::adminStatusFor($realStatus));
+        $this->assertSame($adminStatusName, Purchase::adminStatusNameFor($realStatus));
+        $this->assertContains(
+            $realStatus,
+            Purchase::realStatusesForAdminStatus($adminStatus),
+        );
+    }
+
+    /** @return iterable<string, array{string, string, string}> */
+    public static function statusMappings(): iterable
+    {
+        yield 'created' => [
+            Purchase::STATUS_CREATED,
+            Purchase::ADMIN_STATUS_INCOMPLETE,
+            'Por completar datos',
+        ];
+        yield 'pending payment' => [
+            Purchase::STATUS_PENDING_PAYMENT,
+            Purchase::ADMIN_STATUS_AWAITING_PAYMENT,
+            'Esperando pago',
+        ];
+        yield 'in review' => [
+            Purchase::STATUS_IN_REVIEW,
+            Purchase::ADMIN_STATUS_AWAITING_PAYMENT,
+            'Esperando pago',
+        ];
+        yield 'paid' => [
+            Purchase::STATUS_PAID,
+            Purchase::ADMIN_STATUS_CONFIRMED,
+            'Confirmado',
+        ];
+        yield 'cancelled' => [
+            Purchase::STATUS_CANCELLED,
+            Purchase::ADMIN_STATUS_CANCELLED,
+            'Anulado',
+        ];
+        yield 'rejected' => [
+            Purchase::STATUS_REJECTED,
+            Purchase::ADMIN_STATUS_CANCELLED,
+            'Anulado',
+        ];
+        yield 'expired' => [
+            Purchase::STATUS_EXPIRED,
+            Purchase::ADMIN_STATUS_CANCELLED,
+            'Anulado',
+        ];
+        yield 'superseded' => [
+            Purchase::STATUS_SUPERSEDED,
+            Purchase::ADMIN_STATUS_CANCELLED,
+            'Anulado',
+        ];
+    }
+}

tests/Unit/Sale/SaleModificationResourceTest.php

@@ -3,6 +3,7 @@
 namespace Tests\Unit\Sale;
 
 use App\Domains\Logging\Models\ValueChange;
+use App\Domains\Purchase\Models\Purchase;
 use App\Domains\Sale\Resources\AdminApp\SaleModificationResource;
 use Carbon\CarbonImmutable;
 use Illuminate\Http\Request;
@@ -29,5 +30,7 @@ class SaleModificationResourceTest extends TestCase
         $this->assertSame('2026-08-24T17:53:00+00:00', $data['changed_at']);
         $this->assertSame('2026-08-24', $data['date']);
         $this->assertSame('17:53:00', $data['time']);
+        $this->assertSame(Purchase::ADMIN_STATUS_CANCELLED, $data['admin_status']);
+        $this->assertSame('Anulado', $data['status_label']);
     }
 }