===========================
2. Navigation and Workspace
===========================

Goal
====

Understand global navigation, active project context, and safe movement between modules.

Workspace semantics
===================

1. Global sidebar controls module-level navigation.
2. Top bar controls search, profile, and quick actions.
3. Active project context determines where data and runs are created.

Step-by-step
============

1. Open dashboard.
2. Identify key navigation areas:
   - Left sidebar: Datasets, Builder, Experiments, Models, MLOps, Privacy, SynthGen.
   - Top bar: search, notifications, profile/team.
3. Change module from sidebar and confirm page title updates.
4. Switch active project (if selector is available).
5. Return to previous module and confirm context remains stable.

Functional validation checklist
===============================

1. Each menu item routes to the correct module URL.
2. Browser back/forward preserves expected state.
3. Active project badge/selector remains consistent across modules.
4. Forbidden modules are hidden or blocked for non-authorized roles.
5. Table filters and search survive refresh when expected by product behavior.

Expected result
===============

1. User can move across modules without losing project context.
2. Navigation reflects role permissions and plan limits.

Common errors and recovery
==========================

1. Data appears from wrong project:
   - Re-check active project selector.
   - Hard refresh and re-enter module.
2. Menu option missing:
   - Verify user role and subscription plan.
3. Stale UI state:
   - Clear local storage for platform domain and re-login.

Screenshot
==========

.. figure:: ../../_static/user-manual/common/dashboard.png
   :alt: Global navigation and top workspace controls
   :width: 90%

   Main workspace navigation with module and profile access points.