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.
STACK TECNOLÓGICO
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.
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.
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.
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.
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.
Una regla predecible es más fácil de manejar que varios bloqueos que se solapan.
Retos y soluciones
El primer modelo de organización era demasiado plano. Los equipos reales tienen regiones por encima de las áreas y varios cobradores por área.
Rehice la estructura en regiones, áreas y equipos antes de construir sobre ella.
El restablecimiento de contraseña por correo necesitaba un remitente personalizado y un dominio verificado.
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.
El despliegue de previsualización fallaba una y otra vez aunque el código estaba bien.
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ó.
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.
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.
