Flujo de desarrollo

npm install
npm run sync
npm run validate:openapi
npm run build

Para añadir un sistema:

Cree y mantenga docs/ y openapi/openapi.yaml en el repositorio dueño.
Regístrelo una sola vez en config/systems.mjs.
Añada su página de referencia en docs/api/.
Añada la guía de uso en docs/systems/<id>/user-guide/ (solo en optrax-docs).
Ejecute la validación y build antes de desplegar.

No se copian secretos, .env ni credenciales al portal.