Início Rápido
Pré-requisitos
- Node.js >= 20
- Docker Desktop em execução
npm cina raiz do monorepo
Opção 1 — Local sem Docker (dev puro)
# Sobe DynamoDB local
docker compose up -d dynamodb-local
# Cria tabelas
npm run docker:dynamo:init
# Inicia o bot em modo local
ALLOW_ANONYMOUS=true DISABLE_QUEUE_SEND=true \
npm run dev:local -w @bi-agent/bot-handler
Acesse http://localhost:3000/health → deve retornar {"status":"ok"}.
Opção 2 — Docker Compose (stack completa)
docker compose up --build -d
npm run docker:dynamo:init
Endpoint do bot: http://localhost:3900
Opção 3 — Docker + LocalStack (simulação AWS)
npm run docker:localstack:up
npm run docker:dynamo:init
npm run localstack:init
npm run smoke:localstack:bot
Endpoint do bot: http://localhost:3901
Próximos passos
- Guia Docker + Postman — validar fluxos com coleção Postman
- Guia Docker + LocalStack — simular SQS/Secrets Manager
- API Reference — contrato OpenAPI interativo