- 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>
8.0 KiB
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)
- Concept "4 cockpits" — concorrentes monolíticos precisariam reescrever tudo
- Multi-tenancy BD-por-workspace desde dia 0 (ADR 0006)
- Stack moderna JCS (Node 24 + Nest 11 + Prisma 7 + React 19)
- IA desenhada estruturalmente — não bolt-on
- 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:
- Atende qual das 4 personas (Rafael/Sandra/Daniel/Alice)? Se nenhuma, não é prioridade MVP.
- Reforça "visibilidade em tempo real"? É a promessa-mãe.
- Preserva coexistência com ERPs? Multi-tenant BD-por-workspace continua intocado?
- Está dentro do range SMB (5-50 reps)? Não cair em features enterprise nem micro.
- 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).
- Respeita Visual DNA? Modern Flat + Minimal · JCS Blue único accent · Plus Jakarta · effects sutis · screenshots-only.
- Não viola STACK.md v2.2? Mudanças exigem RFC em
docs/adr/. - Não viola CODING-RULES.md v2.0? Pegadinhas 🔥 PGD-* respeitadas.
- LGPD by design? Datacenter BR + isolamento físico + redact em logs.
- 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:
- Business Goals — refinar os goals do brief
- Target Groups — confirmar 4 personas + naming aliterativo (Rafael Representante, Sandra Supervisora, Daniel Dono, Alice Admin)
- Driving Forces — motivações positivas + negativas (medos, frustrações) de cada persona
- Prioritization — score forças por Frequência × Intensidade × Fit
- Feature Impact — mapear features × forças, identificar features de alto impacto
Output esperado: design-artifacts/B-Trigger-Map/ com:
01-business-goals.md02-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-mappingou simplesmente continuar nesta conversa