sar/design-artifacts/_progress/00-design-log.md

Design Log

Project: SAR — Força de Vendas Started: 2026-05-26 Method: Whiteport Design Studio (WDS)

---

Backlog

Business-value items. Add links to detail files if needed.

• Complete product brief — Phase 1 (A-Product-Brief/)
• Define trigger map — Phase 2 (B-Trigger-Map/) — 3 personas hipotéticas: rep externo, supervisor, admin
• Create user scenarios — Phase 3 (C-UX-Scenarios/)
• Page specifications — Phase 4 (C-UX-Scenarios/<scenario>/<page>/)
• Design System overlay sobre AntD 6.4 — Phase 6 (D-Design-System/)
• Agentic development — Phase 5 (E-Development/)

---

Current

Task	Started	Agent
Phase 0 setup	2026-05-26	wds-0-project-setup

Rules: Mark what you start. Complete it when done (move to Log). One task at a time per agent.

---

Design Loop Status

Per-page design progress. Updated by agents at every design transition.

Scenario	Step	Page	Status	Updated

Status values: discussed → wireframed → specified → explored → building → built → approved | removed

---

Log

2026-05-26 — Project initialized (Phase 0)

• Type: greenfield
• Complexity: complex (Web Application, SaaS B2B multi-tenant)
• Tech stack: STACK.md JCS v2.2 — React 19.2 + Vite 8 + Ant Design 6.4 / NestJS 11.1 + Prisma 7 + PostgreSQL 18 / Proxmox on-prem
• Existing materials: brand.md, STACK.md, CODING-RULES.md, logos em frontend/img/
• Strategic analysis: full (Phase 2 habilitada)
• Brief level: complete
• Stakes: small-business (JCS Sistemas)
• Active agents: Saga (estratégia), Freya (design)
• Next: skill:wds-1-project-brief com Saga

2026-05-26 — Phase 1 Steps 1, 1a, 2 concluídos

• Step 1 (Init): materiais adicionais identificados — mockup SPA legado (index.html 2251 linhas, 9 telas, login excluído).
• Step 1a (Client Profile): JCS = PME software house 11-50p, tech maturity alta + design iniciante. Julian acumula PO + Tech Lead + único Champion, autonomia total. Cultura fast-individual. SAR é upgrade-de-tier para SaaS web vendável (não conserto de legado).
• Step 2 (Vision): SAR oferece 3 experiências distintas (rep operacional / supervisor tático / dono estratégico+IA). 6 diferenciais explícitos: inteligência de carteira, WhatsApp nativo, metas gamificadas, camadas por papel, IA estratégica, SaaS web distribuível.

2026-05-26 — Phase 1 Step 3 (Positioning) concluído

• Target: Distribuidoras / indústrias / RCAs / PMEs com 5-50 reps externos (sweet spot mid-SMB).
• Dor central: Donos e supervisores decidem no escuro — falta visibilidade em tempo real do que acontece na rua.
• Concorrência: Apps verticais (Mercos/Promosoft/MaxFV/Workforce/Mobits), módulos de ERP (TOTVS/Sankhya/Senior), stack improvisado (Excel+WhatsApp+ERP), apps caseiros.
• Estratégia: Coexistência com ERPs (não migração total) — multi-tenancy BD-por-workspace facilita integração heterogênea. WhatsApp+IA no MVP, não em roadmap.
• Próximo: Step 5 — Business Model.

2026-05-26 — Phase 1 Step 5 (Business Model) concluído

• Modelo: B2B SaaS per-seat, sales-led, trial 14-30 dias, contrato híbrido mensal/anual.
• Ticket médio: R$ 750-7.500/mês (porte pequeno a médio alto).
• Implicações técnicas: active rep counter no produto; provisioning automatizado de workspace para trial; billing suporta cobrança mensal recorrente + anual única; reusa BD-por-workspace (ADR 0006) para sandbox.
• Implicações marketing: CTA "Agende demo", trial gated por SDR, pricing page no site.
• Próximo: Step 6 — Business Customers.

2026-05-26 — Phase 1 Step 6 (Business Customers) concluído

• Buyer persona: "Dono Empresário B2B" — 35-60 anos, sócio-fundador, decide na fé+demo+boca-a-boca.
• Decisão: dono OU diretor comercial. Influenciadores chave: supervisor + reps. Ausentes: financeiro, TI, jurídico (venda operacional-emocional).
• Canais: indicação + SEO + feiras + parceiros (todos os 4 ativos).
• Ciclo: 2-4 semanas (pequeno) → 2-4 meses (médio alto).
• Implicações chave: site precisa 3 páginas por papel, comparativos diretos com concorrentes, demo-friendliness obrigatória, JCS precisa de CRM próprio (possível dogfood).
• Próximo: Step 7 — Target Users (3 user personas: rep / supervisor / dono).

2026-05-26 — Phase 1 Step 7 (Target Users) concluído

• 4 personas confirmados: Rafael (Rep — PRIMÁRIA, mobile-first), Sandra (Supervisora), Daniel (Dono+IA), Alice (Admin — nova) com responsabilidade por campanhas/promoções, pautas e tributação.
• Decisão crítica de design: mobile-first para Rafael, desktop-first para os outros 3. SAR são 2 paradigmas de UI no mesmo produto.
• Diferenciais reforçados: editor de campanhas no-code (Alice), assistente ICMS-ST (Alice), auditoria de pautas (Alice+regulatório), comissão em tempo real (Rafael), IA explicável (Daniel).
• Insight de venda: demo precisa brilhar para Sandra, vender para Daniel, encantar Rafael. Alice é benefício, não argumento.
• Próximo: Step 7a — Product Concept.

2026-05-26 — Phase 1 Step 7a (Product Concept) concluído

• Concept canônico: "SAR é uma 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 sobre o mesmo carro em telemetria real.
• 4 princípios: cada cockpit com UX/device próprios; tempo real (Socket.IO/SSE); WhatsApp+IA como fios horizontais; multi-tenancy BD-por-workspace.
• Tensões aceitas: 4 paradigmas UX vs 1 responsivo; tempo real obrigatório; WhatsApp/IA pilares desde MVP.
• Implicação: Phase 6 (Design System) deixa de ser opcional — tokens compartilhados + variantes por cockpit.
• Próximo: Step 8 — Success Criteria.

2026-05-26 — Phase 1 Step 8 (Success Criteria) concluído

• North star MVP: 1º cliente paga e renova nos primeiros 3 meses após go-live.
• Y1: 10-20 clientes (conservador) · NPS donos > 50 · ARR R$ 200k-600k.
• Timeline: MVP em 3-4 meses → cliente renova em mês 6-7 → 10 clientes pagantes em mês 12.
• Métricas em 4 camadas: negócio JCS · cliente · comportamento usuário · qualidade técnica.
• Implicação: instrumentação de produto (OTel/Grafana/analytics/NPS) no MVP, não em roadmap.
• Próximo: Step 9 — Competitive Landscape.

2026-05-26 — Phase 1 Step 9 (Competitive Landscape) concluído

• 5 grupos analisados: apps verticais (Mercos+), ERPs com módulo (TOTVS+), stack improvisado, apps caseiros, do-nothing (50%+ dos prospects).
• 5 unfair advantages estruturais: 4 cockpits + multi-tenancy BD-por-workspace + stack moderna + IA estrutural + velocidade JCS.
• Posição alvo: vendas-first + baixo atrito de implantação.
• Estratégia de venda: demo ataca do-nothing primeiro (urgência), coexistência com ERPs para Grupo 2.
• Janela de mercado: 2-3 anos para entrincheirar; velocidade MVP é decisão estratégica.
• Próximo: Step 10 — Constraints.

2026-05-26 — Phase 1 Step 10 (Constraints) concluído

• Tensão estratégica flagueada: concept ambicioso + 3-4 meses + solo founder mode não comportam concept completo no MVP.
• Resolução proposta: MVP mínimo defensível = Rafael + Sandra completos + Daniel/Alice simplificados + WhatsApp básico (sem IA). IA + editor no-code entram pós-MVP.
• Premissa: 1º cliente é referência/parceiro, aceita limitações; quando renova, Julian contrata 1-2 devs e completa.
• Constraints fixos: STACK.md v2.2, brand.md, LGPD by design, Proxmox on-prem BR, multi-tenancy BD-por-workspace.
• Flexível: providers (pagamento, IA, WhatsApp), analytics, dark mode.
• Próximo: Step 10a — Platform Strategy.

2026-05-26 — Phase 1 Step 10a (Platform Strategy) concluído

• Plataforma primária: Web SaaS (React SPA + Cloudflare + Nginx).
• Rafael: PWA mobile-first com foco iOS (Android continua com app legado por enquanto).
• Sandra: Desktop + PWA mobile-light.
• Daniel: Desktop + iPad first-class.
• Alice: Desktop-only.
• Coexistência: Android legado intocado no MVP; pós-MVP adapta para consumir backend SAR; futuro avalia native iOS+Android sobre SAR.
• Offline: Read + Write com sync (IndexedDB + Service Worker) para Rafael.
• Native features MVP: Geolocation, Web Push, Share API, Notification API. Camera/File API pós-MVP.
• Acessibilidade: WCAG AA desde MVP.
• Próximo: Step 11 — Tone of Voice.

2026-05-26 — Phase 1 Step 11 (Tone of Voice) concluído

• 5 atributos canônicos: Direto · Profissional sem ser frio · Confiante · Específico · Empático nos momentos difíceis.
• Variações por cockpit: Rafael (informal/curto), Sandra (decisivo), Daniel (executivo), Alice (técnico-preciso).
• Vocabulário canônico: Cliente · Rep · Orçamento · Pedido · Faturado · Visita · Carteira · Inativo · Painel · Aprovação.
• Don'ts: emoji em produção, caps lock erros, burocratês, anglicismos desnecessários, frases dúbias.
• Implicação: vocabulário vira tokens i18n; Phase 6 inclui guia microcopy; prompt de IA generativa precisa carregar atributos + vocabulário.
• Próximo: Step 12 — Create Product Brief (consolidação dos Steps 1-11 num documento canônico).

2026-05-26 — Phase 1 BLOCK A (Product Brief) CONCLUÍDO ✅

• Brief canônico gerado: design-artifacts/A-Product-Brief/01-product-brief.md
• 14 steps concluídos (1, 1a, 2, 3, 5, 6, 7, 7a, 8, 9, 10, 10a, 11, 12)
• Tempo decorrido: ~2-3h em uma sessão
• Confirmação: narrativa estratégica apresentada e confirmada sem ajustes
• Próximo: Block B (Content & Language) — Steps 13-18.

2026-05-27 — Phase 1 BLOCK B (Content & Language) CONCLUÍDO ✅

• Documento canônico gerado: design-artifacts/A-Product-Brief/02-content-language.md
• 7 steps concluídos (13, 14, 15, 16, 17, 17a, 18)
• Personality: "Consultor sênior brasileiro de vendas B2B" (5 atributos)
• Tone spectrums: Formality 3 · Mood 2 · Complexity 3 · Energy 2
• Languages: pt-BR only no MVP, i18n-ready
• SEO: 6 intents de keywords · sitemap robusto · structured data plan · page-keyword map top 10
• Content Structure: 10 princípios site + 11 princípios produto + 8 exclusões explícitas
• Content guidelines: UI/Marketing/Info/Email/WhatsApp/IA + ownership + checklist 13 itens
• Próximo: Block C (Visual Direction) — fast-track via brand.md.

2026-05-27 — Phase 1 Step 19 (Inspiration Workshop) concluído

• 🌟 Insight estratégico: "Não acho nada no mercado de identidade como inspirador — uma das coisas que nos trouxe para esse projeto" → estética moderna é parte do diferencial fundacional do SAR, adicionar como 6º unfair advantage no Brief.
• 4 referências externas: Apple iCloud · Linear · Stripe Dashboard · Notion (todas fora do setor B2B força de vendas BR, propositalmente).
• 7 padrões destilados: sidebar fixa + tipografia hierarquia + único accent JCS + densidade respirável + animações sutis + dark mode + empty states informativos.
• Referências por cockpit mapeadas para alimentar Phase 4.
• Próximo: Step 20 — Visual Init.

2026-05-27 — Phase 1 BLOCK C (Visual Direction) CONCLUÍDO ✅

• Documento canônico: design-artifacts/A-Product-Brief/03-visual-direction.md
• 8 steps concluídos (19, 20, 21, 22, 23, 24, 25, 26)
• Insight estratégico: estética moderna é parte do diferencial fundacional do SAR (6º unfair advantage)
• Visual DNA: Modern Flat + Minimal · JCS Blue mono + accents · Plus Jakarta Geometric Humanist · Clean/Confident/Specific/Serene/Modern · split hero + cockpits diferenciados · effects sutis · screenshots-only Apple-style
• Próximo: Block D (Platform Requirements) — fast-track via STACK.md.

2026-05-27 — Phase 1 BLOCK D (Platform Requirements) CONCLUÍDO ✅

• Documento canônico: design-artifacts/A-Product-Brief/04-platform-requirements.md
• 6 steps concluídos (27, 28, 29, 30, 31, 32) — batched após Step 27
• Tech Stack: espelho de STACK.md v2.2 (Node 24 + Nest 11 + Prisma 7 + React 19 + AntD 6.4 + multi-tenant BD-por-workspace ADR 0006 + Proxmox on-prem ADR 0004)
• Integrações fechadas: Iugu (pagamento) · Meta Cloud API oficial (WhatsApp) · PostHog self-host (analytics)
• Integração ABERTA: IA generativa — abstração multi-provider (Vercel AI SDK/LiteLLM) com default temporário Anthropic Claude
• Contact strategy: Form de demo como único CTA; sem chat ao vivo no MVP
• Multilingual: pt-BR only, i18n-ready · Lighthouse > 90 como CI gate
• Maintenance: solo founder mode até 1º cliente
• Próximo: Block E (Wrap-up) — Steps 33-36.

2026-05-27 — Phase 1 BLOCK E (Wrap-up) CONCLUÍDO ✅ — PHASE 1 INTEIRA COMPLETA 🎉

Steps concluídos: 33 (Analyze), 34 (Summary), 35 (Update Design Log), 36 (Provide Activation Phase 2).

Handover document: design-artifacts/A-Product-Brief/00-handover-summary.md

Artefatos canônicos finais (todos em design-artifacts/A-Product-Brief/):

• 00-handover-summary.md ⭐ entrada para Phase 2
• 01-product-brief.md ⭐ brief estratégico (Block A)
• 02-content-language.md (Block B)
• 03-visual-direction.md (Block C)
• 04-platform-requirements.md (Block D)
• dialog/ (16 documentos de histórico detalhado)

Tempo total Phase 1: ~6-8 horas em 2 dias (2026-05-26 + 2026-05-27).

Steps completados: 36/36 ✅

Decisões abertas conscientemente:

• Provider de IA generativa (resolver pré-feature IA)
• Preço per-seat exato (validar com primeiras vendas)
• Setup fee, add-ons premium, contratações futuras, JCS team photos

Tensão estratégica documentada:

• Solo founder + 3-4 meses + concept ambicioso → MVP minimalista (Rafael+Sandra completos; Daniel+Alice simplificados; IA+editor no-code pós-MVP).

Próximo: Phase 2 — Trigger Mapping (skill wds-2-trigger-mapping com Saga). 5 workshops sequenciais. Output em design-artifacts/B-Trigger-Map/.

2026-05-27 — Phase 2 (Trigger Mapping) CONCLUÍDA ✅ (Dream mode)

• 7 documentos gerados em design-artifacts/B-Trigger-Map/:
  • 00-trigger-map.md (hub + mermaid diagram + síntese + priorização MVP)
  • 01-business-goals.md (5 BGs refinados do Brief)
  • personas/02-rafael-representante.md (PRIMARY MVP)
  • personas/03-sandra-supervisora.md (influenciadora compra)
  • personas/04-daniel-dono.md (IA + buyer overlap)
  • personas/05-alice-admin.md (operacional)
  • 06-feature-impact-analysis.md (matrix Features × Forças × Personas)
• Session log: _progress/agent-experiences/2026-05-27-trigger-map-D.md
• Modo: Dream (autonomous) com self-review
• Tempo total: ~15-20 min de geração
• 5 business goals canônicos: BG-1 PMF · BG-2 Referenciabilidade · BG-3 Modernidade · BG-4 Coexistência ERPs · BG-5 Fundação técnica
• Driving forces por persona: 5-7 por persona, mix positivo+negativo, scored Freq×Int×Fit
• Tensões críticas resolvidas: R-7↔S+6 (vigia↔talento) · D+4↔D-6 (IA↔black-box) · Sandra ops↔Daniel estratégico · concept↔solo founder
• Priorização MVP fechada: P0 (lançamento offline, multi-tenant, real-time, 0 pedidos perdidos) → MVP core → MVP-light → pós-MVP
• Próximo: Phase 3 — UX Scenarios (skill wds-3-scenarios).

2026-05-27 — Phase 3 pausada em Step 2 (decisão estratégica de paralelizar com setup)

• Step 1+2 concluídos: site type = Mixed, 65 páginas inventariadas, 7 scenarios MVP aprovados (Marketing→Demo · Trial Onboarding · 4 cockpits · Cross-cockpit Real-Time Flow)
• Decisão pragmática (escolha Julian): pausar detalhamento dos outlines em Phase 3 e começar setup do monorepo HOJE em paralelo. Phase 4 page specs serão feitas just-in-time por feature, junto com o PR de implementação.
• Outlines Phase 3 detalhados (Steps 5+): retomar quando primeiro cockpit precisar ser implementado.
• Próximo: Setup do monorepo SAR — pnpm + Nx + Nest + Prisma + Vite + React + Docker Compose + git Gitea.

2026-05-27 — Setup do monorepo SAR CONCLUÍDO ✅ (Fases 1-9)

• Commit inicial: 17c08e6 chore: initial monorepo scaffold + WDS Phase 1+2 artifacts (3.631 arquivos, local, sem push)
• Stack ativa: pnpm 11.1.0 · Node 24.15.0 · Nx 22.7.4 · TypeScript 5.9.3 · Prettier 3.8.3
• 5 projetos Nx: api · api-e2e · web · web-e2e · api-interface
• Build geral: ✅ todos os 3 projetos buildáveis passam
• Docker Compose dev criado (Postgres 18 · Valkey 8 · MinIO · Mailpit) — não iniciado ainda
• .env.example template completo com todas as variáveis críticas
• README.md + AGENTS.md criados como entrada para devs/agentes
• Git remote: https://git.jcsinformatica.com.br/Julian/sar configurado (push diferido)
• Próximos passos sugeridos:
  1. Criar repo no Gitea e fazer push (git push -u origin main)
  2. Subir Docker Compose dev (pnpm dev:up)
  3. Implementar master-login stub (auth real virá depois)
  4. Implementar multi-tenant BD-por-workspace via Prisma factory + cls
  5. Primeira tela viva: login + painel Rafael (vazio)

---

About This Folder

• This file — Single source of truth for project progress
• agent-experiences/ — Compressed insights from design discussions (dated files)
• wds-project-outline.yaml — Project configuration from Phase 0 setup

Do not modify wds-project-outline.yaml — it is the source of truth for project configuration.