Documento de especificação técnica completa da plataforma eBuz. Cobre requisitos funcionais e não-funcionais, arquitetura, modelo de dados, contratos de API, integracoes, deploy e testes.
152
Requisitos
0
Removidos
69
Tabelas
101
Rotas API
38
Testes
6
ADRs
Livro APE - Arquitetura de Produtos Educacionais
O livro que fundamenta toda a plataforma eBuz. 50 anos de pesquisa científica de 12 pesquisadores condensados em um framework prático de engenharia de transferencia de conhecimento.
Framework Universal
| Pesquisador | Contribuição | No do Framework |
|---|---|---|
| Michael Polanyi | Conhecimento tácito - externalizar o que o expert sabe mas não consegue dizer | INPUT |
| Malcolm Knowles | Andragogia - 6 pressupostos de como adultos aprendem | INPUT |
| Wiggins & McTighe | Backward Design - comecar pelo OUTPUT, não pelo conteúdo | OUTPUT |
| Benjamin Bloom | Taxonomia cognitiva - 6 níveis hierarquicos de aprendizagem | BLACK BOX |
| Robert Gagne | 9 eventos instrucionais - sequência confiavel para produzir aprendizagem | BLACK BOX |
| K. Anders Ericsson | Prática deliberada - foco, feedback, adaptacao, desconforto | BLACK BOX |
| John Sweller | Carga cognitiva - intrinseca, extrinseca, germinal | BLACK BOX |
| William Glasser | Piramide de retenção - modalidades de 10% a 95% | BLACK BOX |
| Eugene Schwartz | 5 níveis de consciencia do comprador | GATEKEEPER |
| Neil Rackham | SPIN Selling - qualificação diagnostica | GATEKEEPER |
| Lincoln Murphy | Customer Success - Desired Outcome | FEEDBACK |
| Fred Reichheld | NPS - métrica que prediz crescimento sustentável | FEEDBACK |
12
Pesquisadores
50+
Anos de pesquisa
5
Nos do framework
14
Capitulos
Cursos Publicados
3 cursos publicados na plataforma com player estilo Spotify, progresso por aula, estrelas e comentários. 42h43 de carga horária total (17h33 de áudio, 13h22 de leitura, 11h45 de exercícios). Áudio gerado via Google TTS Chirp3-HD (voz masculina premium).
| Curso | Módulos | Aulas | Áudio | Leitura | Exercícios | Total | Status |
|---|---|---|---|---|---|---|---|
| Arquitetura de Produtos Educacionais | 12 | 67 | 11h52 | 7h30 | 5h35 | 25h | Publicado |
| Vibecoding PRO | 9 | 44 | 3h19 | 4h20 | 3h40 | 11h19 | Publicado |
| Pre-Vibecoding | 6 | 30 | 2h22 | 1h32 | 2h30 | 6h24 | Publicado |
Áudio medido via ffprobe (duração real dos MP3). Leitura estimada a 200 palavras/min sobre o conteúdo das aulas. Exercícios estimados em 5 min/aula.
3
Cursos
27
Módulos
141
Aulas
42h43
Carga Horária Total
Chirp3-HD
Engine de Áudio
Entrevista Estruturada com Jhow
Chat interativo com personalidade Jhow (IA) que extrai o conhecimento tácito do expert em 3 fases progressivas. Suporte a audio (transcricao via Groq Whisper) e upload de arquivos de referência.
1. Exploração
Perguntas abertas para mapear dominio e experiência do expert
2. Aprofundamento
Investiga pontos-chave, exemplos concretos e diferenciais
3. Sintese
Consolida em Resumo do Produto Educacional estruturado
Resumo do Produto Educacional
- O que ensina: conhecimento e habilidades transferidos
- Quais habilidades aplica: capacidades práticas desenvolvidas
- Para quem resolve dor aguda: público-alvo com problema real
Stack Técnica
Mapa de Contexto
Produto com 4 etapas sequenciais que transformam o conhecimento do expert em um documento estratégico completo. Aproximadamente 35 minutos com IA. Cada etapa gera um documento parcial, e o Passaporte consolida tudo.
Entrevista Estruturada
Chat com Jhow (IA) para extrair conhecimento tácito do expert
Segmentos de Mercado
Fluxo IA para identificar e validar segmentos-alvo
Persona Dissecada
Fluxo IA para construir persona detalhada com dores e desejos
Passaporte de Contexto
Documento final que consolida tudo em estrategia acionavel
4
Etapas
~35min
Tempo com IA
4
Documentos Parciais
1
Passaporte Final
Planos
Starter
R$ 19,90/mes
100.000 moedas
Professional
R$ 49,90/mes
500.000 moedas
Expert
R$ 99,90/mes
1.500.000 moedas
Esteira de Produtos - Precificacao
| Produto | Tipo | Preço | Modelo | Público |
|---|---|---|---|---|
| eBook APE | Digital (PDF) | Gratuito | Isca de captura | Leads frios |
| Passaporte de Contexto (7 dias) | SaaS (acesso temporario) | R$ 19,90 | Acesso único | Leads qualificados |
| Pre-Vibecoding | Curso online (30 aulas) | R$ 47,00 | Acesso vitalício | Iniciantes |
| Vibecoding PRO | Curso online (44 aulas) | R$ 197,00 | Acesso vitalício | Intermediarios |
| Evento Presencial | Workshop 1 dia | R$ 247,00 | Ingresso único | Experts |
| Livro APE | Livro fisico | R$ 97,90 | Compra unica | Experts e educadores |
| Arquitetura de Produtos Educacionais | Curso premium (67 aulas, 12 módulos) | R$ 2.000,00 | Acesso vitalício | Experts avancados |
Funil de Conversão
Métricas de Receita
R$ 150-500
Ticket medio por aluno
R$ 2.608,80
LTV potencial (esteira completa)
7 produtos
Esteira completa
Funil Evergreen - Sistema de Vendas Automatizado
Funil de 4 etapas que transforma tráfego frio em alunos do curso APE. Operação evergreen com webinário gravado de 45 minutos.
Páginas do Funil
| Página | Rota | Função | Status |
|---|---|---|---|
| Captura | /captura | Landing page com formulário (nome + email). Entrada do funil via Meta Ads. | Publicada |
| Webinário | /webinario | Player do vídeo de 45 min + countdown + CTA para oferta | Publicada |
| Oferta | /oferta | Página de vendas do Curso APE. R$ 2.000 (12x R$ 197). 67 aulas, 12 módulos, garantia 7 dias. | Publicada |
| Obrigado | /obrigado | Confirmação pós-compra/registro. Próximos passos + acesso à área de membros. | Publicada |
Webinário APE - Roteiro Completo
Duração: 45-50 minutos
Frameworks: Duarte Resonate + StoryBrand + Phil M. Jones (P1-P5) + Nested Loops
Loops narrativos: 3 loops integrados
Slides: 30 slides Canva (1920x1080, dark theme)
Demo ao vivo: Framework dos 5 nós
Oferta: Stack completo do curso
Fluxo do Funil
Requisitos do Funil
Checkout Transparente
Sistema de pagamento inline - o usuário nunca sai do eBuz. Integração direta com a API transparente do Assas para tokenização de cartão, geração de QR Code PIX e emissão de boletos, tudo dentro da própria plataforma.
Métodos de Pagamento
| Método | Fluxo | Confirmação |
|---|---|---|
| Cartão de Crédito | Dados inline → tokeniza → cobra | Imediata |
| PIX | QR Code + copia-e-cola → polling 5s | Tempo real (~30s) |
| Boleto | Código de barras + PDF | Até 3 dias úteis |
Pontos de Integração
| Página | Produto | Valor | Parcelas |
|---|---|---|---|
/oferta | Curso APE | R$ 2.000 | 12x |
/planos | Acesso 7 dias | R$ 19,90 | 1x |
/livro | Livro APE | R$ 97,90 | 3x |
/créditos | Pacotes | Variável | 1x |
Arquitetura
Segurança
Requisitos do Checkout
Visão do Produto
Proposta de Valor
Metodologia científica operacionalizada
12 pesquisadores transformados em fluxos step-by-step que qualquer expert consegue seguir.
IA como co-autora
Sugestões inteligentes que o expert aceita, edita ou refina. O humano sempre decide.
Multi-LLM resiliente
4 provedores com fallback automático. O aluno nunca ve erro técnico.
Documentos prontos
Cada fluxo gera um documento versionado e compartilhavel, pronto para uso.
Modelo de Negócio
| Item | Detalhes | Provedor |
|---|---|---|
| SaaS com assinatura mensal | Planos com créditos inclusos | Assas |
| Trial 24h via SMS | 3 créditos, verificação anti-fraude por telefone | Twilio |
| Cupons promocionais | Códigos resgatáveis para créditos bonus | Interno |
| Cursos como produto | Player Spotify-like com audio Google TTS | Google TTS |
Planos
Starter
R$ 19,90/mes
100.000 moedas
Professional
R$ 49,90/mes
500.000 moedas
Expert
R$ 99,90/mes
1.500.000 moedas
Requisitos Funcionais
Requisitos Não-Funcionais
Performance
6 itensSegurança
10 itensEscalabilidade
4 itensDisponibilidade
3 itensSEO
6 itensArquitetura
Stack Técnica
| Camada | Tecnologia | Versão |
|---|---|---|
| Frontend | Next.js | 15.5 |
| React | 19 | |
| TypeScript | 5.9 | |
| Tailwind CSS | 4 | |
| Backend / API | Next.js API Routes | 15.5 |
| Supabase (PostgreSQL) | managed | |
| IA | Claude Sonnet 4 | primary |
| Groq Llama 3.1 8B | fallback | |
| Gemini 2.0 Flash | fallback | |
| Ollama Llama 3.2 3B | local | |
| Infraestrutura | Vercel | auto |
| Hetzner VPS | CX22 | |
| Redis Upstash | serverless | |
| pnpm | 9.x | |
| Integrações | Assas | v3 |
| Twilio | SMS | |
| Google TTS | Chirp3-HD | |
| Tiptap | v2 |
Diagrama de Arquitetura
USUARIO -> VERCEL (Next.js 15.5) -> SUPABASE (PostgreSQL, Auth, Storage, RLS, Vault)
-> AI ROUTER (Claude -> Groq -> Gemini -> Ollama -> Cache)
-> SERVICOS (Assas, Twilio, Redis)
-> HETZNER VPS (Ollama, Backups, Monitor)Engine (src/engine/)
FLOW ENGINE
engine.ts (orquestrador)
|-- ai-router.ts (Multi-LLM fallback)
|-- credit-manager.ts
|-- quality-validator.ts
|-- document-generator.ts
|-- json-importer.ts
|-- interview-engine.ts + jhow-prompt.ts
|-- trial-manager.ts
|-- sms-provider.ts
+-- coupon-manager.tsFluxos de Usuário
Jornada do Aluno
Entrevista Estruturada
Jornada do Admin
Pagamento
Trial SMS
Modelo de Dados
Entidades Principais
Políticas RLS
| Tabela | SELECT | INSERT | UPDATE |
|---|---|---|---|
| profiles | Proprio | Service | Proprio |
| flows | Público | Admin | Admin |
| flow_steps | Público | Admin | Admin |
| flow_executions | Proprio | Proprio | Proprio |
| user_documents | Proprio | Service | Proprio |
| user_credits | Proprio | Service | Service |
| credit_transactions | Proprio | Service | Service |
| interview_sessions | Proprio | Service | Service |
| courses | Público | Admin | Admin |
| course_lessons | Público | Admin | Admin |
| blog_posts | Público | Admin | Admin |
| qr_codes | Admin | Admin | Admin |
API Contract
Fluxos
Entrevista
Documentos
Créditos
Blog
QR Codes
Auth / Trial
Planos / Pagamentos
IA
Termos
Integracoes
AI Router (Multi-LLM)
- -Claude Sonnet 4 - sugestões, entrevista (15s, $0.003/$0.015 per 1k tokens)
- -Groq Llama 3.1 8B - validação, fallback ($0.0001 per 1k tokens)
- -Gemini 2.0 Flash - fallback secundário
- -Ollama Llama 3.2 3B - local no VPS ($0)
- -Whisper Large v3 - transcricao de audio
- -Cache em memoria (1h TTL)
- -Log completo em ai_sessions
Assas (Pagamentos)
- -API REST em produção
- -PIX, boleto e cartao de crédito
- -Webhook com HMAC SHA-256
- -Checkout -> pagamento -> subscription + créditos
Twilio (SMS)
- -Código de 6 digitos
- -Normalizacao E.164 para Brasil (+55)
- -Rate limiting: 3 códigos/hora
- -Max 5 tentativas por código
- -Expiração em 10 minutos
Redis Upstash
- -Cache de sessões
- -Rate limiting distribuido
- -Dados temporarios com TTL
Supabase
- -PostgreSQL com RLS em todas as tabelas
- -Auth: Google OAuth + email/senha
- -Storage: blog-images (público, 5MB), interview-files (privado, 50MB), qr-images (público, 2MB)
- -Vault: AES-256-GCM para secrets
Google TTS
- -Chirp3-HD - voz masculina premium
- -Audio para cursos Vibecoding PRO e Pre-Vibecoding
- -Armazenado no Supabase Storage
Plano de Deploy
Ambientes
Vercel (Produção)
- Push para main = deploy automático
- Package manager: pnpm
- Framework: Next.js 15.5 (auto-detected)
- Dominio: app.ebuz.com.br
- Edge Network global
Hetzner VPS
- IP: 77.42.31.230
- SSH porta 2847
- Ollama (LLM local)
- Backups automáticos
- Monitor + alertas
Variaveis de Ambiente
# Supabase NEXT_PUBLIC_SUPABASE_URL NEXT_PUBLIC_SUPABASE_ANON_KEY SUPABASE_SERVICE_ROLE_KEY SUPABASE_DB_PASSWORD SUPABASE_PROJECT_REF SUPABASE_ACCESS_TOKEN # IA ANTHROPIC_API_KEY GROQ_API_KEY GEMINI_API_KEY OLLAMA_API_URL # Pagamentos ASSAS_API_KEY ASSAS_API_URL # SMS TWILIO_ACCOUNT_SID TWILIO_AUTH_TOKEN TWILIO_PHONE_NUMBER # Cache REDIS_URL REDIS_TOKEN # Segurança VAULT_KEY HMAC_SECRET # App NEXT_PUBLIC_APP_URL VERCEL_TOKEN HETZNER_HOST HETZNER_USER
Protocolo de Deploy
- 1Rodar pnpm build localmente (verificar compilacao)
- 2Commitar com mensagem descritiva (prefixo convencional)
- 3Push para main no GitHub (ebuz-ia/ebuz-docs)
- 4Vercel detecta push e inicia build automático
- 5Preview deploy disponível para verificação
- 6Promote para produção (automático para main)
- 7Verificar /api/health no dominio de produção
Migrations
Monitoramento
Plano de Testes
Testes Unitarios
14 itensTestes de Integração
8 itensTestes E2E
8 itensCenarios Criticos
- Debito duplo de créditos (race condition na execução simultanea)
- Race condition em resgate de cupons (two-phase commit)
- Trial anti-fraude (mesmo telefone em contas diferentes)
- Fallback de IA (Claude fora do ar, Groq assume sem erro visível)
- RLS bypass (tentativa de acessar dados de outro usuário)
- Admin access (rota admin acessada por usuário normal)
- Versionamento de documento (criar nova versão sem perder anterior)
- Expiração de trial (créditos bloqueados apos 24h)
ADRs (Architecture Decision Records)
Máquina de Livros
Fábrica modular de produção editorial. Cada projeto usa apenas os módulos que precisa.
Editor
Escrita capítulo a capítulo em Markdown
ImplementadoImportação
Colar texto ou upload de .md/.txt
ImplementadoRevisão IA
Gramática, editorial, acentuação, anti-IA
ImplementadoBuild PDF
Typst/LaTeX via VPS (gráfica + digital)
ImplementadoExportação
PDF, EPUB, Markdown
ImplementadoModelo de dados
| Tabela | Descrição | RLS |
|---|---|---|
| book_projects | Projetos de livro (título, autor, tipo, formato, estágio) | Sim |
| book_chapters | Capítulos (content_md, word_count, sort_order) | Sim |
| book_reviews | Revisões IA (findings JSONB, tipo, severidade) | Sim |
| book_builds | Compilações PDF/EPUB (status, output_url, pages) | Sim |
| book_checklists | QA items por capítulo (tipo, checked) | Sim |
Planos comerciais
| Plano | Preço | Inclui |
|---|---|---|
| Livro Completo | R$ 2.000 | Escrita + Revisão + Diagramação + Publicação |
| Revisão + Diagramação | R$ 1.500 | Importação + Revisão + Diagramação + EPUB |
| Diagramação | R$ 1.000 | Importação + Diagramação + EPUB |
| Publicação | R$ 790 | EPUB + Audiolivro + Podcast |
Arquivos do sistema
lib/book-engine/ types.ts # Tipos TypeScript (BookProject, BookChapter, etc.) accent-corrector.ts # 200+ mapeamentos PT-BR anti-ia-scanner.ts # 150+ padrões de vocabulário IA checklist-templates.ts # QA items por tipo de capítulo src/routes/ admin-livros-route.ts # GET/POST projetos admin-livros-id-route.ts # GET/PUT/DELETE projeto admin-livros-capitulos-route.ts # GET/POST capítulos admin-livros-capitulo-slug-route.ts # GET/PUT/DELETE capítulo admin-livros-build-route.ts # POST build + GET histórico admin-livros-revisar-route.ts # GET/POST/PUT revisões admin-livros-importar-route.ts # POST importação admin-livros-exportar-route.ts # GET/POST exportação src/pages/ admin-livros-dashboard-page.tsx # Dashboard com métricas admin-livros-novo-page.tsx # Formulário novo projeto admin-livros-projeto-page.tsx # Detalhe com módulos admin-livros-capitulo-page.tsx # Editor Markdown admin-livros-revisao-page.tsx # Revisão com tabs admin-livros-importar-page.tsx # Importação (colar/upload) admin-livros-exportar-page.tsx # Exportação (PDF/EPUB/MD) app/maquina-livros/page.tsx # Página de vendas pública infra/supabase/migrations/ 034_maquina_livros.sql # 5 tabelas + RLS + storage
Gerador de Passaportes (Passo 1)
Sistema de geração automatizada de Passaporte de Contexto e Segmentos de Mercado a partir de texto livre, arquivo ou PDF. O expert cola ou faz upload do seu conteúdo e a IA gera dois documentos completos com personas únicas por segmento.
Fluxo de uso
Upload de conteúdo
Expert cola texto, faz upload de .txt/.md ou envia .pdf para extração automática
Geração do Passaporte
IA analisa o conteúdo e gera Passaporte de Contexto com 11 seções estruturadas
Geração de Segmentos
IA identifica 6 segmentos de mercado com personas únicas, dores e desejos
Visualização e biblioteca
Documentos salvos na biblioteca com temas visuais configuráveis e slug inteligente
Requisitos funcionais
Arquitetura
passaporte_projects
Tabela com RLS por usuário
ImplementadoFlows virtuais
Agrupamento na biblioteca
ImplementadoAI Router
Fallback Claude - Groq - Gemini
ImplementadoFew-shot refs
Referências para aprendizado de formato
ImplementadoTemas visuais
Rotas
| Rota | Descrição |
|---|---|
| /passo1 | Upload + formulário de entrada |
| /passo1/[slug]/passaporte | Visualização do Passaporte de Contexto |
| /passo1/[slug]/segmentos | Visualização dos 6 Segmentos |
| /api/passo1/generate | Processamento IA (gerar passaporte + segmentos) |
| /api/passo1/extract-pdf | Extração de texto de PDF |
Arquivos do sistema
app/ passo1/page.tsx # Upload + formulário passo1/[slug]/passaporte/page.tsx # Documento Passaporte passo1/[slug]/segmentos/page.tsx # Documento Segmentos app/api/ passo1/generate/route.ts # Processamento IA passo1/extract-pdf/route.ts # Extração de PDF components/passaporte/ passaporte-viewer.tsx # Visualizador do Passaporte segmentos-viewer.tsx # Visualizador dos Segmentos theme-selector.tsx # Seletor de temas visuais lib/ passaporte-references.ts # Few-shot refs para formato slug-generator.ts # Gerador de slug inteligente
Auth / Onboarding
Melhorias no fluxo de autenticação e onboarding para reduzir fricção no cadastro e permitir gestão completa de usuários pelo admin.
Requisitos funcionais
Detalhes de implementação
Resend confirmation
Botão na tela de login para reenviar email quando o usuário não confirma na primeira vez
ImplementadoCriação manual
Admin cria usuário com email, nome, role e opção de trial automático
ImplementadoPassword reset
Admin pode resetar senha de qualquer usuário via Supabase Admin API
Implementado