Inka Labs Facturación es una web de alta criticidad diseñado para operar como una autoridad de confianza dentro del ecosistema de factuiración electrónica. Su misión es garantizar la inmutabilidad, validez legal y persistencia de cada documento fiscal emitido, operando bajo estrictos estándares de seguridad y rendimiento.
Más que un simple generador de comprobantes, este microservicio actúa como un puente seguro entre las operaciones comerciales de la empresa y los entes reguladores gubernamentales, asegurando cumplimiento normativo total sin sacrificar la velocidad operativa.
🏗️ Arquitectura de Backend (Express.js "Bare Metal")
Dada la naturaleza crítica y de alta velocidad requerida para la firma digital de miles de comprobantes por segundo, se optó por una arquitectura Express.js minimalista y altamente optimizada, evitando la sobrecarga de frameworks más pesados.
- Procesamiento de Streams: Express maneja la recepción de XMLs crudos mediante streams de Node.js, permitiendo firmar digitalmente documentos de gran tamaño sin cargar todo el archivo en memoria RAM. Esto reduce drásticamente el consumo de recursos en contenedores Fargate.
- Middleware Personalizado: Se implementó una cadena de responsabilidad ligera para validación de esquemas (XSD), autenticación (JWT) y logging, sin dependencias externas innecesarias que pudieran introducir latencia.
- Rutas de Alto Rendimiento: Los endpoints están diseñados para responder en menos de 50ms, delegando el trabajo pesado (como la generación de PDFs) a colas de tareas asíncronas, manteniendo el hilo principal de Node.js libre para aceptar nuevas peticiones.
🏗️ Arquitectura de Nube & Almacenamiento (AWS S3)
La solución adopta una arquitectura desacoplada para garantizar resiliencia y escalabilidad independiente:
- Almacenamiento Inmutable (Amazon S3 con Object Lock): Cada comprobante emitido (XML firmado y representación impresa PDF) se almacena en buckets S3 configurados con políticas de retención WORM (Write Once, Read Many). Esto garantiza que, una vez emitido un documento fiscal, este sea inalterable.
- CDN Global (Amazon CloudFront): La distribución de los documentos PDF a clientes finales se realiza a través de una red de entrega de contenido (CDN) segura.
- Base de Datos Transaccional (MySQL 8.0): Se utiliza un clúster de MySQL en Amazon RDS para gestionar el estado de los comprobantes, series y correlativos.
🚀 Stack Tecnológico y Diseño
- Backend Light: Express.js, TypeScript.
- Frontend: Vue 3 (Composition API), Vite, Tailwind CSS 3.
- Estado: Pinia.
- Generación de Documentos: JSPDF y HTML2Canvas.
- Validación: Vuelidate.
💎 Funcionalidades Críticas a Detalle
1. Motor de Emisión Fiscal
El núcleo del sistema, diseñado para procesar transacciones atómicas.
- Firma Digital en Cliente: Implementación de criptografía de curva elíptica.
- Validación de RUC/DNI en Tiempo Real: Integración con APIs gubernamentales.
- Cálculo de Impuestos Granular: Motor de reglas tributarias capaz de manejar IGV, ISC, percepciones.
2. Generación y Gestión Documental
Sistema de producción de documentos legales de alta fidelidad.
- Renderizado de PDF Pixel-Perfect: Algoritmos de maquetación precisos.
- Archivado Inteligente: Clasificación automática en S3.
- Envío Masivo Asíncrono: Cola de trabajos (RabbitMQ).
3. Trazabilidad y Seguridad
- Logs de Auditoría Inmutables: Registro de cada intento de emisión.
- Control de Concurrencia Optimista: Uso de versiones de fila en MySQL.
🛡️ Ingeniería de Software & Buenas Prácticas
- DDD Lite: Modelado del dominio fiscal sin complejidad accidental.
- TDD: Cobertura de pruebas unitarias exhaustiva.
- Resiliencia: Patrones Circuit Breaker para servicios externos.