[ SaaS Product ]

Garnet CRM

CRM multi-tenant para equipos de ventas y cobros en campo

EL RETO

Los equipos de ventas en campo registran visitas, pedidos, entregas y efectivo entre muchas personas y zonas. Las cifras pasan por varias manos y, cuando alguien pregunta quién cambió un saldo, a menudo no hay respuesta. Quería un único sistema donde cada nivel de una empresa vea solo lo que debe, el dinero siga las reglas contables normales y cada cambio deje rastro.

ROL:Full-Stack Developer
AÑO:2026
TIPO:SaaS Product
ESTADO:In Development

STACK TECNOLÓGICO

Next.jsTypeScriptPrismaSupabaseResendnext-intlTailwind CSS
I

Enfoque de ingeniería

La estructura de la organización como modelo

Modelé una empresa como regiones, áreas y equipos, con responsables regionales y de área, comerciales y cobradores. Los roles los asigna el nivel superior, y cada responsable de área recibe informes diarios separados de ventas y de cobros.

Motor de permisos con niveles de acceso

Cada persona tiene un único nivel de acceso, ya sea un rol preparado o una lista personalizada de permisos. Solo los propietarios crean y editan niveles de acceso, y los permisos más sensibles se limitan al propietario y al contable.

Aislamiento de organizaciones por URL

Cada organización vive bajo su propia URL, y una persona solo ve las organizaciones a las que pertenece. La incorporación es por invitación.

Diseño antes que código

Escribí un documento de diseño y resolví primero las reglas: límites de crédito, asignación de pagos, cheques posdatados, devoluciones y quién puede aprobar qué. El código después aplica decisiones que ya estaban tomadas.

II

Decisiones técnicas clave

Las decisiones que dieron forma a la arquitectura y a lo fácil que es mantenerla.

Visibilidad acotada, dinero que nunca se edita, todo auditado

Tres promesas, fijadas antes de construir.

POR QUÉ

Cuando las personas entregan efectivo, la confianza tiene que venir del sistema. Fijar estas reglas pronto obliga a que cada funcionalidad posterior las respete.

Un nivel de acceso por persona

Personalizar un nivel de acceso significa guardar uno nuevo, sin excepciones por persona.

POR QUÉ

Las excepciones se acumulan hasta que nadie puede explicar quién puede hacer qué. Un nivel por persona mantiene los permisos explicables.

El sistema no emite facturas

Los recibos llevan los números de factura o de IVA que cada empresa introduce en su propio formulario.

POR QUÉ

Las reglas de facturación difieren según la empresa y el país, así que el producto se mantiene general y fuera de ese ámbito.

El límite de crédito es el único bloqueo de pedidos

Se muestran los importes vencidos, pero solo el límite de crédito detiene un pedido.

POR QUÉ

Una regla predecible es más fácil de manejar que varios bloqueos que se solapan.

III

Retos y soluciones

[ RETO ]

El primer modelo de organización era demasiado plano. Los equipos reales tienen regiones por encima de las áreas y varios cobradores por área.

[ SOLUCIÓN ]

Rehice la estructura en regiones, áreas y equipos antes de construir sobre ella.

[ RETO ]

El restablecimiento de contraseña por correo necesitaba un remitente personalizado y un dominio verificado.

[ SOLUCIÓN ]

Configuré Resend como remitente con una plantilla de correo de restablecimiento personalizada, de modo que el restablecimiento funciona de principio a fin en producción.

[ RETO ]

El despliegue de previsualización fallaba una y otra vez aunque el código estaba bien.

[ SOLUCIÓN ]

Las variables de entorno, incluida la URL directa de la base de datos, estaban definidas para producción pero no para el entorno de previsualización. Definirlas ahí lo solucionó.

IV

Resultados

Garnet CRM tiene inicio de sesión funcional, aislamiento de organizaciones por URL, un motor de permisos, una página de equipo con invitaciones, restablecimiento de contraseña por correo y compatibilidad con árabe y con diseños de derecha a izquierda, desplegado en Vercel.

3
Fixed promises: scoped, never edited, audited
2
Languages, with right-to-left support

CONCLUSIONES CLAVE

Escribir primero las reglas hizo el código más simple. El motor de permisos solo tuvo que aplicar decisiones ya tomadas, en lugar de inventarlas sobre la marcha.