How sgsanchez/progav-tg1-grupo9 works
Sistema de ventas y facturación expuesto como API REST. El recorrido principal va desde el cliente HTTP, por los controladores y servicios, hasta el registro de ventas con validación de cliente y stock, actualización de inventario y persistencia; las respuestas exponen ventas y comprobantes. También se documentan administración de clientes y productos, consultas de inventario y ranking, auditoría paginada y generación de comprobantes bloqueante o asíncrona. Los vínculos entre módulos se limitan a referencias del índice de fuentes y relaciones descritas explícitamente en el README; el detalle de fuentes no muestreadas no se presume.
Main entry points: VentaService.java Ventas y stock · entity Modelo comercial · ProductoController.java API productos · VentaController.java API ventas
Components 19
API y contratos
- API clientes
src/main/java/ec/edu/espe/ventas/controller/ClienteController.java - API productos
src/main/java/ec/edu/espe/ventas/controller/ProductoController.java - API ventas
src/main/java/ec/edu/espe/ventas/controller/VentaController.java - API auditoría
src/main/java/ec/edu/espe/ventas/controller/AuditoriaController.java - DTO y mappers
src/main/java/ec/edu/espe/ventas/dto
Operación comercial
- Gestión clientes
src/main/java/ec/edu/espe/ventas/service/ClienteService.java - Productos e inventario
src/main/java/ec/edu/espe/ventas/service/ProductoService.java - Ventas y stock
src/main/java/ec/edu/espe/ventas/service/VentaService.java - Comprobantes
src/main/java/ec/edu/espe/ventas/service/ComprobanteService.java
Persistencia
- Modelo comercial
src/main/java/ec/edu/espe/ventas/entity - Repositorio clientes
src/main/java/ec/edu/espe/ventas/repository/ClienteRepository.java - Repositorio productos
src/main/java/ec/edu/espe/ventas/repository/ProductoRepository.java - Repositorios venta y detalle
src/main/java/ec/edu/espe/ventas/repository
Servicios transversales
- Consulta auditoría
src/main/java/ec/edu/espe/ventas/service/AuditoriaService.java - Auditoría AOP
src/main/java/ec/edu/espe/ventas/aspect/AuditoriaAspect.java - Repositorio auditoría
src/main/java/ec/edu/espe/ventas/repository/AuditoriaRepository.java - Interceptor API key
src/main/java/ec/edu/espe/ventas/interceptor/ApiKeyInterceptor.java - Errores HTTP
src/main/java/ec/edu/espe/ventas/exception/GlobalExceptionHandler.java
Other components
- Cliente HTTP
Connections 27
- Cliente HTTP → API clientes: solicita
- Cliente HTTP → API productos: solicita
- Cliente HTTP → API ventas: solicita
- Cliente HTTP → API auditoría: consulta
- Interceptor API key → API clientes: protege /api/**
- API clientes → Gestión clientes: invoca
src/main/java/ec/edu/espe/ventas/controller/ClienteController.java - API productos → Productos e inventario: invoca
src/main/java/ec/edu/espe/ventas/controller/ProductoController.java - API productos → Ventas y stock: consulta ranking
src/main/java/ec/edu/espe/ventas/controller/ProductoController.java - API ventas → Ventas y stock: invoca
src/main/java/ec/edu/espe/ventas/controller/VentaController.java - API ventas → Comprobantes: solicita comprobante
src/main/java/ec/edu/espe/ventas/controller/VentaController.java - API auditoría → Consulta auditoría: invoca
src/main/java/ec/edu/espe/ventas/controller/AuditoriaController.java - Gestión clientes → Repositorio clientes: lee y guarda
src/main/java/ec/edu/espe/ventas/service/ClienteService.java - Productos e inventario → Repositorio productos: lee y guarda
src/main/java/ec/edu/espe/ventas/service/ProductoService.java - Ventas y stock → Repositorio productos: consulta y actualiza stock
src/main/java/ec/edu/espe/ventas/service/VentaService.java - Ventas y stock → Repositorio clientes: busca cliente
src/main/java/ec/edu/espe/ventas/service/VentaService.java - Ventas y stock → Repositorios venta y detalle: persiste ventas
src/main/java/ec/edu/espe/ventas/service/VentaService.java - Repositorio clientes → Modelo comercial: persiste entidades
src/main/java/ec/edu/espe/ventas/repository/ClienteRepository.java - Repositorio productos → Modelo comercial: persiste entidades
src/main/java/ec/edu/espe/ventas/repository/ProductoRepository.java - Repositorios venta y detalle → Modelo comercial: persiste entidades
src/main/java/ec/edu/espe/ventas/repository/ProductoRepository.java - Gestión clientes → DTO y mappers: convierte datos
src/main/java/ec/edu/espe/ventas/service/ClienteService.java - Productos e inventario → DTO y mappers: convierte datos
src/main/java/ec/edu/espe/ventas/service/ProductoService.java - Ventas y stock → DTO y mappers: produce respuestas
src/main/java/ec/edu/espe/ventas/service/VentaService.java - Consulta auditoría → Repositorio auditoría: consulta registros
src/main/java/ec/edu/espe/ventas/service/AuditoriaService.java - Auditoría AOP → Repositorio auditoría: guarda auditoría
src/main/java/ec/edu/espe/ventas/aspect/AuditoriaAspect.java - Repositorio auditoría → Modelo comercial: persiste auditoría
src/main/java/ec/edu/espe/ventas/repository/AuditoriaRepository.java - Auditoría AOP → Ventas y stock: intercepta @Auditable
- Errores HTTP → Cliente HTTP: devuelve error uniforme