uto_manager/docs/user-guide/getting-started/interface-overview.md

102 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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% |