studentprognose 1.1.0__tar.gz

studentprognose-1.1.0/.github/workflows/ci.yml

@@ -0,0 +1,11 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  unit:
+    uses: ./.github/workflows/unit.yml

studentprognose-1.1.0/.github/workflows/pypi-publish.yml

@@ -0,0 +1,68 @@
+name: Publish Python 🐍 package to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+jobs:
+  test:
+    name: Run tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: uv sync --group dev
+
+      - name: Run tests
+        run: uv run pytest
+
+  build:
+    name: Build distribution
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - name: Store distribution packages
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/studentprognose/
+    permissions:
+      id-token: write
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

studentprognose-1.1.0/.github/workflows/unit.yml

@@ -0,0 +1,25 @@
+name: Unit tests
+
+on:
+  workflow_call:
+
+jobs:
+  test:
+    name: Unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: uv sync --group dev
+
+      - name: Run unit tests
+        run: uv run pytest tests/ -v

studentprognose-1.1.0/.gitignore

@@ -0,0 +1,21 @@
+__pycache__/
+*.pyc
+.venv/
+.vscode/
+
+#Data files can be ignored
+data/*
+
+!data/input
+data/input/*
+!data/input/.gitkeep
+
+!data/output
+data/output/*
+!data/output/.gitkeep
+
+!data/metadata
+
+!data/input_raw
+
+

studentprognose-1.1.0/.pre-commit-config.yaml

@@ -0,0 +1,18 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+
+  - repo: https://github.com/psf/black
+    rev: 24.8.0
+    hooks:
+      - id: black
+        args: [--line-length=99]
+
+exclude: |
+    (?x)(
+        ^hooks/
+    )

studentprognose-1.1.0/.python-version

@@ -0,0 +1 @@
+3.12

studentprognose-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Radboud Institutional Research
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

studentprognose-1.1.0/PKG-INFO

@@ -0,0 +1,231 @@
+Metadata-Version: 2.4
+Name: studentprognose
+Version: 1.1.0
+Summary: Studentprognose tool voor het voorspellen van eerstejaars instroom in het hoger onderwijs
+Project-URL: Homepage, https://github.com/cedanl/studentprognose
+Project-URL: Repository, https://github.com/cedanl/studentprognose
+Project-URL: Issues, https://github.com/cedanl/studentprognose/issues
+Author-email: CEDA <info@cedanl.nl>
+License: MIT
+License-File: LICENSE
+Keywords: hoger-onderwijs,instroom,machine-learning,onderwijs,prognose
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Education
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.12
+Requires-Dist: matplotlib>=3.10.0
+Requires-Dist: openpyxl>=3.1.5
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: pillow>=12.2.0
+Requires-Dist: scikit-learn>=1.6.1
+Requires-Dist: scipy>=1.13.0
+Requires-Dist: statsmodels>=0.14.4
+Requires-Dist: tqdm>=4.67.1
+Requires-Dist: xgboost>=2.1.3
+Provides-Extra: dev
+Requires-Dist: pre-commit>=4.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<div align="center">
+  <a href="https://github.com/cedanl/studentprognose">
+    <img src="doc/header.svg" alt="Studentprognose" style="max-width: 100%;">
+  </a>
+
+  <h3>Voorspel je studentinstroom maanden vooruit — met je eigen data, op je eigen machine.</h3>
+
+  <p>
+    <a href="https://www.voxweb.nl/nieuws/de-universiteit-heeft-nu-haar-eigen-glazen-bol-nieuw-model-voorspelt-toekomstige-instroom-van-studenten"><img src="https://img.shields.io/badge/Ingezet_door-Radboud_Universiteit-darkred" alt="Radboud Universiteit"></a>
+    <a href="https://github.com/cedanl"><img src="https://img.shields.io/badge/Onderhouden_door-CEDA-blue" alt="CEDA"></a>
+    <img src="https://badgen.net/github/contributors/cedanl/studentprognose" alt="Contributors">
+    <img src="https://img.shields.io/github/license/cedanl/studentprognose" alt="GitHub License">
+    <br>
+    <a href="#"><img src="https://img.shields.io/badge/Python-≥3.12-3776AB?logo=python&logoColor=white" alt="Python"></a>
+    <img src="https://badgen.net/github/last-commit/cedanl/studentprognose" alt="GitHub Last Commit">
+    <a href="#"><img src="https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white" alt="Windows"></a>
+    <a href="#"><img src="https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=F0F0F0" alt="macOS"></a>
+    <a href="#"><img src="https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black" alt="Linux"></a>
+  </p>
+
+</div>
+
+---
+
+## 📦 Aan de slag
+
+```bash
+# 1. Installeer uv (zie https://docs.astral.sh/uv/getting-started/installation/)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 2. Clone de repository
+git clone https://github.com/cedanl/studentprognose.git
+cd studentprognose
+
+# 3. Draai het model met demodata
+uv run main.py
+```
+
+> [!NOTE]
+> Demodata is meegeleverd in `data/input`, zodat je direct kunt starten. Controleer welke jaren en weken beschikbaar zijn — zonder specificatie gebruikt het script de huidige week, wat mogelijk niet werkt met de meegeleverde data.
+
+---
+
+## 🗃️ Studielink Data
+
+> [!IMPORTANT]
+> Dit model werkt met **Studielink-telbestanden**. Je hebt deze data nodig om voorspellingen te maken voor jouw instelling. Demodata is meegeleverd zodat je het model eerst kunt uitproberen.
+
+---
+
+## Waarom dit model?
+
+Dit model is gebouwd voor **data-analisten bij Nederlandse onderwijsinstellingen** die werken met Studielink-data. Je hebt geen machine learning-expertise nodig.
+
+| | |
+|---|---|
+| **Bring Your Own Data** | Je levert je eigen data aan — er wordt niets extern gedeeld |
+| **Privacy-vriendelijk** | Draait volledig lokaal op je eigen machine |
+| **Open source** | Transparant, aanpasbaar en gratis te gebruiken |
+| **Demo data inbegrepen** | Direct uitproberen zonder eigen data — demobestanden zitten in `data/input` |
+
+---
+
+## ✨ Gebruik
+
+### Jaren en weken
+
+Specificeer jaar en week met `-y` en `-w`:
+
+```bash
+uv run main.py -w 6 -y 2024
+uv run main.py -W 1 2 3 -Y 2024
+uv run main.py -year 2023 2024
+uv run main.py -week 40 41
+```
+
+Gebruik slicing voor een reeks weken:
+
+```bash
+uv run main.py -w 10 : 20 -y 2023
+```
+
+### Datasets
+
+Er zijn twee datasets beschikbaar: **individual** (per student) en **cumulative** (geaggregeerd per opleiding/herkomst/jaar/week). Standaard worden beide gebruikt.
+
+```bash
+uv run main.py -d individual
+uv run main.py -D cumulative
+uv run main.py -dataset both
+```
+
+### Configuratie
+
+Het standaard configuratiebestand is `configuration/configuration.json`. Dit kan worden overschreven:
+
+```bash
+uv run main.py -c pad/naar/configuration.json
+uv run main.py -configuration langer/pad/naar/config.json
+```
+
+### Uitgebreid voorbeeld
+
+Voorspel eerstejaars voor 2023 en 2024, weken 10 t/m 20, met beide datasets:
+
+```bash
+uv run main.py -y 2023 2024 -w 10 : 20 -d b
+```
+
+Voorspel eerstejaars voor collegejaar 2025/2026, week 5, alleen cumulatief:
+
+```bash
+uv run main.py -y 2025 -w 5 -d c
+```
+
+### Syntax overzicht
+
+| Instelling              | Korte notatie  | Lange notatie    | Opties                                      |
+|-------------------------|----------------|------------------|---------------------------------------------|
+| Voorspellingsjaren      | `-y` of `-Y`   | `-year`          | Eén of meer jaren, bijv. `2023 2024`        |
+| Voorspellingsweken      | `-w` of `-W`   | `-week`          | Eén of meer weken, bijv. `10 11 12`         |
+| Slicing                 |                |                  | Gebruik `:` voor reeksen, bijv. `10 : 20`   |
+| Dataset                 | `-d` of `-D`   | `-dataset`       | `i`/`individual`, `c`/`cumulative`, `b`/`both` |
+| Configuratie            | `-c` of `-C`   | `-configuration` | Pad naar configuratiebestand                |
+---
+
+## 📁 Beschrijving van bestanden
+
+### Input
+
+| Bestand | Beschrijving |
+|---------|-------------|
+| **individual** | Individuele (voor)aanmeldingen per student. Wordt gebruikt voor de SARIMA_individual voorspelling. |
+| **cumulative** | Aantal aanmeldingen per opleiding, herkomst, jaar, week en herinschrijving/hogerejaars. Wordt gebruikt voor de SARIMA_cumulative voorspelling. Verkregen via Studielink. |
+| **latest** | Per opleiding, herkomst, jaar en week: aanmeldingen, voorspellingen en foutwaarden (MAE/MAPE). Wordt gebruikt voor volume- en hogerjaarsvoorspellingen. |
+| **student_count_first-years** | Werkelijk aantal eerstejaars studenten per jaar, opleiding en herkomst. |
+| **student_count_higher-years** | Werkelijk aantal hogerjaars studenten per jaar, opleiding en herkomst. |
+| **student_volume** | Werkelijk totaal aantal studenten (eerstejaars + hogerjaars) per jaar, opleiding en herkomst. |
+| **weighted_ensemble** | Gewichten per model voor de ensemble-voorspelling. |
+
+### Output
+
+| Bestand | Beschrijving |
+|---------|-------------|
+| **output_prelim.xlsx** | Voorlopige output met alle voorspellingen van de huidige run. |
+| **output_first-years.xlsx** | Volledige output met voorspellingen voor eerstejaars studenten. |
+| **output_higher-years.xlsx** | Volledige output met voorspellingen voor hogerjaars studenten. |
+| **output_volume.xlsx** | Volledige output met volume-voorspellingen (totaal). |
+
+---
+
+## 🏗️ Architectuur
+
+### Pipeline executievolgorde
+
+**Gedeelde stappen (alle modi):**
+
+| Stap | Fase | Bestand |
+|------|------|---------|
+| 1 | CLI parsing | `cli.py` |
+| 2 | ETL (skip met `--noetl`) | `etl` |
+| 3 | Configuratie laden | `config.py` |
+| 4 | Data laden | `loader` → `preprocessing/add_zero_weeks` |
+| 5 | CI subset (indien `--ci`) | `utils/ci_subset` |
+
+**Modus-specifieke stappen:**
+
+| Stap | Fase | Individual (`-d i`) | Cumulative (`-d c`) | Both (`-d b`) |
+|------|------|---------------------|---------------------|---------------|
+| 6 | Preprocessing | `strategies/individual` | `strategies/cumulative` | individual → cumulative |
+| 7 | Filtering | `strategies/base` | `strategies/base` | `strategies/base` |
+| 8 | Classificatie | `xgboost_classifier` | — | `xgboost_classifier` |
+| 9 | Transformatie | `transforms` | — | `transforms` |
+| 10 | SARIMA | `sarima` (individual) | `sarima` → `transforms` | `sarima` (both) |
+| 11 | XGBoost regressor | — | `xgboost_regressor` | `xgboost_regressor` |
+| 12 | Ratio model | — | `ratio` | `ratio` |
+| 13 | Postprocessing + Opslaan | `postprocessor` | `postprocessor` | `postprocessor` |
+
+Zie de [Technische README](doc/TECHNICAL_README.md) voor meer details over de architectuur.
+
+---
+
+## 🤝 Bijdragen
+
+Dit project wordt actief onderhouden door [CEDA](https://github.com/cedanl). Wil je bijdragen of meedenken? Sluit je aan bij de [werkgroep](https://edu.nl/6d69d).
+
+## 🆘 Ondersteuning
+
+Voor vragen of problemen:
+- **GitHub Issues**: [Probleem melden](https://github.com/cedanl/studentprognose/issues)
+
+---
+
+<div align="center">
+  <sub>Gebouwd met ❤️ door de <a href="https://github.com/cedanl">CEDANL</a> community</sub>
+</div>
+
+

studentprognose-1.1.0/README.md

@@ -0,0 +1,198 @@
+<div align="center">
+  <a href="https://github.com/cedanl/studentprognose">
+    <img src="doc/header.svg" alt="Studentprognose" style="max-width: 100%;">
+  </a>
+
+  <h3>Voorspel je studentinstroom maanden vooruit — met je eigen data, op je eigen machine.</h3>
+
+  <p>
+    <a href="https://www.voxweb.nl/nieuws/de-universiteit-heeft-nu-haar-eigen-glazen-bol-nieuw-model-voorspelt-toekomstige-instroom-van-studenten"><img src="https://img.shields.io/badge/Ingezet_door-Radboud_Universiteit-darkred" alt="Radboud Universiteit"></a>
+    <a href="https://github.com/cedanl"><img src="https://img.shields.io/badge/Onderhouden_door-CEDA-blue" alt="CEDA"></a>
+    <img src="https://badgen.net/github/contributors/cedanl/studentprognose" alt="Contributors">
+    <img src="https://img.shields.io/github/license/cedanl/studentprognose" alt="GitHub License">
+    <br>
+    <a href="#"><img src="https://img.shields.io/badge/Python-≥3.12-3776AB?logo=python&logoColor=white" alt="Python"></a>
+    <img src="https://badgen.net/github/last-commit/cedanl/studentprognose" alt="GitHub Last Commit">
+    <a href="#"><img src="https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white" alt="Windows"></a>
+    <a href="#"><img src="https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=F0F0F0" alt="macOS"></a>
+    <a href="#"><img src="https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black" alt="Linux"></a>
+  </p>
+
+</div>
+
+---
+
+## 📦 Aan de slag
+
+```bash
+# 1. Installeer uv (zie https://docs.astral.sh/uv/getting-started/installation/)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 2. Clone de repository
+git clone https://github.com/cedanl/studentprognose.git
+cd studentprognose
+
+# 3. Draai het model met demodata
+uv run main.py
+```
+
+> [!NOTE]
+> Demodata is meegeleverd in `data/input`, zodat je direct kunt starten. Controleer welke jaren en weken beschikbaar zijn — zonder specificatie gebruikt het script de huidige week, wat mogelijk niet werkt met de meegeleverde data.
+
+---
+
+## 🗃️ Studielink Data
+
+> [!IMPORTANT]
+> Dit model werkt met **Studielink-telbestanden**. Je hebt deze data nodig om voorspellingen te maken voor jouw instelling. Demodata is meegeleverd zodat je het model eerst kunt uitproberen.
+
+---
+
+## Waarom dit model?
+
+Dit model is gebouwd voor **data-analisten bij Nederlandse onderwijsinstellingen** die werken met Studielink-data. Je hebt geen machine learning-expertise nodig.
+
+| | |
+|---|---|
+| **Bring Your Own Data** | Je levert je eigen data aan — er wordt niets extern gedeeld |
+| **Privacy-vriendelijk** | Draait volledig lokaal op je eigen machine |
+| **Open source** | Transparant, aanpasbaar en gratis te gebruiken |
+| **Demo data inbegrepen** | Direct uitproberen zonder eigen data — demobestanden zitten in `data/input` |
+
+---
+
+## ✨ Gebruik
+
+### Jaren en weken
+
+Specificeer jaar en week met `-y` en `-w`:
+
+```bash
+uv run main.py -w 6 -y 2024
+uv run main.py -W 1 2 3 -Y 2024
+uv run main.py -year 2023 2024
+uv run main.py -week 40 41
+```
+
+Gebruik slicing voor een reeks weken:
+
+```bash
+uv run main.py -w 10 : 20 -y 2023
+```
+
+### Datasets
+
+Er zijn twee datasets beschikbaar: **individual** (per student) en **cumulative** (geaggregeerd per opleiding/herkomst/jaar/week). Standaard worden beide gebruikt.
+
+```bash
+uv run main.py -d individual
+uv run main.py -D cumulative
+uv run main.py -dataset both
+```
+
+### Configuratie
+
+Het standaard configuratiebestand is `configuration/configuration.json`. Dit kan worden overschreven:
+
+```bash
+uv run main.py -c pad/naar/configuration.json
+uv run main.py -configuration langer/pad/naar/config.json
+```
+
+### Uitgebreid voorbeeld
+
+Voorspel eerstejaars voor 2023 en 2024, weken 10 t/m 20, met beide datasets:
+
+```bash
+uv run main.py -y 2023 2024 -w 10 : 20 -d b
+```
+
+Voorspel eerstejaars voor collegejaar 2025/2026, week 5, alleen cumulatief:
+
+```bash
+uv run main.py -y 2025 -w 5 -d c
+```
+
+### Syntax overzicht
+
+| Instelling              | Korte notatie  | Lange notatie    | Opties                                      |
+|-------------------------|----------------|------------------|---------------------------------------------|
+| Voorspellingsjaren      | `-y` of `-Y`   | `-year`          | Eén of meer jaren, bijv. `2023 2024`        |
+| Voorspellingsweken      | `-w` of `-W`   | `-week`          | Eén of meer weken, bijv. `10 11 12`         |
+| Slicing                 |                |                  | Gebruik `:` voor reeksen, bijv. `10 : 20`   |
+| Dataset                 | `-d` of `-D`   | `-dataset`       | `i`/`individual`, `c`/`cumulative`, `b`/`both` |
+| Configuratie            | `-c` of `-C`   | `-configuration` | Pad naar configuratiebestand                |
+---
+
+## 📁 Beschrijving van bestanden
+
+### Input
+
+| Bestand | Beschrijving |
+|---------|-------------|
+| **individual** | Individuele (voor)aanmeldingen per student. Wordt gebruikt voor de SARIMA_individual voorspelling. |
+| **cumulative** | Aantal aanmeldingen per opleiding, herkomst, jaar, week en herinschrijving/hogerejaars. Wordt gebruikt voor de SARIMA_cumulative voorspelling. Verkregen via Studielink. |
+| **latest** | Per opleiding, herkomst, jaar en week: aanmeldingen, voorspellingen en foutwaarden (MAE/MAPE). Wordt gebruikt voor volume- en hogerjaarsvoorspellingen. |
+| **student_count_first-years** | Werkelijk aantal eerstejaars studenten per jaar, opleiding en herkomst. |
+| **student_count_higher-years** | Werkelijk aantal hogerjaars studenten per jaar, opleiding en herkomst. |
+| **student_volume** | Werkelijk totaal aantal studenten (eerstejaars + hogerjaars) per jaar, opleiding en herkomst. |
+| **weighted_ensemble** | Gewichten per model voor de ensemble-voorspelling. |
+
+### Output
+
+| Bestand | Beschrijving |
+|---------|-------------|
+| **output_prelim.xlsx** | Voorlopige output met alle voorspellingen van de huidige run. |
+| **output_first-years.xlsx** | Volledige output met voorspellingen voor eerstejaars studenten. |
+| **output_higher-years.xlsx** | Volledige output met voorspellingen voor hogerjaars studenten. |
+| **output_volume.xlsx** | Volledige output met volume-voorspellingen (totaal). |
+
+---
+
+## 🏗️ Architectuur
+
+### Pipeline executievolgorde
+
+**Gedeelde stappen (alle modi):**
+
+| Stap | Fase | Bestand |
+|------|------|---------|
+| 1 | CLI parsing | `cli.py` |
+| 2 | ETL (skip met `--noetl`) | `etl` |
+| 3 | Configuratie laden | `config.py` |
+| 4 | Data laden | `loader` → `preprocessing/add_zero_weeks` |
+| 5 | CI subset (indien `--ci`) | `utils/ci_subset` |
+
+**Modus-specifieke stappen:**
+
+| Stap | Fase | Individual (`-d i`) | Cumulative (`-d c`) | Both (`-d b`) |
+|------|------|---------------------|---------------------|---------------|
+| 6 | Preprocessing | `strategies/individual` | `strategies/cumulative` | individual → cumulative |
+| 7 | Filtering | `strategies/base` | `strategies/base` | `strategies/base` |
+| 8 | Classificatie | `xgboost_classifier` | — | `xgboost_classifier` |
+| 9 | Transformatie | `transforms` | — | `transforms` |
+| 10 | SARIMA | `sarima` (individual) | `sarima` → `transforms` | `sarima` (both) |
+| 11 | XGBoost regressor | — | `xgboost_regressor` | `xgboost_regressor` |
+| 12 | Ratio model | — | `ratio` | `ratio` |
+| 13 | Postprocessing + Opslaan | `postprocessor` | `postprocessor` | `postprocessor` |
+
+Zie de [Technische README](doc/TECHNICAL_README.md) voor meer details over de architectuur.
+
+---
+
+## 🤝 Bijdragen
+
+Dit project wordt actief onderhouden door [CEDA](https://github.com/cedanl). Wil je bijdragen of meedenken? Sluit je aan bij de [werkgroep](https://edu.nl/6d69d).
+
+## 🆘 Ondersteuning
+
+Voor vragen of problemen:
+- **GitHub Issues**: [Probleem melden](https://github.com/cedanl/studentprognose/issues)
+
+---
+
+<div align="center">
+  <sub>Gebouwd met ❤️ door de <a href="https://github.com/cedanl">CEDANL</a> community</sub>
+</div>
+
+