fix backgroud, add deployment info

DEPLOYMENT.md

@@ -0,0 +1,155 @@
+# Deployment handleiding
+
+De CI/CD pipeline **bouwt enkel de Docker image** en zet die in de container registry.  
+Hoe je die image daarna uitrolt op jouw server is volledig aan jou — hieronder staan de meest gebruikte opties.
+
+---
+
+## Stap 1 — Repo instellen in Gitea
+
+Ga naar **Settings → Actions** van jouw fork/kopie van deze repo en stel in:
+
+### Variables  
+*(Settings → Actions → Variables)*
+
+| Naam | Beschrijving | Voorbeeld |
+|------|-------------|---------|
+| `REGISTRY` | Hostname van jouw container registry | `gitea.jouwdomein.be` of `ghcr.io` |
+| `IMAGE_NAME` | Volledig pad van de image (zonder tag) | `gitea.jouwdomein.be/scholengroep5/leerdoelen-tracker` |
+
+### Secrets  
+*(Settings → Actions → Secrets)*
+
+| Naam | Beschrijving |
+|------|-------------|
+| `REGISTRY_USER` | Gebruikersnaam voor de registry |
+| `REGISTRY_TOKEN` | Wachtwoord of access token |
+
+> **Gitea ingebouwde registry:** maak een Gitea access token aan via  
+> *User Settings → Applications → Generate Token* (scope: `package:write`)
+
+---
+
+## Stap 2 — Server voorbereiden
+
+### `.env` aanmaken op de server
+
+Kopieer `.env.example` naar `.env` en vul alle waarden in:
+
+```bash
+cp .env.example .env
+nano .env
+```
+
+### `docker-compose.yml` aanpassen
+
+Vervang de `build:` sectie van de backend door een `image:` verwijzing naar jouw registry:
+
+```yaml
+services:
+  backend:
+    image: gitea.jouwdomein.be/scholengroep5/leerdoelen-tracker:latest
+    # build: ./backend   ← deze regel weghalen of uitcommentariëren
+    restart: unless-stopped
+    ...
+```
+
+---
+
+## Stap 3 — Deployment opties
+
+### Optie A — Handmatig (eenvoudigst)
+
+Na elke nieuwe build in Gitea voer je dit uit op je server:
+
+```bash
+cd /pad/naar/leerdoelen
+docker compose pull backend
+docker compose up -d --no-deps backend
+docker image prune -f
+```
+
+### Optie B — Watchtower (automatisch)
+
+[Watchtower](https://containrrr.dev/watchtower/) controleert periodiek of er nieuwe images zijn en herstart containers automatisch.
+
+```yaml
+# Voeg toe aan je docker-compose.yml
+  watchtower:
+    image: containrrr/watchtower
+    restart: unless-stopped
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock
+      - /root/.docker/config.json:/config.json   # voor private registry auth
+    command: --interval 300 --cleanup backend    # elke 5 min, enkel backend container
+    environment:
+      - WATCHTOWER_POLL_INTERVAL=300
+```
+
+Zorg dat Docker op de server ingelogd is op jouw registry:
+```bash
+docker login gitea.jouwdomein.be -u jouw-user
+```
+
+### Optie C — Portainer webhook
+
+Als je Portainer gebruikt:
+1. Ga naar jouw stack → **Webhooks**
+2. Kopieer de webhook URL
+3. Voeg in Gitea een **webhook** toe onder *Settings → Webhooks*  
+   → URL = jouw Portainer webhook, trigger = **push**
+
+Portainer pulled dan automatisch de nieuwe image en herstart de service.
+
+### Optie D — Gitea runner met SSH (zelf te schrijven)
+
+Als je toch een geautomatiseerde SSH-deploy wil, maak dan een **aparte workflow** in jouw eigen fork — niet in de gedeelde repo. Voorbeeld:
+
+```yaml
+# .gitea/workflows/deploy.yml  — enkel in JOUW fork, niet in de gedeelde repo
+name: Deploy naar onze VPS
+on:
+  workflow_run:
+    workflows: ["Build & Push"]
+    types: [completed]
+
+jobs:
+  deploy:
+    if: ${{ github.event.workflow_run.conclusion == 'success' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: SSH deploy
+        uses: appleboy/ssh-action@v1
+        with:
+          host:     ${{ secrets.DEPLOY_HOST }}
+          username: ${{ secrets.DEPLOY_USER }}
+          key:      ${{ secrets.DEPLOY_SSH_KEY }}
+          script: |
+            cd /pad/naar/leerdoelen
+            docker compose pull backend
+            docker compose up -d --no-deps backend
+            docker image prune -f
+```
+
+---
+
+## Updates installeren
+
+```bash
+# Image pullen en backend herstarten (downtime < 1 seconde)
+docker compose pull backend && docker compose up -d --no-deps backend
+
+# Eventuele database migraties worden automatisch uitgevoerd bij het opstarten
+# (zie entrypoint.sh — flask db upgrade)
+```
+
+## Rollback
+
+Elke build krijgt ook een `sha-XXXXXXXX` tag. Rollback naar een vorige versie:
+
+```bash
+# Vervang sha-tag door de gewenste commit hash
+docker compose stop backend
+docker compose run --rm -e IMAGE_TAG=sha-a1b2c3d4 backend echo ok
+# Of pas IMAGE_NAME in je .env tijdelijk aan naar de sha-tag
+```