docs: guia de configuracion de una clinica/spa nuevo (todas las opciones por cliente + checklist de arranque y estado de fases)

docs/producto/configuracion-cliente.md

@@ -0,0 +1,147 @@
+# 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`](../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:
+1. **Roles**: crear roles propios del negocio (p. ej. Terapeuta, Estilista,
+   Recepción de fin de semana), renombrar, ajustar jerarquía y activar/desactivar.
+2. **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.
+3. **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 |