Dashboard 2026 q1 (#49)

* added dashboard 2026-01

* added dashboard for 2026-02

* added initial version of extrac_stats.py script

* added dashboard for 2026-03

* generate stats in stats folder

* added quartely reports

* added 2026-q1 dashboard

Author: cehbrecht

.gitignore

@@ -163,3 +163,6 @@ cython_debug/
 
 # macos
 .DS_Store
+
+# vscode
+.vscode/

README.md

@@ -8,22 +8,62 @@ Contributions are welcome. Feel free to open a pull request with changes.
 
 ## Running it Locally
 
-It can be helpful to preview changes on your computer before opening a pull request. *ROOCS website* uses the [MkDocs static site generator](https://www.mkdocs.org/). After forking or cloning the repository, perform the following steps to generate the site and preview it:
+Preview changes locally before opening a pull request. This site uses [MkDocs](https://www.mkdocs.org/).
 
 ```
-# build conda env with mkdcos
+# create conda environment
 conda env create
 conda activate roocs
 
 # build docs
 mkdocs build
 
-# view docs locally
+# serve docs locally
 mkdocs serve
 ```
 
 Open browser: http://127.0.0.1:8000
 
+## Extract Monthly Download Stats
+
+Use `scripts/extract_stats.py` to aggregate monthly request/download metrics from dashboard HTML files.
+
+Use the same conda environment setup shown above (`conda env create`, `conda activate roocs`), then run:
+
+```bash
+python scripts/extract_stats.py --start 2025-04 --end 2026-02 --site dkrz --quiet
+```
+
+This writes:
+
+`docs/downloads/stats/<site>-monthly-<start>_to_<end>_metrics.csv`
+`docs/downloads/stats/<site>-quarterly-<start>_to_<end>_metrics.csv`
+`docs/downloads/stats/<site>-monthly-<start>_to_<end>_visits.csv`
+
+Notes:
+
+- `downloads_size` is in MB.
+
+
+## Generate Yearly Dashboard Report
+
+Generate `docs/dashboard/dashboard-<year>.md` from the current quarterly stats files:
+
+```bash
+python scripts/generate_dashboard_report.py --year 2026 --quiet
+```
+
+Extended usage:
+
+```bash
+python scripts/generate_dashboard_report.py 2026
+python scripts/generate_dashboard_report.py --year 2026 --stats-dir docs/downloads/stats --output docs/dashboard/dashboard-2026.md
+```
+
+Input parameter:
+
+- `year` (for example: `2026`)
+
 
 ## Deployment
 

docs/dashboard/dashboard-2026.md

@@ -0,0 +1,31 @@
+# Usage Statistics for 2026
+
+## Quarterly Reports
+### Q1: January - March 2026
+
+- **Dashboards**
+    - 📊 [IPSL](/downloads/dashboard/2026/dashboard-2026-q1-ipsl.html)
+    - 📊 [DKRZ](/downloads/dashboard/2026/dashboard-2026-q1-dkrz.html)
+
+- **Number of Requests**
+    - **Total**: `409,001`
+        - **DKRZ**: `260,752`
+        - **IPSL**: `148,249`
+
+- **Data Transfer (Subsetted Data)**
+    - **Total**: `28.97 TB`
+        - **DKRZ**: `18.71 TB`
+        - **IPSL**: `10.27 TB`
+
+- **Max Concurrency**: #`19`
+
+
+---
+
+## Monthly Reports
+
+| Month | ALL | IPSL | DKRZ |
+|------------------|----------------|----------------|----------------|
+| **March 2026** | [View](/downloads/dashboard/2026/dashboard-2026-03-all.html) | [View](/downloads/dashboard/2026/dashboard-2026-03-ipsl.html) | [View](/downloads/dashboard/2026/dashboard-2026-03-dkrz.html) |
+| **February 2026** | [View](/downloads/dashboard/2026/dashboard-2026-02-all.html) | [View](/downloads/dashboard/2026/dashboard-2026-02-ipsl.html) | [View](/downloads/dashboard/2026/dashboard-2026-02-dkrz.html) |
+| **January 2026** | [View](/downloads/dashboard/2026/dashboard-2026-01-all.html) | [View](/downloads/dashboard/2026/dashboard-2026-01-ipsl.html) | [View](/downloads/dashboard/2026/dashboard-2026-01-dkrz.html) |