Cuotum
Plataforma para cobrar cuotas recurrentes: gimnasios, clubes, alquileres y membresías. La diseñé y construí solo, y está en producción desde 2026.
- 54 socios cargados
- Mercado Pago y Talo
- 103 clases de tests
- cuotum.app
El problema
Un club o un gimnasio chico cobra las cuotas a mano: manda mensajes, espera transferencias y revisa el banco para saber quién pagó. Cuotum lo automatiza.
El negocio carga a sus socios una sola vez. A cada uno le llega un aviso con su link, paga desde el celular y el panel muestra quién está al día y quién no.

Las estaciones de la línea
Las partes de la plataforma y con qué está hecha cada una.
API
Java 21 · Spring Boot · Spring Security
Monolito modular con JWT, bloqueo por intentos fallidos y captcha. 431 clases, 103 de ellas de tests.
Base de datos
PostgreSQL · Row-Level Security · Flyway
Cada negocio ve solo sus datos, aislado en la propia base. 57 migraciones versionadas.
Panel del negocio
React 19 · Vite · TypeScript · Tailwind CSS · TanStack Query
Conceptos de cobro, socios, morosos, métricas por cuota y exportación de deudores.
Link de pago
React
El socio paga desde el celular sin crear cuenta. Con DNI y un código temporal puede ver todas sus cuotas.
Pasarelas
Mercado Pago · Talo
Cada negocio elige cómo cobrar. El pago se reparte al instante entre el negocio y la plataforma.
Avisos
Spring Scheduler · WhatsApp · Email
Recordatorios de vencimiento automáticos, cada uno con su link de pago.
Lo que ve el socio
El socio no descarga nada ni crea una cuenta. Abre el link desde WhatsApp o el email, ve cuánto debe y cuándo vence, y paga.
Si pagó tarde, el recargo por mora se calcula en el momento del pago y se le muestra desglosado: cuota, recargo y total.

Decisiones que tomé
El aislamiento no depende del frontend
El negocio de cada pedido sale siempre del token, nunca de lo que manda el navegador. Y por si algo falla en la aplicación, la base de datos aplica Row-Level Security: una consulta mal armada no puede devolver datos de otro negocio.
La plata se calcula en un solo lugar
Montos en BigDecimal y NUMERIC, nunca en coma flotante. El frontend no hace ninguna cuenta: recibe los importes ya calculados y formateados, así no hay dos versiones de un mismo total.
El dinero no pasa por la plataforma
Con split de pagos, cada cobro se divide en el momento: la cuota va directo al negocio y solo la comisión llega a Cuotum. Simplifica la parte fiscal y el negocio cobra sin esperar.
No arranca con configuración insegura
En producción, el backend se niega a iniciar si la clave de firma de tokens o los orígenes permitidos siguen con los valores de desarrollo. Un error de configuración se ve al desplegar, no después.