feat: Add Linux deployment scripts and server logs view

- Add deployment/linux/ with deploy.sh for deploying from Claude-Agent LXC to Windows server
- Add ServerLogsView.vue for viewing server logs from frontend
- Add shared/routes/system.py for system health endpoints
- Update CLAUDE.md with quick deploy instructions
- Improve Windows deployment scripts (ROA2WEB-Console.ps1)
- Fix OCR service validation and worker pool improvements
- Update environment config examples
- Various script permission and startup fixes

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

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

deployment/windows/scripts/Install-ROA2WEB.ps1

@@ -72,6 +72,8 @@ $script:Config = @{
     FrontendPath = Join-Path $InstallPath "frontend"
     LogsPath = Join-Path $InstallPath "logs"
     TempPath = Join-Path $InstallPath "temp"
+    # IMPORTANT: venv is OUTSIDE InstallPath to survive deployments!
+    VenvPath = "C:\inetpub\wwwroot\roa2web-venv"
     PythonVersion = $PythonVersion
     ServicePort = $ServicePort
     IISSiteName = $IISSiteName
@@ -302,24 +304,46 @@ function New-DirectoryStructure {
 }
 
 function Install-PythonDependencies {
-    Write-Step "Installing Python dependencies..."
+    Write-Step "Setting up Python virtual environment..."
 
     $requirementsPath = Join-Path $Config.BackendPath "requirements.txt"
+    $venvPath = $Config.VenvPath
+    $venvPython = Join-Path $venvPath "Scripts\python.exe"
+    $venvPip = Join-Path $venvPath "Scripts\pip.exe"
 
+    # Create venv if it doesn't exist
+    if (-not (Test-Path $venvPython)) {
+        Write-Step "Creating virtual environment at $venvPath..."
+        try {
+            & python -m venv $venvPath
+            Write-Success "Virtual environment created"
+        } catch {
+            throw "Failed to create virtual environment: $_"
+        }
+    } else {
+        Write-Success "Virtual environment already exists"
+    }
+
+    # Upgrade pip in venv
+    Write-Step "Upgrading pip in virtual environment..."
+    try {
+        & $venvPython -m pip install --upgrade pip
+        Write-Success "Pip upgraded"
+    } catch {
+        Write-Warning "Could not upgrade pip: $_"
+    }
+
+    # Install dependencies
     if (-not (Test-Path $requirementsPath)) {
         Write-Warning "requirements.txt not found at $requirementsPath"
         Write-Warning "Please copy backend files first, then run this script again"
         return
     }
 
+    Write-Step "Installing Python dependencies in virtual environment..."
     try {
-        # Upgrade pip first
-        & python -m pip install --upgrade pip
-
-        # Install dependencies
-        & python -m pip install -r $requirementsPath
-
-        Write-Success "Python dependencies installed successfully"
+        & $venvPip install -r $requirementsPath
+        Write-Success "Python dependencies installed successfully in venv"
     } catch {
         throw "Failed to install Python dependencies: $_"
     }
@@ -359,16 +383,21 @@ function New-WindowsService {
         Write-Success "Existing service removed"
     }
 
-    # Get Python path
-    $pythonPath = (Get-Command python).Source
+    # Get Python path from venv
+    $venvPython = Join-Path $Config.VenvPath "Scripts\python.exe"
+
+    if (-not (Test-Path $venvPython)) {
+        throw "Virtual environment Python not found at $venvPython. Run Install-PythonDependencies first."
+    }
+
     $uvicornModule = "uvicorn"
     $appModule = "main:app"
 
     # NSSM service creation
     try {
-        # Install service
+        # Install service using venv Python
         # NOTE: Using --workers 1 because Telegram bot requires single instance (polling conflict)
-        & nssm install $Config.ServiceName $pythonPath "-m" $uvicornModule $appModule "--host" "127.0.0.1" "--port" $Config.ServicePort.ToString() "--workers" "1"
+        & nssm install $Config.ServiceName $venvPython "-m" $uvicornModule $appModule "--host" "127.0.0.1" "--port" $Config.ServicePort.ToString() "--workers" "1"
 
         # Set service configuration
         & nssm set $Config.ServiceName DisplayName $Config.ServiceDisplayName
@@ -530,6 +559,7 @@ function Show-Summary {
     Write-Host "`nInstallation Details:" -ForegroundColor Yellow
     Write-Host "  Install Path:      $($Config.InstallPath)"
     Write-Host "  Backend Path:      $($Config.BackendPath)"
+    Write-Host "  Virtual Env:       $($Config.VenvPath)"
     Write-Host "  Frontend Path:     $($Config.FrontendPath)"
     Write-Host "  Service Name:      $($Config.ServiceName)"
     Write-Host "  Service Port:      $($Config.ServicePort)"