feat: Add frontend build process and static file serving for visual controller

Author: 02loveslollipop

.github/workflows/deploy.yaml

@@ -41,6 +41,12 @@ jobs:
           aws-session-token: ${{ secrets.AWS_SESSION_TOKEN }}
           aws-region: ${{ env.AWS_REGION }}
 
+      - name: Build visual controller frontend
+        if: ${{ matrix.service == 'visual-controller' }}
+        shell: bash
+        run: |
+          python scripts/build_frontend.py
+
       - name: Compute package suffix
         id: suffix
         shell: bash

package.ps1

@@ -27,6 +27,20 @@ print(f"Created {zip_name}")
 "@
 
 foreach ($service in $services) {
+    if ($service.Name -eq 'visual_controller') {
+        $buildScript = Join-Path $PSScriptRoot 'scripts\build_frontend.py'
+        if (Test-Path $buildScript) {
+            Write-Host "Building frontend bundle" -ForegroundColor Cyan
+            python $buildScript
+            if ($LASTEXITCODE -ne 0) {
+                Write-Host "Frontend build failed." -ForegroundColor Red
+                break
+            }
+        } else {
+            Write-Host "Frontend build script not found at $buildScript" -ForegroundColor Yellow
+        }
+    }
+
     $output = $service.Output
     $path = $service.Path
     if (!(Test-Path $path)) {

scripts/build_frontend.py

@@ -0,0 +1,47 @@
+#!/usr/bin/env python3
+"""
+Build the React frontend and copy the output into the FastAPI static directory.
+
+Usage:
+    python scripts/build_frontend.py
+"""
+
+from __future__ import annotations
+
+import shutil
+import subprocess
+from pathlib import Path
+from typing import Sequence
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+FRONTEND_DIR = REPO_ROOT / "visual_controller" / "frontend"
+STATIC_DIR = REPO_ROOT / "visual_controller" / "static"
+
+
+def run(command: Sequence[str], *, cwd: Path) -> None:
+    print(f"[build_frontend] Running {' '.join(command)} (cwd={cwd})")
+    subprocess.run(command, check=True, cwd=cwd)
+
+
+def main() -> None:
+    if not FRONTEND_DIR.exists():
+        raise SystemExit(f"Frontend directory not found: {FRONTEND_DIR}")
+
+    run(["npm", "install"], cwd=FRONTEND_DIR)
+    run(["npm", "run", "build"], cwd=FRONTEND_DIR)
+
+    dist_dir = FRONTEND_DIR / "dist"
+    if not dist_dir.exists():
+        raise SystemExit("Build output not found (expected dist/ directory).")
+
+    if STATIC_DIR.exists():
+        print(f"[build_frontend] Removing existing static directory: {STATIC_DIR}")
+        shutil.rmtree(STATIC_DIR)
+
+    print(f"[build_frontend] Copying {dist_dir} -> {STATIC_DIR}")
+    shutil.copytree(dist_dir, STATIC_DIR)
+    print("[build_frontend] Done.")
+
+
+if __name__ == "__main__":
+    main()