Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
dca4af2a0b | ||
|
|
c168d3cca3 | ||
|
|
10be022180 | ||
|
|
1096993120 | ||
|
|
8b3921c50e | ||
|
|
63870ba2e6 |
@@ -4,6 +4,17 @@ Alle nennenswerten Änderungen an diesem Projekt werden hier dokumentiert.
|
|||||||
Format angelehnt an [Keep a Changelog](https://keepachangelog.com/de/1.1.0/),
|
Format angelehnt an [Keep a Changelog](https://keepachangelog.com/de/1.1.0/),
|
||||||
Versionierung nach [Semantic Versioning](https://semver.org/lang/de/).
|
Versionierung nach [Semantic Versioning](https://semver.org/lang/de/).
|
||||||
|
|
||||||
|
## [1.12.1] – 2026-07-20
|
||||||
|
|
||||||
|
### Geändert
|
||||||
|
- Bedienung geschlossener Tage im Wochenplan überarbeitet: Statt eines
|
||||||
|
Text-Links am Datum markiert jetzt ein Schloss-Symbol (🔓 zum
|
||||||
|
Schließen, 🔒 zeigt „geschlossen" an und öffnet per Klick wieder) den
|
||||||
|
Tag. Ein geschlossener Tag zeigt sowohl im Wochenplan als auch auf
|
||||||
|
der öffentlichen Speisekarte (Desktop-Tabelle) einen einzigen, über
|
||||||
|
alle Essenszeiten-Zeilen durchgehenden „Geschlossen"-Hinweis statt
|
||||||
|
einer Wiederholung in jeder einzelnen Zeile.
|
||||||
|
|
||||||
## [1.12.0] – 2026-07-20
|
## [1.12.0] – 2026-07-20
|
||||||
|
|
||||||
### Hinzugefügt
|
### Hinzugefügt
|
||||||
|
|||||||
+305
@@ -0,0 +1,305 @@
|
|||||||
|
# Was kann die Speisekarte?
|
||||||
|
|
||||||
|
Vorstellung aller Funktionen der digitalen Kantinen-Speisekarte
|
||||||
|
(Stand Version 1.12.1). Technische Details zur Installation stehen in
|
||||||
|
[DEPLOYMENT.md](DEPLOYMENT.md), die Änderungen je Version in
|
||||||
|
[CHANGELOG.md](CHANGELOG.md).
|
||||||
|
|
||||||
|
## In einem Satz
|
||||||
|
|
||||||
|
Eine selbst gehostete Web-Anwendung, mit der das Kantinen-Team den
|
||||||
|
Wochenplan pflegt und alle Mitarbeiter ihn ohne Login am PC oder Handy
|
||||||
|
lesen können – dreisprachig, mit Allergen-Kennzeichnung, RSS-Abo,
|
||||||
|
Rezeptvorschlägen und eigenem Branding.
|
||||||
|
|
||||||
|
Drei Bereiche mit getrennten Rechten:
|
||||||
|
|
||||||
|
| Bereich | Wer | Zweck |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| Öffentliche Speisekarte (`/`) | alle Mitarbeiter, ohne Login | Wochenplan lesen |
|
||||||
|
| Kantinen-Bereich (`/intern`) | Kantinen-Team (`staff`) und Admins | Gerichte und Wochenplan pflegen |
|
||||||
|
| Admin-Bereich (`/admin`) | nur Admins | Benutzer, Design, Sprachen |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Für alle Mitarbeiter: die öffentliche Speisekarte
|
||||||
|
|
||||||
|
Erreichbar ohne Anmeldung – Link oder QR-Code genügt.
|
||||||
|
|
||||||
|
**Wochenplan Montag bis Freitag**
|
||||||
|
Tabelle mit einer Spalte je Wochentag und einer Zeile je Essenszeit
|
||||||
|
(z. B. Brotzeit, Mittagessen, Mittagessen vegetarisch, Suppe). Pro
|
||||||
|
Zelle können mehrere Gerichte stehen. Jedes Gericht wird mit Preis
|
||||||
|
angezeigt.
|
||||||
|
|
||||||
|
**Navigation**
|
||||||
|
Buttons für vorherige Woche, nächste Woche und „Heute". Beliebige
|
||||||
|
Wochen lassen sich so vor- und zurückblättern – auch als direkter Link
|
||||||
|
(`/?woche=YYYY-MM-DD`), praktisch für Aushänge oder Bookmarks.
|
||||||
|
|
||||||
|
**Handy-Ansicht**
|
||||||
|
Auf schmalen Bildschirmen erscheint standardmäßig eine Tagesansicht mit
|
||||||
|
Tab-Leiste (Mo–Fr) statt der Tabelle; auf Wunsch kann pro Besucher auf
|
||||||
|
die Wochenansicht umgeschaltet werden. Die Desktop-Tabelle bleibt davon
|
||||||
|
unberührt.
|
||||||
|
|
||||||
|
**Allergene und Zusatzstoffe**
|
||||||
|
Je Gericht erscheinen die Kürzel (z. B. `A`, `G`) direkt neben dem
|
||||||
|
Namen, die vollständige Legende steht unterhalb der Karte. Alternativ
|
||||||
|
lässt sich die Kennzeichnung auf einen einzelnen Hinweistext umstellen
|
||||||
|
(siehe Abschnitt 2).
|
||||||
|
|
||||||
|
**Geschlossene Tage**
|
||||||
|
Feiertage, Betriebsausflüge oder Urlaub werden als „Geschlossen"
|
||||||
|
angezeigt – ein einziges, über alle Essenszeiten-Zeilen durchgehendes
|
||||||
|
Banner mit optionalem Grund („Betriebsferien"), statt leerer Zellen.
|
||||||
|
|
||||||
|
**Sprachumschalter**
|
||||||
|
Umschalten der kompletten Oberfläche zwischen den freigeschalteten
|
||||||
|
Sprachen (ausgeliefert mit Deutsch, Englisch, Polnisch). Die Auswahl
|
||||||
|
wird per Cookie gemerkt, die Seite muss dafür nicht neu geladen werden.
|
||||||
|
Ist nur eine Sprache aktiv, verschwindet der Umschalter automatisch.
|
||||||
|
|
||||||
|
**RSS-Feed zum Abonnieren**
|
||||||
|
`/feed.xml` liefert einen Eintrag pro Tag (aktuelle und nächste Woche)
|
||||||
|
mit allen Gerichten je Essenszeit inkl. Preis; geschlossene Tage
|
||||||
|
erscheinen mit Schließungsgrund. Sichtbares RSS-Icon im Kopfbereich
|
||||||
|
plus Autodiscovery im Seiten-`<head>`, damit Outlook, Thunderbird & Co.
|
||||||
|
den Feed automatisch finden. Der Inhalt wird zusätzlich als
|
||||||
|
`content:encoded` ausgeliefert, damit Reader ihn nicht nach der ersten
|
||||||
|
Essenszeit abschneiden.
|
||||||
|
|
||||||
|
**Rezept vorschlagen**
|
||||||
|
Jeder Besucher kann ohne Login ein fehlendes Gericht vorschlagen (Name
|
||||||
|
+ optionale Beschreibung). Eingebaut: Dublettenprüfung gegen bestehende
|
||||||
|
Gerichte und ein unsichtbares Honeypot-Feld als Spamschutz.
|
||||||
|
|
||||||
|
**Eigenes Erscheinungsbild**
|
||||||
|
Firmenlogo zentriert über der Karte, eigenes Favicon im Browser-Tab,
|
||||||
|
Farben nach Corporate Design – alles vom Admin einstellbar, ohne
|
||||||
|
Codeänderung.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Für das Kantinen-Team (`/intern`)
|
||||||
|
|
||||||
|
Nach dem Login sichtbar, gemeinsame Navigation für alle Unterseiten,
|
||||||
|
auf dem Handy als Hamburger-Menü.
|
||||||
|
|
||||||
|
### Wochenplan
|
||||||
|
|
||||||
|
- Gerichte per **Suchfeld** einer Zelle (Tag + Essenszeit) zuweisen –
|
||||||
|
keine langen Dropdown-Listen zum Durchscrollen.
|
||||||
|
- Mehrere Gerichte pro Zelle, einzeln wieder entfernbar.
|
||||||
|
- Wochen-Navigation inkl. „Heute"-Button wie in der öffentlichen Ansicht.
|
||||||
|
- **Tag schließen**: Schloss-Symbol am Datum (🔓 schließt, 🔒 öffnet
|
||||||
|
wieder) mit optionalem, mehrsprachigem Grund. Für geschlossene Tage
|
||||||
|
wird „Mahlzeit hinzufügen" ausgeblendet; bereits eingetragene
|
||||||
|
Gerichte bleiben entfernbar.
|
||||||
|
- Auf dem Handy Tag-für-Tag-Ansicht mit Tab-Leiste; beide Ansichten
|
||||||
|
teilen denselben Bearbeitungsstand.
|
||||||
|
|
||||||
|
### Gerichte
|
||||||
|
|
||||||
|
- Anlegen, bearbeiten, löschen – mit Name, Preis, Allergenen und
|
||||||
|
Zusatzstoffen (Chip-Auswahl).
|
||||||
|
- **Live-Suche** in der Gerichteliste.
|
||||||
|
- **Mehrfachauswahl** zum Löschen vieler Gerichte in einem Schritt.
|
||||||
|
- Ein Namensfeld je aktiver Sprache, mit Button **„Automatisch
|
||||||
|
übersetzen"** (DeepL) – das Ergebnis bleibt danach frei korrigierbar.
|
||||||
|
- **CSV-Export/-Import**: aktuelle Liste als CSV herunterladen,
|
||||||
|
bearbeiten, wieder hochladen. Spalten
|
||||||
|
`name,name_en,…,price,allergens,additives` (Kürzel semikolongetrennt,
|
||||||
|
z. B. `A;G`), Spaltenreihenfolge und Groß-/Kleinschreibung der
|
||||||
|
Kopfzeile egal. Bestehende Gerichte werden über den Namen erkannt und
|
||||||
|
aktualisiert, neue angelegt. Fehlerhafte Zeilen (Pflichtfeld fehlt,
|
||||||
|
ungültiger Preis, mehrdeutiger Name) werden übersprungen und mit
|
||||||
|
Grund aufgelistet, statt den ganzen Import abzubrechen.
|
||||||
|
|
||||||
|
### Essenszeiten
|
||||||
|
|
||||||
|
Vollständig verwaltbar statt fest im Code: anlegen, umbenennen (je
|
||||||
|
Sprache), Uhrzeit ändern, per Pfeil-Buttons neu anordnen, löschen.
|
||||||
|
Beim Löschen werden zugewiesene Gerichte automatisch aus allen
|
||||||
|
Wochenplänen entfernt.
|
||||||
|
|
||||||
|
### Allergene & Zusatzstoffe
|
||||||
|
|
||||||
|
- Globale Listen pflegen (Kürzel + Name je Sprache, Sortierung),
|
||||||
|
ebenfalls mit DeepL-Übersetzung und CSV-Export/-Import.
|
||||||
|
- **Zwei Betriebsmodi, umschaltbar:**
|
||||||
|
1. *Detailliert* – Auswahl je Gericht, Kürzel am Gericht, Legende
|
||||||
|
unter der Karte.
|
||||||
|
2. *Hinweistext* – ein einziger, mehrsprachig editierbarer Satz
|
||||||
|
(z. B. „Bei Fragen zu Allergenen und Zusatzstoffen wenden Sie sich
|
||||||
|
bitte an das Kantinen-Team."). Kürzel, Legende und die
|
||||||
|
Allergen-Auswahl in der Gerichteverwaltung verschwinden;
|
||||||
|
zugeordnete Daten bleiben in der Datenbank erhalten und sind beim
|
||||||
|
Zurückschalten wieder da.
|
||||||
|
|
||||||
|
### Rezeptvorschläge
|
||||||
|
|
||||||
|
Eingereichte Vorschläge sichten, direkt als Gericht **übernehmen** oder
|
||||||
|
**ablehnen**. Die Anzahl offener Vorschläge steht als rote Zahl im
|
||||||
|
Navigationspunkt „Vorschläge".
|
||||||
|
|
||||||
|
### Eigenes Konto
|
||||||
|
|
||||||
|
Name, E-Mail und Passwort ändern, Passkeys registrieren und entfernen,
|
||||||
|
Passwort-Anmeldung für das eigene Konto abschalten.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. Für Admins (`/admin`)
|
||||||
|
|
||||||
|
### Benutzerverwaltung
|
||||||
|
|
||||||
|
Kantinenmitarbeiter anlegen, bearbeiten und löschen; Rolle vergeben
|
||||||
|
(Kantinenmitarbeiter oder Admin); Passwort zurücksetzen – jeweils mit
|
||||||
|
Wiederholungsfeld gegen Tippfehler.
|
||||||
|
|
||||||
|
### Design
|
||||||
|
|
||||||
|
- Acht Farben per Farbwähler einstellbar: Primär, Primär dunkel,
|
||||||
|
Akzent, Kopfzeilentext, Zeilenhintergrund, Zeilenhintergrund
|
||||||
|
alternierend, Hinzufügen-Button, Löschen-Button. Auf Werkszustand
|
||||||
|
zurücksetzbar.
|
||||||
|
- Logo und Favicon hochladen oder entfernen. Aus Sicherheitsgründen
|
||||||
|
nur Rasterformate (png/jpg/webp/gif/ico) – SVG ist bewusst nicht
|
||||||
|
erlaubt, da eingebettetes Script auf der eigenen Domain ausgeführt
|
||||||
|
würde.
|
||||||
|
|
||||||
|
### Sprachen
|
||||||
|
|
||||||
|
Sprachen sind zur Laufzeit verwaltbar, ohne neues Deployment:
|
||||||
|
|
||||||
|
- Vorlage der deutschen Oberflächentexte herunterladen, übersetzt
|
||||||
|
wieder hochladen – die neue Sprache ist sofort aktiv.
|
||||||
|
- Je Sprache wird **Vollständigkeit in %** angezeigt sowie „N neue
|
||||||
|
Begriffe seit letztem Import", falls eine App-Version zusätzliche
|
||||||
|
Texte mitgebracht hat. Fehlende Begriffe fallen automatisch auf
|
||||||
|
Deutsch zurück, bleiben also nie leer.
|
||||||
|
- Neue Sprachen selbst anlegen (Code + Anzeigename). Sobald eine
|
||||||
|
Sprache aktiv ist, erscheint in der Gerichte-, Essenszeiten- und
|
||||||
|
Kennzeichnungsverwaltung automatisch ein Eingabefeld dafür – und im
|
||||||
|
CSV-Export eine zusätzliche Spalte (`name_fr`, …).
|
||||||
|
- Sprachen einzeln deaktivieren, bis hinunter auf eine einzige;
|
||||||
|
Deutsch bleibt als garantiert vollständige Basissprache unlöschbar.
|
||||||
|
- Der Import prüft die Datei gegen die aktuelle Vorlage: Platzhalter
|
||||||
|
wie `{message}` müssen erhalten bleiben, unbekannte Schlüssel werden
|
||||||
|
ignoriert statt einen Fehler zu werfen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. Anmeldung und Sicherheit
|
||||||
|
|
||||||
|
**Drei Anmeldewege, kombinierbar**
|
||||||
|
|
||||||
|
1. **E-Mail + Passwort** – Hashing mit `scrypt` aus der
|
||||||
|
Node-Standardbibliothek.
|
||||||
|
2. **Passkey** (WebAuthn, z. B. Windows Hello, Face ID, Sicherheits-
|
||||||
|
schlüssel) – im eigenen Konto nach dem ersten Login registrierbar.
|
||||||
|
Die Passwort-Anmeldung lässt sich pro Konto abschalten, sobald
|
||||||
|
mindestens ein Passkey vorhanden ist; das wird serverseitig
|
||||||
|
erzwungen, nicht nur im Browser geprüft.
|
||||||
|
3. **SSO per OpenID Connect** (z. B. gegen ein selbst gehostetes
|
||||||
|
Authentik) – Authorization-Code-Flow mit PKCE, Signaturprüfung des
|
||||||
|
ID-Tokens gegen das JWKS des Providers, State/Nonce serverseitig
|
||||||
|
kurzlebig und nur einmal verwendbar. Aktiviert sich über drei
|
||||||
|
Umgebungsvariablen; ohne sie bleibt der SSO-Button unsichtbar.
|
||||||
|
Wichtig: SSO legt **nie** neue Konten an und übernimmt **keine**
|
||||||
|
Rollen aus Claims – nur bereits unter „Benutzer" angelegte
|
||||||
|
E-Mail-Adressen kommen herein, die Rolle bleibt allein in der
|
||||||
|
Benutzerverwaltung steuerbar.
|
||||||
|
|
||||||
|
**Sitzungen**
|
||||||
|
Opake Tokens, nur als Hash in der Datenbank, Cookie mit
|
||||||
|
`httpOnly`/`sameSite=lax`. Laufzeit 30 Tage mit gleitender
|
||||||
|
Verlängerung: fällt die Restlaufzeit unter 7 Tage, wird sie beim
|
||||||
|
nächsten Aufruf erneuert – statt bei jedem Request zu schreiben.
|
||||||
|
|
||||||
|
**Zugriffsschutz**
|
||||||
|
`/intern`, `/admin` und `/konto` sind serverseitig geschützt; jede
|
||||||
|
API-Route prüft zusätzlich die Rolle. Öffentlich lesbar sind nur
|
||||||
|
Speisekarte, Essenszeiten, Kennzeichnungen und Logo/Favicon.
|
||||||
|
|
||||||
|
**Weitere Härtung**
|
||||||
|
CSRF-Origin-Check, HTTP-Security-Header für alle Routen
|
||||||
|
(`X-Frame-Options: DENY`, `frame-ancestors 'none'`, `nosniff`,
|
||||||
|
`Referrer-Policy`, restriktive `Permissions-Policy`), Datenbank ohne
|
||||||
|
Host-Port (nur im internen Docker-Netz erreichbar), Upload-Whitelist
|
||||||
|
für Bildformate.
|
||||||
|
|
||||||
|
**Erster Start**
|
||||||
|
Ist die Datenbank leer, wird automatisch genau ein Admin mit
|
||||||
|
Zufallspasswort angelegt und die Zugangsdaten nach `ZUGANGSDATEN.md`
|
||||||
|
geschrieben (nicht im Repository). Klappt das Schreiben nicht, landen
|
||||||
|
sie im Container-Log statt verloren zu gehen.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Mehrsprachigkeit im Detail
|
||||||
|
|
||||||
|
Zwei Ebenen, beide zur Laufzeit erweiterbar:
|
||||||
|
|
||||||
|
| Ebene | Was | Verwaltung |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| Oberfläche | alle Buttons, Beschriftungen, Meldungen | Admin → Sprachen (Vorlage exportieren/importieren) |
|
||||||
|
| Inhalte | Gerichtnamen, Essenszeiten, Allergene, Zusatzstoffe, Schließungsgründe | ein Feld je aktiver Sprache in der jeweiligen Verwaltung |
|
||||||
|
|
||||||
|
Beides ist **nicht** auf Deutsch/Englisch/Polnisch begrenzt – eine neu
|
||||||
|
angelegte Sprache erscheint automatisch überall. Übersetzungen können
|
||||||
|
per DeepL vorbefüllt werden (in alle aktiven, von DeepL unterstützten
|
||||||
|
Sprachen gleichzeitig) und bleiben danach manuell korrigierbar. Fehlt
|
||||||
|
eine Übersetzung, greift der Deutsch-Fallback; ist Deutsch selbst
|
||||||
|
deaktiviert, die erste aktive Sprache.
|
||||||
|
|
||||||
|
DeepL ist optional: ohne `DEEPL_API_KEY` verschwindet nur der Button
|
||||||
|
„Automatisch übersetzen", alle Felder bleiben von Hand ausfüllbar.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Betrieb
|
||||||
|
|
||||||
|
- **Vollständig selbst gehostet.** Einzige optionale externe
|
||||||
|
Abhängigkeit ist DeepL. Keine Cloud-Datenbank, kein
|
||||||
|
Auth-Dienstleister, kein Storage-Anbieter.
|
||||||
|
- **Stack:** Next.js 16 (App Router, TypeScript, Tailwind CSS),
|
||||||
|
PostgreSQL über `pg` mit eigenen SQL-Migrationen.
|
||||||
|
- **Docker Compose** für Produktion und Entwicklung (Dev-Profil mit
|
||||||
|
Hot-Reload, ohne lokal installiertes Node.js/PostgreSQL).
|
||||||
|
- **Migrationen laufen bei jedem Start automatisch** und idempotent –
|
||||||
|
ein Update braucht keinen manuellen Datenbankschritt.
|
||||||
|
- **`update.sh`** für Linux-Deployments: Stack stoppen, lokale
|
||||||
|
Änderungen an `docker-compose.yml` sichern, `git pull`, Änderungen
|
||||||
|
zurückspielen, neu bauen und starten. Bricht bei Konflikten
|
||||||
|
kontrolliert ab, statt mit halbem Stand weiterzulaufen.
|
||||||
|
- **`npm run db:seed-demo`** spielt einen Beispieldatensatz für Demos
|
||||||
|
ein (Essenszeiten, Kennzeichnungen, Testgerichte, zwei Wochen).
|
||||||
|
Frische Deployments starten bewusst leer.
|
||||||
|
- **Versionsnummer im Fußbereich** jeder Seite, Git-Tags markieren die
|
||||||
|
Versionsstände.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 7. Wann kam was
|
||||||
|
|
||||||
|
| Version | Kern |
|
||||||
|
| --- | --- |
|
||||||
|
| 1.0.0 | Öffentliche Speisekarte, Login (Passwort + Passkey), Kantinen- und Admin-Bereich, Docker-Setup |
|
||||||
|
| 1.1.0 | Versionsnummer im Fußbereich |
|
||||||
|
| 1.2.0 | „Heute"-Button, mobile Tages-/Wochenansicht, Allergen-Chips, Passwort-Wiederholung, Favicon, `SITE_TITLE` |
|
||||||
|
| 1.3.0 | Mehrsprachigkeit DE/EN/PL, DeepL, Rezeptvorschläge inkl. Sichtung |
|
||||||
|
| 1.4.0 | Essenszeiten frei verwaltbar |
|
||||||
|
| 1.5.0 | Supabase komplett entfernt – eigene Datenbank, Auth, Passkeys, Datei-Ablage |
|
||||||
|
| 1.6.x | RSS-Feed, Vorschläge-Badge, DEPLOYMENT.md, DB-Port geschlossen, Bugfixes |
|
||||||
|
| 1.7.0 | CSV-Import/-Export für Gerichte, Allergene, Zusatzstoffe |
|
||||||
|
| 1.8.x | Umschaltbarer Hinweismodus für Kennzeichnungen, `update.sh` |
|
||||||
|
| 1.9.0 | SSO per OpenID Connect |
|
||||||
|
| 1.9.5 | Interner Bereich für Mobilgeräte nutzbar |
|
||||||
|
| 1.10.0 | Sprachen zur Laufzeit verwaltbar (Oberfläche) |
|
||||||
|
| 1.11.x | Sprachen zur Laufzeit verwaltbar (Inhalte), Sprach-Fallback-Fix |
|
||||||
|
| 1.12.x | Tage als geschlossen markierbar, Schloss-Symbol und durchgehendes Banner |
|
||||||
|
|
||||||
|
Ausführlich in [CHANGELOG.md](CHANGELOG.md), der Zeitaufwand je Version
|
||||||
|
in [ZEITAUFWAND.md](ZEITAUFWAND.md).
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
# Zeitaufwand
|
||||||
|
|
||||||
|
Übersicht, wie lange die Umsetzung der einzelnen Versionen mit Claude
|
||||||
|
gedauert hat, zum Vergleich mit der Schätzung für einen erfahrenen
|
||||||
|
Entwickler ohne KI-Unterstützung. Wird bei jeder neuen Version
|
||||||
|
ergänzt.
|
||||||
|
|
||||||
|
## Methodik
|
||||||
|
|
||||||
|
- **„Zeit bei Claude"** basiert auf den Git-Commit-Zeitstempeln
|
||||||
|
zwischen zwei Versions-Tags. Das ist kein reiner Rechenzeit-Wert,
|
||||||
|
sondern enthält auch die Zeit, die der Nutzer zum Lesen/Antworten
|
||||||
|
gebraucht hat – aber es ist der einzige objektiv messbare Anhaltspunkt.
|
||||||
|
- Große Lücken zwischen zwei Tags (mehrere Stunden bis über einen Tag)
|
||||||
|
markieren eindeutig eine neue Sitzung, kein durchgehendes Arbeiten –
|
||||||
|
diese sind als „neue Sitzung" markiert statt als Zeitangabe.
|
||||||
|
- **„Erfahrener Entwickler"** ist eine grobe Schätzung für jemanden,
|
||||||
|
der mit dem Stack (Next.js, PostgreSQL, TypeScript) vertraut, aber
|
||||||
|
neu in diesem Projekt ist, inkl. Testen/Verifikation, exkl. Code-Review
|
||||||
|
durch Dritte.
|
||||||
|
|
||||||
|
## Übersicht
|
||||||
|
|
||||||
|
| Version | Datum | Kern der Version | Zeit bei Claude | Erfahrener Entwickler |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| v1.0.0/v1.1.0 | 17.07. | Grundgerüst: öffentliche Speisekarte, Login (Passwort+Passkey), Kantinen-/Admin-Bereich, Supabase-Schema+RLS, Docker-Setup, lokale PG-Kopie | nicht messbar (erster Commit) | 3–5 Tage (24–40 h) |
|
||||||
|
| v1.2.0 | 18.07. | Heute-Button, mobile Tages-/Wochenansicht, Allergen-Chips, Passwort-Wiederholung, Passkey-Pflicht, SITE_TITLE/Favicon, UX-Politur | 56 min | 1–1,5 Tage (8–12 h) |
|
||||||
|
| v1.3.0 | 18.07. | Volle Mehrsprachigkeit DE/EN/PL, DeepL-Anbindung, Rezeptvorschläge (öffentlich + Sichtung), 2 Bugfixes | 1 h 23 min | 1,5–2 Tage (12–16 h) |
|
||||||
|
| v1.4.0 | 18.07. | Essenszeiten variabel (CRUD + Sortierung), 2 Bugfixes | *(neue Sitzung)* | 0,5–1 Tag (4–8 h) |
|
||||||
|
| v1.5.0 | 18.07. | **Supabase komplett entfernt**: eigene DB/Auth/Passkeys/Storage, 2 Sicherheitsfixes (Passkey-Pflicht serverseitig, SVG-XSS) | 3 h 26 min | 2–3 Tage (16–24 h) |
|
||||||
|
| v1.6.0 | 18.07. | RSS-Feed, Vorschläge-Badge, DEPLOYMENT.md, Supabase-Doku-Reste entfernt | 33 min | 0,5–1 Tag (4–8 h) |
|
||||||
|
| v1.6.1 | 18.07. | DB-Port abgesichert, Troubleshooting-Doku | 1 h 58 min | 1–2 h |
|
||||||
|
| v1.6.2 | 18.07. | Bootstrap-Admin-Fehlerbehandlung + Doku-Fix | 22 min | 1–2 h |
|
||||||
|
| v1.6.3 | 18.07. | Docker `BRANDING_DIR`-Bugfix | 20 min | 0,5–1 h |
|
||||||
|
| v1.7.0 | 19.07. | CSV-Import/-Export (3 Ressourcen), RSS-Fix | *(neue Sitzung)* | 0,5–1 Tag (4–8 h) |
|
||||||
|
| v1.8.0 | 19.07. | Umschaltbarer Hinweismodus für Allergene/Zusatzstoffe | 45 min | 0,5–1 Tag (4–6 h) |
|
||||||
|
| v1.8.1 | 20.07. | `update.sh` Deployment-Skript | 10 min | 1–2 h |
|
||||||
|
| v1.9.0 | 20.07. | SSO-Login per OpenID Connect (PKCE, JWKS-Prüfung) | 26 min | 1–1,5 Tage (8–12 h) |
|
||||||
|
| v1.9.5 | 20.07. | Interner Bereich mobil nutzbar (Hamburger-Nav, Tab-Wochenansicht, 5 Komponenten) | 21 min | 1 Tag (6–10 h) |
|
||||||
|
| v1.10.0 | 20.07. | Dynamisches Sprachpaket-System (Teil 1 Mehrsprachig-Umbau) | *(neue Sitzung)* | 1–1,5 Tage (8–12 h) |
|
||||||
|
| v1.11.0 | 20.07. | Speiseplan-Inhalte variabel (Teil 2, inkl. Produktionsdaten-Migration) | 35 min | 1–1,5 Tage (8–12 h) |
|
||||||
|
| v1.11.1 | 20.07. | Sprach-Fallback-Bugfix (deaktiviertes Deutsch) | 12 min | 0,5–1,5 h |
|
||||||
|
| v1.12.0 | 20.07. | Tage als geschlossen markierbar (Feiertage o. Ä.), mehrsprachiger Grund, RSS-Integration | 1 h 12 min | 0,5–1 Tag (4–8 h) |
|
||||||
|
| v1.12.1 | 20.07. | Schloss-Symbol statt Textlink, durchgehendes Geschlossen-Banner über alle Essenszeiten | 14 min | 2–4 h |
|
||||||
|
| **Gesamt** | | | **~12,3 h messbare aktive Zeit** (+ 1 nicht messbarer Grundgerüst-Block) | **~114–187 h ≈ 15–24 Arbeitstage** (real eher 1–2 Monate Kalenderzeit) |
|
||||||
|
|
||||||
|
## Warum der Unterschied?
|
||||||
|
|
||||||
|
Der Zeitvorteil kommt vor allem daher, dass zwischen Planung,
|
||||||
|
Umsetzung und Test keine Wartezeit liegt (Code-Review, Freigaben,
|
||||||
|
andere Aufgaben dazwischen) – nicht daher, dass grundsätzlich
|
||||||
|
"schneller gedacht" wird. Ein Mensch bräuchte für dieselbe Sorgfalt
|
||||||
|
vermutlich nicht weniger Zeit pro Aufgabe, aber deutlich mehr
|
||||||
|
Kalenderzeit durch Kontextwechsel.
|
||||||
@@ -102,6 +102,10 @@ body {
|
|||||||
font-size: 0.85rem;
|
font-size: 0.85rem;
|
||||||
}
|
}
|
||||||
.menu-table tr:nth-child(even) td.cell { background: var(--c-row-bg-alt); }
|
.menu-table tr:nth-child(even) td.cell { background: var(--c-row-bg-alt); }
|
||||||
|
.menu-table td.cell.closed-cell {
|
||||||
|
vertical-align: middle;
|
||||||
|
background: #fee2e2;
|
||||||
|
}
|
||||||
.menu-table td.cell .dish { margin-bottom: 0.35rem; }
|
.menu-table td.cell .dish { margin-bottom: 0.35rem; }
|
||||||
.menu-table td.cell .dish sup {
|
.menu-table td.cell .dish sup {
|
||||||
font-size: 0.6rem;
|
font-size: 0.6rem;
|
||||||
|
|||||||
+48
-44
@@ -160,58 +160,62 @@ export default async function Home({
|
|||||||
<thead>
|
<thead>
|
||||||
<tr>
|
<tr>
|
||||||
<th className="section-head w-56" aria-hidden />
|
<th className="section-head w-56" aria-hidden />
|
||||||
{days.map((d) => {
|
{days.map((d) => (
|
||||||
const closed = closedDayFor(d.iso);
|
<th key={d.iso} className="day-head">
|
||||||
return (
|
<span className="font-bold">{d.weekday}</span>
|
||||||
<th key={d.iso} className="day-head">
|
<br />
|
||||||
<span className="font-bold">{d.weekday}</span>
|
{formatDateLong(d.iso, dict.dateLocale)}
|
||||||
<br />
|
</th>
|
||||||
{formatDateLong(d.iso, dict.dateLocale)}
|
))}
|
||||||
{closed && (
|
|
||||||
<div className="mt-1 text-xs font-normal">
|
|
||||||
<span className="rounded-full bg-red-100 text-red-700 px-2 py-0.5 font-semibold">
|
|
||||||
{dict.publicMenu.closedLabel}
|
|
||||||
</span>
|
|
||||||
{localized(closed, locale) && (
|
|
||||||
<div className="mt-0.5 opacity-90">
|
|
||||||
{localized(closed, locale)}
|
|
||||||
</div>
|
|
||||||
)}
|
|
||||||
</div>
|
|
||||||
)}
|
|
||||||
</th>
|
|
||||||
);
|
|
||||||
})}
|
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
{sections.map((s) => (
|
{sections.map((s, sIdx) => (
|
||||||
<tr key={s.key}>
|
<tr key={s.key}>
|
||||||
<th className="section-head">
|
<th className="section-head">
|
||||||
<div>{localized(s, locale)}</div>
|
<div>{localized(s, locale)}</div>
|
||||||
<div className="time">{s.time_range}</div>
|
<div className="time">{s.time_range}</div>
|
||||||
</th>
|
</th>
|
||||||
{days.map((d) => (
|
{days.map((d) => {
|
||||||
<td key={d.iso} className="cell">
|
const closed = closedDayFor(d.iso);
|
||||||
{closedDayFor(d.iso)
|
if (closed) {
|
||||||
? null
|
if (sIdx > 0) return null;
|
||||||
: entriesFor(entries, d.iso, s.key).map((e) => {
|
return (
|
||||||
const codes = dishCodes(e.dish);
|
<td key={d.iso} className="cell closed-cell" rowSpan={sections.length}>
|
||||||
return (
|
<div className="flex flex-col items-center justify-center gap-1 py-4 text-red-700">
|
||||||
<div key={e.id} className="dish">
|
<span className="text-2xl" aria-hidden>
|
||||||
<span className="font-bold">
|
🔒
|
||||||
{localized(e.dish, locale)}
|
</span>
|
||||||
</span>
|
<span className="font-semibold">{dict.publicMenu.closedLabel}</span>
|
||||||
{labelingDetailed && codes && (
|
{localized(closed, locale) && (
|
||||||
<sup className="dish-codes">{codes}</sup>
|
<span className="text-sm px-2 text-center">
|
||||||
)}
|
{localized(closed, locale)}
|
||||||
{" – "}
|
</span>
|
||||||
{formatPrice(e.dish.price)}
|
)}
|
||||||
</div>
|
</div>
|
||||||
);
|
</td>
|
||||||
})}
|
);
|
||||||
</td>
|
}
|
||||||
))}
|
return (
|
||||||
|
<td key={d.iso} className="cell">
|
||||||
|
{entriesFor(entries, d.iso, s.key).map((e) => {
|
||||||
|
const codes = dishCodes(e.dish);
|
||||||
|
return (
|
||||||
|
<div key={e.id} className="dish">
|
||||||
|
<span className="font-bold">
|
||||||
|
{localized(e.dish, locale)}
|
||||||
|
</span>
|
||||||
|
{labelingDetailed && codes && (
|
||||||
|
<sup className="dish-codes">{codes}</sup>
|
||||||
|
)}
|
||||||
|
{" – "}
|
||||||
|
{formatPrice(e.dish.price)}
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
})}
|
||||||
|
</td>
|
||||||
|
);
|
||||||
|
})}
|
||||||
</tr>
|
</tr>
|
||||||
))}
|
))}
|
||||||
</tbody>
|
</tbody>
|
||||||
|
|||||||
@@ -69,7 +69,8 @@ export default function PublicMobileMenu({
|
|||||||
{day.weekday} · {formatDateLong(day.iso, dict.dateLocale)}
|
{day.weekday} · {formatDateLong(day.iso, dict.dateLocale)}
|
||||||
</h3>
|
</h3>
|
||||||
{closed ? (
|
{closed ? (
|
||||||
<div className="rounded-md border border-red-200 bg-red-50 px-3 py-2 text-sm text-red-700">
|
<div className="rounded-md border border-red-200 bg-red-50 px-3 py-3 text-sm text-red-700 text-center">
|
||||||
|
<span aria-hidden>🔒</span>{" "}
|
||||||
<span className="font-semibold">{dict.publicMenu.closedLabel}</span>
|
<span className="font-semibold">{dict.publicMenu.closedLabel}</span>
|
||||||
{localized(closed, locale) && <span> – {localized(closed, locale)}</span>}
|
{localized(closed, locale) && <span> – {localized(closed, locale)}</span>}
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
+83
-47
@@ -208,38 +208,49 @@ export default function WeekEditor({
|
|||||||
? dishes.filter((d) => localized(d, locale).toLowerCase().includes(query))
|
? dishes.filter((d) => localized(d, locale).toLowerCase().includes(query))
|
||||||
: dishes;
|
: dishes;
|
||||||
|
|
||||||
// Kleine Anzeige/Umschaltung unter dem Tagesdatum: "Geschlossen" +
|
// Kleines Schloss-Symbol neben dem Tagesdatum: 🔓 zum Schließen
|
||||||
// Wieder-öffnen-Button, sonst ein dezenter "Tag schließen"-Link.
|
// anklicken, 🔒 zeigt einen geschlossenen Tag und öffnet ihn per Klick
|
||||||
function renderClosureBadge(iso: string) {
|
// wieder – der Zustand des Symbols selbst ist die Beschriftung.
|
||||||
const closed = closedDayFor(iso);
|
function renderClosureToggle(iso: string) {
|
||||||
if (closed) {
|
const closed = Boolean(closedDayFor(iso));
|
||||||
return (
|
|
||||||
<div className="mt-1 flex flex-wrap items-center justify-center gap-1 text-xs">
|
|
||||||
<span className="rounded-full bg-red-100 text-red-700 px-2 py-0.5 font-semibold">
|
|
||||||
{dict.weekEditor.closedLabel}
|
|
||||||
</span>
|
|
||||||
<button
|
|
||||||
type="button"
|
|
||||||
className="text-gray-400 hover:text-[var(--c-primary)] underline"
|
|
||||||
onClick={() => reopenDay(iso)}
|
|
||||||
disabled={closeBusy}
|
|
||||||
>
|
|
||||||
{dict.weekEditor.reopenDay}
|
|
||||||
</button>
|
|
||||||
</div>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
return (
|
return (
|
||||||
<button
|
<button
|
||||||
type="button"
|
type="button"
|
||||||
className="mt-1 text-xs text-gray-400 hover:text-[var(--c-primary)] underline"
|
className="mt-0.5 text-base leading-none align-middle opacity-70 hover:opacity-100 disabled:opacity-40"
|
||||||
onClick={() => startClosing(iso)}
|
onClick={() => (closed ? reopenDay(iso) : startClosing(iso))}
|
||||||
|
disabled={closeBusy}
|
||||||
|
title={closed ? dict.weekEditor.reopenDay : dict.weekEditor.closeDay}
|
||||||
|
aria-label={closed ? dict.weekEditor.reopenDay : dict.weekEditor.closeDay}
|
||||||
>
|
>
|
||||||
{dict.weekEditor.closeDay}
|
{closed ? "🔒" : "🔓"}
|
||||||
</button>
|
</button>
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Banner, das bei einem geschlossenen Tag alle Essenszeiten-Zellen
|
||||||
|
// dieses Tages ersetzt (Desktop: eine über rowSpan verbundene Zelle,
|
||||||
|
// Mobil: anstelle der Essenszeiten-Karten) – "Bearbeiten" öffnet das
|
||||||
|
// Formular erneut, um nur den Grund anzupassen, ohne den Tag über das
|
||||||
|
// Symbol im Header erst wieder öffnen zu müssen.
|
||||||
|
function renderClosedBanner(iso: string, closed: ClosedDay) {
|
||||||
|
return (
|
||||||
|
<div className="flex flex-col items-center justify-center gap-1 py-4 text-red-700">
|
||||||
|
<span className="text-2xl" aria-hidden>
|
||||||
|
🔒
|
||||||
|
</span>
|
||||||
|
<span className="font-semibold">{dict.weekEditor.closedLabel}</span>
|
||||||
|
{closed.reason && <span className="text-sm px-2 text-center">{closed.reason}</span>}
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
className="mt-1 text-xs text-gray-500 hover:text-[var(--c-primary)] underline"
|
||||||
|
onClick={() => startClosing(iso)}
|
||||||
|
>
|
||||||
|
{dict.common.edit}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
// Formular zum Schließen/Bearbeiten eines Tages – ein gemeinsames
|
// Formular zum Schließen/Bearbeiten eines Tages – ein gemeinsames
|
||||||
// Formular für Desktop-Tabelle und mobile Tagesansicht, da immer nur
|
// Formular für Desktop-Tabelle und mobile Tagesansicht, da immer nur
|
||||||
// ein Tag gleichzeitig bearbeitet werden kann.
|
// ein Tag gleichzeitig bearbeitet werden kann.
|
||||||
@@ -330,7 +341,6 @@ export default function WeekEditor({
|
|||||||
// unabhängig davon, welche Ansicht gerade rendert.
|
// unabhängig davon, welche Ansicht gerade rendert.
|
||||||
function renderCell(iso: string, sectionKey: string) {
|
function renderCell(iso: string, sectionKey: string) {
|
||||||
const isAdding = adding?.iso === iso && adding?.section === sectionKey;
|
const isAdding = adding?.iso === iso && adding?.section === sectionKey;
|
||||||
const closed = Boolean(closedDayFor(iso));
|
|
||||||
return (
|
return (
|
||||||
<>
|
<>
|
||||||
{entriesFor(entries, iso, sectionKey).map((e) => {
|
{entriesFor(entries, iso, sectionKey).map((e) => {
|
||||||
@@ -353,7 +363,7 @@ export default function WeekEditor({
|
|||||||
</div>
|
</div>
|
||||||
);
|
);
|
||||||
})}
|
})}
|
||||||
{closed ? null : isAdding ? (
|
{isAdding ? (
|
||||||
<div className="mt-2 space-y-1 text-left">
|
<div className="mt-2 space-y-1 text-left">
|
||||||
{selectedDishObj ? (
|
{selectedDishObj ? (
|
||||||
<div className="flex items-center gap-1 text-sm">
|
<div className="flex items-center gap-1 text-sm">
|
||||||
@@ -484,22 +494,34 @@ export default function WeekEditor({
|
|||||||
))}
|
))}
|
||||||
</div>
|
</div>
|
||||||
<h2 className="font-bold text-[var(--c-primary)] mb-1">
|
<h2 className="font-bold text-[var(--c-primary)] mb-1">
|
||||||
{selectedDay.weekday} · {formatDateLong(selectedDay.iso, dict.dateLocale)}
|
{selectedDay.weekday} · {formatDateLong(selectedDay.iso, dict.dateLocale)}{" "}
|
||||||
|
{renderClosureToggle(selectedDay.iso)}
|
||||||
</h2>
|
</h2>
|
||||||
<div className="mb-2">{renderClosureBadge(selectedDay.iso)}</div>
|
{(() => {
|
||||||
<div className="space-y-3">
|
const closed = closedDayFor(selectedDay.iso);
|
||||||
{sections.map((s) => (
|
if (closed) {
|
||||||
<div key={s.key} className="rounded-md border border-gray-200 overflow-hidden">
|
return (
|
||||||
<div className="bg-[var(--c-primary)] text-[var(--c-header-text)] px-3 py-1.5 text-sm">
|
<div className="rounded-md border border-red-200 bg-red-50">
|
||||||
<span className="font-semibold">{localized(s, locale)}</span>{" "}
|
{renderClosedBanner(selectedDay.iso, closed)}
|
||||||
<span className="opacity-80">· {s.time_range}</span>
|
|
||||||
</div>
|
|
||||||
<div className="bg-[var(--c-row-bg)] px-3 py-2 text-sm text-center">
|
|
||||||
{renderCell(selectedDay.iso, s.key)}
|
|
||||||
</div>
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return (
|
||||||
|
<div className="space-y-3">
|
||||||
|
{sections.map((s) => (
|
||||||
|
<div key={s.key} className="rounded-md border border-gray-200 overflow-hidden">
|
||||||
|
<div className="bg-[var(--c-primary)] text-[var(--c-header-text)] px-3 py-1.5 text-sm">
|
||||||
|
<span className="font-semibold">{localized(s, locale)}</span>{" "}
|
||||||
|
<span className="opacity-80">· {s.time_range}</span>
|
||||||
|
</div>
|
||||||
|
<div className="bg-[var(--c-row-bg)] px-3 py-2 text-sm text-center">
|
||||||
|
{renderCell(selectedDay.iso, s.key)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
</div>
|
</div>
|
||||||
))}
|
);
|
||||||
</div>
|
})()}
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
{/* Ab "sm": klassische Wochentabelle */}
|
{/* Ab "sm": klassische Wochentabelle */}
|
||||||
@@ -512,24 +534,38 @@ export default function WeekEditor({
|
|||||||
<th key={d.iso} className="day-head">
|
<th key={d.iso} className="day-head">
|
||||||
<span className="font-bold">{d.weekday}</span>
|
<span className="font-bold">{d.weekday}</span>
|
||||||
<br />
|
<br />
|
||||||
{formatDateLong(d.iso, dict.dateLocale)}
|
{formatDateLong(d.iso, dict.dateLocale)} {renderClosureToggle(d.iso)}
|
||||||
{renderClosureBadge(d.iso)}
|
|
||||||
</th>
|
</th>
|
||||||
))}
|
))}
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
{sections.map((s) => (
|
{sections.map((s, sIdx) => (
|
||||||
<tr key={s.key}>
|
<tr key={s.key}>
|
||||||
<th className="section-head">
|
<th className="section-head">
|
||||||
<div>{localized(s, locale)}</div>
|
<div>{localized(s, locale)}</div>
|
||||||
<div className="time">{s.time_range}</div>
|
<div className="time">{s.time_range}</div>
|
||||||
</th>
|
</th>
|
||||||
{days.map((d) => (
|
{days.map((d) => {
|
||||||
<td key={d.iso} className="cell">
|
const closed = closedDayFor(d.iso);
|
||||||
{renderCell(d.iso, s.key)}
|
if (closed) {
|
||||||
</td>
|
if (sIdx > 0) return null;
|
||||||
))}
|
return (
|
||||||
|
<td
|
||||||
|
key={d.iso}
|
||||||
|
className="cell closed-cell"
|
||||||
|
rowSpan={sections.length}
|
||||||
|
>
|
||||||
|
{renderClosedBanner(d.iso, closed)}
|
||||||
|
</td>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return (
|
||||||
|
<td key={d.iso} className="cell">
|
||||||
|
{renderCell(d.iso, s.key)}
|
||||||
|
</td>
|
||||||
|
);
|
||||||
|
})}
|
||||||
</tr>
|
</tr>
|
||||||
))}
|
))}
|
||||||
</tbody>
|
</tbody>
|
||||||
|
|||||||
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "canteen-menu",
|
"name": "canteen-menu",
|
||||||
"version": "1.12.0",
|
"version": "1.12.1",
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"predev": "node --env-file-if-exists=.env.local db/migrate.mjs && node --env-file-if-exists=.env.local scripts/bootstrap-admin.mjs",
|
"predev": "node --env-file-if-exists=.env.local db/migrate.mjs && node --env-file-if-exists=.env.local scripts/bootstrap-admin.mjs",
|
||||||
|
|||||||
Reference in New Issue
Block a user