API e Auditoria

Visao geral

Esta pagina concentra os recursos dinamicos e auditaveis do projeto. O objetivo e permitir inspecao facil da camada publica sem depender apenas do build ou da leitura do codigo.

OpenAPI publico

Contrato padrao

Swagger UI em /openapi/ e contrato JSON em /api/openapi.json.

O projeto tambem publica o alias versionado /api/v1/openapi.json e aliases de navegacao em /docs/ e /swagger-ui.html.

Endpoints disponiveis

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.

Snapshot atual

Audit snapshot

75 paginas, 18 endpoints e 8 dossiers publicados.

Os exports publicos ficam disponiveis em /data/site-catalog.json, /data/site-audit.json, /data/site-discovery.json, /data/site-portfolio.json, /data/site-categories.json, /data/site-projects.json, /data/site-capabilities.json e /data/site-stacks.json e /data/site-operations.json e /llms.txt, alem de um /robots.txt coerente com o sitemap.

Workbench vivo

Workbench

Inspecao viva dos recursos publicos.

Este painel consulta a API minima e os exports estaticos gerados do mesmo catalogo compartilhado. Ele ajuda a validar payloads, request IDs, inventario de discovery e consistencia operacional sem sair do site.

0/0 recursos carregados

Filtros uteis

• /api/portfolio?category=docs: filtra o portfolio por categoria.
• /api/categories: retorna os recortes tematicos por categoria.
• /api/categories/docs: abre o dossier de uma categoria especifica.
• /api/portfolio?stack=Docker: lista apenas casos ligados a uma stack.
• /api/projects?capability=Platform%20engineering: cruza dossiers por dominio operacional.
• /api/projects/node-vitepress: retorna o detalhe de um dossier especifico.
• /api/discovery?kind=stack&q=next: restringe o inventario por tipo e busca.
• /api/capabilities?q=observabilidade: busca dominios e modos de entrega.
• /api/stacks?category=brand&q=seo: cruza tecnologia com categoria de caso.
• /api/stacks/docker: abre o dossier aprofundado de uma stack.
• /api/operations: lista os dossiers operacionais publicados.
• /api/operations/api-auditavel: abre um fluxo operacional especifico.

Quality gates

Operacao local

Esteira recomendada para manter consistencia

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