agesatony/hockeyiq-kenya
Creator:
age
Host:
# HockeyIQ Kenya
An automated data pipeline and dashboard for Kenya Hockey Union's 2026
domestic season, Kenya's national-team international record, and FIH
Hockey World Cup 2026 context — scraped, analysed, and published as a
self-contained HTML dashboard, kept current by GitHub Actions.
This README is the operational guide. For a full findings/limitations
audit, see **AUDIT.md** — read that before treating anything
here as "verified working," since several claims below could not be
tested end-to-end in the environment that assembled this repo.
## Project structure
```
notebooks/
01_scraping.ipynb Domestic scrape: 8 competitions, matches, events, player stats
02_league_analytics.ipynb League tables, scorer/discipline/form analytics
03_advanced_analytics.ipynb 44-module advanced analytics + the dashboard builder (Module 35)
04_international.ipynb Kenya national-team record (FIH TMS), rankings, ACCC medals
05_worldcup_live.ipynb Fast, standalone FIH World Cup 2026 standings refresh
data/
raw/ Scraper output, one row per match/event/player-stat
processed/ Analytics output consumed by the dashboard
reports/
dashboard.html Generated by 03 — this is the actual site
scripts/
post_to_linkedin.py Builds and posts a real-data digest to LinkedIn
.github/workflows/
domestic-weekly.yml 01->02->03->04, weekly, deploys to Pages, posts weekly digest
worldcup-live.yml 05 + dashboard rebuild, every 3h during the WC window, deploys to Pages
worldcup-daily-digest.yml One LinkedIn post/day during the WC window (decoupled from the above)
requirements.txt
AUDIT.md Full findings, what's fixed, what's unverified, go-live checklist
```
All notebooks use paths like `../data/processed/...`, so they must be run
**from inside `notebooks/`** (the workflows already do this via
`working-directory: notebooks`).
## How it stays up to date
1. **`domestic-week …