0001 — Framework: Micronaut 4 + Netty¶
Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-06-30 · Decidido em: 2026-04-01
Atualização 2026-06-30: a stack subiu para Micronaut 5 / JDK 25 — ver decisão 0009. A escolha de fundo (Micronaut sobre Spring/Quarkus, runtime Netty) registrada abaixo continua válida; mudou só a versão. O título preserva o slug publicado (constituição §5).
Equivalência com a doc arc42 legada. Esta era a documentação anterior (arc42 monolítico,
docs/*.adoc, com tabela de ADRs). O mapeamento é 1:1, na mesma ordem:ADR-001 → 0001,ADR-002 → 0002, …ADR-008 → 0008. Quem conhecia a numeraçãoADR-00Nacha a decisão em000N.
Contexto¶
O auth-service é um serviço novo, extraído do integrador, que precisa subir rápido, ter footprint pequeno (roda como container único no Coolify) e alinhar-se à stack do ecossistema xadm.biz.
Decisão¶
Usar Micronaut 4 com runtime Netty (sem Tomcat), empacotado como JAR único
(shadowJar) sobre eclipse-temurin:21.
Consequências¶
- Startup < 5 s e baixo consumo de memória — adequado a um serviço sempre-ligado e barato de escalar verticalmente.
- Mesmo modelo de programação do integrador — menos atrito de manutenção.
- DI/AOP em tempo de compilação (sem reflexão pesada), o que ajuda no startup.
Alternativas consideradas¶
- Spring Boot: startup > 15 s e footprint maior, sem ganho para este caso — descartado.
- Quarkus: não utilizado no ecossistema xadm; adicionaria uma stack a manter.