# Explore: App Shell & Global Features

> **Goal**: Map every global UI component and interaction. Cover the top bar, sidebar navigation, global search, app switcher, user menu, and cross-cutting behaviors.

## Status: NOT STARTED

---

## Operation Paths

### G-01: Top Bar Layout
- **URL**: any page (start from `/`)
- **Actions**: Just observe
- **Capture**: Logo, app name, app switcher button, search bar, connection badge, build version, user avatar
- **[SCREENSHOT]** `global/topbar_layout.png`

### G-02: App Switcher
- **URL**: any page
- **Actions**:
  1. Click "Sales" button (app switcher) in top bar
  2. Observe dropdown content — apps list, quick links
  3. Click an app if any exist
  4. Click "Manage Apps" link
- **Capture**: Available apps, quick links, navigation behavior
- **[SCREENSHOT]** `global/app_switcher_open.png`
- **[SCREENSHOT]** `global/app_switcher_manage.png`

### G-03: Global Search — Basic
- **URL**: any page
- **Actions**:
  1. Click search bar / combobox
  2. Type "Alex" (a known Lead name)
  3. Observe results dropdown — categories, result items, object badges
  4. Click a result
  5. Verify navigation to correct record
- **Capture**: Search UI, results structure, category grouping
- **[SCREENSHOT]** `global/search_typing.png`
- **[SCREENSHOT]** `global/search_results.png`

### G-04: Global Search — Scope Selector
- **URL**: any page
- **Actions**:
  1. Click "Search: All" button
  2. Observe scope options (All, Lead, Account, etc.)
  3. Select a specific scope (e.g., "Lead")
  4. Type a search term
  5. Verify results are filtered by scope
- **Capture**: Scope options list, filtered results
- **[SCREENSHOT]** `global/search_scope_options.png`
- **[SCREENSHOT]** `global/search_scope_filtered.png`

### G-05: Sidebar Navigation — Full Traverse
- **URL**: `/`
- **Actions**:
  1. Observe sidebar: all items, badges, grouping (Business vs System)
  2. Click each nav item in sequence, verify URL changes
  3. Note which items have badges (Approvals count)
  4. Click "Collapse" button — verify sidebar collapses
  5. Click expand — verify it restores
- **Capture**: Full sidebar, collapsed state, badge counts
- **[SCREENSHOT]** `global/sidebar_expanded.png`
- **[SCREENSHOT]** `global/sidebar_collapsed.png`

### G-06: User Menu
- **URL**: any page
- **Actions**:
  1. Click user avatar button ("IZ" or "SA")
  2. Observe menu items — profile, settings, logout, etc.
  3. Click each non-destructive item, observe result
- **Capture**: Menu items, profile info
- **[SCREENSHOT]** `global/user_menu_open.png`

### G-07: Notification Bell
- **URL**: any page
- **Actions**:
  1. Locate notification bell icon (if present, near user avatar)
  2. Click it
  3. Observe notification panel — items, read/unread, empty state
- **Capture**: Notification panel content
- **[SCREENSHOT]** `global/notifications_panel.png`

### G-08: Connection / Auth State
- **URL**: any page
- **Actions**:
  1. Observe "Salesforce-direct mode (OAuth)" badge
  2. Check localStorage: `auth_token`, `instance_url` keys
  3. Clear auth_token → refresh → verify redirect to login
  4. Re-inject token → refresh → verify re-auth
- **Capture**: Auth badge, login redirect behavior
- **[SCREENSHOT]** `global/auth_badge.png`

---

## Results

> Fill in after exploration

| Path | Status | Screenshot | Observations |
|------|--------|------------|-------------|
| G-01 | | | |
| G-02 | | | |
| G-03 | | | |
| G-04 | | | |
| G-05 | | | |
| G-06 | | | |
| G-07 | | | |
| G-08 | | | |

## Bugs Found

> List any bugs discovered during exploration

| # | Path | Description | Severity | Related Scenario |
|---|------|------------|----------|-----------------|