feat: initial commit

ci-observer-handover/contexts/ci-observer-dashboard-context.md

@@ -0,0 +1,51 @@
+# CI Observer Dashboard Context
+
+> Superseded by: `ci-observer-handover/contexts/CI_OBSERVER_CONTEXT_LATEST_2026-02-11.md`
+> Use the newer file for current production/runtime state.
+
+## Why this exists
+- Need a read-only, always-on CI status wall for CTO/DevOps.
+- Must not affect existing CI/CD pipelines or protected branches.
+- Quick POC required using local infra and GitHub Actions metadata.
+
+## What we built
+- Standalone dashboard service that polls GitHub Actions and renders a live view.
+- Runs on the runner VM as a Docker container.
+- Uses a classic GitHub PAT (read-only scopes) to read workflow runs.
+
+## Current behavior
+- Polls GitHub Actions workflow runs every `REFRESH_SECONDS` (default 5s).
+- Shows last 10 runs by updated time.
+- Status colors:
+  - green = pass
+  - orange = partial (cancelled/skipped/etc.)
+  - red = fail
+  - blue = running/info
+- Cards show run number, workflow, branch, start time, duration, and a link to the run.
+- UI tuned for 23–24" monitor: 5 cards per row.
+
+## Repo and runtime
+- Repo: `Wolkabout/ci-observer-dashboard`
+- Deploy path on runner VM: `/webapps/ci-observer-dashboard`
+- Default port: `8088`
+- URL: `http://10.1.50.20:8088`
+
+## How to run (POC)
+```
+cd /webapps/ci-observer-dashboard
+cp .env.example .env
+# set GITHUB_TOKEN, GH_REPOS, GH_WORKFLOWS, REFRESH_SECONDS
+docker compose up -d --build
+```
+
+## Current config (example)
+```
+GH_REPOS=Wolkabout/IoT-Platform-Core
+GH_WORKFLOWS=unit-tests.yml
+REFRESH_SECONDS=5
+```
+
+## Notes for future Codex sessions
+- This is read-only and independent of CI pipelines.
+- To add more repos/workflows, extend `GH_REPOS` and `GH_WORKFLOWS` (comma-separated).
+- AI summary integration (Ollama) is planned but not implemented yet.