O Problema do Pastel: Entrega Urgente e API Real

Quem já trabalhou em consultoria sabe bem essa cena. O cliente demora semanas para fornecer os requisitos: texto do e-mail, acesso ao sistema, layout da landing page. Quando finalmente entrega tudo, espera que esteja pronto no dia seguinte. A regra é simples: não existe a terceira opção, "rápido e completo". Quando parece que existe, é porque alguma coisa ficou escondida. E foi exatamente isso que aconteceu nesta história.

Fritar pastel: o mock que escondeu o volume da API a 3 horas do deploy

O Front em Next.js e as APIs do Cliente

Numa consultoria em que trabalhei, pegamos um desses pastéis. Era um front em Next. js que consumia as APIs do cliente para montar as telas. O problema: o cliente demorou para nos passar as APIs que ele usava para consultar o serviço. E o prazo de entrega não mudou. A decisão foi a que quase todo time toma nessa situação: mockar as APIs. Criamos respostas falsas com o formato que esperávamos, construímos as telas em cima delas e combinamos o seguinte: quando as APIs reais chegarem, era só apontar as requisições para os endereços certos.

A Surpresa: Dados Excessivos

Na prática, o mock tinha um defeito que só aparece tarde demais: ele responde o que você imagina, não o que a API real devolve. O formato até pode bater. O volume, quase nunca. Quando as APIs reais chegaram, veio a surpresa: eram muito mais dados do que o sistema aguentava. O mock devolvia uma lista pequena e bem comportada. A API real devolvia tudo. A API não tinha paginação. Não havia como pedir "os primeiros 20". Cada chamada trazia a lista inteira.

A Tela Absurdamente Lenta

js, a página é renderizada primeiro no servidor, que manda o HTML pronto para o navegador. Depois, o React "acorda" esse HTML no navegador e passa a controlar a página. Isso se chama hidratação. Para dar certo, o React precisa gerar no navegador exatamente o mesmo HTML que o servidor gerou. Se alguma coisa diferir, ele reclama do erro de hidratação, e a página pode piscar, perder interatividade ou ser refeita do zero no navegador. Com uma lista enorme, componentes pesados e dados que podiam mudar entre a renderização no servidor e a no navegador, as chances de diferença se multiplicam. Junte isso com a lentidão, e a tela que funcionava lindamente com o mock virou outra coisa.

A Solução: Simplificar Componentes e Renderizações

Com esse prazo, não dava para consertar a causa: a API era do cliente, e não ia ganhar paginação até o fim da tarde. O objetivo passou a ser outro: entregar algo que funcionasse na apresentação, sabendo que seria provisório. Se a API não pagina, o front pagina. A API continuava devolvendo tudo, mas a tela passou a renderizar só um pedaço por vez.

A Apresentação: Saída a Tempo, Mas com Dúvidas

O deploy saiu e a apresentação aconteceu no horário. Mas o cliente notou que a tela tinha elementos visuais mais simples do que o combinado. Explicamos o que tinha acontecido: foi um problema técnico, causado pelo volume de dados da API, e na semana seguinte teríamos a tela pixel perfect, do jeito que estava no Figma, que era o que tínhamos combinado.

Conclusão

A urgência de entrega levou a um mock de API que não previu o volume de dados reais. A solução foi simplificar componentes e renderizações para garantir a apresentação em tempo. A dívida técnica foi saldada na semana seguinte, mas a apresentação foi feita com uma tela mais simples do que o combinado inicialmente.

Comentários