ClimaHub

Os alertas do ClimaHub são publicados no padrão OASIS Common Alerting Protocol (CAP) versão 1.2, formato internacional de intercâmbio de avisos públicos utilizado por serviços meteorológicos e sistemas de proteção civil. A publicação ocorre em dois endpoints públicos, sem autenticação:

• https://climahub.dumontdev.com.br/cap/feed.xml — Feed Atom com os alertas em vigência application/atom+xml
• /cap/alerta/{identifier}.xml — Documento CAP 1.2 de um alerta atualmente em vigência (exemplo real) application/cap+xml

Cada documento é serializado conforme a sequência exigida pelo schema oficial da OASIS e a suíte de testes do projeto valida os documentos gerados contra esse schema (XSD), versionado no repositório.

Schema oficial (OASIS): docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2.xsd

SHA-256 do XSD versionado no projeto:
b7798ef25868b068c97b268bda02d067c7d4ba9373adc5638bf37105804ee723

Nesta instância de demonstração, os alertas publicados carregam <status>Exercise</status> — a semântica prevista pelo próprio CAP para exercícios — e são identificados visualmente como simulação no painel público.

O ClimaHub trata o alerta como um documento com vigência e trilha, não como uma postagem editável:

Vigência obrigatória

Nenhum alerta existe sem prazo de expiração (expires). O formulário sugere a duração pela natureza do evento e o operador pode ajustá-la — nunca omiti-la.

Expiração automática

A condição de "alerta ativo" é avaliada por consulta a cada acesso — um alerta vencido desaparece do painel e do feed imediatamente, sem depender de rotinas em segundo plano. Um processo periódico registra as transições para fins de histórico.

Atualização e cancelamento

Correções são publicadas como novas mensagens (msgType Update) e encerramentos antecipados como cancelamentos (msgType Cancel), sempre referenciando a mensagem original (references) no formato do padrão. A mensagem substituída sai da lista de vigentes.

Imutabilidade

Um alerta emitido não pode ser editado nem excluído. A correção é uma nova mensagem encadeada à anterior — requisito de auditoria em comunicação de emergência.

Trava de emissão oficial

Enquanto a instância não estiver homologada por autoridade de Defesa Civil, a emissão de alertas oficiais (status Actual) é bloqueada na camada de dados da aplicação, não apenas na interface.

Estado atual e planejado das integrações. Os rótulos refletem o que existe hoje: "Em produção" indica funcionalidade operante e verificável nesta instância; "Previsto" indica integração planejada, ainda sem implementação.

A camada de ingestão de dados de sensores (fontes, leituras, qualidade e saúde da rede) está especificada na arquitetura do projeto e será construída antes das primeiras integrações, de modo que fontes públicas e sensores próprios compartilhem o mesmo modelo de dados.

O ClimaHub opera como uma instância por município: o geocódigo IBGE (Pelotas/RS — 4314407), as coordenadas de referência e a identificação do órgão emissor são configuração da instância, não dado por registro. Essa escolha simplifica a operação, o isolamento de dados e a homologação individual. A evolução para múltiplos municípios em uma mesma instância está mapeada — exigiria entidade de municípios, escopo territorial nas consultas e feeds CAP por município — e será avaliada conforme a demanda de implantação.

Nenhum dado pessoal trafega no painel público nem no feed CAP: as rotas públicas expõem apenas alertas, ocorrências georreferenciadas sem titularidade e informações operacionais de abrigos. Os registros de pessoas afetadas — que podem conter dados sensíveis — são restritos a usuários autenticados com perfil adequado. O tratamento segue a LGPD como referência normativa (e o GDPR para cooperação internacional); a política pública de proteção de dados, com base legal, categorias, finalidades e prazos de retenção, integra o roteiro de evolução do projeto.