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>
2026-05-27 14:34:20 +00:00
commit 17c08e6392
3631 changed files with 855518 additions and 0 deletions
--- a/design-artifacts/_progress/00-design-log.md
+++ b/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.
--- a/design-artifacts/_progress/agent-experiences/2026-05-27-trigger-map-D.md
+++ b/design-artifacts/_progress/agent-experiences/2026-05-27-trigger-map-D.md
@@ -0,0 +1,91 @@
+# Session Log — Trigger Mapping (Dream Mode)
+
+**Date:** 2026-05-27
+**Agent:** Saga (BA / Strategic Analyst)
+**Mode:** Dream (D) — autonomous generation + final review
+**Duration target:** 15-25 min
+
+---
+
+## Layer 1: WDS Form (internalizado)
+
+Effect Mapping by Mijo Balic & Ingrid Domingues, adapted by WDS:
+- **WHY:** Business goals (refined from brief)
+- **WHO:** Target groups (alliterative persona names)
+- **WHAT:** Driving forces (positive motivations + negative fears/frustrations)
+- **HOW:** Feature impact (mapping features to forces)
+
+**Quality criteria:**
+- Personas alliterative, behavioral (não demográficas)
+- Driving forces specific, not vague (não "user wants efficiency")
+- Forces scored Frequency × Intensity × Fit
+- Feature impact direct mapping
+- Diagram mermaid Goals → Personas → Forces
+
+**Common mistakes:**
+- Personas demográficos sem comportamento
+- Forces genéricas ("quer mais produtividade")
+- Pular forças negativas (medos, frustrações)
+- Não escorar forças
+- Inventar sem ancorar em discovery
+
+---
+
+## Layer 2: Project Context (Phase 1 destilada)
+
+Disponível em contexto:
+- `01-product-brief.md` — Vision, Positioning, Personas, Business Model, Success, Competitive, Constraints
+- `02-content-language.md` — Tom, vocabulário canônico
+- `03-visual-direction.md` — Visual DNA
+- `04-platform-requirements.md` — Stack, integrações
+- `dialog/*` — 16 docs de histórico detalhado
+
+**4 personas confirmadas:**
+- Rafael Representante (PRIMARY) — mobile-first, 70-90% volume
+- Sandra Supervisora — desktop+mobile, influenciadora-chave da compra
+- Daniel Dono — desktop/iPad, IA estratégica, overlap buyer persona
+- Alice Admin — desktop-only, campanhas no-code
+
+**Concept canônico:** "4 cockpits especializados sobre dado único em tempo real, atravessado por WhatsApp nativo e IA contextual"
+
+**Positioning:** target 5-50 reps · dor "decide no escuro" · coexistência com ERPs.
+
+---
+
+## Layer 3: Domain Research (skipped — Phase 1 já cobre extensivamente)
+
+Domain conhecido:
+- Mercado B2B força de vendas BR (concorrentes Mercos/Promosoft/MaxFV/Workforce/Mobits)
+- ERPs com módulo (TOTVS/Sankhya/Senior/Bling/Tiny/Omie)
+- Realidade do rep externo BR (carro, 3G, comissão pesa no salário)
+- Estrutura típica PME 5-50 reps (dono decide, supervisor influencia, financeiro/TI ausentes)
+- Dor "decide no escuro" validada com Julian
+- LGPD constraints
+- Setor visual medíocre (insight Step 19)
+
+Web search seria redundante — basear em context destilado.
+
+---
+
+## Layer 4: Generate (executando)
+
+Outputs em `design-artifacts/B-Trigger-Map/`:
+- `01-business-goals.md`
+- `personas/02-rafael-representante.md`
+- `personas/03-sandra-supervisora.md`
+- `personas/04-daniel-dono.md`
+- `personas/05-alice-admin.md`
+- `06-feature-impact-analysis.md`
+- `00-trigger-map.md` (hub + mermaid)
+
+---
+
+## Layer 5: Self-Review (pós-generation)
+
+A executar após assembly completo. Verificar:
+- [ ] Goals refinados, não copiados do brief
+- [ ] Personas com 5-7 driving forces cada (mix positivo+negativo)
+- [ ] Forces scored Freq×Int×Fit
+- [ ] Feature impact matrix completa
+- [ ] Diagram mermaid coerente
+- [ ] Trace: cada decision desta Phase 2 tem origem em Phase 1
--- a/design-artifacts/_progress/wds-project-outline.yaml
+++ b/design-artifacts/_progress/wds-project-outline.yaml
@@ -0,0 +1,121 @@
+# WDS Project Outline — SAR
+# Generated by skill:wds-0-project-setup on 2026-05-26
+# DO NOT MODIFY — source of truth for project configuration
+
+project:
+  name: SAR
+  full_name: "SAR — Força de Vendas"
+  company: JCS Sistemas
+  type: greenfield
+  product_complexity: complex
+  product_kind: web-application
+  created: 2026-05-26
+  language: pt-BR
+
+tech:
+  stack: react
+  stack_reference: STACK.md  # canon JCS v2.2 (2026-05-24)
+  details:
+    runtime: Node 24 LTS · pnpm 11.1 · TypeScript 5.9
+    monorepo: Nx 22.7
+    backend: NestJS 11.1 (Express 5) · Prisma 7 · PostgreSQL 18
+    frontend: React 19.2 + Compiler · Vite 8 (Rolldown) · TanStack Query/Router · Zustand
+    api: REST + OpenAPI 3.1 + Zod 4 + nestjs-zod + react-hook-form
+    auth: master-login (IdP OAuth2/OIDC próprio) · jose · argon2id
+    multi_tenancy: BD-por-workspace (ADR 0006) — cluster PG por workspace
+    infra: Proxmox on-prem BR · Docker Compose · MinIO · Vault · Valkey
+  component_library: ant-design
+  component_library_version: "6.4"
+  skip_design_system: false  # AntD não cobre tokens/variações JCS — Phase 7 mantida
+
+phases:
+  enabled:
+    - phase-1-project-brief
+    - phase-2-trigger-mapping  # strategic_analysis: full
+    - phase-3-prd
+    - phase-4-ux-design
+    - phase-5-agentic-development
+    - phase-6-design-system  # mantida apesar de AntD — overrides JCS
+    - phase-7-go-live
+  brief_level: complete
+  strategic_analysis: full
+
+structure:
+  root_folder: design-artifacts
+  folders:
+    - design-artifacts/A-Product-Brief/
+    - design-artifacts/B-Trigger-Map/
+    - design-artifacts/C-UX-Scenarios/
+    - design-artifacts/D-Design-System/
+    - design-artifacts/E-Development/
+    - design-artifacts/_progress/
+    - design-artifacts/_progress/agent-experiences/
+
+existing_materials:
+  has_materials: true
+  items:
+    - path: brand.md
+      type: brand-identity
+      summary: "Paleta JCS (#004a99 primária), Plus Jakarta Sans, Font Awesome 6.4, Chart.js, layout topbar 80px + sidebar 260px, radius 12/20px, sombra suave. Tom Apple-inspired."
+    - path: STACK.md
+      type: tech-canon
+      version: "2.2"
+      summary: "Stack canônica JCS — Node 24 + Nest 11 + Prisma 7 + Postgres 18 + React 19.2 + AntD 6.4. Multi-tenancy BD-por-workspace. Self-host Proxmox sa-east-1 → on-prem BR."
+    - path: CODING-RULES.md
+      type: invariants
+      version: "2.0"
+      summary: "Invariantes (Zod contrato, RFC 9457 422, Vault, BullMQ, Idempotency-Key, argon2id) + pegadinhas 🔥 PGD-SEC/PGD-DB."
+    - path: frontend/img/SAR_logo_fundo_transparente.png
+      type: asset-logo
+    - path: frontend/img/SAR_icone_fundo_transparente.png
+      type: asset-icon
+    - path: design-artifacts/_references/legacy-screens-html/index.html
+      type: legacy-mockup
+      summary: |
+        SPA mockup do SAR (2251 linhas) com 9 telas: indicadores, pedidos,
+        funil, agenda, novo-pedido, analise-cliente, clientes, cadastro-cliente,
+        produtos. Login excluído. Usa variáveis CSS de brand.md.
+        Revela 7ª tela "Painel de Desempenho" (BI) não listada nos módulos do brand.md.
+
+product_context:
+  description: |
+    SAR é um sistema web de força de vendas SaaS B2B para representantes comerciais
+    e empresas. Substitui app Android/Desktop legado. Centraliza pedidos, clientes,
+    financeiro, comissões/FLEX e CRM, sincronizado com ERP.
+  modules:
+    - vendas       # Pedidos (Orçamento→Faturado), catálogo, pautas
+    - fiscal       # ICMS-ST, IPI, grupos tributários por UF
+    - financeiro   # Títulos, recebimentos, limite de crédito
+    - comissao-flex # Cálculo por rep e produto, rateio supervisor, saldo FLEX
+    - crm          # Funil Kanban, agenda, check-in GPS, timeline 360°
+    - administrativo # Multi-empresa, configs, gestão de reps
+  initial_personas_hypothesis:
+    - representante-externo  # Pedidos, CRM, agenda, comissão
+    - supervisor-vendas      # Acompanha equipe, libera descontos
+    - administrador          # Configurações, pautas, relatórios
+
+project_context:
+  stakes: small-business
+  domain: b2b-saas / sales-force-automation
+  market: representantes comerciais e empresas B2B (Brasil)
+  competing_with: app Android/Desktop legado proprietário + planilhas + ferramentas fragmentadas
+
+working_relationship:
+  involvement: balanced
+  role: product-owner
+  presentation: recommend-with-rationale
+  communication_language: pt-BR
+
+agents:
+  active:
+    - saga    # Strategy: Brief, Trigger Map, Scenarios outline
+    - freya   # Design: UX, Page Specs, Design System
+  triggers:
+    PB: saga  # Project Brief
+    TM: saga  # Trigger Map
+    SC: saga  # Scenarios outline
+    UX: freya # Page specs
+    SA: freya # Spec audit
+    DS: freya # Design System
+
+next_phase: wds-1-project-brief