B2B-E-Commerce & Abo-Plattform für Playground Coffee

Das Projekt

Eine vollwertige B2B-Webplattform für eine Rösterei, die den gesamten Handelsprozess abbildet: vom Kunden-Onboarding über Bestellungen und Abos bis zu Lieferanten-Importen (z. B. Gastronovi), Billbee-Synchronisation und umfassenden Auswertungen. Entwickelt als modulare, skalierbare Full-Stack-Anwendung mit modernem Tech-Stack.

Kernfunktionen

B2B-Shop & Checkout

• Artikelkatalog mit Preisgruppen (individuelle Konditionen pro Kunde)
• Warenkorb, Checkout mit Rechnungs- und Lieferadresse
• Varianten (Bohnen, Espresso, Filter, French Press)
• Abholung oder Versand
• Zahlungsarten: Banküberweisung, Vorkasse, Rechnung, Lastschrift

Billbee-Integration

• Bestellungen werden automatisch an Billbee übertragen
• Kundensuche und Import aus Billbee
• Status-Synchronisation (Ausstehend → Gepackt → Versendet)
• Verschiedene Vertriebswege nutzen getrennte Billbee-Konten

Kaffee-Abo-System

• Flexible Abos mit wöchentlicher, 2-wöchentlicher, monatlicher, 2-monatlicher und quartalsweiser Lieferung
• Mehrere Artikel pro Abo
• Automatische Bestellauslösung per Cron/n8n
• Abo-Bestätigungs-E-Mails, Erinnerungen
• Röstliste: aggregierte kg-Liste aus Billbee-Bestellungen + Abos pro Woche

Auswertungen & Reporting

• Billbee-Umsatzreport: Zeitraum-Slider, Granularität (Tag/Woche/Monat/Quartal/Jahr), Vorjahr-Vergleich, Kategorien (Kaffee/Merch/Zubehör), Billbee + Cafe-Umsätze kombiniert
• Abo-Auswertung: Gelieferte SUB-Bestellungen, Admin-Kunden ausgeschlossen, alle Kunden mit aktivem Abo, Menge/Artikel aus subscription_items
• Kundenauswertung über alle Vertriebswege
• Cafe-Tagesumsatz-API für n8n

E-Mail-Automatisierung

• Bestellbestätigung, Versandbenachrichtigung, Abholbenachrichtigung
• Stornierungs-E-Mails
• Account-Freischaltung mit Passwort-Generierung
• E-Mail-Log für alle ausgehenden E-Mails

Bestellimport per E-Mail (Wholesale)

• IMAP-Abruf des Wholesale-Postfachs
• PDF-Parsing aus E-Mail-Anhängen (Lieferscheine)
• Extraktion von Artikeln, Mengen, Lieferadresse
• Kundenerkennung und Übertragung an Billbee (getrenntes Vertriebsweg-Konto)
• n8n-Workflow mit UID, Betreff, optionalem Dry-Run
• Admin-Tool: Upload, Adress-Matching, Test-Parsing

Gastronovi

• CSV-Parser für Gastronovi-Bestellungen
• Kundenerkennung per E-Mail, PLU (Art.-Nr.), TAB-Trennzeichen
• Billbee-Order-Erstellung mit Buyer/Käufer aus Kunden-DB
• Zahlungsart aus Kundeneinstellung

Cafe & Kasse

• cafe_sales-Tabelle mit EXTF-Spalten (Umsatz, Beleginfo, Auftragsnummer)
• n8n-API für Tagesumsatz-Import
• CSV-Test-Seite für Cafe-Auswertung

Admin-Tools

• Bestellungen: Status-Badges, Billbee-Sync, Bestellbestätigung erneut senden
• Kunden: Billbee-Import, Preisgruppen, Adressen
• Artikel: Billbee-Produktsuche, Preisgruppen, Aktivieren/Deaktivieren
• Röstliste: Verwaltung, Auslösetag, Kunden bei Abos
• Wholesale E-Mails: IMAP, Filter, PDF-Extraktion
• Billbee-Sync: Full Load, Zeitspanne, Letzter Tag, skipLoaded
• Billbee-Report: Umsatz, Bestellanzahl, Kategorien
• Changelog: Automatisch aus Git generiert

Verwendete Technologien

Architektur-Highlights

• Row Level Security (RLS): Kunden sehen nur ihre Daten, Admins haben Vollzugriff
• Preisgruppen: Artikelpreise abhängig von Kunden-Preisgruppe
• Paginierung: Supabase-Limit 1000 Zeilen wird mit range(from, to) umgangen
• Robustes Fehlerhandling: Timeouts, leere JSON-Antworten, 404-Fehler
• E-Mail-Log: Alle ausgehenden E-Mails werden protokolliert

Geschäftlicher Nutzen

• Zeitersparnis: Automatische Billbee-Synchronisation, Lieferanten-Import per E-Mail (z. B. Gastronovi)
• Transparenz: Auswertungen für Umsatz, Abos, Cafe
• Skalierbarkeit: Modulare APIs, n8n für Workflows
• Kundenerlebnis: Abos mit flexiblen Intervallen, Bestellbestätigungen, Abholbenachrichtigungen