Abrir artículo público de Docs
Permite revisar que una ruta pública de ayuda abre el artículo correcto desde la landing, sin iniciar sesión, y muestra contenido, pasos, validaciones, resultado y media publicada desde el bundle de Docs.
En este artículo
Usa esta guía para comprobar una publicación pública de Docs antes de compartirla con soporte, contenidos o usuarios externos.
El flujo parte de `/docs/acceso/es-iniciar-sesion-nativa?lang=es`, carga el índice público, resuelve el detalle del artículo y muestra lo que esté disponible en `backend/docs-content/articles.json`.
Antes de empezar
- La landing debe estar disponible en `APP_WEB_URL`.
- La landing debe apuntar al backend público mediante `VITE_PUBLIC_API_BASE_URL` o usar el fallback `http://localhost:8081`.
- El backend debe tener `DOCS_CONTENT_PATH` apuntando a un `articles.json` válido o usar `./docs-content`.
- El bundle debe contener el artículo en español con sección `acceso` y slug `es-iniciar-sesion-nativa`.
- Para revisar media publicada, `DOCS_ASSETS_PATH` debe contener el asset referenciado por `media.src`.
Instrucciones
- 1.
Abrir la ruta pública del artículo
Abre `APP_WEB_URL/docs/acceso/es-iniciar-sesion-nativa?lang=es`. La pantalla pública de Docs debe cargar sin pedir usuario, contraseña, organización ni ubicación. Si se entra desde `/manual/...` o `/wiki/...`, la vista es la misma y los enlaces internos vuelven a `/docs/...`.
- 2.
Confirmar idioma, dispositivo y tema
Comprueba que el artículo se muestra en español y que el selector `Dispositivo` refleja la variante usada. Si se cambia el dispositivo, la pantalla vuelve a pedir índice y detalle con `locale`, `platform` y `theme`, pero no cambia la ruta del navegador.
- 3.
Revisar el contenido publicado
Verifica que aparecen título, resumen, aviso de `Reportes y mejoras`, media principal si está publicada, requisitos, pasos, validaciones, resultado, enlaces relacionados y tabla de contenidos. El detalle solo debe cargarse después de encontrar en el índice un `DocsArticleSummary` con `section_slug=acceso` y `slug=es-iniciar-sesion-nativa`.
- 4.
Comprobar el contrato público
Para una revisión técnica de publicación, abre `GET /api/public/docs/acceso/es-iniciar-sesion-nativa?locale=es&platform=mobile&theme=light` y confirma que la respuesta incluye `version`, `locale`, `platform`, `theme`, `section` y `article`.
- 5.
Verificar la media publicada
Si el artículo devuelve `media.src`, comprueba que se sirve desde `/api/public/docs/assets/...`. Para este caso, la variante esperada es `/api/public/docs/assets/iphone/light/es/auth-native-login/auth-native-login-validation-clip.mp4`.
- 6.
Gestionar estados no disponibles
Si el índice no contiene el artículo, el detalle falla o el asset no existe bajo `DOCS_ASSETS_PATH`, registra el problema como brecha de bundle, configuración o publicación de media. La UI pública no debe presentar datos parciales como válidos.
Validaciones y límites
- La acción es pública: cualquier visitante puede leer el artículo si está en el bundle.
- La ruta canónica del artículo es `/docs/{sectionSlug}/{articleSlug}` aunque existan alias `/manual` y `/wiki`.
- `locale` queda limitado a `es` o `en`; la landing cae a inglés si su idioma no está entre los locales generados.
- `platform` se normaliza a `mobile`, `tablet` o `web`; `theme` solo distingue `dark` y trata el resto como `light`.
- El endpoint público solo permite `GET` y `HEAD`; otros métodos devuelven `405 metodo no permitido`.
- Los assets públicos se limpian y solo se sirven si la ruta queda dentro de `DOCS_ASSETS_PATH`.
- El bundle verificado declara `version=2026-06-18`; si se esperan cambios posteriores, deben estar regenerados en `backend/docs-content/articles.json`.
Resultado esperado
El operador confirma que el artículo público de Docs se abre desde la landing, usa el contrato público correcto y muestra solo contenido y media publicados desde el bundle.