feat: web video transcoding, admin playback, and viewer fixes

Add on-demand H.264/AAC web playback (RQ, ffmpeg) with API routes and
Next.js proxies; extend admin UI with WebPlaybackVideo and shared hooks.
Store transcode cache beside pending-photos (WEB_VIDEO_CACHE_DIR / UPLOAD_DIR)
and ignore data/web_videos. Centralize FastAPI URL helpers, optional Vite
and Next base paths for subfolder deploy, and fix modal reopen by using
router.replace when closing the home photo viewer. Include migration,
install scripts, deployment doc updates, and CI admin build env tweak.

Made-with: Cursor

scripts/run-psql-migration.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# Run a SQL migration against the main DATABASE_URL from repo .env.
+#
+# Usage (from anywhere):
+#   ./scripts/run-psql-migration.sh migrations/add-photos-web-playback-columns.sql
+#
+# Strips SQLAlchemy driver suffixes (+psycopg2, +asyncpg) so psql accepts the URL.
+# For remote Postgres, set DATABASE_URL in .env to postgresql://user:pass@host:port/dbname
+
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT"
+
+if [[ ! -f .env ]]; then
+  echo "ERROR: .env not found at $ROOT/.env" >&2
+  exit 1
+fi
+
+set -a
+# shellcheck disable=SC1091
+source .env
+set +a
+
+if [[ -z "${DATABASE_URL:-}" ]]; then
+  echo "ERROR: DATABASE_URL is not set in .env" >&2
+  exit 1
+fi
+
+SQL_FILE="${1:?Usage: $0 path/to/migration.sql}"
+
+if [[ ! -f "$SQL_FILE" ]]; then
+  echo "ERROR: SQL file not found: $SQL_FILE" >&2
+  exit 1
+fi
+
+URL="$DATABASE_URL"
+URL="${URL//+psycopg2/}"
+URL="${URL//+asyncpg/}"
+
+exec psql "$URL" -f "$SQL_FILE"