
O cache que congelava a capa: quando renomear virou mudança de contrato
Trocar a imagem no mesmo caminho não muda nada para quem já baixou. O nome passou a carregar hash do conteúdo, e dois consumidores quebraram no mesmo instante.
27 posts

Trocar a imagem no mesmo caminho não muda nada para quem já baixou. O nome passou a carregar hash do conteúdo, e dois consumidores quebraram no mesmo instante.

A evolução recente do blog: melhorias de acessibilidade WCAG AA, correções de tags, e o ciclo de posts 2/dia. Uma jornada de engenharia de qualidade e consistência.

A suíte E2E derrubou o CI duas vezes com o mesmo sintoma: o servidor de preview não subia. O primeiro culpado tinha nome e endereço. O segundo estava escondido atrás dele, com a mesma assinatura exata. Dois defeitos, um código de saída — e a lição de que tempo de vida também é diagnóstico.

O que o pipeline do LifeLog realmente faz: gate de capas no build, dados de /ocultos gerados em vez de lidos do deploy, e o buraco que sobrou — nada verificava se o que o post afirma é verdade.

Um bloco de shell na última linha de um post já publicado. O mesmo defeito estava em 18 posts, e nenhum dos meus gates olhava o corpo do artigo: um olhava tag, outro olhava par PT/EN. Escrevi o guard que faltava — e a primeira versão dele acusou 9 posts inocentes.

O LifeLog trocou de domínio, o redirect precisou ser host-aware para não apagar a CSP, e no dia seguinte o watchdog auto-healou capas e posts órfãos que tinham sido gerados fora do git.

423 páginas mandavam visitas para a loja e o banco registrava 136 sessões com 1 visita atribuída. A correção foi no build — e no caminho apareceram dois falsos positivos que quase ensinaram a equipe a ignorar o gate.

Uma regra de padronização na camada de borda substituía a política de segurança do site inteiro por uma versão de duas linhas — e só um teste que batia na produção de verdade percebeu.

A migração para Linux nativo derrubou as três postagens diárias: gerenciador de pacotes ausente, scripts com caminhos do Windows e arquivos de estado perdidos. O que foi preciso consertar para o pipeline voltar a andar.

Para avisar os buscadores de que uma mudança é de verdade, o protocolo exige que eu publique na raiz do meu site um arquivo que qualquer um pode ler. É o IndexNow: um segredo que não é segredo, um aviso que chega antes do mundo estar pronto, e um deploy que eu jurava que era meu.

Durante meses olhei para o ponto verde do pipeline como se fosse prova. Quando tirei as duas linhas que engoliam o código de saída dos testes, o primeiro run honesto da história do repositório devolveu 8 falhas em 417 testes. A cura não foi escondê-las de novo: foi dar à dívida um endereço, um dono e um vencimento.

O botão de recusar posts salvava o feedback num arquivo. Mas um arquivo não abre issue, não notifica e não cobra. Um dia a fila silenciosa engoliu um pedido inteiro — e o LifeLog aprendeu que rejeição sem notificação é só descarte educado. A história do /api/recusar e do ciclo que fecha sozinho.

Gate de capas no build, contraste WCAG AA, o 10o projeto no schema, e uma auditoria bug-hunter com zero violacoes. A historia do blog que parou de ser so um blog e virou um sistema com qualidade.

O watchdog de capas que eu construí para garantir imagens boas no blog descobriu um problema que eu não esperava: as capas geradas por IA vinham no formato errado. O browser rejeitava, e eu só descobri porque o próprio watchdog reclamou.

Quatro commits seguidos mexendo na navbar do LifeLog, cada um desfazendo o efeito do anterior. Links que somiam, logo que pulava, botão que flutuava. A lição: refatorar com pressa num asthma de classes é como assar um bolo mudando a receita a cada passo.

Um post que subiu com capa escura me fez construir um sistema de garantia: geração de imagem com fallback em duas camadas e um watchdog silencioso que troca capa ruim sozinho. A história de como o blog parou de depender de um único caminho.

Depois de 5 dias fazendo o círculo nascer do clique no desktop, o mobile ainda usava crossfade — por decisão documentada: clip-path é paint-heavy e trava GPU fraca. Até o Samuel pedir o contrário. E o que tornou possível reverter? Os fixes anti-stutter que já estavam no global.css.

Os cards da home mostravam a data histórica do evento — e a ordem parecia bagunçada (07, 09, 09, 06). A mudança: exibir a data de publicação (pubDate). A história de um detalhe que muda como o blog é percebido.

Cinco dias tentando fazer um círculo de luz nascer exatamente de onde o dedo toca. O CSS parecia certo, o CI passava, mas o usuário via stutter, origem errada e conteúdo apagando. A causa raiz não era o código — era a interação entre View Transitions API, blend modes do Chromium e um node_modules fantasma.

158 commits, 49 posts bilíngues, 4 engines de tema, 59 capas AI, e uma decisão que mudou tudo: matar o robô que escrevia posts sozinho.

Em vez de substituir o circular reveal por crossfade básico, corrigi a causa raiz do stutter em GPU low-end. VT clip-path + fallback limpo.

O momento em que percebi que meu blog de devlogs estava produzindo relatórios, não histórias — e como resolvi isso matando o robô que escrevia posts sozinho.

Sistematei as animações do LifeLog: stagger nos cards, scroll shadow no navbar, micro-interações em tags/pills/search, e uma easing curve única pra tudo.

Removi a animação circular com clip-path que vivia dando stutter e simplifiquei pra crossfade puro no tema do LifeLog.

TagCloud, PostLayout compartilhado, FilterBar turbinada com Fuse.js e tema arrumado — um dia inteiro de melhorias na base do blog.

Estabelecendo a frequência de postagens diárias e resolvendo o pipeline de geração de capas por IA com Cloudflare Workers + FLUX.1 Schnell.

Por que criei um blog pessoal em 2026, a escolha do Astro, e o que esperar daqui pra frente.