Repository navigation

Arquitetura — exclusão Pix (canônico)

Fonte da verdade: ADR-001 (Accepted) + README. Este arquivo não substitui o ADR; só resume o desenho atual pra agents/humanos.

Bounded context

Um repo, um stack deployável: patote85/aws-lambda-api-gateway-python.

Pasta	Papel
`lambda/`	Handler Powertools (HTTP API)
`cdk/`	Cognito + DynamoDB + Lambda + HttpApi (JWT)
`tests/`	pytest + moto (sem AWS)
`docs/adr/`	Decisões versionadas

aws-api-gateway-cdk está arquivado (banner no README dele) — não usar pra deploy.

Componentes (hoje)

HTTP API — throttle 100 rps / burst 200; CORS lab localhost (sem *)
Lambda Python 3.12 — app.lambda_handler
DynamoDB — PK cliente_id / SK request_id, pointer LATEST
Cognito User Pool — JWT nas rotas mutáveis/status; GET /health público

Access pattern Dynamo (obrigatório)

Histórico: SK = <uuid>
Ponteiro: SK = LATEST (espelho do estado corrente)
Status/dedup leem só LATEST
Confirmação de pagamento atualiza uuid e LATEST

Verificação agent-friendly

make check   # ruff + mypy(tests) + pytest + cdk synth

Não-objetivos (ainda)

Step Functions / SNS/SQS (event-driven) — ADR futuro
WAF / ACM / domínio custom
Pix real (stub de lab)
Unificar com aws-crud-api-lambda-dynamodb (outro BC)