Tema
Stack Tecnológico
Backend
| Tecnologia | Versão | Por quê |
|---|---|---|
| Node.js | 20+ | Runtime padrão do ecossistema |
| NestJS | 10+ | Framework opinativo com DI, módulos, decorators — estrutura previsível para time |
| TypeScript | 5+ | Type safety em todo o código |
| Prisma | 5+ | ORM com migrations, type-safe queries, suporte a pgvector |
| PostgreSQL | 13+ (pgvector) | Banco relacional com suporte a vetores para futuras features de AI |
| Redis | Latest | Filas (BullMQ), cache, deduplicação, flags de business hours |
| BullMQ | Latest | Processamento assíncrono de jobs com retry, backoff, dead-letter |
| Nodemailer | Latest | Envio de email via SMTP |
| MJML | Latest | Templates de email responsivos compilados para HTML |
Frontend
| Tecnologia | Versão | Por quê |
|---|---|---|
| Next.js | 15 | SSR/SSG com App Router, bom ecossistema |
| React | 19 | UI library padrão |
| TypeScript | 5+ | Consistência com backend |
| Tailwind CSS | Latest | Utility-first, produtividade |
| shadcn/ui | Latest | Componentes acessíveis baseados em Radix UI |
| Clerk | Latest | Autenticação pronta (login, organização, convites) |
Infraestrutura
| Tecnologia | Por quê |
|---|---|
| Docker Compose | Orquestração local e produção (3 arquivos obrigatórios) |
| Traefik | Reverse proxy com TLS automático (Let's Encrypt) |
| MinIO | Armazenamento S3-compatible self-hosted para imagens e arquivos |
| Azure Key Vault | Gerenciamento seguro de secrets em produção |
Serviços externos
| Serviço | Função |
|---|---|
| Clerk | Autenticação, gestão de usuários e organizações |
| Meta WhatsApp Business API | Envio oficial de mensagens WhatsApp (WABA) |
| Chatwoot | Plataforma de atendimento multicanal (self-hosted) |
| Evolution API | Cliente WhatsApp por QR code (não-oficial) |
| n8n | Automação de fluxos (self-hosted) |
| Millennium ERP | Sistema de gestão (fonte dos dados de clientes e vendas) |
Padrões de código
- Linguagem do código: inglês (variáveis, funções, comentários, commits)
- Linguagem das respostas: português brasileiro
- Commits: conventional commits (
feat:,fix:,chore:) - Testes: Jest para unitários, Playwright para E2E
- Linting: ESLint + Prettier