Fernando Parreiras — site pessoal

Código-fonte do hub público de Fernando Parreiras: um ponto de entrada para advisory executivo, palestras, apresentações, cases, iniciativas empresariais e conteúdo sobre inteligência artificial, liderança e tecnologia humanizada.

O que este projeto entrega

• posicionamento profissional e apresentação das iniciativas Trustyu.ai e Tech Human;
• páginas de soluções, advisory, conselho, transformação com IA e palestras;
• área de conhecimento com artigos, trilhas, filtros e feed RSS;
• Docks com apresentações públicas, roteiro, download, QR e páginas próprias;
• captação consentida de materiais e conversas, com entrega por email, registro no CRM, retomada e cancelamento;
• cases, livros e outros ativos autorais;
• rotas estáticas e metadados próprios para descoberta, SEO e agentes de IA;
• experiência responsiva, navegação por teclado e suporte a movimento reduzido;
• controles de segurança, cache e redirecionamento mantidos no próprio repositório.

Rotas principais

Rota	Conteúdo
/	Visão geral, proposta de valor e caminhos por intenção
/solucoes/	Advisory executivo, conselho e transformação com tecnologia e IA
/palestras/	Temas, formatos e chamada para conversa
/negocios/	Iniciativas e ecossistema empresarial
/cases/	Trabalhos e resultados selecionados
/conteudos/	Livros, mídia e acervo autoral
/artigos/	Artigos sobre liderança, negócios, carreira e IA
/artigos/:slug/	Leitura individual com metadados e HTML estático
/sobre/	Trajetória, princípios e posicionamento
/contato/	Canais de contato e conversão
/docks/	Biblioteca de apresentações públicas
/docks/:slug/	Apresentação, roteiro, download, QR e pedido consentido de material ou conversa

O acervo de conhecimento é versionado junto com o código. Cada artigo publicado recebe rota estática, metadados Article, entrada no sitemap e item no feed RSS.

Stack

• React 18 e React Router 7;
• Vite 7;
• Tailwind CSS 3 e Framer Motion;
• metadados de página com React Helmet;
• testes de contrato com o test runner nativo do Node.js;
• hospedagem, redirects, headers e cache na Netlify.

Desenvolvimento local

Pré-requisito: Node.js ^20.19.0 ou >=22.12.0. O ambiente de produção usa Node.js 22.

npm ci
npm run dev

O servidor local usa http://localhost:3000.

Validação

Antes de abrir uma PR, execute os mesmos gates usados para validar uma entrega:

npm test
npm run lint
npm run build
npm audit --omit=dev

O build produz o bundle Vite e, em seguida, gera o HTML inicial das rotas públicas e dos artigos, além de robots.txt, sitemap.xml, llms.txt e /artigos/rss.xml a partir das mesmas fontes canônicas.

Conteúdo e publicação

O site não depende de CMS. Navegação, soluções, cases, apresentações, artigos e metadados ficam versionados em src/data/.

src/data/articles.js é a fonte canônica dos artigos disponíveis e do gate de publicação. A fila aprovada fica em src/data/scheduledArticles.js, com um instante scheduledAt explícito para cada texto. Um build inclui somente os artigos cuja data já venceu; os demais permanecem fora das rotas, busca, RSS, sitemap e llms.txt.

Como o site é estático, cada ativação exige um novo build de produção. O calendário e o contrato operacional estão documentados em docs/knowledge/editorial-calendar.md. Rascunhos sem aprovação editorial devem continuar fora dos dois catálogos.

Docks: publicação e relacionamento

O Docks transforma apresentações aprovadas em ativos públicos versionados. O catálogo canônico fica em src/data/docks.js e src/data/presentations.js; o build gera páginas, roteiro, download e QR sem alterar os arquivos-fonte das apresentações.

O pedido de material é explícito e separado das escolhas de complementos, Carta do Fernando e conversa. As Functions registram o snapshot da submissão, exigem recibos do CRM e do provedor de email, retomam falhas parciais com idempotência e mantêm cancelamento e retenção. Um aceite do provedor não deve ser descrito como leitura, resposta ou reunião.

• contrato e limites: docs/docks-lead-capture.md;
• evidência de produção: docs/docks-homologacao-2026-10-05.md;
• privacidade: dados pessoais não entram nos eventos analíticos e jobs são removidos conforme a política documentada.

Estrutura do repositório

src/components/       componentes de seção e primitives de interface
src/pages/            páginas e composição das rotas
src/data/             conteúdo estruturado e metadados canônicos
src/lib/              analytics, navegação e utilitários
netlify/functions/    APIs de captação, entrega, relatório, cancelamento e rotina agendada
public/               imagens, apresentações e arquivos de descoberta
tests/                contratos de acessibilidade, rotas e higiene de produção
tools/                geração de páginas estáticas e arquivos para crawlers
docs/                 estratégia, QA e runbooks operacionais
netlify.toml           build, redirects, CSP, headers e cache

Deploy e segurança

O domínio canônico é fernandoparreiras.com.br; acessos por www são redirecionados para o domínio apex. A configuração da Netlify aplica CSP restritiva às rotas normais e uma política isolada apenas às apresentações autocontidas em /presentations/*.

O procedimento de DNS, verificação e rollback está em docs/netlify-cutover-runbook.md. Evidências de QA versionadas ficam em docs/qa/, nas homologações Docks e em output/playwright/. Segredos permanecem somente no servidor; o cliente público recebe apenas contratos e estados necessários à experiência.

Contribuição

Este é um site pessoal mantido por Fernando Parreiras. Mudanças devem ser propostas por branch e pull request, preservar os gates editoriais e manter testes, lint, build e auditoria de dependências verdes.

Licença

Este repositório não publica uma licença open source. Código, conteúdo e ativos visuais permanecem sob os direitos de seus respectivos titulares.