# 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.