Blueprint
Um laboratório de engenharia bilíngue baseado em trabalho original e decisões documentadas.
A pergunta
Como um laboratório pessoal pode tornar decisões de engenharia visíveis sem se transformar em um currículo? O Blueprint organiza seu trabalho público em Builds, Experimentos e Notas.
Arquitetura
A v1 aprovada usa Next.js, TypeScript, Tailwind CSS e MDX versionado no repositório. O conteúdo público é gerado durante o build. O inglês é o idioma de origem; traduções revisadas em pt-BR ficam em /pt.
Um único registro validado de conteúdo conecta rotas de artigos, listagens, traduções e metadados de SEO. A v1 não precisa de banco de dados, autenticação ou CMS.
Decisões e trade-offs
- A geração estática favorece deploy simples e conteúdo revisável. Atualizações de conteúdo exigem um novo build.
- O MDX no repositório mantém as mudanças visíveis em pull requests. Autores precisam revisar MDX como entrada do build.
- A tradução ocorre durante a autoria, preservando nomes técnicos e código. A publicação em inglês não depende da disponibilidade de tradução.
- Vercel Web Analytics é a solução mínima de analytics aprovada. As métricas permanecem privadas.
Limite atual
O Blueprint está em implementação. O deploy de produção e o lançamento público continuam pendentes. Esta nota não afirma resultados de performance, experimentos concluídos ou resultados de deploy.
Veja o propósito do laboratório e a nota sobre organização de repositórios.
Log de engenharia
Primeiro deploy de produção — resolução pendente
O primeiro deploy de produção na Vercel falhou depois que o Next.js concluiu a geração das rotas estáticas. A falha ocorreu na verificação personalizada de output após o build do Blueprint: ela esperava .next/server/app/index.html, um caminho interno fixo de output do Next.js que não estava presente no ambiente de build da Vercel.
A lição de engenharia é que verificações personalizadas não devem depender de caminhos de output do framework que não sejam documentados ou que variem conforme o ambiente. A resolução continua pendente até que o deploy de produção corrigido e o domínio personalizado blueprint.app.br com HTTPS sejam verificados com sucesso.