Pular para o conteúdo
Felipe Sousa

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.

FrontendAppSecDevOps/Infra

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

Stack

Next.jsReactTypeScriptTailwind CSSnext-intlZodVitestVercelGitHub Actions