Julian/sar
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
da2f1020d141833edb3f6cd08fdba431b8b98f93
sar/design-artifacts/A-Product-Brief/01-product-brief.md
julian 17c08e6392 chore: initial monorepo scaffold + WDS Phase 1+2 artifacts 
- 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>
2026-05-27 14:34:20 +00:00

18 KiB
Raw Blame History

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

Reference in New Issue View Git Blame Copy Permalink