Vuelvo
Plataforma de fidelización post-venta para PYMES.
"Vendé más sin conseguir un solo cliente nuevo."
CRM centrado en el cliente existente: base de datos, segmentación automática, recordatorios de cumpleaños y recompra, y campañas por email + WhatsApp manual. Incluye landing pública de conversión.
Stack
- Next.js 15 (App Router) + TypeScript + React 19
- Tailwind CSS (diseño móvil-primero, en español)
- Prisma + PostgreSQL (Supabase) como base de datos
- Server Actions para toda la escritura (sin API REST intermedia)
- Auth propia (email + contraseña con bcrypt, sesiones en cookie httpOnly)
- Multi-tenant: cada negocio ve solo sus datos, aislados por
businessId
- Modo claro/oscuro con tokens de tema (persistente, sin parpadeo al cargar)
Requisitos
- Node.js 18+ (probado con Node 24)
- Un proyecto de Supabase (o cualquier Postgres)
Puesta en marcha
- Copiá
.env.example a .env y completá DATABASE_URL y DIRECT_URL con la
connection string de tu proyecto Supabase (Connect → ORMs → Prisma).
- Instalá dependencias y preparalo:
npm install # instala dependencias y genera el cliente Prisma
npm run db:push # crea las tablas en tu base de Supabase
npm run db:seed # carga datos demo (20 clientes)
npm run dev # levanta el servidor en http://localhost:3000
Si el puerto 3000 está ocupado: PORT=3001 npm run dev.
npm run db:reset hace db:push --force-reset + db:seed juntos (borra y recarga todo).
Cuenta demo (creada por el seed): [email protected] / demo1234.
También podés crear un negocio nuevo desde Registrarse.
Scripts útiles
| Script | Qué hace |
|---|
npm run dev | Servidor de desarrollo |
npm run build | Build de producción (genera Prisma + compila Next) |
npm run db:push | Aplica el esquema Prisma a la base |
npm run db:seed | Carga los datos demo |
npm run db:reset | Reinicia la base y vuelve a sembrar |
Estructura
app/
page.tsx Landing pública de conversión (CTAs a WhatsApp)
(auth)/ Login y registro (layout con panel de marca, sin sesión)
(app)/ Rutas protegidas (guard de sesión + shell)
dashboard/ Dashboard (KPIs + oportunidades del día)
clientes/ Lista, alta, edición, ficha, importar y exportar CSV
segmentos/ Clientes agrupados automáticamente
recordatorios/ "Hoy tenés que…" (cumpleaños / recompra / reactivar)
campanas/ Generador de envíos + plantillas editables
configuracion/ Datos del negocio y reglas de segmentación
actions.ts Server Actions (crear/editar/compras/config/import)
auth-actions.ts register / login / logout
components/
landing/ Reveal (scroll-in) y tarjeta de fidelidad (signature visual)
... UI reutilizable (shell, tarjetas, formularios)
lib/
auth.ts Hash de contraseña + sesiones en cookie
segmentation.ts Reglas de VIP / frecuente / inactivo / recompra
queries.ts Acceso a datos por negocio (aislado por sesión)
csv.ts Parser CSV + mapeo de columnas + fechas flexibles
build-message.ts Render de plantillas con variables {nombre} {negocio}
messages.ts Links wa.me y mailto (incluye contacto del negocio)
prisma/
schema.prisma Modelo de datos (Business, User, Session, Customer…)
seed.ts Datos demo + usuario demo
Diseño
- Tipografía: Calistoga (display, títulos) + Inter (cuerpo) + JetBrains Mono
(labels/eyebrows), cargadas vía
next/font/google en app/layout.tsx.
- Landing (
app/page.tsx): construida con ui-ux-pro-max
como referencia de sistema de diseño, adaptando la paleta genérica sugerida a
la identidad de marca ya establecida (verde + dorado). Elemento distintivo:
una tarjeta de fidelidad con sellos (components/landing/loyalty-card.tsx).
- Los CTA de la landing van a WhatsApp (
lib/messages.ts → businessWhatsappLink)
para pedir acceso — el alta de negocios es manual/personal, no autoservicio.
Módulos del MVP
- ✅ Acciones rápidas — botón "Nueva venta" (atajo de teclado
N) accesible desde
cualquier pantalla: buscá un cliente o cargá uno nuevo y registrá la venta en el
mínimo de clics, sin salir de donde estás. En mobile, un FAB con speed-dial (Nueva
venta / Nuevo cliente / Importar) siempre a mano.
- ✅ Base de clientes — alta/edición/baja, notas, etiquetas, búsqueda y filtros.
- ✅ Importación CSV — carga masiva desde Excel/Google Sheets con mapeo de columnas
auto-detectado, vista previa y descarte de duplicados (por teléfono o email).
- ✅ Registro de compras — actualiza automáticamente la última compra.
- ✅ Segmentación automática — VIP, frecuente, ocasional, nuevo, inactivo.
- ✅ Recordatorios — cumpleaños de la semana + recompra vencida + inactivos.
- ✅ Campañas — audiencias predefinidas; WhatsApp manual (link
wa.me con
mensaje listo) + email (mailto). Plantillas editables por el negocio.
- ✅ Estadísticas — ticket promedio, frecuencia, activos vs inactivos, ventas 30 días.
- ✅ Exportación CSV — descarga de toda la cartera (con segmento y totales), lista para Excel.
- ✅ Cuentas y multi-negocio — registro/login por email, sesión en cookie, datos
aislados por negocio.
Notas de arquitectura y próximos pasos
La base vive en Supabase (PostgreSQL). La app se conecta con Prisma usando dos
URLs: DATABASE_URL (pooler de transacciones, puerto 6543 — la usa la app en runtime,
ideal para serverless/Vercel) y DIRECT_URL (conexión directa, puerto 5432 — solo para
aplicar el esquema con prisma db push).
El aislamiento entre negocios se aplica hoy a nivel de aplicación (toda consulta
filtra por el businessId de la sesión). Para reforzarlo a nivel de base de datos se
puede activar Row Level Security en las tablas desde el dashboard de Supabase.
Pendiente para siguientes iteraciones:
- Row Level Security en las tablas de Supabase.
- Envío automático/masivo de emails (integrar Resend con
RESEND_API_KEY).
- API de WhatsApp Business para envíos automáticos.
- Programa de puntos/beneficios y estadísticas avanzadas.
