Wie bei der Vitus-App zeigt die Startseite oben ein Bild. Es wird in den Einstellungen gewählt (oder ausgeblendet); ohne eigenes Foto erscheint eine Platzhalter-Illustration (static/hero-placeholder.svg). Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| data | ||
| drizzle | ||
| scripts | ||
| src | ||
| static | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| .npmrc | ||
| docker-compose.yml | ||
| Dockerfile | ||
| drizzle.config.ts | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| svelte.config.js | ||
| tsconfig.json | ||
| vite.config.ts | ||
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 Begrüßung, Suche, frei konfigurierbaren Kacheln, Neuigkeiten und nächsten 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: gut lesbare Schrift (Atkinson Hyperlegible), 3 Schriftgrößen, Hell/Dunkel, Vorlesen-Funktion, Leichte Sprache pro Seite/Meldung
- Merkliste (lokal auf dem Gerät), Teilen, offline lesbar, als App installierbar
- Keine Werbung, kein Tracking, keine externen Schriften oder CDNs
Redaktion (/admin)
- Übersicht, Meldungen (Entwurf, geplante Veröffentlichung, anheften), Seitenbaum, Termine, Startseiten-Kacheln, Ansprechpartner, Mediathek, Postfach
- Text-Editor mit Formatierungen, Links und Bildern
- Bilder werden automatisch gedreht, verkleinert und als WebP gespeichert
- Rollen: Redakteur (Inhalte) und Administrator (zusätzlich Benutzer & Einstellungen)
- Einstellungen: App-Name, Logo, Markenfarbe, Texte, Impressum, Datenschutz – das App-Symbol wird daraus automatisch erzeugt
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) |
Erweitern
- Neues Feld / neuer Inhaltstyp:
src/lib/server/db/schema.tsändern →npm run db:generateerzeugt eine Migration indrizzle/, 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 insrc/lib/admin/. - Icons für Kacheln/Seiten:
src/lib/icons.ts, Farben:src/lib/palette.ts+.tone-*insrc/app.css. - Öffentliche Seiten:
src/routes/(app)/, Datenabfragen gebündelt insrc/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.