Cambiar dispositivo en Docs
Permite cambiar la variante de dispositivo usada por la wiki pública de Docs entre Móvil, Tablet y Web. El cambio mantiene el artículo abierto, vuelve a cargar el índice y el detalle con la plataforma seleccionada, y muestra la media resuelta para esa variante cuando existe.
En este artículo
Esta guía sirve para revisar un artículo público de Docs en la misma landing usando las variantes Móvil, Tablet y Web, sin iniciar sesión ni entrar en la app autenticada.
La selección cambia las peticiones públicas de Docs y la media resuelta del detalle, pero no se guarda en la URL; al recargar, la plataforma vuelve a calcularse por el viewport.
Antes de empezar
- Abrir la landing en una ruta pública de Docs, por ejemplo `/docs` o `/docs/reservas-y-sala/es-abrir-selector-de-mesas?lang=es`.
- El backend debe tener disponible `backend/docs-content/articles.json` con idiomas `es` y `en` y plataformas `mobile`, `tablet` y `web`.
- No hace falta sesión ni permisos de app: la consulta usa `/api/public/docs`.
- Para apreciar un cambio visual, usar un artículo con media publicada para más de una plataforma, como `Cómo abrir el selector de mesas`.
Instrucciones
- 1.
Abrir un artículo público de Docs
Entra en `/docs` o abre directamente `/docs/reservas-y-sala/es-abrir-selector-de-mesas?lang=es`. Si se abre `/docs` sin artículo concreto, la pantalla selecciona el primer artículo disponible y navega a su URL canónica.
- 2.
Localizar el selector Dispositivo
En la cabecera del artículo busca `Dispositivo`. La wiki muestra tres opciones: `Móvil`, `Tablet` y `Web`. La opción inicial depende del ancho y del tipo de dispositivo desde el que se abre la landing.
- 3.
Elegir otra plataforma
Pulsa `Móvil`, `Tablet` o `Web`. La pantalla conserva el artículo seleccionado y recompone la consulta pública con `locale`, `platform` y `theme`; si había una carga en curso, la anterior se cancela.
- 4.
Revisar la media publicada
Comprueba la captura o vídeo del artículo tras el cambio. Si existe variante para la plataforma elegida, se muestra esa media; si no existe, la API aplica fallback y puede devolver una media de otra plataforma.
- 5.
Comprobar el contrato público si hace falta
Abre un detalle como `/api/public/docs/reservas-y-sala/es-abrir-selector-de-mesas?locale=es&platform=tablet&theme=light` para revisar `platform`, `theme`, `media`, `resolved_platform` y `available_platforms`.
- 6.
Compartir el resultado con contexto
Comparte la URL del artículo y especifica qué opción del selector debe pulsarse. La plataforma no viaja en el enlace de la landing pública, aunque la API sí acepta `platform` por query param.
Validaciones y límites
- La pantalla pública no pide sesión.
- La UI pública solo ofrece `mobile`, `tablet` y `web`.
- El cambio de plataforma no modifica la URL ni añade `platform` a `location.search`.
- Los enlaces internos de Docs no conservan la plataforma seleccionada.
- `mobile` se resuelve como contenido `iphone`, `tablet` como `ipad` y `web` como `web`.
- La API puede devolver `resolved_platform` distinto de `platform` cuando falta la variante exacta.
- Si `platform` falta o no se reconoce en la API, el backend responde como `web`.
- La pantalla autenticada `DocumentationPage` no implementa este selector manual; muestra una píldora informativa de plataforma detectada.
Resultado esperado
El artículo público queda abierto en la variante elegida y el detalle de Docs se refresca con la media publicada correspondiente cuando existe. Si no hay variante exacta, la API documenta el fallback mediante `resolved_platform` y `available_platforms`.