InkaERP representa la culminación de una arquitectura empresarial moderna diseñada para la gestión integral de recursos corporativos de gran escala. Este sistema no es solo una herramienta administrativa; es una plataforma de inteligencia de negocios que orquesta operaciones críticas desde la logística hasta la contabilidad financiera, garantizando integridad, escalabilidad y rendimiento en tiempo real.
El proyecto fue concebido bajo los principios de Clean Architecture y Domain-Driven Design (DDD), asegurando que la complejidad del negocio esté desacoplada de la infraestructura tecnológica, lo que permite una evolución sostenible y mantenible a largo plazo.
🏗️ Arquitectura de Backend Modular (NestJS)
Para gobernar la complejidad de múltiples dominios de negocio, se seleccionó NestJS como el framework de backend, proporcionando una estructura robusta inspirada en Angular:
- Modularidad Extrema: El sistema se divide en módulos funcionales (
AuthModule,LogisticsModule,FinanceModule,SalesModule) que encapsulan sus propios controladores, servicios y proveedores. Esto permite que diferentes equipos de desarrollo trabajen en paralelo sin colisiones. - Inyección de Dependencias (DI): El contenedor DI de NestJS facilita la gestión de dependencias y, crucialmente, permite un testing unitario aislado al poder inyectar mocks de servicios complejos durante las pruebas.
- Validación Robusta (DTOs): Uso extensivo de Data Transfer Objects con decoradores
class-validatoryclass-transformerpara asegurar que cada byte de información que entra al sistema cumpla con las reglas de negocio antes de tocar la lógica del servicio. - Guards y Decoradores: Implementación de seguridad declarativa mediante Guards personalizados para RBAC (Role-Based Access Control) y decoradores para metadatos de auditoría.
🏗️ Arquitectura de Nube & Infraestructura (AWS)
Para soportar la carga transaccional y la disponibilidad requerida por una corporación multinacional, InkaERP se despliega sobre una infraestructura inmutable y altamente disponible en Amazon Web Services:
- Orquestación de Contenedores (Amazon ECS con AWS Fargate): El núcleo del sistema corre sobre contenedores Docker gestionados por Fargate, lo que elimina la sobrecarga administrativa de servidores. Esta arquitectura serverless permite un auto-escalado horizontal basado en métricas de CPU y memoria.
- Almacenamiento de Objetos (Amazon S3): Todos los activos digitales, desde documentos adjuntos hasta reportes generados y backups de auditoría, se almacenan en buckets S3 con políticas de ciclo de vida inteligente.
- Persistencia de Datos (Amazon RDS PostgreSQL): La base de datos PostgreSQL opera en una configuración Multi-AZ para tolerancia a fallos, utilizando réplicas de lectura para descargar las consultas analíticas pesadas.
🚀 Stack Tecnológico de Vanguardia
- Backend: NestJS (Node.js Enterprise Framework).
- Frontend: Preact, Vite, Tailwind CSS 4.
- Base de Datos: PostgreSQL 16 con extensiones PostGIS.
- Estado: Signals (@preact/signals).
- Testing: Vitest, Cypress.
💎 Módulos del Sistema a Detalle
1. Dashboard Ejecutivo & BI
- Visualización de Datos: Gráficos interactivos con Recharts.
- KPIs en Tiempo Real: Websockets conectados a Redis.
- Reportes Predictivos: Algoritmos de regresión lineal.
2. Gestión Logística Avanzada (WMS)
- Control de Inventario Multi-Almacén: Algoritmos de grafos.
- Valorización de Stock: Costo promedio y FIFO.
3. Facturación Electrónica & Finanzas
- Emisión Fiscal: Generación de XML UBL 2.1 firmado.
- Libros Contables: Balances de comprobación automáticos.
4. Punto de Venta (POS) & Ventas
- Modo Offline-First: IndexedDB para ventas sin conexión.
- Búsqueda Full-Text: Motor tolerante a fallos.
🛡️ Ingeniería de Software & Buenas Prácticas
- SOLID Principles: Aplicación rigurosa de principios de diseño.
- CI/CD Pipelines: GitHub Actions para despliegue Blue/Green.
- Seguridad: OWASP Top 10, JWT con rotación.
- Observabilidad: OpenTelemetry y CloudWatch.