- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
28 KiB
Content & Language: SAR — Força de Vendas
Status: ✅ Block B COMPLETO (Steps 13-18) Cliente: JCS Sistemas Última atualização: 2026-05-26
Este documento define como o SAR fala em todas as camadas — personalidade da marca, tom, idioma, SEO, arquitetura de conteúdo. Companion do
01-product-brief.md.
Materiais herdados (entrada para Block B)
brand.md— identidade visual + tom visual "Apple-inspired, clean, minimalista"01-product-brief.md— positioning, buyer persona, 4 user personasdialog/tone-of-voice.md(Step 11) — 5 atributos canônicos + variações por cockpit + vocabulário canônico
Personality
"Se o SAR fosse uma pessoa..."
Um consultor sênior de vendas B2B brasileiro, 40-50 anos, ex-representante que virou consultor de vendas. Conhece a rua, conhece o ERP, conhece o WhatsApp. Entra na sua empresa, observa por uma semana e começa a apontar onde está sangrando — sem julgar, sem PowerPoint, sem firula. Diz o que precisa ser dito, no momento certo, com dados na ponta da língua.
5 atributos de personalidade
| # | Atributo | O que significa | Como se expressa |
|---|---|---|---|
| 1 | Confiável | Não some, não erra pedido, dados não se perdem. Funciona sem drama. | "Pedido #1234 aprovado" · uptime 99.5% · pedidos perdidos = 0 |
| 2 | Especialista prático | Conhece o setor de força de vendas BR de cor (anos de JCS Android+Desktop). Fala como amigo prático, não acadêmico. | Vocabulário do setor usado naturalmente · IA explicável · zero jargão academicista |
| 3 | Decidido | Não fica em "talvez você queira considerar". Diz o que é, aponta o caminho. | "Cliente OPENFRIOS bloqueado: limite estourado." · botões diretos |
| 4 | Discreto | Não atrapalha, não enche de modais. Faz seu trabalho sem ruído. | Apple-inspired clean · zero notificação desnecessária · empty states informativos |
| 5 | Aliado | Está do lado do usuário, não vigiando. | Linguagem inclusiva · IA sugere não impõe · sem tom punitivo |
Conexão com cada persona
| Persona | Como o "consultor sênior" se relaciona |
|---|---|
| 🟢 Rafael (Rep) | Colega mais experiente — dicas práticas, mostra status na hora que precisa |
| 🟡 Sandra (Supervisora) | Assessor de confiança — prepara o que ela precisa, sem decidir por ela |
| 🔵 Daniel (Dono) | Consultor estratégico — 1 frase de insight, não relatório de 50 páginas |
| 🟣 Alice (Admin) | Técnico que entende processo — antecipa, não pergunta o óbvio |
O que o SAR não é
❌ Vendedor barulhento ("Compre agora!" "Promoção!") ❌ Burocrata ("O sistema identificou que...") ❌ Coach motivacional ("Você consegue! Vai!") ❌ Espião (não dedura rep, não relatório de "produtividade pessoal") ❌ Filósofo (não explica feature em parágrafos) ❌ Jovem descolado (sem emoji, sem gíria, sem meme)
Síntese
O SAR tem a personalidade de um consultor sênior brasileiro de vendas B2B — confiável, especialista prático, decidido, discreto e aliado. Conhece o setor de cor, fala a língua de quem está na rua e de quem está no escritório, mas não ostenta saber nem enche linguiça. Aparece quando é útil, some quando não é. Diz o que precisa ser dito, com dados, no momento certo. É colega do Rafael, assessor da Sandra, consultor do Daniel, e técnico-parceiro da Alice — sem nunca virar nem vendedor barulhento, nem burocrata, nem espião, nem jovem descolado.
Tone of Voice (refinamento via spectrums)
Posicionamento nos 4 espectros (1-5)
| Espectro | Posição | Significado |
|---|---|---|
| Formality | 3 (meio-termo, levemente formal) | Profissional sem ser frio — "roupa social leve, não terno, não camiseta" |
| Mood | 2 (sério-com-leveza) | Não brincalhão, mas com momentos leves nos estados vazios |
| Complexity | 3 (vocabulário do setor + acessível) | Usa pauta/ICMS-ST/faturado sem traduzir, mas explica IA e erros |
| Energy | 2 (reservado) | Apple-inspired calm — sem exclamações, sem emojis em produção |
Mapa visual
Formality: Formal ┤──────●──── Casual (3/5)
Mood: Serious ┤───●──────── Playful (2/5)
Complexity: Technical ┤──────●──── Simple (3/5)
Energy: Reserved ┤───●──────── Enthusiastic (2/5)
Centro de gravidade: levemente formal, sério-com-leveza, tecnicamente acessível, energia contida.
We Say / We Don't Say (canônico)
Cumprimentos / status
| Contexto | ✅ We say | ❌ Formal demais | ❌ Casual demais |
|---|---|---|---|
| Login do Rafael | "Bom dia, Rafael" | "Prezado(a) usuário" | "E aí, Rafael!" |
| Sandra acessa | "3 aprovações pendentes" | "Existem 3 aprovações pendentes no sistema" | "Olha só, 3 coisas pra você!" |
| Painel do Daniel | "Faturamento em junho: R$ 1.2M (+18%)" | "Resultado consolidado de faturamento" | "Explodiu o mês!" |
Sucesso / confirmação
| Contexto | ✅ We say | ❌ Formal | ❌ Casual |
|---|---|---|---|
| Pedido enviado | "Pedido #1234 enviado" | "Sua solicitação foi processada com êxito" | "Foi! Pedido na mão." |
| Aprovação | "Pedido #1234 aprovado pela Sandra" | "Operação validada por usuário supervisor" | "Sandra liberou!" |
| Check-in | "Check-in registrado em OPENFRIOS às 14:32" | "Registro de visita armazenado com sucesso" | "Pegou o cliente!" |
Erro / problema
| Contexto | ✅ We say | ❌ Formal | ❌ Casual |
|---|---|---|---|
| Sem conexão | "Sem sinal. Seu pedido fica salvo aqui e envia quando você se conectar." | "Falha de conectividade detectada." | "Aí ó, caiu! Mas relaxa." |
| Cliente bloqueado | "OPENFRIOS bloqueado: limite de crédito estourado. Peça liberação ou ajuste o valor." | "Bloqueio comercial automático ativado por restrição financeira." | "Eita, esse aí tá no vermelho!" |
| Senha errada | "Senha incorreta. Tente de novo ou recupere sua senha." | "Credenciais inválidas. Verifique e tente novamente." | "Hmm, essa senha não bate" |
Empty states
| Contexto | ✅ We say | ❌ Formal | ❌ Casual |
|---|---|---|---|
| Funil vazio | "Sem propostas em andamento. Cadastre a primeira em Nova proposta." | "Nenhum registro foi localizado na consulta." | "Tudo vazio! Bora preencher!" |
| Sem pedidos hoje | "Nenhum pedido lançado hoje. Bom dia para mudar isso." | "Não há registros para o período informado." | "Dia parado hoje, hein?" |
| Inativos zerado | "Nenhum cliente inativo nos últimos 60 dias." | "Inexistem clientes em estado de inatividade." | "Tudo certo, parabéns!" |
IA / sugestão
| Contexto | ✅ We say | ❌ Formal | ❌ Casual |
|---|---|---|---|
| Daniel — descontos | "Você aprovou 3 descontos acima de 10% essa semana, todos para OPENFRIOS. Reavaliar tabela?" | "Detectada concentração de aprovações acima do padrão." | "Olha esse OPENFRIOS aí roubando seus descontos!" |
| Rafael — cliente | "OPENFRIOS não compra há 47 dias. Visite ou ligue." | "Cliente sem atividade comercial registrada nos últimos 47 dias." | "Cliente esfriando! Corre lá!" |
Reuso do Step 11
Os 5 atributos canônicos (dialog/tone-of-voice.md) e o vocabulário canônico seguem como tokens — não duplico aqui. Este documento adiciona apenas a calibragem por espectro + We Say/Don't Say expandidos.
Languages
Estratégia canônica
pt-BR only no MVP, arquitetura i18n-ready.
| Idioma | Status MVP | Prioridade futura |
|---|---|---|
| pt-BR | ✅ Único idioma do produto, site, marketing, IA | Sempre primário |
| en | 🟡 Não no MVP — preparado no código (chaves i18n) | Eventual: parceiros internacionais, futuras integrações |
| es (LatAm) | ❌ Fora de escopo no MVP | Possível Y2+ se houver expansão Argentina/Paraguai/Uruguai (requer adaptação fiscal por país) |
Por quê pt-BR only
- Target = empresas brasileiras (positioning, Step 3)
- Vocabulário do setor (carteira, faturado, pauta, ICMS-ST, NCM, NF) só faz sentido em pt-BR
- Concorrência regional pt-BR only (Mercos, Promosoft, MaxFV)
- JCS comunica em pt-BR (config.yaml)
- Zero ROI imediato em traduzir antes do MVP fechar
Por quê i18n-ready arquitetural
Custo marginal de usar chaves i18n agora é muito menor que retrofit depois:
- React-i18next ou similar (decisão técnica de Phase 3+)
- Todas as strings de UI em arquivo
pt-BR.json(não hardcoded em JSX) - Vocabulário canônico fixo no Step 11 já naturalmente vira chaves consistentes (
pedido.status.aprovado,cliente.estado.inativo, etc.) - Preserva opção de expansão Y2+ sem reescrita
Implementação prática (encaminha para Phase 3)
- Chaves estruturadas:
cockpit.<rafael|sandra|daniel|alice>.<area>.<elemento> - Validação de output da IA: rejeitar respostas em en, fazer fallback ou retry com prompt mais firme
- Prompts de IA em pt-BR sempre (preserva qualidade linguística)
Localização (BR-only)
| Item | Padrão SAR |
|---|---|
| Moeda | BRL (R$ X.XXX,XX — vírgula decimal, ponto milhar) |
| Data | DD/MM/AAAA (calendário gregoriano BR) |
| Hora | 24h (HH:mm), fuso America/Sao_Paulo por workspace; UTC armazenado no PG |
| Telefone | +55 (XX) XXXXX-XXXX (celular) · +55 (XX) XXXX-XXXX (fixo) |
| CEP | XXXXX-XXX |
| CNPJ | XX.XXX.XXX/XXXX-XX |
| CPF | XXX.XXX.XXX-XX |
| Endereço | Padrão BR (Logradouro, número, complemento, bairro, cidade, UF, CEP) |
| Pesos/medidas | Sistema métrico (kg, g, l, ml, m, cm) |
Implicação para STACK
- Validators no Zod para CPF/CNPJ/CEP/telefone BR (libs do ecossistema NPM)
- Date-fns ou Day.js com locale
pt-BR Intl.NumberFormat('pt-BR', { style: 'currency', currency: 'BRL' })para formatação- Fuso por workspace armazenado no master-login (cliente em SP ≠ cliente em Manaus)
Tone consistency
Não aplicável no MVP (idioma único). Se um dia for bilíngue, regra: personalidade idêntica ("consultor sênior brasileiro" continua sendo a metáfora), mas registro adapta à cultura do idioma destino. en seria um pouco mais formal que pt-BR (formality 3.5 vs 3).
SEO Keywords
Keywords por intenção
🎯 Service / Solução (alta intent comercial)
software de força de vendas·sistema de força de vendas·plataforma de força de vendassoftware para representante comercial·sistema para representante externo·app para vendedor externoSaaS força de vendas
🩺 Problem (leads quentes)
como controlar representante externocomo saber quais clientes pararam de comprarcomo organizar pedidos de representantescomo aprovar desconto vendedor externocomo integrar WhatsApp com vendas B2Bcomo acompanhar meta de vendedorcomo saber se rep está visitando cliente
⚖️ Comparison (fundo de funil)
alternativa ao Mercos·alternativa ao PromosoftMercos preço·Mercos vs MaxFV·Promosoft vs Mercossoftware força de vendas comparativo·melhor software força de vendas
🏷️ Brand
SAR JCS·JCS Sistemas·SAR força de vendas·JCS força de vendas
📚 Informational (top of funnel + autoridade)
o que é força de vendascomo funciona representação comercialdiferença entre rep e vendedor internogestão de carteira ativainteligência artificial em vendas B2Bcomo recuperar cliente inativoKPIs força de vendas
🎯 Long-tail setor-específico
software para distribuidora de bebidassistema para indústria de alimentos vendasERP para representação comercial autônoma RCAgestão de força de vendas para distribuidora alimentíciasoftware para indústria de produtos químicos vendas
Domínio
A definir — opções priorizadas:
sarjcs.com.br(Recomendado — brandable + JCS-link, requer verificação de disponibilidade)sar.jcs.com.br(subdomain — JCS-centric)sarforcadevendas.com.br(SEO-rich, longo)sar.com.br(curto, premium — verificar disponibilidade)
Padrão de URL
- pt-BR primário:
<dominio>/<slug> - en futuro (i18n-ready):
<dominio>/en/<slug> - Slug: lowercase · hífen · sem especiais · ASCII · curto
Sitemap
/ [Hero, prova social, 3 cockpits, CTA demo]
/funcionalidades/
/funcionalidades/cockpit-representante
/funcionalidades/cockpit-supervisor
/funcionalidades/cockpit-dono
/funcionalidades/cockpit-admin
/funcionalidades/whatsapp-nativo
/funcionalidades/ia-estrategica
/funcionalidades/carteira-ativa
/para/ [Páginas por setor]
/para/distribuidoras
/para/industrias
/para/representacoes-comerciais
/para/pequenas-empresas
/comparativos/ [Combate frontal]
/comparativos/sar-vs-mercos
/comparativos/sar-vs-promosoft
/comparativos/sar-vs-modulo-totvs
/precos [Pricing transparente]
/recursos [Hub de conteúdo]
/recursos/blog/ [Content marketing]
/recursos/calculadora-roi [Lead magnet]
/recursos/kit-vendedor-externo [Lead magnet]
/cases [Cases de cliente — alimenta canal #1]
/parceiros [Contadores, revendedores ERP]
/sobre [JCS + time + missão]
/contato [Form demo — CTA principal]
/app/ [Produto SAR (auth via master-login)]
Page × Primary Keyword map (top 10)
| Página | Slug | Primary keyword | Secondary |
|---|---|---|---|
| Home | / |
software de força de vendas |
SAR, JCS |
| Cockpit Rep | /funcionalidades/cockpit-representante |
app para representante comercial |
app para vendedor externo |
| Cockpit Supervisor | /funcionalidades/cockpit-supervisor |
como acompanhar vendedor externo |
controle de representantes |
| Cockpit Dono | /funcionalidades/cockpit-dono |
BI força de vendas com IA |
inteligência artificial em vendas |
| WhatsApp nativo | /funcionalidades/whatsapp-nativo |
integração WhatsApp com vendas B2B |
aquecimento de lead WhatsApp |
| Carteira ativa | /funcionalidades/carteira-ativa |
recuperar cliente inativo |
gestão de carteira ativa |
| Distribuidoras | /para/distribuidoras |
software para distribuidora |
sistema força de vendas distribuidor |
| SAR vs Mercos | /comparativos/sar-vs-mercos |
alternativa ao Mercos |
Mercos comparativo |
| Preços | /precos |
preço software força de vendas |
quanto custa Mercos, SAR preço |
| Blog "controlar rep" | /recursos/blog/como-controlar-representante-externo |
como controlar representante externo |
app para acompanhar vendedor |
Local SEO
Aplicabilidade média. SAR é nacional, mas a JCS Sistemas mantém presença local.
- Reivindicar Google Business Profile da JCS Sistemas
- NAP consistente no footer (Nome, Endereço, Phone)
- Categoria Google: Software company
- Reviews de clientes JCS alimentam credibilidade
Structured data plan
| Página | Schema.org |
|---|---|
| Todas | Organization (JCS Sistemas) |
| Home | SoftwareApplication (SAR) + Organization |
| Preços | Product + Offer por tier |
| Cases | Article + Review |
| Comparativos | Article |
| Blog | Article + BreadcrumbList |
| Calculadora ROI | SoftwareApplication |
| Páginas com FAQ | FAQPage |
Keyword usage guidelines
- Title tag: primary keyword + brand (
SAR — Software de Força de Vendas | JCS), 60 chars - Meta description: keyword + benefício + CTA, 150-160 chars
- H1: primary keyword (pode diferir do title)
- Body: mention natural, sem stuffing
- Alt text: descritivo + keyword onde aplicável
- Slug: curto, keyword-rich, sem stopwords
Content Structure Principles
Princípios (não especificações). Phase 4 (UX Design) traduz em telas concretas.
🌐 Site Marketing
- Hero entrega proposta em <5 segundos — frase clara + visual + 1 CTA único
- Demo em vídeo, não tour interativo — Daniel assiste, não mexe; 90s com legendas
- Prova social pesada — logos de clientes, depoimentos em vídeo de donos, números reais
- 3 jornadas paralelas para 3 personas —
/para-donos,/para-supervisores,/para-representantes(Alice é benefício, não argumento de venda) - Setores ganham página dedicada quando há vocabulário próprio (distribuidoras ≠ indústrias ≠ RCAs)
- CTA principal único — "Agende sua demo." (não "saiba mais" + "experimente" + "fale conosco")
- Pricing visível, não escondido atrás de form — faixa per-seat clara; fechamento final via comercial
- Comparativos acessíveis, não em destaque —
/comparativos/<x>para quem já compara - Conteúdo SEO no
/recursos/separado do pitch - Cases reais publicáveis tornam-se peça central quando há 3+ clientes pagantes
🖥️ Produto (4 cockpits)
- Cada cockpit tem sua home dedicada — Rafael → painel rep, Sandra → "apertar parafusos", Daniel → IA insights + faturamento, Alice → fila cadastros + campanhas
- Hierarquia por urgência, não categoria — primeira tela mostra decisões de HOJE
- Navegação varia por device:
- Rafael (mobile): bottom nav com 4-5 ícones primários
- Sandra/Daniel/Alice (desktop): sidebar 260px fixa
- Daniel (iPad): sidebar colapsável touch-friendly
- Profundidade máxima 3 níveis (Rafael se perde se for mais fundo no celular)
- WhatsApp e IA não vivem em sub-menu — diferenciais declarados estão no caminho principal de cada cockpit
- Empty states informativos, não placeholders
- Notificações in-app + push apenas para decisão (não para "pedido visualizado")
- Tempo real visível com micro-animação suave (não toast intrusivo)
- Configurações fora do caminho principal — Alice tem sua área (
/admin) - Auditoria onde faz sentido — histórico em cada entidade (pauta, produto, rep, pedido)
- Onboarding discreto, Apple-inspired — tooltips contextuais, sem tour agressivo
❌ Exclusões explícitas (NÃO no MVP)
| Exclusão | Por quê |
|---|---|
| Tutorial interativo onboarding agressivo (Intercom-style) | Brand é Apple-inspired clean — discreção é valor |
| Gamificação visual gritante (badges, achievements, fogos) | "Supervisor amigo, não Big Brother" — sem ranking público de rep |
| Chat-com-cliente-final dentro do produto | Share API + WhatsApp Business já cobrem |
| Módulo de marketing email (campanhas em massa) | Resend é transacional; JCS não vira ferramenta de marketing |
| Módulo de NF/SPED próprio | Cliente integra com ERP; SAR é vendas, não fiscal completo |
| Wallet/pagamento de cliente final | Cliente final paga via outro meio; SAR registra |
| CMS de blog para o cliente | SAR não é WordPress |
| Mobile-first para Daniel/Alice | Desktop-first é decisão arquitetural (Step 7) |
Clareza do PO (calibragem da latitude de Phase 4)
| Área | Visão |
|---|---|
| Site marketing | Médio-alto |
| Produto (4 cockpits) | Alto |
| Onboarding agressividade | Alto (explicitamente discreto) |
| Gamificação | Alto (explicitamente sutil/ausente) |
| Conteúdo SEO | Médio (keywords mapeadas; tom dos artigos a definir) |
| Cases | Baixo (depende de ter clientes) |
Implicação para Phase 4: bastante latitude técnica, restrições claras de tom e estilo.
Content Type Guidelines (entradas práticas para Phase 4 e marketing)
🔘 UI Microcopy (botões, labels, erros, estados)
- Mantenha curto: verbos no infinitivo (
Salvar,Cancelar,Enviar) ou imperativo direto - Voz ativa: "Sandra aprovou", não "Foi aprovado por Sandra"
- Específico sobre a ação:
Enviar pedido>Enviar - Vocabulário canônico sempre (
Cliente,Rep,Pedido,Faturado) - Sem ponto final em botões e labels curtos (
Salvar, nãoSalvar.) - Sem maiúsculas em sentence-case: "Lançar pedido" (não "Lançar Pedido")
📣 Marketing Content (headlines, features, value props)
- Lidere com benefício, não feature ("Veja quantos clientes pararam de comprar" > "Sistema de carteira ativa")
- Frases curtas: 1 ideia por frase
- Power words do tom: clareza, controle, decisão, tempo real, visibilidade, sem-mais (Apple-inspired clean — não palavras "promocionais")
- Conecte com driving forces das personas:
- Daniel: clareza estratégica, IA, decisão
- Sandra: controle, tempo, equipe sob comando
- Rafael: meta, agilidade, ferramenta que respeita
- (Alice): autonomia, lançamento sem dev
- Especificidade vence: "R$ 7.5M em pedidos processados/mês" > "Milhões em vendas"
📚 Informational Content (blog, recursos, sobre)
- Responda à pergunta do título logo no primeiro parágrafo (princípio SEO + tom direto)
- Headings descritivos: o leitor consegue scanear e entender o esqueleto
- Keywords naturalmente integradas (sem stuffing)
- Inclua exemplos concretos (números reais, cenários, vocabulário do setor)
- Conclusão com CTA contextual (não "compre agora!" — algo como "Veja na prática" ou "Conheça o SAR")
📧 Notificações transacionais (email, push, in-app)
- Assunto direto:
Pedido #1234 aprovado pela Sandra(não "Atualização do seu pedido") - Corpo curto: o que aconteceu + 1 link/ação
- Mesma personalidade: "consultor sênior" continua firme em email/push
- Footer JCS consistente (assinatura, contato, opt-out se aplicável)
💬 WhatsApp programático (para o cliente final do cliente SAR)
⚠️ Estas mensagens não são do SAR para o usuário — são do cliente-empresa para o cliente-do-cliente. SAR fornece templates customizáveis.
- Identifique a empresa-cliente claramente: "Pedido aprovado | OPENFRIOS"
- Não use jargão JCS/SAR: o cliente final não conhece — é mensagem comercial da empresa-cliente
- Templates aprovados por Meta (regra WhatsApp Business)
- Opt-out claro em qualquer mensagem ("Para parar de receber, responda PARAR")
🤖 IA generativa (alertas, sugestões, insights)
- Sempre em pt-BR (validação de output)
- Explicável: cada insight tem "por quê" curto ("Você aprovou 3 descontos acima de 10%, todos para OPENFRIOS")
- Sugestão, nunca ordem: "Considere reavaliar..." / "Pode valer a pena..." (mas SEM cair em "talvez você queira considerar...")
- Específico com números: sem "alguns", "vários", "muitos"
- Confiável: se não houver dado, IA não inventa — diz "Não tenho dados suficientes para essa análise ainda"
Content Ownership (quem escreve o quê)
Estado MVP (solo founder mode). Refinar conforme JCS contrata.
| Tipo de conteúdo | Owner MVP | Owner Y1+ | Frequência |
|---|---|---|---|
| UI microcopy do produto | Julian (revisado contra este doc) | UX writer / dev + revisor | A cada feature nova |
| Headlines + value props do site | Julian | Marketing/Content + revisor de tom | Estabilizado pós-launch |
| Blog / artigos SEO | Julian (4-8 artigos no MVP) | Content writer freelance/full-time | 4-8/mês |
| Cases publicáveis | Julian + cliente (entrevista) | Marketing/Content | Cada cliente novo (com release) |
| Notificações transacionais (email/push) | Julian (revisor único) | UX writer + dev | Por feature |
| Templates WhatsApp | Julian + cliente revisa | Cliente customiza, JCS aprova | Por cliente |
| Prompts de IA generativa | Julian (eng + tom) | AI/ML eng + revisor | A cada melhoria de IA |
| Documentação técnica (changelog, API) | Julian | Dev team | A cada release |
| FAQ / suporte | Julian (depois de receber primeiras dúvidas reais) | Suporte/CS | Mensal |
Princípio de ownership
Quem escreve, valida contra este doc. Quem revisa, garante que tom + vocabulário + atributos batem.
Sem comitê de revisão. Solo founder = Julian é também revisor. Quando contratar, contratar revisor independente para vendas + marketing (evita viés-do-tech-founder).
Writing Checklist (entra em todo PR de microcopy / artigo / email)
- [ ] Tom: bate com os 5 atributos (Direto, Profissional sem ser frio, Confiante, Específico, Empático nos momentos difíceis)?
- [ ] Vocabulário: usa palavras canônicas (Cliente, Rep, Orçamento, Pedido, Faturado, etc.)?
- [ ] Espectros: dentro de Formality≈3 / Mood≈2 / Complexity≈3 / Energy≈2?
- [ ] Sem palavras proibidas (operação, registro, sistema, movimentação como sujeito)?
- [ ] Sem anglicismos desnecessários (Submit→Enviar, Loading→Carregando)?
- [ ] Sem emoji em produção (exceção: empty states muito específicos)?
- [ ] Voz ativa, não passiva?
- [ ] Específico com números/nomes quando possível?
- [ ] Acessibilidade: linguagem clara, sem jargão sem explicação?
- [ ] pt-BR correto (gramática + ortografia)?
- [ ] Variação por cockpit respeitada (Rafael informal-curto / Sandra decisivo / Daniel executivo / Alice técnico-preciso)?
- [ ] SEO: keyword primária na presença esperada (sem stuffing)?
- [ ] CTA único e contextual?
Resumo executivo (Content & Language)
─────────────────────────────────────────────────
SAR — Content & Language Summary
─────────────────────────────────────────────────
Personality: Consultor sênior brasileiro de vendas B2B
(Confiável · Especialista prático · Decidido ·
Discreto · Aliado)
Tone attributes: Direto · Profissional sem ser frio · Confiante ·
Específico · Empático nos momentos difíceis
Spectrums: Formality 3/5 · Mood 2/5 · Complexity 3/5 · Energy 2/5
(levemente formal, sério-com-leveza, tecnicamente
acessível, energia contida)
Languages: pt-BR only no MVP, arquitetura i18n-ready
(IA generativa sempre em pt-BR com validação)
Localização: BR completo — BRL · DD/MM/AAAA · 24h America/Sao_Paulo ·
CPF/CNPJ/CEP/telefone padrão BR
Top keywords: software de força de vendas · como controlar
representante externo · alternativa ao Mercos ·
como saber clientes inativos · BI vendas com IA
Sitemap: / · /funcionalidades/<cockpit|whatsapp|ia|carteira>
/para/<setor> · /comparativos/<concorrente>
/precos · /recursos/<blog|calculadora|kit>
/cases · /parceiros · /sobre · /contato · /app/
Vocabulário canon: Cliente · Rep · Orçamento · Pedido · Faturado ·
Visita · Carteira · Inativo · Painel · Aprovação
Exclusões: Tutorial agressivo · gamificação gritante ·
chat-com-cliente · marketing email · NF/SPED ·
wallet · CMS blog · mobile-first para outros
─────────────────────────────────────────────────
Próximos passos
- Phase 4 (UX Specs) consome este doc para todo microcopy de cada page
- Phase 6 (Design System) incorpora este doc no guia de microcopy
- Prompts de IA generativa carregam atributos + vocabulário + espectros
- Site marketing (em Phase 4 ou paralelo) segue princípios de Content Structure
Block B encerrado. Próximo: Block C — Visual Direction (Steps 19-26), fast-track via brand.md.