sar/design-artifacts/A-Product-Brief/01-product-brief.md

# Product Brief: SAR — Força de Vendas

**Cliente:** JCS Sistemas
**Status:** Product Brief completo (Block A da Phase 1 WDS)
**Versão:** 1.0
**Última atualização:** 2026-05-26
**Próximo:** Block B (Content & Language) → Block C (Visual Direction) → Block D (Platform Requirements) → Phase 2 (Trigger Mapping)

---

## Resumo estratégico

O **SAR** é a primeira plataforma SaaS web da **JCS Sistemas**, sucessora dos produtos legados Android (força de vendas) e Desktop (ERP) num upgrade-de-tier que unifica força de vendas e ERP num único produto distribuível. Mais que produto, o SAR é a **vitrine** que posiciona a JCS como fornecedora de SaaS moderno no mercado B2B brasileiro.

A ideia organizadora não é "produto único com RBAC". É uma **plataforma de quatro cockpits especializados** — Rep, Supervisor, Dono e Admin — compartilhando uma camada de dados em tempo real, atravessada por WhatsApp nativo e IA contextual. Como uma equipe de Fórmula 1: cada papel tem seu próprio dashboard, mas todos veem o mesmo carro com a mesma telemetria.

O target é PME brasileira (distribuidora, indústria, RCA ou PME com vendas externas) com **5-50 representantes na rua**. A dor central que motiva a compra: **donos e supervisores decidem no escuro** — 5-10% da carteira esfria silenciosamente e ninguém vê. A alternativa mais comum não é Mercos ou TOTVS, é **não fazer nada** (Excel + WhatsApp + ERP sem módulo). O choque "olha o que você está perdendo silenciosamente" vence mais leads que qualquer comparativo direto.

---

## Vision

> SAR é a plataforma de força de vendas que dá clareza para o representante, ferramenta de decisão para o supervisor, e IA estratégica para o dono — entregue como SaaS web, vendável e escalável, posicionando a JCS Sistemas como fornecedora de software moderno para o mercado B2B brasileiro.

### Três experiências distintas no mesmo produto

- **Representante:** clareza absoluta da carteira (quanto, pra quem, status), metas expostas e atingíveis, WhatsApp integrado, inteligência de carteira (inativos, ciclo, oportunidades).
- **Supervisor:** "telas que apertam parafusos todos os dias" — instrumentos de ação tática diária, não dashboards contemplativos.
- **Dono:** análise estratégica com IA proativa — não relatórios passivos, mas insights que dizem onde olhar e por quê.

### Sete diferenciais explícitos

1. Inteligência de carteira ativa (inativos, ciclo, oportunidades)
2. WhatsApp como canal nativo (não anexo)
3. Metas como gamificação operacional
4. Três experiências distintas por papel (pilar de marca)
5. IA estratégica para o dono (não decorativa)
6. SaaS web distribuível (vs. legado instalável)
7. Facilidade de implantação JCS-side

---

## Positioning

**Para** distribuidoras, indústrias e escritórios de representação brasileiros com 5-50 representantes externos,

**que precisam** de visibilidade em tempo real do que está acontecendo na rua para decidir com dados em vez de no escuro,

**o SAR é** uma plataforma SaaS de força de vendas que entrega **três experiências distintas no mesmo produto** — clareza operacional para o rep, instrumentos de decisão para o supervisor, IA estratégica para o dono — com WhatsApp como canal nativo e inteligência ativa de carteira.

**Diferente de** apps verticais como Mercos e Promosoft (que tratam todos os usuários igual e não têm IA estratégica), módulos de força de vendas de ERPs como TOTVS e Sankhya (burocráticos, caros e desconectados do mobile), e do stack improvisado de planilha+WhatsApp+ERP (que não dá visibilidade nenhuma),

**o SAR** é instalado em minutos como SaaS web, com camadas IA-first sobre cada papel — e **coexiste com ERPs existentes em vez de exigir migração total**.

### Mapa estratégico (posição alvo)

```
                    Alto custo de implantação
                              ▲
                              │
              TOTVS  ●        │
              Sankhya         │       ● Apps caseiros
                              │
   ◄─────────────────────────┼─────────────────────────►
   ERP-first                  │              Vendas-first
                              │
                              │   ● Mercos
              ● SAR           │   ● Promosoft
              (vendas-first   │
              + low-friction) │   ● Excel + WhatsApp
                              ▼
                    Baixo custo de implantação
```

---

## Target Users — 4 personas

> **Persona primária do MVP:** Rafael (Representante). 70-90% do volume de uso. SAR ganha ou perde aqui.

### 🟢 Rafael — Representante (PRIMÁRIA)

- **Quem:** 30-50a, vendedor B2B externo, comissionado, atende 50-200 clientes ativos
- **Onde:** no carro, no posto, no fundo da loja — **mobile-first via PWA iOS**
- **Frustração #1:** cliente esfria sem ele saber
- **Goal:** bater meta sempre
- **Device:** mobile (PWA)

### 🟡 Sandra — Supervisora

- **Quem:** 35-55a, gerente comercial, coordena 5-30 reps
- **Onde:** escritório, desktop o dia todo
- **Frustração #1:** reps "somem" no campo, aprovação vira fila de WhatsApp
- **Goal:** time bate meta + dormir tranquila
- **Device:** desktop + PWA mobile-light para consultas rápidas

### 🔵 Daniel — Dono / Diretor Comercial

- **Quem:** 40-65a, sócio-fundador, decide investimentos
- **Onde:** desktop/notebook + **iPad first-class** (uso noturno em casa)
- **Frustração #1:** dashboards mostram passado, não próximo passo
- **Goal:** dirigir sem operar — confiar no time + IA que avisa quando algo desvia
- **Device:** desktop/iPad (visualização-first)

### 🟣 Alice — Administradora / Backoffice

- **Quem:** 25-45a, funcionária administrativa do cliente
- **Onde:** escritório, desktop o dia todo
- **Responsabilidade:** cadastros, pautas, **campanhas de desconto/promoções no-code**, tributação ICMS-ST, gestão de reps
- **Frustração #1:** "promoção exige pedir pro dev"
- **Goal:** lançar campanha sozinha, manter catálogo+tributação sem incidente
- **Device:** desktop-only

### Buyer × User mapping

- **Decisor (Dono ou Diretor Comercial):** overlap alto com Daniel; quem assina contrato
- **Influenciadores que matam o deal:** Sandra (sempre) + Rafael (champion interno se já conheceu o SAR)
- **Ausentes da decisão de compra:** financeiro, TI, jurídico — venda é operacional-emocional, não técnica-financeira

---

## Business Model

**B2B SaaS multi-tenant, per-seat, sales-led, com trial real.**

| Componente | Decisão |
|---|---|
| Cobrança | **Per-seat** (por representante ativo/mês) |
| Vendas | **Sales-led** — demo + proposta + acompanhamento comercial |
| Trial | **14-30 dias** com dados reais (workspace sandbox provisionado) |
| Contrato | Cliente escolhe: **mensal sem fidelização** (full price) **ou** **anual prepago** (-10-20%) |

### Ticket médio estimado (preliminar, R$ 150/rep referência)

| Porte cliente | Reps | Mensal estimado | ARR |
|---|---|---|---|
| Pequeno | 5-10 | R$ 750-1.500 | R$ 9k-18k |
| Médio baixo | 11-25 | R$ 1.650-3.750 | R$ 20k-45k |
| Médio alto | 26-50 | R$ 3.900-7.500 | R$ 47k-90k |

### Buyer persona — "O Dono Empresário B2B"

35-60a, sócio-fundador ou herdeiro de negócio familiar, gerencia "no peito". Critério de avaliação principal: **fé que vai funcionar**, não TCO planilhado. Convence-se com: demo concreta + boca-a-boca + cases. Assusta-se com: "meu pessoal não vai aprender" + "mais um sistema" + "é caro pra valer?".

### Canais de aquisição (todos os 4 ativos)

1. **Indicação boca-a-boca** (canal #1; alimentado por referência forte do primeiro grupo de clientes)
2. **Google / SEO + content marketing**
3. **Eventos / feiras setoriais** (APAS, Fispal, Anamaco, etc.)
4. **Parceiros** (contadores, revendedores ERP, consultorias)

### Ciclo de vendas por porte

- **Pequeno (5-10 reps):** 2-4 semanas — dono decide, demo curta, fechamento rápido
- **Médio baixo (11-25):** 1-2 meses — dono + supervisor avaliam, comparam com 1-2 concorrentes
- **Médio alto (26-50):** 2-4 meses — avaliação mais formal, possível POC

---

## Success Criteria

### North Star do MVP

> **1º cliente real paga e renova sem cancelar nos primeiros 3 meses após go-live.**

Retenção provada > tração massiva. Prova que o produto entrega valor sustentado.

### Marcos timeline

| Marco | Quando | Critério de aceite |
|---|---|---|
| MVP em produção com 1º cliente real | **3-4 meses** | Cliente assinou contrato pago, usando os 4 cockpits |
| MVP validado | + 3 meses (mês 6-7) | 1º cliente renovou → north star atingida |
| 10 clientes pagantes | mês 12 | Conservador Y1 |
| 20 clientes pagantes | mês 16-18 | Esticado Y1+ |

### Métricas em 4 camadas

**A. Negócio JCS:** logo churn < 3%/mês · NPS donos > 50 · CAC payback < 12m · NRR > 110% · ARR Y1 R$ 200k-600k

**B. Cliente:** +15-30% pedidos/rep/mês vs baseline · 10-20% inativos recuperados via alerta IA · tempo médio aprovação desconto < 30 min · % reps ativos > 80% · NPS reps > 30

**C. Comportamento usuário:**
- Rafael: > 95% pedidos no SAR · pedido < 60s · DAU/MAU > 70%
- Sandra: > 90% aprovações via SAR · acessa tela do dia > 80% dos dias úteis
- Daniel: IA insights > 2x/semana
- Alice: > 80% campanhas no-code sem suporte

**D. Qualidade técnica:** p95 tela < 800ms · p95 pedido end-to-end < 60s · uptime 99.5% · tickets resolvidos < 4h em > 80% · **pedidos perdidos = 0** (P0 imediato)

---

## Competitive Landscape

### Cinco alternativas (incluindo do-nothing)

1. **Apps verticais** (Mercos, Promosoft, MaxFV, Workforce, Mobits) — SAR ataca via 4 cockpits + IA + WhatsApp nativo + UX moderna
2. **ERPs com módulo** (TOTVS, Sankhya, Senior, Bling, Tiny, Omie) — SAR ataca via **coexistência via API** (não migração do ERP)
3. **Stack improvisado** (Excel + WhatsApp + ERP sem módulo) — SAR ataca via "primeira ferramenta de verdade"
4. **Apps caseiros** (dev terceirizado) — SAR ataca via "fim do pesadelo de manutenção, roadmap contínuo"
5. **Do nothing** (50%+ dos prospects) — SAR ataca via choque "5-10% da carteira/ano perdida silenciosamente"

### Cinco unfair advantages estruturais (alto moat, > 2 anos para neutralizar)

1. **Concept estrutural "4 cockpits"** — concorrentes monolíticos precisariam reescrever tudo
2. **Multi-tenancy BD-por-workspace desde dia 0** (ADR 0006) — não retrofit
3. **Stack moderna JCS** (Node 24 + Nest 11 + Prisma 7 + React 19.2) — ~3x mais rápida que legados PHP/Java/Delphi
4. **IA desenhada estruturalmente** — não bolt-on
5. **Velocidade de iteração JCS** (decisão fast-individual) — itera mensalmente; concorrentes corporates anualmente

### Vantagens não-sustentáveis (copiáveis em 6-24 meses)

WhatsApp nativo, editor no-code, UX moderna por papel, real-time entre cockpits. **A defesa real é a combinação estrutural dos 5 itens acima**, não feature individual.

### Janela de mercado

**2-3 anos para entrincheirar** antes de saturação SaaS força de vendas BR. Velocidade do MVP é decisão estratégica, não apenas operacional.

---

## Constraints & Context

### ⚠️ Tensão estratégica explícita

Concept ambicioso + MVP 3-4 meses + **solo founder mode** (Julian acumula PO + Tech Lead + único Champion + único dev até 1º cliente) = **a matemática não fecha sem trade-off**.

### Resolução proposta — MVP mínimo defensível

- ✅ **Rafael cockpit** (Rep — primária, mobile-first) — obrigatório
- ✅ **Sandra cockpit** (simplificado) — obrigatório
- ✅ **Arquitetura multi-tenant BD-por-workspace** — fundacional
- ✅ **WhatsApp** — versão básica (notificações; conversa bidirecional pós-MVP)
- 🟡 **Daniel cockpit** — dashboard simples; **IA estratégica entra pós-MVP**
- 🟡 **Alice cockpit** — cadastros essenciais; **editor no-code de campanhas entra pós-MVP**

**Premissa:** 1º cliente é referência interna ou parceiro próximo, aceita limitações em troca de condições especiais. Quando o cliente renova (north star atingida), Julian contrata 1-2 devs e completa IA + editor no-code + cockpits ricos.

### Plataforma & device strategy

| Cockpit | Plataforma |
|---|---|
| 🟢 Rafael | **PWA mobile-first foco iOS** (Android continua com app legado por enquanto) |
| 🟡 Sandra | Desktop + PWA mobile-light |
| 🔵 Daniel | Desktop + **iPad first-class** (otimização dedicada) |
| 🟣 Alice | Desktop-only |

### Offline strategy (Rafael)

**Read + Write com sync** — IndexedDB queue + Service Worker. Lançamento de pedido offline → sincroniza quando volta sinal. Idempotency-Key local protege contra duplicação.

### Native features no MVP

✅ Geolocation (check-in) · Web Push (Sandra: aprovação; Rafael: pedido aprovado) · Share API (compartilhar via WhatsApp do celular) · Notification API desktop. **Camera e File System Access entram pós-MVP.**

### Coexistência com app Android legado

- **MVP:** SAR PWA + backend SAR construídos. Android legado intocado.
- **Pós-MVP (Y1+):** App Android legado é adaptado para consumir backend SAR.
- **Futuro (Y1-Y2):** Avaliar native iOS + native Android sobre backend SAR.

### Stack canon JCS v2.2 (fonte da verdade)

Node 24 LTS · pnpm 11.1 · TypeScript 5.9 · Nx 22.7 · NestJS 11.1 · Prisma 7 · PostgreSQL 18 · React 19.2 + Vite 8 · Ant Design 6.4 · TanStack Query/Router · Zustand · Zod 4 · master-login (IdP próprio) · jose · argon2id · BullMQ 5.77 · Socket.IO 4 + SSE · MinIO · Vault · OpenTelemetry + Pino · Resend · Proxmox on-prem BR · Docker Compose · Ansible deploy · Cloudflare + Nginx.

**Decisões abertas (Step 29):** provider de pagamento, provider de IA, WhatsApp Business API provider, analytics de produto.

### Brand canon (brand.md)

Paleta JCS Blue `#004a99` · Plus Jakarta Sans (400-800) · Font Awesome 6.4 · Chart.js · Radius 12/20px · Sombra `0 4px 25px rgba(0,0,0,0.05)` · Topbar 80px + Sidebar 260px · Tom visual Apple-inspired clean. Dark mode desejável (Rafael uso noturno).

### LGPD by design (STACK.md §22)

Isolamento físico cluster PG por workspace · datacenter BR (sem CLOUD Act US) · PII criptografada (MinIO SSE + pgcrypto) · redact em logs · Art. 18 implementado · DPA com Meta/OpenAI obrigatório · hashar dados antes de enviar para IA · opt-in explícito do contato final no WhatsApp.

---

## Tone of Voice

### Cinco atributos canônicos

1. **Direto** — sem floreio
2. **Profissional sem ser frio** — sério, mas humano (não burocratês)
3. **Confiante** — afirmativo, não tentativo
4. **Específico** — números/dados sempre que possível
5. **Empático nos momentos difíceis** — explica problema + caminho

### Variações por cockpit (mesmos atributos, registros distintos)

- **Rafael:** mais informal, frases curtas, foco em ação ("Sem sinal. Envio depois.")
- **Sandra:** direto + decisivo, contexto rápido ("3 aprovações pendentes.")
- **Daniel:** executivo, foco em insight ("Faturamento +18% vs mês anterior.")
- **Alice:** técnico-preciso, mas humano ("Pauta atualizada. 1.247 produtos afetados.")

### Vocabulário canônico (padrão único)

**Cliente** · **Representante / Rep** · **Orçamento** · **Pedido** · **Faturado** · **Visita** · **Carteira** · **Inativo** · **Painel** · **Aprovação**

### Don'ts

❌ Emoji em produção · caps lock para erros · burocratês ("operação", "registro", "movimentação") · "Por favor"/"obrigado" excessivos · trocadilhos/gírias · anglicismos desnecessários · frases dúbias ("Talvez", "Possivelmente")

---

## Riscos e mitigações

| Risco | Detecção | Mitigação |
|---|---|---|
| Rafael não adota | DAU/MAU < 50% em 60 dias | Revisão UX mobile-first; possível pivot de interação |
| Sandra não confia | Aprovações via WhatsApp > 30% | Investigação: SAR lenta? Falta contexto? Workflow ruim? |
| Daniel ignora IA | < 1x/semana em IA insights | IA irrelevante / pouco visível / black box demais |
| North star falha | Cliente cancela em 3 meses | Review estrutural do MVP |
| Pedidos perdidos por bug | > 0 incidentes em qualquer janela | P0 imediato — bloqueio de release até root cause |
| WhatsApp/Meta muda regras | Integração quebra | Arquitetura plug-in; Telegram/SMS no roadmap |
| IA não convence donos | NPS Daniel baixo | Manter explicabilidade; possível recuo da IA para feature secundária |
| Solo founder esgotamento | Velocidade caindo | Contratar 1 dev mesmo antes do 1º cliente |

---

## Próximos passos

| Bloco da Phase 1 | Steps | Status | Conteúdo |
|---|---|---|---|
| **A. Product Brief** | 1-12 | ✅ **CONCLUÍDO (este documento)** | Vision · Positioning · Users · Business Model · Success · Competitive · Constraints · Platform · Tone |
| B. Content & Language | 13-18 | ⏳ Próximo | Personality · Tone (refinamento) · Languages · SEO · Content structure |
| C. Visual Direction | 19-26 | Fast-track via brand.md | Design style · Layout · Effects · Imagery |
| D. Platform Requirements | 27-32 | Fast-track via STACK.md | Tech stack · Integrations · Contact strategy · Multilingual |
| E. Wrap-up | 33-36 | Pendente | Analyze · Summary · Design log · Activation Phase 2 |

**Após Phase 1:** Phase 2 — Trigger Mapping (aprofundar driving forces das 4 personas).

---

## Anexos

- **brand.md** — identidade visual JCS
- **STACK.md v2.2** — stack canônica
- **CODING-RULES.md v2.0** — invariantes + pegadinhas
- **design-artifacts/_references/legacy-screens-html/index.html** — mockup SPA do SAR (9 telas)
- **dialog/** — histórico detalhado de cada decisão (client-profile, vision, positioning, business-model, business-customers, target-users, product-concept, success-criteria, competitive-landscape, constraints, platform-strategy, tone-of-voice)

---

_Powered JCS. Sistema SAR — Força de Vendas · Product Brief v1.0_