Skip to content

docs: revisao das adrs de decomposicao, painel web e escala a zero - #19

Merged
NicolasArthurDev merged 10 commits into
devfrom
docs/adr-indexadores-em-go
Sep 17, 2026
Merged

NicolasArthurDev merged 10 commits into
devfrom
docs/adr-indexadores-em-go

Conversation

@thnbi

@thnbi thnbi commented Sep 15, 2026 •

Copy link
Copy Markdown
Contributor

O que mudou

  • ADR-0031 registrando o painel web em Ruby on Rails com Hotwire, neste repositório, como cliente da API REST
  • ADR-0032 registrando KEDA como o gatilho da escala a zero, com os indexadores em ScaledJob e o worker de notificação em ScaledObject
  • ADR-0028 com a justificativa do MCP reescrita como isolamento mútuo, o painel web atualizado após o ADR-0031, e a decomposição posicionada na definição pragmática de microsserviços em vez de negá-la
  • ADR-0027 corrigido, porque dizia "Job com escala a zero" e Job não escala a zero
  • ADR-0002 com status dizendo que a alternativa de microserviços via rede foi retomada, e que a escolha de linguagem por serviço fica em aberto de propósito

Por quê

O ADR-0028 terminava negando ser microsserviço. O projeto persegue a definição clássica de
forma pragmática: adota componentização por serviço, canos burros, automação de infraestrutura,
projeto para falha e design evolutivo, e declina organização por capacidade de negócio,
governança poliglota e banco por serviço. A consequência agora afirma a posição e nomeia o
custo, acoplamento pelo schema e migration coordenada entre os seis serviços que alcançam o
banco.

O painel web estava previsto como arquivo estático em CDN, sem processo. Passa a ser aplicação
Rails com processo próprio, cliente da API como qualquer outro, sem alcançar o PostgreSQL.

A escala a zero era promessa sem mecanismo. A documentação do Kubernetes define Job como tarefa
que roda até terminar e para, então alguém precisa criá-lo a cada lote, e nenhum ADR dizia quem.
O ADR-0018 rejeitou broker e o ADR-0021 rejeitou fila, os dois condicionando a entrada a medir
primeiro. KEDA lendo o cursor de revisão cabe nesse histórico, porque continua sendo o mesmo
polling, agora feito pela plataforma em vez da aplicação.

O que saiu deste PR

Havia aqui uma ADR fixando Go nos indexadores. Ela foi retirada porque suas premissas caíram
durante a própria revisão: a consequência "o CI segue rodando só Go" ficou falsa com a chegada
do Rails, e o argumento técnico principal era o ONNX via cgo, que depende do provedor de
embedding local continuar sendo o caminho do self-host.

A escolha de linguagem por serviço volta a ficar em aberto, registrada como tal no status do
ADR-0002.

Pendência que este PR não resolve

O ADR-0026 diz que o servidor MCP é cliente da API sem acesso privilegiado ao armazenamento, e
o ADR-0028 o põe compartilhando o banco. As duas leituras têm consequências opostas para
autenticação, tenant e auditoria, e a decisão fica para um ADR próprio.

Como testar

  • Conferir que o status do ADR-0002 diz o que foi retomado e o que ficou em aberto
  • Conferir que as consequências do ADR-0028 afirmam a posição em vez de negá-la
  • Conferir que o ADR-0031 não deixa o painel alcançar o banco
  • Conferir que o ADR-0032 não contraria a rejeição de broker do ADR-0018 nem a de fila do ADR-0021

Auto-review (checklist)

  • Descrição clara (o que/por quê/como testar)
  • PR pequeno e focado
  • Casos limite considerados (ex.: vazio, 0, erro)
  • Evidência de teste (manual ou automatizado)

@thnbi thnbi self-assigned this Sep 15, 2026
@thnbi thnbi added documentation Improvements or additions to documentation isn Disciplina ISN 75620501, edicao 2026.2 labels Sep 15, 2026
@thnbi thnbi changed the title docs: adr dos indexadores em go docs: adr dos indexadores e posicionamento em microsservicos Sep 15, 2026
@thnbi thnbi changed the title docs: adr dos indexadores e posicionamento em microsservicos docs: revisao das adrs de decomposicao, linguagem e painel web Sep 15, 2026
@thnbi thnbi changed the title docs: revisao das adrs de decomposicao, linguagem e painel web docs: revisao das adrs de decomposicao e painel web Sep 16, 2026

@NicolasArthurDev NicolasArthurDev left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@NicolasArthurDev
NicolasArthurDev merged commit 3a1f6b9 into dev Sep 17, 2026
2 checks passed
@thnbi thnbi changed the title docs: revisao das adrs de decomposicao e painel web docs: revisao das adrs de decomposicao, painel web e escala a zero Sep 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation isn Disciplina ISN 75620501, edicao 2026.2

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants