Ninguém lê o manual: ajuda na tela, tour guiado e um checklist que se marca sozinho

Depois do cadastro, o vazio

Há algumas semanas escrevi sobre o cadastro que espantava todo mundo: CNPJ, confirmação de e-mail e 2FA antes de mostrar qualquer coisa. Cortei essa fricção.

Só que entrar no painel não é o mesmo que ter valor. Um sistema de gestão vazio é intimidador: menu cheio, tabelas sem dados, nenhuma pista de por onde começar. Se a pessoa não chega ao primeiro resultado na primeira sessão, a chance de voltar no dia seguinte é pequena.

No Oficina Simples, defini o primeiro resultado assim: o dono da oficina envia um orçamento e o cliente aprova pelo celular. Tudo no onboarding existe para encurtar o caminho até esse momento.

O caminho virou três camadas.

Camada 1: o botão "Ajuda" em cada tela

Toda tela importante tem um botão de ajuda no cabeçalho. Ele abre um modal curto com o que aquela tela faz, as dúvidas mais comuns e o próximo passo.

O conteúdo fica num lugar só, organizado por chave, e não espalhado pelas views. E tem uma regra que o código garante: um teste falha se alguma tela apontar para uma chave que não existe, ou cair no texto genérico. Não dá para esquecer a ajuda de uma tela nova e só descobrir quando um cliente perguntar.

Camada 2: um tour que respeita o que a pessoa pode ver

O tour guiado é uma lista de passos: em qual página, qual elemento destacar e o que dizer.

O detalhe que fez diferença: cada passo só entra se a pessoa pode acessar aquela tela. Ele usa a mesma checagem de permissão dos menus. Se a oficina desligou o estoque, o passo do estoque some. Se o usuário é mecânico e não vê o financeiro, o passo do financeiro some. Ninguém recebe um tour mostrando uma tela que vai dar 403.

O progresso fica guardado no navegador, para sobreviver à troca de página que o próprio tour provoca. E o convite "Primeira vez por aqui?" só aparece para contas com menos de 7 dias. Quem já usa o sistema há meses não precisa ser interrompido.

Camada 3: um checklist que se marca sozinho

No dashboard, um card "Primeiros passos" lista o caminho até o primeiro resultado:

1. Complete os dados da oficina (telefone e logo entram no orçamento).
2. Cadastre os serviços que você mais faz.
3. Cadastre um cliente com o veículo dele.
4. Abra a primeira ordem de serviço.
5. Envie um orçamento para o cliente.
6. Escolha os menus que a oficina usa (opcional).

A decisão mais importante: nenhum item é marcado por clique. Cada um é calculado a partir dos dados reais. "Abra a primeira OS" está concluído quando existe uma OS. "Envie um orçamento" está concluído quando existe uma OS que saiu do rascunho.

Isso tem três vantagens:

• Não mente. Ninguém marca como feito algo que não fez.
• Funciona fora de ordem. Se a pessoa descobriu sozinha como abrir uma OS, o item já aparece concluído.
• Não precisa de tabela de progresso. O estado do onboarding é o próprio estado do sistema.

Cada item tem uma dica de uma linha e um link direto para onde fazer. O card só aparece para dono e gerente, e some quando os obrigatórios estão feitos ou quando o dono clica em "Ocultar".

A regra para telas novas

Onboarding apodrece rápido. A cada tela nova, a ajuda e o tour ficam um pouco mais desatualizados.

Para evitar isso, virou parte da definição de pronto: tela nova ganha botão de ajuda e conteúdo; se faz parte do fluxo principal, ganha um passo no tour. O teste de ajuda cobra a primeira parte automaticamente.

O que aprendi

• Defina o primeiro resultado antes de desenhar o onboarding. Sem isso, o tour vira uma visita guiada pelo menu.
• Ajuda que depende de disciplina é ajuda que vai faltar. Coloque um teste no meio.
• Calcule o progresso a partir dos dados, não de cliques. É mais simples e é mais honesto.
• Respeite permissões em tudo, inclusive na ajuda. Um tour que mostra o que a pessoa não pode usar ensina que o sistema está quebrado.