04. Backend
A continuación se detalla la estructura principal del backend (Spring Boot) detectada en el proyecto.
Controllers
| Nombre | Responsabilidad | Ubicación |
|---|---|---|
BillingController | Gestión de facturación. | com.alpura.facturacion.web |
AddendaController | Generación y administración de Addendas. | com.alpura.facturacion.web |
PayRollController | Procesamiento de nómina. | com.alpura.facturacion.web |
PayrollCancellationController | Cancelación de recibos de nómina. | com.alpura.facturacion.web |
DocumentsController | Gestión y descarga de documentos (PDF/XML). | com.alpura.facturacion.web |
PubSubController / PubSubRestController | Interfaz de mensajería GCP Pub/Sub. | com.alpura.facturacion.web |
ValidationController | Validación de facturas y reglas. | com.alpura.facturacion.web |
OnlineInvoiceController | Facturación en línea. | com.alpura.facturacion.web |
SQLController | Operaciones/Consultas a base de datos. | com.alpura.facturacion.web |
Configuration
| Nombre | Responsabilidad | Ubicación |
|---|---|---|
RestTemplateConfig | Configuración del cliente HTTP. | com.alpura.facturacion.config |
ModelMapperConfig | Mapeo de DTO a Entidades. | com.alpura.facturacion.config |
InterceptorConfig | Configuración de interceptores (ej. Logging). | com.alpura.facturacion.config |
CryptoProviderConfig | Configuración de seguridad/criptografía BouncyCastle. | com.alpura.facturacion.config |
ChannelAdapter | Adaptador de canales de integración. | com.alpura.facturacion.config |
AsyncMethod | Métodos asíncronos (@Async). | com.alpura.facturacion.config |
Value Objects / DTOs
| Nombre | Responsabilidad | Ubicación |
|---|---|---|
PayrollRequest / PayRollResponse | Payload para servicios de Nómina. | com.alpura.facturacion.common.vo |
GenerarAddendaRequest | Payload para creación de Addenda. | com.alpura.facturacion.common.vo |
TransaccionDto / TransaccionFolio | Representación de folios y transacciones. | com.alpura.facturacion.common.vo |
DocumentXmlPDF | Representación de archivos generados. | com.alpura.facturacion.common.vo |
ReglaCalculo / DigitalStamp | Lógica de cálculo y sellos (Timbrado). | com.alpura.facturacion.common.vo |