🇩🇪 Deutsch
================================================================================
  SELGORITHM — KASSENSYSTEM
  BENUTZERHANDBUCH
  Version 2026
================================================================================

--------------------------------------------------------------------------------
INHALTSVERZEICHNIS
--------------------------------------------------------------------------------
  1. Einführung und Systemübersicht
  2. Hauptvorteile
  3. Erste Schritte
  4. Kernfunktionen
     4.1  Produkterfassung und Barcode-Scanning
     4.2  Warenkorbverwaltung
     4.3  Zahlung und Verkaufsabwicklung
     4.4  Kundenverwaltung (Konten)
     4.5  Bestellung zurückstellen
     4.6  Produktverwaltung
     4.7  Typcode-System
     4.8  Treuekarten und Punkte
     4.9  Berichte
     4.10 Gewinnbericht
     4.11 Stornierung und Korrektur von Verkäufen
     4.12 Bewegungsbericht
     4.13 Finanz- und Personalmodul
     4.14 Lagerausgangsliste
     4.15 Datenimport / -export
     4.16 Bondruck
     4.17 Barcodeettikettendruck
  5. Administration
     5.1  Benutzerverwaltung
     5.2  Einstellungen und Themes
  6. Tastaturkürzel
  7. Datensicherheit und Backup
  8. Technische Hinweise

================================================================================
1. EINFÜHRUNG UND SYSTEMÜBERSICHT
================================================================================

Selgorithm ist eine professionelle, offline-fähige Kassensystem-Anwendung
(POS), die speziell für Buchhandlungen und Einzelhandelsunternehmen entwickelt
wurde. Aufgebaut auf einer modernen, lokal unter Windows laufenden
webbasierten Oberfläche, verbindet Selgorithm die Flexibilität einer
browserbasierten Benutzeroberfläche mit der Zuverlässigkeit und Geschwindigkeit
einer Desktop-Anwendung.

Selgorithm benötigt für den täglichen Betrieb keine Internetverbindung. Alle
Daten werden lokal in einer verschlüsselten SQLite-Datenbank gespeichert, sodass
Ihre Geschäftsdaten privat und auch ohne Netzwerkverbindung sofort zugänglich
bleiben.

Die Anwendung unterstützt 8 Sprachen, 13 visuelle Themes und mehrere
Währungsformate — geeignet für nationale und internationale Betriebe.

================================================================================
2. HAUPTVORTEILE
================================================================================

  GESCHWINDIGKEIT UND EFFIZIENZ
  ——————————————————————————————
  Barcode-Scanning schließt einen Verkauf in Sekunden ab. Tastaturkürzel
  eliminieren die Notwendigkeit, in Stoßzeiten zur Maus zu greifen, und
  reduzieren Transaktionszeit und Kassiermüdigkeit erheblich.

  DATENEIGENTUM
  ——————————————
  Ihre Daten verlassen Ihr Gerät nie. Keine Abonnementgebühren, keine
  Cloud-Abhängigkeit, kein Risiko von Dienstunterbrechungen. Vollständiges
  Eigentum an Ihrem Verkaufsverlauf, Kundendaten und Inventar jederzeit.

  GEWINNTRANSPARENZ
  ——————————————————
  Der integrierte Gewinnbericht berechnet den Nettogewinn pro Tag, Woche,
  Monat und Jahr durch Vergleich von Verkaufspreisen mit Einkaufskosten.
  So können Inhaber ertragreiche Zeiträume identifizieren und fundierte
  Bestellentscheidungen treffen.

  KUNDENBEZIEHUNGEN
  ——————————————————
  Das Treuekarten- und Punktesystem fördert Stammkunden. Detaillierte
  Kontoerfassung (Kreditverkäufe) hilft, Kreditkunden und ausstehende Salden
  transparent zu verwalten.

  MEHRBENUTZERZUGRIFFSKONTROLLE
  ——————————————————————————————
  Rollenbasierter Zugriff (Admin vs. Personal) stellt sicher, dass Kassierer
  nur erlaubte Operationen durchführen können, während Manager die vollständige
  Kontrolle über sensible Funktionen wie Stornierungen, Berichte und Konfiguration
  behalten.

  BESTANDSKONTROLLE
  ——————————————————
  Automatische Bestandsaktualisierungen bei jedem Verkauf und jeder Stornierung.
  Niedrigbestandswarnungen verhindern Ausverkäufe bei beliebten Titeln. Die
  Lagerausgangsliste erstellt ein druckbares PDF mit allen verkauften Artikeln
  in einem beliebigen Datumsbereich.

================================================================================
3. ERSTE SCHRITTE
================================================================================

  ERSTSTART
  —————————
  Beim ersten Start werden Sie durch einen Einrichtungsassistenten geführt, um
  Folgendes zu konfigurieren:
    - Firmenname und Logo-Emoji
    - Standardsprache und Währung
    - Administrator-Benutzername und Passwort

  ANMELDEN
  ————————
  Navigieren Sie zur Anmeldeseite und geben Sie Ihre Anmeldedaten ein. Verwenden
  Sie die Option "Angemeldet bleiben" auf gemeinsam genutzten Geräten nur, wenn
  dies Ihrer Sicherheitsrichtlinie entspricht.

  GERÄTEKOMPATIBILITÄT
  ———————————————————
  Selgorithm erkennt Ihren Gerätetyp automatisch und lädt ein optimiertes Layout:
    - Desktop: Vollständiges Zweipanel-Layout
    - Tablet: Angepasstes Layout mit ausklappbarer Navigationsleiste
    - Mobil: Kompakte, touch-optimierte Oberfläche

================================================================================
4. KERNFUNKTIONEN
================================================================================

4.1  PRODUKTERFASSUNG UND BARCODE-SCANNING
——————————————————————————————————————————
  Scannen Sie einen Produktbarcode mit einem USB- oder Bluetooth-Barcodescanner,
  oder tippen Sie den Barcode manuell in das Barcode-Eingabefeld. Das Produkt wird
  sofort aus der Datenbank abgerufen und dem Warenkorb hinzugefügt.

  VORTEIL: Barcode-Scanning eliminiert manuelle Preiseingabefehler und reduziert
  die Transaktionszeit auf unter 2 Sekunden pro Artikel, auch bei großen Inventaren.

  - Drücken Sie F4, um sofort den Fokus auf das Barcode-Eingabefeld zu setzen.
  - Drücken Sie F3, um Produkte nach Name zu suchen, wenn kein Barcode verfügbar ist.


4.2  WARENKORBVERWALTUNG
————————————————————————
  Der Warenkorb zeigt alle gescannten Artikel mit bearbeitbaren Feldern für
  Menge, Rabatt und Einzelpreis. Klicken Sie auf eine Zelle, um sie inline
  zu bearbeiten.

  VORTEIL: Echtzeit-Warenkorbbearbeitung ermöglicht Kassierern, benutzerdefinierte
  Rabatte anzuwenden, Mengen zu korrigieren und Preise anzupassen, ohne die
  Transaktion neu zu starten.

  - Wählen Sie eine Zeile und drücken Sie F2, um das vollständige
    Produktbearbeitungsmodal zu öffnen.
  - Verwenden Sie Ctrl+↓ / Ctrl+↑, um mit der Tastatur zwischen Warenkorbzeilen
    zu navigieren.
  - Rechtsklick auf eine Zeile für Kontextmenüoptionen (bearbeiten / löschen).


4.3  ZAHLUNG UND VERKAUFSABWICKLUNG
——————————————————————————————————
  Selgorithm unterstützt drei Zahlungsmethoden:

    BAR (F8)          — Sofortige Barzahlung. Bestand wird reduziert,
                         Tagesumsatzzähler wird aktualisiert.
    KARTE (F9)        — Kredit-/Debitkartenzahlung. Gleicher Prozess wie bar.
    KREDIT (F6)       — Aufgeschobene Zahlung auf ein Kundenkonto. Erstellt
                         automatisch einen Schuldeneintrag im Kundenbuch. Nur
                         verfügbar, wenn ein Kunde ausgewählt ist.

  VORTEIL: Flexible Zahlungsoptionen unterstützen alle Einzelhandelsszenarien.
  Kreditverkäufe ermöglichen formelles Kontomanagement ohne externe
  Buchhaltungssoftware.


4.4  KUNDENVERWALTUNG (KONTEN)
————————————————————————————
  Fügen Sie Kundenkonten zur Kreditverfolgung hinzu und verwalten Sie diese.
  Jeder Kunde hat ein Hauptbuch mit allen Kreditverkäufen, Zahlungen und Salden.

  VORTEIL: Ersetzen Sie Papierbücher durch durchsuchbare, stets genaue digitale
  Aufzeichnungen des ausstehenden Saldos und der Transaktionshistorie jedes Kunden.

  - Kunden aus dem Einstellungsmenü umbenennen oder löschen.
  - Kundenkonten sind direkt mit Kreditverkäufen integriert.


4.5  BESTELLUNG ZURÜCKSTELLEN (F7)
———————————————————————————————————
  Speichern Sie einen teilweise abgeschlossenen Warenkorb in der Warteschlange,
  während Sie einen anderen Kunden bedienen. Zurückgestellte Bestellungen werden
  im rechten Panel aufgelistet und können jederzeit wiederhergestellt werden.

  VORTEIL: Eliminiert verlorene Verkäufe durch Kundenunterbrechungen. Kassierer
  können mehrere Transaktionen gleichzeitig bearbeiten, ohne Datenverlust.


4.6  PRODUKTVERWALTUNG
——————————————————————
  Jeder Produktdatensatz enthält:
    - Barcode, Titel, Verlag
    - Listenpreis (Coverpreis)
    - Einkaufsrabatt (Kostenbasis für Gewinnberechnung)
    - Händlerrabatt
    - Kundenrabatt
    - Aktueller Bestandslevel
    - Typcode (Kategorie)
    - Coverbild

  Rechtsklick auf ein gescanntes Produkt, um seine Details zu bearbeiten.

  VORTEIL: Zentrale Produktdaten sorgen für konsistente Preisgestaltung bei
  allen Transaktionen. Die Einkaufsrabattintegration ermöglicht automatisches
  Gewinntracking ohne manuelle Kosteneingaben.


4.7  TYPCODE-SYSTEM
————————————————————
  Weisen Sie 1–3 Zeichen lange Typcodes zu, um Produkte zu kategorisieren
  (z.B. R = Roman, T = Test/Lernmaterial, C = Kinder). Erstellen Sie unbegrenzte
  benutzerdefinierte Codes mit benutzerdefinierten Farben über Einstellungen →
  Typcodes verwalten.

  VORTEIL: Typcodes ermöglichen gefilterte Lagerausgangslisten und erlauben
  Lagermitarbeitern, nur die für ihren Arbeitsbereich relevanten Produktkategorien
  zu sehen.


4.8  TREUEKARTEN UND PUNKTE
—————————————————————————————
  Stellen Sie physische Treuekarten mit eindeutigen Kartennummern aus. Punkte
  werden automatisch auf Basis eines konfigurierbaren Verdienstbetrags pro Kauf
  gesammelt. Sehen Sie die Gesamtpunkte und Transaktionshistorie jedes Kunden
  im Finanzmodul.

  VORTEIL: Treueprogramme erhöhen die Wiederkaufrate. Das automatisierte
  Punktesystem erfordert keine manuelle Verfolgung und integriert sich nahtlos
  in die Verkaufsabwicklung.


4.9  BERICHTE — DATUMSBEREICH-VERKAUFSBERICHT
——————————————————————————————————————————————
  Zugriff über Berichte → Datumsberichtsbericht. Wählen Sie ein beliebiges
  Start- und Enddatum, um eine vollständige Liste der Verkäufe zu erstellen,
  einschließlich: Datum, Barcode, Titel, Verlag, Menge, Einzelpreis, Rabatt,
  Gesamt, Kunde und Zahlungsart.

  VORTEIL: Sofortiger Zugriff auf historische Verkaufsdaten für jeden Zeitraum.
  Export nach Excel für weitere Analysen oder Buchhaltungsintegration. Direkt aus
  dem Browser für physische Aufzeichnungen drucken.


4.10 GEWINNBERICHT
——————————————————
  Zugriff über Berichte → Gewinnbericht. Aggregierte Gewinndaten über vier
  Zeitskalen anzeigen: Täglich, Wöchentlich, Monatlich, Jährlich.

  Jede Zeile zeigt: Zeitraum | Menge | Umsatz | Kosten | Gewinn | Marge%
  Zusammenfassungskarten zeigen Gesamtumsatz, Kosten, Nettogewinn und
  Durchschnittsmarge.

  Gewinn = Umsatz − (Menge × Listenpreis × (1 − Einkaufsrabatt%))

  VORTEIL: Echtzeit-Rentabilitätsdaten ohne Buchhalter. Identifizieren Sie,
  welche Zeiträume, Jahreszeiten oder Monate die höchsten Margen erzielen.
  Vergleichen Sie die wöchentliche Leistung, um Bestell- und
  Personalentscheidungen zu optimieren.


4.11 STORNIERUNG UND KORREKTUR VON VERKÄUFEN
—————————————————————————————————————————————
  STORNIERUNG: Suchen Sie einen vergangenen Verkauf nach Barcode. Überprüfen
  Sie die Verkaufsdetails und bestätigen Sie die Stornierung. Der stornierte
  Datensatz wird archiviert, der Bestand automatisch wiederhergestellt und der
  Umsatz angepasst.

  KORREKTUR: Verschiebt die Artikel eines vergangenen Verkaufs zurück in den
  aktiven Warenkorb zur Neupreisgestaltung oder erneuten Erfassung vor dem
  erneuten Verkauf zu korrigierten Werten.

  VORTEIL: Audit-sichere Korrekturen ohne dauerhafte Datenlöschung. Stornierte
  Verkäufe werden in einem separaten Archiv für Compliance und Überprüfung
  aufbewahrt.


4.12 BEWEGUNGSBERICHT
——————————————————————
  Zugriff über Berichte → Bewegungen. Scannen oder geben Sie einen Barcode ein,
  um die letzten 7 Tage der Verkaufsaktivität für dieses spezifische Produkt
  anzuzeigen, einschließlich täglich verkaufter Menge.

  VORTEIL: Schnelle Identifizierung von schnelldrehenden Waren, um die
  Nachbestellung zu priorisieren, bevor ein Ausverkauf eintritt.


4.13 FINANZ- UND PERSONALMODUL
————————————————————————————
  Zugriff über Admin → Finanzen & Personal (/finans).

  Funktionen:
    - Personalverwaltung: Mitarbeiter hinzufügen, Arbeitszeiten erfassen
      (Überstundenunterstützung)
    - Gehaltszahlungen: Zahlungshistorie pro Mitarbeiter erfassen und verfolgen
    - Ausgabenverfolgung: Geschäftsausgaben nach Kategorie erfassen
    - Tägliche Finanzzusammenfassung: Umsatz, Ausgaben, Nettosaldo
    - Kundenkonten: vollständiges Soll-/Habenbuch pro Kunde
    - Finanzdaten nach Excel exportieren

  VORTEIL: Vollständiger Kleinunternehmensfinanzüberblick auf einem einzigen
  Bildschirm. Keine separate Gehaltsabrechnungs- oder Ausgabensoftware für
  kleine Teams erforderlich.


4.14 LAGERAUSGANGSLISTE (eksik-listesi)
—————————————————————————————————————
  Zugriff über Admin → Fehlerliste. Wählen Sie einen Datumsbereich und
  Produkttypfilter, um ein druckbares PDF mit allen verkauften Artikeln
  (Lagerausgangs-/Kommissionierliste) zu erstellen.

  VORTEIL: Stellt Lagermitarbeitern eine klare, typgefilterte Kommissionierliste
  direkt aus den Verkaufsdaten bereit — eliminiert manuelle Listenerstellung
  und reduziert Auftragserfüllungsfehler.


4.15 DATENIMPORT / -EXPORT
——————————————————————————
  Zugriff über das Datenmenü.

  EXPORT:
    - Bestandsliste nach Excel (.xlsx)
    - Verkaufsbericht nach Excel für beliebigen Datumsbereich
    - Vollständiges Datenbank-Backup (.db-Datei)

  IMPORT:
    - Massenproduktimport über Excel-Vorlage
    - Vorschaumodus zeigt potenzielle Probleme vor der Anwendung
    - Datenbankwiederherstellung aus Backup

  VORTEIL: Nahtlose Integration in Excel-basierte Workflows. Massenprodukterfassung
  reduziert die Einrichtungszeit für neue Filialen erheblich. Regelmäßige
  Backups schützen vor Datenverlust.


4.16 BONDRUCK
——————————————
  Konfigurieren Sie Ihren Thermodrucker unter Einstellungen → Boneinstellungen.
  Bons enthalten Firmenname, Unterüberschrift, Artikelwarenliste, Gesamtbeträge,
  Rabattzusammenfassung und Kundeninformationen.

  VORTEIL: Professionelle Bons stärken das Kundenvertrauen und liefern für
  beide Seiten einen physischen Nachweis jeder Transaktion.


4.17 BARCODE-ETIKETTENDRUCK
——————————————————————————
  Klicken Sie im Produktbearbeitungsmodal auf die Druckschaltfläche, um den
  Barcode-Etikettendesigner zu öffnen. Wählen Sie Etikettengröße, Menge und
  Layout. Direkt auf jeden angeschlossenen Drucker drucken.

  VORTEIL: Hausinterner Etikettendruck eliminiert die Abhängigkeit von
  vorgedruckten Etiketten und ermöglicht sofortige Neubeschriftung bei
  Preisänderungen.

================================================================================
5. ADMINISTRATION
================================================================================

5.1  BENUTZERVERWALTUNG
—————————————————————————
  Admin-Benutzer können Mitarbeiterkonten unter /admin/users erstellen,
  bearbeiten und löschen. Zwei Rollen sind verfügbar:

    ADMIN    — Vollständiger Zugriff auf alle Funktionen einschließlich Berichte,
               Stornierungen, Benutzerverwaltung und Konfiguration.
    PERSONAL — Zugriff nur auf Verkäufe, Warenkorb, Zurückstellungen und
               Kundenauswahl.

  VORTEIL: Rollentrennung verhindert unbefugten Zugriff auf sensible Funktionen
  wie Finanzberichte und Verkaufsstornierungen.


5.2  EINSTELLUNGEN UND THEMES
———————————————————————————
  Zugriff über Admin → Einstellungen.

    - Firmenname und Logo-Emoji
    - Anzeigesprache (8 Optionen)
    - Visuelles Theme (13 Optionen)
    - Währungssymbol
    - Niedrigbestand-Warnschwelle
    - Standard-Kundenname
    - Typcode-Verwaltung

  VORTEIL: Vollständige Personalisierung stellt sicher, dass die Oberfläche
  Ihre Marke widerspiegelt und sich für Ihr Team vom ersten Tag an vertraut
  anfühlt.

================================================================================
6. TASTATURKÜRZEL
================================================================================

  TASTE       AKTION
  ——————————  ————————————————————————————————————————
  F1          Tastaturkürzel-Referenz öffnen
  F2          Ausgewähltes Produkt bearbeiten (Warenkorbzeile muss ausgewählt sein)
  F3          Produktsuche nach Name öffnen
  F4          Fokus auf Barcode-Eingabefeld (alles auswählen)
  F5          Seite neu laden
  F6          Kreditverkauf verarbeiten
  F7          Aktuelle Bestellung zurückstellen
  F8          Barverkauf verarbeiten
  F9          Kartenbestellung verarbeiten
  F11         Vollbildmodus umschalten
  Ctrl+↓      Auswahl zur nächsten Warenkorbzeile bewegen
  Ctrl+↑      Auswahl zur vorherigen Warenkorbzeile bewegen
  Enter       Barcode bestätigen / Zellenbearbeitung bestätigen
  Escape      Inline-Bearbeitung abbrechen / Modal schließen
  ↑ / ↓       In bearbeitbarer Zelle navigieren

================================================================================
7. DATENSICHERHEIT UND BACKUP
================================================================================

  Alle Daten werden lokal gespeichert unter:
    %LOCALAPPDATA%\Selgorithm_Web\

  Sitzungsgeheimnisse werden beim ersten Start automatisch generiert und lokal
  gespeichert. Es werden keine Daten an externe Server übertragen.

  EMPFOHLENER BACKUP-ZEITPLAN:
    - Täglich: Datenbank-Backup über Daten → Backup exportieren
    - Wöchentlich: Den Selgorithm_Web-Ordner auf ein externes Laufwerk oder
      einen Cloud-Speicherdienst Ihrer Wahl kopieren

  WIEDERHERSTELLUNG: Verwenden Sie Daten → Datenbank wiederherstellen, um eine
  frühere Backup-Datei zu laden.

================================================================================
8. TECHNISCHE HINWEISE
================================================================================

  - Läuft auf Python 3.10+ mit Flask-Web-Framework
  - Datenbank: SQLite (einzelne .db-Datei, portabel)
  - Oberfläche: WebView2 (Windows-integriert) rendert einen lokalen Webserver
  - Mindest-Betriebssystem: Windows 10 (64-Bit)
  - Keine Internetverbindung für den Betrieb erforderlich
  - Mehrgerätebetrieb im lokalen Netzwerk möglich (Ihren Händler kontaktieren)

================================================================================
  © 2026 Selgorithm. Alle Rechte vorbehalten.
================================================================================