Teste de Backend (Unificado: Docker Local & AWS SAM)

Implementa:

• Local: FastAPI + Celery + Redis + MongoDB (Docker Compose)
• AWS: API Gateway + Lambda + SQS + DynamoDB (SAM)

Alternância unificada de RUN_MODE

Defina o modo de execução em .env:

• RUN_MODE=local → Stack Dockerizada
• RUN_MODE=aws → Stack Serverless

Configuração

cp .env.sample .env
# edite conforme necessário; defina RUN_MODE=local ou RUN_MODE=aws

Executar

./run.sh         # Linux/macOS
run.cmd          # Windows
# ou: make up

Deploy (AWS)

RUN_MODE=aws ./deploy.sh    # Linux/macOS
set RUN_MODE=aws & deploy.cmd   # Windows
# ou: make aws-deploy

Testar

./test.sh         # Linux/macOS
test.cmd          # Windows
# ou: make test

Endpoints (Local)

• API: http://localhost:8000
• Swagger: http://localhost:8000/docs

Endpoints (AWS local)

• API: http://127.0.0.1:3000 (via sam local start-api)

Celery (Fila de Tarefas)

O projeto utiliza o Celery para processamento assíncrono de tarefas, usando o Redis como broker e backend.

Como funciona

• O Celery executa tarefas em background, como processamento de dados ou envio de e-mails.
• No modo local, o worker Celery é iniciado automaticamente pelo Docker Compose.
• Para rodar manualmente (fora do Docker), use:

celery -A processor.celery_app worker --loglevel=info

Exemplos de uso

• As tarefas estão definidas em processor/tasks.py.
• O FastAPI pode disparar tarefas Celery via endpoints.

Monitoramento

• Para monitorar as tarefas, acesse o log do container worker ou utilize ferramentas como Flower.

---

Notas

• Prefira AWS SSO / papéis IAM; as chaves do .env são apenas para uso local.
• O stack AWS está em aws-sam/ com template.yaml e fontes das Lambdas.