Como rodar

Desenvolvimento

gradlew quarkusDev

Sobe em http://localhost:8080 e abre o navegador sozinho. O Dev Services levanta um contêiner PostgreSQL 17 automaticamente — não é preciso configurar banco, usuário ou senha.

Exige Docker. É o preço da troca de SQLite por PostgreSQL, e é permanente.

Para desligar a abertura automática do navegador:

%dev.nasa.dev.abrir-navegador=false

Testes

gradlew test

Também sobe um contêiner. O reaproveitamento está desligado de propósito: com ele, o banco sobreviveria entre execuções e os testes de esquema — que usam chaves fixas — passariam na primeira rodada e falhariam na segunda, esbarrando na duplicata que eles mesmos deixaram.

Produção

NASA_DB_URL=jdbc:postgresql://host:5432/nasa \
NASA_DB_USER=... \
NASA_DB_PASSWORD=... \
gradlew rodar

Ou, com o jar empacotado:

java -Duser.timezone=UTC -jar build/quarkus-app/quarkus-run.jar

A flag de fuso não é opcional. Sem ela o arranque cai, com a mensagem trazendo o comando pronto — a CatracaDeFusoUtc recusa qualquer fuso que não seja offset zero e fixo. gradlew rodar já passa a flag.

As três variáveis de ambiente não têm valor padrão. Faltando qualquer uma, o arranque cai: subir com credencial adivinhada é pior que não subir.

O que acontece no arranque

1. Fuso conferido — se não for UTC, para aqui;
2. Banco verificado — servidor no ar, credencial aceita, base existe. Cada falha tem mensagem própria com a correção;
3. Migrações aplicadas — checksums conferidos inteiros antes de aplicar qualquer uma;
4. Faxina de log — apaga o que passou de 30 dias ou do teto de contagem.

Guardas antes de commitar

pwsh guardas/guardas.ps1

Roda a guarda de segredos e a de caminhos proibidos. O hook de pre-commit já as chama — e bloqueia o commit se alguma reprovar. Três estados: 0 passou · 1 reprovou · 2 não verificou, que não é aprovação.

Sincronizar dados para ver o sistema funcionando

POST /api/eventos/sincronizar?limite=50&dias=30
POST /api/clientes          {"nome":"...","documento":"..."}
POST /api/enderecos         {"cep":"01310-200","clienteId":1}
POST /api/contatos          {"email":"...","tipoContato":"EMERGENCIA"}
POST /api/contatos/{id}/vincular/{clienteId}
POST /api/alertas/varrer?raioKm=100&dias=30
POST /api/alertas/despachar

Ou pelas telas, que fazem o mesmo caminho: Desastres → Clientes → Endereços → Contatos → Alertas.