Documentación completa del proyecto en el módulo Soporte

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>

modules/soporte/docs/tecnica/10-indice-de-modulos.md

@@ -0,0 +1,41 @@
+# Índice de módulos
+
+Inventario de los módulos del sistema, generado del filesystem en cada carga.
+
+{{modulos}}
+
+## Cómo leer esta tabla
+
+**Vistas** son las pantallas (`modules/<slug>/views/*.php`). **Endpoints** son los archivos que devuelven JSON (`modules/<slug>/api/*.php`).
+
+Un módulo con **1 vista y 0 endpoints** suele ser un puente al sistema anterior: la vista solo incluye el archivo de la raíz, donde está el código real.
+
+```php
+// modules/lab_domicilios/views/index.php
+require_once APP_ROOT . '/lab_domicilios.php';
+```
+
+**En SYSTEM_MODULES** indica si el módulo pasa por el control de permisos. Los que dicen «no» quedan accesibles para cualquier sesión — es el caso de módulos auxiliares que se consumen desde otras pantallas.
+
+## Dónde está el código de verdad
+
+| Módulo | Código real |
+|---|---|
+| `turnero` | En el módulo. Es el más grande y el más nuevo |
+| `registro_exams` | En el módulo |
+| `lab_examenes`, `medicos` | En el módulo |
+| `lab_domicilios`, `lab_pacientes`, `lab_ordenes`, y demás `lab_*` | Archivo de la raíz; el módulo es un puente |
+| `whatsapp` | `index.php` y `services/BotService.php` |
+| `enfermero_portal` | `enfermero_portal.php` |
+
+## Servicios y clases compartidas
+
+{{servicios}}
+
+## Detalle por módulo
+
+- [Turnero](?m=soporte&v=documentacion&s=tecnica&d=turnero)
+- [WhatsApp y bot](?m=soporte&v=documentacion&s=tecnica&d=whatsapp-bot)
+- [Formularios](?m=soporte&v=documentacion&s=tecnica&d=formularios)
+- [Domicilios](?m=soporte&v=documentacion&s=tecnica&d=domicilios)
+- [Todos los endpoints](?m=soporte&v=documentacion&s=tecnica&d=endpoints)