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>
This commit is contained in:
170
design-artifacts/A-Product-Brief/00-handover-summary.md
Normal file
170
design-artifacts/A-Product-Brief/00-handover-summary.md
Normal file
@@ -0,0 +1,170 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user