refactor(ticket): implement fixed validity time generation for event date and time windows in TicketGeneratorService

app/Domains/Purchase/documentacion/README.md

@@ -0,0 +1,33 @@
+# Dominio Purchase
+
+## Propósito
+
+Implementa el ciclo de compra y checkout: crea una compra desde el carrito, toma una instantánea de sus ítems, reserva inventario, permite ediciones, inicia el pago y confirma, cancela o vence la operación.
+
+## Modelo
+
+- `Purchase`: raíz de la compra; estados `created`, `pending_payment`, `paid`, `cancelled`, `rejected` y `expired`.
+- `PurchaseItem`: snapshot del producto o variante, cantidad, precio y total al comprar.
+- `TelepagosQr` y `TelepagosPayment`: datos del QR e intentos/resultados del proveedor.
+- `PurchasePaid`: evento emitido una sola vez al pasar a pagada bajo bloqueo transaccional.
+
+## Servicios de checkout
+
+`CheckoutService` es la fachada estable. Delega en:
+
+- `StartCheckoutService`: inicia la compra desde el carrito.
+- `EditCheckoutService`: modifica cliente o cantidades antes del cierre.
+- `CompleteCheckoutService`: completa, envía a revisión o confirma el pago.
+- `ReleaseCheckoutService`: cancela, vence y procesa vencimientos pendientes.
+- `SourceCartService`: sincroniza, restaura o finaliza el carrito fuente.
+- `CatalogSelectionResolver` y `PurchaseItemSnapshotFactory`: resuelven selecciones y generan snapshots.
+
+`UserPurchaseLimitService` controla límites de compra y `CheckoutService` conserva el punto de entrada para controladores e integraciones.
+
+## Endpoints
+
+Bajo `/tenants/{tenant:codigo}/compras`, con `auth:sanctum`: listado, inicio, detalle, edición de ítems, datos del cliente, intención de pago, finalización, revisión y cancelación.
+
+## Dependencias y reglas
+
+Depende de `Cart`, `Catalog`, `Tenant`, `Auth` e `Integration`; emite eventos consumidos por `Ticket` y `Notification`. Los cambios de estado e inventario deben ser transaccionales y usar los servicios del checkout, no actualizaciones directas del modelo.