# Monitor the Situation Operator-grade real-time situational awareness dashboard. Single-binary Go backend, React 19 frontend, Postgres + Redis, fronted by nginx and (optionally) a Cloudflare Tunnel. > The phrase "Monitoring the situation" is a Twitter/X meme from June 2025. This is the version that actually monitors the situation. ## Stack | Layer | Tech | | ----------- | ---------------------------------------------------------- | | Backend | Go 1.22, chi router, `coder/websocket`, `goose` migrations | | Frontend | React 19, Vite, TanStack Query, Zustand, MapLibre, D3 | | Storage | Postgres 16 (BRIN-indexed time-series), Redis 7 | | Ingress | nginx (dev + prod), Cloudflare Tunnel (prod) | | Build / run | `just` recipes, multi-stage Docker, air for live reload | ## Quickstart (development) ```bash cp .env.example .env # fill .env: POSTGRES_PASSWORD, JWT_SECRET, NOTIFICATION_ENCRYPTION_KEY just dev-start just migrate-dev open http://localhost:8432 ``` JWT signing keys auto-generate at `backend/keys/private.pem` on first boot. The dev stack binds host ports `8432` (nginx) / `5432` (backend) / `4432` (postgres) / `6432` (redis) / `3432` (vite). ### Smoke checks ```bash curl -s http://localhost:8432/api/v1/healthz curl -s http://localhost:8432/api/v1/snapshot | jq . docker run --rm -i --network host ghcr.io/vi/websocat:latest \ "ws://localhost:8432/api/v1/ws?topics=heartbeat" ``` ## Production (Cloudflare Tunnel) ```bash cp .env.example .env # fill production secrets including CLOUDFLARE_TUNNEL_TOKEN just tunnel-start just migrate ``` ## Tests ```bash cd backend && go test -race ./... ``` ## Layout ``` backend/ Go services (cmd/api, internal/{events,bus,ws,snapshot,collectors,...}) frontend/ React 19 dashboard conf/ nginx and per-environment Docker configs migrations/ goose SQL migrations (mounted into the backend container) ```