Dokumentation
raspb Weinshop — Dokumentation
Wie die Plattform aufgebaut ist, was sie kann und wie Sie damit arbeiten. Geschrieben für zwei Gruppen: Winzerinnen und Winzer, die ihren Shop pflegen — und alle, die die Plattform betreiben oder erweitern.
Einstieg
Der raspb Weinshop ist keine Shop-Software, die Sie installieren, sondern eine betriebene Plattform: Jedes Weingut bekommt seinen eigenen Shop unter eigener Domain, mit eigenem Design und eigenem Stripe-Konto. Geteilt werden nur die Dinge, die niemand zweimal braucht — Commerce-Backend, Datenbank, Medienspeicher, Zertifikate und Betrieb.
Für Sie als Winzer heißt das: Sie pflegen Ihre Weine und Ihre Geschichte, um alles andere kümmern wir uns. Für Technikerinnen und Techniker heißt es: eine Multi-Mandanten-Architektur auf Medusa v2 und SvelteKit, sauber getrennt über Sales Channels, deployt über Docker und Traefik.
Lesepfade
Je nachdem, warum Sie hier sind, lohnen sich unterschiedliche Reihenfolgen.
Ich bin Winzerin oder Winzer
- Quick-Start — die ersten fünf Handgriffe
- Feature-Katalog — was der Shop alles kann
- FAQ — Kosten, Migration, Stripe
Ich betreibe oder erweitere
- Systemarchitektur — der Aufbau im Ganzen
- Komponenten — jeder Baustein einzeln
- Deployment — Build, Push, Smoke-Test
- Onboarding — neues Weingut anlegen
Alle Kapitel
Sieben Kapitel, jedes für sich lesbar. Die Suche links oben findet Abschnitte über alle Kapitel hinweg — sie läuft vollständig im Browser, es wird nichts an einen Server geschickt.
- Systemarchitektur Wie die Plattform aufgebaut ist — vom Reverse Proxy bis zur Datenbank. Öffnen
- Komponenten Jeder Baustein einzeln: Aufgabe, Technologie, Schnittstellen. Öffnen
- Mandanten-Onboarding Vom ersten Gespräch bis zum Shop, der Bestellungen annimmt. Öffnen
- Feature-Katalog Alles, was die Plattform kann — nach Bereichen sortiert. Öffnen
- Quick-Start für Winzer Die ersten fünf Handgriffe im Cockpit — Schritt für Schritt. Öffnen
- Deployment Build-Pipeline, Docker-Stack, Registry, Smoke-Tests, Fehlerbilder. Öffnen
- FAQ Technik, Kosten, Migration, Stripe und Betrieb — kurz beantwortet. Öffnen
Konventionen
Vier Sorten farbiger Hinweisboxen begleiten den Text. Sie sehen so aus:
Statusangaben
Im Feature-Katalog steht hinter jedem Punkt ein Status: Live heißt, das Feature läuft im Produktivbetrieb bei mindestens einem Weingut. In Arbeit heißt, es ist begonnen oder geplant, aber noch nicht ausgerollt. Wir schreiben nichts als „live“, was wir nicht selbst im Betrieb gesehen haben.
Jeder API-Fehler muss dem Nutzer sichtbar sein — nie leere Boxen oder leere Flächen. Immer Fehler- und Ladezustand vorsehen.
Dieser Satz steht seit dem Gutschein-Release in unseren Entwicklungsnotizen und erklärt ganz gut, wonach die Plattform gebaut ist: Lieber eine ehrliche Meldung als eine hübsche, leere Oberfläche.