🐾
🐾 Guía completa · Versión 1.0

Manual de usuario

Todo lo que necesitas para operar el sistema de Luan Dog Spa & Boutique: recibir clientes, agendar, atender a cada mascota con cariño y llevar el negocio al día.

✂️ Agenda y cortes 🐶 Fichas de mascotas 🧾 Consentimiento imprimible 📊 Reportes y RRHH
👋
Sección 01

Bienvenida

Este sistema fue hecho a la medida para Luan Dog Spa & Boutique. Reúne en un solo lugar la agenda del día, la información de cada cliente y su mascota, la atención (baño, corte, cierre con fotos), el catálogo de cortes, los reportes del negocio y el módulo de personal.

¿Para quién es?

Para todo el equipo del spa: quien recibe en el mostrador, quien atiende a los perritos y quien administra. Cada persona ve lo que le corresponde según su rol.

¿Desde dónde se usa?

Desde el computador del mostrador (pantalla táctil o teclado y mouse). Está pensado para tocar con el dedo o usar el teclado, lo que te resulte más cómodo.

Un consejo antes de empezar: tómate 10 minutos para leer las secciones Roles y Agenda. Con eso ya puedes operar el día a día; el resto lo consultas cuando lo necesites.
🧑‍🤝‍🧑
Sección 02

Roles y accesos

El sistema tiene tres tipos de usuario. Cada uno ve solo lo que necesita para su trabajo — así la información sensible está protegida.

Administrador Recepcionista Groomer / Auxiliar
Puede…AdministradorRecepcionistaGroomer
Ver la agenda del día
Registrar clientes y mascotasNo
Ver datos de contacto del cliente (cédula, teléfono, correo, dirección)No
Agendar y editar citasNo
Registrar el servicio (intake) y cerrar la visitaNo
Agregar fotos a una visita
Reportes, RRHH, salarios, adelantos, ventasNoNo
Privacidad del groomer: el groomer ve la agenda completa del día y la información del perrito (para atenderlo bien), pero nunca ve los datos de contacto del cliente. Es una protección de datos que va por diseño, no un simple “ocultar en pantalla”.
🔑
Sección 03

Ingresar al sistema

  1. Abre el navegador y entra a la dirección del sistema.
  2. Escribe tu usuario y tu contraseña (te las entrega el administrador).
  3. Presiona Iniciar sesión. Verás tu pantalla de inicio según tu rol.
  4. Al terminar tu turno, usa Cerrar sesión — sobre todo en el computador del mostrador.
Cuida tu contraseña. No la compartas ni la dejes anotada a la vista. Si crees que alguien la conoce, pídele al administrador que la cambie. Tras varios intentos fallidos, el sistema bloquea el acceso unos minutos por seguridad.
📋
Sección 04

Pantalla de inicio (dashboard)

Apenas inicias sesión llegas a tu pantalla de inicio: te saluda por tu nombre (“Hola, …”), muestra tu rol y te resume cómo viene el día. Cada rol ve su propio panel — no es la misma pantalla para todos.

⏰ Próximas citas de hoy

Es el panel principal, arriba de todo, y está pensado para mirarlo de reojo mientras atiendes. Trae un reloj en vivo y va clasificando las citas del día solo:

  • En curso — la mascota que se está atendiendo en este momento.
  • Siguiente — la que viene, con su cuenta regresiva (“empieza en 25 min”, “empieza ya”). Cuando faltan menos de 15 minutos, se pone en naranja para que no se te pase.
  • Finalizada — las que ya terminaron; se apagan solas a medida que avanza el día.

Muestra hasta 6 citas para que el foco esté en el “ahora”, y con Abrir agenda saltas al calendario completo. Si aún no hay nada, verás “No hay citas para hoy”; cuando ya atendiste todo, “No hay más citas por hoy” junto a las últimas atendidas, como contexto.

El reloj se mueve solo: el panel se actualiza cada minuto sin que toques nada. Los números y gráficos de más abajo se calculan al entrar; si quieres el dato fresco después de un rato, recarga la página.

⚡ Accesos rápidos

Al lado de las citas tienes los botones del día a día, según tu rol:

  • Administrador y recepcionista: Nueva cita y Nuevo cliente.
  • Groomer: Ver agenda y Ver mascotas.

🔢 Los números del día (KPIs)

Debajo de la agenda hay una fila de tarjetas que cuentan cómo va el día:

  • Citas de hoy — el total del día, con el detalle “N confirmadas · N pendientes”. Al groomer le dice “Mis citas de hoy”, porque solo cuenta las suyas. Ojo: esos dos números no tienen por qué sumar el total. “Pendientes” son las agendadas y las que están esperando; “confirmadas”, las que el cliente confirmó. Las que ya arrancaron (en baño, en corte, deslanado) no están en ninguno de los dos grupos, así que la resta no cuadra — y está bien.
  • Mascotas atendidas hoy — cuántas visitas se cerraron hoy (al groomer, las que atendió él).
  • Clientes VIP ⭐ — total de clientes VIP. Administrador y recepcionista.
  • Clientes en riesgo — los que se pasaron de su ciclo habitual y conviene reactivar (ver Reactivación). Administrador y recepcionista.
  • Ingresos del día — el total de las ventas de baño registradas hoy (las que se anotan en RRHH → Ventas de baño diarias). Si todavía nadie las registró, muestra $ 0. Solo administrador.
  • Empleados en turno — cuántos marcaron entrada hoy. Solo administrador.

📈 Los gráficos

  • Citas por día — cómo viene el movimiento de los últimos 14 días.
  • Citas de hoy por estado — la torta del día: cuántas esperando, en baño, en corte, deslanadas… Aquí sí entran las canceladas y las de no asistió, para que veas el día completo.
  • Carga por groomer (hoy) — cuántas citas tiene cada groomer, para repartir parejo. Administrador y recepcionista.
  • Servicios más usados — el top 5 de los últimos 30 días. Administrador y recepcionista.
  • Clientes frecuentes — el top 5 de los últimos 30 días, con su corona si son VIP. Administrador y recepcionista.
  • Ventas de baño por día — los últimos 14 días en dinero. Solo administrador.

Si todavía no hay información en un período, el gráfico te lo dice con calma (“Sin citas en el periodo”, “Sin visitas registradas”) en vez de aparecer vacío.

¿Por qué la torta y la tarjeta no dan el mismo número? Es a propósito: “Citas de hoy” cuenta el trabajo real del día y por eso deja fuera las canceladas; la torta “Citas de hoy por estado” muestra todo lo que pasó, canceladas incluidas. Si un día ves la torta con más citas que la tarjeta, es que hubo cancelaciones.

Qué ve cada rol en el inicio

En la pantalla de inicio…AdministradorRecepcionistaGroomer
Próximas citas de hoy y accesos rápidosSolo las suyas
Citas de hoy · Mascotas atendidas hoySolo las suyas
Citas por día · Citas de hoy por estadoSolo las suyas
Clientes VIP · Clientes en riesgoNo
Carga por groomer · Servicios más usados · Clientes frecuentesNo
Ingresos del día · Ventas de baño · Empleados en turnoNoNo
La privacidad también manda aquí: el dinero solo existe para el administrador — al resto ni siquiera se le calcula, no es que se le esconda en pantalla. Y ningún panel del inicio muestra cédula, teléfono, correo ni dirección: las citas van solo con mascota, servicio y hora.
Si prefieres menos movimiento: el panel tiene animaciones suaves (los números suben contando, las barras crecen). Si en tu computador o celular activaste “reducir movimiento”, el sistema lo respeta y las apaga — los colores y las etiquetas En curso / Siguiente se mantienen, porque son información, no adorno.
🐶
Sección 05

Clientes y mascotas

Cada cliente puede tener hasta 6 mascotas y un segundo propietario (por ejemplo, la pareja o un familiar que también trae al perrito).

Para encontrar un cliente, usa el buscador de la parte superior: escribe parte del nombre (no importan las tildes: “gomez” encuentra a “Gómez”), el teléfono, o la cédula completa. Al tocar un cliente se abre su ficha a pantalla completa, con sus datos, mascotas y el historial a un clic.

Registrar un cliente nuevo

  1. Ve a Clientes y presiona Nuevo cliente.
  2. Completa nombre, documento y datos de contacto. Acepta el aviso de tratamiento de datos (Ley 1581).
  3. Agrega la o las mascotas: nombre, raza, tamaño y la ficha clínico-conductual (alergias, salud, comportamiento).
  4. Guarda. El cliente ya queda disponible para agendar.

Ficha de la mascota

Registra comportamiento (tranquilo, nervioso, agresivo…), alergias, condiciones de salud y notas de manejo. Esta información la ve todo el equipo — incluido el groomer — para atender con seguridad.

Cliente VIP ⭐

El administrador puede marcar a un cliente como VIP. Queda distinguido con una corona dorada en su ficha y en los reportes. También hay un VIP automático para los más frecuentes.

Campos a la medida: el administrador puede crear campos personalizados para la ficha de la mascota (por ejemplo, número de chip o tipo de pelaje). Aparecen automáticamente en el formulario.
📅
Sección 06

Agenda y citas

La agenda muestra las citas como bloques (estilo Google Calendar): cada cita ocupa el alto de su duración e indica la mascota, el servicio, la hora, el estado y el groomer que atiende (👤). Las citas a la misma hora se muestran lado a lado.

🗓️ Tres formas de ver la agenda

Con el selector [Día] [Semana] [Mes] arriba a la derecha eliges cómo ver el calendario:

  • Día — el día completo hora por hora, con cada cita como un bloque. Ideal para trabajar en el mostrador.
  • Semana — los 7 días de la semana en columnas, para ver de un vistazo cómo viene la semana.
  • Mes — el mes completo tipo calendario; cada día muestra sus citas (y "+N más" si son muchas). Toca un día para saltar a su vista de Día.

Con las flechas ‹ › avanzas o retrocedes (por día, semana o mes según la vista) y con Hoy vuelves a la fecha actual.

Crear una cita

Al presionar Nueva cita se abre un formulario ordenado en tres preguntas: ¿Quién? (el cliente y su mascota), ¿Qué? (servicio y groomer) y ¿Cuándo? (fecha y horario). Se llena de arriba hacia abajo.

  1. En Agenda, presiona Nueva cita.
  2. Busca al cliente escribiendo en el campo Cliente (ver abajo) y elígelo de la lista.
  3. Elige la mascota, y luego el servicio, el groomer, la fecha y el horario.
  4. Presiona Crear cita. Aparece en su franja. Si el groomer ya tiene otra cita a esa hora, el sistema te advierte del cruce.
El botón espera por ti: Crear cita permanece desactivado hasta que hayas elegido cliente y mascota, y el pie del formulario te dice qué falta. Así no se guardan citas a medias.

🔎 Buscar al cliente (por nombre, cédula o teléfono)

El campo Cliente es un buscador: en lugar de desplegar una lista enorme, escribes lo que tengas a mano y el sistema muestra las coincidencias. Puedes buscar por cualquiera de estos tres datos en el mismo campo, sin elegir antes “por cuál busco”:

  • Nombre o apellido — con escribir un pedazo basta, y no importan las tildes: “gomez” encuentra a “Gómez”. También puedes escribir nombre y apellido juntos (“maría gómez”).
  • Teléfono — un pedazo del número sirve, con o sin espacios o guiones.
  • Cédula — aquí sí debe ir completa: por seguridad la cédula se guarda cifrada, así que solo se puede buscar exacta (un pedazo no la encuentra). Si buscas por cédula, escríbela entera.

Cada resultado muestra el nombre, la cédula (solo los últimos dígitos, por privacidad), el teléfono y las mascotas del cliente — así distingues fácil a dos personas con el mismo nombre. Los clientes VIP ⭐ salen marcados. Elige el correcto con el dedo o con las flechas del teclado y Enter.

El buscador se guarda solo: al elegir al cliente, el campo se recoge en una tarjeta pequeña con su nombre y teléfono, y aparece un botón Cambiar por si te equivocaste. Debajo aparecen sus mascotas.
Si dice “No pudimos buscar”: es un problema de conexión, no quiere decir que el cliente no exista. Presiona Reintentarno crees un cliente nuevo, porque quedaría duplicado y su historial se partiría en dos. Solo cuando el buscador diga claramente “Sin resultados” es que el cliente no está registrado.

🐶 Elegir la mascota

Después de elegir al cliente, sus mascotas aparecen debajo:

  • Si tiene una sola, queda elegida automáticamente (te lo avisa: “Única mascota — ya elegida”). No tienes que hacer nada.
  • Si tiene varias, aparecen como tarjetas con el nombre y la raza; toca la que viene hoy.
¿No aparece el cliente? Si de verdad no está registrado, el buscador ofrece “Crear cliente …” como última opción: abre el registro de cliente con el dato que ya escribiste, para que no lo teclees de nuevo. (Ver Clientes y mascotas.)

Estados de la cita

Cada estado se distingue por color + ícono + nombre (no solo por color, para que se entienda a simple vista):

Agendada
Confirmada
⏳ Esperando
🛁 En baño
✂️ En corte
✅ Deslanado
🚫 Cancelada
❌ No asistió

⏱️ Duración de la cita (hora de inicio y hora de fin)

Cada servicio dura lo que tenga que durar: al crear o editar una cita eliges dos horas — la de inicio y la de fin — como si movieras dos relojes. Debajo verás la duración calculada en vivo (por ejemplo, "Duración: 1 h 30 min").

  • La cita ocupa exactamente ese rango en la agenda (por ejemplo, "09:30–11:00").
  • La hora de fin no puede ser anterior ni igual a la de inicio: si te equivocas, el sistema te avisa y no te deja guardar hasta corregirlo.
  • La duración mínima es de 15 minutos, y la cita debe terminar dentro del horario de atención (no pasa del cierre).
Cruce de horarios: si intentas ponerle a un mismo groomer dos citas que se solapan (aunque sea por unos minutos), el sistema te lo advierte. Dos citas que solo se tocan (una termina justo cuando empieza la otra) sí se permiten. Groomers distintos pueden atender a la misma hora sin problema.

Vista Compacto / Detalle

Con el selector de densidad cambias entre tarjetas compactas (más citas a la vista) y tarjetas con la foto de la mascota y más contexto. El sistema recuerda tu preferencia.

Cancelar una cita

Cancelar pide confirmación (no es un cambio de estado rápido) porque queda registrado. Así se evita cancelar por error.

🛁
Sección 07

Atención de la mascota

Cuando llega el perrito, se registra el servicio (intake) y, al terminar, se cierra la visita con las fotos y las notas.

1 · Registrar el servicio (intake)

  • Elige el servicio base (Baño Hydra o Baño Básico) — es obligatorio.
  • Agrega los adicionales que apliquen (corte de uñas, deslanado, limpieza de oídos…).
  • Anota si el cliente trae shampoo propio y el corte deseado del catálogo.
Atajo “Repetir última visita”: para un cliente recurrente, con un botón precargas el mismo servicio, adicionales y corte de la vez anterior. Luego ajustas lo que cambie y confirmas.

2 · Cerrar la visita

Al terminar el servicio, registra el cierre con toda la información de la atención:

  • Fotos antes y después.
  • Anomalías detectadas y comportamiento durante el proceso.
  • Quién atendió (groomer), descripción del corte, recomendaciones y tiempo del servicio.
Fotos: usa imágenes livianas. Si la foto es muy pesada, el sistema te avisa para que subas una más liviana; no te deja el proceso “colgado”.
🧾
Sección 08

Consentimiento y entrega

Antes del servicio, el cliente firma un consentimiento que se imprime en tirilla. Al entregar, firma el “recibido conforme”.

Consentimiento (antes)

Desde la cita, presiona Imprimir consentimiento. Salen 2 copias (una para el cliente y una para el spa) con los datos del cliente y la mascota, el servicio, el texto de responsabilidad y el espacio de firma. Si la impresora falla, puedes reintentar o exportar a PDF.

Entrega conforme (después)

Cuando el servicio termina y se entrega la mascota, se genera el acta de entrega “recibido conforme” para la firma del cliente. Queda registrado con fecha y hora.

Nota legal: los textos de consentimiento y de entrega deben ser revisados y aprobados por un abogado antes de usarse con clientes reales. Pregúntale al administrador si ya están en su versión definitiva.
📖
Sección 09

Historial de visitas

Cada mascota tiene su historial de visitas, accesible desde su ficha con el botón Ver historial. Cada entrada muestra la fecha, el servicio, el resultado y quién atendió.

Historial inmutable: solo la última visita se puede editar. Las visitas anteriores quedan en solo lectura 🔒 — así el historial es confiable. Si el administrador necesita corregir una visita antigua, puede hacerlo con una excepción justificada que queda registrada.

Vista del groomer

El groomer ve las 2 visitas más recientes de la mascota (para saber cómo se atendió antes), siempre sin datos de contacto del cliente.

Editar la última visita

Recepción puede ajustar la última visita (corte, recomendaciones, agregar fotos) mientras siga siendo la más reciente.

🧴
Sección 11

Servicios (baños y adicionales)

En Servicios (solo administrador) defines los baños y adicionales del spa. Aquí es donde creas un servicio nuevo — por ejemplo un “Baño premium con shampoo especial” — o ajustas los que ya existen.

Crear o editar un servicio

  1. Ve a Servicios y presiona Nuevo servicio (o Editar en uno existente).
  2. Escribe el nombre y elige el tipo: Base (el servicio principal, p. ej. un baño) o Adicional (se suma al base, como corte de uñas o deslanado).
  3. Opcional: pon un precio de referencia y una descripción.
  4. Guarda. El servicio queda disponible de inmediato para elegir en la agenda y en la atención.

Base vs. Adicional

Un servicio base es el corazón de la visita (Baño Hydra, Baño Básico…). Los adicionales se agregan sobre el base (corte de uñas, limpieza de oídos, deslanado…). El tipo define dónde aparece al registrar la atención.

Desactivar en vez de borrar

Si dejas de ofrecer un servicio, desactívalo: deja de aparecer al agendar, pero se conserva en el historial de las visitas que ya lo usaron. Los servicios no se borran, para no perder registros pasados.

El precio es de referencia, no un cobro: sirve para cotizar — se muestra al elegir el servicio (por ejemplo “Baño Hydra · $45.000”). El sistema no cobra ni suma totales (no es una caja). Un servicio sin precio simplemente muestra su nombre. El precio lo ven el administrador y la recepción; al groomer no se le muestra.
💬
Sección 12

Confirmación por WhatsApp

El sistema puede enviar al cliente un mensaje de WhatsApp para confirmar o recordar su cita; el cliente responde “Confirmo” o “Cancelo” y la cita se actualiza sola.

Requiere activación: esta función necesita el número propio de Luan habilitado en WhatsApp y sus plantillas aprobadas. Mientras no esté activada, el sistema no envía mensajes automáticos, pero todo lo demás funciona con normalidad. Consulta con el administrador el estado de la activación.
📊
Sección 13

Reportes

En Reportes (solo administrador y recepción según el reporte) eliges un rango de fechas y ves los indicadores del negocio.

Clientes frecuentes

Ranking de clientes por número de visitas en el período. Los VIP aparecen con su corona.

Servicio más usado

Cada servicio con su conteo de uso, de mayor a menor.

📈
Sección 14

Reactivación (churn) y VIP

El reporte de reactivación (administrador) detecta clientes que dejaron de venir: el sistema estima cada cuánto suele venir cada cliente (su cadencia) y, si se pasa de su ciclo habitual, lo marca en riesgo mostrando su cadencia estimada y los días de atraso.

  • Filtras por “más de X días de atraso” y ordenas por el atraso mayor primero.
  • Con el botón 📲 Recordar le envías un recordatorio por WhatsApp para invitarlo a volver (queda registrado el contacto).
  • El VIP automático marca a los clientes más frecuentes (top 50) sin quitar los VIP que pusiste a mano.
🧑‍💼
Sección 15

Recursos Humanos

El módulo de RRHH es solo para el administrador. Aquí se gestiona el personal y la información sensible (salarios, adelantos), que nadie más ve.

Perfil de empleado

Crea y edita empleados: nombre, documento, cargo, salario base, horario y fecha de ingreso. Puedes vincular al empleado con su cuenta de acceso al sistema.

Adelantos de sueldo

Registra adelantos por empleado (monto, fecha, nota) y consulta el historial. El monto es información sensible: solo el administrador lo ve.

Ventas de baño diarias

Registra cuántos baños se vendieron cada día. Recepción puede llevar el conteo; el total en dinero solo lo ve y edita el administrador.

Reporte por empleado

Horas trabajadas, horas extra, número de marcajes y adelantos de cada empleado en el período elegido.

⏱️
Sección 16

Marcaje y horas extra

Cada empleado registra su entrada y salida desde la pantalla de Marcaje, usando su PIN o su firma en pantalla. No se usa biometría.

Cómo marca un empleado

  1. Abre Marcaje en el computador del mostrador.
  2. Selecciona tu nombre e ingresa tu PIN en el teclado numérico (o firma en el recuadro).
  3. El sistema registra entrada si no tienes un turno abierto, o salida si ya marcaste entrada.
  4. Al cerrar el turno, calcula automáticamente las horas extra según tu jornada.
  • El administrador asigna y restablece el PIN de cada empleado (nunca se muestra en pantalla).
  • Tras varios PIN incorrectos seguidos, el marcaje se bloquea unos minutos por seguridad.
  • El administrador puede revisar y corregir un marcaje si hizo falta; queda registrado.
🛡️
Sección 17

Privacidad y datos

El sistema cuida los datos personales de acuerdo con la ley colombiana (Ley 1581 de datos y Ley 1480 del consumidor):

  • La cédula del cliente se guarda cifrada; el groomer nunca ve datos de contacto.
  • Se registra quién ve o imprime información sensible (auditoría), sin exponer los valores.
  • El cliente autoriza el tratamiento de sus datos al registrarse.
Tu parte: maneja con discreción los datos de los clientes, no dejes sesiones abiertas y cierra sesión al terminar tu turno.
Sección 18

Preguntas frecuentes

No puedo ver el módulo de Reportes o RRHH

Esos módulos son solo para el administrador (RRHH) o para roles autorizados (algunos reportes). Si crees que deberías tener acceso, coméntalo con el administrador.

El groomer dice que no ve el teléfono del cliente

Es correcto y a propósito. El groomer ve la información de la mascota para atenderla, pero nunca los datos de contacto del cliente. Es una protección de datos.

No puedo editar una visita antigua

El historial es inmutable: solo la última visita se edita. Las anteriores quedan en solo lectura 🔒. Si de verdad hay que corregir una, el administrador puede hacerlo con una excepción justificada.

La foto no se sube

Probablemente sea muy pesada. El sistema te lo avisa; sube una imagen más liviana y listo.

El sistema no envía WhatsApp

Esa función se activa por separado (número y plantillas de WhatsApp de Luan). Mientras no esté activada, no se envían mensajes automáticos, pero el resto funciona normal.

Olvidé mi contraseña / mi PIN

El administrador la restablece. Por seguridad, nadie más puede verla.

¿Dudas que no están aquí? Habla con el administrador del spa o con el equipo de soporte que te instaló el sistema. Este manual se irá ampliando con el uso.