papke-page

Decisões de engenharia

1. 01

   Conteúdo como código

   Tudo — páginas, projetos, experiência, blog — vive em arquivos TypeScript versionados, lidos por um único módulo de acesso. Uma fonte tipada que alimenta o site e o agente ao mesmo tempo: mudou o conteúdo, mudou nos dois.

2. 02

   Agente fundamentado, com guardrails

   O agente só fala sobre mim. Antes de gerar, uma chamada barata decide se a pergunta é pertinente; depois, a base de 49 fatos e 14 respostas preparadas é recuperada por relevância e entra no prompt com as regras que a acompanham (ressalvas, confiança de relato, código só ilustrativo). Rate limit por IP, resistência a injeção de prompt e nada de dado sensível — tudo no tier grátis.

3. 03

   Anonimização como regra — e como teste

   A base do agente nasce de um arquivo de carreira anonimizado de propósito: nenhum fato nomeia instituição, sistema, schema ou colega. A regra não fica só no documento — um teste automatizado falha se qualquer snippet carregar host, schema, usuário ou nome de objeto real. E a auditoria externa confirmou: nada interno chega ao bundle servido.

4. 04

   Bilíngue de ponta a ponta

   PT/EN via next-intl do conteúdo às rotas — 123 chaves por idioma, cada projeto e cada cargo escritos nas duas línguas — e o agente responde no idioma da pergunta.

5. 05

   Segurança verificada de fora

   O site carrega um único recurso externo no browser — o Google Analytics, com aviso na primeira visita e opt-out no rodapé —, então a CSP pôde ser restritiva, liberando nominalmente apenas os domínios do Google. Chaves só no servidor, APIs só POST com CORS fechado e erros sem stack trace. Depois de blindar, auditei de fora como um atacante: rotas sensíveis, bundle, source maps, cookies. Zero vazamento — e a proteção anti-bot da Vercel barrou minha própria varredura em rajada.

6. 06

   Capas em SVG feitas à mão

   Em vez de imagens genéricas, cada projeto tem uma capa em SVG desenhada à mão na mesma linguagem visual (dark + âmbar): diagramas de arquitetura, pipelines, o ecossistema do banco. Leves, nítidas em qualquer tela, validadas como XML antes de entrar — e, quando o projeto tem material real, com fotos e telas embutidas.

7. 07

   Domínio próprio sem proxy

   O roger.papke.com.br fica na Cloudflare só como DNS (nuvem cinza): um CNAME direto pra Vercel, que emite e renova o SSL sozinha. Sem proxy no meio, sem cache brigando com o Next. O endereço .vercel.app redireciona com 308, e a URL canônica vive num único módulo que alimenta metadata, sitemap e robots.

8. 08

   Deploy contínuo por PR — duas máquinas, uma branch

   Cada mudança passa por Pull Request com tsc, eslint e 42 testes no verde. Duas máquinas trabalham na mesma branch: fetch e rebase antes de cada push, e o histórico segue linear. O merge é decisão humana; a partir dele, a Vercel publica sozinha.

Arquitetura