API REST para uma plataforma de barbearias, construída com NestJS, TypeScript, Prisma e PostgreSQL. O projeto organiza as regras de negócio com princípios de Clean Architecture e DDD.
- Swagger UI:
http://localhost:3001/docs - Contrato OpenAPI JSON:
http://localhost:3001/docs/openapi.json - Índice completo da documentação
- Visão geral
- Arquitetura
- Fluxos da aplicação
- Regras de negócio
- Guia da API
- Desenvolvimento e execução local
- Backlog técnico e de produto
Na Swagger UI, use Authorize com o accessToken retornado por
POST /api/v1/users/login para testar as rotas protegidas.
npm install
docker compose up -d
npx dotenv-cli -e .env.development -- npx prisma migrate deploy
npm run start:devA API inicia em http://localhost:3001 por padrão. Configure APP_PORT,
DATABASE_URL, JWT_SECRET e JWT_EXPIRES_IN em .env.development; há um
exemplo completo no guia de desenvolvimento.
npm run start:dev # desenvolvimento com recarga
npm run build # build de produção
npm test # testes
npm run test:int # testes de integraçãoPara entender qual documento é a fonte de verdade de cada assunto, comece pelo índice da documentação.