<aside> 🧪
Página de teste. Versão prática do Capítulo IV no projeto chape-sistema. Continue no mesmo repositório dos capítulos anteriores.
</aside>
💬 Contexto: Muitas vezes o primeiro "atendente" do suporte não é uma pessoa — é a mensagem de erro que aparece na tela. Se ela culpa o usuário, usa jargão ou não diz o que fazer, o chamado chega irritado e sem informação.
Netiqueta também se escreve em código.
As regras de netiqueta do Capítulo IV valem para as mensagens que o sistema mostra:
// ❌ Jargão, culpa o usuário e não diz o que fazer
throw new Error('ERR_AUTH_401: credenciais inválidas, usuário digitou errado');
// ✅ Linguagem acessível, sem culpa, com próximo passo e um protocolo para o suporte
mostrarMensagem(
'Não conseguimos confirmar seu acesso. Confira seu e-mail e sua senha. ' +
'Se o problema continuar, informe o protocolo CHP-0042 ao suporte.'
);
registrarNoLog('ERR_AUTH_401', { usuario: email, protocolo: 'CHP-0042' }); // detalhe técnico vai para o log
| Regra do Capítulo IV | Na mensagem de erro |
|---|---|
| Use linguagem acessível | Nada de códigos, nomes de função ou siglas técnicas |
| Nunca culpe o usuário | "O CPF não é válido", e não "Você digitou errado" |
| Mantenha o usuário informado | Diga o que aconteceu e o que fazer agora |
| Registre o atendimento | Um protocolo liga a tela do usuário ao log técnico |
Formato: Duplas | ~30 minutos
Este arquivo foi encontrado no sistema da Chapecoense. Crie-o em src/mensagens.js:
// Mensagens que aparecem na tela para o usuário
function mensagemParaUsuario(codigo) {
if (codigo === 'ETIMEDOUT') return 'ERRO FATAL: ETIMEDOUT em pool.query()';
if (codigo === 'CPF_INVALIDO') return 'Você digitou o CPF errado!!';
if (codigo === 'SEM_PERMISSAO') return 'Acesso negado. 403.';
return 'Erro desconhecido.';
}
module.exports = { mensagemParaUsuario };
Agora crie test/suporte.test.js com os testes abaixo. Eles representam as regras de netiqueta — rode e veja todos falharem:
const test = require('node:test');
const assert = require('node:assert');
const { mensagemParaUsuario } = require('../src/mensagens');
const PROIBIDO = ['ERRO FATAL', 'pool', '403', '!!', 'Você digitou', 'ETIMEDOUT'];
for (const codigo of ['ETIMEDOUT', 'CPF_INVALIDO', 'SEM_PERMISSAO', 'XPTO']) {
test(`mensagem de ${codigo} é amigável e traz o protocolo`, () => {
const msg = mensagemParaUsuario(codigo, 'CHP-0042');
for (const termo of PROIBIDO) {
assert.ok(!msg.includes(termo), `não deveria conter "${termo}": ${msg}`);
}
assert.ok(msg.includes('CHP-0042'));
});
}
test('código desconhecido recebe mensagem padrão', () => {
assert.match(mensagemParaUsuario('XPTO', 'CHP-1'), /nossa equipe já foi avisada/);
});
O que fazer: reescreva mensagemParaUsuario(codigo, protocolo) até todos os testes passarem. Cada mensagem deve dizer o que aconteceu e o que o usuário pode fazer, e terminar com o protocolo para o suporte.
Desafio de organização: em vez de uma sequência de if, guarde as mensagens num objeto. Por que isso facilita a manutenção quando surgir um código de erro novo?
Para responder: os testes garantem que a mensagem não tem jargão. Eles garantem que a mensagem é boa? O que só uma pessoa consegue avaliar?