Vorlesen: - „Seite vorlesen“ in der Kopfzeile auf jeder Seite, dazu im Artikel - satzweise mit Markierung des gelesenen Satzes (CSS Highlight API), mitscrollend; Steuerleiste mit Pause, Satz zurück/vor, langsam, Stopp - Satzgrenzen folgen der Darstellung; Bedienelemente werden übersprungen Barrierefreiheit (axe-core, WCAG 2.2 AA – jetzt ohne Befund): - Kontraste von Hilfstext und Status-Schrift angehoben, keine Transparenz mehr bei erledigten Einträgen - Fehlerseiten mit Titel und Hauptbereich (App, Redaktion, allgemein) - Überschriften-Hierarchie in der Meldungsliste - Text-Editor mit zugänglichem Namen, eindeutige Seitenleisten, beschriftete Symbol-Buttons, ausreichend große Tippflächen - Redaktion: Sprunglink zum Inhalt, Schriftgröße/Farbschema unter „Mein Konto“; Redaktionskalender in voller Breite Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
95 lines
5.1 KiB
Markdown
95 lines
5.1 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,
|
||
**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
|
||
- Merkliste (lokal auf dem Gerät), Teilen, offline lesbar, als App installierbar
|
||
- 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
|
||
- 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](https://github.com/dequelabs/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)
|
||
|
||
```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.
|