Visão geral
StockFlow é uma plataforma backend pensada para empresas que precisam controlar estoque de forma centralizada em ambiente multi-tenant. A API expõe operações de produtos, movimentações, alertas e auditoria, com documentação OpenAPI e integração ao frontend Next.js em produção na Vercel.
- Autenticação JWT + Refresh Token
- RBAC por perfil de acesso
- Auditoria de operações
- Cache com Redis
- Health Checks e Rate Limiting
Problema resolvido
Empresas com múltiplas unidades ou filiais precisam de um sistema de estoque confiável, com isolamento de dados por empresa, rastreabilidade de movimentações e APIs prontas para integração com painéis administrativos.
Regras de negócio
- Cada empresa opera em contexto isolado (multi-tenant).
- Usuários possuem papéis com permissões distintas via RBAC.
- Movimentações de estoque devem ser auditáveis.
- Tokens de acesso expiram e são renovados via refresh token.
- Endpoints críticos possuem rate limiting para proteção.
Arquitetura
Arquitetura em camadas com NestJS
A API segue módulos NestJS com separação entre controllers, services e repositórios Prisma. Redis atua como cache de leitura e PostgreSQL como fonte de verdade.
- Cliente / Frontend
- API Gateway NestJS
- Auth + RBAC
- Services de domínio
- Prisma + PostgreSQL
- Redis Cache
Desafios técnicos
- Segurança
- Escalabilidade
- Arquitetura
- Performance
Decisões técnicas
NestJS + Prisma
Escolhidos para acelerar desenvolvimento tipado, com migrations versionadas e contratos claros entre domínio e persistência.
Redis para cache
Reduz consultas repetitivas em dashboards e listagens de alto volume sem comprometer consistência nas escritas.
Swagger/OpenAPI
Documentação viva da API para facilitar integração do frontend e revisão técnica em entrevistas.
CI/CD no GitHub Actions
Pipeline automatizado garante lint, testes e build a cada push, reduzindo regressões em produção.
Qualidade de Software
Ferramentas, testes automatizados, CI/CD e padrões de engenharia aplicados neste portfólio.