julian
17c08e6392
- 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>
79 lines
3.4 KiB
Markdown
79 lines
3.4 KiB
Markdown
# Phase 1 — Dialog Context
|
|
|
|
**Project:** SAR — Força de Vendas
|
|
**Owner:** Julian (Product Owner, JCS Sistemas)
|
|
**Agent:** Saga (Business Analyst)
|
|
**Started:** 2026-05-26
|
|
**Brief level:** complete (36 steps)
|
|
**Communication language:** pt-BR
|
|
|
|
---
|
|
|
|
## Working Relationship (de wds-project-outline.yaml)
|
|
|
|
- **Involvement:** balanceado
|
|
- **Presentation:** recomendar com justificativa
|
|
- **Stakes:** small-business (JCS Sistemas)
|
|
- **Role:** Product Owner
|
|
|
|
---
|
|
|
|
## Materiais existentes (entrada Phase 1)
|
|
|
|
| Material | Path | Cobre |
|
|
|---|---|---|
|
|
| Brand identity | `brand.md` | Visual Direction quase completo + parte de tom |
|
|
| Stack canon JCS | `STACK.md` v2.2 | Platform Requirements quase completo |
|
|
| Coding rules | `CODING-RULES.md` v2.0 | Constraints técnicas (invariantes + pegadinhas) |
|
|
| Logos | `frontend/img/SAR_logo_fundo_transparente.png`, `SAR_icone_fundo_transparente.png` | Assets |
|
|
| **Mockup SPA legado** | `design-artifacts/_references/legacy-screens-html/index.html` | Estrutura funcional + 9 telas mockadas alinhadas à marca |
|
|
|
|
---
|
|
|
|
## Pré-análise do mockup legado (9 telas)
|
|
|
|
> Login excluído por decisão do PO (já será coberto pela stack: master-login + jose).
|
|
|
|
| Tela (id SPA) | Título | Função (inferida) |
|
|
|---|---|---|
|
|
| `indicadores` | Painel de Desempenho | Dashboard executivo: faturamento, ritmo, mix de produtos, status carteira, radar de inatividade |
|
|
| `pedidos` | Meus Pedidos | Lista de pedidos com totais consolidados |
|
|
| `funil` | Meu Funil de Vendas | Kanban CRM |
|
|
| `agenda` | Agenda e Rotas | Calendário + Roteiro Otimizado |
|
|
| `novo-pedido` | Lançamento de Pedido | Form: cliente + comercial + adicionais + total |
|
|
| `analise-cliente` | Visão 360° do Cliente | Timeline integrada (ex.: OPENFRIOS) |
|
|
| `clientes` | Lista de Clientes | — |
|
|
| `cadastro-cliente` | Cadastro de Cliente | Dados principais + endereço + contatos |
|
|
| `produtos` | Catálogo de Produtos | Detalhe + modal de produto |
|
|
|
|
### Observações da pré-análise
|
|
|
|
1. **"Painel de Desempenho" não estava em `brand.md`**. O brand.md lista 6 módulos (Vendas, Fiscal, Financeiro, Comissão/FLEX, CRM, Administrativo) e o mockup adiciona um 7º implícito (BI/Dashboard). A confirmar no brief: é módulo separado ou tela transversal a outros módulos?
|
|
2. **CSS do mockup usa variáveis JCS** (`var(--jcs-blue)`, `var(--orange)`, etc.) — o legado já está alinhado à identidade.
|
|
3. **Cliente 360° já está implementado** no mockup — confirma a visão de `brand.md`.
|
|
|
|
---
|
|
|
|
## Histórico do diálogo
|
|
|
|
### 2026-05-26 — Step 1 (Init)
|
|
|
|
- Saga apresentada como BA do projeto.
|
|
- Escopo Phase 1 explicado (36 steps em 5 blocos: Brief / Content / Visual / Platform / Wrap-up).
|
|
- Tempo previsto: 2-3h (ajuste sobre os 30-60 min default do workflow).
|
|
- Estratégia acordada: **fast-track de Visual (via brand.md + mockup) e Platform (via STACK.md)**, foco em Product Brief (steps 1-12) e Content (steps 13-18) onde há mais lacunas.
|
|
- Materiais adicionais: usuário disponibilizou mockup HTML do SAR (`index.html` SPA com 9 telas) — login não entra no escopo.
|
|
- Ritmo escolhido: sessão longa contínua, até onde der.
|
|
|
|
---
|
|
|
|
## Progress Tracker
|
|
|
|
| Bloco | Steps | Status |
|
|
|---|---|---|
|
|
| A. Product Brief | 1-12 | Step 1 ✅ · Step 1a → próximo |
|
|
| B. Content & Language | 13-18 | Pendente |
|
|
| C. Visual Direction | 19-26 | Pendente (fast-track) |
|
|
| D. Platform Requirements | 27-32 | Pendente (fast-track) |
|
|
| E. Wrap-up | 33-36 | Pendente |
|