Macht 82d4c91 rückgängig – der Text am Akzentkreis und das
Einstellungsfeld „Text im Kreis“ sind wieder da.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
79 lines
3.9 KiB
Markdown
79 lines
3.9 KiB
Markdown
# 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)/<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.
|