Documentação

Esta página documenta a arquitetura WordPress usada neste portfólio. O conteúdo visível pode ser ajustado no editor clássico, enquanto as seções abaixo são renderizadas pelo template do tema.
O objetivo é demonstrar arquitetura WordPress customizada, integrações de marketing, otimização runtime, uma camada de cache de página e apresentação de projetos baseada em evidências.

Estrutura da build

O site é dividido entre um tema customizado, um plugin toolkit para arquitetura de conteúdo e dois MU plugins para comportamento runtime e cache de página. Isso mantém a edição simples no wp-admin enquanto preserva ownership de código, modelagem de conteúdo e fluxos de páginas especiais no repositório.

• wp-content/themes/lago-process: templates do tema do portfólio, layout, CSS, navegação e renderização de páginas.
• wp-content/plugins/lucas-portfolio-toolkit: CPTs, arquitetura de custom fields, menus de admin, opções e campos editáveis específicos de página.
• wp-content/mu-plugins/portfolio-runtime-optimization.php: limpeza runtime, trackers adiados, tratamento de imagens, sitemap e hardening do frontend.
• wp-content/mu-plugins/portfolio-page-cache.php: cache de página para visitantes anônimos com regras de bypass e invalidação.

Modelo de edição

O projeto desativa Gutenberg intencionalmente e trabalha com editor clássico mais campos estruturados. O objetivo é demonstrar uma build WordPress disciplinada, editável no admin sem depender de page builders para o layout principal do portfólio.

• Páginas mantêm conteúdo longo no editor clássico.
• Projetos, marcas e visuais de assessment usam post types dedicados com meta fields estruturados.
• Templates especiais como home, documentation, plugin-code, rollout, versioning, projects, brands, resume/CV, schedule, assessment e bonus assessment expõem campos dedicados no wp-admin.
• Header, footer, defaults de SEO e labels compartilhados são gerenciados na tela Site Settings do portfólio.

Tipos de conteúdo e o que controlam

O portfólio é organizado em modelos de conteúdo reais para manter site público, fluxo de admin e saída REST alinhados. A camada de CPTs cuida das entidades repetíveis, enquanto grupos de campos de página controlam fluxos únicos como currículo e páginas de assessment.

• App Projects: sites de produto, apps de marketing e casos de aplicações web.
• CRM Projects: captura de leads, cadências, integrações e camadas de automação.
• Delivery Projects: comércio operacional e sistemas de pedidos/admin.
• PMS Projects: sistemas de hospitalidade, booking, operações e fluxos de hotelaria.
• Fusion AI Projects: assistentes, chatbot e casos relacionados à OpenAI.
• Served Brands: sites de hospitalidade e evidências de entrega no nível da marca.
• Assessment Visuals: entradas visuais reutilizáveis usadas pelas galerias do template de take-home.
• Resume / CV: grupo especial de campos para resumo, timeline de experiência, skills, infraestrutura e idiomas.
• Assessment pages: grupos especiais de campos para os fluxos Verdian take-home e bonus assessment.

Grupos de custom fields

Os custom fields são separados por contexto de edição, então cada tela expõe apenas os dados de que precisa. Isso mantém o admin enxuto enquanto preserva um contrato de conteúdo estruturado para o tema.

• Campos dos CPTs de projeto: summary, client type, stack, lista de stack-used, integrated APIs, integrations, automation flow, admin features, code evidence, source path, URLs, credenciais temporárias, results, icon e seções flexíveis em JSON.
• Campos dos CPTs de marca: brand summary, brand URL, scope, stack, client type, source path, detalhes de acesso, integrations, results e seções flexíveis em JSON.
• Campos da página documentation: hero eyebrow, lede, summary cards em JSON, navegação em JSON e blocos de seção em JSON.
• Campos da página Resume / CV: meta description, badge, role, location, contact details, summary, experience em JSON, skills em JSON, infrastructure em JSON e languages em JSON.
• Campos do assessment Verdian: hero copy bilíngue, itens de competency assessment, seções de analytics, seções de arquitetura, perguntas de crescimento, blocos de referência visual, blocos de disclosure de AI e CTA/conteúdo final.
• Campos do bonus assessment: intro bilíngue, environment, implementation, explicação do plugin e seções de fechamento.
• Campos de assessment visual: target section, public label, caption, alt override, external image URL e featured image.

Resumo dos plugins e recursos implementados

Três plugins/módulos customizados organizam a build do portfólio.

• Lucas Portfolio Toolkit: registra CPTs, expõe custom fields estruturados para projetos, marcas, assessment visuals e páginas especiais, agrupa telas do portfólio no admin, adiciona metaboxes específicas e fornece Site Settings globais.
• Portfolio Runtime Optimization: remove ruído desnecessário do WordPress, otimiza saída de assets, adia trackers, melhora a marcação de imagens e serve um sitemap leve.
• Portfolio Page Cache: armazena HTML gerado para tráfego GET anônimo, ignora sessões/admin/requisições inseguras e limpa arquivos de cache quando o conteúdo muda.

Operações de admin e controle de cache

O admin do WordPress inclui controles explícitos para source de evidência de código e invalidação de cache, para que o site publicado possa ser atualizado sem acesso ao shell.

• Plugin Code page: o metabox do admin inclui lp_plugin_code_paths, um path real do servidor por linha, já preenchido com plugin atual, MU plugins e arquivos do tema.
• Renderização da code page: o template público lê esses paths diretamente, resolve labels pelo registry quando possível e faz fallback para título/descrição inferidos em arquivos desconhecidos.
• Barra superior do WordPress: a ação Clear Portfolio Cache está disponível para admins e limpa o cache full-page antes do redirect com aviso de sucesso.
• Menu mobile: o header usa estado explícito de abrir/fechar mais submenus colapsáveis no mobile, reduzindo overflow e mantendo o comportamento igual em páginas internas e home.

Guia de conteúdo

Tudo que aparece no site deve ser atualizado em um destes quatro lugares no wp-admin.

• Settings > General e Menus: título do site e navegação principal.
• Lucas Portfolio > Site Settings: marca/subtítulo do header, CTA, texto do footer, defaults de SEO, labels de arquivos e labels compartilhados do single de projeto.
• Pages: body copy e campos específicos de template para documentation, projects, brands, schedule, versioning, Zapier, plugin-code, home, rollout, resume/CV, assessment e bonus assessment.
• Campos de admin de Plugin Code: use a lista de paths reais para decidir exatamente quais arquivos aparecem na página pública de evidência de código.
• CPTs do portfólio: summaries, stacks, integrations, credentials, evidence, icons e featured images dos projetos.
• CPT Assessment Visuals: imagens e captions de galeria usadas dentro da página de assessment.

Evidência de servidor e boas práticas

O próprio site documenta tanto a implementação quanto o raciocínio operacional.

• Os projetos referenciam sistemas reais hospedados neste servidor e expõem detalhes controlados de avaliação por campos do CPT.
• O tema preserva templates semânticos em vez de embutir lógica de apresentação no editor.
• Campos estruturados reduzem quebra acidental de layout e facilitam a governança de conteúdo.
• A performance é tratada de forma conservadora com MU plugins, sem depender apenas de plugins de otimização de terceiros.
• Versionamento, pontos de rollback e páginas de documentação tornam a build mais fácil de revisar e mais segura de evoluir.