Voz e Tom
O que é Voz, o que é Tom
Voz é constante — é a personalidade do SystemClinic. Ela não muda independentemente de quem está lendo.
Tom é variável — se adapta ao contexto emocional. A voz de uma pessoa empática não muda, mas ela fala diferente ao dar boas notícias e ao explicar um erro.
A Voz do SystemClinic
O SystemClinic é o assistente operacional de uma clínica. Pense em um profissional experiente e confiável que:
- É direto — não enrola, não usa jargão técnico sem necessidade
- É respeitoso — trata o usuário como profissional competente, não como iniciante
- É calmo — nunca dramatiza erros, sempre aponta o caminho
- É humano — usa linguagem natural, não de robô
Não é:
- Informal ao ponto de ser improfissional ("Opa! Algo deu errado 😬")
- Formal ao ponto de ser frio ("O sistema não pôde processar sua requisição.")
- Condescendente ("Não se preocupe, é fácil!")
- Excessivamente entusiasmado ("Incrível! Seu agendamento foi criado! 🎉")
Princípios de Redação
1. Fale na voz ativa
| Evitar | Preferir |
|---|---|
| "O agendamento foi criado pelo sistema" | "Agendamento criado" |
| "Será necessário que o usuário confirme" | "Confirme o agendamento" |
| "Os dados foram salvos com sucesso" | "Dados salvos" |
2. Seja específico
Mensagens vagas forçam o usuário a adivinhar. Seja preciso sobre o que aconteceu e o que fazer.
| Evitar | Preferir |
|---|---|
| "Algo deu errado" | "Não foi possível salvar o prontuário. Verifique sua conexão e tente novamente." |
| "Campo inválido" | "CPF inválido. Use o formato 000.000.000-00." |
| "Erro de autenticação" | "E-mail ou senha incorretos." |
3. Priorize a ação do usuário
O usuário quer continuar trabalhando. Mensagens de feedback devem orientar o próximo passo, não apenas descrever o estado.
| Evitar | Preferir |
|---|---|
| "Sem permissão para esta ação" | "Somente administradores podem excluir pacientes. Contate o responsável da clínica." |
| "Sessão expirada" | "Sua sessão expirou. Faça login novamente para continuar." |
4. Não culpe o usuário
Erros de validação devem guiar, não acusar.
| Evitar | Preferir |
|---|---|
| "Você preencheu o campo incorretamente" | "O campo CPF precisa ter 11 números." |
| "Dados inválidos informados" | "Verifique os campos marcados em vermelho antes de continuar." |
5. Use português brasileiro correto — sem informalidade excessiva
- Contrações: "pro" e "pra" são aceitáveis em onboarding e textos de ajuda. Em formulários e alertas, use "para".
- Pontuação: vírgulas antes de "que" relativo são obrigatórias. Sem ponto de exclamação em notificações operacionais.
- Tratamento: "você" — nunca "tu" ou "o senhor/a senhora".
Tom por Contexto
Sucesso
Breve e positivo. Confirma que a tarefa foi concluída. Não celebra em excesso.
✓ Agendamento confirmado para quinta-feira, 12h30.
✓ Prontuário salvo.
✓ Paciente adicionado com sucesso.Informativo
Neutro e claro. Apresenta dados ou guia o usuário sem julgamento.
Selecione o profissional responsável pelo atendimento.
Você tem 3 agendamentos pendentes de confirmação.
O período de faturamento será de 1º a 31 de maio.Aviso
Apresenta uma condição que requer atenção, mas não é um bloqueio.
O paciente não confirmou o agendamento de amanhã.
Esta ação removerá o acesso do profissional à clínica. Confirme para continuar.
Você está prestes a exportar dados sensíveis cobertos pela LGPD.Erro
Explica o que falhou e o que fazer. Nunca é dramático.
Não foi possível conectar ao servidor. Verifique sua conexão e tente novamente.
O horário selecionado já está ocupado. Escolha outro horário disponível.
A sessão expirou. Faça login novamente.Destrutivo / Confirmação de exclusão
Específico sobre o que será perdido. Irreversível deve ser dito claramente.
Excluir "Ana Luíza Ferreira"? Esta ação é permanente e não pode ser desfeita.
Cancelar agendamento de 14h00 com Dr. Rafael? O paciente será notificado por e-mail.Onboarding
Um pouco mais caloroso — o usuário está chegando pela primeira vez. Mas sem excesso.
Bem-vindo ao SystemClinic. Vamos configurar sua clínica em alguns passos.
Essa é sua agenda. Aqui você gerencia todos os atendimentos da clínica.Empty States
Construtivos — explicam o estado atual e oferecem a próxima ação.
Nenhum agendamento para hoje.
[+ Novo Agendamento]
Nenhum paciente encontrado com esse nome.
Verifique a grafia ou [cadastre um novo paciente →]Glossário de Termos — Consistência
Use sempre os mesmos termos para os mesmos conceitos. Variações geram confusão.
| Termo correto | Evitar |
|---|---|
| Agendamento | Consulta, marcação, sessão |
| Paciente | Cliente, usuário, pessoa |
| Profissional | Médico (quando não aplicável), terapeuta, colaborador |
| Prontuário | Ficha, histórico, dossiê |
| Organização / Clínica | Empresa, conta, tenant |
| Plano | Assinatura (quando for recorrente) |
| Fatura | Boleto, nota, recibo (termos específicos têm seu próprio contexto) |
| Administrador | Admin, root, super usuário |
| Notificação | Alerta, aviso (reservar "alerta" para estados de urgência) |
| Confirmar | Salvar (use "Salvar" para dados, "Confirmar" para ações) |
| Cancelar | Desmarcar, desfazer (use "Cancelar" para agendamentos) |
Maiúsculas
- Módulos do sistema: capitalizados quando usados como nome próprio ("acesse o módulo Prontuário")
- Papéis de usuário: minúsculos em corpo de texto ("o administrador pode...", "os profissionais cadastrados...")
- Status: maiúsculo apenas no início ("Agendado", "Concluído", não "AGENDADO")
- Botões: primeira letra maiúscula apenas ("Salvar alterações", não "SALVAR ALTERAÇÕES")
Pontuação em UI
| Elemento | Regra |
|---|---|
| Botões | Sem ponto final |
| Labels de formulário | Sem ponto final |
| Placeholders | Sem ponto final, com ou sem maiúscula inicial |
| Mensagens de erro | Com ponto final |
| Tooltips curtos (< 10 palavras) | Sem ponto final |
| Tooltips longos (frase completa) | Com ponto final |
| Títulos de modal | Sem ponto final |
| Corpo de modal | Com ponto final |