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>
7.2 KiB
7.2 KiB
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?"