Pular para conteúdo

0012 — Views em JTE no lugar de Thymeleaf

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-08-26 · Decidido em: 2026-08-26

Contexto

As telas server-render do tradutor (login, monitor/auditoria de requests, admin) rodavam em Thymeleaf (micronaut-views-thymeleaf). Sob GraalVM native-image (decisão 0011) o Thymeleaf/OGNL resolve o modelo por reflexão — cada tipo alcançado por template precisaria de @ReflectiveAccess e a falha só aparece em runtime (500), tela por tela: whack-a-mole de reflexão. A casa fixou o alvo na ADR central 0025 — Views server-render com JTE.

Decisão

Adotar JTE (gg.jte) como motor das views server-render, substituindo o Thymeleaf, seguindo a central 0025. Template compilado, type-check no build, zero reflexão de modelo em runtime.

Consequências

  • Plugin gg.jte.gradle 3.2.4 casado ao runtime micronaut-views-jte; templates em src/main/jte/** (login.jte, kit/, admin/, webstorm-ecom-requests/), generateJte antes do compileJava.
  • generate() mode — os .java gerados são compilados junto do app (native-safe; sem .bin por reflexão em runtime). contentType = Html.
  • reflect-config.json de reachability-metadata dos templates gerados em src/main/resources/META-INF/native-image/jte-views/.
  • Os globais de view (appNome/clienteXadm/authEnabled/usuário) vêm do XadmViewModel da lib xadm-seguranca (decisão 0006).
  • Fontes geradas ficam em build/generated-sources/jte, fora de src/main/java → naturalmente fora do escopo de cobertura.

Fora de escopo: o motivo e as alternativas da migração (vivem na central 0025).