# Phase 2: V2 Shell and Navigation

## Objective

Build the V2 UI shell and navigation framework with place context switching and place information entrypoint.

---

## Tasks

### 2.1 V2 shell layout

- Create V2 layout wrapper (header/sidebar/content).
- Add consistent spacing/visual hierarchy for dashboard-first UX.
- Add responsive behavior for desktop/tablet.

### 2.2 Place context switcher

- Add selected-place switcher in navbar.
- Persist selection in session.
- Propagate selected place context to all V2 pages.

### 2.3 Place information settings access

- Add direct action/link from navbar to selected place information settings.
- Ensure route guard validates access to selected place.

### 2.4 V2 navigation tree

- Define groups: Dashboard, Cardex, Orders, Catalog, Settings.
- Apply role-aware visibility (`super_admin`, `manager`).
- Ensure active-state logic works with `/admin/v2/*` routes.

---

## File Impact (Expected)

- `app/Providers/FilamentServiceProvider.php`
- `app/Filament/V2/Pages/*`
- `resources/views/filament/v2/*`
- optional middleware/helper for selected place context

---

## Acceptance Criteria

- V2 shell is stable and responsive.
- Place switcher updates page context without desynchronization.
- Place settings shortcut opens selected place information reliably.
- Navigation only shows allowed items for current role.

---

## Tests

- Role visibility tests for V2 navigation.
- Session persistence tests for selected place.
- Routing tests for place settings entrypoint.