Abrir el índice público de Docs
Abre el área de documentación pública desde el sitio de la landing mediante /docs, /manual o /wiki. La pantalla carga el índice público de Docs sin requerir inicio de sesión en la app y después abre automáticamente el primer artículo disponible en la ruta canónica /docs/{section_slug}/{slug} en cuanto el índice se ha cargado.
En este artículo
Usa esta guía cuando necesites verificar o capturar el punto de entrada de la documentación pública en el runtime de la landing de ES en español.
Es un flujo de documentación público y de solo lectura. No requiere Grupo Marea Demo, Marea Gran Via, reservas, tickets, personal, catálogos ni una sesión autenticada de Antylogic.
Antes de empezar
- El sitio de la landing es alcanzable, por ejemplo mediante APP_WEB_URL en el runtime demo de ES.
- PUBLIC_API_BASE_URL apunta a un backend que expone /api/public/docs; los hosts locales de la landing lo fijan por defecto a http://localhost:8081.
- El servicio de contenido de Docs del backend tiene un bundle de docs disponible, actualmente respaldado por backend/docs-content/articles.json en el repositorio inspeccionado.
- Para una captura de ES en español, abre /docs?lang=es o usa un idioma de navegador en español para que el idioma de los Docs públicos resuelva a español.
Instrucciones
- 1.
Abre la ruta de Docs
Desde el sitio público de la landing, elige Docs en la cabecera o introduce /docs directamente en el navegador. Las URLs directas /manual y /wiki abren la misma pantalla pública de Docs.
- 2.
Espera a que se cargue el índice
La pantalla abre el armazón de Docs, detecta la vista de plataforma y solicita el índice público usando el idioma, la plataforma y el tema resueltos. Durante la carga, la cabecera de Docs, el área de búsqueda, el área del contador de guías, el estado de carga y el selector de plataforma permanecen visibles.
- 3.
Comprueba las secciones cargadas
Cuando el índice se cargue, la pantalla lista las secciones de documentación y los resúmenes de artículo. En escritorio, usa la barra lateral; en pantallas más pequeñas, abre el panel de secciones de Docs. La caja de búsqueda visible filtra localmente los resúmenes cargados.
- 4.
Confirma la apertura automática del artículo
Una ruta /docs, /manual o /wiki sin más no se mantiene como página de categoría independiente cuando existen artículos. En cuanto hay resúmenes disponibles, la pantalla selecciona el primer artículo y sustituye la URL del navegador por /docs/{section_slug}/{slug}.
Validaciones y límites
- No se necesita sesión autenticada de Antylogic, pertenencia a organización, pertenencia a ubicación ni permiso de rol.
- El elemento de navegación Docs está activo para /docs, /manual y /wiki.
- La petición pública usa GET /api/public/docs con los valores de consulta locale, platform y theme.
- El selector de plataforma solo permite mobile, tablet o web.
- Si el índice no tiene artículos, la pantalla muestra el estado vacío de Docs y no solicita ningún detalle de artículo.
Resultado esperado
La superficie pública de Docs se carga en español, el contenido del índice es visible y la ruta pasa de la URL de entrada sin más a la primera ruta canónica de artículo /docs cuando existen resúmenes de artículo.