sar/design-artifacts/A-Product-Brief/02-content-language.md

# 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.<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 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: `<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

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/<x>` 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/<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.**