Agenda — vista calendario

Vista diaria multi-columna. Columnas son tus recursos, filas son las horas. Cada turno es un bloque de color por estado.

La Agenda es la vista calendario diaria de tus reservas. Es la pantalla más visual del bucket: en columnas ves tus recursos activos (Diego, Valentina, Sala Grupal...) y en filas ves las horas del día de 7:00 a 22:00. Cada turno se renderiza como un bloque de color sobre el grid, posicionado según su horario de inicio y altura proporcional a la duración del servicio. El color del bloque indica el estado de la reserva: amarillo pending, verde confirmado, gris completado, rojo no-show, las canceladas no aparecen.

La navegación es simple: tres botones arriba — día anterior, Hoy (jump al día actual), día siguiente. Te mueves por días uno a uno; no hay vista semanal o mensual todavía. Esto es deliberado: la agenda del MYPE se gestiona día por día y la vista diaria es la única que da claridad suficiente sobre los conflictos y los huecos.

Al hacer click en un bloque de turno, se abre un modal con el detalle: cliente, servicio, horario, estado actual, link de tracking, botones de acción rápida (confirmar / cancelar / completar). Es la forma rápida de gestionar turnos sin salir de la vista calendario. Para la vista completa de un turno (con timeline + notas), entra al detalle desde el modal con «Ver detalle completo».

La agenda NO incluye reservas canceladas (sería ruido visual). Si quieres revisar canceladas, usa la sub-tab Lista con filtro de estado.

Manual completo

Abrir la agenda

  1. Entra a Reservas › Agenda.
  2. Por default ves el día de hoy (zona horaria America/Lima).

Navegar entre días

Botón Acción
Día anterior.
Hoy Salta al día actual.
Día siguiente.

Encima del grid se muestra la fecha actual seleccionada: «Lunes 19 de mayo de 2026». El día seleccionado persiste mientras estés en la pantalla — al salir y volver, vuelve a hoy.

Los colores de los bloques

Color Estado Significado
🟡 Amarillo Pending Reserva nueva, sin confirmar. Esperando tu decisión.
🟢 Verde Confirmed Confirmaste — el slot está apartado.
⚫ Gris Completed Pasó el turno y lo marcaste como atendido.
🔴 Rojo No-show El cliente no apareció. Cuenta para el rate de no-shows.
(no aparece) Cancelled Reservas canceladas no se muestran en la agenda — solo en Lista.

El bloque también muestra el color base del recurso como acento lateral, para que reconozcas de un vistazo de qué recurso es el turno. Si dos recursos tienen turnos a la misma hora, los ves uno al lado del otro en columnas distintas.

Qué muestra cada bloque

Dentro de cada bloque ves:

  • Hora de inicio (ej. «11:00»).
  • Nombre del cliente (snapshot al momento de la reserva).
  • Nombre del servicio (corte / tinte / yoga).
  • Duración implícita por la altura del bloque sobre el grid.

Los bloques solapados (dos confirmaciones en el mismo recurso al mismo tiempo) no deberían existir porque el state machine los previene. Si por alguna razón ves dos turnos superpuestos en la misma columna, contáctanos por WhatsApp para revisar.

El grid de horas

  • El grid muestra de 7:00 AM a 10:00 PM (15 horas).
  • Cada fila representa 30 minutos.
  • La altura de cada bloque se calcula proporcional a su duración: un servicio de 30 min ocupa una fila, uno de 60 min ocupa dos filas, etc.

Si tienes turnos antes de las 7am o después de las 10pm, no aparecen en la agenda. Por ahora es un rango fijo. Si tu negocio opera 24h (delivery nocturno, etc.), avísanos.

Modal de detalle rápido

Click en un bloque abre el modal con:

  • Datos del cliente: nombre + WhatsApp + email (si dio).
  • Servicio + recurso + hora exacta.
  • Estado actual con su badge de color.
  • Notas del cliente (lo que dejó en comentarios al reservar).
  • Botones de acción: confirmar, cancelar, completar, marcar no-show, reabrir — según el estado actual del turno.
  • Link de tracking público copiable.
  • Botón «Ver detalle completo» que te lleva a la página completa del turno, con timeline y notas internas.

Acciones rápidas desde el modal

Los botones disponibles dependen del estado actual del turno:

Estado actual Botones disponibles
Pending Confirmar · Cancelar
Confirmed Marcar completado · Marcar no-show · Cancelar
Completed Reabrir (vuelve a pending)
No-show Reabrir (vuelve a pending)
Cancelled Reabrir (vuelve a pending)

Al confirmar un pending desde la agenda, el sistema corre el state machine atómico: aparta el slot, auto-rechaza otros pendings del mismo slot, manda email a los rechazados con alternativas. Más en Booking.

Cuándo usar Agenda vs Lista

Caso Usa
Ver el día completo y los huecos disponibles Agenda
Buscar a un cliente específico Lista (tiene búsqueda por nombre/WA)
Filtrar solo pendings por confirmar Lista (con filtro de estado)
Ver canceladas / no-shows Lista (Agenda no las muestra)
Detectar conflictos visuales (dos turnos solapados) Agenda
Cambiar estados en lote rápido Lista

La Agenda es la vista de operación del día. La Lista es la vista de búsqueda y gestión amplia. Las dos comparten datos — los cambios en una se reflejan en la otra al recargar.

El día sin reservas

Si el día seleccionado no tiene reservas, el grid queda vacío con las columnas de recursos pero sin bloques. Es buena señal de que tienes capacidad libre para promocionar.

Recursos archivados

Los recursos archivados no aparecen como columnas en la agenda — solo verás los recursos activos. Si necesitas ver el histórico de un recurso archivado, usa la Lista con filtro de recurso (que sí los incluye en el dropdown).

FAQ

¿Puedo arrastrar un turno a otra hora? Hoy no. Drag-to-reschedule está diferido a una versión futura. Por ahora, para mover un turno, abre el detalle, cancela el turno actual y crea uno nuevo en la hora correcta. O escribíle al cliente por WhatsApp y deja que él se mueva desde el picker.

¿Cómo veo la próxima semana de un vistazo? La vista semanal no existe todavía. Navega día a día con las flechas. Para vista resumen amplia, usa la Lista con filtros.

¿Las reservas en pending bloquean visualmente el slot? Sí — el bloque amarillo ocupa el espacio en el grid igual que un confirmado. Pero atrás, el slot NO está apartado (filosofía WhatsApp-first). Si quieres ver qué slots realmente están libres para nuevas reservas, mira solo los huecos sin bloques de cualquier color salvo los blanco/vacíos.

¿Puedo crear una reserva manual desde la agenda? Hoy no directamente. La creación manual de reservas por el dueño está en roadmap. Por ahora, todas las reservas se crean desde el picker público — si quieres crear una reserva offline (cliente te llamó por teléfono), abre mypes.pe/{tu-slug}/reservar y completa el form como si fueras el cliente.

¿Los bloques tienen tooltip al pasar el mouse? Sí, en desktop. Pasas el mouse sobre el bloque y ves el detalle resumido (cliente, servicio, hora exacta).

¿En móvil cómo se ve la agenda? Cada columna se vuelve scroll horizontal. Es funcional pero apretado — para móvil, recomendamos usar la Lista que tiene mejor UX en pantallas chicas.

¿Por qué un turno se ve cortado abajo? Si el turno empieza cerca de las 22:00 y dura 60 min, el bloque visualmente se corta en 22:00 (límite del grid). El turno real existe igual y termina a las 23:00 — solo la representación visual se trunca. Si tienes turnos nocturnos frecuentes, avísanos para extender el rango del grid.