Files
sar/design-artifacts/B-Trigger-Map/00-trigger-map.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

9.9 KiB
Raw Blame History

Trigger Map: SAR — Força de Vendas

Phase: 2 — Trigger Mapping COMPLETO Created: 2026-05-27 Method: Effect Mapping (Mijo Balic & Ingrid Domingues) adaptado por WDS Agent: Saga · Mode: Dream (autonomous + final review)

Conecta business goals → personas → driving forces → features. Esta é a North Star estratégica que orienta toda decisão de design e priorização nas próximas fases (PRD, UX Specs, Dev).


Documentos deste bloco

Arquivo Conteúdo
00-trigger-map.md (este) Hub + mermaid diagram + síntese
01-business-goals.md 5 business goals refinados do Brief
personas/02-rafael-representante.md PRIMARY — mobile-first, 70-90% volume
personas/03-sandra-supervisora.md SECONDARY alto impacto — influenciadora compra
personas/04-daniel-dono.md SECONDARY alto valor — IA, buyer overlap
personas/05-alice-admin.md TERTIARY operacional — campanhas, pautas
06-feature-impact-analysis.md Matrix Features × Forças × Personas → priorização MVP

North Star

Tornar a JCS Sistemas referência em SaaS de força de vendas no mercado B2B brasileiro através do SAR — posicionando a empresa além da base atual de clientes, com produto moderno, multi-tenant e referenciável.


Mapa Goals → Personas → Forces (mermaid)

graph LR
    NS[North Star<br/>JCS referência em SaaS<br/>força de vendas BR]

    BG1[BG-1 PMF MVP<br/>1º cliente renova em 3m]
    BG2[BG-2 Base referenciável Y1<br/>10-20 clientes pagantes]
    BG3[BG-3 Modernidade visual<br/>setor medíocre, espaço aberto]
    BG4[BG-4 Coexistência ERPs<br/>não migração]
    BG5[BG-5 Fundação para escala<br/>débito técnico zero]

    NS --> BG1
    NS --> BG2
    NS --> BG3
    NS --> BG4
    NS --> BG5

    BG1 --> Rafael
    BG1 --> Sandra
    BG2 --> Daniel
    BG3 --> Mercado[Mercado externo<br/>concorrentes, observadores]
    BG4 --> Daniel
    BG5 --> Julian[Julian + futuros devs]

    Rafael[🟢 Rafael Representante<br/>PRIMARY · 70-90% volume<br/>mobile-first PWA iOS]
    Sandra[🟡 Sandra Supervisora<br/>SECONDARY · influenciadora compra<br/>desktop + mobile-light]
    Daniel[🔵 Daniel Dono<br/>SECONDARY · IA + buyer<br/>desktop + iPad first-class]
    Alice[🟣 Alice Admin<br/>TERTIARY · operacional<br/>desktop-only]

    Rafael --> RForces[Top forces:<br/>R+1 Bater meta · R+2 Clareza carteira<br/>R-4 Comissão mistério · R-5 Lentidão 3G<br/>R-3 Perder pedido P0]
    Sandra --> SForces[Top forces:<br/>S+2 Visibilidade tempo real<br/>S-1 Descobrir tarde · S-2 Aprovação WhatsApp<br/>S-3 Refém planilhas · S-4 Cliente top esfriando]
    Daniel --> DForces[Top forces:<br/>D+1 Insight estratégico · D+2 Dirigir sem operar<br/>D+4 IA segundo cérebro · D-1 Decidir no escuro<br/>D-6 IA black-box]
    Alice --> AForces[Top forces:<br/>A+1 Autonomia sem dev · A+3 Confiança produção<br/>A+4 Trilha auditoria · A-3 ICMS-ST labirinto]

    RForces --> Features
    SForces --> Features
    DForces --> Features
    AForces --> Features

    Features[Features pilares MVP<br/>Lançamento offline · Real-time · Visão 360°<br/>Comissão tempo real · Inativos · WhatsApp notif<br/>Fila aprovações · Watchlist · Pauta versionada]

    classDef goal fill:#e6eff8,stroke:#004a99,stroke-width:2px,color:#004a99
    classDef persona fill:#fff,stroke:#004a99,stroke-width:2px
    classDef forces fill:#f4f7fa,stroke:#718096,stroke-width:1px
    classDef features fill:#e6eff8,stroke:#004a99,stroke-width:3px,color:#004a99,font-weight:bold

    class NS,BG1,BG2,BG3,BG4,BG5 goal
    class Rafael,Sandra,Daniel,Alice,Mercado,Julian persona
    class RForces,SForces,DForces,AForces forces
    class Features features

5 Business Goals (resumo)

# Goal Outcome Métrica north-star
BG-1 PMF do MVP 1º cliente paga + renova em 3m Renovação mês 3 = 100%
BG-2 Base referenciável Y1 10-20 clientes + cases públicos ARR R$ 200k-600k · NPS donos > 50
BG-3 Modernidade visual SAR vira exemplo no setor Menções orgânicas + top 5 SEO
BG-4 Coexistência com ERPs Não migração, integração 30-40% clientes com integração ERP ativa
BG-5 Fundação para escala 0 débito técnico crítico Coverage 70/25/5 · 0 pedidos perdidos

4 Personas (resumo)

Persona Prioridade Device Top force positiva Top force negativa
🟢 Rafael Representante PRIMARY (MVP) Mobile-first PWA iOS R+1 Bater meta (5/5/5) · R+2 Clareza carteira R-3 Perder pedido (P0) · R-4 Comissão mistério
🟡 Sandra Supervisora SECONDARY (alto impacto) Desktop + mobile-light S+2 Visibilidade tempo real (5/5/5) S-1 Descobrir tarde demais · S-2 Aprovação WhatsApp
🔵 Daniel Dono SECONDARY (alto valor) Desktop + iPad first-class D+1 Insight estratégico · D+4 IA segundo cérebro D-1 Decidir no escuro · D-6 IA black-box
🟣 Alice Admin TERTIARY (operacional) Desktop-only A+1 Autonomia sem dev (5/5/5) A-3 ICMS-ST labirinto · A-2 Erro em produção

Forças cruzadas (alta prioridade — atendem 2+ personas)

Force compartilhada Personas Feature pilar
"Cliente top esfria sem ver" Rafael (R-1) · Sandra (S-4) · Daniel (D-4) Alerta IA de inativos + Watchlist
"Tempo real do que está na rua" Rafael (R+2) · Sandra (S+2) · Daniel (D-1) Real-time entre cockpits (Socket.IO)
"Aprovação fora de WhatsApp informal" Rafael (R-6) · Sandra (S-2) Fila de aprovações in-app + push
"Confiança em dados/auditoria" Daniel (D-1) · Alice (A+4) · Sandra (S-5) Auditoria em cada entidade + versionamento de pautas
"Não depender de dev/escritório" Rafael (R+4) · Alice (A+1) Autonomia operacional (alçada local + editor no-code futuro)
"Visibilidade decisória, não passiva" Sandra (S+3) · Daniel (D+1) IA explicável com dado anexo

Tensões críticas resolvidas no design

Tensão Resolução
R-7 (Rafael vigia) ↔ S+6 (Sandra ver talento) SAR mostra outputs, não inputs punitivos. Sem geofencing contínuo, sem % tela ativa pública.
D+4 (Daniel IA) ↔ D-6 (Daniel anti-black-box) IA explicável obrigatória — cada insight tem "por que te digo isso" + dado anexo.
Sandra ops do dia ↔ Daniel estratégico do período Cockpits separados desde dia 1 (RBAC por papel) — mesma fonte, camadas qualitativamente diferentes.
Concept ambicioso ↔ Solo founder MVP 3-4m MVP minimalista — Rafael+Sandra completos, Daniel+Alice simplificados, IA estratégica e editor no-code entram pós-MVP.

Priorização final do MVP

🔴 P0 (absolutos — produto não roda sem)

  • Lançamento offline com sync (PWA + IndexedDB queue + Idempotency-Key)
  • Multi-tenancy BD-por-workspace
  • Auth + RBAC por cockpit
  • Real-time entre cockpits (Socket.IO)
  • 0 pedidos perdidos por bug

🟢 MVP core

  • Visão 360° do cliente
  • Lançamento de pedido < 60s mobile
  • Comissão visível em tempo real
  • Funil de propostas
  • Alertas de inativos
  • Agenda + check-in GPS
  • WhatsApp notif outbound
  • Fila de aprovações com contexto
  • Dashboard "tela do dia" Sandra
  • Dashboard executivo Daniel simplificado (sem IA)
  • Watchlist clientes-chave
  • Cadastros completos (produto/cliente/rep)
  • Pauta com versionamento
  • ICMS-ST manual por UF
  • Auditoria em cada entidade
  • Limite de crédito + bloqueio automático

🟡 MVP-light (existe mas sem brilho — completar pós-MVP)

  • Dashboard Daniel sem IA estratégica (entra pós-MVP)
  • Tela direta de promoção 1 a 1 (editor visual no-code pós-MVP)
  • ICMS-ST manual (assistente IA pós-MVP)
  • WhatsApp apenas outbound (conversa bidirecional pós-MVP)
  • Bulk operations básico (edit em massa pós-MVP)

Pós-MVP / Y1+

  • IA estratégica explicável (DIFERENCIAL DECLARADO — fundamental para Daniel)
  • Editor de campanhas no-code (DIFERENCIAL DECLARADO — fundamental para Alice)
  • Conversa bidirecional WhatsApp + aquecimento de lead
  • Assistente ICMS-ST por NCM+UF
  • Comparativo período + análise de concentração
  • Programa de indicação
  • Adaptação app Android legado
  • Native iOS/Android sobre backend SAR

Quality checklist (Self-review Layer 5 — Dream mode)

  • Personas com naming aliterativo (Rafael Representante, Sandra Supervisora, Daniel Dono, Alice Admin)
  • Cada persona tem 5-7 driving forces (mix positivo+negativo)
  • Forces scored Frequency × Intensity × Fit
  • Top scores destacados por persona
  • Feature Impact mapeia features → forças → personas
  • Mermaid diagram conecta Goals → Personas → Forces → Features
  • Tensões críticas explicitadas e resolvidas
  • Priorização MVP clara (P0 / core / light / pós-MVP)
  • Trace: cada decision tem origem em Phase 1 (Brief)
  • Anti-padrões documentados por persona

Como esse documento é consumido

Fase Como usa
Phase 3 (PRD) Feature Impact Analysis vira backlog priorizado · driving forces viram acceptance criteria
Phase 4 (UX Specs) Personas + driving forces guiam cada page spec ("qual force essa tela resolve?")
Phase 5 (Dev) Tensões e anti-padrões viram code review checklist · P0 vira teste de regressão obrigatório
Phase 6 (Design System) Variantes por cockpit baseadas em personas
Sales & Marketing Buyer persona "Dono Empresário B2B" guia demo · tensões viram material de objection handling

Próximo passo

Phase 3 — Scenarios / PRD (escolher conforme stack metodológica)

Output esperado em design-artifacts/C-UX-Scenarios/: scenarios outline (jornadas dos usuários) + posteriormente page specifications detalhadas.

Tempo estimado: 2-4h.


Trigger Map gerado em Dream mode (autonomous) em 2026-05-27. Self-review aprovado. Pronto para Phase 3.