Prompt base - Sistema Leads para Empresa

Construye una app móvil y web lista para producción (MVP funcional) llamada:

“LeadFlow Pro – Captación y Seguimiento Automático para PYMES”

1. Objetivo del MVP

Crear una app muy simple e intuitiva para PYMES de servicios que:

Capture leads desde un formulario

Los gestione en un pipeline tipo Kanban

Permita agendar llamadas

Genere mensajes y emails de seguimiento con variables dinámicas

Lance recordatorios automáticos al administrador

Prioriza claridad, velocidad y cero complejidad técnica.

1. Usuarios objetivo

PYMES de servicios: reformas, clínicas, estética, asesorías, inmobiliarias, talleres, agencias.

1. Roles (preparado para multiusuario)

Admin (por defecto): configura servicios, plantillas, automatizaciones, métricas.

Usuario (futuro): puede ver/editar leads asignados.

En el MVP: implementar login simple y un Admin por workspace.

1. Navegación (mobile-first)

Menú inferior con 4 pestañas:

Leads

Dashboard

Calendario

Ajustes

1. Modelo de datos (base de datos limpia y escalable)

Entidad: Lead

id (UUID)

nombre_completo (string, requerido)

telefono (string, requerido)

email (string, opcional)

servicio_id (FK Servicio, requerido)

mensaje (text, opcional)

urgencia (enum: Normal, Alta, Inmediata)

estado (enum pipeline: Nuevo, Contactado, Seguimiento, PropuestaEnviada, Cerrado, Perdido)

fecha_creacion (timestamp auto)

fecha_ultima_accion (timestamp auto update)

fecha_ultimo_contacto (timestamp opcional)

valor_estimado (number opcional)

ingreso_cerrado (number opcional)

notas_internas (text opcional)

origen (enum opcional: Web, WhatsApp, Llamada, Referido, Otro)

Entidad: Servicio

id

nombre (string)

activo (boolean)

orden (number)

Entidad: PlantillaMensaje

id

tipo (enum: WhatsApp, Email)

asunto_email (string, solo si tipo=Email)

cuerpo (text)

activa (boolean)

ultima_edicion (timestamp)

Variables soportadas: {nombre} {servicio} {fecha} {telefono}

Entidad: Cita

id

lead_id (FK)

fecha_hora (datetime)

duracion_min (number default 30)

estado (enum: Programada, Completada, Cancelada)

recordatorio_enviado (boolean)

fecha_creacion (timestamp)

Entidad: AjustesAutomatizacion

id

auto_recordatorio_48h (boolean)

auto_followup_3d (boolean)

auto_recordatorio_cita_24h (boolean)

Entidad: AccionLead (log)

id

lead_id (FK)

tipo (enum: Creado, EstadoCambiado, MensajeGenerado, EmailGenerado, CitaCreada, NotaAñadida)

detalle (text)

fecha (timestamp)

1. Funcionalidades principales

5.1 Captación de Lead (Formulario)

Pantalla pública / interna “Nuevo Lead” con campos:

Nombre completo * (requerido)

Teléfono * (requerido)

Email (opcional)

Servicio solicitado (dropdown desde Servicios, editable por Admin)

Mensaje / descripción (textarea)

Urgencia (Normal / Alta / Inmediata)

Botón: “Solicitar información”

Al enviar:

Guardar Lead en BD

estado = Nuevo

fecha_creacion y fecha_ultima_accion auto

registrar AccionLead = Creado

Mostrar pantalla “Lead creado” con 2 acciones:

Generar WhatsApp

Generar Email

5.2 Sistema de seguimiento automático (MVP implementable)

Cuando se crea un lead:

Generar (no enviar automáticamente) sugerencias:

✅ Plantilla de WhatsApp con variables reemplazadas

✅ Plantilla de Email con variables reemplazadas

Plantilla WhatsApp por defecto:

“Hola {nombre}, gracias por solicitar información sobre {servicio}. En breve te contactamos. Si prefieres agendar ahora, haz clic aquí.”

Email por defecto:

Asunto: “Recibimos tu solicitud – {servicio}”
Cuerpo: “Hola {nombre}, hemos recibido tu solicitud sobre {servicio} a fecha {fecha}. En breve te contactaremos.”

En la ficha del lead debe haber botones:

Abrir WhatsApp (usar deep link con el teléfono y el texto generado)

Copiar mensaje

Copiar email

(Opcional MVP) botón “Marcar como Contactado” que actualiza estado.

Admin puede editar plantillas en Ajustes.

5.3 Pipeline Kanban (Dashboard Leads)

Tab “Leads”:

Vista Kanban con columnas:

Nuevos Leads

Contactado

Seguimiento

Propuesta Enviada

Cerrado

Perdido

Soportar drag & drop entre columnas.

Al mover:

actualizar estado

actualizar fecha_ultima_accion

registrar AccionLead = EstadoCambiado

Cada tarjeta de lead muestra:

Nombre

Servicio

Etiqueta de urgencia (Normal/Alta/Inmediata con color)

Teléfono

Fecha último contacto (si existe)

Click en tarjeta abre Detalle del Lead.

5.4 Detalle del Lead (pantalla clave)

Secciones:

Datos (nombre, teléfono, email, servicio, urgencia)

Estado (dropdown + historial)

Acciones rápidas:

Generar WhatsApp

Abrir WhatsApp

Generar Email

Agendar Llamada

Notas internas (editable)

Historial (lista AccionLead)

5.5 Agenda de llamadas (calendario interno)

Tab “Calendario”:

Vista lista y vista calendario simple.

Botón dentro del lead: “Agendar llamada”

selector de fecha/hora

duración (30/45/60)

Al crear cita:

guardar Cita

actualizar estado del Lead a Seguimiento

registrar AccionLead = CitaCreada

Recordatorio 24h antes (MVP):

Crear una notificación interna o “tarea pendiente” visible en Dashboard/Leads.

Si el sistema soporta notificaciones push/email, dejarlo listo con una abstracción (pero no depender de servicios externos).

5.6 Recordatorios & automatizaciones

Automatización A (48h):

Si lead en estado Nuevo y sin cambios en 48h → crear notificación interna para Admin:

“Lead sin movimiento en 48h: {nombre} – {servicio}”

Automatización B (3 días sin respuesta tras Propuesta Enviada):

Si estado=Propuesta Enviada y sin cambios en 3 días → generar sugerencia de follow-up (texto) y mostrar en panel de notificaciones.

Estas automatizaciones deben poder activarse/desactivarse en Ajustes.

5.7 Panel de Ajustes (Admin)

Gestión de Servicios (CRUD: añadir, editar, activar/desactivar, ordenar)

Plantillas (WhatsApp y Email) editables, con ayuda de variables disponibles

Automatizaciones (toggles)

Botón “Upgrade” (placeholder)

Sección “Usuarios” (solo estructura/lista, sin complejidad; preparado)

5.8 Métricas (Dashboard)

Tab “Dashboard” con tarjetas y gráficos simples:

Total de leads

Tasa de conversión (Cerrado / Total)

Leads por servicio

Tiempo medio de respuesta (fecha_creacion → fecha_ultimo_contacto o primera acción)

Ingresos cerrados (suma ingreso_cerrado manual)

1. UI/UX

Estilo limpio, moderno, fondo blanco, acento sutil

Tipografía legible, botones grandes, textos claros

Cero jerga técnica

Estados y urgencia muy visual

1. Requisitos técnicos

App funcional web + mobile preview

Base de datos normalizada con relaciones

Código/estructura escalable

Manejo de errores y validaciones (campos requeridos)

Preparada para despliegue iOS/Android

1. Criterios de aceptación (Definition of Done)

Puedo crear un lead y verlo en Kanban en “Nuevos Leads”

Puedo arrastrar leads entre columnas y se guarda el estado

Puedo abrir el detalle del lead y generar/copiar WhatsApp y Email con variables reemplazadas

Puedo agendar una llamada y verla en el calendario

Se generan recordatorios internos por 48h y 3 días según reglas

Admin puede editar servicios, plantillas y activar/desactivar automatizaciones

Dashboard muestra métricas básicas correctamente

Entrega un MVP completo, estable y usable.