🏗️ PC services hub — overview

All services na PC ai-brain (Tailscale 100.109.129.16). Hub Linux primary (post-migration), Windows secondary dla Adobe + drukarki.

📡 Endpoints (Tailscale + Funnel)

Service	Local URL	Tailscale URL	Public (Funnel)
pose_server	`http://localhost:8001`	`http://100.109.129.16:8001`	`https://desktop-e7102ja.tailc2b192.ts.net`
dashboard	`http://localhost:8080`	`http://100.109.129.16:8080`	via path-mount `/webhook/github`
blender	`http://localhost:8002`	`http://100.109.129.16:8002`	—
LM Studio	`http://localhost:1234`	—	—

🔐 Auth

X-Pose-Auth (Bearer token)

pose_server global middleware (v20+), wszystkie endpointy poza /health

Token: POSE_UPLOAD_TOKEN env (User scope). Format: 32-byte base64url. Wymagany dla:
POST /upload-recording · GET /queue-status · POST /retry-failed · POST /pose · POST /pose-batch · GET /frame-skeleton/{filename} · GET /version

GitHub Webhook HMAC

dashboard /webhook/github (publicznie wystawiony via Funnel)

HMAC SHA256 z GH_WEBHOOK_SECRET env. GitHub Settings → Webhooks → Secret matches.

🎯 Core services

pose_server core

FastAPI port 8001 · CUDA RTX 3060 12GB · venv .venv

YOLO11x-pose ensemble (z opcjonalnym DWPose Wholebody fallback). Spawn analyze_recording.py per uploaded workout. Sweep nightly task (3 AM systemd timer) re-analyzes invalid sidecars. Webhook self-update przez dashboard.

Key endpoints:

POST /upload-recording — iPhone HealthIOS upload .mov + metadata + optional iOS skeleton
POST /pose-batch — multi-frame pose detection (analyze worker internal)
GET /queue-status — analyzing + pending + done + failed
POST /retry-failed — sweep trigger (sweep-nightly task lub manual)
GET /frame-skeleton/{stem}.mov?idx=N&n=4 — rendered skeleton frame thumbnails dla iOS UI
GET /sessions — per-set grouped workouts (post v18 schema)

VL pipeline: Gemini 2.5 Flash (PRIMARY cloud, multi-key round-robin) → qwen2.5-vl-7b (FALLBACK local LM Studio)

dashboard core

FastAPI port 8080 · UI dla services + analyses

Health probes per service, restart triggers, GitHub webhook receiver, live progress widget dla pose_server analyses. Migration page /migration z live status.

UI routes: / · /recordings · /sessions · /migration · /hosts · /docs-page

blender render

FastAPI port 8002 · D:\BlenderLauncher\

Headless Blender render queue. Default 4.5.8 LTS, version manager dla różnych Blender installs.

LM Studio VL

GUI app port 1234 · qwen2.5-vl-7b GGUF

Local VL inference dla qwen2.5-vl-7b. Fallback gdy Gemini cloud unavailable. Manual start via tray icon (lub systemctl --user po Linux migration).

☁️ Cloud integrations

Gemini 2.5 Flash cloud PRIMARY

api.google.com/genai · 3 keys round-robin · free tier 15 RPM

VL inference dla form analysis. analyze_recording.py tries Gemini first, falls back do qwen2.5-vl-7b on 429 quota / network error / parse fail.

Google Drive backup backup

rclone gdrive: remote · OAuth · personal Google One

Post-analyze auto-push workout bundle (video.mov + analysis.json + ios_skeleton.json + thumbnails) do gdrive:health-workouts/{stem}/. Zero marginal cost (Bartek's existing Google One subscription).

Supabase claude_handoff coordination

api.supabase.com · Management API · PAT auth

Cross-instance Claude coordination (hub-Claude ↔ iOS-Claude ↔ Bartek). Table claude_handoff w project xctrcwunonuggrgnlggw. Scripts: scripts/handoff.ps1 + scripts/sb.ps1.

Tailscale VPN

Tailnet desktop-e7102ja.tailc2b192.ts.net · 100.109.129.16

Mesh VPN dla hub ↔ iPhone ↔ Mac ↔ klient PC. Funnel exposes pose_server :8001 publicly via HTTPS dla iPhone mobile data uploads (bypass DERP relay).

🛡️ Watchdog

pc-services-watchdog

Windows scheduled task (every 5 min) · → systemd timer post-Linux

Probe pose_server :8001/health + dashboard :8080/health. Down → Start-ScheduledTask (Windows) lub systemctl restart (Linux). 30s timeout + 3-strike debounce eliminuje false-positive restart pod load.

📅 Scheduled jobs

Job	Cron	Co
pc-services-watchdog	every 5 min	Health probe + auto-restart
pc-services-sweep-nightly	03:00 daily	POST /retry-failed (reanalyze invalid sidecars)
pc-services-backup-blender-projects	04:00 daily	Blender projects backup
pc-services-cleanup-blender-jobs	Sunday 03:30	Old Blender render jobs cleanup
pc-services-renew-cert	Sunday 02:00	Tailscale cert renewal (Funnel)

📊 Data flow

iPhone HealthIOS                         pose_server :8001
─────────────────                       ─────────────────────
record workout (.mov) ─┐
                       │  X-Pose-Auth header
                       ▼
                 Tailscale Funnel HTTPS
                 desktop-e7102ja.tailc2b192.ts.net
                       │
                       ▼
                 POST /upload-recording ─→ D:\health-recordings\
                       │                      ↓
                       │                  spawn analyze_recording.py
                       │                      ↓
                       │                  ffmpeg extract 12 frames
                       │                      ↓
                       │                  ┌─ Gemini 2.5 Flash (cloud) ─┐
                       │                  │  (primary VL form-check)   │
                       │                  └─────────┬──────────────────┘
                       │                            │ on 429/error
                       │                            ▼
                       │                  qwen2.5-vl-7b (LM Studio fallback)
                       │                      ↓
                       │                  motion detection (YOLO pose-batch)
                       │                      ↓
                       │                  per-rep VL + kinematics
                       │                      ↓
                       │                  sidecar.analysis.json (v22 schema)
                       │                      ↓
                       │                  Supabase form_checks upsert ─→ iOS Coach
                       │                  rclone push → gdrive:health-workouts/{stem}/
                       │
                       ▼ poll /analyze-status
                 iOS shows verdict + per_rep + drill_recommendations