# Medição

Fonte: /pt-br/ux/foundations/how-we-measure.md

- Resumo: Como contamos cliques, entradas e linhas, as quatro tarefas por entidade, a linha Passa de toda regra e um template para copiar.
- Status: Adotada, em 2026-10-02
- Princípios: Menos passos, Menos rolagem, Menos entradas, Máxima intuição, Jeito único
- Superfícies: Tela, Formulário
- Do inglês de 2026-10-02

## Quando usar

Use sempre que contar os cliques, as entradas ou as linhas visíveis de uma tela ou formulário, e sempre que escrever a linha Passa de uma regra. Para escrever uma medição, copie o [template](#template).

## Quando não usar

Emails e documentos ainda não têm protocolo de contagem. As regras deles também levam uma linha Passa, escrita como uma verificação que duas pessoas responderiam do mesmo jeito.

## Como funciona

### Conte toda ação do ponteiro como um clique

Um clique é toda ação do ponteiro, incluindo o foco em um campo e a conclusão salva. Atalhos de teclado não contam, então cada caminho é o que uma pessoa percorre com o mouse.

Passa: a contagem de uma tarefa lista pelo nome cada ação do ponteiro, do primeiro clique ao resultado salvo.

### Conte cada campo como uma entrada

Uma entrada é um campo ou um valor que a pessoa informa. O número de caracteres digitados nele não conta.

Passa: a contagem de uma tarefa nomeia cada campo em que a pessoa digitou ou escolheu um valor.

### Conte só os campos habilitados em um formulário de criação

Um formulário de criação é medido pelos campos que a pessoa pode preencher. Valores padrão e controles condicionais ficam anotados ao lado da contagem, nunca somados a ela.

Passa: a contagem do formulário informa os campos obrigatórios, os campos opcionais e os valores padrão e controles condicionais que ele mostrou.

### Meça a densidade em 1180 x 757

A densidade é o número de linhas inteiras visíveis em 1180 x 757 pixels, com zoom de 100% e sem rolagem. Uma linha cortada pela borda de baixo não conta.

Passa: a tela foi medida em 1180 x 757, a 100%, sem rolar, e só as linhas inteiras foram contadas.

### Conte a confirmação de uma exclusão

Os cliques da confirmação de uma exclusão contam para a exclusão. Um passo irreversível precisa de aprovação antes que alguém o execute em um teste.

Passa: a contagem da exclusão inclui a confirmação, e nenhum passo irreversível rodou sem aprovação.

### Classifique o melhor resultado contando os empates

Ganha quem tem menos cliques, menos entradas obrigatórias e mais campos opcionais. Produtos empatados no melhor resultado dividem o posto.

Passa: todo produto que chega ao melhor valor de uma medida é marcado como melhor.

### Meça as mesmas quatro tarefas em toda entidade

Cada entidade é medida em quatro tarefas: abrir um registro, criar um registro com nome, editar o nome e excluir o registro.

Passa: toda entidade de uma comparação tem as quatro contagens, ou diz por que falta uma.

| Tarefa | Começa em | Termina em |
|---|---|---|
| Abrir | A lista principal da entidade | O detalhe do registro aparece |
| Criar com nome | A entrada principal da entidade | Um registro novo com nome está salvo |
| Editar o nome | O detalhe ou a linha do registro | O nome alterado está salvo |
| Excluir | O detalhe ou a linha do registro | O registro sumiu, confirmação incluída |

### Dê a toda regra uma linha Passa

Toda regra declara uma condição Passa. Quando um produto de referência foi medido, a condição é um número tirado dessa medida, como em "Pass: 15 full rows fit". Quando não há medida, a linha Passa traz uma verificação que duas pessoas responderiam do mesmo jeito.

Passa: todo título de regra do guia é seguido de uma linha Passa, e a linha traz um número sempre que existe uma referência medida.

Troque isto: Passa: o formulário é curto.
Por isto: Passa: salve uma pessoa com nome em 3 cliques ou menos, com 1 campo digitado.

## Um exemplo preenchido

A seção Person da comparação do revisor, com os números como foram medidos (comparação, linhas 11 a 42). Um documento de medição repete esta forma para cada entidade: a entidade e a tarefa humana, o veredito, a tabela de comparação, a lista de Fix com uma linha Passa por item, notas sobre o que não foi verificado e as telas medidas.

Person. Core. Identificar e gerenciar uma pessoa.

Veredito: Fix. O formulário principal e a criação com nome precisam de menos passos.

| Person | Nosso | Attio | folk |
| :---- | :---: | :---: | :---: |
| Layout padrão | Cards | Tabela | Kanban |
| Abrir · cliques | 1 | 1 | 1 |
| Criar com nome · cliques | 4 | 4 | 3 |
| Editar nome · cliques | 2 | 2 | 2 |
| Apagar · cliques | 3 | 3 | Precisa de aprovação |
| Obrigatórios no formulário de criação | 4 | 0 | 1 |
| Opcionais no formulário de criação | 7 | 14 | 3 |
| Campos digitados · rota testada | 1 | 2 | 1 |
| Seleções usadas | 0 | 0 | 0 |
| Defaults obrigatórios usados · Não verificado | 0 | 0 | 0 |

Fix:

- Tornar a view padrão de People uma tabela. Copiar Attio; manter Cards como view opcional.
- Tornar Name opcional. Copiar Attio.
- Tornar Company opcional. Copiar Attio e folk.
- Tornar Email opcional. Copiar Attio e folk.
- Tornar Phone opcional. Copiar Attio e folk.
- Dar foco automático a Name no formulário principal. Copiar folk. Passa: salvar uma pessoa identificável em 3 cliques ou menos com 1 campo digitado.

Como ler. O melhor valor de uma linha é a menor contagem de cliques ou de obrigatórios e a maior de opcionais, e produtos empatados compartilham o melhor: folk vence a criação com nome com 3, Attio vence obrigatórios com 0 e opcionais com 14. "Precisa de aprovação" significa que o passo não foi executado por ser irreversível. "Não verificado" marca uma linha medida sem uma segunda checagem. A comparação pinta de verde as melhores células; em Markdown, nomeie o vencedor numa frase abaixo da tabela.

O que o exemplo não decide. Quatro dos seis fixes conflitam com o nosso modelo: Name é fórmula, e Email, Company e Phone moram no Core, não na relação. A medição continua válida como medição. Se um fix é aplicado, vai para decisão de modelo ou é recusado é trabalho da triagem, não desta página.

## Template

Copie este bloco para cada entidade que medir. Mantenha os nomes das linhas para os documentos poderem ser comparados.

```markdown
# <Entidade>

<Domínio>. <A tarefa humana, em cinco palavras.>

Veredito: <Passa | Fix | Não pontuado>. <Uma frase dizendo por quê.>

| <Entidade> | Nosso | <Referência 1> | <Referência 2> | <Referência 3> |
| :---- | :---: | :---: | :---: | :---: |
| Layout padrão | | | | |
| Abrir · cliques | | | | |
| Criar com nome · cliques | | | | |
| Editar nome · cliques | | | | |
| Apagar · cliques | | | | |
| Obrigatórios no formulário de criação | | | | |
| Opcionais no formulário de criação | | | | |
| Campos digitados · rota testada | | | | |
| Seleções usadas | | | | |
| Defaults obrigatórios usados | | | | |

Melhor: <quem vence cada linha, empates incluídos>.

## Fix

- [ ] <Mudança no imperativo>. Copiar <referência>. Passa: <condição mensurável>.

## Notas

- <O que não foi verificado, o que precisou de aprovação, o que a rota assumiu.>

Fontes: <um link por tela medida, a nossa primeiro>
```

## Referências

O protocolo vem da comparação de usabilidade de CRMs do revisor (2026-09-29/30), da tabela "How to read the comparison" (comparação, linhas 2353 a 2370). Essa tabela define clique como "Every pointer action, including field focus and saved completion", entradas como "Fields or values, not arbitrary test-name characters", densidade como "Fully visible records at 1180 × 757, 100%, zero scroll", campos de criação como "Enabled fields only; defaults and conditional controls noted" e exclusão como "Confirmation clicks count; irreversible steps require approval". Ela deixa os atalhos de teclado fora dos caminhos do ponteiro. O melhor resultado dela "includes ties: lower clicks/required input; higher optional-field counts" (inclui empates: menos cliques e entradas obrigatórias, mais campos opcionais).

As quatro tarefas são as linhas que a comparação mede em cada entidade: Open, Tested named create, Edit name e Delete (comparação, linhas 17 a 28).

A linha Passa copia a redação da própria comparação, como em "Pass: 15 full rows fit at the same screen size when the view has enough records." (comparação, linha 615) e "Pass: no owner entry is needed." (comparação, linha 662). A comparação é interna e não tem URL. Toda regra do guia agora leva uma linha Passa. Onde não há medida, a linha diz uma verificação que duas pessoas responderiam do mesmo jeito, e ganha um número quando uma referência for medida.
