4.5 KiB
4.5 KiB
Tech Stack
| Categoria | Tecnologia | Versão | Propósito | Justificativa |
|---|---|---|---|---|
| Containerização | Docker | 24+ | Build e runtime de containers | Reprodutibilidade, portabilidade |
| Orquestração | Kubernetes | 1.28+ | Deploy e orquestração | Padrão de mercado, self-healing |
| Ingress Controller | Nginx Ingress | Latest | Roteamento HTTP | Simples, direto ao ponto |
| Linguagem Frontend | TypeScript | 5.3+ | Código frontend type-safe | Type safety reduz bugs, melhora DX com autocomplete |
| Framework Frontend | Next.js | 14.2+ | Framework React SSR | App Router moderno, API Routes integradas, standalone output para containers |
| Biblioteca UI | Shadcn/ui | Latest | Componentes React acessíveis | TailwindCSS-based, customizável, tema escuro nativo, WCAG AA |
| Gerenciamento de Estado | React Hooks | (built-in) | Estado local e context | Simplicidade para POC, Context API para auth global |
| Linguagem Backend | TypeScript | 5.3+ | API Routes type-safe | Shared types com frontend, consistência de linguagem |
| Framework Backend | Next.js API Routes | 14.2+ | Endpoints API | Zero config, stateless (K8s-friendly) |
| Estilo de API | REST | - | HTTP JSON APIs | Simplicidade, EvolutionAPI é REST, sem overhead de GraphQL |
| Banco de Dados | PostgreSQL (Supabase) | 15+ | Database relacional | Schema portal isolado, RLS nativo, Supabase gerenciado |
| Cache | Nginx (Ingress) | - | Static assets caching | Cache de assets via Nginx, Redis futuro para app cache |
| Armazenamento de Arquivos | N/A | - | Não requerido na POC | Apenas QR codes (base64 inline) |
| Autenticação | Supabase Auth | Latest | Email/senha, recuperação senha | Auth unificado existente, SMTP configurado, RLS integrado |
| Testes Frontend | Vitest + React Testing Library | Latest | Unit tests componentes | Fast, Vite-based, melhor que Jest |
| Testes Backend | Vitest | Latest | Unit tests API Routes | Mesma ferramenta que frontend, mocking fácil |
| Testes E2E | Playwright | Latest | Testes end-to-end | Multi-browser, fast, trace viewer excelente |
| Build Tool | Turbopack (Next) | (built-in) | Fast refresh e builds | Next.js 14+ default |
| Bundler | Webpack (Next) | (built-in) | Production builds | Next.js production bundler |
| CI/CD | Manual (kubectl) | - | Deploy manual | POC: kubectl apply, sem CI/CD complexo |
| Monitoramento | kubectl logs | - | Logs básicos | POC: logs via kubectl, sem Prometheus/Grafana |
| Framework CSS | TailwindCSS | 3.4+ | Utility-first CSS | Tema escuro fácil, design system AutomatizaSE, Shadcn/ui compatible |