APHORA es una aplicación web progresiva (PWA) para explorar riesgos y eventos relevantes en Argentina, consultar observaciones y revisar evidencia con su fuente, vigencia y estado de verificación claramente diferenciados.
- Aplicación en producción: https://aphora.simondalmasso44.workers.dev/
- Repositorio canónico: https://github.com/simondalmasso/Aphora
- Espejo heredado de GitLab: https://gitlab.com/simondalmasso/aphora
APHORA organiza información para facilitar la observación cívica; no sustituye las alertas oficiales, los servicios de emergencia ni las instrucciones de las autoridades.
- Radar nacional y exploración por área o localidad.
- Eventos relacionados con riesgos meteorológicos, inundaciones, sismos e incendios, según la disponibilidad de cada fuente.
- Contexto geográfico, actividad reciente y evidencia asociada a los eventos.
- Separación explícita entre fuente oficial, observación y fuente complementaria.
- Indicadores de frescura y verificación: una observación, una alerta publicada y una confirmación no son equivalentes.
- Interfaz adaptable y capacidades de aplicación web progresiva (PWA).
La cobertura y la actualización dependen de las fuentes externas. La ausencia de un evento en APHORA no demuestra que una zona sea segura.
El código integra proveedores y adaptadores para fuentes públicas como el Servicio Meteorológico Nacional (SMN/CAP), el Instituto Nacional del Agua (INA), INPRES, USGS, NASA EONET y datos complementarios de inundaciones. La fuente concreta y su función deben evaluarse en cada evento; no todas las fuentes tienen el mismo alcance, autoridad o frecuencia de actualización.
- Frontend: JavaScript, CSS y HTML en
public/ysrc/client/. - Dominio: normalización de riesgos y observaciones en
src/domain/. - Proveedores: adaptadores de fuentes externas en
src/providers/. - Backend: Cloudflare Worker en
src/worker/. - Persistencia: Cloudflare D1 y migraciones SQL en
migrations/. - PWA: manifiesto, iconos y service worker en
public/. - Pruebas y herramientas:
test/yscripts/.
Requisitos: Node.js compatible con las dependencias del proyecto y npm.
npm ci
npm run gateLa compuerta ejecuta comprobación sintáctica, lint, pruebas automatizadas y build. Para ejecutar tareas individuales:
npm run typecheck
npm run lint
npm test
npm run buildLa ejecución local del Worker y el acceso a D1 pueden requerir configuración de Cloudflare y credenciales propias. No compartas secretos ni los agregues al repositorio.
docs/ Contratos, planes, autoridad y estrategia SEO
migrations/ Migraciones de base de datos
public/ Interfaz web, estilos, PWA y recursos públicos
scripts/ Build, validación, diagnóstico y mantenimiento
src/client/ Lógica de interfaz
src/domain/ Modelo y normalización de riesgos
src/providers/ Adaptadores de fuentes
src/worker/ API y lógica del Cloudflare Worker
test/ Pruebas automatizadas y fixtures
GitHub main es la fuente canónica para código, ramas, revisiones y linaje de releases. GitLab es un espejo downstream: no desarrolles cambios independientes allí. Consulta docs/REPOSITORY_AUTHORITY.md.
La estrategia SEO está en docs/SEO_STRATEGY.md. Incluye intención de búsqueda, metadatos, rastreo, enlaces canónicos y medición. El posicionamiento no puede garantizarse: requiere rastreo e indexación por buscadores y señales externas.
- No publiques tokens, claves privadas, credenciales ni datos personales.
- No uses el radar como única fuente para decisiones de emergencia.
- Verifica avisos y recomendaciones directamente con los organismos oficiales.
- Reporta errores mediante GitHub Issues.
APHORA está desplegado públicamente y continúa en desarrollo. La disponibilidad de la aplicación no implica que todas las fuentes externas estén activas ni que cada evento esté confirmado.
No se declara una licencia en este README. Hasta que se añada un archivo de licencia explícito, no debe asumirse que el código puede reutilizarse bajo una licencia open source determinada.