Portal de Clientes Neft

Sobre el proyecto

Portal de clientes desarrollado como sistema interno de Neft — reescritura completa desde cero con arquitectura profesional. Monorepo pnpm con backend NestJS y frontend Next.js 14. Incluye autenticación con JWT + refresh tokens, blacklist en Redis, historial de sesiones por dispositivo y RBAC dinámico con permisos granulares por módulo. El core de negocio cubre CRM de clientes (persona física y moral, México/LATAM/USA), catálogo de servicios, cotizaciones, facturación, pagos, notas de crédito, gestión de documentos con Cloudflare R2, helpdesk con tickets y notificaciones asíncronas vía BullMQ. Los menús del dashboard son dinámicos, asignados por rol, con árbol recursivo en PostgreSQL.

Funcionalidades implementadas

• Autenticación JWT con refresh tokens y blacklist en Redis
• Historial de sesiones con datos de dispositivo, IP y geolocalización
• RBAC dinámico: roles, permisos granulares y menús por rol
• CRM de clientes: persona física y moral, soporte México/LATAM/USA y perfiles fiscales (RFC/SAT)
• Catálogo de servicios, cotizaciones y suscripciones de clientes
• Módulo de facturación, pagos y notas de crédito
• Gestión de documentos con almacenamiento en Cloudflare R2 (S3-compatible)
• Helpdesk completo con sistema de tickets
• Notificaciones in-app y por email con colas BullMQ asíncronas
• Reportes financieros y auditoría completa de acciones

Resultados obtenidos

• 100% de operaciones internas digitalizadas en un solo sistema
• Gestión unificada de clientes, cotizaciones y facturación
• Permisos granulares por módulo para cada rol del equipo
• Deploy automatizado en Railway con PostgreSQL y Redis integrados