Evidências e limites¶
Estados de implementação¶
| Estado | Uso |
|---|---|
| Implementado | Funcionalidade ou componente presente no código |
| Parcialmente implementado | Parte do comportamento existe; indicar o que falta |
| Planejado | Funcionalidade prevista, ainda sem implementação |
| Experimental | Alternativa em avaliação, sem adoção oficial |
| Legado | Implementação ou conteúdo histórico mantido por compatibilidade ou referência |
Propostas e referências arquiteturais permanecem identificadas como tais. Esses estados descrevem implementação; não exigem ressalvas de execução.
Rastreabilidade¶
As fontes apontam para código, contratos, testes e configurações. Links Azure DevOps usam version=GC<commit> e requerem acesso corporativo. O inventário centraliza repositórios e versões; mkdocs/validation/source-links.json registra os paths citados.
Escopo e exclusões¶
A edição abrange exclusivamente backend e infraestrutura associada: arquitetura, deployment local, referência cloud, BFF piloto e modelagem de dados. O dicionário reconstrói documentos, campos e índices a partir do código, sem afirmar a configuração física dos bancos corporativos. Fluxos E2E detalhados continuam como etapa posterior; os templates orientam a manutenção e ampliação do acervo.
Não foram executados testes dos microserviços nesta tarefa; os testes citados foram lidos como evidência de cenários. Os resultados do portal constam em Validação. Build do portal não valida APIs, políticas de segurança ou comportamento distribuído.
Contexto do responsável (correção de escopo): o cliente administrativo possui infraestrutura e ciclo de deployment independentes e não é executado no cluster Kubernetes do backend. É representado somente como consumidor externo, sem investigação de sua implementação.
Contexto corporativo e ambiente local¶
A infraestrutura e os deployments de DEV, STAGING e PROD são de responsabilidade do TOTVS Apps, assim como sua documentação oficial.
Este portal detalha o ambiente local experimental de desenvolvimento, integração e validação arquitetural. Istio e Kubernetes Gateway API permanecem experimentais, exclusivos do ambiente local, e não fazem parte da entrega corporativa oficial. A configuração local não representa necessariamente os ambientes corporativos.
Acervo anterior e fonte canônica¶
docs/ARCHITECTURE.md, SERVICES.md, DEPENDENCIES.md, FLOWS.md, DATA.md, INFRASTRUCTURE.md e OPEN_QUESTIONS.md foram usados como orientação e confrontados com fontes atuais. Permanecem preservados fora do portal; não são mantidos como uma segunda descrição canônica nesta tarefa.
Diferenças já reconciliadas: Web Pages agora possui fonte local; agendamento HTTP já integra o develop do Scheduler; BFF possui novas fachadas de documentação e infraestrutura parcial de autorização por recurso.
O diagrama cloud foi indicado pelo responsável e copiado integralmente. A classificação anterior de Istio como experimental veio do responsável e está registrada como tal.