# Documentação Monetarie: convenção OFICIAL dos dois portais (decisão do dono, 21/07/2026)

REGRA (não inverter nunca):

| Portal | Pasta fonte | Público-alvo | Host que serve |
|---|---|---|---|
| Docs de CLIENTE FINAL ("Monetarie API": ApiKey + HMAC-SHA512 + whitelist de IP) | `docs/docs-site/` (esta pasta) | Cliente final da Monetarie | `docs.monetarie.com` (PRD) e `docs-h.monetarie.com` (HML) — PÚBLICOS |
| Docs da PARTNER API (OAuth2 client_credentials, integração servidor a servidor) | `docs/partner-portal/` | Parceiros internos (Vulci/integrações diretas) | `docs.monetarie.internal` / `docs-h.monetarie.internal` — SOMENTE INTERNOS (VPN) |

Como funciona o serving: UMA imagem (`monetarie/docs-portal` no ECR, service ECS `docs-portal`) construída pelo `docs/docs-site/Dockerfile` builda OS DOIS sites VitePress e o nginx roteia por Host header (`nginx-dualhost.conf`): server_name `docs.monetarie.com|docs-h.monetarie.com` entrega o cliente final; default_server entrega o partner (todo host interno cai nele). O conteúdo do partner-portal NUNCA é exposto pelos hosts públicos.

Layout: os dois portais compartilham o MESMO tema visual (hero com diamante dourado + 3 cards, escuro #101820 / ouro #ffc847) — aprovado pelo dono. Ao alterar textos, manter o layout; o que muda entre eles é o conteúdo (cliente final = modelo AVIV: ApiKey/HMAC/whitelist; partner = OAuth2/escopo/idempotência).

Build + deploy (a partir da RAIZ do repo):

    docker buildx build --platform linux/arm64 -f docs/docs-site/Dockerfile \
      -t 990933657879.dkr.ecr.sa-east-1.amazonaws.com/monetarie/docs-portal:homolog-<sha>-<slug>-<data> --push docs/

Depois registrar task-def nova (families `monetarie-docs-portal-homolog|prod`) e update-service `docs-portal` nos 2 clusters. PRD = retag por imagetools com digest MATCH.

Histórico da nomenclatura: a pasta nasceu como `docs/client-portal` e foi renomeada para `docs/docs-site` em 21/07 (commit `0e8dfe94`) para seguir a convenção da AVIV (`docs-site` = docs de cliente). O diretório `core/docs-site/` é OUTRA coisa (docs de desenvolvedor do core) — não confundir.