Banco Backend, caso a caso

O gatilho

Todo push na main, todo pull request e o disparo manual. Os dois jobs começam juntos, cada um no seu próprio ubuntu-latest.

Checkout e JDK

O checkout traz o histórico completo, que o Sonar usa para o blame. Java 21 da Temurin, com o cache do Maven.

O harness, conferido

Um job à parte, em paralelo. O doctor gate reprova o build quando uma linha com gate falha: as 15 regras de boundary, a varredura de imports proibidos em cada arquivo-fonte, o schema das extensões, o jar do hook gerado do ArchHook.java atual e os registros de hook. Linhas que dependem do runner, como CLAUDE_PROJECT_DIR, aparecem mas nunca reprovam.

  Boundaries ........ ✅ 15 active rules  Boundary violations . ✅ 203 file(s) swept against 15 rule(s)  Schema ............ ✅ all extension files pass  Hook jar .......... ✅ built from the current .claude/hooks/ArchHook.java  Hooks ............. ✅ 28 registration(s) across 12 event(s)✅ doctor gate: no gated line failed (Boundaries, Boundary violations, Schema, Hook jar, Hooks, MCP, Audit overrides).

Regras de código, antes de compilar

Na fase validate, o Checkstyle lê src/main contra config/checkstyle/checkstyle.xml, a metade mecânica de rules/code-quality.md: tamanho, parâmetros, complexidade, aninhamento, números mágicos. Uma violação reprova o build.

[INFO] You have 0 Checkstyle violations.

Compilação

Código de produção e de teste compilados com Java 21. O agente do JaCoCo já está ligado, para medir a cobertura dos testes que vêm a seguir.

Testes de unidade

287 testes, sem banco e sem broker. Entre eles, o ArchitectureTest, com 21 regras ArchUnit.

[INFO] Tests run: 21, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 2.496 s -- in dev.nerviz.bankapp.ArchitectureTest[INFO] Tests run: 287, Failures: 0, Errors: 0, Skipped: 0

Testes de integração, com infraestrutura real

80 testes contra containers de verdade, subidos pelo Testcontainers: postgres:16-alpine e apache/kafka:4.1.0. O runner do GitHub tem Docker, então nenhum é pulado.

Creating container for image: postgres:16-alpineCreating container for image: apache/kafka:4.1.0[INFO] Tests run: 80, Failures: 0, Errors: 0, Skipped: 0

Formatação

O Spotless confere src/main e src/test com o palantir-java-format e reprova import não usado. Pega o arquivo escrito por fora do hook de formatação.

[INFO] Spotless.Java is keeping 202 files clean - 0 needs changes to be clean, 202 were already clean, 0 were skipped because caching determined they were already clean

Regras dos testes

src/test contra checkstyle-test.xml, um conjunto próprio para código de teste. Foi este check que deixou três runs vermelhos em 12/10/2026, com duas violações que o a28934c corrigiu.

[INFO] You have 0 Checkstyle violations.

Cobertura mínima

O JaCoCo exige 80% das linhas e 70% dos branches no projeto todo, fora as classes de startup e de configuração. Os números vêm de rules/testing.md e nunca baixam para o build passar.

[INFO] All coverage checks have been met.[INFO] BUILD SUCCESS

Os testes de integração rodaram mesmo?

Um step de shell lê o failsafe-summary.xml. Se existe *IT.java e nenhum teste de integração rodou, ou algum foi pulado, o build falha: um IT pulado não prova nada.

✅ 80 integration test(s) ran, none skipped.

Análise no SonarQube Cloud

Depois do verify, com o relatório do JaCoCo pronto. Só roda quando o secret SONAR_TOKEN existe, então o pull request de um fork passa sem ele. O step envia a análise e não espera o quality gate: o resultado fica no SonarQube Cloud.

[INFO] ANALYSIS SUCCESSFUL, you can find the results at: https://sonarcloud.io/dashboard?id=nerviz-ai_bank-app&branch=main