# 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