# RiccardoLive – echte Zahlen auf der Artikelseite

Zeigt drei Angaben, **alle echt**:

* **Besucher, die den Artikel gerade ansehen** – gezählt aus tatsächlichen Aufrufen
* **Verkäufe im Zeitraum** – Stückzahl aus Bestellpositionen (abgebrochene Bestellungen zählen nicht)
* **knapper Bestand** – „Nur noch X auf Lager", wenn der Bestand unter der Schwelle liegt

Erfundene Zahlen gibt es hier nicht: was unter dem Schwellwert liegt, wird gar nicht
angezeigt. Eine erfundene Zahl wäre eine irreführende geschäftliche Handlung
(UWG § 5, Omnibus-Richtlinie) und kann abgemahnt werden.

## Wie gezählt wird

`riccardo_product_view` hält je Besucher und Artikel **einen Zeitstempel** und einen
**Hash des Session-Tokens** (SHA-256, auf 16 Byte gekürzt) – keine IP, kein Name, keine
Kundennummer. Einträge, die älter als das dreifache Zeitfenster sind, werden bei jedem
Aufruf gelöscht; die Tabelle bleibt dadurch klein.

Gezählt werden **verschiedene** Besucher im Zeitfenster (Standard 10 Minuten). Varianten
zählen zum Elternartikel mit, sonst zerfallen die Zahlen auf die Sorten.

Bei der Verkaufszahl greift ein Rückfall über die Artikelnummer: in älteren
Bestellpositionen kann die Produkt-Verknüpfung leer sein (der Artikel wurde später neu
angelegt). Varianten-Nummern mit Punkt-Suffix (`RZ-10039.2`) werden dem Elternartikel
zugeschlagen.

## Einstellungen

*Einstellungen → Erweiterungen → Riccardo Live-Zahlen* (je Verkaufskanal): Zeitfenster,
Mindestzahl Betrachter, Zeitraum und Mindestzahl der Verkäufe, Schwelle für den
Bestandshinweis (0 = aus) und ein Schalter für die ganze Anzeige.

## Technik

Die Zahlen kommen per JavaScript von
`/widgets/riccardo/artikel/{productId}/aktivitaet` (Antwort `no-store`, ohne
anzeigbare Zahlen HTTP 204) und werden jede Minute aktualisiert – die Artikelseite
selbst bleibt damit cachebar. Derselbe Aufruf zählt den eigenen Besuch mit.