Saltar al contenido
Gabriel Neuman
Gabriel Neuman

Ejemplo real

Plan · CobraFácil

Sobre este archivo: Todo en _plan/ (este plan y las carpetas de milestones) es un artefacto temporal de documentación para el build inicial. No es funcional — ningún código, configuración, runtime, test o deploy debe importar, leer o depender de archivos en _plan/. Cuando los milestones estén completos, se puede borrar la carpeta.

CobraFácil

Una app para que freelancers en México den seguimiento a sus facturas pendientes y manden recordatorios de cobro automáticos por WhatsApp y email, escalados según los días de atraso — sin perseguir clientes a mano.

Next.jsPostgreSQLVercelResendWhatsApp Cloud API

Qué hace la app

  • Registro de facturas

    Capturas cliente, monto, fecha de emisión y fecha de vencimiento. La app calcula sola los días de atraso.

  • Recordatorios escalados

    Mensajes automáticos que suben de tono según el atraso: 3 días amable, 15 días firme, 30 días formal.

  • Envío por WhatsApp y email

    Cada recordatorio sale por el canal que el cliente prefiere. WhatsApp para los que no leen correo.

  • Tablero de cartera

    Vista de todo lo por cobrar: total pendiente, qué está por vencer y qué ya está vencido.

Ya provisto por el starter

  • Signup / login
  • Reset password
  • App shell autenticado
  • Dark mode
  • Cron jobs (Vercel)

Fuera de alcance (v1)

  • Timbrado CFDI — la app da seguimiento a facturas ya emitidas; no las genera ni timbra.
  • Cobro dentro de la app — v1 solo recuerda; el pago se hace fuera. Link de pago queda para v2.
  • Multi-usuario / equipos — v1 es de un solo freelancer. Nada de roles ni cuentas compartidas.

Integraciones externas

WhatsApp Cloud API

Recordatorios por WhatsApp

Permite que la app mande mensajes de WhatsApp automáticos desde un número de negocio. Requiere plantillas aprobadas por Meta para mensajes iniciados por la app.

Credenciales que conseguir

  • Cuenta de WhatsApp Business + número verificado
  • Access token permanente + Phone Number ID

Resend

Recordatorios por email

Envía los recordatorios por correo, uno a uno, disparados por el código de la app cuando toca cobrar. No es marketing.

Credenciales que conseguir

  • API key de Resend
  • Dominio verificado para envío

Modelo de datos

Lo que la app necesita recordar.

Cliente

nombreNombre o razón social del cliente que debe.
whatsappNúmero para recordatorios por WhatsApp.
emailCorreo para recordatorios por email.
canal_preferidoWhatsApp o email — por dónde se le contacta primero.

Relaciones · Un cliente tiene muchas facturas.

Factura

montoCantidad por cobrar.
vence_elFecha límite de pago. La app calcula el atraso desde aquí.
estadoPendiente, vencida o pagada.

Relaciones · Cada factura pertenece a un cliente y tiene muchos recordatorios enviados.

Milestones

1

Foundation + CRUD

Las pantallas para registrar clientes y facturas, y el tablero que muestra lo pendiente. Sin envíos todavía.

Qué se construye

  • Alta/edición de clientes y facturas
  • Cálculo automático de días de atraso
  • Tablero de cartera con totales

NO en este milestone

  • Envío de recordatorios
  • Integraciones externas

Done when: puedes dar de alta una factura y verla en el tablero con sus días de atraso calculados.

2

Recordatorios + integraciones

Los envíos automáticos por WhatsApp y email, con las reglas de escalamiento por días de atraso.

Qué se construye

  • Envío por WhatsApp Cloud API y Resend
  • Reglas de escalamiento (3/15/30 días)
  • Job diario que dispara los recordatorios

NO en este milestone

  • Personalizar textos por cliente
  • Links de pago

Done when: una factura vencida hace 3 días genera y envía un recordatorio real por el canal preferido del cliente.

Riesgos

#RiesgoImpactoMitigación
R1Meta puede rechazar las plantillas de WhatsApp o tardar en aprobarlas.altoArrancar con email funcionando y WhatsApp como segundo canal; mandar plantillas a revisión al inicio del proyecto.
R2Recordatorios demasiado agresivos pueden molestar a clientes del freelancer.medioTono escalado y editable; el freelancer aprueba antes del primer envío a cada cliente.

Supuestos

  • Las facturas ya existen (emitidas fuera de la app); aquí solo se les da seguimiento.
  • El freelancer tiene o abre una cuenta de WhatsApp Business.
  • v1 arranca con base vacía; no se migran datos históricos.
Generado con De Idea a Plan · gabrielneuman.com · 2026-07-12