Godines Inventario

Contexto del Proyecto

Godines Construcciones llevaba su inventario a mano: alguien abría cada factura del proveedor y tecleaba producto por producto en una hoja de cálculo. Con varias empresas del mismo grupo y decenas de facturas al mes, el inventario nunca reflejaba la realidad y nadie sabía con certeza qué material había en obra. Construimos un panel propio que invierte el flujo: la factura que ya reciben del SAT es la fuente de verdad, y el inventario se deriva de ella.

Desafío Técnico

El reto no era dibujar una tabla de productos, sino tres problemas a la vez: leer el estándar fiscal mexicano CFDI sin errores, mantener varias empresas del grupo estrictamente aisladas entre sí en la misma base de datos, y hacerlo con un modelo de permisos que resista una auditoría. Todo ello sobre datos fiscales reales, donde una entrada duplicada o un dato cruzado entre empresas no es un bug cosmético: es un problema contable.

Problemas Resueltos

• •Fragmentación de proveedores: cada uno nombra el mismo material con una clave SAT y una descripción distintas. Se resolvió con una tabla de mapeo que consolida esas variantes en un producto maestro único por empresa, de modo que el stock no se parta en tres registros del mismo tornillo.
• •Idempotencia en la ingesta: subir dos veces el mismo XML no puede duplicar el inventario. Cada CFDI queda registrado por su UUID fiscal con restricción de unicidad por empresa, así que un reenvío se ignora en lugar de inflar el stock.
• •Aislamiento multi-empresa: todos los datos operativos están scopeados por empresa y cada API verifica en servidor que el usuario tenga acceso concedido a esa empresa antes de responder. El RFC de cada empresa configura la lógica de entrada/salida, en lugar de estar quemado en el código.
• •Auditoría de seguridad y refactor: la versión heredada confiaba en una cookie falsificable desde el navegador y exponía endpoints de administración sin autenticación. Se reescribió el modelo de sesión (cookies httpOnly validadas en servidor), se añadió RBAC en base de datos y se documentaron los hallazgos y sus correcciones.

Ejecución Técnica

Desarrollo del panel en Next.js 15 y React 19 con Prisma sobre PostgreSQL; procesador de CFDI que convierte cada XML en movimientos de entrada o salida según el RFC de la empresa; modelo multi-inquilino con roles CEO/usuario y concesiones de acceso por empresa; autenticación con Supabase validada en servidor; reportes exportables a PDF y Excel; y gráficas de consumo por producto y periodo.

Resultados Obtenidos

El cliente pasó de teclear facturas a arrastrarlas: el inventario se actualiza solo y cada movimiento queda trazado hasta el folio y el proveedor que lo originó. El sistema opera en producción para varias empresas del grupo, cada una viendo únicamente lo suyo, y el rediseño de seguridad cerró un bypass de autenticación que permitía entrar al panel sin credenciales.

Evidencia Visual