Gutscheinkontor – Deine Gutscheineverwaltung

Themenbild für vibecoding

Jeder kennt es: Ein Gutschein zum Geburtstag, ein Rabattcode aus der Newsletter-Aktion, ein Restguthaben von der letzten Rückgabe. Irgendwo liegt er, in einer Schublade, im Mailpostfach oder als Foto auf dem Handy. Und dann, Monate später, der Blick auf das Datum: abgelaufen.

Genau dagegen habe ich Gutscheinkontor gebaut, eine kleine Web-App, die alle Gutscheine an einem Ort verwaltet und rechtzeitig per E-Mail vor dem Ablauf erinnert. Sie ist für Homelabs und Familien gedacht und läuft als einzelner Docker-Container.

Was Gutscheinkontor kann

Gutscheine erfassen, wie sie wirklich aussehen. Nicht jeder Gutschein ist ein fester Euro-Betrag. Gutscheinkontor kennt Wertgutscheine mit Restwert, Prozent-Rabatte, Freitext-Vorteile („Gratis-Versand“, „2 für 1“) und den Mindestbestellwert. Dazu kommen Ablaufdatum, Schlagwörter, Notizen und Anhänge (etwa das PDF oder der Screenshot des Gutscheins). Ein Hinweis markiert Gutscheine, die nur online einlösbar sind, samt Adresse des Webshops.

Logos statt grauer Listen. Jeder Gutschein kann das Logo seines Shops bekommen, per Upload oder auf Knopfdruck von der Webseite des Shops. So erkennt man die Liste auf einen Blick.

Erinnerungen, die ankommen. Standardmäßig schickt die App 30, 7 und 1 Tag vor dem Ablauf eine E-Mail. Das reicht, um einen Gutschein noch einzulösen, bevor er verfällt.

Für die ganze Familie. Weitere Nutzer kommen per Einladungslink dazu. Alle sehen denselben Bestand, ein Gutschein von Oma landet also nicht beim Falschen. Eine offene Registrierung gibt es bewusst nicht.

Dark Mode und Handy. Die Oberfläche ist responsiv, kennt einen Dunkelmodus und ist auf Deutsch.

Sicherheit: Gutscheincodes sind Geld

Ein Gutscheincode ist praktisch Bargeld. Deshalb ist die Sicherheit kein Nachgedanke:

  • Codes liegen verschlüsselt in der Datenbank.
  • Passwörter werden mit Argon2id gehasht.
  • Zwei-Faktor-Anmeldung (TOTP) ist Pflicht, für jedes Konto.
  • Schutz gegen CSRF, Begrenzung von Fehlversuchen, strenge Content-Security-Policy.
  • Der Container läuft ohne Root, mit schreibgeschütztem Dateisystem und ohne zusätzliche Rechte.

Datenschutz ist ebenso schlicht gehalten: keine Tracker, keine Analytics, keine externen Ressourcen. Die einzige Verbindung nach außen ist der Mailserver, den man selbst einträgt. Die App schreibt keine Zugriffsprotokolle, weil Einladungs- und Reset-Links ihr Token im Pfad tragen.

Backups und Export

Die App legt jede Nacht um 3 Uhr ein Backup an und behält die letzten sieben, mit Integritätsprüfung, bevor es unter seinem Namen abgelegt wird. Zusätzlich gibt es einen Export als ZIP (mit Anhängen) oder CSV. Der Import fügt nur hinzu, überschreibt nie etwas und bietet einen Probelauf, der vorab zeigt, was passieren würde.

Ein wichtiger Hinweis steht deshalb auch in der Anleitung: Den SECRET_KEY getrennt von den Daten sichern. Ohne ihn sind Codes, 2FA-Daten und Backups nicht mehr lesbar.

Installation in fünf Minuten

Voraussetzung sind Docker mit dem Compose-Plugin und ein Reverse Proxy für HTTPS, zum Beispiel Caddy.

git clone https://github.com/teitech/Gutscheinkontor.git
cd Gutscheinkontor
cp .env.example .env

In der .env trägt man den SECRET_KEY (erzeugt mit openssl rand -base64 48) und die öffentliche BASE_URL ein. Dann:

docker compose up -d

Beim ersten Aufruf legt man das Administrator-Konto an und richtet die Zwei-Faktor-Anmeldung ein. Das Image gibt es für amd64 und arm64, es läuft also auch auf dem Raspberry Pi. Beispiele für die Proxy-Konfiguration (Caddy, Traefik, nginx, Nginx Proxy Manager) liegen in der Dokumentation.

Ehrlich gesagt: Vibe-Coding

Ich will es nicht verschweigen: Gutscheinkontor ist ein privates Projekt und entstand mit KI-gestützter Entwicklung, also Vibe-Coding. Ich habe die Anforderungen und Entscheidungen vorgegeben, vom Pflicht-2FA bis zur Frage, ob es eine offene Registrierung geben darf, und mir die Umsetzung von einer KI schreiben lassen. Damit das nicht auf Hoffnung beruht, laufen bei jedem Push Tests in GitHub Actions. Dort wird das Image gebaut und wie im Betrieb gestartet; ein Rauchtest geht Einrichtung, Gutschein, Anhang, Export, Import und Backup einmal komplett durch.

Trotzdem gilt: Nutzung auf eigene Gefahr. Es gibt keine Garantie und keinen Support. Wer die App produktiv einsetzt, sollte Sicherheit und Datensicherung selbst prüfen. Das Projekt ist jung, mit Ecken und Kanten ist zu rechnen.

Wie geht es weiter?

Seit Version 0.1.0 ist schon einiges dazugekommen: Prozent-Rabatte und Freitext-Vorteile, Shop-Logos, ein neues Erscheinungsbild mit eigenem Logo und zuletzt die Version 0.3.4. Die Oberfläche ist für weitere Sprachen vorbereitet, derzeit gibt es nur Deutsch.

Der Quellcode liegt unter der AGPL-3.0 öffentlich auf GitHub: github.com/teitech/Gutscheinkontor. Feedback, Fehlermeldungen und Ideen sind willkommen.

Und jetzt entschuldigt mich: Ich muss noch einen Gutschein einlösen, der in 7 Tagen abläuft.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

Nach oben scrollen