Funktions-Handbuch

Endkunden- und Pilotkunden-Handbuch. Erklaert den sellx Hub Schritt-fuer-Schritt mit Screenshots.

5 Artikel · Plattform-Uebersicht

Der sellx Hub ist eine lokale Desktop-Anwendung fuer JTL-Wawi-Nutzer, die ihre Standard-Reports, Ad-hoc-Abfragen und wiederkehrenden Daten-Pflege-Aufgaben in einer modernen Oberflaeche buendelt — ohne Cloud-Zwang, ohne SQL-Skripte im Editor, ohne das Rad fuer jedes Team neu zu erfinden.

Plugins werden als .sellxpkg -Dateien installiert, koennen pro Pilotkunde aktiviert oder deaktiviert werden und bringen ihre eigene Parametrisierung, ihre eigenen SQL-Queries (oder andere Backend-Logik) und ihre eigenen Berechtigungen mit.

Lokal & offline-faehig

SQL bleibt auf dem Kunden-Server. Nur Heartbeat & Lizenz gehen in die Cloud.

Plugin-basierte Erweiterung

4 Plugin-Kategorien, alle als .sellxpkg installierbar.

Setup-Wizard & Lizenz

4-Schritte-Onboarding, Hardware-gebundene Lizenz, 30 Tage Grace.

Vier Plugin-Kategorien

Jedes Plugin gehoert zu genau einer dieser vier Kategorien — die Kategorie bestimmt, was das Plugin tun darf und wie es im Hub dargestellt wird.

SQL-Report
Ad-hoc-Abfragen gegen die JTL-Wawi-Datenbank. Parametrisierbar, mit Berechtigungs-Pruefung pro Plugin-Manifest.
Beispiel: Artikel-KPI pro Kategorie, Top-Kunden nach Umsatz, Offene Aufträge.
Dashboard
Mehrere Visualisierungen auf einer Seite. Charts, KPIs, Filter — alles in einer konfigurierbaren Ansicht.
Beispiel: Vertriebs-Dashboard mit Tagesumsatz, Top-Artikeln und Retourenquote.
Daten-Tool
Interaktive Werkzeuge fuer wiederkehrende Daten-Pflege: Export-Filter, Massen-Updates, Stammdaten-Bereinigung.
Beispiel: Artikel-Etiketten-Generator, Kunden-Massen-Mail-Vorbereitung.
Automation
Schreibt zurueck in die JTL-DB (db_datawriter + DDL erforderlich). Zeitgesteuerte Jobs oder manuelle Trigger.
Beispiel: Taeglicher Bestandsabgleich, automatisches Re-Hosting von Bildern.

Wie der Hub aufgebaut ist

Drei Schichten, klar getrennt: Eine Rust-Shell startet den Sidecar-Prozess, das React-Frontend rendert die UI, der .NET 8-Sidecar macht die eigentliche Arbeit (SQL, Lizenz, Plugins).

textarchitektur.txt

┌──────────────────────────────────────────────────────────┐
│  sellx Hub (auf Kunden-Server)                           │
│                                                          │
│  ┌───────────────────┐    ┌─────────────────────────────┐ │
│  │ Tauri Shell       │    │  .NET 8 Sidecar (Kestrel)   │ │
│  │  - WebView2       │◄──►│  - SQL-Executor             │ │
│  │  - Sidecar-Spawn  │    │  - License Validator        │ │
│  │  - IPC-Bridge     │    │  - Plugin-Engine            │ │
│  │  - Auto-Updater   │    │  - Hardware-Fingerprint     │ │
│  └────────┬──────────┘    └──────────┬──────────────────┘ │
│           │                           │                    │
│  ┌────────▼──────────┐                │                    │
│  │  React Frontend   │                │                    │
│  │  - shadcn/ui      │                │                    │
│  │  - TanStack Query │                │                    │
│  │  - Recharts       │                │                    │
│  └───────────────────┘                │                    │
└────────────────────────────────────────┼────────────────────┘
                                         │
              ┌──────────────────────────┼──────────────┐
              ▼                          ▼              ▼
    ┌──────────────────┐       ┌──────────────────┐  ┌──────────────┐
    │ JTL-Wawi SQL     │       │ sellx Central    │  │ Lokale       │
    │ Server (extern)  │       │ (Cloud)          │  │ SQLite       │
    │ eazybusiness     │       │ Katalog, Lizenz, │  │ data.db      │
    │ tArtikel, ...    │       │ Heartbeat        │  │              │
    └──────────────────┘       └──────────────────┘  └──────────────┘

Die Frontend-Schicht enthaelt bewusst keine Geschaeftslogik — sie rendert nur und ruft ueber Tauri-IPC oder lokales HTTP den Sidecar. SQL-Queries und Lizenzpruefungen laufen ausschliesslich im Sidecar, was die Auditierbarkeit und die Hardware-Bindung vereinfacht.

So nutzen Sie den Hub

Der typische Anwender-Workflow ist kurz — die meisten Pilotkunden sind in unter 15 Minuten produktiv.

1
Setup-Wizard durchlaufen (DB-Verbindung, Verbindungstest, Konto-Aktivierung). Die JTL-Registry wird automatisch ausgelesen.
2
Plugin installieren (entweder aus dem Marketplace oder per .sellxpkg-Datei). Berechtigungen werden aus dem Manifest gelesen und angezeigt.
3
Plugin als Tab oeffnen (im Workspace), Parameter eingeben, Ergebnis-Tabelle oder Chart ansehen, ggf. als CSV exportieren.
4
Einstellungen pruefen (DB-Status, Heartbeat zur sellx-Central, Log-Viewer bei Fehlern).

So sieht der Hub aus

Sobald der Setup-Wizard durchlaufen ist, oeffnet sich das Dashboard mit Sidecar-Status, installierten Plugins und Quick-Actions.

sellx Hub Dashboard nach Setup-Wizard — Dashboard nach Setup-Wizard — Sidecar-Status, Plugin-Liste und Quick-Actions.

Mehr erfahren

Diese Uebersicht ist bewusst kurz gehalten. Fuer Details zu einzelnen Bereichen springen Sie direkt in die jeweilige Schritt-fuer-Schritt-Anleitung.

SQL-Report

Dashboard

Daten-Tool

Automation