diff --git a/docs/producto/configuracion-cliente.md b/docs/producto/configuracion-cliente.md new file mode 100644 index 0000000..e62d7ac --- /dev/null +++ b/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 |