revisão e complementação da documentação do projeto

This commit is contained in:
Marcos Lohmann
2026-09-14 14:54:28 -03:00
parent 868d885cb6
commit f8d9b6cdcd
35 changed files with 767 additions and 8 deletions

View File

@@ -77,7 +77,7 @@ local JWKS HTTP server as a stand-in for the rest of the e2e suite (valid for va
not for real protocol integration with the IdP).
**Production extension documented, not implemented:** mTLS/workload identity —
`docs/adr/ADR-019-identity-extension.md`.
`docs/adr/ADR-019-extensao-de-identidade.md`.
### PDP / Policy Engine (EP-03)

View File

@@ -75,7 +75,7 @@ HTTP local mais leve como stand-in para o resto da suíte e2e (válido para a l
não para a integração de protocolo real com o IdP).
**Extensão de produção documentada, não implementada:** mTLS/workload identity —
`docs/adr/ADR-019-identity-extension.md`.
`docs/adr/ADR-019-extensao-de-identidade.md`.
### PDP / Policy Engine (EP-03)

View File

@@ -24,7 +24,7 @@ point being tested.
and adherent to open standards** (OAuth 2.1/OIDC, Rego), not out of arbitrary preference. This
resolves two gaps that the reference architecture left open (`README.md` §48, questions
1 and 3) with a definitive technical decision, not an assumption — they were never revisited
throughout the implementation. See `docs/adr/ADR-019-identity-extension.md`,
throughout the implementation. See `docs/adr/ADR-019-extensao-de-identidade.md`,
`docs/adr/ADR-025-engine-do-pdp.md`.
**We rejected** a custom PDP engine in Python (more control, but reinvents policy evaluation

View File

@@ -24,7 +24,7 @@ próprio ponto que estava sendo testado.
aderentes a padrões abertos** (OAuth 2.1/OIDC, Rego), não por preferência arbitrária. Isso
resolve duas lacunas que a arquitetura de referência deixava abertas (`README.md` §48, perguntas
1 e 3) com uma decisão técnica definitiva, não uma suposição — nunca foram revisitadas ao longo
da implementação. Ver `docs/adr/ADR-019-identity-extension.md`,
da implementação. Ver `docs/adr/ADR-019-extensao-de-identidade.md`,
`docs/adr/ADR-025-engine-do-pdp.md`.
**Rejeitamos** um engine de PDP próprio em Python (mais controle, mas reinventa avaliação de

View File

@@ -13,7 +13,7 @@ Target audience: whoever is going to **evaluate or adapt** this RI for a real sc
A real, highly available IdP (Keycloak cluster, or a managed equivalent), not the single
instance from `docker-compose.yml`. The extension to mTLS/workload identity — covering cases
where `client_credentials` is not strong enough (e.g.: workloads in a service mesh) — is
already documented as an extension point in `docs/adr/ADR-019-identity-extension.md`; production
already documented as an extension point in `docs/adr/ADR-019-extensao-de-identidade.md`; production
would implement that extension, not reinvent the authentication middleware from scratch.
## PDP

View File

@@ -13,7 +13,7 @@ Público-alvo: quem vai **avaliar ou adaptar** esta RI para um cenário real.
Um IdP real em alta disponibilidade (cluster Keycloak, ou equivalente gerenciado), não a
instância única do `docker-compose.yml`. A extensão para mTLS/workload identity — cobrindo casos
em que `client_credentials` não é forte o suficiente (ex.: workloads em malha de serviço) — já
está documentada como ponto de extensão em `docs/adr/ADR-019-identity-extension.md`; produção
está documentada como ponto de extensão em `docs/adr/ADR-019-extensao-de-identidade.md`; produção
implementaria essa extensão, não reinventaria o middleware de autenticação do zero.
## PDP