Documentación: menús y respuestas del bot, y manual de domicilios

El análisis de completitud cruzando roles contra módulos y tablas contra documentos encontró dos huecos reales. Manual de domicilios: recepcionista, lab_recepcion y lab_readonly tienen acceso a la pantalla administrativa de domicilios, y la única página sobre el tema era la del portal del enfermero, restringida a enfermeros. Son pantallas distintas —una ve todo, la otra solo lo propio— y ahora cada una tiene su guía. Los enfermeros pasan también a ver el manual de formularios, que su rol habilita. Menús y respuestas automáticas del bot: había cuatro tablas en uso que ninguna página explicaba. El bot responde solo las preguntas frecuentes mediante autoresponses (7 configuradas) y ofrece un menú interactivo de 21 opciones en dos niveles, todo configurable desde la base sin desplegar código. También quedan documentados el estado de conversación, los envíos masivos y las encuestas. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-04 12:04:27 -05:00
parent 74e219e2ae
commit bc318db129
6 changed files with 178 additions and 1 deletions
@@ -71,6 +71,7 @@ Un turno **nunca se borra**. Si el paciente no aparece se marca *ausente*; si no
 - [Recepción](?m=soporte&v=documentacion&s=manual&d=recepcion)
 - [Chat de WhatsApp](?m=soporte&v=documentacion&s=manual&d=chat-whatsapp)
 - [Órdenes médicas](?m=soporte&v=documentacion&s=manual&d=ordenes-medicas)
+- [Domicilios](?m=soporte&v=documentacion&s=manual&d=domicilios)
 - [Formularios](?m=soporte&v=documentacion&s=manual&d=formularios)
 - [Reportes y métricas](?m=soporte&v=documentacion&s=manual&d=reportes)
 - [Toma de muestras](?m=soporte&v=documentacion&s=manual&d=toma-de-muestras)
@@ -35,6 +35,15 @@ La línea de WhatsApp del laboratorio la atiende un bot, pero cuando hace falta

 Lo importante: **cuando toma una conversación, el bot deja de responder ahí**. No hay riesgo de que le conteste encima al paciente mientras usted está escribiendo.

+## Lo que el bot resuelve solo
+
+Antes de llegar a una persona, el bot responde por su cuenta las preguntas más
+frecuentes —precios, horarios, ubicación, indicaciones previas— y ofrece un menú
+numerado para agendar, consultar resultados o ver el portafolio.
+
+Ese contenido es configurable: si una respuesta quedó desactualizada o hace falta
+una nueva, un administrador la cambia sin necesidad de programar nada.
+
 ## Atender una conversación

 La lista muestra los hilos con mensajes recientes. Al abrir uno ve el historial completo y puede responder.
@@ -0,0 +1,64 @@
+---
+roles: recepcionista, lab_recepcion, lab_readonly, supervisor
+---
+
+# Domicilios
+
+La pantalla administrativa de las visitas domiciliarias: agendarlas, asignarles enfermero y seguirlas.
+
+> Es distinta del **portal del enfermero**. Aquí se ve y administra todo; el portal muestra a cada enfermero solo lo suyo y está pensado para el celular.
+
+## Agendar una visita
+
+1. **Paciente** — búsquelo por cédula. Si no existe, se crea en el momento.
+2. **Dirección** — la de su ficha con un botón, o escriba otra. Agregue indicaciones si el lugar es difícil de ubicar.
+3. **Fecha y hora**.
+4. **Servicio** — qué se va a hacer.
+5. **Seguro y autorización**, si aplica.
+6. **Valores** — domicilio y copago.
+
+## Asignar un enfermero
+
+Una visita agendada queda **sin asignar** hasta que se le pone un enfermero. Las sin asignar del día son las que hay que resolver primero: nadie las va a atender solo porque estén agendadas.
+
+Al asignarla, la visita aparece en el portal de ese enfermero, que puede editarla.
+
+## Estados
+
+```
+  ┌────────────┐   ┌───────────┐   ┌──────────────┐
+  │ programado ├──►│ en curso  ├──►│  completado  │
+  └─────┬──────┘   └───────────┘   └──────────────┘
+        │
+        └────────────────────────► ┌──────────────┐
+                                   │  cancelado   │
+                                   └──────────────┘
+```
+
+## Notas y archivos
+
+Cada visita admite notas de seguimiento, con fotos y archivos adjuntos. Sirve para dejar la orden médica en papel, un resultado o una observación de lo ocurrido.
+
+Las notas quedan visibles para quien atienda después. Es el lugar correcto para dejar constancia de algo que el próximo necesita saber.
+
+## Formularios
+
+Se le puede enviar un formulario al paciente para que lo firme desde su celular, o copiar el enlace para hacérselo llegar por otro medio. Los ya firmados se consultan desde la misma visita.
+
+## Si solo tiene permiso de lectura
+
+Algunos roles ven los domicilios sin poder modificarlos: no aparecen los botones de crear ni editar. Puede consultar la agenda, el estado de cada visita y sus notas.
+
+## Preguntas frecuentes
+
+**Agendé una visita y el enfermero dice que no la ve.**
+Verifique que le haya asignado el enfermero. Sin asignación, la visita no aparece en ningún portal.
+
+**Hay que reprogramar.**
+Edite la fecha y la hora, y avísele al paciente. Desde el portal del enfermero hay un enlace que abre WhatsApp con el mensaje ya redactado.
+
+**El paciente cambió de dirección.**
+Edite la visita. Si el cambio es permanente, actualice también la ficha del paciente, o la próxima vez volverá a aparecer la anterior.
+
+**¿Puedo ver los domicilios de todos los enfermeros?**
+Desde esta pantalla sí. El portal, en cambio, muestra a cada enfermero solo los suyos.
@@ -1,5 +1,5 @@
 ---
-roles: formularios_readonly, supervisor
+roles: formularios_readonly, enfermero, supervisor
 ---

 # Formularios