Cromados

Cromados es un sistema para barberías que unifica en un solo producto:

• Cliente: reserva turnos online en minutos.
• Dueños/Admin: gestionan sucursales, barberos, servicios, horarios y turnos desde un panel.
• Barberos: operan el día a día con un bot de Telegram (agenda, mover/agendar turnos, descansos, desbloqueos y adicionales).

Nota: cuando digo WhatsApp Bot, me refiero a mensajes automáticos de confirmación/recordatorio enviados por WhatsApp. A nivel técnico está implementado con Twilio + plantillas.

---

Problema

La gestión por mensajes suele generar:

• turnos duplicados,
• cambios sin registro,
• poca visibilidad de disponibilidad real,
• dependencia del dueño para coordinar todo.

---

Solución

Un flujo end-to-end con agenda real y superficies separadas por rol:

• Web pública para reservas (cliente),
• Panel admin para operación (dueños),
• Bot Telegram para operación diaria del barbero,
• Pagos integrados (opcional según configuración),
• Notificaciones por WhatsApp Bot (confirmación + recordatorio).

---

Flujo end-to-end (lo importante)

1. Cliente elige sucursal → barbero → servicio(s) → fecha/hora disponible
2. Confirma la reserva (y paga si aplica)
3. El sistema registra estado de turno y pago (webhook/callback)
4. Se disparan notificaciones:
   • WhatsApp Bot (Twilio): confirmación y recordatorio al cliente
   • Telegram Bot: operación interna del barbero (agenda y gestión)

---

Funcionalidades por rol

1) Cliente (Web pública)

• Reserva guiada: sucursal → barbero → servicios → disponibilidad
• Disponibilidad por fecha (horarios reales por barbero)
• Confirmación final del turno
• Checkout de pago (si corresponde)

2) Dueños / Admin (Panel)

Operación completa sin planillas:

• Sucursales: altas/edición
• Barberos: gestión y (si aplica) foto/visibilidad
• Servicios (tipo de corte): CRUD + activar/desactivar + asignación de barberos habilitados
• Horarios: configuración operativa (incluye días excepcionales si aplica)
• Turnos: listado, estados, acciones operativas
• Calculadora de pagos: herramienta interna para liquidaciones

Estados de turnos

• PENDIENTE, RESERVADO, CONFIRMADO, CANCELADO (según operación y flujo de pago)

3) Barberos (Bot de Telegram)

Bot pensado para operar rápido sin entrar al panel:

Menú / comandos principales

• /turnos — ver próximos turnos
• /disponibilidad — consultar horarios libres
• /servicios — ver servicios y precios
• /agendar — agendar turno presencial
• /adicional — agregar servicios adicionales a un turno
• /fijos — crear turnos recurrentes
• /mover — mover un turno a otra fecha/hora
• /descanso — bloquear horarios (descanso/almuerzo)
• /desbloquear — liberar turno bloqueado
• /menu — mostrar menú

Qué resuelve

• Turnos presenciales (bloqueos)
• Reprogramaciones con flujo guiado
• Bloqueos por descanso
• Desbloqueo con distinción clara:
  • 🔒 turno presencial
  • 📱 turno desde la app (con pago)
  • 😴 descanso

---

Integraciones

Pagos (Mercado Pago)

• Checkout para generar preferencia y redireccionar al flujo de pago
• Retorno (back URLs)
• Webhook para actualizar estado de pago de forma asíncrona (validación de firma)

WhatsApp Bot (Twilio)

• Confirmación de reserva
• Recordatorio previo al turno
• Envíos mediante plantillas (no spam, no marketing masivo)

Telegram Bot (interno)

• Operación diaria del barbero y tareas operativas sin tocar el panel web

---

Stack

• Backend: Java + Spring Boot
• Frontend: React + TypeScript + Tailwind
• DB: PostgreSQL
• Infra/Deploy: Linux/VPS (según entorno)

---

Seguridad y confiabilidad (sin humo)

• Separación de superficies (público vs admin vs bots)
• Validación de datos y reglas de agenda
• Webhooks de pago controlados (firma/headers)
• Secrets por variables de entorno (no hardcode)

---

Evidencia visual

Cliente

Admin

(Las capturas del Bot de Telegram y WhatsApp se omiten por privacidad, pero la funcionalidad está descrita arriba)

---

Qué incluye / Qué no incluye

Incluye

• Web de reservas (cliente)
• Panel admin (operación)
• Bot Telegram (barberos)
• Pagos integrados (Mercado Pago)
• WhatsApp Bot (Twilio) para confirmación y recordatorio

No incluye (se cotiza aparte)

• Integraciones nuevas fuera del alcance (ej: CRM, facturación, analytics avanzados)
• Canales de marketing masivo / campañas
• Multi-tenant SaaS (si el negocio lo requiere, cambia el alcance)

---