timothy/mapper
Public Access
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add ofxpimapper-full-stack OpenSpec artifacts

Browse Source 
Comprehensive blueprint for a headless Raspberry Pi 3B projection mapping appliance:
- Unified installer with 2GB swap safety for C++ source builds.
- WebSocket-driven real-time vertex/surface manipulation.
- 5-tab responsive dashboard (Dashboard, Mapping, Media, Network, System).
- Media validation with ffprobe (H.264 check) and resource warnings.
- Throttled log streaming and explicit mapping persistence.
This commit is contained in:
Timothy Hofland
2026-03-10 22:34:02 +01:00
parent 7928a2be9b
commit 158e6a204f
5 changed files with 144 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
openspec/changes/ofxpimapper-full-stack/tasks.md Normal file
View File

@ -0,0 +1,30 @@
## 1. Setup Script Upgrades
- [ ] 1.1 Add `ofxPiMapper` installation logic (source build with 2GB swap safety).
- [ ] 1.2 Modify `ofxPiMapper` C++ source code to add `/ofxPiMapper/surface/highlight` OSC listener.
- [ ] 1.3 Implement graphics driver configuration (KMS/DRM) for headless operation.
## 2. Backend Expansion (Node.js)
- [ ] 2.1 Implement WebSocket (Socket.io) handlers for low-latency vertex updates.
- [ ] 2.2 Create the Throttled Log Streamer (max 10 lines / 500ms) for process output.
- [ ] 2.3 Implement the "Mapping Manifest" with `ffprobe` codec validation (H.264).
- [ ] 2.4 Add System Control endpoints (Shutdown, Reboot, Restart Mapper, Save Mapping).
## 3. Frontend Overhaul (React/Tailwind)
- [ ] 3.1 Implement the 5-tab navigation system (Dashboard, Mapping, Media, Network, System).
- [ ] 3.2 Build the "Responsive Dashboard" with real-time stats (CPU/RAM/Temp).
- [ ] 3.3 Create the "Media Vault" with file upload, preview, and delete.
- [ ] 3.4 Upgrade the "Virtual Canvas" with Surface Naming, Quad/Triangle adding, and drag/scale/rotate.
## 4. Hybrid Networking UI
- [ ] 4.1 Implement the WiFi scanner and client-mode connection interface.
- [ ] 4.2 Add AP configuration (SSID/Password change) with graceful reboot handling.
## 5. Integration & Stress-Testing
- [ ] 5.1 Test 1080p playback stability on Pi 3B with active mapping.
- [ ] 5.2 Validate the "LAN-Rescue" mDNS connectivity.
- [ ] 5.3 Conduct end-to-end "Clean Install" test using the setup script.