FelpsXP Hub
Este site: um portfólio reconstruído do zero em um repositório público, sem banco e sem login, com cada decisão registrada em ADR e segurança e testes rodando em cada pull request.
Problema
A versão anterior do Hub vivia dentro de um monorepo privado, acoplada à autenticação e ao banco da plataforma. O portfólio não podia ser mostrado como código, e uma página pública dependia de infraestrutura de que não precisava.
Solução
Recomeçar em um repositório público e independente, em vez de extrair o histórico antigo (ADR-0002). O conteúdo é TypeScript tipado e validado com Zod no build, as páginas em português e inglês foram pré-renderizadas e servidas pela CDN até a CSP estrita exigir um nonce por requisição (ADR-0009), e a v1 não tem banco nem autenticação, porque nenhuma página pública precisa deles (ADR-0003).
Destaques de arquitetura
- Sem banco e sem login, não há dado de visitante para vazar; as páginas nascem de conteúdo tipado, nos dois idiomas
- Schemas Zod como fonte única da verdade: os tipos TypeScript são inferidos deles, e o build falha apontando registro e campo quando algo está errado, incluindo links que não sejam HTTPS
- Headers de segurança desde o primeiro commit: CSP sem unsafe-eval em produção, frame-ancestors none, nosniff e Referrer-Policy restritiva; cookie de idioma Secure e SameSite
- Tema claro e escuro sem flash, com um script inline que só aceita dois valores e carrega o nonce de cada requisição
- CSP estrita com nonce por requisição e strict-dynamic, sem unsafe-inline, em modo report-only até rodar limpa em produção (ADR-0009)
- Idioma como segmento de rota, com hreflang, URL canônica no domínio de produção, sitemap com alternativas e imagem de compartilhamento gerada no build
- Toda decisão cara de reverter vira ADR antes do código; PRs pequenos com squash; CI com gitleaks, lint, typecheck, testes e build
Desafios
- O Next.js 16 renderiza o 404 no cliente quando o layout raiz fica sob um segmento dinâmico. Antes de culpar a mudança, a mesma falha foi reproduzida na main; a limitação ficou documentada em vez de adotar uma flag experimental
- A imagem de compartilhamento do idioma padrão passava por um redirecionamento 307, que robôs de redes sociais não seguem em imagens. O problema só apareceu servindo o build de produção, e hoje um teste impede a regressão
- Um ADR aceito descrevia a camada de conteúdo de forma diferente do código real. Ele foi corrigido por um novo ADR, sem reescrever o histórico
- O plano registrado era liberar o script de tema por hash SHA-256. Inspecionando o build, cada página trazia um payload de hidratação inline diferente, e um hash sozinho teria quebrado o site inteiro. A alternativa foi decidida em ADR, medida antes e depois e lançada primeiro em modo report-only, com testes que falham a qualquer violação
Responsabilidades
- Arquitetura e registro das decisões em ADRs
- Implementação das páginas, do shell e da camada de conteúdo
- Endurecimento de segurança: headers, cookie, validação e escape de JSON-LD
- Testes, CI e deploy na Vercel
- Conteúdo e internacionalização em português e inglês
Resultados
- Um portfólio que é, ele próprio, a prova: código, histórico, ADRs e pull requests abertos para qualquer revisor
- Nota 100 em acessibilidade, boas práticas e SEO no Lighthouse nas quatro páginas medidas, e CSP estrita sem nenhuma violação na suíte de ponta a ponta
- Uma suíte de testes que cobre schemas, consistência entre idiomas, SEO e as regras de escrita do repositório
Aprendizados
- Recomeçar saiu mais barato que extrair: o histórico antigo trazia acoplamentos e detalhes privados que custariam mais para limpar do que para reconstruir
- Verificar o build servido, não só o código-fonte: os dois bugs mais sutis desta reconstrução só apareceram assim
- Supply chain também é decisão de produto: dependências novas entram numa versão com algumas semanas de vida, não na que saiu ontem