zwitschi
7c48183410
Add the screen/copy/button inventory and canonical terminology, standardize inspection/wand admit-refuse hints, name the review action Return to menu, and move radio action/hold/status labels into the string table. Headless 250/250, Python 97/97, docs check OK.
47 lines
3.1 KiB
Markdown
47 lines
3.1 KiB
Markdown
# UI copy and button inventory
|
||
|
||
Status: audit in progress for the 0.9.2 UI polish patch.
|
||
|
||
## Screen inventory
|
||
|
||
| Screen / panel | Owner | Primary actions | Notes |
|
||
| --- | --- | --- | --- |
|
||
| Start / venue menu | `start_menu.gd` | Continue shift, choose venue, Help, Settings, Quit | Campaign status and free-play venues share this screen. |
|
||
| Tutorial card | `tutorial_overlay.gd` | F1 skip | Non-blocking; no mouse capture. |
|
||
| HUD | `hud.gd` | Observe, target, inspect, wheel, radio, flashlight, body camera, door, pause | No interactive controls; must stay mouse-transparent. |
|
||
| Action wheel | `action_radial.gd` | Choose de-escalation/access/radio action | Confirm with Space/click; cancel with Esc/RMB. |
|
||
| Access inspection | `hud.gd` | A = admit, D = refuse | Real access evidence cards. |
|
||
| Wand screening | `hud.gd` | A = admit, D = refuse | Shows alert and carried items. |
|
||
| Radio / emergency | `radio_panel.gd` | Send request / hold Send emergency, Cancel | Normal click vs emergency hold. |
|
||
| Pause | `pause_overlay.gd` | Resume, restart, Settings, quit to menu | Esc resumes. |
|
||
| Settings | `settings_panel.gd` | Apply, Cancel, Replay tutorial, Reset campaign, rebind controls | Destructive reset asks for confirmation. |
|
||
| Help | `help_overlay.gd` | Filter controls, Close | Policy card and current bindings. |
|
||
| Shift review | `shift_review.gd` | Continue campaign, timeline, return to menu, quit | Campaign next step is shown here. |
|
||
| Timeline | `event_timeline.gd` | Previous, Next, Close | Review evidence stepper. |
|
||
|
||
## Canonical terms
|
||
|
||
- **Admit / refuse** — access decisions. Do not alternate with “allow / deny” or “grant / reject” in player-facing controls.
|
||
- **Warning** — Level 2.
|
||
- **Blocking** — Level 3 positioning; do not call it “force”.
|
||
- **Assistance** — Level 4 radio call; **emergency** is Level 5.
|
||
- **Body camera** — always two words.
|
||
- **Shift review** — the end-of-shift screen; “review” alone is acceptable in prose.
|
||
- **Continue campaign** — advance to the next venue.
|
||
- **Return to menu** — leave the review to the venue menu (it does not start a new shift by itself).
|
||
- **Send request** — non-emergency assistance; **Send emergency** — emergency call.
|
||
|
||
## Button/label issues found
|
||
|
||
- HUD inspection and wand used “allow/deny” versus “admit/refuse”; both now use **A = admit · D = refuse entry**.
|
||
- Shift review’s old “Run another shift” actually returned to the menu; renamed **Return to menu**.
|
||
- Radio emergency action used all-caps while assistance used sentence case; both are now sentence case, with the warning in the panel title/hold hint.
|
||
- Normal radio send was previously wired only to the emergency hold handlers; fixed in 0.8.1 and covered by `test_radio_panel.gd`.
|
||
|
||
## Remaining audit work
|
||
|
||
- Inventory hardcoded player-facing strings screen by screen and move them to `content/strings.en.json`.
|
||
- Verify focus/hover/pressed/disabled states with keyboard, gamepad and mouse.
|
||
- Test long strings and 1.75x HUD font scale.
|
||
- Capture every dialog/button state and run `screen_designs.py compare` plus the pinned judge.
|