Docs

03 — Pilares e Critérios do Produto

<!-- EXEMPLO: produto fictício "SiteScope". Substitua pelos pilares do seu produto real. -->

Pilares do produto

Defina 3–5 pilares que agrupam funcionalidades e expectativas de valor. Status: 🟢 maduro | 🟡 em evolução | 🔴 planejado

Pilar 1 — Diagnóstico 🟢

Descrição: Capacidade central de varrer qualquer URL/domínio e produzir um score de saúde digital cobrindo SEO on-page, performance (Core Web Vitals), acessibilidade básica e erros de rastreamento. É o motivo pelo qual o cliente contrata.

CritérioMetaComo medir
Cobertura de checks≥ 80 checks ativos (SEO + perf + crawl)Contagem no código de regras ativas
Precisão de scoreCorrelação ≥ 0,85 com Lighthouse manual em sample de 50 URLsTeste de validação mensal
Tempo de varredura< 3 min para site com até 200 páginasP95 no APM
Falsos positivos< 2% nos alertas de erro críticoRevisão amostral trimestral

Pilar 2 — Automação 🟡

Descrição: Agendamento de varreduras recorrentes (diária, semanal, mensal) e envio proativo de alertas quando métricas-chave regridem. Elimina o trabalho manual de "lembrar de rodar" e permite que a agência reaja antes do cliente perceber.

CritérioMetaComo medir
Confiabilidade de jobs< 0,5% de jobs falhando silenciosamenteTaxa de erro no worker (Datadog)
Latência de alertaNotificação enviada em < 5 min após detecção de regressãoLogs de timestamps
Canais de notificaçãoE-mail + Slack webhook disponíveisFeature flag + cobertura de testes
CustomizaçãoThreshold configurável por site e por métricaUI: formulário de threshold por site

Pilar 3 — Relatórios e Colaboração 🔴

Descrição: Geração de relatórios PDF/HTML com marca da agência (white-label), compartilháveis com o cliente final sem que ele precise ter login. Inclui painel de cliente com histórico de scores e comparativo entre períodos.

CritérioMetaComo medir
Tempo para gerar PDF< 30 s para relatório padrão (≤ 10 páginas)P95 no serviço de PDF
White-labelLogo, cores e domínio customizáveis sem intervenção de suporteSelf-service no painel da agência
Abertura pelo cliente≥ 60% dos relatórios enviados abertos em 48 hPixel de rastreamento no link
NPS do relatório≥ 40 (feedback in-app ao cliente final)Survey pós-abertura

Pilar 4 — Confiança (plataforma) 🟢

Descrição: Conta, billing, segurança, onboarding — herdado em parte do boilerplate; documentar critérios específicos do SiteScope.

CritérioMetaComo medir
Uptime API / app99,5% mensalMonitoramento UptimeRobot + status page
Onboarding (Aha moment)Primeira varredura concluída em < 5 min após cadastroFunil de ativação no analytics
Suporte self-serviceHelp docs cobrem ≥ 90% dos top-10 tickets de suporteRevisão mensal das categorias de ticket
Segurança de dadosDados de cliente isolados por tenant (Row Level Security no Hasura)Auditoria de permissões por spec de multi-tenant

Matriz pilar × persona

PilarAna (Diretora)Bruno (Especialista SEO)Carol (Freelancer)
DiagnósticoAlta — base do contrato com clienteAlta — uso diárioAlta — prova de valor
AutomaçãoAlta — reduz horas da equipeAlta — alertas antes do cliente verMédia — nice-to-have no Starter
Relatórios e ColaboraçãoAlta — diferencial de vendasMédia — usa, mas não vendeMédia — entrega ao cliente
Confiança (plataforma)Alta — responsável pelo contratoBaixa — não percebe diretamenteMédia — não pode perder dados

Definition of Done (produto)

Uma entrega de feature só está "done" quando:

  1. Critério(s) de pilar associado(s) atualizado(s) neste doc ou em 04-features-modules.md
  2. Spec em specs/ com FR-xxx e cenários de aceite
  3. Métrica de sucesso definida em 06-product-metrics.md (se aplicável)
  4. Comunicação alinhada (marketing/vendas) se impacto externo

Links relacionados