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

1.2 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.
  • AdminAppSaleExcelService: genera descargas Excel 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, GET /sales/pdf y GET /sales/excel.
  • GET /sales/modifications, GET /sales/modifications/pdf y GET /sales/modifications/excel.

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, PDF y Excel.