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

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.