Documentación: diagramas, kiosko y chat, catálogos, respaldos y endpoints documentados

Diagramas en texto dentro de bloques de código, en vez de capturas: se editan
como texto, no pesan en el repositorio y no quedan desactualizados solos. Se
agregan el recorrido de un turno, quién firma cada consentimiento, el paso de
una muestra pendiente entre visitas y la línea de tiempo de las tomas seriadas.

Páginas nuevas del manual: kiosko y pantallas de TV (las dos que funcionan sin
nadie operándolas), y chat de WhatsApp, que explica por qué el bot deja de
responder cuando un operador toma la conversación y de dónde sale el límite de
24 horas.

Páginas técnicas nuevas: registro de exámenes, y los catálogos del laboratorio
agrupados en una sola página por compartir la misma forma. Operación suma
respaldos y recuperación, incluyendo qué datos históricos no son recuperables.

Los 10 endpoints que no tenían comentario de cabecera ahora lo tienen, así que
la tabla generada por {{endpoints}} queda completa: 83 de 83.

DOCUMENTACION_LAB.md y README_LAB.md quedan como puntero al módulo;
WEBHOOK_ENDPOINTS.md se elimina por estar ya migrado a la sección técnica.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Lizandro Guarnizo
2026-08-04 10:49:02 -05:00
co-authored by Claude Opus 5
parent 81c007c516
commit 71c9dfd424
21 changed files with 454 additions and 806 deletions
@@ -0,0 +1,70 @@
# Kiosko y pantallas de TV
Las dos pantallas que funcionan solas, sin nadie operándolas. Conviene entenderlas porque cuando fallan, el que se entera primero es quien está en recepción.
## El kiosko
El tótem de la entrada, donde el paciente saca su turno sin ayuda.
```
PACIENTE LLEGA
┌──────────────┐
│ Elige tipo │ general, preferencial, embarazada,
│ de turno │ solo entrega de muestras…
└──────┬───────┘
┌──────────────┐
│Datos básicos │ nombre y celular (opcional)
└──────┬───────┘
┌──────────────┐
│ Imprime │──► el turno aparece en la pantalla de TV
│ su turno │ y en la cola de recepción
└──────────────┘
```
Es una de las **dos únicas pantallas públicas** del sistema: no pide usuario ni contraseña, porque nadie va a iniciar sesión en el tótem de la entrada.
### Prioridades
El tipo de turno que elige el paciente define su lugar en la cola. Las prioridades las configura un administrador; quien atiende no necesita hacer nada: **Llamar siguiente** ya respeta el orden.
### Si el paciente deja su celular
Puede recibir por WhatsApp el aviso de su turno y los consentimientos para firmar desde el teléfono mientras espera. Vale la pena insistirle en que lo deje.
### Cuando el kiosko falla
Un turno siempre se puede crear a mano desde recepción. El kiosko es una comodidad, no un requisito — si está caído, la atención sigue.
## Pantalla de TV
La de la sala de espera. Muestra el turno que se está llamando y la cola, y reproduce contenido del laboratorio de fondo.
También es pública: se abre en el navegador del televisor y se deja andando.
### El contenido de fondo
Es una lista de videos e imágenes que se reproducen en bucle, uno detrás de otro:
```
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ video 1 │──►│ imagen │──►│ video 2 │──►│ imagen │──┐
│ hasta │ │ 8 seg │ │ hasta │ │ 10 seg │ │
│ el final│ │ │ │ el final│ │ │ │
└─────────┘ └─────────┘ └─────────┘ └─────────┘ │
▲ │
└──────────────────── vuelve a empezar ────────────┘
```
Los videos van completos; a las imágenes se les fija cuántos segundos duran. Se administra desde **Configuración del turnero → Pantalla TV**: se suben, se reordenan arrastrando y se eliminan de a uno.
### Si la pantalla se queda pegada
Recargá la página en el televisor. Si el contenido no cambió, verificá que la lista tenga elementos activos en la configuración.
## Verificar paciente
Una consulta rápida por cédula para ver la ficha y el historial de alguien, sin abrir su turno. Útil cuando el paciente pregunta algo en el mostrador y no querés perder lo que estás haciendo.