Configuración de una clínica / spa nuevo

Guía de puesta en marcha de una instancia del sistema (producto multi-giro). Todo lo que sigue se configura desde la interfaz, sin tocar código.

Para crear la instancia (base de datos, puerto, servicio, dominio, secretos y primer usuario admin) usa el script de provisioning: ver nueva-instancia.md. Esta guía empieza cuando la instancia ya está levantada y con sesión de administrador.

1. Identidad de la clínica

Configuración → Clínica → Identidad

Qué	Efecto
Nombre comercial	Login, títulos, tickets, documentos y mensajes
Logo claro / oscuro	Sidebar, login y tema claro
Pie de página	Login y documentos impresos
Color primario / acento	Se aplican en vivo sobre los 3 temas; vacío = tema original
URL pública	Base para enlaces de pago, correos y el enlace de reservas

2. Terminología (giro del negocio)

Configuración → Terminología

Elige el pack según el negocio y ajusta cualquier término a mano:

Pack	Paciente	Cita	Visita	Expediente	Médico	Cabina
Clínica (default)	Paciente	Cita	Visita	Expediente	Médico	Cabina
Spa / Wellness	Cliente	Reserva	Sesión	Ficha	Terapeuta	Sala
Estética	Cliente	Cita	Sesión	Ficha	Especialista	Cabina
Dental	Paciente	Cita	Consulta	Expediente	Odontólogo	Consultorio

El pack cambia menús, títulos, botones, estados y también los mensajes de notificación y el portal público de reservas.

3. Operación

Configuración → Clínica (datos y horarios)

Teléfono, email, dirección, sitio web, RFC, nota de ticket.
Horario de apertura y cierre: define la rejilla de la agenda (default 08:00–19:00).
Zona horaria y moneda base.

Configuración → Sucursales: alta de sedes (nombre, código, dirección, teléfono) y cuál es la predeterminada. Cada cita pertenece a una sucursal. Las sucursales con histórico no se borran: se desactivan.

Configuración → Categorías de servicios: las 4 categorías base (Consulta, Tratamiento, Procedimiento, Paquete) se pueden renombrar y se pueden crear más (p. ej. "Depilación", "Faciales"). Las de sistema no se borran.

4. Catálogo y precios

Servicios: nombre, categoría, precio, duración (define el tamaño del bloque en la agenda), paquete y tasa de impuesto.
Inventario: artículos, consumibles (con caducidad, que bloquea la venta al vencer) y su tasa de impuesto.
Los precios se editan en Servicios / Inventario; el POS y la agenda los toman de ahí.

5. Impuestos

Configuración → Clínica → Impuestos (apagado por defecto)

Activar impuestos, nombre (p. ej. IVA), tasa por defecto y catálogo de tasas.
Precios incluyen impuesto: si el precio capturado ya trae impuesto, el sistema lo desglosa automáticamente.
Con impuestos activos: desglose en POS, tickets, estado de cuenta y reporte Reportes → Impuestos (por mes, servicio y sucursal, exportable).

6. Reservas en línea (portal del cliente)

Configuración → Reservas en línea (apagado por defecto)

Activar el portal y compartir el enlace /reservar de la clínica (el propio panel muestra el enlace listo para copiar).
Opciones: título y descripción visibles al cliente, confirmación manual o automática de la cita reservada, permitir elegir especialista, permitir elegir sucursal, máximo de días a futuro, anticipación mínima, teléfono de contacto, mensaje de confirmación y política de cancelación (si el cliente puede cancelar y con cuántas horas de anticipación).
El cliente recibe un enlace propio para consultar o cancelar su cita. Las reservas que llegan por el portal se distinguen en la agenda.

7. Usuarios, roles y permisos

Configuración → Usuarios: alta de usuarios, rol, menús visibles y, para agenda, las 5 acciones específicas (consultar, agendar, editar, eliminar, generar visitas).

Configuración → Roles: tres pestañas:

Roles: crear roles propios del negocio (p. ej. Terapeuta, Estilista, Recepción de fin de semana), renombrar, ajustar jerarquía y activar/desactivar.
Permisos: 43 permisos por acción agrupados en 9 módulos, con botones todo/ninguno. El backend los hace cumplir aunque el usuario manipule la interfaz.
Menús: qué sección ve cada rol.

Recomendación: partir del rol más parecido, ajustar y guardar.

8. Notificaciones

Configuración → Notificaciones (apagado por defecto, con modo prueba)

Recordatorios automáticos antes de la cita (varias ventanas: 2 h, 24 h, 1 semana…), confirmación al reservar en línea, felicitación de cumpleaños, seguimiento post-visita y recuperación de pacientes que no se presentaron.
Canales: WhatsApp y correo. Plantillas editables con vista previa.
Modo prueba: registra lo que se habría enviado sin contactar a nadie — úsalo para revisar textos antes de encenderlo.
Historial de notificaciones enviadas por paciente y por cita, con reintento.

9. Tickets y documentos

Configuración → Tickets: ancho (58/80 mm), fuente, logo y qué secciones se imprimen (incluida la de impuestos). Se aplica al ticket de venta y al de reimpresión.

Checklist de arranque

Identidad: nombre, logos, colores, URL pública.
Terminología: pack del giro + ajustes finos.
Horarios, zona horaria, sucursales, categorías.
Catálogo de servicios con precios y duraciones.
Inventario y consumibles (caducidades).
Impuestos (tasa por defecto + tasas por servicio/artículo).
Usuarios y roles/permisos.
Reservas en línea (activar y difundir el enlace).
Notificaciones en modo prueba → revisar textos → encender.
Tickets: formato y secciones.
Confirmar que las credenciales del admin se cambiaron.

Estado del producto por fases

Fase	Alcance	Estado
1	Capa de configuración (terminología, sucursales, categorías, ajustes, colores, horarios, URLs de pago), defaults neutros, provisioning de instancias	Entregado
2.1	Roles y permisos editables (43 permisos)	Entregado
2.2	Impuestos configurables	Entregado
2.3	Portal público de reservas en línea	Entregado
2.4	Recordatorios y notificaciones automáticas	En curso
2.5	Consentimientos y formularios digitales con fotos	Pendiente
2.6	Membresías y suscripciones	Pendiente
3	Recursos en agenda, compras/proveedores, comisiones por reglas, PWA, i18n, API keys/webhooks, panel multi-cliente	Pendiente

6.6 KiB Raw Blame History Unescape Escape