O que recebe na entrega

Após licença e canal institucional, o cliente recebe o pacote baseline (nível 1) com código, configuração de exemplo, ambiente lab e validação repetível. Versão de referência documentada: 0.1.0-dev.

Transparência: esta página descreve o conteúdo típico da entrega licenciada. O artefacto exacto acompanha VERSION e MANIFEST.md no pacote recebido.

Estrutura do pacote

flowchart TB
    ROOT["Pacote licenciado Área 51"]
    BL["baseline/"]
    SRC["src/area51_config/"]
    OP["operational/"]
    TESTS["tests/"]

    ROOT --> BL
    ROOT --> SRC
    ROOT --> OP
    ROOT --> TESTS

    BL --> BLR["README · VERSION · MANIFEST · CHANGELOG"]
    BL --> BLS["scripts/ — validate, samples, manifest"]
    BL --> BLC["config/ — exemplos .env"]
    BL --> BLD["docs/ — QUICKSTART e guias"]

    SRC --> CLI["CLI area51-config"]
    OP --> KC["Keycloak Docker :8080"]
    OP --> APP["App Flask protegida :5000"]

Directórios principais

Caminho	Conteúdo
`baseline/`	Entrega versionada: manifesto, scripts de validação e exemplos de configuração
`baseline/config/`	`.env.google.example`, `.env.microsoft.example`, `frontier.onprem.env.example`, `oidc.keycloak.client.env.example`
`baseline/scripts/`	`validate_baseline.py`, `generate_sample_configs.py`, `prepare_delivery.py`
`src/area51_config/`	Biblioteca e CLI `area51-config` para gerar parâmetros OIDC
`operational/`	Stack lab: Keycloak + aplicação protegida de referência
`tests/`	Testes automatizados de protocolo e fluxo (~118 cenários)

Primeiros passos após receber

Validação da baseline

python baseline/scripts/validate_baseline.py

Executa fases dev (testes), config (Google/Entra), env (fronteira + OIDC) e, com IdP activo, operational (validate_oidc_flow).

Configuração OIDC: area51-config ou módulo area51_config — gera parâmetros com PKCE.
Lab Keycloak: realm caracore-area51 · utilizador demo demo / demo123.
App de referência: rota /protected na porta 5000.
Guia rápido: baseline/docs/QUICKSTART.md no pacote recebido.

Fluxo pós-entrega

flowchart LR
    E["Pacote recebido"] --> V["validate_baseline.py"]
    V --> C["Configurar .env
fronteira + OIDC"]
    C --> L["Subir lab operational/"]
    L --> F["validate_oidc_flow"]
    F --> H["Evidência para homologação"]

O que é o Área 51 Componentes Fronteiras e segurança Fluxo OIDC