[{"data":1,"prerenderedAt":340},["ShallowReactive",2],{"blog-/blog/como-reportar-um-bug":3,"blog-surround-/blog/como-reportar-um-bug":334},{"id":4,"title":5,"author":6,"body":7,"category":316,"date":317,"description":318,"draft":319,"extension":320,"image":321,"meta":322,"navigation":323,"ogImage":324,"path":325,"readingTime":326,"seo":327,"stem":328,"tags":329,"__hash__":333},"blog/blog/como-reportar-um-bug.md","Como relatar um problema no sistema e agilizar a correção","Guilherme Chaves",{"type":8,"value":9,"toc":302},"minimark",[10,14,17,20,25,37,46,49,57,60,64,73,85,92,96,99,103,114,128,131,135,143,159,162,167,170,174,177,198,201,205,216,230,234,237,251,256,260,292,296,299],[11,12,13],"p",{},"Todo software tem bugs. Isso não é descuido — é parte de construir algo que muita gente usa,\nde jeitos que ninguém previu. O que separa um problema resolvido hoje de um problema que fica\numa semana em ping-pong não costuma ser a gravidade do erro. É a qualidade do relato.",[11,15,16],{},"Quando o chamado chega como \"não está funcionando, corrige urgente\", quem desenvolve gasta o\nprimeiro dia só descobrindo o que você quis dizer. Cada pergunta de volta — \"onde?\", \"o que\napareceu?\", \"consegue mandar um print?\" — é mais um dia com o problema no ar. Um bom report\nentrega essas respostas de antemão. Ele não é formalidade: é o atalho até a solução.",[11,18,19],{},"E a boa notícia é que você não precisa saber programar para escrever um. Precisa só contar a\nhistória certa, na ordem certa. Este é o roteiro.",[21,22,24],"h2",{"id":23},"_1-um-título-que-já-diz-o-problema","1. Um título que já diz o problema",[11,26,27,28,32,33,36],{},"O título é a primeira coisa que quem desenvolve lê — e, numa lista de dez chamados, às vezes\na única. Ele precisa dizer ",[29,30,31],"strong",{},"onde"," e ",[29,34,35],{},"o quê",", curto e específico. Um bom título também\nevita duplicados: fica fácil perceber que aquele problema já foi relatado antes.",[38,39,40],"blockquote",{},[11,41,42,45],{},[29,43,44],{},"Ruim:"," \"Não consigo ver o paciente quando cadastro, clico e não vai. Corrigir urgente!\"",[11,47,48],{},"Esse título é vago, emocional e não localiza nada. Compare:",[38,50,51],{},[11,52,53,56],{},[29,54,55],{},"Bom:"," \"Cadastro de pacientes — pacientes novos não aparecem na lista\"",[11,58,59],{},"O segundo já entrega a área do sistema e o comportamento errado. Dá para decidir a urgência e\nsaber por onde começar só de bater o olho.",[21,61,63],{"id":62},"_2-um-resumo-com-quando-e-onde","2. Um resumo com quando e onde",[11,65,66,67,32,70,72],{},"Se o título não conta a história toda, acrescente um resumo curto. A regra é: o mínimo de\npalavras, incluindo ",[29,68,69],{},"quando",[29,71,31],{}," aconteceu. Pense que esse texto pode ser buscado\ndepois — use as palavras que você mesmo usaria para procurá-lo.",[38,74,75,80],{},[11,76,77,79],{},[29,78,44],{}," \"De manhã eu tentei trocar minha foto mas não consegui clicar.\"",[11,81,82,84],{},[29,83,55],{}," \"Terça de manhã, ao atualizar o perfil, tentei trocar a foto e o botão 'Trocar\nfoto' não apareceu.\"",[11,86,87,88,91],{},"E descreva o ",[29,89,90],{},"problema",", não o remédio. \"O formulário está feio e esticado\" ajuda menos do\nque \"o formulário não está respeitando a fonte padrão e os campos poderiam ficar lado a lado\nem vez de empilhados\". O primeiro é uma reclamação; o segundo é uma informação com a qual dá\npara trabalhar.",[21,93,95],{"id":94},"_3-uma-imagem-vale-mil-chamados","3. Uma imagem vale mil chamados",[11,97,98],{},"Um print vale mais que três parágrafos. Um vídeo curto vale mais que o print. Eles mostram de\numa vez o que aconteceu, em que tela, com quais dados — coisas que a gente sempre esquece de\nescrever. Se dá para gravar a tela reproduzindo o erro, grave. É o tipo de esforço de dez\nsegundos que economiza horas do outro lado.",[21,100,102],{"id":101},"_4-o-que-você-esperava-vs-o-que-aconteceu","4. O que você esperava vs. o que aconteceu",[11,104,105,106,109,110,113],{},"Este é o coração do report. Diga, em duas linhas, o que ",[29,107,108],{},"deveria"," ter acontecido e o que\n",[29,111,112],{},"de fato"," aconteceu. Essa diferença é o bug.",[38,115,116,122],{},[11,117,118,121],{},[29,119,120],{},"Resultado esperado:"," ao clicar em \"Trocar foto\", abrir a janela para escolher a imagem.",[11,123,124,127],{},[29,125,126],{},"Resultado atual:"," o botão \"Trocar foto\" nem aparece.",[11,129,130],{},"Sem essa comparação, quem desenvolve precisa adivinhar qual era a sua expectativa — e às vezes\no \"erro\" é só uma tela funcionando diferente do que você imaginava.",[21,132,134],{"id":133},"_5-o-passo-a-passo-para-reproduzir","5. O passo a passo para reproduzir",[11,136,137,138,142],{},"Essa é a parte mais valiosa e a mais esquecida. Assuma que quem vai consertar não faz ideia de\ncomo chegar no erro. Como ",[139,140,141],"em",{},"você"," chegou lá?",[144,145,146,150,153,156],"ol",{},[147,148,149],"li",{},"Entrar em \"Meu perfil\"",[147,151,152],{},"Clicar em \"Trocar foto\"",[147,154,155],{},"Passar o mouse sobre a foto atual",[147,157,158],{},"Clicar para trocar",[11,160,161],{},"Use uma lista numerada. E, se você testou algumas vezes, diga com que frequência o erro\naparece — \"acontece toda vez\" é uma informação diferente de \"aconteceu uma vez só\".",[38,163,164],{},[11,165,166],{},"Se você mesmo não consegue reproduzir o erro de novo, quem desenvolve dificilmente vai\nconseguir. Tente refazer o caminho antes de abrir o chamado.",[11,168,169],{},"Bug que se reproduz sempre é bem mais fácil de caçar do que bug que aparece de vez em quando.",[21,171,173],{"id":172},"_6-o-ambiente-onde-aconteceu","6. O ambiente onde aconteceu",[11,175,176],{},"O mesmo sistema pode se comportar de formas diferentes dependendo de onde é usado. Alguns\ndetalhes fazem muita diferença:",[178,179,180,186,192],"ul",{},[147,181,182,185],{},[29,183,184],{},"Navegador"," (Chrome, Safari, Firefox…) e, se souber, a versão.",[147,187,188,191],{},[29,189,190],{},"Aparelho e sistema"," — celular ou computador, Android, iPhone, Windows.",[147,193,194,197],{},[29,195,196],{},"Tamanho da tela"," — vários bugs só aparecem no celular ou só na tela grande.",[11,199,200],{},"Você não precisa virar especialista. Só diga de onde estava acessando quando o problema\napareceu.",[21,202,204],{"id":203},"_7-a-url-e-se-der-os-logs-do-console","7. A URL e, se der, os logs do console",[11,206,207,210,211,215],{},[29,208,209],{},"A URL"," é simples e quase sempre esquecida. O endereço da página (aquele ",[212,213,214],"code",{},"https://..."," lá\nem cima) diz exatamente em que ponto do sistema você estava. Copie e cole.",[11,217,218,221,222,225,226,229],{},[29,219,220],{},"Os logs do console"," são um bônus técnico. Muitos erros deixam um rastro escondido que\naparece ao apertar ",[212,223,224],{},"F12"," (ou ",[212,227,228],{},"Ctrl + Shift + I",") no navegador, na aba \"Console\". Se você se\nsentir à vontade para tirar um print dessa tela, ótimo — pode conter a resposta exata. Se não,\ntudo bem: os itens anteriores já resolvem a maioria dos casos.",[21,231,233],{"id":232},"_8-diga-o-quanto-dói","8. Diga o quanto dói",[11,235,236],{},"Ajude a definir a prioridade. Nem todo bug é urgente, e tratar tudo como emergência faz o que\né realmente crítico se perder no meio. Vale separar duas coisas:",[178,238,239,245],{},[147,240,241,244],{},[29,242,243],{},"Gravidade"," — o quanto atrapalha. Impede de trabalhar? Trava uma venda? Ou é um detalhe\nvisual que incomoda mas dá para conviver?",[147,246,247,250],{},[29,248,249],{},"Urgência"," — o quão rápido precisa ser resolvido para o seu negócio.",[38,252,253],{},[11,254,255],{},"\"O botão de finalizar pedido não funciona, ninguém consegue comprar\" e \"a fonte do rodapé\nestá um pouco grande\" são os dois bugs — mas não disputam a mesma fila.",[21,257,259],{"id":258},"_9-cinco-hábitos-que-fazem-a-diferença","9. Cinco hábitos que fazem a diferença",[178,261,262,268,274,280,286],{},[147,263,264,267],{},[29,265,266],{},"Um bug, um chamado."," Não junte três problemas num relato só; cada um vira difícil de\nacompanhar e de fechar.",[147,269,270,273],{},[29,271,272],{},"Procure antes de abrir."," Talvez o problema já tenha sido relatado — evita trabalho\nrepetido dos dois lados.",[147,275,276,279],{},[29,277,278],{},"Reproduza antes de relatar."," Se você mesmo não consegue refazer o erro, quem desenvolve\ndificilmente vai conseguir.",[147,281,282,285],{},[29,283,284],{},"Foque no problema técnico."," Deixe ideias e sugestões de melhoria para outro momento; no\nchamado, o que importa é o que quebrou.",[147,287,288,291],{},[29,289,290],{},"Registre num lugar só."," Um canal combinado — e-mail, uma ferramenta, uma planilha — vale\nmais do que mensagens espalhadas em três aplicativos.",[21,293,295],{"id":294},"o-report-é-uma-conversa","O report é uma conversa",[11,297,298],{},"No fim, reportar bug bem é uma forma de colaboração. Bugs acontecem; o que decide a rapidez da\nsolução é quão claro chega a informação. Um relato caprichado poupa idas e vindas, respeita o\ntempo de quem desenvolve e devolve o problema resolvido mais cedo para você.",[11,300,301],{},"Na ChavesTech, esse ping-pong quase não existe: como você fala direto com quem desenvolve, um\nprint no lugar certo e duas frases bem colocadas já colocam a correção em andamento. Não há\numa camada de suporte traduzindo o seu problema para outra pessoa — a sua descrição chega\ninteira em quem vai resolver. E é assim que bug deixa de ser dor de cabeça e volta a ser o que\nsempre foi: parte normal de manter um software vivo.",{"title":303,"searchDepth":304,"depth":304,"links":305},"",2,[306,307,308,309,310,311,312,313,314,315],{"id":23,"depth":304,"text":24},{"id":62,"depth":304,"text":63},{"id":94,"depth":304,"text":95},{"id":101,"depth":304,"text":102},{"id":133,"depth":304,"text":134},{"id":172,"depth":304,"text":173},{"id":203,"depth":304,"text":204},{"id":232,"depth":304,"text":233},{"id":258,"depth":304,"text":259},{"id":294,"depth":304,"text":295},"Qualidade","2026-07-14","Um bom relato de erro não é burocracia: é o caminho mais curto até o conserto. Guia prático, com exemplos de report ruim e bom, para quem usa o sistema e precisa avisar quem desenvolve.",false,"md","/img/blog/como-reportar-um-bug.jpg",{},true,null,"/blog/como-reportar-um-bug",7,{"title":5,"description":318},"blog/como-reportar-um-bug",[330,331,332],"bug","qualidade","boas-práticas","b32ItOjRtL1dzyDDYlHYuFiU46GbUNRhiNYQQzF0jF4",[335,324],{"title":336,"path":337,"stem":338,"category":339,"children":-1},"Acessibilidade: os clientes que seu site afasta sem você ver","/blog/acessibilidade-os-clientes-que-seu-site-afasta","blog/acessibilidade-os-clientes-que-seu-site-afasta","Web",1784123994971]