Produkte¶
URL: /admin/products
Mindest-Rolle: super-admin
Was ist ein Produkt?¶
Ein Produkt ist ein logischer Namensraum, der Dokumente, Sessions und
Feedback gruppiert. Jedes Produkt hat eine eindeutige ID (String-Slug),
z.B. meldeschein. Der Chatbot kann so mehrere Produkthandbuecher
getrennt verwalten und beantworten.
Produkt-Tabelle¶
Die Tabelle zeigt alle Produkte (aktive und inaktive) mit folgenden Spalten:
| Spalte | Beschreibung |
|---|---|
| Name | Anzeigename des Produkts |
| Slug / ID | Eindeutige Kennung (URL-sicherer String) |
| Status | Aktiv oder Inaktiv |
| Dokumente | Anzahl aktiver Dokument-Versionen |
| Standard | Badge, falls es das Default-Produkt ist |
Neues Produkt anlegen¶
Beim Anlegen eines Produkts werden folgende Felder erwartet:
| Feld | Pflicht | Beschreibung |
|---|---|---|
| ID | Ja | Eindeutige Kennung |
| Name | Ja | Anzeigename |
| Description | Nein | Beschreibung |
| Slug | Nein | Auto-generiert aus dem Namen |
Auto-Slug¶
Der Slug wird automatisch aus dem Namen generiert. Dabei werden Umlaute konvertiert (ae statt ae, oe statt oe, ue statt ue, ss statt ss) und Sonderzeichen entfernt.
Produkt deaktivieren¶
Produkte werden nicht physisch geloescht, sondern deaktiviert (Soft-Delete). Ein deaktiviertes Produkt erscheint nicht mehr im Produkt-Switcher und kann nicht fuer neue Dokumente verwendet werden.
Endpoint: DELETE /admin/products/{product_id} (setzt is_active=False)
Standard-Produkt
Das Default-Produkt ist geschuetzt und kann nicht geloescht werden.
Produkt reaktivieren¶
Ein deaktiviertes Produkt kann ueber die PATCH-API reaktiviert werden:
Endpoint: PATCH /admin/products/{product_id} mit {"is_active": true}
Lizenz-Limit¶
Die Lizenz definiert die maximale Anzahl erlaubter Produkte (max_products):
| Tier | max_products |
|---|---|
| Basis | 1 |
| Professional | 1 |
| Enterprise | 99 |
Beim Versuch, mehr Produkte als erlaubt anzulegen, wird HTTP 402 zurueckgegeben.
API-Endpoints¶
| Methode | Endpoint | Beschreibung |
|---|---|---|
GET |
/admin/products |
Produkt-Verwaltungsseite (HTML) |
GET |
/admin/products.json |
Produktliste als JSON |
POST |
/admin/products |
Neues Produkt anlegen |
PATCH |
/admin/products/{id} |
Produkt aktualisieren |
DELETE |
/admin/products/{id} |
Produkt deaktivieren |