# Interface Overview

## Three-Pane Workspace Layout

---

## Desktop Layout (Windows / Web)

```text
┌────────────────────────────────────────────────────────────────────────────┐
│ Header: Echelon Selector | Doctrinal Mode | Export Tools                   │
├──────────────────┬─────────────────────────────────────┬───────────────────┤
│ Left Panel:      │ Central Canvas Workspace             │ Right Panel:      │
│ Template Palette │ (Pan / Zoom / Drag-and-Drop)         │ Node Inspector    │
│                  │                                      │                   │
│ - MBCT Template  │  [Brigade HQ]                        │ - Unit ID & Name  │
│ - SBCT Template  │       │                              │ - Assigned MOS    │
│ - ABCT Template  │       ├── [Infantry Bn]              │ - Personnel       │
│ - CAB Template   │       │       └── [Rifle Platoon]   │ - Readiness       │
│ - Echelon Blocks │       └── [Artillery Bn]             │ - Findings        │
├──────────────────┴─────────────────────────────────────┴───────────────────┤
│ Status Bar: Scale Factor | Active Node Count | MTOE Validation Status      │
└────────────────────────────────────────────────────────────────────────────┘
```

---

## Panel Descriptions

### Application Header

| Control | Function |
|---|---|
| Echelon Selector | Filter canvas display by echelon level |
| Doctrinal Mode | Toggle between 2026 MBCT / SBCT / ABCT / CAB modes |
| Export Tools | Open export dialog (JSON / Protobuf / PDF) |

### Left Panel — Template Palette

The collapsible left sidebar contains drag-and-drop building blocks:

- **2026 Brigade Templates** — Complete pre-configured formations (MBCT, SBCT, ABCT, CAB-Heavy, CAB-Light)
- **Echelon Blocks** — Individual battalion, company, platoon, squad, and team frameworks
- **Duty Position Slots** — Standalone position slots across all branches (Infantry, Medical, Signal, EW, UAV, Supply)

### Central Canvas Workspace

The main interactive area hosting the infinite organizational graph. Features:

- **Pan** — Click and drag on empty canvas space
- **Zoom** — Mouse wheel (desktop) or pinch gesture (Android)
- **Node Selection** — Click any node to select; Shift+click for multi-select
- **Box Selection** — Click and drag on empty space to draw a selection rectangle
- **Drag-and-Drop** — Drag nodes to re-parent within the hierarchy

### Right Panel — Node Inspector

Context-sensitive panel that updates when a node is selected:

- **Unit Information** — Unit ID, designation, echelon, doctrinal branch
- **Position Slots** — List of authorized duty positions with fill status
- **Personnel Assignment** — Search and assign soldier records to slots
- **Equipment** — Organic equipment and Line Item Numbers (LIN)
- **Readiness Status** — Manning percentage and operational readiness toggle
- **Validation Findings** — Active MTOE findings for the selected node

### Status Bar

| Indicator | Description |
|---|---|
| Scale Factor | Current canvas zoom level (e.g., `1.0×`, `0.5×`) |
| Active Node Count | Total nodes currently rendered on canvas |
| MTOE Validation | Aggregate finding counts: 🔴 Critical / 🟡 Warning / 🔵 Advisory |

---

## Android Layout

On Android, the three-pane layout adapts to a mobile-optimized configuration:

- **Left Panel** → Navigation Drawer (swipe from left edge or tap ☰)
- **Right Panel** → Bottom Sheet Inspector (tap any node to open)
- **Right-click menus** → Tap-and-hold radial menus (200ms press)
- **Keyboard shortcuts** → Not available; use touch gestures

---

## Keyboard Shortcuts (Windows / Web)

| Shortcut | Action |
|---|---|
| `Ctrl+Z` | Undo last operation |
| `Ctrl+Y` | Redo |
| `Ctrl+F` | Search nodes |
| `Ctrl+D` | Duplicate selected subtree |
| `Ctrl+S` | Save current workspace |
| `Ctrl+E` | Open export dialog |
| `Delete` | Remove selected node |
| `Escape` | Deselect / cancel drag |
| `Ctrl+A` | Select all nodes |
| `Ctrl+0` | Reset zoom to 100% |