Operacao

O que mudou na base tecnica

Esta refatoracao reorganizou o projeto para que o site principal, a documentacao e a camada serverless tenham uma historia unica. A configuracao do VitePress agora e centralizada, o tema passou a ser orientado por tokens e o conteudo principal saiu de um markdown gigante para uma estrutura orientada por dados.

Principios operacionais

Conteudo orientado por dados

O mesmo catalogo compartilhado alimenta site, APIs, exports e paginas derivadas, reduzindo drift entre narrativa, runtime e operacao.

SEO e distribuicao

Robots, sitemap, schema.org, llms.txt, PWA e canais publicos trabalham em conjunto para reforcar descoberta e distribuicao.

API auditavel

Rotas pequenas com metadata de request, filtros explicitos e payloads previsiveis tornam discovery, troubleshooting e automacao mais simples.

Operacao previsivel

Scripts, health checks, matrix-check, Docker local e comandos documentados tornam a evolucao menos fragil e mais repetivel.

Dossiers operacionais

Operacao

Fluxos, quality gates e conexoes entre runtime e narrativa.

Cada dossier operacional liga rotas, stacks, categorias e projetos para deixar a leitura da base menos abstrata.

Export JSONEndpoint operacao

Dossier operacional

3 projetos

Conteudo orientado por dados

O mesmo catalogo compartilhado alimenta site, APIs, exports e paginas derivadas, reduzindo drift entre narrativa, runtime e operacao.

Sinais

• catalogo central reaproveitado por tema, workbench, discovery e exports
• geracao deterministica de artefatos publicos antes de dev, test e build
• dossiers e filtros derivados do mesmo inventario canonico

Quality gates

• npm run site:export
• npm test
• npm run build

Abrir dossierVer payload

Dossier operacional

3 projetos

SEO e distribuicao

Robots, sitemap, schema.org, llms.txt, PWA e canais publicos trabalham em conjunto para reforcar descoberta e distribuicao.

Sinais

• sitemap e metadados estruturados publicados junto com o build
• llms.txt, robots.txt e rotas principais alinhados a um inventario auditavel
• site principal, portal complementar e perfil tecnico reforcando o mesmo posicionamento

Quality gates

• npm run site:export
• npm run build

Abrir dossierVer payload

Dossier operacional

3 projetos

API auditavel

Rotas pequenas com metadata de request, filtros explicitos e payloads previsiveis tornam discovery, troubleshooting e automacao mais simples.

Sinais

• request_id, timestamp, path, method e query em todos os envelopes
• filtros simples que evitam baixar payloads inteiros sem necessidade
• endpoints e exports refletindo o mesmo estado do catalogo

Quality gates

• npm run site:export
• npm test

Abrir dossierVer payload

Dossier operacional

4 projetos

Operacao previsivel

Scripts, health checks, matrix-check, Docker local e comandos documentados tornam a evolucao menos fragil e mais repetivel.

Sinais

• runtime commands versionados no proprio projeto
• quality gates curtos e combinaveis para validar o caminho oficial
• readiness pensado por stack, projeto e operacao

Quality gates

• npm run site:export
• npm run format:check
• npm run lint
• npm test
• npm run build
• npm run matrix:check

Abrir dossierVer payload

Esteira local

Quality gates

Fluxo minimo para evoluir com seguranca

• npm run site:export
• npm run format:check
• npm run lint
• npm test
• npm run build
• npm run matrix:check

API minima e auditavel

Cada resposta da API devolve um envelope com request_id, timestamp, metodo, path, query e payload explicito. Isso facilita diagnostico, observabilidade e consumo por futuras automacoes sem depender de logs implícitos.

Os endpoints de portfolio, discovery, capacidades, stacks e projects tambem aceitam filtros simples por query string, o que ajuda a montar automacoes e inspeções sem precisar baixar o payload inteiro.

GET

/api/health

Status operacional e metadados de request.

GET

/api/openapi.json

Contrato OpenAPI 3.1 da camada publica e auditavel.

GET

/api/v1/openapi.json

Alias versionado do contrato OpenAPI para integracoes e tooling.

GET

/api/profile

Resumo institucional com canais e especialidades.

GET

/api/links

Catalogo de links publicos da marca e da conta pessoal.

GET

/api/catalog

Catalogo compartilhado que alimenta o site e a camada publica.

GET

/api/audit

Snapshot de contagem, rotas, superficies e exportacoes publicas.

GET

/api/discovery

Inventario plano de recursos publicos para filtros, automacao e exploracao.

GET

/api/portfolio

Snapshot filtravel dos casos, stacks, categorias e sinais do portfolio.

GET

/api/categories

Diretorio tematico por categoria com sinais, stacks, capacidades e relacoes operacionais.

GET

/api/categories/:slug

Dossier aprofundado de uma categoria com portfolio, projetos, capacidades e operacao ligada.

GET

/api/capabilities

Dominios de capacidade, tecnologias e modos de entrega do laboratorio.

GET

/api/stacks

Mapa das tecnologias recorrentes com conexoes entre portfolio e capacidades.

GET

/api/stacks/:slug

Dossier aprofundado de uma stack com projetos ligados, comandos uteis e operacao relacionada.

GET

/api/projects

Diretorio filtravel dos dossiers tecnicos e operacionais por projeto.

GET

/api/projects/:slug

Detalhe de um dossier especifico com relacoes, comandos e superficies.

GET

/api/operations

Dossiers operacionais com quality gates, rotas, stacks e projetos conectados.

GET

/api/operations/:slug

Detalhe de um dossier operacional especifico para leitura profunda por fluxo.

Variaveis opcionais

• VITEPRESS_SITE_URL: substitui a URL canonica e a base de SEO.
• VITEPRESS_GA_MEASUREMENT_ID: injeta Google Analytics 4 quando necessario.
• VITEPRESS_GTM_ID: habilita Google Tag Manager sem hardcode no tema.
• VITEPRESS_ADSENSE_CLIENT: injeta o client do AdSense apenas em ambientes que pedem monetizacao.
• VITEPRESS_ENABLE_SW: controla o registro do service worker.