Lizandro GuarnizoandClaude Opus 5
32c209710c
21 documentos en cuatro secciones, escritos sobre el comportamiento real del sistema —incluidos los casos que costaron diagnosticar esta semana. Manual de usuario (visible para todos): primeros pasos, recepción, toma de muestras, portal del enfermero y administración. Orientado a tareas concretas, no a describir pantallas. Documentación técnica: índice de módulos, turnero, formularios y firma digital, WhatsApp y bot, domicilios, webhook (migrado de WEBHOOK_ENDPOINTS.md) e inventario de endpoints. Arquitectura: visión general, enrutamiento y registro de módulos, roles y permisos, modelo de datos, integración con WhatsApp, y decisiones tomadas con su deuda técnica asociada. Operación: runbook de incidentes ordenado por síntoma, configuraciones críticas —incluido qué vive en Meta y no en la base— y despliegue. Se documentan explícitamente las trampas conocidas: role/role_id que hay que mantener sincronizados, las columnas can_* que el control de acceso no lee, las URL de plantilla que no se cambian desde el código, y las columnas históricas que quedaron en NULL sin forma de recuperarlas. README_DOCS.md apunta al módulo y explica cómo agregar páginas. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
88 lines
3.6 KiB
Markdown
88 lines
3.6 KiB
Markdown
# Administración
|
|
|
|
Tareas de administrador: usuarios, permisos, configuración y reportes.
|
|
|
|
## Usuarios y permisos
|
|
|
|
### Crear un usuario
|
|
|
|
La convención de la casa es usar el **número de cédula como nombre de usuario** para el personal asistencial.
|
|
|
|
Cargá también la **cédula** en su ficha: es lo que aparece bajo la firma en los formularios. Si falta, el documento sale firmado sin identificación.
|
|
|
|
Los enfermeros son un caso aparte: su cédula sale de la ficha de enfermero, no del usuario.
|
|
|
|
### Cambiar el rol de alguien
|
|
|
|
> Un usuario tiene **dos** campos de rol y hay que cambiar los dos. El texto (`role`) es lo que muestra la interfaz; el vínculo (`role_id`) es de donde salen los permisos reales.
|
|
|
|
Si cambiás solo uno, el usuario ve un rol y tiene los permisos del otro. Ya pasó.
|
|
|
|
Después del cambio, **el usuario debe cerrar sesión y volver a entrar**: los permisos se cargan al iniciar sesión, no en cada pantalla.
|
|
|
|
### Dejar un módulo en solo lectura
|
|
|
|
Lo que decide si alguien puede modificar es el campo `permission` (`read` o `write`) de cada módulo del rol.
|
|
|
|
> Las columnas `can_editar`, `can_crear` y similares **no se usan** para el control de acceso. Ponerlas en cero no impide nada. Lo que manda es `permission`.
|
|
|
|
## Turnero
|
|
|
|
### Escritorios y estaciones
|
|
|
|
Cada puesto de recepción y cada estación de muestras es un *lugar*. Se les puede asignar:
|
|
|
|
- **Formularios obligatorios** — todo paciente que pase por ahí los debe firmar.
|
|
- **Equipos por IP o token** — así el operador ve solo su puesto y no puede confundirse.
|
|
|
|
### Formularios obligatorios
|
|
|
|
Se exigen por dos vías, y se acumulan:
|
|
|
|
| Vía | Ejemplo |
|
|
|---|---|
|
|
| Por examen | VIH exige su consentimiento específico |
|
|
| Por estación | Toda toma de muestras exige F-LAB-08 |
|
|
|
|
### Pantalla de TV
|
|
|
|
Admite una lista de videos e imágenes que se reproducen en bucle, uno detrás de otro. Se pueden reordenar arrastrando y a cada imagen se le fija cuántos segundos dura.
|
|
|
|
### Reabrir un turno
|
|
|
|
Desde el historial se puede cambiar el estado de un turno, incluso reabrir uno finalizado, ausente o cancelado.
|
|
|
|
## Facturación del día
|
|
|
|
El panel muestra tres cifras:
|
|
|
|
| Cifra | Qué incluye |
|
|
|---|---|
|
|
| **Facturado** | Turnos finalizados |
|
|
| **En proceso** | Turnos aún activos, ya cobrados pero sin cerrar |
|
|
| **Total estimado** | La suma de ambos |
|
|
|
|
Los turnos **ausentes y cancelados no se cuentan** en ninguna: no se van a cobrar.
|
|
|
|
## LIA
|
|
|
|
El asistente del dashboard del turnero responde preguntas sobre la operación del día: tiempos por profesional, facturación, exámenes más pedidos, buscar un paciente.
|
|
|
|
Tiene un presupuesto de consumo. Cuando se agota, se bloquea y hay que reponerlo. El consumo por pregunta es alto porque envía el contexto completo del día cada vez.
|
|
|
|
## Documentos
|
|
|
|
Los datos que salen en el encabezado de todos los documentos —nombre, dirección, ciudad, teléfono, logo, color— se editan desde **Configuración del laboratorio**, sin tocar código.
|
|
|
|
> La dirección física se cambia desde ahí. Pero **la URL de los botones que llegan por WhatsApp no**: esa vive en la plantilla aprobada por Meta y se cambia en el WhatsApp Manager, con reaprobación de por medio.
|
|
|
|
## Términos y condiciones
|
|
|
|
El bot exige aceptarlos antes de conversar. La URL del documento está en **dos lugares** que hay que cambiar juntos: la versión activa de términos y el texto del mensaje de bienvenida, que la repite dentro.
|
|
|
|
Se vuelve a pedir la aceptación cuando pasan 6 meses o cuando se publica una versión nueva marcada para reenvío.
|
|
|
|
## Cuando algo falla
|
|
|
|
El [runbook de incidentes](?m=soporte&v=documentacion&s=operacion&d=runbook) tiene los casos frecuentes con su diagnóstico y solución.
|