Ambiente local — deployment e reprodutibilidade¶
Data: 11/10/2026 · Status: achados abertos, sem alteração de manifests dos serviços.
Ambiente dos achados: ambiente local e configurações de build disponíveis no workspace. Estes registros não diagnosticam DEV, STAGING ou PROD. A infraestrutura corporativa requer evidências próprias; diferenças em relação ao ambiente local não demonstram erro.
AA-006 — Endereçamento entre serviços¶
Evidência: ConfigMap BFF configura GATEWAY_METRICS_BASE_URL com totvs-gateway-metrics; o Service é totvs-gateway-monitoring. Há duplicação de GATEWAY_OBJECT_STORAGE_BASE_URL. URLs necessárias a caminhos de documentação não aparecem em todos os ConfigMaps correspondentes.
Fontes: BFF ConfigMap, Monitoring Service, Broker ConfigMap, OpenAPI ConfigMap.
Risco inferido: falha de resolução ou fallback para URL inadequada. Recomendação: comparar valores renderizados com clients e Services. Fechamento: revisão do deployment efetivo e smoke de cada caminho.
AA-007 — Propagação de headers e exposição¶
Evidência: o Ingress Broker lista apenas token/discovery em auth-response-headers; os serviços usam flags adicionais em caminhos de erro. Há rotas condicionadas a devMode. Ingress, Broker, rotas dev.
Risco inferido: divergência entre erro decidido e resposta pública; exposição de interfaces internas quando perfis de desenvolvimento são usados fora de contexto. Recomendação: matriz ingresso/headers/rotas por ambiente. Fechamento: validar o controller e os valores reais. Não houve alteração de ingresso nesta tarefa.
AA-008 — Rastreabilidade de releases¶
Evidência: tags mutáveis, overrides locais, dependências Maven SNAPSHOT e templates externos de pipeline. BFF values, BFF POM, pipeline documental.
Risco inferido: não conseguir atribuir comportamento observado ao código analisado. Recomendação: release manifest com commit e digest de cada componente, inclusive sidecars. Fechamento: inventário reproduzível do ambiente de validação. As dependências do portal foram fixadas nesta entrega; as dos serviços não foram alteradas.
AA-009 — Referência cloud e operação local¶
Evidência: referência cloud mostra GKE, serviços gerenciados e namespaces separados; Helmfile local configura Kind e dependências locais. Web Pages fica fora do agregador e Tunnel não tem chart encontrado.
Risco inferido: onboarding e decisões de disponibilidade baseados na topologia errada. Recomendação: manter as visões separadas e obter evidência cloud antes de declarar HA, peering, isolamento ou serviços ativos. Fechamento: revisão pelo arquiteto e inventário do ambiente cloud. O tutorial histórico permanece identificado como histórico.