# 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 personas - **`dialog/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...` - 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 vendas` - `software para representante comercial` · `sistema para representante externo` · `app para vendedor externo` - `SaaS força de vendas` #### 🩺 Problem (leads quentes) - `como controlar representante externo` - `como saber quais clientes pararam de comprar` - `como organizar pedidos de representantes` - `como aprovar desconto vendedor externo` - `como integrar WhatsApp com vendas B2B` - `como acompanhar meta de vendedor` - `como saber se rep está visitando cliente` #### ⚖️ Comparison (fundo de funil) - `alternativa ao Mercos` · `alternativa ao Promosoft` - `Mercos preço` · `Mercos vs MaxFV` · `Promosoft vs Mercos` - `software 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 vendas` - `como funciona representação comercial` - `diferença entre rep e vendedor interno` - `gestão de carteira ativa` - `inteligência artificial em vendas B2B` - `como recuperar cliente inativo` - `KPIs força de vendas` #### 🎯 Long-tail setor-específico - `software para distribuidora de bebidas` - `sistema para indústria de alimentos vendas` - `ERP para representação comercial autônoma RCA` - `gestão de força de vendas para distribuidora alimentícia` - `software para indústria de produtos químicos vendas` ### Domínio **A definir** — opções priorizadas: 1. `sarjcs.com.br` (Recomendado — brandable + JCS-link, requer verificação de disponibilidade) 2. `sar.jcs.com.br` (subdomain — JCS-centric) 3. `sarforcadevendas.com.br` (SEO-rich, longo) 4. `sar.com.br` (curto, premium — verificar disponibilidade) ### Padrão de URL - pt-BR primário: `/` - en futuro (i18n-ready): `/en/` - 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 1. **Hero entrega proposta em <5 segundos** — frase clara + visual + 1 CTA único 2. **Demo em vídeo, não tour interativo** — Daniel assiste, não mexe; 90s com legendas 3. **Prova social pesada** — logos de clientes, depoimentos em vídeo de **donos**, números reais 4. **3 jornadas paralelas para 3 personas** — `/para-donos`, `/para-supervisores`, `/para-representantes` (Alice é benefício, não argumento de venda) 5. **Setores ganham página dedicada** quando há vocabulário próprio (distribuidoras ≠ indústrias ≠ RCAs) 6. **CTA principal único** — "Agende sua demo." (não "saiba mais" + "experimente" + "fale conosco") 7. **Pricing visível, não escondido atrás de form** — faixa per-seat clara; fechamento final via comercial 8. **Comparativos acessíveis, não em destaque** — `/comparativos/` para quem já compara 9. **Conteúdo SEO no `/recursos/`** separado do pitch 10. **Cases reais publicáveis** tornam-se peça central quando há 3+ clientes pagantes ### 🖥️ Produto (4 cockpits) 1. **Cada cockpit tem sua home dedicada** — Rafael → painel rep, Sandra → "apertar parafusos", Daniel → IA insights + faturamento, Alice → fila cadastros + campanhas 2. **Hierarquia por urgência, não categoria** — primeira tela mostra decisões de HOJE 3. **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 4. **Profundidade máxima 3 níveis** (Rafael se perde se for mais fundo no celular) 5. **WhatsApp e IA não vivem em sub-menu** — diferenciais declarados estão no caminho principal de cada cockpit 6. **Empty states informativos**, não placeholders 7. **Notificações in-app + push** apenas para decisão (não para "pedido visualizado") 8. **Tempo real visível** com micro-animação suave (não toast intrusivo) 9. **Configurações fora do caminho principal** — Alice tem sua área (`/admin`) 10. **Auditoria onde faz sentido** — histórico em cada entidade (pauta, produto, rep, pedido) 11. **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ão `Salvar.`) - **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/ /para/ · /comparativos/ /precos · /recursos/ /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.**