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
@@ -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.