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>

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

@@ -0,0 +1,245 @@
+# 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.
+
+---
+
+## 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.