API and Audit

Overview

This page concentrates the dynamic and auditable resources of the project. The goal is to make inspection of the public layer easy without relying only on the build output or on code reading.

Public OpenAPI

Standard contract

Swagger UI at /openapi/ and JSON contract at /api/openapi.json.

The project also exposes the versioned alias /api/v1/openapi.json and navigation aliases at /docs/ and /swagger-ui.html.

Available endpoints

GET

/api/health

Operational status and request metadata.

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

Institutional summary with channels and specialties.

GET

/api/links

Catalog of public links for the brand and personal account.

GET

/api/catalog

Shared catalog powering the site and public layer.

GET

/api/audit

Snapshot of counts, routes, surfaces and public exports.

GET

/api/discovery

Flat inventory of public resources for filters, automation and exploration.

GET

/api/portfolio

Filterable snapshot of portfolio cases, stacks, categories and signals.

GET

/api/categories

Thematic directory by category with signals, stacks, capabilities and related operations.

GET

/api/categories/:slug

Deep category dossier with portfolio, projects, capabilities and related operations.

GET

/api/capabilities

Capability domains, technologies and delivery modes of the lab.

GET

/api/stacks

Map of recurring technologies with links between portfolio and capabilities.

GET

/api/stacks/:slug

Deep stack dossier with related projects, useful commands and operations.

GET

/api/projects

Filterable directory of technical and operational project dossiers.

GET

/api/projects/:slug

Details of a specific dossier with relations, commands and surfaces.

GET

/api/operations

Operational dossiers with quality gates, routes, stacks and related projects.

GET

/api/operations/:slug

Detailed operational dossier for deeper reading by flow.

Current snapshot

Audit snapshot

75 pages, 18 endpoints and 8 published dossiers.

Public exports are available through /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, /data/site-stacks.json, /data/site-operations.json and /llms.txt.

Live workbench

Workbench

Live inspection of public resources.

This panel queries the minimal API and static exports generated from the same shared catalog. It helps validate payloads, request IDs, discovery inventory and operational consistency without leaving the site.

0/0 resources loaded

Useful filters

• /api/portfolio?category=docs&lang=en-US: filter the portfolio by category.
• /api/categories/docs?lang=en-US: open a category dossier.
• /api/projects/node-vitepress?lang=en-US: get a project dossier detail.
• /api/stacks/docker?lang=en-US: open a deep stack dossier.
• /api/operations/api-auditavel?lang=en-US: inspect an operational dossier.

Quality gates

Local operations

Recommended pipeline to keep consistency

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