Inicio rápido — epidemiologia

El texto proviene del README de registro del repositorio, incluido al momento de compilar el sitio.

Inicio rápido de desarrollo

En una instalación real, la aplicación llega desde su release firmada: el manifiesto de la suite es la única lista de aplicaciones y el aprovisionamiento ya no clona nada. Lo que sigue es para trabajar sobre el código, contra una suite en marcha.

  1. Clonar este repositorio y construir el frontend. js/ y css/ no están versionados: un clon necesita npm ci && npm run build antes de que la aplicación sirva.

  2. Llevar el código al contenedor. Los comandos occ de esta guía corren en el contenedor de APS Conecta Gestión de la suite (docker exec -u www-data aps-conecta-nextcloud php occ …); los scripts del repositorio usan ese mismo contenedor y aceptan EPI_CONTAINER para otro destino.

  3. Comprobar que los tres trabajos en segundo plano quedaron registrados (en el contenedor): docker exec -u www-data aps-conecta-nextcloud php occ background-job:list | grep -E 'ProbeJob|RefreshJob|WarmJob'. Exactamente tres filas es lo correcto: el sondeo que detecta, el pase horario que mantiene al día una instalación que nadie abre y el pase profundo nocturno que recorre los catálogos antiguos. Una fila ausente significa que la habilitación no la registró: ver las trampas de la plataforma en la página de desarrollo.

  4. Abrir /apps/epidemiologia en la URL de la instalación (http://localhost/… es la base dentro del contenedor, por eso la usa scripts/smoke.sh y un navegador no puede). Inicio muestra una tarjeta por sector de alertas, cada una con lo último que publicó su fuente. Desde la terminal, scripts/smoke.sh comprueba el mismo cableado y más.

Pruebas: scripts/test.sh ejecuta la batería unitaria dentro del contenedor (PHPUnit 11), npm test la lógica del frontend (Vitest), scripts/smoke.sh el cableado contra la instancia en marcha, scripts/layout.sh la disposición en un navegador real a tres anchos y scripts/openapi.sh regenera openapi.json. La integración continua (.github/workflows/ci.yml) corre en main y en los pull requests, no en cada push.

js/ y css/ no están versionados: los construye el flujo de release y viajan dentro del tarball firmado; un clon necesita npm ci && npm run build antes de que la aplicación sirva. Para actualizar una instalación desde un clon: git pull, npm ci && npm run build, docker exec -u www-data aps-conecta-nextcloud php occ upgrade y reiniciar el contenedor web. La migración de la 0.11.0 reescribe la clave primaria de epidemiologia_alert y APS Conecta Gestión no tiene migraciones de retroceso: respaldar la base de datos antes de esa actualización. La configuración (notify_groups y los contadores que escribe la propia aplicación), el procedimiento para añadir una fuente y el resto de las trampas están en la referencia de desarrollo.

Licencia