CONTEXTO
Tengo un sitio web existente de Quantum. Debes integrar un portal de documentación técnica para la API externa de Quantum Nube, específicamente Facturación Electrónica (FE) y Documento Soporte Electrónico (DSE). Te entregaré la carpeta QUANTUM_API_FE_DSE_WEB_V1.

OBJETIVO
Integrar la documentación dentro del diseño y arquitectura del sitio existente, no crear un sitio paralelo. Quiero una experiencia de developer docs profesional tipo Stripe/Twilio: sidebar, buscador, headings con anclas, badges GET/POST, scopes, tablas responsivas, bloques de código copiables, tabs cURL/JavaScript/Python/PHP, callouts y referencia OpenAPI.

FUENTE DE VERDAD
1. openapi/quantum-api-v1.yaml = contrato técnico.
2. docs/*.md y MASTER_DOCUMENTACION_API_FE_DSE.md = explicación humana.
3. website/nav.json = navegación sugerida.
4. postman/*.json = descargas Postman.
5. examples/* = ejemplos.

ANTES DE MODIFICAR
- Diagnostica framework, router, componentes, sistema de estilos y layout actual.
- Dime qué archivos vas a modificar/crear y por qué.
- Conserva header/footer/tipografía/espaciado de la marca actual.
- No elimines contenido existente.
- No cambies rutas de negocio ni backend de la API.

ARQUITECTURA DE RUTAS DESEADA
/developers/api
/developers/api/quickstart
/developers/api/authentication
/developers/api/fe
/developers/api/dse
/developers/api/idempotency
/developers/api/errors
/developers/api/security
/developers/api/reference
/developers/api/changelog
/developers/downloads/openapi.yaml
/developers/downloads/postman-collection.json

OPENAPI
- Renderiza openapi/quantum-api-v1.yaml con la solución compatible más limpia del stack existente (preferible Scalar o Redoc; Swagger UI también es aceptable si encaja mejor).
- No dupliques manualmente todos los endpoints si el renderer ya los genera.
- La referencia debe permitir navegar por FE, DSE y DIAN/GetAcquirer.

SEGURIDAD OBLIGATORIA
- NUNCA hardcodear un token real.
- No crear campos con un Bearer Token persistido en localStorage para una página pública.
- No ejecutar llamadas reales de producción desde frontend público.
- Los ejemplos usan API_TOKEN/YOUR_API_TOKEN.
- Si quieres Try it real, primero propón un backend/BFF o portal autenticado; no lo implementes con secreto en browser sin aprobación.

RESPONSIVE
- Desktop: sidebar + contenido; TOC derecho si hay espacio.
- Mobile: sidebar como drawer; tablas y código con scroll horizontal; botones y tipografía legibles.
- Evita cards gigantes y espacios excesivos.

CALIDAD
- Añade botones Copy en código.
- Añade deep links por heading.
- Añade links de descarga OpenAPI/Postman.
- Añade buscador por heading/ruta si el stack lo permite.
- Marca claramente advertencias: FE 8%=INC, DSE Idempotency-Key y DSE iva vs porcentaje_iva.
- La documentación no debe inventar endpoints que no estén en openapi/quantum-api-v1.yaml.

ENTREGA
- Resume cambios.
- Lista archivos creados/modificados.
- Ejecuta build/lint del proyecto.
- Corrige errores antes de entregar.
- Entrega capturas o describe validación desktop/mobile si tienes browser visual disponible.
