qrcode-generator/docs/roadmap.md

Roadmap

Was gebaut ist, und was danach sinnvoll wäre. Der zweite Teil ist eine Sammlung von Vorschlägen mit einer groben Einschätzung des Aufwands — keine Zusage und keine Reihenfolge. Was zuerst kommt, entscheidet, was im Betrieb fehlt.

---

Gebaut

Version 1 — Grundgerüst (13.08.2026)

• Next.js-Anwendung und PostgreSQL als Docker-Compose-Stack, ohne Reverse Proxy, Migrationen beim Start
• QR-Typ-Registry als Dispatch-Tabelle — ein neuer Typ ist ein Modul plus ein Formular, ohne Eingriff in den übrigen Code
• Typ Website, statisch und dynamisch, mit Kurz-URL, 302-Weiterleitung und Scan-Zähler
• Gestaltung: Farben mit Kontrastwarnung, Größe, Fehlerkorrektur, Rand
• Download als PNG und SVG, serverseitig gerendert
• „Meine Codes“ mit Ziel ändern und Löschen
• Deutsche Oberfläche, deutsche Fehlermeldungen, Validierung mit Zod
• Update-Skript für Linux/macOS und Windows

Typen einzeln freigeben (14.08.2026)

Ausblenden nicht gebrauchter Typen in der Verwaltung. Bereits erstellte Codes eines abgeschalteten Typs funktionieren weiter.

Phase A — acht weitere Typen (14.08.2026)

vCard, App-Link, WhatsApp, E-Mail, SMS, Standort, Zahlung (GiroCode und Zahlungslink), WLAN.

Phase B1 — Anmeldung, Gruppen, Rollen (14.08.2026)

Abschaltbare Anmeldung, Benutzerverwaltung, Gruppen mit den Rollen Administrator, Bearbeiter und Betrachter, Sitzungen in der Datenbank, scrypt-Passwörter, Sperre nach Fehlversuchen.

Phase B2 — mehrere Domains (14.08.2026)

Domains für Kurz-URLs, den Gruppen zugeteilt. Slug je Domain eindeutig, Host-Header gegen die registrierten Domains geprüft.

Listenansicht (14.08.2026)

„Meine Codes“ als Liste mit Suche, Sortierung und Gruppenfilter — gedacht für viele Projekte nebeneinander. Karten bleiben als zweite Ansicht.

Phase C — die letzten sechs Typen (14.08.2026)

Mehrere Links, Social Media, Video, PDF, Bild, Feedback. Dazu:

• Landingpages als eigene Gattung (/s/{slug}), ohne App-Navigation
• Datei-Upload mit Inhaltsprüfung, Größengrenze und Aufräumen
• Feedback mit anonymer Erhebung und Auswertung

Damit sind alle 15 vorgesehenen Typen gebaut.

Single Sign-on (15.08.2026)

Anmeldung über Authentik und andere OIDC-Anbieter, mit PKCE und geprüftem ID-Token.

Dokumentation (15.08.2026)

Bedienungsanleitung mit Bildern, Authentik-Anleitung, Funktionsübersicht. Die Bilder erzeugt ein Skript, damit sie nicht veralten.

---

Denkbar als Nächstes

Die Einschätzungen sind grobe Hausnummern für eine Person, die den Code kennt.

Naheliegend

Statistik über die Zeit · mittel Der Zähler weiß heute nur, wie oft und wann zuletzt. Ein Verlauf je Tag wäre eine eigene Tabelle plus ein Diagramm in der Codeansicht. Die eigentliche Frage ist nicht die Technik, sondern wie lange man so etwas aufbewahrt — und was man dabei über die Scannenden erfährt. Ein reiner Tageszähler ohne Herkunft und Gerät ist unbedenklich und würde für „läuft die Kampagne?“ genügen.

Codes exportieren · klein Eine CSV aller Codes einer Gruppe mit Name, Kurz-URL, Ziel und Scans — für die Übergabe an eine Druckerei oder die Ablage.

Papierkorb statt Löschen · klein Gelöschte Codes 30 Tage aufheben, dann endgültig entfernen. Heute ist ein gedruckter Code nach einem Fehlklick unwiederbringlich tot.

Codes duplizieren · klein „Wie dieser, aber mit anderem Ziel“ — bei vielen ähnlichen Projekten spart das jedes Mal ein paar Minuten.

Wenn der Bedarf da ist

Stapelverarbeitung · mittel Eine CSV hochladen und daraus 200 Codes erzeugen, als ZIP zurück. Sinnvoll, sobald jedes Produkt oder jeder Tisch einen eigenen Code bekommt.

Gruppen aus dem Verzeichnis übernehmen · mittel Die OIDC-Anbindung übernimmt heute bewusst nur die Identität. Eine Zuordnung von Verzeichnisgruppen zu Gruppen dieser Anwendung ist möglich, braucht aber eine klare Regel dafür, was mit von Hand vergebenen Rollen geschieht — sonst verliert jemand beim nächsten Anmelden stillschweigend seine Rechte.

Logo im QR-Code · mittel Ein kleines Bild in die Mitte setzen, mit erzwungener Fehlerkorrektur H und einer Warnung, wenn zu viel verdeckt wird. Braucht eine ehrliche Prüfung mit mehreren Scanner-Apps, sonst entstehen Codes, die nur auf dem eigenen Handy funktionieren.

Ablaufdatum und Zeitsteuerung · mittel Ein Code, der ab einem Datum woandershin führt oder abläuft — für Veranstaltungen und Aktionen.

Passwortgeschützte Landingpages · mittel Für Unterlagen, die nicht jeder sehen soll, der den Aushang fotografiert. Heute ist die Empfehlung klar: Vertrauliches gehört nicht hinter einen offenen QR-Code.

Größere Brocken

Mehrsprachige Oberfläche · groß Die Anwendung ist durchgehend deutsch, auch in den Fehlermeldungen und den Landingpages. Eine zweite Sprache berührt jede Datei.

Eigene Gestaltung der Landingpages · groß Logo, Farben und Schrift je Gruppe, damit die Seite nach der eigenen Firma aussieht. Technisch überschaubar, gestalterisch eine eigene Aufgabe — und es braucht Grenzen, damit nichts Unlesbares entsteht.

Dateien außerhalb der Datenbank · mittel Heute liegen Uploads in PostgreSQL, damit es bei einem Volumen bleibt. Wer sehr viele oder sehr große Dateien ablegt, will sie irgendwann auf einem Objektspeicher (S3) haben. Der Wechsel betrifft nur src/lib/uploads.ts und die Auslieferungsroute — aber auch die Sicherungsstrategie.

---

Wie ein neuer Typ dazukommt

Falls doch noch einer fehlt: Er besteht aus einem Modul in src/lib/qr/types/, einer Formular-Komponente, je einem Registry-Eintrag und — wenn er eine eigene Seite braucht — einer Landingpage. Am übrigen Code ändert sich nichts. Näheres im README, Abschnitt „Einen weiteren Typ ergänzen“.