Files
sar/design-artifacts/A-Product-Brief/00-handover-summary.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

8.0 KiB
Raw Permalink Blame History

Phase 1 Handover Summary — SAR

Phase 1 Status: COMPLETO Última atualização: 2026-05-27 Próxima fase: Phase 2 — Trigger Mapping (Saga) Cliente: JCS Sistemas · PO: Julian


🎯 O essencial em uma página

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.

Product Concept (ideia organizadora)

Plataforma de 4 cockpits especializados (Rep / Supervisor / Dono / Admin) compartilhando um dado único em tempo real, atravessado por WhatsApp nativo e IA contextual. Metáfora: equipe de Fórmula 1 — cada papel tem seu próprio dashboard, mas todos veem o mesmo carro com a mesma telemetria.

Primary Audience (4 user personas)

Persona Device Volume Frustração #1
🟢 PRIMÁRIA Rafael (Representante) Mobile-first PWA iOS 70-90% Cliente esfria sem ele saber
🟡 Sandra (Supervisora) Desktop + mobile 5-15% Reps "somem" no campo
🔵 Daniel (Dono) Desktop + iPad first-class 1-5% Recebe passado, não próximo passo
🟣 Alice (Admin) Desktop-only 1-5% "Promoção exige pedir pro dev"

Buyer persona: "Dono Empresário B2B" — 35-60a, sócio-fundador, gerencia "no peito", critério principal = fé que vai funcionar (não TCO).

Positioning

Para distribuidoras, indústrias, RCAs e PMEs brasileiras com 5-50 representantes externos, que precisam de visibilidade em tempo real do que está acontecendo na rua, o SAR é uma plataforma SaaS de força de vendas com 3 experiências distintas por papel + WhatsApp nativo + inteligência ativa de carteira, instalada em minutos como SaaS web e coexistindo com ERPs existentes em vez de exigir migração.

Key Differentiators (5 estruturais com alto moat)

  1. Concept "4 cockpits" — concorrentes monolíticos precisariam reescrever tudo
  2. Multi-tenancy BD-por-workspace desde dia 0 (ADR 0006)
  3. Stack moderna JCS (Node 24 + Nest 11 + Prisma 7 + React 19)
  4. IA desenhada estruturalmente — não bolt-on
  5. Velocidade de iteração JCS — decisão fast-individual

+ 6º diferencial (Step 19): estética moderna em mercado visualmente medíocre.

Business Model

B2B SaaS multi-tenant, per-seat, sales-led, trial 14-30 dias, contrato híbrido (mensal sem fidelização OU anual prepago -15%).

ARR Y1 projetado: R$ 200k-600k (10-20 clientes).

Success Criteria

North Star MVP: 1º cliente real paga e renova sem cancelar nos primeiros 3 meses pós go-live.

Timeline crítico:

  • MVP em produção com 1º cliente: 3-4 meses (solo founder mode)
  • MVP validado (renovação): mês 6-7
  • 10 clientes pagantes: mês 12

Métricas em 4 camadas definidas (negócio JCS · cliente · comportamento usuário · qualidade técnica).

⚠️ Tensão estratégica flagueada

Concept ambicioso + 3-4 meses + solo founder = matemática não fecha sem MVP minimalista:

  • Rafael (Rep) + Sandra (Supervisora) completos
  • 🟡 Daniel (Dono) dashboard simples; IA estratégica entra pós-MVP
  • 🟡 Alice (Admin) cadastros essenciais; editor no-code de campanhas entra pós-MVP
  • WhatsApp em versão básica (notificações no MVP, conversa bidirecional pós)

📦 Artefatos gerados (todos em design-artifacts/A-Product-Brief/)

Documentos canônicos

Arquivo Conteúdo
00-handover-summary.md Este arquivo — entrada para Phase 2
01-product-brief.md Brief estratégico (Block A — Steps 1-12)
02-content-language.md Tom, personalidade, idioma, SEO, content structure (Block B — Steps 13-18)
03-visual-direction.md Identidade visual, design style, layout, imagery (Block C — Steps 19-26)
04-platform-requirements.md Stack, integrações, contato, multilingual técnico, maintenance (Block D — Steps 27-32)

Diálogos (histórico detalhado de cada decisão)

Arquivo
dialog/00-context.md
dialog/client-profile.md
dialog/vision.md
dialog/positioning.md
dialog/business-model.md
dialog/business-customers.md
dialog/target-users.md
dialog/product-concept.md
dialog/success-criteria.md
dialog/competitive-landscape.md
dialog/constraints.md
dialog/platform-strategy.md
dialog/tone-of-voice.md
dialog/inspiration-analysis.md
dialog/decisions.md (log cronológico)
dialog/progress-tracker.md (status dos 36 steps)

Materiais referenciados (existentes)

Arquivo Onde
brand.md raiz do repo
STACK.md v2.2 raiz do repo
CODING-RULES.md v2.0 raiz do repo
Logos SAR frontend/img/SAR_*.png
Logos JCS design-artifacts/_references/jcs-logo/
Mockup HTML legado design-artifacts/_references/legacy-screens-html/

🔓 Decisões abertas (pendências para resolver depois)

Pendência Resolver quando
Provider de IA generativa (Anthropic / OpenAI / Local / Multi) Antes da feature de IA entrar — Y1+ pós north star MVP
Preço per-seat exato Validar com primeiras vendas (calibrar baseado em R$ 150/rep referência de mercado)
Setup fee / implantação paga (opcional) Quando 5+ clientes mostrarem demanda
Add-ons premium (WhatsApp tier? IA tier?) Pós-validação north star
Domínio definitivo (sarjcs.com.br?) Antes de ir ao ar — verificar disponibilidade
Contratação de 1-2 devs Quando 1º cliente renovar (north star atingida)
JCS team photos para /sobre Quando JCS tiver caixa para photoshoot

🛠️ Conjunto canônico de "regras do SAR" (para todo PR e decisão futura)

Antes de toda feature/PR, verificar:

  1. Atende qual das 4 personas (Rafael/Sandra/Daniel/Alice)? Se nenhuma, não é prioridade MVP.
  2. Reforça "visibilidade em tempo real"? É a promessa-mãe.
  3. Preserva coexistência com ERPs? Multi-tenant BD-por-workspace continua intocado?
  4. Está dentro do range SMB (5-50 reps)? Não cair em features enterprise nem micro.
  5. Respeita tom canônico? 5 atributos (Direto, Profissional sem ser frio, Confiante, Específico, Empático), 5 mood keywords (Clean, Confident, Specific, Serene, Modern), vocabulário canônico (Cliente, Rep, Orçamento, Pedido, Faturado, Visita, Carteira, Inativo, Painel, Aprovação).
  6. Respeita Visual DNA? Modern Flat + Minimal · JCS Blue único accent · Plus Jakarta · effects sutis · screenshots-only.
  7. Não viola STACK.md v2.2? Mudanças exigem RFC em docs/adr/.
  8. Não viola CODING-RULES.md v2.0? Pegadinhas 🔥 PGD-* respeitadas.
  9. LGPD by design? Datacenter BR + isolamento físico + redact em logs.
  10. Solo founder pode entregar? Se quebra o budget, vai pra pós-MVP.

🚀 Próxima fase — Phase 2: Trigger Mapping

Objetivo: Aprofundar driving forces das 4 personas em 5 workshops sequenciais:

  1. Business Goals — refinar os goals do brief
  2. Target Groups — confirmar 4 personas + naming aliterativo (Rafael Representante, Sandra Supervisora, Daniel Dono, Alice Admin)
  3. Driving Forces — motivações positivas + negativas (medos, frustrações) de cada persona
  4. Prioritization — score forças por Frequência × Intensidade × Fit
  5. Feature Impact — mapear features × forças, identificar features de alto impacto

Output esperado: design-artifacts/B-Trigger-Map/ com:

  • 01-business-goals.md
  • 02-rafael-representante.md (e similares para os outros 3)
  • Feature Impact matrix
  • Mermaid diagram conectando goals → personas → forças

Tempo estimado: 2-3 horas (similar a Block A da Phase 1).

Como começar:

  • Skill: wds-2-trigger-mapping
  • Agente: Saga (continua sendo o BA)
  • Comando: /wds-2-trigger-mapping ou simplesmente continuar nesta conversa