# 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, **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, Farbpaar (Haupt- und Akzentfarbe), Titelbild, 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) ```bash 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 ```bash 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:generate` erzeugt eine Migration in `drizzle/`, die beim nächsten Start automatisch eingespielt wird. - **Admin-Bereiche** folgen alle demselben Muster: `src/routes/admin/(panel)//` 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.