Dokumentation

Einführung in ShopBite

ShopBite ist ein Open-Source-Bestellsystem für Restaurants, Pizzerien und Lieferdienste. Es besteht aus Shopware 6 als Backend, dem ShopBite Plugin für Öffnungszeiten, Feiertage und Extras sowie einer schnellen Storefront auf Basis von Nuxt.

Der schnellste Weg, ShopBite kennenzulernen: Starten Sie es auf Ihrem eigenen Rechner. Sie brauchen dafür nur Docker.

In fünf Minuten starten

Docker installieren

Installieren Sie Docker Desktop (macOS, Windows) oder Docker Engine mit Compose (Linux). Planen Sie etwa 4 GB freien Arbeitsspeicher ein.

Repository klonen und starten

git clone https://github.com/shopbite-de/shopbite.git
cd shopbite
docker compose up -d

Beim ersten Start werden die Images geladen und Shopware wird installiert. Das dauert einige Minuten. Mit docker compose logs -f setup sehen Sie den Fortschritt. Sobald storefront config written erscheint, ist der Shop bereit.

Shop öffnen

Was	Adresse	Zugang
Storefront	localhost:3000
Shopware Administration	localhost:8000/admin	`admin` / `shopbite`
Backoffice	localhost:3010	`chef` oder `theke` / `shopbite`
E-Mails (Mailpit)	localhost:8025

Sie bekommen einen fertigen Restaurant-Shop: 71 Gerichte in 9 Kategorien, Pizzagrößen, Extras, Beilagen, vegetarische und vegane Kennzeichnung, Öffnungszeiten und einen funktionierenden Checkout.

Bestellen Sie eine Pizza als Gast. Die Bestellbestätigung landet in Mailpit, die Bestellung sehen Sie in der Administration unter Bestellungen.

Was Sie ausprobieren können

Kontaktformular testen: Nachrichten über localhost:3000/kontakt landen ebenfalls in Mailpit.
Speisekarte ändern: Passen Sie in der Administration unter Kataloge > Produkte einen Preis an. Nach ein bis zwei Minuten zeigt die Storefront den neuen Preis.
Öffnungszeiten pflegen: Unter ShopBite > Öffnungszeiten (der Demo-Shop ist rund um die Uhr geöffnet). Tragen Sie unter Feiertage den heutigen Tag ein, dann zeigt die Storefront den Shop als geschlossen.
Wie das Personal arbeiten: Das Backoffice unter localhost:3010 ist die einfache Verwaltung für ein Restaurant. chef (Management) pflegt Gerichte, Preise, Abschnitte, Extras und Öffnungszeiten, theke (Personal) sieht die Bestellungen von heute, pausiert Online-Bestellungen und stellt die Lieferzeit ein. Auf Handy und Tablet lässt es sich als App installieren, unter Mein Zugang richten Sie die Anmeldung per Fingerabdruck oder Face ID ein.
Ohne Demo-Daten starten: SEED_DEMO_MENU=0 docker compose up -d legt bei einer frischen Installation nur den Verkaufskanal an, ohne Speisekarte.
Von vorne beginnen: docker compose down -v löscht alle Daten, der nächste Start ist eine frische Installation.

Shop anpassen

Der Ordner storefront/ im Repository ist Ihre Storefront. Texte der Startseite, Impressum, Datenschutz, AGB, Farben und Logo liegen dort als einfache Dateien:

Was	Wo
Texte und Abschnitte der Startseite	`storefront/content/index.yml`
Impressum, Datenschutz, AGB, Zahlung und Lieferung	`storefront/content/*.md`
Markenfarben	`storefront/app/assets/css/main.css`
Logo	`storefront/public/light/Logo.png`, `storefront/public/dark/Logo.png`
Name, Adresse, Telefon	`storefront/nuxt.config.ts`

Mit Node.js und pnpm sehen Sie jede Änderung sofort im Browser:

cd storefront
pnpm install
pnpm dev

Die Storefront läuft dann unter localhost:3001 und nutzt das Shopware aus dem Schnellstart, die Zugangsdaten legt das Setup automatisch an. Mit docker compose up -d --build storefront übernehmen Sie Ihre Version anschließend auf localhost:3000.

Was ist ShopBite?

ShopBite besteht aus mehreren Open-Source-Komponenten, die im Schnellstart schon zusammengesteckt sind:

Komponente	Aufgabe
Shopware 6	Backend für Produkte, Bestellungen, Kunden und Zahlungen
ShopBite Plugin	Öffnungszeiten, Feiertage, Extras, Lieferzeiten und Checkout-Regeln
ShopBite Storefront	Schnelle, mobile Bestelloberfläche auf Basis von Nuxt 4
Order Printer	Druckt neue Bestellungen auf einem Bondrucker in der Küche

ShopBite richtet sich an Restaurants, Pizzerien, Imbisse, Lieferdienste und alle Gastronomiebetriebe, die Bestellungen online annehmen möchten, ohne Provision an eine Plattform abzugeben.

Vom Test zum echten Shop

Der Schnellstart ist zum Ausprobieren gedacht. Er nutzt feste Passwörter und läuft ohne HTTPS. Für einen echten Shop gehen Sie so vor:

Shopware installieren, zum Beispiel mit dem Produktiv-Setup aus shopbite-de/shopware (Docker, TLS, S3-Speicher).
ShopBite Plugin einrichten und Öffnungszeiten pflegen.
Den Ordner storefront/ in ein eigenes Repository übernehmen und veröffentlichen. Er erweitert die ShopBite Storefront als Nuxt Layer, mehr dazu unter Erste Schritte mit der Storefront.
Optional den Bondrucker anschließen.

Die Architekturübersicht zeigt, wie die Teile zusammenspielen.