vek1 — contexto

Projeto Kodama1/VEK1

VEK1 e uma aplicacao web moderna construida com Next.js 15, React 19, TypeScript e Supabase como backend. O projeto implementa arquitetura Server-First, utilizando Server Components por padrao e Server Actions para mutacoes de dados.

Stack Principal

• Next.js 15 (App Router, PPR, Server Components)
• React 19 (hooks, TypeScript estrito)
• Supabase (auth, banco, storage, busca vetorial)
• Tailwind CSS para estilizacao
• Vitest + Testing Library para testes
• Bun como gerenciador de pacotes oficial
• Drizzle ORM para banco de dados
• OpenAI, Stripe, AWS S3, Radix UI, Jotai

Estrutura Relevante

app/
  actions/     → Server Actions
  api/         → Rotas API (migrando para Actions)
  (internal)/  → Rotas protegidas
components/
  ui/          → Componentes reutilizaveis
  [feature]/   → Componentes por funcionalidade
lib/
  supabase/
    client.ts  → Cliente browser
    ssr.ts     → Cliente servidor
hooks/         → Custom hooks
__tests__/     → Testes unitarios

Comandos Comuns

bun install           # Instalar dependencias
bun run dev           # Desenvolvimento com Turbopack
bun run build         # Build de producao
bun run generate:types # Gerar tipos Supabase
bun run test          # Executar testes
bun run lint          # Verificar lint

Agents/Skills Notaveis

• Evolution API: Gateway WhatsApp (server-side e client-side)
• OpenAI: Geracao de embeddings
• Better Auth: Sistema de autenticacao
• Stripe: Gerenciamento de assinaturas e faturamento
• AWS S3: Armazenamento de arquivos com presigned URLs
• TanStack Virtual: Virtualizacao de listas
• CMDK: Command palette para navegacao

O projeto segue praticas rigorosas de codigo: Server Components por padrao, tipagem estrita (sem any), Tailwind CSS exclusivo, e testes obrigatorios para componentes, hooks e utilitarios. CI/CD valida build, testes e lint em pull requests.