Backend: vision general
Que cubre cutlyy-back
cutlyy-back es la API y la capa operativa que protege la logica del negocio. Su papel principal es asegurar que Cutlyy no sea solo una interfaz bonita, sino un sistema consistente.
El backend se encarga de:
- validar reglas de negocio
- persistir informacion en Firestore
- proteger acceso segun sesion y contexto de negocio
- sincronizar bookings y appointments
- recalcular metricas
- ejecutar automatizaciones y notificaciones
Que dominios atiende
Los modulos principales expuestos hoy cubren:
- autenticacion
- negocios
- planes
- sedes
- servicios
- membresias
- usuarios
- bookings
- appointments
- reseñas
- metricas
- roles, permisos y modulos
- push notifications
- mensajeria de WhatsApp
Que es fuente de verdad en backend
Cuando existe una duda sobre comportamiento real, el backend es la referencia final para temas como:
- quien puede hacer una accion
- si una reserva es valida
- si hay cupo disponible por plan
- como se recalculan pagos y metricas
- que automatizaciones se disparan
Relacion con el frontend
| Tema | Frontend | Backend |
|---|---|---|
| UX | Guia la navegacion y muestra formularios | No participa directamente |
| Validacion liviana | Previene errores obvios | Aplica validacion definitiva |
| Persistencia | No guarda dominio core por si solo | Guarda y sincroniza datos |
| Estados del flujo | Los presenta | Los decide y protege |
| Automatizaciones | Muestra resultado | Programa y ejecuta procesos |
Ciclo tipico de una peticion
Runtime y stack
| Area | Tecnologia |
|---|---|
| Runtime | Node.js 22 |
| Lenguaje | TypeScript |
| Servidor | Express 5 |
| Persistencia | Firestore |
| Auth | Firebase Admin |
| Automatizaciones | Google Cloud Tasks |
| Infobip | |
| Push | Firebase Cloud Messaging |
Responsabilidades mas sensibles
- multiempresa por
businessId - control de suscripcion y plan
- consistencia entre bookings y appointments
- manejo de empleados, membresias y roles
- reconciliacion de cupos