Skip to content

CaioOlivieri/AlertaVida

Repository files navigation

AlertaVida

tests Coverage badge

🇧🇷 Leia em português

Real-time multi-source ingestion of natural-disaster alerts for the Brazilian public. Ingests data from CEMADEN and NASA EONET (operational), with INMET and INPE planned.

Architecture

Modular pipeline: source adapters → change detection → transactional outbox. Each source runs in an independent transaction; failure of one does not block others. See wiki/_index.md for the full architecture and the 8-layer roadmap.

Running

uv sync              # install everything (dev included via dependency-groups PEP 735)
uv sync --frozen     # reproduce exact lock
python -m alertavida.monitor     # one-shot debug run
python -m alertavida.scheduler   # continuous service (Ctrl+C to stop)

Tests

uv run pytest                # full suite (network and time.sleep are mocked)
uv run pytest -m integration  # CEMADEN contract test (hits real API)

Data sources

  • CEMADEN — public data from the Brazilian federal government (Centro Nacional de Monitoramento e Alertas de Desastres Naturais)
  • NASA EONET — operational (global natural events)
  • INMET — planned
  • INPE — planned

License

Apache 2.0. Copyright 2026 Caio Olivieri. See LICENSE.

Status

Active development — Layer 4 (multi-source ingestion) complete; Layer 5 (correlation) next. See wiki.


Português

Ingestão em tempo real de alertas de desastres naturais para o público brasileiro. Coleta dados do CEMADEN e NASA EONET (operacionais), com INMET e INPE planejados.

Arquitetura — pipeline modular: adaptadores de fonte → detecção de mudanças → outbox transacional. Cada fonte roda em uma transação independente; a falha de uma não bloqueia as outras. Veja wiki/_index.md para a arquitetura completa e o roadmap de 8 camadas.

Como rodar e testar — os comandos são os mesmos das seções Running e Tests acima.

Fontes de dados — CEMADEN (dados públicos do governo federal brasileiro — Centro Nacional de Monitoramento e Alertas de Desastres Naturais); NASA EONET operacional; INMET e INPE planejados.

Licença — Apache 2.0. Copyright 2026 Caio Olivieri. Veja LICENSE.

Status — Em desenvolvimento ativo — Camada 4 (ingestão multi-fonte) completa; Camada 5 (correlação) a seguir (veja a wiki).

About

Real-time multi-source ingestion of natural-disaster alerts for the Brazilian public.

Topics

Resources

License

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages