Documentação

15 documentos sobre como este sistema funciona e por que ele é assim. Escritos em Markdown, versionados junto com o código e renderizados no servidor — cada um também está disponível em texto cru, no fim da própria página.

Fundamentos

3 doc

O que o sistema faz, como está organizado, e por quê

4 min Visão geral O problema, a resposta e o caminho de um alerta do começo ao fim ler 4 min Arquitetura Fatias verticais, peers e kernel — e a guarda que impede o acoplamento ler 3 min A pilha e o porquê Java 25, Quarkus, Qute e HTMX — e o que saiu do projeto original ler

As fatias

2 doc

Cada recorte vertical do domínio, com as invariantes que ele protege

3 min Evento O que a NASA publica, e o defeito de 456 km ler 6 min Alerta A saída do sistema — montada na hora, e sem gravar nada ler

Infraestrutura

3 doc

Banco, migrações, guardas e o que roda no arranque

5 min Banco e migrações SQLite, o aplicador próprio e o que cada migração mudou ler 6 min Guardas executáveis Segredos, caminhos proibidos, fronteira arquitetural, fuso e geometria ler 6 min Segurança SSRF, XXE, credenciais, mascaramento e o que cada trava impede ler

Decisões e cicatrizes

3 doc

O que foi medido, o que mudou, e o preço de cada engano

4 min Sem cadastro Por que quatro fatias e duas tabelas foram removidas do sistema ler 5 min Defeitos medidos Os enganos do projeto original, com o número que os torna reais ler 4 min De PostgreSQL a SQLite As duas trocas medidas, o que se perdeu, e a recomendação que não venceu ler

Referência

4 doc

API, fontes de dados e como rodar

3 min API Todos os endpoints, com o que cada um garante ler 3 min Fontes de dados NASA, BrasilAPI, ViaCEP, Nominatim e GDACS — todas abertas ler 2 min Como rodar Desenvolvimento, testes e produção ler 12 min Interface Ícones, dicas de campo e a regra da porcentagem — e o que a tela recusa fazer ler