vek1 — contexto
VEK1 — contexto raiz
Snapshot completo em
brain/projects/vek1/. Esta nota é só o índice — detalhes nas vizinhas.
O que é (uma frase)
SaaS multi-tenant de agentes de IA conectados ao WhatsApp via Evolution API, com base de conhecimento por embeddings (Postgres+pgvector, self-hosted) — voltado a PMEs pra automação de atendimento, vendas consultivas e fechamento de pedido com PIX (AbacatePay) ou pagamento na entrega.
Arquitetura atual (api-first)
vek1 (Next 16) virou camada thin de UI + auth + roteamento. Toda escrita em DB passa pelo vek1-api (FastAPI/Python no VPS Hermes) via HTTP interno com X-Internal-Token, X-Auth-Token ou X-Webhook-Token (3 escopos isolados). A frente:
- Better Auth usa
httpAdaptercustom (src/lib/auth-http-adapter.ts) → endpoints/internal/auth/*no vek1-api. apiClient(src/lib/api-client/*) é o único caminho de mutation: auth/orders/leads/agents/products/documents/stores/company/dashboard/messages/audit/tokenUsage/email.lib/supabase.ts(legado) virou wrapper snake_case sobre apiClient (compat com ~10 callers que ainda importam).- Drizzle ORM permanece como source-of-truth do schema (
src/lib/db/schema.ts) — mas reads/writes diretos de DB do frontend são raros (queries só pra renderização SSR).
vek1-api/context tem a contraparte detalhada.
Tipos de agente
Lista canônica via vek1-api /agents (config YAML). Confirmado 2026-05-20:
| type | nome | preço |
|---|---|---|
sales_assistant |
Assistente de Vendas | R$199 |
satisfaction_research |
Pesquisa de Satisfação | R$99 |
technical_support |
Suporte Técnico | R$49 |
Modelo: deepseek-chat (todos). Agente sales_assistant tem function calling com create_order — sai do "consultivo" pro "fechamento de pedido real".
Onde olhar primeiro
| Quero saber sobre | Lê |
|---|---|
| Negócio, planos, público | domain.md |
| Roteiro de vendas (SDR → fechamento) | sales-script.md |
| Pricing spec (Stripe sub + topup) — draft | pricing-design.md |
| Stack + estrutura de pastas | architecture.md |
| Schema Postgres (Drizzle) | data-model.md |
| Auth (Better Auth + HTTP adapter) | auth.md |
| Features (agents, KB, orders, leads, settings, stock-sync) | features.md |
| AbacatePay, Evolution, Resend, vek1-api, envs | integrations.md |
| Cache Components, Server Actions, CI, testes | decisions.md |
| O que está pronto, WIP, código morto | state.md |
| Bugs, traps, gotchas | gotchas.md |
| Gaps e riscos | gaps.md |
| Trajetória / PRs recentes | recent-activity.md |
Localização
- Repo: https://github.com/marcuscaum/vek1
- Clone local:
C:\Users\User\vek1\ - Branch principal:
main - Deploy: Vercel (frontend + Next API routes/route handlers)
- Backend: vek1-api em
https://vek1-api.kodama.solutions(VPS Hermes)
Stack resumido
- Next 16.2.6 (App Router, Cache Components/PPR, Turbopack) · React 19 · TS strict
- Drizzle ORM +
postgres-js(schema source-of-truth — escrita via vek1-api) - Better Auth 1.6 (email/password, HTTP adapter custom → vek1-api)
- MinIO/S3 (
@aws-sdk/client-s3) — bucket únicovek1, key prefix porcompanies/{user.id} - AbacatePay (PIX) — gateway de cobrança das orders do cliente final
- Evolution API v2.3.x (WhatsApp) — instância criada via
evolution-instance.ts(fetch direto, sem lib externa) - Resend (email transacional — reset password) na API, não no frontend
- Tailwind v4 + shadcn/ui (style new-york, base slate) + Radix · Jotai · SWR · Sonner · Recharts
- Bun no CI; Vitest 4 + Testing Library + jsdom (não Jest)
Status comercial
Beta gratuito. Lojistas atuais não pagam (custos LLM/infra saem do bolso). Spec de pricing draft em pricing-design.md: 3 tiers Stripe (Starter R$79 / Pro R$299 / Business R$899) + metered overage + topup avulso com bônus 50% primeira carga.