30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
# 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.
|