Nexus IA — Plataforma de IA com 620+ endpoints, multimodal e agente autônomo
- 620+
- Endpoints REST
- 20+
- Modelos de IA
- 6
- Planos
Cliente
Nexus IA
Setor
Inteligência artificial e produtividade
Linha do tempo
Iteração contínua · 2026-08
Produto ao vivo
Usar agoraResultados
Resultados reportados pelo cliente durante o rollout
Baseline: core API + gateway /v1 + backend-api
Fonte: Contagem de route handlers (Next.js)
Baseline: chat, raciocínio, pesquisa e voz
Fonte: API /api/models em produção
Baseline: Free, Go, Plus, Pro, Business, Enterprise
Fonte: lib/plans.ts
Baseline: OCR, caption, classify, compare e outros
Fonte: API /api/vision
Baseline: PDF, DOCX, XLSX, PPTX e outros
Fonte: API /api/documents
Baseline: com citações no formato de fonte
Fonte: API /api/search
Baseline: Stripe (internacional) + Mercado Pago (BR)
Fonte: API /api/billing
Baseline: RLS em todas as tabelas
Fonte: Arquitetura ExpoStacker
Dados reportados pelo cliente
O desafio
O desafio
Nexus IA é um SaaS de inteligência artificial que centraliza múltiplos modelos e capacidades em uma plataforma comercial. Oferece Nexus Auto com roteamento automático para o melhor modelo disponível, catálogo com 20+ modelos (chat, raciocínio, pesquisa e voz), gateway OpenAI-compatible para integrações externas, chat com memória de contexto persistente, assistente de código, multimodal (documentos em 20 formatos, áudio, imagem e vídeo), workspace com terminal e agente autônomo capaz de criar arquivos e editar projetos, BYOK e 6 planos comerciais em BRL.
Equipes e profissionais desperdiçam tempo alternando entre múltiplas ferramentas de IA, corrigindo respostas com acentuação quebrada e lidando com limites de uso de APIs individuais, o que reduz produtividade e aumenta custos operacionais.
A abordagem
A abordagem
A arquitetura migrou de um backend Python legado para Next.js 16 com 620+ route handlers cobrindo core API, gateway OpenAI-compatible (/v1) e backend-api — tudo deployado em Cloudflare Workers via OpenNext. Persistência em Supabase (Postgres + Auth + RLS), Nexus Auto escolhe o melhor modelo disponível por tarefa, BYOK permite ao usuário conectar a própria chave e billing roda em Stripe + Mercado Pago.
A solução
A solução
- Nexus Auto — roteamento automático para o melhor modelo disponível por tarefa
- Catálogo com 20+ modelos públicos (chat, raciocínio, pesquisa, voz e realtime)
- Gateway OpenAI-compatible (/v1): chat/completions, models, images, audio, realtime, assistants, threads, memories, embeddings, responses, containers, computer, videos, vision, canvas, skills e documents
- 620+ route handlers REST: core API, gateway /v1 e backend-api compatível
- Assistente de código com geração, explicação, revisão e execução direta
- Workspace completo com terminal, editor, árvore de arquivos e agente autônomo
- Agente autônomo capaz de criar arquivos, editar projetos e executar comandos
- Multimodal: documentos em 20 formatos, áudio (TTS/STT/realtime), imagem e vídeo
- Pesquisa web com 6 engines configuradas (1 ativa sem chave) e citações no formato de fonte
- Memória persistente com RAG, deduplicação, tags e histórico por usuário
- Visão/OCR com 17 capacidades de análise de imagem
- BYOK (Bring Your Own Key) — usuário conecta a própria chave de IA
- 6 planos comerciais (Free, Go, Plus, Pro, Business, Enterprise) em BRL via Stripe + Mercado Pago
- Autenticação JWT + Supabase Auth, cookies httpOnly e rate limiting
- Banco por ilha: Supabase dedicado com RLS em todas as tabelas
Linha do tempo
Como o projeto foi conduzido, do mapeamento ao deploy. How the project was conducted, from mapping to deploy.
Iteração 1
Fundação
- Migração do backend Python (legado) para Next.js App Router
- Supabase (Postgres + Auth + RLS) como banco de produção
- Nexus Auto — roteamento automático de modelos
- Deploy em Cloudflare Workers via OpenNext
Iteração 2
Produto
- 620+ route handlers: core API, gateway /v1 e backend-api
- Workspace com terminal, editor, file tree e agente autônomo
- Multimodal: documentos (20 formatos), áudio, imagem e vídeo
- Memória persistente com RAG e visão/OCR (17 modos)
Iteração 3
Comercial
- 6 planos em BRL (Free a Enterprise) com Stripe + Mercado Pago
- BYOK — usuário conecta a própria chave de IA
- Controle de custos e uso por plano em tempo real
- Landing comercial com SEO e sitemap
Metodologia
Como o projeto foi conduzido, do mapeamento ao deploy. How the project was conducted, from mapping to deploy.
Migração incremental do legado Python para Next.js (API por API)
Testes de roteamento e fallback entre modelos/providers
Auditoria de SEO, acessibilidade e responsividade
Validação de auth JWT + Supabase Auth + RLS
Padrões ExpoStacker de componentização e design tokens
Arquitetura
- → Next.js 16 App Router com 620+ route handlers (Edge + Node.js runtime)
- → Gateway OpenAI-compatible em /v1 para integrações externas
- → Nexus Auto escolhe o melhor modelo disponível por tarefa
- → Supabase (Postgres + Auth + RLS) como banco de produção
- → Workspace React com terminal, editor, file tree e agente autônomo
- → Multimodal: documentos (20 formatos), áudio, imagem, vídeo, visão/OCR
- → Billing em Stripe + Mercado Pago com 6 planos em BRL
- → Deploy em Cloudflare Workers via OpenNext (worker nexus-ai-bark)
- → BYOK e controle de custos por plano em tempo real
Diagrama conceitual — não reflete implementação real
Stack tecnológica
Escolhas técnicas e o que ficou para fora.
ai
Por quê: App Router com 620+ route handlers — front e API no mesmo runtime edge
Alternativa rejeitada: FastAPI separado (migração concluída)
Por quê: Tipagem ponta a ponta — catálogo de modelos, billing e API contracts
Alternativa rejeitada: JavaScript puro (menos segurança em refactors)
Por quê: Postgres + Auth + RLS — banco dedicado por produto
Alternativa rejeitada: SQLite local (MVP, não escala)
Por quê: Deploy edge global via OpenNext com secrets gerenciados
Alternativa rejeitada: VPS dedicado (mais custo e ops)
ai
Por quê: Workspace interativo e chat com streaming SSE
Alternativa rejeitada: HTML vanilla (sem estado rico)
Por quê: Tokens consistentes com ExpoStacker
Alternativa rejeitada: CSS puro (mais lento para prototipar)
Por quê: Estado global do chat/workspace sem boilerplate
Alternativa rejeitada: Redux (mais verboso)
ai
Por quê: Roteamento automático + chave própria do usuário como caminho alternativo
Alternativa rejeitada: Provedor único (ponto único de falha)
Por quê: Assinaturas e checkout para clientes internacionais
Alternativa rejeitada: Pagamento manual (não escala)
Por quê: PIX, boleto e cartão para o mercado brasileiro
Alternativa rejeitada: Stripe sozinho (sem PIX/boleto nativo)
ai
Por quê: Workspace com terminal real e editor de código no navegador
Alternativa rejeitada: Sem workspace (só chat)
Por quê: Contexto persistente por usuário com deduplicação e tags
Alternativa rejeitada: Sem memória (sessão perdida)
Por quê: Respostas em tempo real token a token
Alternativa rejeitada: Request/response completo (UX lenta)
Decision log
O que escolhi, o que rejeitei e por quê.
Migração de FastAPI para Next.js
Por que: Unifica front e back no mesmo runtime edge, elimina a necessidade de hospedar dois serviços e aproveita o deploy em Cloudflare Workers com secrets gerenciados.
Alternativas rejeitadas: Manter FastAPI separado (mais complexidade de deploy), serverless em outro provedor
Supabase em vez de SQLite
Por que: Supabase entrega Postgres + Auth + RLS prontos para produção com dados isolados por linha — SQLite era suficiente para MVP mas não escala nem oferece auth nativa.
Alternativas rejeitadas: Postgres hospedado (mais ops), Firebase (lock-in maior)
Gateway OpenAI-compatible em /v1
Por que: Permite que qualquer ferramenta que fala com a API OpenAI se integre ao Nexus sem customização — ampliando o alcance do produto.
Alternativas rejeitadas: API própria fechada (menos integrações), GraphQL (complexidade desnecessária)
Billing duplo: Stripe + Mercado Pago
Por que: Stripe cobre clientes internacionais; Mercado Pago oferece PIX e boleto — essenciais para o mercado brasileiro.
Alternativas rejeitadas: Só Stripe (sem PIX/boleto nativo), só Mercado Pago (cobertura internacional menor)
Assistente de IA
Pipeline de roteamento inteligente
Usuário envia a mensagem e seleciona o modelo (ou Nexus Auto)
Sistema verifica disponibilidade do modelo e plano do usuário
Roteador seleciona o provider com melhor score de disponibilidade
BYOK permite usar a chave própria do usuário quando configurada
Fallback automático em caso de falha, timeout ou quota excedida
Resposta é transmitida via SSE, custo é calculado e registrado no Supabase
Mecânicas de engajamento
Planos progressivos
6 planos (Free a Enterprise) desbloqueiam mais modelos, multimodal e limites maiores — progressão clara de upgrade.
Workspace ativo
Projetos, arquivos, terminal e agente autônomo mantêm o usuário retornando ao ambiente.
Nexus Auto
O roteamento automático ensina o usuário a confiar na plataforma para escolher o melhor modelo por tarefa.
Multimodal gamificado
Documentos, áudio, imagem e vídeo desbloqueados por nível — progressão visual que incentiva upgrade.
BYOK
Usuário conecta a própria chave de IA e expande limites sem trocar de plano.
Segurança e acesso
Segurança e conformidade
-
Chaves de API externas nunca expostas no front-end — somente backend
-
Autenticação JWT + Supabase Auth com cookies httpOnly
-
Senhas com hash bcrypt, troca via endpoint dedicado
-
RLS (Row-Level Security) em todas as tabelas do Supabase
-
Rate limiting nas rotas por IP e por plano
-
CORS restrito a origens configuradas
-
Verificação de email, recuperação de senha e reset de uso
-
Validação de plano no backend a partir do token JWT
-
BYOK — chaves do usuário armazenadas criptografadas
Lições aprendidas
Nem tudo saiu como planejado.
— O compartilhamento de clientes HTTP async globais entre requisições síncronas gera erros de event loop — clientes por requisição resolvem timeouts e encoding. Migrar de FastAPI para Next.js centralizou front e back no mesmo runtime edge, simplificando deploy. Banco por ilha (Supabase dedicado por produto) protege o resto do ecossistema de falhas locais.
Veja também outros produtos
StackPost StackPost — API Unificada de Redes Sociais
API unificada de redes sociais multi-tenant com 19 integrações, 114 endpoints REST, OAuth centralizado, agendamento, analytics e comentários.
Ver case →
VulnStrike VulnStrike
Scanner de vulnerabilidades SaaS: digite um domínio e receba nota de segurança A+–F com achados explicados e correção passo a passo — scan grátis sem cadastro.
Ver case →
NutriX NutriX
Plataforma de saúde adaptativa em produção: nutrição calculada, treino ao vivo, coach de IA, análise por foto e portal de profissionais.
Ver case →Quer um produto como esse?
Posso fazer o mesmo para o seu negócio. Vamos conversar.