Nexo

Site institucional da Nexo, agência de inteligência artificial aplicada a processos de negócio.

Desenvolvimento

Requer Node.js 22.12+ ou 24 e npm.

cd src/frontend
npm ci
npm run dev

npm run build
npm run preview

O build verifica TypeScript e gera os arquivos estáticos em src/frontend/dist/.

Na Vercel, configure Root Directory como src/frontend, build como npm run build e saída como dist. No Railway, configure a raiz do serviço como /src/frontend e utilize npm run start com a variável PORT fornecida pela plataforma.

Interface

• React, TypeScript e Vite.

• Tailwind CSS v4 e shadcn/ui (Radix, estilo Nova).

• Componentes locais em src/frontend/components/ui, configurados em src/frontend/components.json.

• Marca com símbolo próprio gerado em src/frontend/public/images/nexo-symbol-purple.png, paleta branca/lavanda/violeta e sombras roxas.

• Entradas de conteúdo por IntersectionObserver, com reaparição ao sair e retornar à tela em ambas as direções.

• Fundo animado contínuo com manchas de luz roxa mais intensas e chuva diagonal de partículas em CSS, pausado com a aba oculta ou quando o visitante escolhe reduzir as animações.

• Contraste reforçado, contornos semânticos e sombras violetas para separar os elementos brancos.

• Tema, cores semânticas e responsividade em src/frontend/styles/globals.css.

• Conteúdo, exemplos de aplicação e link de contato em src/frontend/lib/content.ts.

• Carrossel do processo com Embla, arraste por mouse/toque e navegação por botões e teclado.

• Serviços em carrossel no celular e grade de duas colunas no desktop.

• Cards compactos no mobile, textos resumidos nos serviços e no streaming e apresentação compacta dos benefícios.

• Navegação interna por rolagem, mantendo a URL sem fragmentos #, inclusive no menu mobile.

• Menu mobile com foco controlado, perguntas frequentes e benefícios com indicadores de validação.

• Fontes Geist servidas localmente.

• Núcleo 3D em CSS com seis faces, órbitas em planos distintos e profundidade por perspectiva, sem WebGL ou novas dependências.

• Demonstrações ampliadas em streaming de contabilidade, marketing e atendimento, navegáveis por setas, teclado e arraste, identificadas como simulações com dados fictícios.

• Sem controles visíveis de pausa ou reinício; temporizadores pausam fora da tela ou quando a aba está oculta. As animações tocam mesmo quando o sistema operacional pede movimento reduzido (muitos PCs fracos ativam isso pelo perfil de energia e o site ficava estático). Quem quiser menos movimento usa o botão "Reduzir animações" no rodapé; a escolha fica salva no navegador (html[data-reduce-motion="true"]) e mostra o conteúdo completo sem animação.

• Serviços com entregas e exemplos, processo com atividades de cada etapa, valor para o negócio com mecanismos, impactos potenciais e indicadores.

• Desempenho em computadores fracos: o símbolo da marca tem 256 px (cerca de 40 KB, em vez de 720 KB); a chuva do fundo usa três camadas animadas em vez de oitenta e quatro; a digitação das demonstrações atualiza só os textos que mudam, no mesmo ritmo, em vez de renderizar o card inteiro a cada passo. Um teste de fluidez roda depois do carregamento e, só em aparelho lento (ou com 2 núcleos/2 GB), liga html[data-perf="lite"]: nenhuma animação nem elemento sai, apenas o desfoque ao vivo do cabeçalho vira um fundo quase opaco.

As ilustrações e fluxos de aplicação são exemplos; não representam métricas ou resultados de clientes. Os links de contato abrem o WhatsApp existente da Nexo.

Componentes

cd src/frontend
npx shadcn@latest info
npx shadcn@latest docs button
npx shadcn@latest add <componente>

O desenho anterior permanece preservado na branch nexo-ai-v1.

Backend administrativo

Backend Python/FastAPI com autenticação por senha e Google, aprovação de contas, clientes, perfil/foto, recuperação de senha, SQLite e Redis. Testes na raiz e CI automático. Painel administrativo em /admin, mantendo a identidade visual do site. Configure VITE_API_URL no frontend para a URL pública do backend; publique o backend com FRONTEND_URL/CORS_ORIGINS correspondentes ao site. Consulte instruções do painel. Consulte instruções do backend.

Documentos e identificação de criadores

Membros aprovados podem enviar e baixar documentos em /documents. A API grava os arquivos em UPLOAD_DIR/documents com nomes internos aleatórios; o SQLite guarda os metadados. Configure DOCUMENT_MAX_BYTES (padrão: 10485760, 10 MiB). São aceitos PDF, DOC/DOCX, XLS/XLSX, PPT/PPTX, TXT, CSV, ODT/ODS e RTF. Downloads exigem autenticação e são enviados como anexos. Exclusão de documentos de outras pessoas exige Owner; o criador pode excluir os próprios documentos. O volume /data no Railway deve preservar tanto o banco quanto uploads. A tabela é criada pelo comando de criação de tabelas já usado na inicialização.

Clientes mostram created_by_name; a listagem aceita filtros combinados name (trecho sem distinguir maiúsculas/minúsculas), niche (exato) e created_by_id, além de contrato e paginação. O diretório /members inclui apenas ID, nome, cargo e has_photo; imagens são obtidas autenticadas em /members/{id}/photo. Contas pendentes não acessam o diretório, clientes ou documentos. Owners podem consultar fotos de contas pendentes ao gerenciá-las. Ao excluir uma conta, seus clientes e documentos são transferidos ao Owner principal.

Vídeos (HyperFrames)

No painel, a área Comercial tem a página Vídeos: o membro descreve o vídeo (a IA escreve o HTML) ou cola um HTML, acompanha o andamento, assiste, baixa o MP4 e pode reaproveitar o HTML ou a descrição de um vídeo anterior.

POST /videos, POST /videos/generate, GET /videos, GET /videos/{id} e GET /videos/{id}/file geram vídeos MP4 com o HyperFrames (HTML renderizado em vídeo). Usam a mesma autenticação das demais rotas (sessão ou chave de API nexo_live_...) e só aceitam owner, admin e commercial; chaves de commercial alcançam /videos. Os pedidos respondem 202 na hora com um id; consulte GET /videos/{id} até status ser done (ou failed, com error) e baixe o arquivo em video_url.

• POST /videos recebe {"html": "...", "fps": 30, "quality": "standard"} com uma composição HyperFrames pronta.
• POST /videos/generate recebe {"prompt": "...", "aspect": "landscape|vertical|square", "seconds": 15}; a IA (Groq) escreve o HTML, ele é validado (/lint) e corrigido pela própria IA em até 3 tentativas, e então renderizado.
• Narração (áudio): POST /videos/generate aceita "narration": true (padrão). A IA escreve o texto falado de cada cena em data-narration e uma voz em português (Kokoro, no próprio container, sem chave nem conta) é gerada e mixada no MP4. A fala precisa caber na cena (cerca de 2,3 palavras por segundo); se não couber, a IA é avisada e corrige. POST /videos também narra um HTML que traga data-narration nas cenas. Sem o modelo de voz (TTS_MODEL_DIR) o vídeo sai sem som (audio: false no vídeo). A imagem Docker já traz o modelo (92 MB).
• GET /videos lista os últimos vídeos de quem chama (sem o HTML).
• Cada membro pode ter 2 vídeos em andamento (429 acima disso). Um vídeo só é visível para quem o criou.

O render roda dentro do próprio backend: ele sobe video-server/ (Node + Chrome + FFmpeg, já na imagem Docker) como processo filho em 127.0.0.1, no primeiro pedido de vídeo, com um segredo aleatório e prioridade menor que a da API, e o reinicia se cair. Não há outro serviço para publicar nem VIDEO_URL/VIDEO_SECRET para configurar (eles existem só para usar um servidor de render externo). Sem Node/video-server/ instalados as rotas respondem 503. Só /videos/generate precisa de GROQ_API_KEY (opcional: GROQ_MODEL); sem ela essa rota responde 503 e /videos continua funcionando. Os MP4 ficam em UPLOAD_DIR/videos. O render consome CPU e memória do container da API: por padrão roda um por vez (VIDEO_MAX_CONCURRENT_RENDERS).

Node Nexo para n8n

O node privado da Nexo para n8n permite consultar e administrar recursos da API usando uma chave de API por credencial. Ele inclui operações para clientes, automações, documentos, avisos, chat, dashboard e avisos administrativos.

Os arquivos do node e as instruções de instalação e implantação estão em n8n/. Para criar a imagem personalizada baseada na imagem oficial n8nio/n8n:latest, use o Dockerfile.n8n na raiz do repositório como Dockerfile do serviço n8n no Railway. Preserve o volume de dados existente do n8n (por exemplo, /root/.n8n), a chave de criptografia e faça backup antes de trocar a imagem.