kodama-hub — contexto

Kodama Hub

Plataforma central multi-tenant que conecta números de WhatsApp empresariais a agentes RAG (Retrieval-Augmented Generation). Operada pela Kodama com onboarding manual via painel administrativo. Cada empresa gerencia múltiplos números, onde cada número executa um agente RAG independente, utilizando como canal o WhatsApp Cloud API (Meta) ou Evolution, configurável por número. A aplicação está em produção em hub.kodama.solutions (VPS Hermes).

Stack principal: Next.js 16 (web/painel admin), FastAPI (API RAG), DeepSeek, Ollama bge-m3, Postgres com pgvector.

Estrutura relevante (monorepo):

• web/ - Next.js 16, contém painel admin e webhooks/envio WhatsApp (fork do vek1)
• api/ - FastAPI, implementa RAG com DeepSeek + Ollama bge-m3 + Postgres/pgvector (fork do vek1-api)
• docs/superpowers/specs/ - especificações de design

Comandos comuns: (não especificados no README, mas assume-se gerenciamento via npm/yarn e pip para as stacks)

Agents/Skills notáveis:

• Agente RAG por número de WhatsApp, com suporte a múltiplos canais (Cloud API e Evolution)
• RAG baseado em documentos por número, com upload gerenciado pelo painel
• Funcionalidades fora do MVP: roteador de atendimento, handoff humano, bridge de número próprio, crawl de site, conector de dados ao vivo