SIMsales Gutschein-Shop

SIMsales ist unser eigenes Shop-System für Gutscheine, Tickets, Events und Mehrfachkarten von Studios (SIMproducts, Händler-Admin, Check-in-App, Agentur-Dashboard, Storefront-Widget <sim-store>). Hauptkunde ist Balance Kassel; weitere Händler sind studios in motion, AktiVita und INJOY Wunstorf (Stand Notiz). Die Bestellungen laufen seit 25.09.2026 zusätzlich in die Zentrale (Hub) und das Kundenportal.

• Betrieb auf dem eigenen VPS (Alias ssh simproducts), Compose-Projekt mit Storefront, Admin-Dashboard, Check-in, Agency-Dashboard, Backend (:4000), Landing hinter Traefik; Datenbank Supabase-Postgres.
• Funktionen live: PayPal Live und Sandbox mit verschlüsselten Zugangsdaten, mehrere Benachrichtigungs-Adressen je Händler, CSV-Export mit Zeitraum, Mehrfachkarten mit Ablauf und Entwertungshistorie, Produkt-Varianten, Medienpool mit KI-Bildern (Limit 30 pro Monat), Kategorie-Filter und Akkordeon im Widget, Lastschrift-Button entfernt (PayPal-SEPA nur mit PayPal-Konto).
• Gutschein-Designs: Werkstatt mit 4 Vorlagen live seit 25.08. (QR 168 px, Scan-Test 10 von 10), Zuordnung für 35 Produkte, Zeitzonenpaket Europe/Berlin.
• Bestellübersicht mit Artikel-Spalte, Detaildialog, Suche und Filtern seit 09.09. (von René abgenommen).
• Hub-Anbindung live seit 25.09. (Hub v0.342.0): Webhook mit HMAC, Master-API, Leads nach Einwilligungsregel, Karte in der Kundenakte, Portalbereich „Bestellungen“; Balance importiert (44 Bestellungen, 31 Leads, Umsatz 776,01 €). Der n8n-Webhook ist deaktiviert.
• Letzte Änderung 02.10.: Storefront-Raster ohne leere Plätze (8e74836). SimGym-Demo-Shop /shop/ auf preprod (Code DEMO).
• Test-Bestellungen von Balance wurden am 20.08. gelöscht; Rechnungsnummern starteten dadurch bei RE-2026-0001.

• ich ersten echten Kauf über den Webhook beobachten (Event shop.bestellung).
• René Balance Kassel Live-PayPal-Zugangsdaten einmalig neu eintragen (wurden vor dem Deploy vom Alt-Bug überschrieben; prüfen, ob erledigt) und die Benachrichtigungs-Adressen eintragen.
• René Woman-Only-Uhrzeit mit Balance bestätigen (20:00 Uhr, Shop zeigte vorher 22:00); „PayPal-Konto optional“ im Geschäftskonto prüfen.
• René SimGym-Demo-Shop ansehen und preprod nach main (Bezahlweg im Testmodus, Testdaten beim Händler aufräumen).
• ich Nebenbefund prüfen: order_items.custom_fields_answers mit Schlüssel „undefined“ (Storefront-Checkout).
• ich Betriebssicherung anschließen (kein Cron, kein Backup-Skript auf dem VPS; Repos, Configs und pocketbase-Volume ungesichert, prüfen); externes Monitoring fehlt (1 vCPU, Hermes-Dashboard frisst dauerhaft CPU).
• ich Absenderanzeige der Bestell-Mails beim nächsten Testkauf prüfen; Idee Absendername je Verkäufer.

• 2026-09-25: Einwilligungsregel für Shop-Leads: bezahlt = Verkauf und Lead „gewonnen“ (Werbung nur mit Einwilligung); Abbruch mit Einwilligung = Lead „neu“; ohne Einwilligung nur anonyme Zahl. Nie Adresse, Zahlungsdaten, Gutschein-Codes.
• 2026-08-25: Fitness und Kurse bekommen die Quer-Karte, keine eigene Variante (René); Gutschein-Designs lokal entwickeln.
• 2026-08-07: Schnappschuss-Prinzip: Preis, Steuer und PDF werden beim Kauf eingefroren; ein Titel-Snapshot in order_items wird bewusst nicht gebaut (nicht erneut vorschlagen).
• 2026-08-17: Storefront-Widget fest hell, dunkel nur mit theme="dark".
• Kundendaten nicht eigenmächtig korrigieren; Test-Händler-Login aus der Automatik ist geblockt, Optik über den lokalen Render-Harnisch prüfen.
• Balance-Website holt Events beim Build von api.simsales.de: SimSales-Container nie parallel zu Website-Builds neu starten.

1. 02.10.2026
   Storefront-Raster ohne leere Plätze (8e74836); SimGym-Demo-Shop auf /shop/ (preprod).
2. 25.09.2026
   Hub-Anbindung live (Hub v0.342.0, dc17eae; Backend 24cbae7 und 56d3937 auf dem VPS), Balance-Bestand importiert, n8n-Webhook deaktiviert.
3. 09.09.2026
   Bestellübersicht mit Artikeln, Suche und Filtern (64b57fc bis c7a921e).
4. 25.08.2026
   Gutschein-Designs Runde 2 live (94b48bb), Zeitzonenpaket (3e08226), Zuordnung 35 Produkte, Mail-Vorlagen mit Umlauten.
5. 23.08.2026
   Lastschrift-Button entfernt.
6. 20.08.2026
   Balance-Test-Bestellungen gelöscht.
7. 17.08.2026
   Storefront fest hell, Akkordeon-Kategorieansicht.
8. 14.08.2026
   Produkt-Varianten (3925fa9); 2026-08-07: Mehrfachkarten (8adb3cf), Produkt-Löschen-Fix.
9. 03.08.2026
   PayPal Live und Sandbox mit Verschlüsselung (709043c), Balance-Kundenwünsche (90748b7), Mail-Absender-Fix, Build-Dispatch für beide Umgebungen.
10. 01.08.2026
    Server-Zugang ssh simproducts und GitHub-Token für das Repo eingerichtet.

• Repo: /root/repos/system-sim-products (Deploy-Branch change2docker, Doku in Doku/ Nr. 16, 18, 19, 20), Werkstatt gutschein-werkstatt/.
• Server: ssh simproducts (Alias in /root/.ssh/config), Compose docker-compose.prod.yml, Konfiguration deploy/simsales.env (Variablen wie MASTER_API_KEY, CREDENTIALS_ENCRYPTION_KEY, SMTP_*; Werte nie notieren), Container system-sim-products-backend-1.
• Hub: hub/src/simsalesCore.ts, simsales.ts, portalShop.ts; Tabellen shop_bestellungen, simsales_konfig; Zentrale › Kunde › Leads › Karte „Shop-Bestellungen“; Portal /portal/shop.
• Sicherungen: /root/backups-simsales/ (pdf_templates, voucher_template_id, email_templates, SimGym-Demo-Händler), VPS /root/backups/balance-orders-20260820.tgz.
• Transfer: /root/transfer/simsales-hub-anbindung/ (Patch-Serie), Schlüsselablage /root/transfer/keys/ (Master-API-Schlüssel, nicht notieren).
• Wiki: 40-Projekte/SIMproducts.md.