Juan Bustos
← Todas las líneas

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.

Panel de Cuotum con lo recaudado en el mes, socios al día, en mora, porcentaje cobrado y últimos movimientos
Panel del negocio, con datos de ejemplo.

Las estaciones de la línea

Las partes de la plataforma y con qué está hecha cada una.

  1. API

    Java 21 · Spring Boot · Spring Security

    Monolito modular con JWT, bloqueo por intentos fallidos y captcha. 431 clases, 103 de ellas de tests.

  2. Base de datos

    PostgreSQL · Row-Level Security · Flyway

    Cada negocio ve solo sus datos, aislado en la propia base. 57 migraciones versionadas.

  3. 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.

  4. 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.

  5. Pasarelas

    Mercado Pago · Talo

    Cada negocio elige cómo cobrar. El pago se reparte al instante entre el negocio y la plataforma.

  6. 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.

Link de pago de Cuotum en el celular: total a pagar, vencimiento y alias y CVU para transferir
Link de pago, con datos de ejemplo.

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.