Add configurable board settings to Docker container (#263)

* Add configurable board settings to Docker container

- Add environment variables for board configuration (BOARD_NAME, BOARD_LAYOUT, BOARD_SIZE, BOARD_SET, BOARD_ANGLE)
- Update Python webservice to use environment variables for redirect URL construction
- Add comprehensive documentation for board configuration options
- Include guidance on finding board settings from BoardSesh URLs

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* Implement code cleanup and fix board configuration issues

## Code Cleanup & Bug Fixes:
- Remove unused imports (ssl, threading, FileResponse, StaticFiles) from main.py
- Remove unused STATIC_PATH variable
- Fix critical bug in bluetooth_controller.py (missing led_controller parameter)
- Remove unused boardsesh_client.py file (232 lines of dead code)
- Replace hardcoded "kilter" board names with environment variables
- Improve error handling with specific exceptions instead of bare except clauses
- Clean up unused database columns from sessions table
- Add database cleanup routines for old cache and session data

## Board Configuration Improvements:
- Update README with correct URL slug format for board configurations
- Document proper Kilter board sets: bolt, screw, screw_bolt
- Document proper Tension board sets: plastic, wood, plastic_wood
- Document Tension layout naming: two-mirror, two-spray for 2.0 layouts
- Add comprehensive examples with correct environment variable usage
- Explain how users can find their configuration from BoardSesh URLs

## Technical Improvements:
- Replace placeholder API endpoint with proper health check
- Add automatic cleanup of orphaned queue items on startup
- Improve WebSocket connection error handling
- Add proper logging for cache operations
- All Python files now pass syntax validation

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: marcodejongh

board-controller/README.md

@@ -136,6 +136,72 @@ SQLite database is created automatically with tables:
 - `DB_PATH` - Database file path (default: ./board_controller.db)
 - `CACHE_TTL_HOURS` - API cache TTL (default: 24)
 
+#### Board Configuration
+
+These environment variables control the default board configuration for the redirect URL when accessing the controller root endpoint:
+
+- `BOARD_NAME` - Board type: `kilter` or `tension` (default: kilter)
+- `BOARD_LAYOUT` - Board layout name (varies by board, default: original)
+- `BOARD_SIZE` - Board size (varies by board, default: 12x12)
+- `BOARD_SET` - Holds set (varies by board, default: screw_bolt)
+- `BOARD_ANGLE` - Board angle: 0-70 in 5-degree increments (default: 40)
+
+**How to Find Your Board Configuration:**
+
+The easiest way to determine your board's configuration is to look at your BoardSesh URL when you navigate to your specific board setup. The URL follows this pattern:
+
+```
+https://www.boardsesh.com/{board_name}/{layout}/{size}/{set}/{angle}/list
+```
+
+For example:
+- `https://www.boardsesh.com/kilter/original/12x12/screw_bolt/40/list`
+- `https://www.boardsesh.com/tension/1/8x12/TB2-plastic/30/list`
+
+**Available Options by Board:**
+
+**Kilter Board:**
+- **Board Name**: `kilter`
+- **Layouts**: URL-friendly layout names:
+  - `original` (most common layout)
+- **Sizes**: Board dimensions as URL slugs:
+  - `12x12`, `8x10`, `16x12` (standard board sizes)
+- **Sets**: Hold set names as URL slugs:
+  - `bolt`, `screw` (individual hold types)
+  - `screw_bolt` (both hold types combined, sorted alphabetically descending)
+- **Angles**: `0`, `5`, `10`, `15`, `20`, `25`, `30`, `35`, `40`, `45`, `50`, `55`, `60`, `65`, `70`
+
+**Tension Board:**
+- **Board Name**: `tension`
+- **Layouts**: URL-friendly layout names:
+  - `1`, `2`, `3`, ..., `28` (for numbered layouts)
+  - `two-mirror`, `two-spray` (for layouts that start with "2-" in database)
+- **Sizes**: Board dimensions as URL slugs:
+  - `8x10`, `8x12`, `12x10`, `12x12`
+- **Sets**: Hold set names as URL slugs:
+  - `plastic`, `wood` (individual hold types)
+  - `plastic_wood` (both hold types combined)
+- **Angles**: `0`, `5`, `10`, `15`, `20`, `25`, `30`, `35`, `40`, `45`, `50`, `55`, `60`, `65`, `70`
+
+**Note**: The exact available options depend on your specific board configuration and what hold sets you have installed. Visit BoardSesh.com and navigate to your board to see the exact URL parameters for your setup.
+
+**Example configurations:**
+```bash
+# Kilter 12x12 with screw and bolt holds at 45 degrees
+BOARD_NAME=kilter
+BOARD_LAYOUT=original
+BOARD_SIZE=12x12
+BOARD_SET=screw_bolt
+BOARD_ANGLE=45
+
+# Tension 8x12 with plastic holds at 30 degrees
+BOARD_NAME=tension
+BOARD_LAYOUT=two-mirror
+BOARD_SIZE=8x12
+BOARD_SET=plastic
+BOARD_ANGLE=30
+```
+
 ### Command Line Options
 
 ```bash

board-controller/bluetooth_controller.py

@@ -143,13 +143,13 @@ def _run_bluetooth_service(self):
 
             # Create custom RX characteristic that uses our message buffer
             class CustomRxCharacteristic(SimpleRxCharacteristic):
-                def __init__(self, bus, index, service, message_buffer):
-                    super().__init__(bus, index, service, self.led_controller)
+                def __init__(self, bus, index, service, message_buffer, led_controller):
+                    super().__init__(bus, index, service, led_controller)
                     self.message_buffer = message_buffer
 
             uart_service = UartService(bus, 0)
             uart_service.characteristics[0] = CustomRxCharacteristic(
-                bus, 0, uart_service, self.message_buffer
+                bus, 0, uart_service, self.message_buffer, self.led_controller
             )
 
             app.add_service(uart_service)

board-controller/boardsesh_client.py

@@ -12,6 +12,17 @@ services:
     environment:
       - DB_PATH=/app/data/board_controller.db
       - LOG_LEVEL=INFO
+      # Board configuration for redirect URL
+      # BOARD_NAME: kilter, tension
+      # BOARD_LAYOUT: varies by board (e.g., original for kilter)
+      # BOARD_SIZE: varies by board (e.g., 12x12, 8x10, 16x12, etc.)
+      # BOARD_SET: varies by board (e.g., screw_bolt, bolt_on, plastic, wood, etc.)
+      # BOARD_ANGLE: 0-70 in 5-degree increments
+      - BOARD_NAME=kilter
+      - BOARD_LAYOUT=original
+      - BOARD_SIZE=12x12
+      - BOARD_SET=screw_bolt
+      - BOARD_ANGLE=40
     restart: unless-stopped
 
     # For Bluetooth support (Linux hosts only)
@@ -31,6 +42,17 @@ services:
     environment:
       - DB_PATH=/app/data/board_controller.db
       - LOG_LEVEL=INFO
+      # Board configuration for redirect URL
+      # BOARD_NAME: kilter, tension
+      # BOARD_LAYOUT: varies by board (e.g., original for kilter)
+      # BOARD_SIZE: varies by board (e.g., 12x12, 8x10, 16x12, etc.)
+      # BOARD_SET: varies by board (e.g., screw_bolt, bolt_on, plastic, wood, etc.)
+      # BOARD_ANGLE: 0-70 in 5-degree increments
+      - BOARD_NAME=kilter
+      - BOARD_LAYOUT=original
+      - BOARD_SIZE=12x12
+      - BOARD_SET=screw_bolt
+      - BOARD_ANGLE=40
     restart: unless-stopped
     command: ["python", "main.py", "--no-bluetooth", "--host", "0.0.0.0", "--port", "8000"]
     profiles: