Pular para conteúdo

0029 — Adota as libs da casa na versão corrente (ADR central 0034)

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-09-15 · Decidido em: 2026-09-14

Decisão local do bi-comercial-xls que aponta a decisão CENTRAL 0034 da casa. Os números não se correspondem.

Contexto

O app declara a última versão publicada de cada módulo do xadm-commons que consome. Atrás da corrente é pendência, e abaixo do piso a /xadm-release recusa a release (ADR central 0034, que substitui a política de piso da central 0019 citada na local 0018). O bi-comercial-xls consome cinco módulos: xadm-seguranca, xadm-comum-web, xadm-comum-storage e xadm-comum-util em produção, e xadm-comum-teste nos testes.

Decisão

O app acompanha a corrente dos cinco módulos: xadm-seguranca 0.8.0, xadm-comum-web 0.10.0, xadm-comum-storage 0.3.0, xadm-comum-util 0.2.0 e, em teste, xadm-comum-teste 0.4.0. O mesmo PR aplica as seções ### Migração de cada CHANGELOG:

  • o DSN do GlitchTip vem só do SENTRY_DSN;
  • a credencial do Garage vem dos nomes do broker, GARAGE_ACCESS_KEY_ID e GARAGE_SECRET_ACCESS_KEY (os antigos GARAGE_ACCESS_KEY/GARAGE_SECRET_KEY ainda são lidos, com WARN);
  • o Postgres de teste passa ao singleton da xadm-comum-teste, com a base IntegracaoComPostgres, e as regras de fronteira da RegrasArquitetura substituem as cópias locais;
  • a @IntegracaoDocker e a DockerDisponivelCondition vêm da xadm-comum-teste, e as cópias locais saem;
  • no modo PSQL o ArquivoXlsStorage segue injetado direto: a xadm-comum-storage só cobra a credencial do Garage quando algo chama o S3, e o recurso nesse modo dispensa as envs do Garage.

Consequências

  • Bumpar lib é migrar: a próxima /xadm-release sobe o que estiver atrás e aplica as ### Migração em ordem, removendo o código local que a lib passou a prover.
  • O recurso Coolify precisa de SENTRY_DSN e do par GARAGE_ACCESS_KEY_ID/GARAGE_SECRET_ACCESS_KEY antes do deploy. As envs antigas saem depois que o app estiver no ar com as novas (Deploy).
  • A xadm-seguranca 0.8.0 tira o login do event loop; aqui nada muda, porque o app já declara micronaut.server.thread-selection: AUTO.
  • Este RD é ponteiro: divergência de mérito sobre versão de lib se resolve no ADR central 0034.

Alternativas consideradas

  • Subir só as versões e deixar as ### Migração para depois, apoiado no dual-read da credencial do Garage: descartado. O dual-read é transição com saída anunciada, e a 0034 faz do bump uma migração no mesmo PR.