feat: neue Website mit Docker-Deployment

2026-07-13 22:12:02 +02:00
commit 5f9e64e9f4
17 changed files with 3603 additions and 0 deletions
@@ -0,0 +1,67 @@
+# Neue Website der Hardtschule Karlsruhe
+
+Ein eigenständiger, responsiver Website-Prototyp auf Basis öffentlich auffindbarer Informationen der bisherigen Schulwebsite, des Webarchivs und der Stadt Karlsruhe.
+
+## Lokal ansehen
+
+```sh
+npm run dev
+```
+
+Danach ist die Seite unter `http://127.0.0.1:4173` erreichbar.
+
+## Mit Docker betreiben
+
+Das veröffentlichte Image kann direkt aus der Gitea-Container-Registry gestartet werden:
+
+```sh
+docker run -d \
+  --name hardtschule-website \
+  --restart unless-stopped \
+  -p 8080:80 \
+  git.servercentral.org/jonas/hardtschule-karlsruhe.de:latest
+```
+
+Die Website ist anschließend unter `http://localhost:8080` erreichbar. Alternativ genügt mit der enthaltenen Compose-Datei:
+
+```sh
+docker compose up -d
+```
+
+Falls das Gitea-Paket nicht öffentlich ist, muss auf dem Zielsystem zuvor einmal `docker login git.servercentral.org` ausgeführt werden.
+
+### Image lokal bauen
+
+```sh
+docker build -t hardtschule-website .
+docker run --rm -p 8080:80 hardtschule-website
+```
+
+### Automatischer Build in Gitea
+
+Der Workflow unter `.gitea/workflows/docker.yml` baut bei jedem Push auf `main` zwei Tags:
+
+- `git.servercentral.org/jonas/hardtschule-karlsruhe.de:latest`
+- `git.servercentral.org/jonas/hardtschule-karlsruhe.de:<commit-sha>`
+
+Damit der Workflow das Image veröffentlichen kann:
+
+1. Repository-Actions und einen Runner mit dem Label `ubuntu-latest` aktivieren.
+2. In Gitea einen Personal Access Token mit Schreibrecht für Pakete erstellen.
+3. Unter **Repository → Einstellungen → Actions → Secrets** die Secrets `REGISTRY_USERNAME` und `REGISTRY_TOKEN` hinterlegen.
+
+Der unveränderliche Commit-Tag erlaubt bei Bedarf ein gezieltes Rollback. `latest` zeigt immer auf den aktuellen Stand von `main`.
+
+## Inhaltliche Quellen
+
+- bisherige Website und Webarchiv der Hardtschule Karlsruhe
+- Stadt Karlsruhe: Hardtschule – Brandschutz und WC-Sanierung
+- Stadt Karlsruhe: Städtischer Schülerhort an der Hardtschule
+- Werkraum Karlsruhe: Theaterprojekte 2023/24
+
+## Vor einer Veröffentlichung
+
+- aktuelle Termine, Materiallisten und Pläne ergänzen
+- Kontaktangaben und Zuständigkeiten von der Schule bestätigen lassen
+- Impressum und Datenschutz an Hosting und tatsächliche Dienste anpassen
+- Nutzungsfreigabe für Fotos dokumentieren (Fotos im Prototyp: Dirk Altenkirch / Stadt Karlsruhe)