Produkte

Der Produktkatalog listet die Artikel auf, die Ihr Internetcafe oder Gaming-Center verkauft. Dazu gehören Speisen, Getränke, Snacks, Zubehör und alle anderen physischen Waren, die Kunden angeboten werden. Jedes Produkt hat einen definierten Preis, eine Kategorie, einen Steuersatz und einen Lagerbestand. Produkte sind mit dem Bestellsystem integriert, sodass Kassierer Bestellungen erstellen, Verkäufe verfolgen und den Bestand verwalten können.

Produkte werden auf der Registerkarte Produkte der Seite Lagerbestand in der Hauptnavigation verwaltet. Die Registerkarte bietet eine Tabellenansicht und eine Rasteransicht. Rasterkarten zeigen das Produktfoto, den Preis und ein Abzeichen Auf Lager oder Nicht auf Lager.

Produktfelder

Jeder Produktdatensatz enthält folgende Informationen:

Feld	Beschreibung
`name`	Der Produktname, der in der Bestelloberfläche angezeigt wird. Muss eindeutig sein (ohne Berücksichtigung der Groß-/Kleinschreibung).
`category`	Eine Textbezeichnung zur Gruppierung verwandter Produkte (z. B. "Getränke", "Snacks", "Zubehör"). Für Filterung und Berichterstattung.
`unit`	Die Maßeinheit für die Bestandsverfolgung (z. B. "Stück", "kg", "Liter", "Dose", "Flasche").
`barcode`	Ein optionaler Barcode-Wert für Scanner-Integration. Kassierer können den Barcode eines Produkts scannen, um es schnell einer Bestellung hinzuzufügen.
`sale_price`	Der Verkaufspreis in Währungsuntereinheiten (z. B. Cent). Dies ist der dem Kunden pro Einheit berechnete Betrag.
`vat_rate`	Der MwSt.-Satz (Mehrwertsteuer) für dieses Produkt (z. B. 18 für 18% MwSt.). Zur Berechnung des Steueranteils jedes Verkaufs.
`stock`	Der aktuelle Lagerbestand als Dezimalzahl. Wird automatisch aktualisiert, wenn Bestellungen aufgegeben und Wareneingänge erfasst werden. Der Bestand wird nicht am Produkt selbst bearbeitet. Verwenden Sie die Registerkarte Lagerstatus der Seite Lagerbestand.
`min_stock`	Der Nachbestellschwellenwert. Wenn der Lagerbestand auf diesen Wert oder darunter fällt, wird das Produkt auf der Registerkarte Lagerstatus als kritisch gekennzeichnet. Null bedeutet kein Schwellenwert.
`description`	Eine optionale Textbeschreibung für zusätzliche Produktdetails.
`photo`	Ein optionales Produktfoto, das in der Rasteransicht und in der Cafeteria-Speisekarte angezeigt wird.

Produkt aus dem Verkauf nehmen

Ein Produkt, das nicht mehr angeboten werden soll, wird mit der Aktion Aus dem Verkauf nehmen auf der Registerkarte Produkte entfernt. Eine Bestätigung erklärt, dass dies das Produkt aus dem Katalog löscht und nicht rückgängig gemacht werden kann. Vergangene Bestellungen, die das Produkt enthielten, behalten ihre Positions-Snapshots, sodass historische Verkaufsdaten erhalten bleiben.

Bestandsverfolgung

HandyCafe führt einen laufenden Lagerbestand für jedes Produkt. Dieser Wert wird automatisch vom System aktualisiert als Reaktion auf:

Verkäufe: Wenn ein Produkt über eine Bestellung verkauft wird, sinkt der Bestand um die bestellte Menge.
Wareneingänge: Wenn neuer Bestand empfangen und auf der Registerkarte Wareneingang der Seite Lagerbestand erfasst wird, steigt der Bestand entsprechend.
Manuelle Anpassungen: Die Registerkarte Lagerstatus bietet die Aktionen Lager korrigieren, Abfall und Zählen, um Schwund, Bruch, Fehlzählungen oder andere Abweichungen zu berücksichtigen.

Der Bestand kann im Produkteditor nicht bearbeitet werden. Alle Bestandsänderungen laufen über die Registerkarte Lagerstatus, sodass jede Änderung in der Bewegungshistorie landet.

Produktbestandsprotokoll

Jede Änderung des Lagerbestands eines Produkts wird im Produktbestandsprotokoll erfasst und erstellt eine vollständige Prüfspur:

Grund	Beschreibung
`sale`	Bestand durch Kundenbestellung verringert. Verknüpft mit dem spezifischen Bestelldatensatz.
`purchase`	Bestand durch Inventareinkauf erhöht. Verknüpft mit dem spezifischen Inventareintrag.
`adjustment`	Bestand wurde manuell von einem Kassierer oder Administrator angepasst.
`waste`	Bestand durch Verderb, Bruch oder Abschreibung verringert.
`return`	Bestand durch Kundenrückgabe oder Bestellungsstornierung erhöht.

Jeder Protokolleintrag erfasst die Mengenänderung (positiv für Erhöhungen, negativ für Verringerungen), den neuen Lagerbestand nach der Änderung, wer die Änderung vorgenommen hat und eine optionale Notiz mit der Begründung.

Produktkategorien

Produkte werden nach Kategorie über ein Freitextfeld gruppiert. Gängige Kategorien sind:

Getränke (Softdrinks, Wasser, Energydrinks)
Heißgetränke (Kaffee, Tee, heiße Schokolade)
Snacks (Chips, Süßigkeiten, Schokoriegel)
Speisen (Sandwiches, Wraps, warme Gerichte)
Zubehör (Headsets, USB-Sticks, Mauspads)

Kategorien werden in der Bestelloberfläche zum Filtern verwendet. Kassierer können schnell zwischen Kategorien wechseln, um das richtige Produkt zu finden. Kategorien dienen auch der Gruppierung in Verkaufsberichten.

Es gibt keine separate Kategorieverwaltungsoberfläche. Kategorien werden implizit erstellt, wenn Sie einem Produkt einen Kategorienamen zuweisen. Um eine Kategorie umzubenennen, aktualisieren Sie das Kategoriefeld bei allen Produkten, die den alten Namen verwenden.

Produkt erstellen

So fügen Sie dem Katalog ein neues Produkt hinzu:

Öffnen Sie die Seite Lagerbestand in der Seitenleiste und wechseln Sie zur Registerkarte Produkte.
Klicken Sie auf die Schaltfläche Neues Produkt.
Geben Sie den Namen ein (muss eindeutig sein).
Wählen oder geben Sie eine Kategorie ein.
Wählen Sie die Maßeinheit.
Legen Sie den Verkaufspreis fest (der dem Kunden berechnete Betrag).
Legen Sie den MwSt.-Satz fest.
Optional geben Sie einen Barcode für Scanner-Unterstützung ein und fügen ein Foto hinzu.
Klicken Sie auf Speichern.

Der Anfangsbestand wird hier nicht festgelegt. Erfassen Sie die Anfangsmenge mit einem Wareneingang oder der Aktion Zählen auf der Registerkarte Lagerstatus. Ein Produkt kann auch direkt aus einer Belegzeile erstellt werden, wenn eine Lieferung einen Artikel enthält, der noch nicht im Katalog ist.

Produkt bearbeiten

Wählen Sie ein Produkt aus der Liste, um seinen Editor zu öffnen. Sie können jedes Feld aktualisieren, einschließlich Name, Preis, Kategorie, MwSt.-Satz, Barcode und Foto. Änderungen werden sofort wirksam. Bei einer Preisänderung gilt der neue Preis für alle zukünftigen Bestellungen. Die Aktion Aus dem Verkauf nehmen löscht das Produkt nach einer Bestätigung aus dem Katalog.

Vergangene Bestellungen werden von Preisänderungen nicht beeinflusst. Jede Bestellposition speichert den unit_price zum Zeitpunkt des Verkaufs als Snapshot.

Integration mit Bestellungen

Wenn ein Kassierer eine Bestellung erstellt und ein Produkt hinzufügt:

Der aktuelle Verkaufspreis und MwSt.-Satz des Produkts werden als Snapshots in die Bestellposition kopiert.
Die Positionssumme wird als Stückpreis * Menge berechnet.
Beim Abschluss der Bestellung wird der Lagerbestand des Produkts um die bestellte Menge verringert.
Ein Bestandsprotokoll-Eintrag mit reason = 'sale' wird erstellt und mit der Bestellung verknüpft.

Bei späterer Stornierung oder Erstattung der Bestellung kann der Bestand durch einen Rückgabe-Bestandsprotokoll-Eintrag wiederhergestellt werden.