Expand Glitch operations hub, cabinet authoring, deployment, and RFID support

Operator hub
- Introduce Escape Gallery branding and Glitch: the Dark Machine room views
- Add cabinet illustrations, Pac-Man marquee/gameplay artwork, and waiting states
- Add device feedback panels with RFID readings, input/output states, and stale status
- Add logged operator hardware interventions with request deduplication

Room and cabinet authoring
- Add a visual custom-PCB connection editor with per-cabinet device inventory
- Support device IDs, bindings, wiring notes, input polarity, and validation
- Add physical-room label/dimension toggles and editable doorway annotations
- Preserve doorway changes through undo, save, and revert
- Expand cabinet profiles, room layout, and Glitch scenario resources

Scenarios and gameplay
- Add per-assignment game configuration and runtime feature validation
- Add timed test wins and Frogger individual-home objectives
- Add the three-cabinet timed/score/Frogger test scenario
- Add Cabinet 1 Pac-Man RFID credits, credit sound, and CREDIT 0/1 display
- Require physical Start after an accepted scan and prevent duplicate credits

Pi hardware and deployment
- Add GPIO feedback sampling and a separate multiplexed RFID helper
- Validate reader pin ownership and input/output conflicts
- Add SSH cabinet startup and Pi desktop-session service support
- Add master packaging, site setup, SSH enrollment, and staged cabinet releases
- Verify deployment manifests and support explicit activation/status/log commands

Documentation and verification
- Consolidate the root README around the current architecture and setup workflow
- Add the complete master/Pi/RFID export and deployment walkthrough
- Document network isolation, credentials, card identification, and rollback
- Add PCB, room-editor, feedback, credit, deployment, and controller tests
- Isolate protocol tests from designer-edited cabinet configurations

Known limitations
- RFID helper compilation and physical Pi commissioning remain unverified
- Fleet provisioning does not yet configure RFID-only installations completely
- Broader Pac-Man tests retain a ghost-capture assertion failure
- Staged exports must be rebuilt and checked before deploying runtime 2.3

tests/room_network/test_fleet.py

@@ -13,7 +13,8 @@ import unittest
 class FleetTests(unittest.TestCase):
     def setUp(self):
         self.now = 100
-        self.catalog = json.loads((ROOT / 'tools/room_controller/catalog.json').read_text())
+        # Fixed historical test room: designer edits must not alter protocol assertions.
+        self.catalog = json.loads(Path(__file__).with_name('catalog_fixture.json').read_text(encoding='utf-8'))
         self.fleet = server.Fleet(':memory:', self.catalog, lambda: self.now)
         for cabinet in self.fleet.rooms: self.poll(cabinet)
 
@@ -54,6 +55,9 @@ class FleetTests(unittest.TestCase):
         self.assertFalse(self.poll('cabinet_01')['commands'])
 
     def test_compatibility_rejects_missing_controls_and_accepts_alternatives(self):
+        # Explicit fixture: actual cabinet hardware can evolve independently.
+        self.catalog['cabinets']['cabinet_01']['capabilities'] = ['joystick_4way', 'button_1', 'start_button']
+        self.catalog['cabinets']['cabinet_03']['capabilities'] = ['spinner', 'button_1', 'start_button']
         with self.assertRaisesRegex(ValueError, 'hardware'):
             self.fleet.operator('prepare', {'cabinet': 'cabinet_01', 'game': 'missile_command'})
         cabinet = self.catalog['cabinets']['cabinet_03']