Formacao de revendedoras
Trilhas estruturadas que formam revendedoras tecnica e comercialmente competentes em ate 30 dias, padrao editorial HBR e exigencia minima de 80% para certificar.
Roadmap executivo · Maio 2026
Semijoias-Educa / Herreira Academy
Roadmap executivo do portal educacional bilingue para formar, certificar e acompanhar revendedoras de joias e semijoias no Brasil e no mundo. Documento de alinhamento da diretoria sobre como o portal multi-cliente Semijoias-Educa atende a missao Herreira de treinamento padronizado da rede de revendedoras.
2 idiomas
PT-BR e EN-US desde o MVP
9 trilhas + 5
79 modulos publicos · 25 modulos Herreira Partner
90 dias
Da especificacao ao MVP fechado com Herreira
A revendedora que entende produto vende valor. A que so recebe catalogo vende desconto.
Visao do produto
Seis pilares estrategicos que justificam a existencia do portal e organizam toda decisao de produto, conteudo e tecnologia ate 2027.
Governanca de marca
Padrao de discurso, fatos canonicos e tom de voz controlados em um unico ambiente. Patricia revisa o que vai para revendedora antes da publicacao.
Conteudo publico citavel (GEO)
Paginas de trilha, glossario, FAQ e guias indexaveis com Schema.org e llms.txt. Capturam citacao em ChatGPT, Perplexity, Gemini e Claude.
Certificacao comercial
Certificado verificavel via QR code e pagina publica de validacao. Hash de integridade, ID nao-sequencial e revogacao com motivo publico.
Dados de aprendizagem
Painel executivo com taxa de conclusao por trilha, gap por competencia, NPS por persona e LTV por plano. Decisao baseada em evidencia, nao em opiniao.
Escala global bilingue
PT-BR canonico e EN-US desde o MVP, com hreflang correto e traducao revisada por humano. Abre mercado de revendedoras Herreira em Miami, Lisboa e Orlando.
Personas que o portal atende
Nove personas validadas via PRD e entrevistas com a rede Herreira. Cada uma tem objetivo, dor e metrica de sucesso explicitos para orientar produto e conteudo.
Marina, 32 — revendedora iniciante
Objetivo: entender tecnica de banho e prata 925 para vender com autoridade.
Dor: nao sabe responder "e banhado mesmo?" com confianca.
Sucesso: conclui Trilha 1 em 14 dias, ticket medio sobe 25%.
Camila, 38 — revendedora experiente
Objetivo: profissionalizar a operacao e formar equipe.
Dor: opera Shopify no improviso, sem politica de preco.
Sucesso: implementa Trilha 7, sobe margem em 4 pontos.
Bia, 27 — candidata a revendedora
Objetivo: avaliar se faz sentido entrar no setor antes de investir.
Dor: nao sabe diferencar oportunidade de ilusao.
Sucesso: conclui 3 modulos free, decide com clareza.
Renata, 45 — instrutora convidada
Objetivo: autoridade publica em joalheria via marca propria.
Dor: conteudo na rede dela e raso, sem credencial.
Sucesso: assina trilha avancada, gera leads para consultoria.
Daniela, 34 — administradora do portal
Objetivo: publicar modulos, moderar usuarios, emitir cupons.
Dor: hoje opera planilha, sem auditoria.
Sucesso: usa painel admin v1, gasta 4h/semana em operacao.
Carlos, 41 — time comercial Herreira
Objetivo: rede de revendedoras treinadas vendendo o argumentario certo.
Dor: revendedora quebra fato canonico, prejudica marca.
Sucesso: 80% da rede ativa concluiu Herreira Partner em 90 dias.
Lucas, 29 — atendimento e SLA
Objetivo: responder duvidas com SLA por plano.
Dor: hoje email avulso, sem priorizacao.
Sucesso: SLA 48h Aprendiz / 24h Profissional / 8h Master / 2h Empresarial cumprido em 95% dos chamados.
Bruno, 36 — owner Brasil GEO
Objetivo: Semijoias-Educa citado em LLMs em consultas relevantes.
Dor: conteudo bom nao e citavel sem schema correto.
Sucesso: mention rate sobe de 0 para 40 em 12 meses.
Patricia Caramaschi — lideranca Herreira
Objetivo: rede coesa, marca preservada, narrativa A Joia que Sou em todo ponto de contato.
Dor: revendedora improvisa argumento ou desconto.
Sucesso: 200 revendedoras certificadas Herreira Partner em 12 meses.
Jornada da revendedora — 10 etapas
Da descoberta ao plano de recertificacao anual. Cada etapa tem evento mensuravel para alimentar painel executivo e otimizacao de funil.
Etapa 1
Descoberta
Etapa 2
Cadastro
Etapa 3
Onboarding
Etapa 4
Trilha Fundamentos Herreira
Etapa 5
Primeira avaliacao
Etapa 6
Certificacao
Etapa 7
Materiais oficiais
Etapa 8
Venda assistida
Etapa 9
Evolucao de nivel
Etapa 10
Recertificacao
Eventos instrumentados
discovery_landing·signup_complete·onboarding_donemodule_started·module_completed·quiz_passedcertificate_issued·material_downloadedtier_upgraded·renewal_window_opened
Pontos de friccao a monitorar
- Cadastro: queda em verificacao de email (M1).
- Trilha 1 modulo 4: primeiro conteudo pago, principal ponto de churn.
- Quiz de certificacao: nota minima 80%, dispara reforco automatico se reprovar.
- Recertificacao anual: lembrete em D-30 e D-7 via email + WhatsApp.
Now / Next / Later
Visao executiva do que entra em cada janela ate fim de 2027. Now sustenta MRR Herreira piloto; Next abre escala B2B; Later destrava posicao internacional.
Now
0 – 90 dias
2026-05-02 → 2026-08-15
- MVP educacional fechado com Herreira (30 alunas)
- Area da aluna com progresso por trilha
- Painel admin basico — gestao de alunas e modulos
- Cursos com quiz e correcao automatica
- Certificado de conclusao verificavel
- Pagina publica indexada com Schema.org Course
- Trilha 1 completa (8 modulos) + 4 modulos da Trilha 2
- Stripe + Pagar.me com webhooks e trial 30 dias
- Lancamento publico com 200 alunas pagas no fim de Q3
Next
3 – 6 meses
2026-08-16 → 2027-01-31
- Gamificacao responsavel — XP, badges, missoes, streak
- GEO avancado — Wikidata, llms.txt completo, schemas profundos
- Glossario publico canonico de joalheria
- Tutor de IA com RAG sobre conteudo aprovado
- Dashboard executivo Herreira com gap de competencia
- Notificacoes transacionais via Resend + WhatsApp
- Trilhas 5, 6 (parcial) e 7 completas
- Plano Empresarial em 5 marcas regionais
- Trilha B2B Herreira Partner com 25 modulos
Later
6 – 12 meses
2027-02-01 → 2027-12-31
- Multi-pais — Portugal, EUA Hispano, UE
- Comunidades regionais por cidade-ancora
- CRM integrado com pipeline de revendedora
- Certificacao avancada com prova supervisionada
- Analytics comercial fechando o loop venda → trilha
- Trilha 9 completa + autores convidados gemologos
- Programa de afiliados com LTV-share
- App PWA com modo offline para Trilha 1-4
- Escala global bilingue consolidada (5 mil alunas)
Q1 a Q4 — entrega trimestral
Recorte por trimestre dos marcos M0 a M4 do ROADMAP fonte. Cada trimestre fecha com criterio mensuravel de saida.
Marco M0 + M1
Especificacao concluida, repo monorepo, design system, MVP fechado com Herreira (beta 30 alunas).
- Setup Turborepo com apps/web, apps/admin, apps/api
- Auth Supabase + RLS + 4 ambientes
- Paywall Stripe + Pagar.me operando
- Trilha 1 completa publicada (8 modulos)
- Voice Guard rodando em CI
Criterio de saida
30 alunas Herreira ativas, NPS > 40, billing 100% funcional, 0 bug critico aberto.
MRR alvo R$ 2.000
Marco M2
Lancamento publico, 40 modulos das trilhas 1-4, Pix recorrente, fórum por trilha.
- Schema.org Course + LearningResource em todos modulos
- llms.txt versao inicial
- Dashboard de aprendizagem da aluna
- SEO/GEO operacional com IndexNow
- Plano Profissional ativo com mentoria mensal
Criterio de saida
200 alunas pagas, churn mensal < 8%, NPS > 50.
MRR alvo R$ 12.000
Marco M3
Escala B2B, trilha Herreira Partner em producao, primeiros tres modulos da Trilha 6 (GEO joalheria).
- Tutor IA com RAG sobre conteudo aprovado
- Recomendador simples por gap de competencia
- Tradutor PT-BR ↔ EN-US assistido
- Agentes editoriais auxiliando revisao
- Plano Empresarial em 5 marcas regionais
Criterio de saida
550 alunas pagas, 5 contratos B2B ativos, NRR > 100%.
MRR alvo R$ 35.000
Marco M4
Multi-pais (Portugal e EUA hispano), comunidades regionais, CRM, certificacao avancada, painel da rede, governanca global.
- Trilha 6 (GEO joalheria) completa
- Trilha 8 e 9 publicadas
- Plano Master ativo com 1:1 trimestral
- App PWA com modo offline
- Paginas /joias/[cidade] alavancando moat regional
Criterio de saida
1.100 alunas pagas, catalogo v1.0 fechado (79 modulos), churn < 5%.
MRR alvo R$ 80.000
Modulos funcionais do produto
Mapa completo das 17 capacidades do portal, com usuario primario, descricao executiva, prioridade e metrica de sucesso.
| Modulo | Usuario | Descricao | Prioridade | Metrica |
|---|---|---|---|---|
| Home publica | Visitante | Pagina-narrativa SSR com tese, metricas vivas e CTA para cadastro. | Critica | CTR cadastro > 6% |
| Catalogo | Visitante | Lista publica de trilhas e modulos com filtro por persona e plano. | Alta | Modulos vistos por sessao |
| Curso | Aluna | Pagina do curso com objetivos, modulos, instrutor e CTA de matricula. | Critica | Conversao para start trial |
| Trilha | Aluna | Sequencia ordenada de modulos com pre-requisito explicito. | Critica | Taxa de conclusao > 55% |
| Glossario | Visitante e aluna | Verbete canonico bilingue com schema DefinedTerm para alimentar LLMs. | Alta | Mentions em LLMs |
| FAQ | Visitante | Perguntas e respostas com FAQPage schema, organizadas por jornada. | Media | Cliques zero ao suporte |
| Area da aluna | Aluna | Painel pessoal com continue de onde parou, badges e proximos passos. | Critica | Sessoes por semana > 3 |
| Player | Aluna | Renderizador MDX com TOC, marcacao de progresso, modo leitura. | Critica | Tempo medio > 12 min |
| Quizzes | Aluna | Auto-corretivo objetivo, revisao por mentor para subjetivo. | Alta | Nota media > 75% |
| Certificados | Aluna e externo | PDF + pagina /cert/<id> verificavel com QR, hash, revogacao. | Alta | Emissoes / aluna ativa |
| Gamificacao | Aluna | XP por aula, badges por trilha, missoes semanais, streak respeitoso. | Media | Retencao D7 > 50% |
| Tutor IA | Aluna | RAG sobre modulo aberto, sempre cita a fonte, log de auditoria. | Media | Resolucao sem suporte |
| Admin | Operacao | Gestao de alunas, cursos, cupons, refunds, auditoria. | Critica | Tempo de operacao / semana |
| CMS | Conteudista | MDX em git com voice_guard obrigatorio antes de merge. | Alta | Modulos publicados / mes |
| Pagamentos | Aluna | Stripe (cartao) + Pagar.me (Pix) com webhook signing dual. | Critica | Taxa de aprovacao > 92% |
| Analytics | Operacao e diretoria | Plausible + PostHog + Sentry + dashboard executivo Herreira. | Alta | Dashboards atualizados / dia |
| GEO dashboard | Marketing | Mention rate, citation rate, share of voice generativo por LLM. | Media | Mentions / mes > 40 (M4) |
Trilhas educacionais — catalogo v1.0
Nove trilhas publicas (~79 modulos) e a sub-trilha B2B Herreira Partner (25 modulos, 14 co-marcados exclusivos). Padrao editorial HBR de 2.500 a 4.000 palavras por modulo.
Trilha 1 — Fundamentos: o universo das semijoias
8 modulos · ~3h · Free + Aprendiz
Persona iniciante absoluta. Tres modulos free abrem o funil. Conteudo cobre definicoes, cadeia produtiva, mercado, metais, pedras, hipoalergenia, etiquetagem legal e tipologia de cliente.
- O que e semijoia, joia fina e bijuteria
- A cadeia produtiva brasileira (Limeira, SP)
- O mercado em numeros (IBGM 2025)
- Ouro, prata, rodio, paladio
- Pedras naturais, sinteticas e zirconias
- Hipoalergenia, niquel e regulacao Anvisa
- Etiquetagem legal Inmetro
- Os 5 tipos de cliente que compram semijoias
Trilha 2 — Materiais e tecnicas
10 modulos · ~3,5h · Aprendiz
Persona Marina (revendedora) e Julia (designer). Domina anatomia da peca, banhos, prata, ligas, zirconias, perolas, cristais, esmaltacao e fronteiras tecnicas.
- Anatomia de uma peca — aro, base, pino, fecho
- Banho flash, 3 micra e Gold Filled
- Banho de rodio em peca branca
- Prata 925 — identificar e cuidar
- Ligas — latao, bronze, alpaca
- Zirconias — cortes, cores, qualidade ABCD
- Perolas natural, cultivada e shell
- Cristais Swarovski, Preciosa, vidrilho
- Esmaltacao a frio, vitrificada e resina
- Quando uma peca e "joia" (ouro 18k, prata 950)
Trilha 3 — Vendas consultivas e atendimento de luxo acessivel
9 modulos · ~3,5h · Aprendiz
Persona Camila (lojista) e equipe de vendas. Psicologia de compra, atendimento de luxo, storytelling, demonstracao tatil, objecoes classicas, fechamento e pos-venda.
- Psicologia da compra — presente, autopresente, ritual
- Atendimento de luxo acessivel (Tiffany, Pandora, Vivara)
- Storytelling de produto
- Diagnostico em 3 perguntas (BANT adaptado)
- Demonstracao tatil — provador, espelho, luz
- Objecoes classicas (banho, escurecimento, garantia)
- Fechamento sem pressao (Cialdini aplicado)
- Pos-venda como motor de recorrencia — cartao amuleto
- Treinamento de equipe — roleplay e shadowing
Trilha 4 — Empreendedorismo em joias e semijoias
12 modulos · ~5h · Aprendiz + Profissional
Futura dona de marca. Modelos de negocio, validacao, plano enxuto, constituicao juridica, fornecedores, capital de giro, localizacao, branding, fotografia, precificacao, contratos e roadmap de 12 meses.
- Modelos de negocio — revenda, atacado, marca, marketplace
- Validacao de tese (caso Herreira 2008)
- Plano de negocios em 1 pagina
- MEI vs ME vs LTDA
- Fornecedores — Limeira, mostruario, cota minima
- Linha de credito — Sebrae, BNDES, capital de giro
- Localizacao — rua, shopping, kiosque, virtual
- Branding — nome, logo, paleta
- Identidade visual e fotografia de produto
- Precificacao — markup, ponto de equilibrio, margem
- Contratos com revendedoras
- Roadmap de 12 meses
Trilha 5 — Marketing digital e social commerce
11 modulos · ~4,5h · Profissional
Marca e lojista digital. Funil de joalheria, Instagram, TikTok, WhatsApp, fotografia, video curto, Meta Ads, influencia, e-commerce, marketplaces, email e SMS.
Trilha 6 — GEO e SEO para joalheria
6 modulos · ~2,5h · Profissional + Master Diferencial competitivo unico
Nasce do moat Brasil GEO. Marca avancada e marketing senior. SEO para joalheria, GEO em LLMs, Wikidata e Wikipedia, schemas aplicados, conteudo que LLMs amam, GEO regional.
- SEO para joalheria — keywords transacionais, schema, link building
- GEO — como ChatGPT, Perplexity e Gemini decidem citar
- Wikidata e Wikipedia para joalheria
- Schema.org Product, Review, LocalBusiness
- Conteudo que LLMs amam — estrutura, citacoes, profundidade
- GEO regional — "joalheria em [cidade]"
Trilha 7 — Operacao, estoque, precificacao e pos-venda
9 modulos · ~3,5h · Profissional
ERP, curva ABC, inventario, precificacao dinamica, politica de troca, pos-venda como gerador de LTV, reparo, logistica e indicadores semanais.
Trilha 8 — Curadoria, tendencias e estilo
6 modulos · ~2,5h · Aprendiz + Profissional
Compradora, estilista de imagem, brand manager. Calendario de tendencias, Pantone, personal jewelry styling, ocasiao, colecao capsula e editorial.
Trilha 9 — Avancado: joias finas, gemologia e avaliacao
8 modulos · ~3,5h · Master exclusivo
Profissional senior, joalheiro tradicional. 4Cs do diamante, pedras coradas preciosas, semipreciosas brasileiras, lapidacao, hallmark, avaliacao para seguro, restauro e ourivesaria contemporanea.
Herreira Partner — sub-trilha B2B (Plano Empresarial)
25 modulos · 11 abertos + 14 co-marcados
Trilha customizada para revendedoras Herreira. Mistura modulos do catalogo aberto com modulos exclusivos co-marcados, escritos com fatos canonicos da marca (fundacao agosto/2008, 18 anos, dois telefones).
1. Fundamentos Herreira (5 modulos)
Banho 18k 10-15 micra, paladio sem niquel, historia desde 2008, garantia, hipoalergenia.
2. Como vender Herreira (6 modulos)
Cliente ideal classe B+/A, mix de produto, ticket medio R$ 280, regra anti-desconto, storytelling A Joia que Sou.
3. Operacao da revendedora (5 modulos)
Cadastro com CNPJ ou MEI, pedido via WhatsApp comercial, telefones (62) 3091-5858 e (62) 98173-0039, troca, logistica.
4. Vitrine digital (5 modulos)
Instagram, fotografia sem estudio, video de 15-30s, voz Patricia em copy, WhatsApp Business como CRM.
5. Certificacao Herreira Partner (4 modulos)
Simulacao de venda em 3 cenarios, prova teorica com nota minima 80%, regras do selo Herreira Partner com validade de 12 meses, renovacao anual.
Area da aluna — dashboard de aprendizagem
Painel pessoal que respeita o ritmo da aluna, prioriza acao seguinte clara e nunca substitui o conteudo por gamificacao vazia.
Bem-vinda, Marina
Plano Aprendiz · Trilha 1 em curso
Continue de onde parou
Trilha 1 · Modulo 4 — Ouro, prata, rodio, paladio
Proxima melhor acao
Responda o quiz do modulo 3 antes de avancar
Em andamento
3 aulas
Badges
2 conquistas
Certificados
0 emitidos
Tutor IA
5 perguntas
Materiais favoritos
PDF Banho 3 micra · Checklist atendimento · Tabela hipoalergenia
Notificacoes
Mentoria de quinta · Novo modulo Trilha 2 · Quiz pendente
Area administrativa
Dez capacidades operacionais com auditoria e RBAC granular. Pensada para operacao enxuta e escalavel sem virar "planilha grande".
Gestao de alunas
Listar, filtrar, mudar plano, revogar acesso, exportar/deletar dados (LGPD em 15 dias).
Gestao de cursos
Criar, editar, despublicar trilhas. Gates de qualidade obrigatorios antes de publicar.
Gestao de aulas
MDX em git, voice_guard verde, revisao editorial obrigatoria via PR.
Gestao de quizzes
Banco de questoes, peso, randomizacao, prova teorica de certificacao.
Gestao de certificados
Emitir, revogar, verificar via /cert/<id>. Hash de integridade auditavel.
Conteudo bilingue
PT-BR canonico + EN-US revisado. Frontmatter com titulo_en, descricao_en e <slug>.en.mdx.
Gestao de pagamentos
Stripe + Pagar.me, cupons, refunds, dunning automatico, downgrade.
Gestao de permissoes
RBAC com 8 papeis e eixo org_id. RLS no Postgres + MFA TOTP em admin/owner.
Relatorios
MRR, churn, NRR, LTV, NPS, mention rate, taxa de conclusao por trilha.
Auditoria
Log imutavel das acoes sensiveis. Quem fez, quando, com que IP, motivo. Retencao 90 dias.
Gamificacao responsavel
Oito mecanicas leves que medem competencia e continuidade, nao pressao comercial. Desliga ao primeiro sinal de ansiedade.
| Mecanica | Objetivo | Disparador | Recompensa | Risco | Metrica |
|---|---|---|---|---|---|
| XP por aula | Reforco positivo continuo | Conclusao de aula com tempo minimo | +10 XP | Farming sem absorcao | Tempo medio por aula |
| Badges por trilha | Reconhecer marco | Trilha com nota >= 80% | Badge para LinkedIn | Inflacao de badge | Badges legitimos / aluna |
| Streak semanal | Habito leve | 3 sessoes na semana | Selo "regularidade" | Pressao à aluna em ferias | Streak ativo / churn |
| Missoes | Direcionar foco | Sugestao mensal | +50 XP + badge | Excesso de objetivo | Conclusao de missao |
| Quizzes | Validar competencia | Fim de modulo | Liberacao do proximo | Bypass via tentativa | Nota media > 75% |
| Certificados | Marco verificavel | Trilha completa | PDF + pagina publica | Emissao indevida | Emissoes auditadas |
| Ranking opcional | Comunidade saudavel | Opt-in da aluna | Top 10 da semana | Comparacao toxica | Adesao opt-in < 30% |
| Recomendacoes | Reduzir gap | Skill graph | Modulo certo na hora certa | Filter bubble | CTR da recomendacao |
Diretriz da diretoria
Gamificacao deve medir competencia e continuidade, nao pressao comercial. Streak nunca penaliza ferias. Ranking e opt-in. Badges so sao emitidos com aprovacao real, nao por farming.
Citabilidade em buscadores e LLMs
Camadas publicas e privadas separadas para maximizar citacao em ChatGPT, Perplexity, Gemini e Claude sem expor conteudo monetizavel.
Camada publica (citavel)
- Pagina de cada curso e trilha
- Glossario canonico bilingue de joalheria
- FAQ por jornada
- Guias e ensaios editoriais
- Pagina de certificacao publica /cert/<id>
Camada privada (paywall)
- Aulas completas dos modulos pagos
- Materiais comerciais — scripts, playbooks
- Quizzes e exames
- Resultados detalhados de quiz
- Mentorias gravadas
Requisitos tecnicos por pagina publica
- SSR ou SSG no Next.js 16 com revalidacao incremental
- JSON-LD com Schema.org Course, LearningResource, FAQPage, Article, VideoObject, Organization, Person
- Sitemap automatico com IndexNow ping em deploy
- robots.txt explicito + llms.txt completo
- Canonical e hreflang corretos para PT-BR e EN-US
- Answer blocks com pergunta + resposta direta
- Glossario canonico com schema DefinedTerm
- Citacoes a fontes externas verificaveis
Metricas GEO
Mention Rate
Frequencia de citacao por LLM
Citation Rate
Modulos citados / total publicado
Share of Voice
Voz vs concorrentes em LLMs
Trafego de IA
Sessoes vindas de AI overviews
Conversao IA
Cadastros / sessao IA
Top citados
Paginas com mais mentions
IA generativa com governanca NIST AI RMF
Oito casos de uso autorizados. Cada chamada LLM logada em ai_audit_log. Lista explicita de proibidos protege marca e aluna.
Tutor de duvidas
RAG sobre modulo aberto, sempre cita fonte. Respostas com link para pagina-fonte.
Resumo de aula
Sintese executiva ao fim do modulo, estilo "tres ideias para levar".
Flashcards
Geracao automatica de flashcards a partir do conteudo, revisao espaçada.
Simulacao de venda
3 cenarios (presente, autopresente, ritual), avaliacao por rubrica.
Correcao assistida
Quiz subjetivo recebe sugestao de IA + revisao humana obrigatoria.
Recomendacao de trilha
Por gap de competencia, sem filter bubble, com explicabilidade.
Assistente editorial
Voice guard + sugestoes de revisao no PR de conteudo.
Auditoria de conteudo
Detecta dado desatualizado (preco, lei, fato canonico).
Guardrails inegociaveis
RAG so com conteudo aprovado e versionado. Logs auditaveis em ai_audit_log com retencao 90 dias. Revisao humana obrigatoria em todo conteudo novo. IA nao muda preco. IA nao aprova revendedora. IA nao acessa dados de pagamento. Deepfake de instrutora real e proibido. Geracao de certificado sem trilha completada e proibida.
Stack tecnologica
Doze camadas com escolha justificada por custo, ecossistema e aderencia a padroes do mercado mid-market BR.
| Camada | Tecnologia | Por que |
|---|---|---|
| Frontend | Next.js 16 + Tailwind + shadcn/ui | App Router maduro, SSR/ISR/PPR para GEO, design system pronto. |
| Backend | Server Actions + tRPC | End-to-end type safety, cold start baixo, fricao zero com Next.js. |
| Banco | Supabase Postgres + pgvector | RLS declarativa, vector store nativo para RAG, escala bem ate M5. |
| Auth | Supabase Auth + RLS + RBAC | 8 papeis com custom claims, MFA TOTP, SAML SSO no upgrade Team. |
| CMS | MDX em git | Versionamento, code review, sem CMS proprietario. |
| Video | Mux ou Cloudflare Stream | Decisao em M2 com base em custo/min real e DRM. |
| Pagamentos | Stripe + Pagar.me ou Asaas | Cartao internacional + Pix recorrente nao-negociavel no BR. |
| Jobs | Inngest ou Trigger.dev | Filas duraveis, retries, observability nativa. |
| IA | OpenAI + Anthropic + Gemini + Groq + Perplexity | 5 LLMs unificadas em curso-factory, melhor LLM por tarefa. |
| Busca | pgvector + Postgres FTS | Hibrido lexico + semantico no mesmo Postgres. |
| Observabilidade | Sentry + PostHog + Plausible | Erro + produto + privacidade-friendly LGPD. |
| Deploy | Vercel | Preview por PR, ISR/PPR, deploy independente por app. |
Arquitetura logica em camadas
Diagrama de blocos do fluxo da aluna. Conteudo publico alimenta SEO/GEO; conteudo privado vive atras de paywall com auditoria.
Usuario (visitante · aluna · admin · org admin)
Frontend publico (apps/web)
Area autenticada (apps/web)
API edge (apps/api · tRPC + Server Actions)
Banco Supabase Postgres + RLS
CMS MDX em git
Pagamentos Stripe + Pagar.me
Video Mux/Stream
IA-RAG pgvector + LLMs
Jobs Inngest
Analytics Plausible + PostHog + Sentry
GEO monitor + IndexNow
Admin (apps/admin)
Fluxo: usuario acessa pagina publica indexada pelos LLMs. Cadastra-se, escolhe plano, paga. Acessa area autenticada, assiste aula, responde quiz, ganha certificado. Eventos vao para Plausible e PostHog. Conteudo publico alimenta SEO e GEO. Admin governa conteudo, alunas e metricas com auditoria. IA-RAG so opera sobre conteudo aprovado, com log em ai_audit_log.
Seguranca e LGPD by design
Matriz de risco priorizada por impacto. Mitigacoes ja desenhadas no roadmap. Auditoria externa antes de M2.
| Risco | Impacto | Mitigacao | Dono |
|---|---|---|---|
| Vazamento de dados de aluna | Critico | RLS por org_id, criptografia em repouso, backups 30 dias, DPO interino | Security Owner |
| Acesso indevido ao admin | Critico | MFA TOTP obrigatoria, IP allowlist em owner, log imutavel | Security Owner |
| Conteudo errado publicado (fato canonico) | Alto | Voice guard CI + Patricia review obrigatorio em content/herreira/** | Conteudista |
| IA alucinando preco ou promocao | Critico | Tutor IA proibido de mudar preco; resposta cita modulo-fonte | AI Owner |
| Falha de pagamento e dunning | Alto | 3 retentativas em 7 dias, downgrade automatico, fallback boleto | Tech Lead |
| Certificado emitido indevidamente | Alto | Hash de integridade, ID nao-sequencial, revogacao publica | PO |
| Conteudo privado indexado por engano | Alto | robots.txt + middleware paywall + auditoria mensal de SERP | Growth/GEO Owner |
| Revendedora usando material incorreto | Medio | Selo Herreira Partner com validade de 12 meses, recertificacao | Especialista Herreira |
Controles base
- MFA TOTP obrigatoria em admin e owner
- RBAC com 8 papeis e eixo organizacional
- RLS no Postgres declarativa por par (papel, tabela)
- Logs imutaveis com retencao 90 dias
- Criptografia em repouso e em transito (TLS 1.3)
- Backups Supabase com restore mensal testado
- Consent log granular (LGPD + GDPR by design)
- Politica de retencao por tipo de dado
- Auditoria externa antes de M2
- Revisao humana obrigatoria em todo output de IA publicado
- Politica de IA NIST AI RMF (ADR-009)
- Direitos LGPD atendidos em 15 dias uteis (ADR-010)
Analytics e KPIs
North Star MRR em BRL. KPIs operacionais, comerciais e de aprendizagem instrumentados desde o MVP.
38%
Cadastro → primeira aula (M1)
55%
Primeira aula → conclusao M1
> 55%
Conclusao por trilha (M2)
> 50%
Retencao D7
> 35%
Retencao D30
200/mes
Certificados emitidos (M3)
> 75
Nota media de quizzes
95% PT
Uso por idioma
12 paises
Alunas por pais (M5)
Top 20
Duvidas recorrentes
15%
Citation rate (M3)
40 mentions
Mention rate por mes (M4)
SOV crescente
Share of voice generativo
R$ 165k
MRR projetado M5 (jun/27)
< 5%
Churn voluntario M4
> 4x
LTV/CAC (M4)
Squad e governanca
Squad MVP enxuto. Decisoes formalizadas via 11 ADRs + decision log por release. Patricia consultada em tudo que toca marca.
Product Owner
Alexandre Caramaschi — visao, priorizacao, decisao final.
Tech Lead
Arquitetura, code review, mentor tecnico.
Frontend Engineer
apps/web e apps/admin, design system, performance.
Backend Engineer
apps/api, schema, RLS, integracoes Stripe e Pagar.me.
UX/UI Designer
Figma, design tokens, jornada, acessibilidade WCAG 2.2.
Conteudista
Editor MDX, voice_guard, padrao HBR, revisao editorial.
Especialista Herreira
Patricia Caramaschi — review de conteudo Herreira, voz, fatos canonicos.
QA Engineer
Playwright, axe-core, regressao de paywall.
Security/LGPD Owner
RBAC, RLS, MFA, threat model, DPO interino.
Growth/GEO Owner
Bruno Azambuja (Brasil GEO) — schemas, llms.txt, mention rate.
Ritos da squad
- Sprint de 2 semanas com release/yyyy-mm-dd
- Daily assincrona via canal dedicado
- Review semanal com demo de incremento
- Backlog grooming quinzenal
- Retrospectiva ao fim de cada sprint
- Decision log por release com 2 revisores em PR para main
- ADRs publicas em /docs/adr
- Definition of Ready e Definition of Done escritas
Sprints 0 a 5 — janela 90 dias
Mapeamento direto entre os 6 sprints de execucao e os marcos M0 fim + M1 + M2 do ROADMAP.
Sprint 0 — Fundacao (2026-05-09 → 2026-05-23)
Objetivo
Setup operacional e infraestrutura base para o time comecar a desenvolver.
Entregaveis
Turborepo + 4 ambientes Supabase + gitflow + AI policy + design tokens.
Metricas
CI verde · build < 3min · previews por PR.
Riscos
Curva Turborepo · pendencia Pix recorrente Pagar.me.
Sprint 1 — Auth e layout (2026-05-24 → 2026-06-06)
Objetivo
Aluna se cadastra, faz login, ve home autenticada com estado vazio.
Entregaveis
Supabase Auth + RLS · design system v1 · pagina home publica · pagina planos.
Metricas
Cadastro funcional em < 90s · LCP home < 1.8s · voice_guard 100%.
Riscos
OAuth Google em revisao · LGPD policy a ratificar.
Sprint 2 — Cursos e player (2026-06-07 → 2026-06-20)
Objetivo
Aluna assina, paga, abre primeiro modulo da Trilha 1.
Entregaveis
Stripe + Pagar.me com webhooks · trial 30 dias · render MDX · primeiros 8 modulos da T1 · middleware paywall.
Metricas
Taxa de aprovacao Stripe > 92% · Pix recorrente operacional · tempo de leitura medio > 12 min.
Riscos
Pix recorrente atrasar · pricing dinamico em US$.
Sprint 3 — Quizzes e certificados (2026-06-21 → 2026-07-04)
Objetivo
Aluna completa Trilha 1, faz quiz, recebe certificado verificavel.
Entregaveis
Quiz auto-corretivo · certificado PDF + /cert/<id> · QR code · hash de integridade.
Metricas
Tempo de emissao < 30s · 95% certificados verificados via QR.
Riscos
Geracao PDF on-demand pode estourar custo · revisao juridica do termo "certificado de conclusao".
Sprint 4 — Gamificacao e notificacoes (2026-07-05 → 2026-07-18)
Objetivo
Aluna recebe XP, badges, missoes, notificacoes via email e WhatsApp.
Entregaveis
XP por aula · badges · streak respeitoso · missoes mensais · Resend + WhatsApp Business templates.
Metricas
Retencao D7 > 50% · abertura email > 35% · opt-in WhatsApp > 60%.
Riscos
Streak gerar pressao indevida · notification fatigue.
Sprint 5 — GEO, analytics, go-live (2026-07-19 → 2026-08-15)
Objetivo
Lancamento publico aberto com 200 alunas pagas e MRR R$ 12k.
Entregaveis
Schema.org Course + LearningResource · llms.txt · sitemap + IndexNow · Plausible + PostHog · campanha Meta · FAQ + glossario.
Metricas
200 alunas pagas · NPS > 50 · mention rate inicial 5+ · auditoria externa concluida.
Riscos
CAC acima de R$ 120 · bug critico no go-live · congestionamento de admin.
Riscos e decisoes executivas
Dez decisoes que dependem de aprovacao da diretoria antes do fim do M0. Cada uma com opcao recomendada e razao.
Nome publico do produto
Manter Semijoias-Educa como marca multi-cliente, com Herreira Academy como sub-trilha B2B. Recusa portal Herreira-only para preservar moat horizontal.
Subdominio
Domain principal semijoiaseduca.com.br. Plano Empresarial ganha herreira.semijoiaseduca.com.br com tema Herreira aplicado.
Acesso aberto vs restrito
Catalogo de modulos publico (preview e SEO/GEO). Aulas completas atras de paywall. Trilha B2B Herreira tem visualizacao restrita por org_id.
Modelo de monetizacao
Hibrido — 3 modulos free (T1) como degustacao + paywall escalonado em 4 planos individuais + plano Empresarial. Sem freemium puro.
Gateway de pagamento
Stripe (cartao internacional) + Pagar.me (Pix recorrente). Asaas e Iugu como fallback. Validar Pix recorrente em M0.
Provedor de video
Decisao em M2 com base em custo/min real. Mux e Cloudflare Stream em comparativo. Bunny como custo-otimizado.
Provedor de auth
Supabase Auth ja decidido (ADR-007). Clerk avaliada e recusada por dependencia externa.
Politica de IA
NIST AI RMF adotado (ADR-009). Lista explicita de autorizados e proibidos. Auditoria 90 dias.
Politica de certificacao
Certificado proprio de conclusao com hash verificavel. Recusa parceria IBGM no MVP — risco juridico de "certificacao profissional".
Paises prioritarios
Brasil (BR) primario. Portugal e EUA hispano em M4. UE em M5. EN-US como base para todos os mercados internacionais.
Checklist final M0 → Go-live
Doze frentes de aprontamento. Cada item bloqueia o lancamento publico de M2 se nao estiver verde.
- Produto — PRD aprovado, 9 trilhas mapeadas, 5 personas validadas
- UX — Figma com jornada da aluna e admin, design tokens, WCAG 2.2 AA
- Engenharia — monorepo, 4 ambientes, CI/CD, bundle size budget
- Conteudo — 12 modulos M1 publicados, voice_guard verde, padrao HBR
- Seguranca — RBAC + RLS + MFA + threat model + auditoria externa
- LGPD — consent log, export/delete em 15d, DPO interino, ADR-010
- Pagamentos — Stripe + Pagar.me com webhooks, trial 30d, dunning
- GEO — schemas em todas paginas publicas, llms.txt, sitemap, IndexNow
- IA — politica NIST publicada, ai_audit_log ativo, revisao humana
- Analytics — Plausible + PostHog + Sentry + dashboard executivo
- Sprints — 6 sprints concluidos, retrospectivas registradas, ADRs em dia
- Go-live — 200 alunas pagas, NPS > 50, churn < 8%, MRR R$ 12k