============================
2. Navegacion y Workspace
============================

Objetivo
========

Entender navegacion global, contexto de proyecto activo y transicion segura entre modulos.

Semantica del workspace
=======================

1. Sidebar izquierdo controla navegacion por modulo.
2. Topbar controla busqueda, perfil y acciones rapidas.
3. Proyecto activo define donde se crean datasets, experimentos y modelos.

Paso a paso
===========

1. Abrir dashboard.
2. Identificar zonas principales:
   - Sidebar: Datasets, Builder, Experiments, Models, MLOps, Privacy, SynthGen.
   - Topbar: busqueda, notificaciones, perfil/team.
3. Cambiar de modulo y confirmar cambio de titulo/URL.
4. Cambiar proyecto activo (si existe selector).
5. Volver al modulo anterior y confirmar que el contexto se conserva.

Checklist de validacion funcional
=================================

1. Cada item de menu abre el modulo correcto.
2. Back/forward del navegador mantiene estado esperado.
3. Proyecto activo se mantiene consistente entre modulos.
4. Modulos restringidos se ocultan o bloquean por rol.
5. Filtros de tabla y busqueda se comportan segun diseno del producto.

Resultado esperado
==================

1. Navegacion estable sin perdida de contexto.
2. Permisos visibles y aplicados segun rol y plan.

Errores comunes y recuperacion
==============================

1. Datos de proyecto incorrecto:
   - Revisar selector de proyecto activo.
   - Refrescar y reingresar.
2. Opcion de menu faltante:
   - Verificar rol y plan de suscripcion.
3. Estado visual obsoleto:
   - Limpiar storage local y volver a iniciar sesion.

Imagen
======

.. figure:: ../../_static/user-manual/common/dashboard.png
   :alt: Navegacion global y controles de workspace
   :width: 90%

   Navegacion principal con accesos de modulo y perfil.