Add UV run support and systemd service installer

**UV Integration:**
- Updated pyproject.toml with [tool.uv.scripts]
- Added 'uv run start' to launch wedding phone
- Added 'uv run test' to run audio tests
- Refactored main code into main() function
- Added proper entry point for package installation

**Systemd Service:**
- Created wedding-phone.service template
- Service runs with UV for dependency management
- Automatic restart on failure
- Proper security hardening (NoNewPrivileges, PrivateTmp)
- GPIO and audio group access configured

**Service Installer:**
- Created install_service.sh automated installer
- Auto-detects project path and user
- Checks for UV installation and dependencies
- Configures service file with correct paths
- Option to enable and start immediately
- Provides helpful command reference

**Installer Features:**
- Validates config.json exists (creates from example if missing)
- Installs UV dependencies automatically
- Updates service file paths dynamically
- Color-coded output for clarity
- Error checking at each step
- Clean installation process

**Usage:**
```bash
# Run directly with UV
uv run start

# Install as system service
./install_service.sh

# Service management
sudo systemctl start wedding-phone
sudo systemctl stop wedding-phone
sudo journalctl -u wedding-phone -f
```

**Documentation:**
- Updated README with UV commands
- Added service installation guide
- Removed old manual systemd instructions
- Added service management commands
- Updated file structure documentation

**Benefits:**
- Easier to run (single command)
- Automatic startup on boot
- Better dependency management
- Professional service integration
- Simplified installation process

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

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

install_service.sh

@@ -0,0 +1,127 @@
+#!/bin/bash
+#
+# Wedding Phone Service Installer
+# Installs the wedding phone as a systemd service
+#
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+echo "=========================================="
+echo "Wedding Phone Service Installer"
+echo "=========================================="
+echo ""
+
+# Check if running as root
+if [ "$EUID" -eq 0 ]; then
+    echo -e "${RED}ERROR: Do not run this script as root or with sudo${NC}"
+    echo "This script will prompt for sudo password when needed"
+    exit 1
+fi
+
+# Get the directory where this script is located
+SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+SERVICE_FILE="$SCRIPT_DIR/wedding-phone.service"
+
+echo "Project directory: $SCRIPT_DIR"
+echo ""
+
+# Check if config.json exists
+if [ ! -f "$SCRIPT_DIR/config.json" ]; then
+    echo -e "${YELLOW}WARNING: config.json not found${NC}"
+    echo "Creating config.json from config.example.json..."
+    if [ -f "$SCRIPT_DIR/config.example.json" ]; then
+        cp "$SCRIPT_DIR/config.example.json" "$SCRIPT_DIR/config.json"
+        echo -e "${GREEN}✓ Created config.json${NC}"
+        echo -e "${YELLOW}Please edit config.json to configure your system before starting the service${NC}"
+        echo ""
+    else
+        echo -e "${RED}ERROR: config.example.json not found${NC}"
+        exit 1
+    fi
+fi
+
+# Check if UV is installed
+if ! command -v uv &> /dev/null; then
+    echo -e "${RED}ERROR: UV is not installed${NC}"
+    echo "Install UV with: curl -LsSf https://astral.sh/uv/install.sh | sh"
+    exit 1
+fi
+
+echo -e "${GREEN}✓ UV is installed${NC}"
+
+# Install dependencies
+echo ""
+echo "Installing dependencies..."
+cd "$SCRIPT_DIR"
+uv pip install -e .
+
+echo -e "${GREEN}✓ Dependencies installed${NC}"
+echo ""
+
+# Update the service file with the correct path
+echo "Configuring service file..."
+TEMP_SERVICE="/tmp/wedding-phone.service"
+cat "$SERVICE_FILE" | sed "s|/home/pi/wedding-phone|$SCRIPT_DIR|g" > "$TEMP_SERVICE"
+
+# Update User in service file
+CURRENT_USER=$(whoami)
+sed -i "s|User=pi|User=$CURRENT_USER|g" "$TEMP_SERVICE"
+sed -i "s|Group=pi|Group=$CURRENT_USER|g" "$TEMP_SERVICE"
+
+echo -e "${GREEN}✓ Service file configured for user: $CURRENT_USER${NC}"
+echo ""
+
+# Install the service
+echo "Installing systemd service..."
+sudo cp "$TEMP_SERVICE" /etc/systemd/system/wedding-phone.service
+sudo systemctl daemon-reload
+
+echo -e "${GREEN}✓ Service installed${NC}"
+echo ""
+
+# Ask if user wants to enable and start the service
+read -p "Do you want to enable and start the service now? (y/n) " -n 1 -r
+echo ""
+if [[ $REPLY =~ ^[Yy]$ ]]; then
+    echo "Enabling service to start on boot..."
+    sudo systemctl enable wedding-phone.service
+    echo -e "${GREEN}✓ Service enabled${NC}"
+
+    echo ""
+    echo "Starting service..."
+    sudo systemctl start wedding-phone.service
+    echo -e "${GREEN}✓ Service started${NC}"
+
+    echo ""
+    echo "Service status:"
+    sudo systemctl status wedding-phone.service --no-pager
+else
+    echo ""
+    echo "Service installed but not started."
+    echo "To enable and start later, run:"
+    echo "  sudo systemctl enable wedding-phone.service"
+    echo "  sudo systemctl start wedding-phone.service"
+fi
+
+echo ""
+echo "=========================================="
+echo "Installation Complete!"
+echo "=========================================="
+echo ""
+echo "Useful commands:"
+echo "  Start service:   sudo systemctl start wedding-phone"
+echo "  Stop service:    sudo systemctl stop wedding-phone"
+echo "  Restart service: sudo systemctl restart wedding-phone"
+echo "  View logs:       sudo journalctl -u wedding-phone -f"
+echo "  Service status:  sudo systemctl status wedding-phone"
+echo "  Disable service: sudo systemctl disable wedding-phone"
+echo ""
+
+# Clean up
+rm -f "$TEMP_SERVICE"