No description
Find a file
Friederich Loheide 391c91d4b0
Some checks failed
Prüfen / pruefen (pull_request) Failing after 2m33s
CI und Docker: Build-Werkzeuge für better-sqlite3, CI nur für PRs und main
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-09 19:03:24 +00:00
.forgejo/workflows CI und Docker: Build-Werkzeuge für better-sqlite3, CI nur für PRs und main 2026-10-09 19:03:24 +00:00
data Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
deploy Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
drizzle Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
mobile Erscheinungsbild je Einrichtung: Vorlagen, Schriften, Farben, mehrere Installationen 2026-10-09 17:54:11 +00:00
scripts Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
src Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
tests/e2e Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
.dockerignore Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
.env.example Leichte Sprache automatisch für Leser, mehrere KI-Anbieter 2026-10-03 05:49:18 +00:00
.gitignore Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
.npmrc Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
CHANGELOG.md Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
docker-compose.yml Leichte Sprache automatisch für Leser, mehrere KI-Anbieter 2026-10-03 05:49:18 +00:00
Dockerfile CI und Docker: Build-Werkzeuge für better-sqlite3, CI nur für PRs und main 2026-10-09 19:03:24 +00:00
drizzle.config.ts Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
package-lock.json Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
package.json Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
playwright.config.ts Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
README.md Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00
svelte.config.js Sicherheit der Redaktion: 2FA, Passwort-Reset, CSP, dauerhafte Sperren 2026-09-30 17:21:38 +00:00
tsconfig.json Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
vite.config.ts Speiseplan, Übersetzungen, Statistik, Überwachung, Tests und CI (0.2.0) 2026-10-09 19:01:41 +00:00

Werkstatt-App

Eine moderne, werbefreie Info-App für Werkstätten für Menschen mit Behinderung (WfbM) – mit einfachem Redaktions-Backend. Läuft als installierbare Web-App (PWA) auf Handy, Tablet und Desktop.

Funktionen

App (öffentlich)

  • Startseite je nach Vorlage – z. B. großes Titelbild mit Akzentkreis und umlaufendem Text –, Hinweis-Fahne (Schließzeit oder angeheftete Meldung), Suche, Bereichen, Neuigkeiten und Terminen
  • Meldungen mit Titelbild, Galerie, Video (datensparsam erst nach Klick), Dateien und Ansprechpartnern
  • Infoseiten in beliebiger Tiefe (z. B. „Dienste → Sozialer Dienst“)
  • Termine & Schließzeiten, gruppiert nach Monat, mit Kalender-Abo (/termine.ics)
  • Speiseplan pro Woche mit Linien (z. B. „Menü 1“), Standorten, Kennzeichnung (vegan, vegetarisch, Fisch …) und den 14 Allergenen nach LMIV; „Heute gibt es“ auf der Startseite
  • Andere Sprachen per KI: Meldungen und Seiten auf Englisch, Türkisch, Arabisch, Ukrainisch, Russisch, Polnisch, Rumänisch oder Persisch – für Angehörige; gekennzeichnet, mit „Original anzeigen“, Arabisch/Persisch von rechts nach links, Vorlesen in der jeweiligen Sprache
  • Ansprechpartner-Verzeichnis, Kontaktformular, Volltextsuche
  • Barrierearm: klare Schrift (selbst gehostet, wählbar), 3 Schriftgrößen, Hell/Dunkel, Leichte Sprache pro Seite/Meldung – geprüfte Fassung (auch als KI-Entwurf erstellt) oder, wenn so eingestellt, automatisch per KI übertragen (gekennzeichnet, mit „Fehler melden“)
  • Vorlesen jeder Seite (Knopf in der Kopfzeile) oder eines Artikels: satzweise, der gelesene Satz wird markiert und mitgescrollt, mit Pause, Satz vor/zurück und langsamem Tempo
  • Push-Benachrichtigungen zu Neuigkeiten und Schließzeiten (Themen frei wählbar, jederzeit abbestellbar)
  • Merkliste (lokal auf dem Gerät), Teilen, offline lesbar, als App installierbar
  • Seite Barrierefreiheit mit Erklärung und Formular „Barriere melden“
  • Keine Werbung, kein Tracking, keine externen Schriften oder CDNs

Redaktion (/admin)

  • Redaktionskalender fürs Team: Planungen mit Status (Idee → In Arbeit → Zur Freigabe → Geplant → Erledigt), Zuständigkeit, Frist, Notizen und Kommentaren; Monatsansicht mit Meldungen und Terminen, Board nach Status, Liste; Ziehen & Ablegen (mit Tastatur-Alternative), Ideenspeicher, „Meldung daraus erstellen“, „Meine Aufgaben“ auf der Übersicht
  • Ansprechpartner einmal anlegen und in beliebig vielen Seiten und Meldungen verwenden – mit Suche, Reihenfolge, Anlegen direkt aus dem Auswahlfeld und „Verwendet in“
  • Meldungen (Entwurf, geplante Veröffentlichung, anheften), Seitenbaum, Termine, Startseiten-Bereiche, Mediathek, Postfach
  • Text-Editor mit Formatierungen, Links und Bildern
  • Leichte Sprache per KI (Einstellungen): Anbieter Anthropic (Claude), OpenAI, Mistral (EU), DeepSeek oder Ollama, Modell wählbar, Schlüssel verschlüsselt gespeichert, Verbindungstest, Tageslimit. Arbeitsweise „Mit Prüfung“ (Knopf „Mit KI erstellen“ → Entwurf prüfen → speichern) oder „Automatisch für Leser“
  • Bilder werden automatisch gedreht, verkleinert und als WebP gespeichert
  • Speiseplan pflegen: Wochenansicht, Gericht per Dialog, „Vorwoche übernehmen“, Linien und Standorte
  • Statistik: anonyme Aufrufzahlen (ohne Cookies und IP-Adressen) – Verlauf, meistgelesene Inhalte, Anteil App/Web, Nutzung von Leichter Sprache und Übersetzungen
  • Benachrichtigungen: beim Erscheinen einer Meldung (auch zeitgesteuert), automatisch am Vortag einer Schließzeit, oder von Hand – mit Vorschau und Verlauf
  • Rechtliches: Impressum und Datenschutzerklärung aus Vorlagen, die genau beschreiben, was die App verarbeitet (bitte trotzdem prüfen lassen); Erklärung zur Barrierefreiheit; Barriere-Meldungen im Postfach
  • Sicherheit: Zwei-Faktor-Anmeldung (Authenticator-App, Wiederherstellungscodes, für Admins verpflichtend schaltbar), „Passwort vergessen“ per E-Mail, dauerhafte Sperren gegen Durchprobieren, Content-Security-Policy
  • Rollen: Redakteur (Inhalte) und Administrator (zusätzlich Benutzer & Einstellungen)
  • Erscheinungsbild je Einrichtung: drei Vorlagen (Kreis, Klar, Kacheln) mit Feinschliff – Hausfarben mit Kontrastprüfung („Farbe anpassen“ dunkelt zu helle Töne ab), vier gut lesbare Schriften (u. a. Atkinson Hyperlegible), eckig/rund/sehr rund. Das App-Symbol wird daraus erzeugt.
  • Checkliste „Erste Schritte“ im Dashboard führt neue Einrichtungen durch die Einrichtung

Native Apps (iOS und Android)

Im Ordner mobile/ liegt die Capacitor-Hülle für App Store und Play Store – mit Push-Nachrichten über Firebase, nativem Vorlesen, App-Links und Symbolen aus den Einstellungen. Gebaut wird auf einem Mac mit Xcode bzw. Android Studio; die Schritte stehen in mobile/README.md. Die Apps laden die Inhalte von der Web-App, neue Inhalte brauchen also kein App-Update.

Barrierefreiheit

App und Redaktion werden mit axe-core gegen WCAG 2.2 AA geprüft (hell und dunkel, Handy und Desktop) – aktuell ohne Befund. Dazu u. a.: Sprunglinks zum Inhalt, sichtbarer Tastaturfokus, beschriftete Bedienelemente, Ansagen für Screenreader bei Änderungen, Tastatur-Alternativen zu Ziehen & Ablegen, prefers-reduced-motion, Kontrast ≥ 4,5 : 1. Schriftgröße und Farbschema lassen sich auch in der Redaktion einstellen (Mein Konto).

Tests

npm run test:unit   # Vitest: Logik und Server-Funktionen mit eigener Test-Datenbank
npm run build
npm run test:e2e    # Playwright: Leser (Handy) und Redaktion (Desktop) inkl. axe-Prüfung, hell und dunkel

Die Ende-zu-Ende-Tests starten die gebaute App mit frischer Demo-Datenbank und einem nachgebauten KI-Dienst (tests/e2e/). Einmalig npx playwright install chromium – oder mit PW_CHROMIUM=/pfad/zu/chrome ein vorhandenes Chromium nutzen.

Forgejo Actions: .forgejo/workflows/ci.yml prüft jeden Push (Typen, Unit-Tests, Build, Ende-zu-Ende). .forgejo/workflows/release.yml baut bei einem Tag v1.2.0 das Docker-Image und legt es als git.loheide.cloud/friloo/werkstaetten-app:1.2.0 (und :latest) in die Registry. Dafür braucht es einen Forgejo-Runner mit dem Label docker (für den Release-Job mit Zugriff auf den Docker-Socket) und das Repository-Secret REGISTRY_TOKEN (Token mit „package: write“). Änderungen stehen in CHANGELOG.md.

Technik

SvelteKit 2 (Svelte 5) · Tailwind CSS 4 · SQLite (better-sqlite3) mit Drizzle ORM · sharp · Tiptap. Bewusst schlank: ein Node-Prozess, eine SQLite-Datei, ein Upload-Ordner (~200 MB RAM im Betrieb).

Loslegen (Entwicklung)

npm install
npm run db:seed                       # Demo-Inhalte (fiktive „Lindenhof Werkstätten“)
npm run user:create -- admin@example.org ein-langes-passwort admin "Vorname Name"
npm run dev

App: http://localhost:5173 · Redaktion: http://localhost:5173/admin

Betrieb

cp .env.example .env    # ORIGIN, ADMIN_EMAIL, ADMIN_PASSWORD setzen
docker compose up -d --build

Alle Daten (Datenbank + Uploads) liegen in ./data – das ist das Einzige, was gesichert werden muss. Der Container lauscht auf 127.0.0.1:3000; davor einen Reverse-Proxy mit HTTPS (z. B. Caddy) setzen. Ohne Docker: npm ci && npm run build && ORIGIN=https://… BODY_SIZE_LIMIT=30M node build.

Überwachung: GET /health antwortet mit Status, Version und Datenbank-Zustand (HTTP 503 bei Problemen) – geeignet für Uptime-Kuma, Healthchecks o. ä. Unerwartete Fehler landen im Log und, mit ALERT_EMAIL, im Postfach der Betreuung. Die Version steht unten in der Seitenleiste der Redaktion.

Variable Bedeutung
ORIGIN Öffentliche URL (Pflicht in Produktion, sonst schlagen Formulare fehl)
DATA_DIR Ordner für app.db und uploads/ (Standard ./data)
ADMIN_EMAIL / ADMIN_PASSWORD Erster Admin, wird angelegt, solange es noch keinen Benutzer gibt
APP_NAME, ORG_NAME, BRAND_COLOR, ACCENT_COLOR Optionale Startwerte beim allerersten Start
BODY_SIZE_LIMIT Max. Upload-Größe (im Docker-Image auf 30M gesetzt)
ALERT_EMAIL Bekommt unerwartete Fehler per E-Mail (gleiche Fehler höchstens stündlich, max. 20/Tag; braucht SMTP)
APP_VERSION Beim Bauen: Versionsnummer für /health und die Redaktion (Standard: aus package.json)
SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, SMTP_FROM E-Mail-Versand für „Passwort vergessen“. Ohne SMTP steht der Link im Server-Log
GOOGLE_TOKEN_URL, FCM_API_URL Nur für Tests: andere Adressen für Firebase
VAPID_PUBLIC_KEY / VAPID_PRIVATE_KEY Optional – sonst werden die Push-Schlüssel automatisch erzeugt und gespeichert

Mehrere Einrichtungen

Jede Werkstatt bekommt eine eigene Installation: eigener Container, eigene Datenbank, eigene Domain – Daten und Zugänge bleiben strikt getrennt, und jede Einrichtung gestaltet ihre App selbst (Vorlage, Farben, Schrift, Logo unter Einstellungen → Erscheinungsbild). Alle nutzen dasselbe Image.

docker build -t werkstatt-app:latest .            # einmal bzw. bei jedem Update

APP_NAME="Lindenhof-App" ORG_NAME="Lindenhof Werkstätten" BRAND_COLOR=#0f4c5c \
  deploy/neue-einrichtung.sh lindenhof app.lindenhof-werkstaetten.de it@lindenhof.de
cd /srv/werkstatt-apps/lindenhof && docker compose up -d

Das Skript legt /srv/werkstatt-apps/<kurzname>/ mit .env, compose.yml und data/ an, wählt einen freien Port, erzeugt ein Admin-Passwort und gibt den passenden Caddy-Block aus. APP_NAME, ORG_NAME, BRAND_COLOR und ACCENT_COLOR gelten nur für den allerersten Start (zu helle Farben werden automatisch abgedunkelt); danach zählt, was in den Einstellungen steht.

Skript Zweck
deploy/neue-einrichtung.sh <kurzname> <domain> [admin-mail] Einrichtung anlegen
VERSION=1.2.0 deploy/aktualisieren.sh [kurzname …] Image aus der Registry holen (ohne VERSION: lokal bauen), Einrichtungen nacheinander neu starten und per /health prüfen – Migrationen laufen automatisch
deploy/uebersicht.sh Tabelle aller Einrichtungen: Container, App-Zustand, Version, letzte Sicherung (Rückgabewert 1, wenn eine ausfällt – für cron)
deploy/sichern.sh [kurzname …] Datenbank (konsistente Kopie im laufenden Container) und Uploads sichern, 14 Tage aufbewahren

Jede Einrichtung braucht etwa 100–150 MB RAM (Limit 384 MB). Für eigene Apps im Store je Einrichtung siehe mobile/README.md.

Erweitern

  • Neues Feld / neuer Inhaltstyp: src/lib/server/db/schema.ts ändern → npm run db:generate erzeugt eine Migration in drizzle/, die beim nächsten Start automatisch eingespielt wird.
  • Admin-Bereiche folgen alle demselben Muster: src/routes/admin/(panel)/<bereich>/ mit Liste (+page) und Bearbeiten ([id]/+page, neu = anlegen). Bausteine liegen in src/lib/admin/.
  • Icons für Bereiche/Seiten: src/lib/icons.ts. Farben kommen aus den Einstellungen; alle übrigen Töne leitet src/app.css daraus ab.
  • Design-Vorlagen, Schriften, Rundungen: src/lib/theme.ts. Eine Vorlage bestimmt Kopfbereich (src/lib/components/Hero*.svelte), Bereichs-Kacheln (Tile.svelte) und Termine auf der Startseite; Rundungen wirken über data-radius an <html> und die --radius-*-Variablen in src/app.css.
  • Öffentliche Seiten: src/routes/(app)/, Datenabfragen gebündelt in src/lib/server/content.ts.

Ideen für später

E-Mail-Weiterleitung des Kontaktformulars, Umfragen, Bedienoberfläche in weiteren Sprachen.