Files
whatsapp/modules/soporte/docs/tecnica/55-registro-examenes.md
Lizandro GuarnizoandClaude Opus 5 71c9dfd424 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>
2026-08-04 10:49:02 -05:00

2.2 KiB

Registro de exámenes

Registro de exámenes realizados en sede: creación de órdenes, toma de muestras e ingreso de resultados. Es de los módulos nuevos — todo su código vive dentro de modules/registro_exams/.

Vistas

Vista Qué hace
lista Órdenes con filtros y estado
nueva_orden Alta de una orden
orden Detalle: ítems, estados e ingreso de resultados
etiqueta Etiqueta imprimible para rotular la muestra

Endpoints

Endpoint Qué hace
get_ordenes.php Lista con filtros
get_orden.php Detalle de una orden
save_orden.php Crea o actualiza
save_resultado.php Guarda el resultado de un ítem
cambiar_estado_item.php Avanza el estado de un ítem individual

Usan api/_helpers.php del módulo, con las mismas convenciones que el turnero.

Flujo

  nueva_orden          orden                    orden
      │                  │                        │
      ▼                  ▼                        ▼
 ┌─────────┐       ┌───────────┐           ┌─────────────┐
 │  crear  ├──────►│  muestra  ├──────────►│  resultado  │
 │  orden  │       │  tomada   │           │  ingresado  │
 └─────────┘       └───────────┘           └─────────────┘
      │                  │
      ▼                  ▼
  etiqueta          se rotula
  imprimible        la muestra

El estado se lleva por ítem, no por orden completa: una orden puede tener unos exámenes resueltos y otros pendientes.

Relación con otros módulos

Módulo Vínculo
lab_examenes De ahí sale el catálogo y los valores de referencia
lab_pacientes El paciente de la orden
medicos El médico que la solicitó

Al tocarlo

Los resultados de laboratorio son información clínica: un ítem mal guardado o un valor de referencia equivocado tienen consecuencias reales. Cualquier cambio en save_resultado.php merece probarse con una orden de prueba antes de subirlo.