<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.


💡 Netiqueta dentro do 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

💻 Exercício 1 — Reescrevendo as mensagens de erro

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?