No description
Find a file
Friederich Loheide 0dfb787d06 Push-Benachrichtigungen, Rechtstexte und Barrierefreiheitserklärung
Push:
- Abos mit Themen (Neuigkeiten, Schließzeiten), jederzeit abbestellbar;
  iPhone-Hinweis zur Installation; VAPID-Schlüssel automatisch erzeugt
- Meldungen mit „Benachrichtigung senden“ gehen beim Erscheinen raus
  (auch zeitgesteuert), Schließzeiten automatisch am Nachmittag davor
- Redaktionsseite „Benachrichtigungen“ mit Vorschau, Empfängerzahlen und
  Verlauf; abgelaufene Abos werden entfernt, doppeltes Senden verhindert
- Automatische Nachrichten ohne Empfänger werden nicht als gesendet
  verbucht (sonst verpasste Schließzeit-Erinnerung)

Rechtliches (eigener Server):
- Angaben zur Einrichtung in den Einstellungen; Impressum (§ 5 DDG,
  § 18 MStV) und Datenschutzerklärung aus Vorlagen, die genau beschreiben,
  was die App verarbeitet – fehlende Angaben gelb markiert
- Seite „Barrierefreiheit“ mit Erklärung und Formular „Barriere melden“,
  Meldungen gekennzeichnet und filterbar im Postfach
- Vorlesen bevorzugt Stimmen auf dem Gerät (keine Online-Stimme, wenn
  vermeidbar)

Geprüft: Push Ende-zu-Ende gegen nachgebauten Push-Dienst (Entschlüsselung,
VAPID, 410-Abbau), axe-Audit aller Seiten ohne Befund.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-30 17:37:25 +00:00
data Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
drizzle Sicherheit der Redaktion: 2FA, Passwort-Reset, CSP, dauerhafte Sperren 2026-09-30 17:21:38 +00:00
scripts Redaktionskalender für das Redaktionsteam 2026-09-30 15:11:46 +00:00
src Push-Benachrichtigungen, Rechtstexte und Barrierefreiheitserklärung 2026-09-30 17:37:25 +00:00
.dockerignore Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
.env.example Push-Benachrichtigungen, Rechtstexte und Barrierefreiheitserklärung 2026-09-30 17:37:25 +00:00
.gitignore Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
.npmrc Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
docker-compose.yml Push-Benachrichtigungen, Rechtstexte und Barrierefreiheitserklärung 2026-09-30 17:37:25 +00:00
Dockerfile Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
drizzle.config.ts Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +00:00
package-lock.json Sicherheit der Redaktion: 2FA, Passwort-Reset, CSP, dauerhafte Sperren 2026-09-30 17:21:38 +00:00
package.json Sicherheit der Redaktion: 2FA, Passwort-Reset, CSP, dauerhafte Sperren 2026-09-30 17:21:38 +00:00
README.md Push-Benachrichtigungen, Rechtstexte und Barrierefreiheitserklärung 2026-09-30 17:37:25 +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 Werkstatt-App: öffentliche PWA und Redaktions-Backend 2026-09-29 20:55:13 +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 mit großem Titelbild, Akzentkreis mit 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)
  • Ansprechpartner-Verzeichnis, Kontaktformular, Volltextsuche
  • Barrierearm: klare Schrift (Montserrat, selbst gehostet), 3 Schriftgrößen, Hell/Dunkel, Leichte Sprache pro Seite/Meldung
  • 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
  • Bilder werden automatisch gedreht, verkleinert und als WebP gespeichert
  • 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)
  • Einstellungen: App-Name, Logo, Farbpaar (Haupt- und Akzentfarbe), Titelbild, Texte, Impressum, Datenschutz – das App-Symbol wird daraus automatisch erzeugt

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).

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.

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
BODY_SIZE_LIMIT Max. Upload-Größe (im Docker-Image auf 30M gesetzt)
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
VAPID_PUBLIC_KEY / VAPID_PRIVATE_KEY Optional – sonst werden die Push-Schlüssel automatisch erzeugt und gespeichert

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.
  • Öffentliche Seiten: src/routes/(app)/, Datenabfragen gebündelt in src/lib/server/content.ts.

Ideen für später

Push-Benachrichtigungen (Web Push), E-Mail-Weiterleitung des Kontaktformulars, Umfragen, Mehrsprachigkeit, Standort-Filter für Speisepläne.