=============================
2. Navegacao e Workspace
=============================

Objetivo
========

Entender navegacao global, contexto de projeto ativo e transicao segura entre modulos.

Semantica do workspace
======================

1. Sidebar esquerdo controla navegacao por modulo.
2. Barra superior controla busca, perfil e acoes rapidas.
3. Projeto ativo define onde datasets e execucoes sao criados.

Passo a passo
=============

1. Abrir dashboard.
2. Identificar areas principais:
   - Sidebar: Datasets, Builder, Experiments, Models, MLOps, Privacy, SynthGen.
   - Topbar: busca, notificacoes, perfil/team.
3. Trocar modulo e confirmar titulo/URL.
4. Trocar projeto ativo (se houver seletor).
5. Voltar ao modulo anterior e confirmar contexto preservado.

Checklist de validacao funcional
================================

1. Cada item do menu abre a URL/modulo correto.
2. Back/forward do navegador mantem estado esperado.
3. Projeto ativo permanece consistente entre modulos.
4. Modulos restritos ficam ocultos ou bloqueados por papel.
5. Filtros e busca funcionam conforme comportamento esperado.

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

1. Navegacao estavel sem perda de contexto.
2. Permissoes aplicadas conforme papel e plano.

Erros comuns e recuperacao
==========================

1. Dados de projeto errado:
   - Revisar seletor de projeto ativo.
   - Atualizar pagina e reentrar.
2. Opcao de menu ausente:
   - Verificar papel e plano de assinatura.
3. Estado visual desatualizado:
   - Limpar storage local e refazer login.

Imagem
======

.. figure:: ../../_static/user-manual/common/dashboard.png
   :alt: Navegacao global e controles do workspace
   :width: 90%

   Navegacao principal com acesso a modulos e perfil.