0019 — Adota o kit de UI X-Adm (JTE) — ponteiro do ADR central 0025¶
Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-09-04 · Decidido em: 2026-08-26
Contexto¶
Este RD não decide nada novo: a escolha do motor de views e do layout padrão é da casa,
registrada no ADR central 0025 (views server-render em JTE, com o kit de UI X-Adm —
layout.jte/headerRight.jte + custom-theme.css). O que faltava aqui era o rastro local:
quando este app migrou, e o que ficou dele.
A /xadm-docs (passo 3c, tipo C) cobra exatamente isso — código que adotou uma migração de stack
decidida centralmente sem nenhum registro em docs/decisoes/ do próprio repo. Sem o ponteiro, quem
abre este repo não sabe se o src/main/jte/ é adoção da norma ou invenção local.
Decisão¶
O maxsul-pied adota o kit de UI X-Adm, conforme o ADR central 0025, desde 2026-08-26
(1b1c783, "feat(views): migra UI Thymeleaf→JTE e adota comum-web 0.6.1"). A migração saiu de
Thymeleaf e trouxe junto o xadm-comum-web 0.6.1 (0008).
O que vive no repo, e sob qual regime:
| arquivo | origem | regime |
|---|---|---|
src/main/jte/kit/layout.jte, kit/headerRight.jte |
templates/views-jte/kit/** |
verbatim do central — re-derivado pela /xadm-docs |
src/main/resources/public/css/custom-theme.css |
templates/public/** |
verbatim do central — re-derivado |
src/main/resources/public/css/app.css |
scaffold templates/app.css |
copy-once — é conteúdo deste app, nunca re-derivado |
src/main/jte/kit/navMenu.jte |
deste app | conteúdo local (menu do maxsul-pied) |
As telas do repo (painel/, console*, captura*, dados/, destinatarios/) chamam o layout do
kit; o painel do colaborador tem um layout próprio por decisão anterior — separar menu de
operador do que o cliente vê (0006 §"Reusar o layout/navbar de
operador nas telas do usuário: rejeitada"). Isso não é desvio do 0025: é o mesmo kit com dois
recortes de navegação.
Consequências¶
- A
/xadm-docsmantémkit/layout.jte,kit/headerRight.jteecustom-theme.cssem sincronia com o central (o kit é opcional no manifesto; instalado, sincroniza como qualquer template). app.cssenavMenu.jtesão deste app — não re-derive nem reporte defasagem deles.- Mudança de identidade visual da casa chega por re-derivação do kit, não por edição local.
- Este RD é ponteiro: divergência de mérito sobre o motor de views se resolve no ADR central 0025, não aqui.