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>
135 lines
7.2 KiB
Markdown
135 lines
7.2 KiB
Markdown
# Persona — Alice Admin (TERTIARY — operacional crítico)
|
||
|
||
**Phase 2 — Trigger Mapping · Workshop 2-4**
|
||
**Status:** TERTIARY persona — 1-5% volume (em ondas) · NÃO pesa na decisão de compra, mas o produto não roda sem ela
|
||
**Device-target:** Desktop-only
|
||
|
||
---
|
||
|
||
## Quem é Alice
|
||
|
||
> Funcionária administrativa da empresa-cliente, 25-45 anos. Trabalha em escritório, desktop o dia todo. Reporta para Sandra ou Daniel. **É quem mantém o produto rodando** — cadastra produtos, atualiza pautas de preço, configura grupos tributários, lança campanhas/promoções, gerencia reps. Não tem treino de dev, mas domina Excel a níveis avançados.
|
||
|
||
### Dia típico
|
||
|
||
- **8h** — chega ao escritório, café, abre SAR no desktop
|
||
- **8h30-10h** — atualiza pauta de preço da semana, configura promoções de fim de mês
|
||
- **10h-12h** — cadastra novos produtos da linha de janeiro (do fornecedor que mandou planilha)
|
||
- **12h** — almoço
|
||
- **13h-15h** — ajustes tributários (ICMS-ST por UF), revisa cadastros de novos clientes inseridos pelos reps
|
||
- **15h-17h** — cadastros de reps novos, ajustes de comissão, suporte a casos pontuais
|
||
- **17h** — fechamento
|
||
|
||
### O que a motiva (em uma frase)
|
||
|
||
> **"Manter tudo rodando sem incidente, sem depender do dev para ajuste pequeno."**
|
||
|
||
---
|
||
|
||
## Driving Forces
|
||
|
||
### ✅ Positive forces
|
||
|
||
| ID | Force | Descrição | Freq | Int | Fit MVP |
|
||
|---|---|---|---|---|---|
|
||
| **A+1** | **Autonomia operacional (sem precisar do dev)** | Lançar promoção, ajustar pauta, mexer em tributação sem abrir chamado de TI. | 5/5 | 5/5 | 5/5 |
|
||
| **A+2** | **Eficiência em bulk operations** | Importar 500 produtos do fornecedor, atualizar pauta de 1000 itens — sem clicar 1000 vezes. | 4/5 | 5/5 | 4/5 |
|
||
| **A+3** | **Confiança no que está em produção** | Não ter receio de "estourei o sistema com uma pauta errada". | 5/5 | 5/5 | 4/5 |
|
||
| **A+4** | **Trilha de auditoria visível** | Saber quem mexeu em quê, quando. Proteção pessoal e organizacional. | 4/5 | 4/5 | 5/5 |
|
||
| **A+5** | **Lançar campanha rapidamente** | Promoção sazonal, kit de produtos, brinde — em < 30 min, não semana. | 3/5 | 5/5 | 3/5 (pós-MVP) |
|
||
| **A+6** | **Ser reconhecida como mais que "backoffice"** | Ter ferramenta que respeita seu domínio técnico (tributação, pauta, processo). | 3/5 | 4/5 | 3/5 |
|
||
|
||
### ❌ Negative forces
|
||
|
||
| ID | Force | Descrição | Freq | Int | Fit MVP |
|
||
|---|---|---|---|---|---|
|
||
| **A-1** | **Depender do dev para ajuste pequeno** | "Preciso de uma promoção de 15% no produto X, dev tá ocupado, leva 1 semana." | 4/5 | 5/5 | 3/5 (pós-MVP completo) |
|
||
| **A-2** | **Ser culpada por erro em produção** | Pauta com vírgula errada, 1.000 pedidos saem com preço errado. Pesadelo. | 2/5 | 5/5 | 5/5 |
|
||
| **A-3** | **ICMS-ST como labirinto sem mapa** | Cada UF tem regra, NCM específico, alíquota... sem assistente, precisa de PDF da legislação. | 3/5 | 5/5 | 4/5 |
|
||
| **A-4** | **Perder histórico de mudança** | Editou pauta, alguém depois questiona "por que estava em R$ X mês passado?". Sem evidência. | 3/5 | 4/5 | 5/5 |
|
||
| **A-5** | **Telas lentas em bulk** | Editar 200 produtos um por um, tela carrega cada vez. Hora de trabalho perdida. | 4/5 | 4/5 | 4/5 |
|
||
| **A-6** | **Ser vista só como "backoffice"** | Esforço técnico invisível — quando dá tudo certo, ninguém percebe; quando dá errado, é culpada. | 3/5 | 4/5 | 3/5 |
|
||
|
||
---
|
||
|
||
## Score consolidado
|
||
|
||
Top 5 forces de Alice:
|
||
|
||
| Rank | Force | Score |
|
||
|---|---|---|
|
||
| 1 | **A+1 Autonomia (sem dev)** | 125 |
|
||
| 1 | **A+3 Confiança em produção** | 100 |
|
||
| 1 | **A-3 ICMS-ST labirinto** | 75 (3×5×5) |
|
||
| 1 | **A+4 Trilha auditoria** | 80 |
|
||
| 1 | **A-4 Perder histórico** | 60 (3×4×5) |
|
||
|
||
---
|
||
|
||
## Features que respondem às forças de Alice
|
||
|
||
| Force | Feature SAR que responde |
|
||
|---|---|
|
||
| A+1 Autonomia sem dev | **Editor de campanhas no-code** (pós-MVP) + cadastros completos no MVP |
|
||
| A+2 Bulk operations | **Import CSV/Excel** com preview · seleção múltipla com bulk edit · sem refresh entre operações |
|
||
| A+3 Confiança em produção | **Preview obrigatório** antes de salvar mudanças em massa · double-confirm para operações destrutivas |
|
||
| A+4 Trilha auditoria | **Histórico em cada entidade** (quem, quando, valor anterior) · revertível |
|
||
| A+5 Campanhas no-code | **Editor visual de campanha** pós-MVP: "Produto X com 15% off para clientes região Y no mês Z" — sem SQL |
|
||
| A+6 Reconhecida | UX que respeita expertise técnica (forms densos, atalhos, profissionalidade) |
|
||
| A-1 Depender do dev | Cobertura ampla do editor no-code (pós-MVP) — MVP entrega cadastros e pautas com versionamento |
|
||
| A-2 Erro em produção | Preview · validação Zod · "X produtos serão afetados — confirma?" · rollback de pauta versionada |
|
||
| A-3 ICMS-ST | **Assistente de tributação:** sugere grupo correto baseado em NCM + UF de destino |
|
||
| A-4 Perder histórico | Versionamento de pautas · auditoria em produtos/clientes |
|
||
| A-5 Telas lentas | **Bulk edit otimizado** (server-side, queries batch via Prisma) |
|
||
| A-6 Backoffice invisible | UI elegante para Alice (não tela "tabelão preto e cinza") — Notion-inspired |
|
||
|
||
---
|
||
|
||
## O que NÃO fazer (anti-padrões pra Alice)
|
||
|
||
- ❌ Wizard de 10 passos para criar promoção (Alice quer form denso, não condução infantil)
|
||
- ❌ Pedido constante de confirmação para tudo (Alice é técnica, sabe o que faz)
|
||
- ❌ Esconder funcionalidade avançada atrás de "modo avançado" (Alice é avançada)
|
||
- ❌ Sem atalho de teclado em telas de cadastro (Alice digita rápido, mouse é freio)
|
||
- ❌ Form sem auto-save (Alice perde 30 min de cadastro por refresh acidental)
|
||
- ❌ Bulk operations sem preview (Alice é cuidadosa — quer ver antes de aplicar)
|
||
|
||
---
|
||
|
||
## Restrições MVP (refinamento da tensão Step 10)
|
||
|
||
Como solo founder + 3-4 meses não comporta tudo, **o cockpit Alice no MVP** tem:
|
||
|
||
| Feature | MVP | Pós-MVP |
|
||
|---|---|---|
|
||
| Cadastro de produto | ✅ Form denso completo | Bulk import refinado |
|
||
| Cadastro de cliente | ✅ Completo (com integração ERP eventual) | — |
|
||
| Cadastro de rep | ✅ Permissões + região + comissão | Hierarquia rep → supervisor |
|
||
| Pauta de preço | ✅ Edição + versionamento | Diff visual entre versões |
|
||
| ICMS-ST por UF | ✅ Configuração manual | **Assistente automático por NCM** |
|
||
| Campanhas/Promoções | 🟡 Tela direta (editar 1 a 1) | **Editor visual no-code** |
|
||
| Auditoria | ✅ Histórico em cada entidade | UI dedicada de auditoria/relatório |
|
||
| Bulk operations | 🟡 Import básico | Edit múltipla, scripts |
|
||
|
||
Alice no MVP é **suficiente para o produto rodar**, mas não brilha como diferencial. O **editor no-code** é onde ela passa a ser argumento de marketing — entra pós-MVP.
|
||
|
||
---
|
||
|
||
## Métricas de adoção
|
||
|
||
- **% campanhas lançadas sem suporte (no-code editor):** > 80% (pós-MVP feature do editor)
|
||
- **Tempo médio de cadastro de produto:** < 90 segundos
|
||
- **Erros de pauta em produção (mensais):** 0 (P0)
|
||
- **NPS Alice:** > 40 (admins têm vida dura — > 40 é bom)
|
||
- **Adoção do assistente ICMS-ST:** > 70% dos novos cadastros (pós-MVP)
|
||
|
||
---
|
||
|
||
## Citações canônicas
|
||
|
||
> "Pauta atualizada. 1.247 produtos afetados."
|
||
|
||
> "Promoção lançada. 234 itens em desconto até 30/06."
|
||
|
||
> "Grupo tributário sugerido pela IA para NCM 22030000 + UF SP. Aplicar?"
|