Files
shopit-back/app/Domains/Sale/documentacion/README.md

1.1 KiB

Dominio Sale

Propósito

Provee consultas administrativas y exportaciones de ventas confirmadas, además del historial de modificaciones auditadas.

Componentes

  • AdminAppSaleService: pagina ventas, calcula totales y obtiene colecciones para exportación; también consulta modificaciones.
  • AdminAppSalePdfService: genera descargas PDF de ventas y de cambios.
  • AdminAppSaleIndexRequest: valida filtros del listado y la exportación.
  • SaleResource y SaleModificationResource: representan ventas e historial para AdminApp.
  • SaleController: entrada HTTP del panel.

Endpoints

Bajo /v1/adminapp/tenant, protegidos por auth:sanctum y adminapp.tenant:

  • GET /sales y GET /sales/pdf.
  • GET /sales/modifications y GET /sales/modifications/pdf.

Dependencias

Consume compras de Purchase, datos del tenant y entradas de Logging. No es dueño del estado de una compra; cualquier mutación debe ejecutarse en Purchase.

Consideraciones

La consulta paginada y la colección de exportación deben aplicar los mismos filtros para evitar diferencias entre pantalla y PDF.