Sobre Este Proyecto

Una herramienta interna para empresas de factoring orientada a gestionar carteras de facturas: cargar operaciones, controlar vencimientos, calcular descuentos diarios y registrar cobranzas sin planillas de cálculo ni cálculos manuales.

 

Características Principales:

• CRUD de operaciones de factoring – Registro de facturas con cliente, pagador, valor nominal, fecha de emisión, fecha de vencimiento y tasa mensual. Calcula automáticamente días, descuento, adelanto y ganancia esperada.
• Directorio de clientes y pagadores – Gestión de cedentes y pagadores con normalización de RUC, búsqueda difusa y detección de duplicados mediante índices trigram de PostgreSQL.
• Dashboard en tiempo real – Tarjetas estadísticas para cartera total, monto pendiente, ganancia esperada y cantidad de vencidos. Vista cronológica de los próximos 7 días de vencimientos.
• Listado inteligente de operaciones – Ordenado por fecha de vencimiento, filas vencidas resaltadas en rojo, paginación basada en cursor y filtros por estado, rango de fechas, cliente o pagador.
• Cobranza en un clic – Permite marcar facturas como cobradas con un solo botón; protecciones SQL idempotentes evitan cobranzas duplicadas y soportan reversión para correcciones.
• Reporte de intereses – Reporte de intereses generados por rango de fechas con tarjetas resumen, desglose de top-5 clientes y exportación Excel en streaming con encabezados estilizados y paneles congelados.
• Adjuntos seguros – Subida de archivos PDF, JPEG, PNG o WebP (verificados mediante magic-bytes, límite de 10 MiB) vinculados a operaciones con descargas autenticadas desde servidor y limpieza automática de archivos huérfanos.
• Autenticación sin registro público – Login mediante Better Auth con email y contraseña; usuarios creados exclusivamente vía CLI administrativa. Sesiones basadas en cookies con protección CSRF mediante verificación de Origin.
• UX centrada en español – Todo el contenido en español rioplatense (es-AR), formato monetario en USD y tipografía editorial con Fraunces serif + Geist sans.
• Responsive y accesible – Diseño mobile-first con componentes shadcn/ui, navegación por teclado, skeleton loaders y páginas de detalle optimizadas para impresión.

Stack Tecnológico:

• Frontend: Next.js 16 (App Router), React 19, Tailwind CSS 4, shadcn/ui (primitivas Radix), tipografías Fraunces + Geist
• Backend: Next.js Server Actions, vista PostgreSQL para campos derivados, decimal.js para cálculos monetarios exactos (HALF_UP)
• Base de Datos: PostgreSQL 16 (clientes, pagadores, operaciones, adjuntos, sesiones, cuentas)
• Autenticación: Better Auth, hash de contraseñas argon2id, sesiones mediante cookies, middleware CSRF basado en verificación de Origin
• Validación: Esquemas Zod (zMoney, zPercent, zDate) + React Hook Form
• ORM y Migraciones: Drizzle ORM + Drizzle Kit
• Exportación Excel: ExcelJS streaming WorkbookWriter
• Testing: Playwright e2e (happy-path), tests unitarios para cálculos de factoring y normalización de identidad
• Infraestructura: Docker Compose (Dockerfile multi-stage), nginx reverse proxy, TLS con Cloudflare, backups nocturnos mediante pg_dump y predeploy grep gate

Objetivo:
Entregar un sistema de operaciones de factoring confiable y autocontenido que pueda ser gestionado de punta a punta por un único operador: cargar facturas, controlar vencimientos, registrar cobranzas y generar reportes, sin dependencias externas más allá de PostgreSQL y un navegador web.