# 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 |