Skip to content

docs: o /healthz respondia uma coisa e a wiki anunciava outra - #4

Merged
elielsousa-pathbit merged 1 commit into
masterfrom
docs/revisao-profunda
Sep 12, 2026
Merged

elielsousa-pathbit merged 1 commit into
masterfrom
docs/revisao-profunda

Conversation

@elielsousa-pathbit

Copy link
Copy Markdown
Contributor

A página do painel e a de diagnóstico documentavam OMNIROUTE_SERVICE_UNREACHABLE. O servidor responde GATEWAY_SERVICE_UNREACHABLE.

Nada quebra por causa disso: o painel funciona, o healthcheck funciona, os testes passavam. Quem perde é quem monta um alerta sobre a string documentada — ele nunca dispara, e o silêncio parece saúde.

Corrigi a documentação para o valor real, e não o contrário: mudar o código quebraria quem já monitora a resposta que ele de fato devolve.

Novo teste

Cada resposta que o /healthz produz tem de aparecer na documentação, e nenhuma página pode citar resposta que o código nunca devolve. As duas direções, porque cada uma falha de um jeito diferente.

Verificado que pega a regressão: reintroduzir a string antiga numa cópia descartável falha o teste, apontando arquivo e linha.

https://claude.ai/code/session_01Dw2Zc66wvY8QBZJmPBeMsT

A pagina do painel e a de diagnostico documentavam
OMNIROUTE_SERVICE_UNREACHABLE; o servidor responde
GATEWAY_SERVICE_UNREACHABLE. Nada quebra por causa disso: o painel funciona,
o healthcheck funciona, os testes passavam. Quem perde e quem monta um
alerta sobre a string documentada -- ele nunca dispara, e o silencio parece
saude.

Corrigida a documentacao para o valor real, e nao o contrario: mudar o
codigo quebraria quem ja monitora a resposta que ele de fato devolve.

Novo teste: cada resposta que o /healthz produz tem de aparecer na
documentacao, e nenhuma pagina pode citar resposta que o codigo nunca
devolve. Verificado que ele pega a regressao -- reintroduzir a string antiga
numa copia falha o teste, com arquivo e linha.
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@elielsousa-pathbit
elielsousa-pathbit merged commit b3eb92c into master Sep 12, 2026
5 checks passed
@elielsousa-pathbit
elielsousa-pathbit deleted the docs/revisao-profunda branch September 12, 2026 20:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant