Building 70 Projects ranging from beginner to advanced so anyone can — learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company 👇
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
docs(monitor): quickstart README
CarterPerez-dev33d15a6ab66c
diff --git a/PROJECTS/advanced/monitor-the-situation-dashboard/README.md b/PROJECTS/advanced/monitor-the-situation-dashboard/README.mdnew file mode 100644index 00000000..a2fb49c9--- /dev/null+++ b/PROJECTS/advanced/monitor-the-situation-dashboard/README.md@@ -0,0 +1,65 @@+<!--+©AngelaMos | 2026+README.md+-->++# 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)+```