CugrancaXXI
CugrancaXXI es un sistema integral de gestión comercial especializado para empresas importadoras que maneja el ciclo completo de operaciones de importación. El sistema gestiona documentos clave como facturas (invoiceNumber), conocimientos de embarque (blNumber), fechas de puerto (portDate) y fechas de importación (importerDate), controlando todo el proceso desde la orden de compra hasta la entrega final. Incluye módulos de producción para fabricación local, gestión de proveedores internacionales, control de inventario con pesos y dimensiones para logística, empaquetado, y seguimiento detallado de costos y pagos tanto para importaciones como para producciones locales, ofreciendo visibilidad completa del estado de cada transacción y permitiendo la generación de reportes operativos para la toma de decisiones estratégicas.
Tecnologías usadas:
Front End:
Stack tecnológico moderno y bien estructurado que combina React 19 con TypeScript para tipado robusto, utilizando Vite como bundler para desarrollo rápido. La arquitectura implementa Zustand con persistencia para gestión de estado global y autenticación, junto con React Hook Form y Zod para validación de formularios tipada. El sistema usa Tailwind CSS v4 para estilizado moderno y React Router v7 para navegación declarativa, complementado con TanStack React Table para tablas complejas y Recharts para visualización de datos. Destaca el uso de @react-pdf/renderer para generación de documentos PDF y axios con retry para comunicación HTTP resiliente, mostrando buenas prácticas de manejo de errores con Sonner para notificaciones y un sistema de componentes personalizados a través de fazt-web-module. La aplicación sigue patrones de arquitectura limpia con separación de responsabilidades entre containers, components y contexts, implementando un diseño responsive y accesible con manejo optimizado de loading states y gestión centralizada de UI.
React
TypeScript
Vite
Tailwind
Back End:
Arquitectura enterprise robusta construida con NestJS que implementa patrones de diseño modernos como inyección de dependencias, módulos funcionales y decoradores TypeScript para un código escalable y mantenible. El sistema utiliza TypeORM con MySQL para persistencia de datos con un esquema relacional bien normalizado, implementando transacciones ACID con QueryRunner para garantizar integridad en operaciones complejas. La seguridad está manejada con JWT y Passport.js mediante estrategias locales y JWT, con guards decorativos para protección de rutas y validación de DTOs con class-validator y class-transformer. La API RESTful sigue convenciones HTTP estándar con manejo robusto de errores y CORS configurado para múltiples orígenes. Destacan los patrones de repository pattern, service layer con lógica de negocio separada, y data transfer objects para validación. El sistema maneja casos de uso complejos como cálculos financieros con Decimal.js para precisión monetaria, generación de reportes con agregaciones de datos complejas, y flujos de trabajo de importación con estados y transiciones. La configuración es environment-aware con @nestjs/config y la base de datos se inicializa automáticamente con datos semilla, demostrando buenas prácticas de configuración y deployment-ready architecture.
MySql
NestJS
TypeORM
Código no disponible