Lizandro GuarnizoandClaude Opus 5
71c9dfd424
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>
55 lines
2.2 KiB
Markdown
55 lines
2.2 KiB
Markdown
# 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.
|