Airtime je Händler, Jahresbonus-Staffel, Export überarbeitet, natives Windows-Fenster

- Airtime: Auszahlung in % je Händler (0 % = keine). Im Export als eine Summenzeile,
  die Einzelposten in einer eigenen Airtime-Liste (zweite Excel-Datei).
- Jahresbonus Neuaktivierung: Betrag je Karte nach Staffel (Standard 1-9: 5 € ... ab 40: voll),
  Standard-Staffel änderbar, eigene Staffel je Händler möglich.
- Provisionsarten: Airtime/Jahresbonus werden erkannt, Behandlung je Provisionsart umstellbar.
- Export: freenet und Vodafone standardmäßig in einer Datei, Positionen mit 0,00 € weglassen.
- Händler-Dialog: GROSSBUCHSTABEN-Regel als Häkchen (ging verloren, wenn „Hinzufügen“ vergessen wurde).
- Windows: Hauptfenster ist ein echtes Programmfenster mit unsichtbarem Rahmen – Andocken am
  Bildschirmrand, Win+Pfeiltasten und natives Größe-Ziehen; Trennsteg baut erst beim Loslassen neu auf.
- DB-Schema v3 (Migration), Tests für alles Neue.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.gitea/workflows/windows-build.yml

@@ -14,6 +14,7 @@ jobs:
   windows-exe:
     # Label ggf. an euren Runner anpassen (Runner braucht Docker; Wine steckt im Container-Image).
     runs-on: ubuntu-latest
+    timeout-minutes: 30   # normal ca. 5 Minuten – ein Hänger darf den Runner nicht stundenlang belegen
     container:
       image: tobix/pywine:3.12
     env:

.gitignore

@@ -13,3 +13,6 @@ dist/
 build/tmp/
 build/version_info.txt
 *.db
+selbsttest.txt
+/*.jpg
+/*.png

README.md

@@ -5,14 +5,31 @@ von **freenet** (CSV/Excel) und **Vodafone/Euronics** (Excel) ein, ordnet die Po
 Unterhändlern zu, erlaubt freie Anpassung der Auszahlung und exportiert je Händler eine
 fertige Excel-Abrechnung. Optik: Windows 95.
 
+## Erster Start
+
+Beim ersten Start führt ein **Einrichtungs-Assistent** durch Speicherort, Unterhändler
+(inkl. „Nummern aus Abrechnung vorschlagen“) und die erste Abrechnung. Danach zeigt ein
+**Rundgang** mit Hinweis-Sprechblasen die wichtigsten Stellen. Beides sowie den
+**Tipp des Tages** gibt es jederzeit im Menü **?**.
+
+Die Windows-95-Titelleiste ist selbst gezeichnet (Windows lässt die echte nicht umfärben).
+Falls sie auf einem PC Probleme macht: *Datei ▸ Einstellungen ▸ Darstellung* – dann wird die
+normale Windows-Titelleiste verwendet.
+
 ## Bedienung in Kürze
 
-1. **Händler anlegen** (`Strg+H`): Name, Standard-Auszahlung in % und die *Kennungen*:
+1. **Händler anlegen** (`Strg+H`): Name, Standard-Auszahlung in %, **Airtime in %** (0 % = keine
+   Airtime) und die *Kennungen*:
    - freenet → Spalte **Unterhaendler** (z. B. `11111102`)
-   - Vodafone → Spalte **Vo-Nr** (z. B. `80000002`, `EU000001`) **oder**
+   - Vodafone → Spalte **Vo-Nr** (z. B. `80000002`, `EU000001`) **oder** das Häkchen
-     „Vodafone (Name in GROSSBUCHSTABEN)“: alle Vodafone-Positionen, deren Kundenname komplett
+     „Vodafone-Kunden mit Nachnamen in GROSSBUCHSTABEN“: alle Vodafone-Positionen, deren Kundenname
-     großgeschrieben ist (so erfasst unser Unterhändler seine Kunden). Diese Regel kann nur ein
+     komplett großgeschrieben ist (so erfasst unser Unterhändler seine Kunden). Diese Regel kann nur
-     Händler haben und hat Vorrang vor der Vo-Nr.
+     ein Händler haben und hat Vorrang vor der Vo-Nr.
+   - **Jahresbonus Neuaktivierung**: Betrag je Karte nach Staffel, abhängig von der Anzahl Karten des
+     Händlers in der Abrechnung. Standard (änderbar unter *Händler ▸ Standard-Staffel Jahresbonus…*):
+     1–9 Karten 5 €, 10–14 10 €, 15–19 15 €, 20–24 20 €, 25–29 25 €, 30–34 30 €, 35–39 35 € je Karte,
+     ab 40 der volle Betrag. Je Händler kann eine eigene Staffel hinterlegt werden. Nie mehr als die
+     Provision laut Abrechnung; Stornos zählen ab.
    Ein Händler kann mehrere Kennungen haben, auch bei beiden Anbietern.
    Einzelne Fehltreffer: Positionen markieren → Rechtsklick ▸ **Händler zuweisen…**
    (feste Zuweisung, Vorrang vor allem anderen; zurück mit „Automatisch zuordnen“).
@@ -21,14 +38,22 @@ fertige Excel-Abrechnung. Optik: Windows 95.
    eines Monats plus die Vodafone-Datei. Das Format wird an der Kopfzeile erkannt.
    Doppelt importierte Dateien werden erkannt. Unbekannte Kennungen erscheinen unter
    „(Nicht zugeordnet)“ und lassen sich direkt einem Händler zuordnen.
-4. **Prüfen und anpassen**: links Händler wählen, rechts sind die Positionen nach
+4. **Eigene Filiale ausblenden**: Positionen eurer eigenen Kennungen (z. B. freenet `11111100`,
+   Vodafone `80000001`) müssen nicht verprovisioniert werden. Rechtsklick auf eine nicht zugeordnete
+   Gruppe ▸ *Kennung als eigene ausblenden* (oder *Händler ▸ Eigene Kennungen…* bzw. direkt im
+   Import-Bericht). Sie verschwinden aus Liste, Summen und Export und stehen grau unter
+   „(Eigene – ausgeblendet)“. Händler-Zuordnungen (auch GROSSBUCHSTABEN) haben Vorrang.
+5. **Prüfen und anpassen**: links Händler wählen, rechts sind die Positionen nach
    Provisionsart gruppiert.
    - Gruppe markieren → **Prozent…** (`F4`): Auszahlung für die ganze Provisionsart; auf Wunsch
      als feste Regel für diesen Händler gespeichert (gilt dann für künftige Importe).
    - Doppelklick / `F2` auf eine Position: Betrag frei überschreiben
      (`Enter` speichern, `↓`/`Tab` nächste Zeile, `Esc` abbrechen). Blau = von Hand geändert.
    - Rechtsklick: u. a. „Auszahlung 0 €“.
-5. **Export** (`Strg+E`): je Händler (und je Anbieter) eine `.xlsx` im Format der Vorlage:
+6. **Export** (`Strg+E`): je Händler eine `.xlsx` im Format der Vorlage – freenet und Vodafone
+   zusammen (auf Wunsch getrennt), **Airtime nur als eine Summenzeile** „Airtime“ – plus eine
+   eigene **Airtime-Liste** (`<Händler> - Airtime - <Titel>.xlsx`). Positionen mit 0,00 € werden
+   weggelassen (abschaltbar):
 
    | A | B | C | D | E | F | G | H | I | J | K | L | M | N |
    |---|---|---|---|---|---|---|---|---|---|---|---|---|---|
@@ -37,6 +62,14 @@ fertige Excel-Abrechnung. Optik: Windows 95.
    Sortierung: Zeitraum → Provisionsart → Datum, darunter eine Summenzeile.
    Kopfzeile optional zuschaltbar.
 
+Welche Provisionsart Airtime bzw. Jahresbonus ist, erkennt das Programm an den Texten (z. B.
+„AirTime Provision“, „Umsatzbeteiligung“, „Jahresbonus“); umstellbar je Provisionsart unter
+*Händler ▸ Provisionsarten…*.
+
+Das Hauptfenster ist unter Windows ein echtes Programmfenster mit Win95-Optik: an den Bildschirmrand
+ziehen (Andocken), `Win`+Pfeiltasten, Doppelklick auf die Titelleiste und Ziehen am Rand funktionieren
+wie gewohnt.
+
 Alles wird sofort in der Datenbank gespeichert (`%APPDATA%\Provisionsmanager95\provisionen.db`).
 Speicherort änderbar unter *Datei ▸ Einstellungen*, Datensicherung über *Datei ▸ Datensicherung*.
 
@@ -75,6 +108,8 @@ Aufbau:
 | `provtool/export.py` | Excel-Export im Zielformat |
 | `provtool/money.py` | Beträge (intern immer in Cent) |
 | `provtool/gui/` | Oberfläche (Tkinter im Win95-Stil) |
+| `provtool/gui/rahmen.py` | selbst gezeichnete Titelleiste, Menüleiste, Größenänderung |
+| `provtool/gui/assistent.py` | Einrichtungs-Assistent, Rundgang, Tipp des Tages |
 
 **Datenschutz:** Echte Abrechnungen enthalten Kundendaten und gehören nicht ins Repository
 (`.gitignore` schließt `*.csv`, `*.xlsx` im Hauptordner und `beispieldaten/` aus).
@@ -84,9 +119,17 @@ Aufbau:
 Gitea Actions (`.gitea/workflows/windows-build.yml`) baut die `.exe` im Container
 `tobix/pywine:3.12` (Windows-Python unter Wine) mit PyInstaller:
 
-- jeder Push: Tests unter Windows-Python + `Provisionsmanager95.exe` als Artefakt
+- jeder Push: alle Tests unter Windows-Python (Wine) **inklusive Oberflächen-Tests** auf einem
+  virtuellen Bildschirm, danach `Provisionsmanager95.exe` bauen und mit
+  `Provisionsmanager95.exe --selbsttest` die **fertige .exe** prüfen; erst dann gibt es das Artefakt
 - Tag `vX.Y.Z` (passend zu `provtool/__init__.py`): zusätzlich ein Gitea-Release mit `.exe` und `.zip`
 
+Die Oberflächen-Tests (`tests/test_gui.py`) bedienen die echte Oberfläche: Dialoge öffnen,
+Programm schließen, während Assistent/Rückfragen/Rundgang offen sind, Alt+F4, Beträge ändern usw.
+Jede Ausnahme in der Oberfläche und jeder Eintrag in `fehler.log` lässt sie fehlschlagen; ein
+Watchdog bricht hängende Tests ab, statt den Build zu blockieren. Ohne Bildschirm werden sie lokal
+übersprungen, im Build (`PROVTOOL_GUI_TESTS=1`) ist das ein Fehler.
+
 Lokal geht dasselbe mit Docker:
 
 ```bash

build/build_windows.sh

@@ -9,11 +9,25 @@ export LANG=C.UTF-8 LC_ALL=C.UTF-8   # sonst kann Wine keine Umlaute in Dateinam
 export WINEPREFIX="${WINEPREFIX:-/opt/wineprefix}"
 PY="wine python"
 
+# Ein virtueller Bildschirm für den GANZEN Build – vor dem ersten Wine-Aufruf starten!
+# Wine bindet seinen Hintergrundprozess (wineserver/Desktop) an das DISPLAY des ersten Aufrufs.
+# Läuft z. B. „pip install“ ohne Bildschirm und die GUI-Tests später mit, scheitert Tk unter
+# Wine mit „Failed to create the menu window“.
+wineserver -k 2>/dev/null || true
+ANZEIGE=":$((90 + RANDOM % 9))"
+Xvfb "$ANZEIGE" -screen 0 1280x800x24 -nolisten tcp >/dev/null 2>&1 &
+XVFB_PID=$!
+trap 'wineserver -k 2>/dev/null || true; kill $XVFB_PID 2>/dev/null || true' EXIT
+export DISPLAY="$ANZEIGE"
+sleep 1
+
 $PY --version
 $PY -m pip install --disable-pip-version-check -q -r requirements-dev.txt
 
-echo "== Tests (Windows-Python) =="
+echo "== Tests inkl. Oberfläche (Windows-Python unter Wine) =="
-$PY -m pytest -q
+# PROVTOOL_GUI_TESTS=1: fehlt der Bildschirm, ist das ein Fehler (nicht „übersprungen“)
+# -v: im Log ist live sichtbar, welcher Test läuft; timeout: Obergrenze für alle Tests zusammen
+PROVTOOL_GUI_TESTS=1 timeout 900 $PY -m pytest -v -p no:cacheprovider
 
 echo "== Version =="
 VERSION=$($PY build/version_info.py | tr -d '\r')
@@ -23,6 +37,19 @@ echo "== PyInstaller =="
 $PY -m PyInstaller --noconfirm --clean --distpath dist --workpath build/tmp build/provisionsmanager.spec
 
 test -f dist/Provisionsmanager95.exe
+
+echo "== Selbsttest der fertigen .exe =="
+rm -f selbsttest.txt
+set +e
+timeout 300 wine dist/Provisionsmanager95.exe --selbsttest selbsttest.txt
+CODE=$?
+set -e
+cat selbsttest.txt 2>/dev/null || echo "(keine Ergebnisdatei – die .exe ist vermutlich gar nicht gestartet)"
+if [ "$CODE" -ne 0 ] || ! head -1 selbsttest.txt 2>/dev/null | tr -d '\r' | grep -qx OK; then
+  echo "Selbsttest der .exe FEHLGESCHLAGEN (Exit-Code $CODE)"
+  exit 1
+fi
+echo "Selbsttest bestanden"
 cp README.md dist/LIESMICH.md 2>/dev/null || true
 ( cd dist && rm -f Provisionsmanager95-*.zip && \
   python3 -c "import zipfile,sys; z=zipfile.ZipFile(sys.argv[1],'w',zipfile.ZIP_DEFLATED); [z.write(f) for f in sys.argv[2:]]; z.close()" \

build/make_tipp_bild.py

@@ -0,0 +1,61 @@
+"""Erzeugt provtool/gui/bilder/tipp.png (freigestellt, verkleinert, ohne Metadaten) aus dem Foto
+für den „Tipp des Tages“. Nur zum Entwickeln nötig (Pillow): python build/make_tipp_bild.py <foto>"""
+import sys
+from collections import deque
+from pathlib import Path
+
+from PIL import Image
+
+ZIEL_HOEHE = 170
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def freistellen(im: Image.Image, schwelle: int = 232, min_flaeche: int = 6000) -> Image.Image:
+    """Weißen Hintergrund transparent machen: alle hellen Flächen, die den Rand berühren ODER groß
+    sind (z. B. das Innere der Büroklammer-Schlaufen). Kleine helle Flächen (Augenweiß) bleiben."""
+    im = im.convert("RGBA")
+    w, h = im.size
+    px = im.load()
+    hell = lambda p: p[0] >= schwelle and p[1] >= schwelle and p[2] >= schwelle  # noqa: E731
+    gesehen = bytearray(w * h)
+    for sy in range(h):
+        for sx in range(w):
+            if gesehen[sy * w + sx] or not hell(px[sx, sy]):
+                continue
+            flaeche, rand, q = [], False, deque([(sx, sy)])
+            gesehen[sy * w + sx] = 1
+            while q:
+                x, y = q.popleft()
+                flaeche.append((x, y))
+                if x in (0, w - 1) or y in (0, h - 1):
+                    rand = True
+                for nx, ny in ((x + 1, y), (x - 1, y), (x, y + 1), (x, y - 1)):
+                    if 0 <= nx < w and 0 <= ny < h and not gesehen[ny * w + nx] and hell(px[nx, ny]):
+                        gesehen[ny * w + nx] = 1
+                        q.append((nx, ny))
+            if rand or len(flaeche) >= min_flaeche:
+                for x, y in flaeche:
+                    px[x, y] = (255, 255, 255, 0)
+    return im.crop(im.getbbox())
+
+
+def main(foto: str, ziel: Path, modus: str = "lanczos"):
+    im = freistellen(Image.open(foto))
+    faktor = ZIEL_HOEHE / im.height
+    groesse = (max(1, round(im.width * faktor)), ZIEL_HOEHE)
+    if modus == "raster":  # erst auf das Pixel-Raster (ca. 8 px) mitteln, dann hochskalieren
+        klein = im.resize((im.width // 8, im.height // 8), Image.BOX)
+        im = klein.resize(groesse, Image.NEAREST)
+    else:
+        im = im.resize(groesse, Image.LANCZOS)
+    # Halbtransparente Randpixel hart machen (Tk/Win95-Optik, keine weißen Säume)
+    alpha = im.getchannel("A").point(lambda a: 255 if a >= 128 else 0)
+    im.putalpha(alpha)
+    ziel.parent.mkdir(parents=True, exist_ok=True)
+    im.save(ziel, optimize=True)  # PNG ohne EXIF-Metadaten
+    print(ziel, im.size)
+
+
+if __name__ == "__main__":
+    main(sys.argv[1], Path(sys.argv[2]) if len(sys.argv) > 2 else ROOT / "provtool" / "gui" / "bilder" / "tipp.png",
+         sys.argv[3] if len(sys.argv) > 3 else "lanczos")

build/provisionsmanager.spec

@@ -8,6 +8,7 @@ a = Analysis(
     [os.path.join(ROOT, "build", "start.py")],
     pathex=[ROOT],
     hiddenimports=["openpyxl", "xlrd"],
+    datas=[(os.path.join(ROOT, "provtool", "gui", "bilder"), os.path.join("provtool", "gui", "bilder"))],
     excludes=["numpy", "pandas", "PIL", "pytest", "matplotlib", "unittest", "pydoc_data"],
     noarchive=False,
 )

provtool/__init__.py

@@ -1,5 +1,5 @@
 """Provisions-Manager 95 – Provisionsabrechnung für Unterhändler der Handy-Insel Miesbach."""
 
-__version__ = "1.0.0"
+__version__ = "1.3.0"
 APP_NAME = "Provisions-Manager 95"
 APP_ORG = "Handy-Insel Miesbach"

provtool/config.py

@@ -35,7 +35,8 @@ DEFAULTS = {
     "import_ordner": None,
     "export_kopfzeile": False,
     "export_summe": True,
-    "export_pro_anbieter": True,
+    "export_anbieter_getrennt": False,  # freenet + Vodafone in einer Datei
+    "export_null_weglassen": True,
 }
 
 

provtool/db.py

@@ -8,10 +8,11 @@ from dataclasses import dataclass
 from datetime import datetime
 from pathlib import Path
 
+from provtool import regeln
 from provtool.importer import ImportErgebnis
 from provtool.money import apply_percent
 
-SCHEMA_VERSION = 2
+SCHEMA_VERSION = 3
 
 SCHEMA = """
 CREATE TABLE IF NOT EXISTS meta (schluessel TEXT PRIMARY KEY, wert TEXT);
@@ -23,7 +24,15 @@ CREATE TABLE IF NOT EXISTS haendler (
     email TEXT DEFAULT '',
     notiz TEXT DEFAULT '',
     standard_prozent REAL NOT NULL DEFAULT 100,
-    aktiv INTEGER NOT NULL DEFAULT 1
+    aktiv INTEGER NOT NULL DEFAULT 1,
+    airtime_prozent REAL NOT NULL DEFAULT 0,   -- 0 = keine Airtime
+    staffel TEXT                               -- Jahresbonus-Staffel (JSON), NULL = Standard-Staffel
+);
+
+-- Fest eingestellter Typ einer Provisionsart (sonst automatisch erkannt, siehe regeln.py).
+CREATE TABLE IF NOT EXISTS art_typ (
+    provisionsart TEXT PRIMARY KEY,
+    typ TEXT NOT NULL
 );
 
 -- Eine Kennung ordnet Positionen eines Anbieters einem Händler zu
@@ -45,6 +54,14 @@ CREATE TABLE IF NOT EXISTS regel (
     UNIQUE (haendler_id, provisionsart)
 );
 
+-- Eigene Kennungen (eigene Filiale): diese Positionen werden ausgeblendet und nicht verprovisioniert.
+CREATE TABLE IF NOT EXISTS eigen (
+    id INTEGER PRIMARY KEY,
+    anbieter TEXT NOT NULL,
+    wert TEXT NOT NULL,
+    UNIQUE (anbieter, wert)
+);
+
 CREATE TABLE IF NOT EXISTS abrechnung (
     id INTEGER PRIMARY KEY,
     titel TEXT NOT NULL,
@@ -82,6 +99,7 @@ CREATE INDEX IF NOT EXISTS ix_position_abr ON position(abrechnung_id);
 """
 
 UNZUGEORDNET = 0  # Pseudo-Händler-ID für Positionen ohne bekannte Kennung
+EIGEN = -2        # Pseudo-Händler-ID für Positionen eigener Kennungen (ausgeblendet)
 
 # Sonder-Kennung: Vodafone-Positionen, deren Kundenname komplett in GROSSBUCHSTABEN steht
 # (so erfasst ein Unterhändler seine Kunden). Hat Vorrang vor der VO-Nr.
@@ -103,6 +121,8 @@ class Haendler:
     notiz: str = ""
     standard_prozent: float = 100.0
     aktiv: bool = True
+    airtime_prozent: float = 0.0
+    staffel: list | None = None   # None = Standard-Staffel
 
 
 def _now() -> str:
@@ -126,6 +146,11 @@ class Datenbank:
         if "haendler_fest" not in spalten:
             # NULL = automatisch über Kennungen, sonst fest zugewiesene Händler-ID (0 = bewusst keiner)
             self.con.execute("ALTER TABLE position ADD COLUMN haendler_fest INTEGER")
+        h_spalten = {r[1] for r in self.con.execute("PRAGMA table_info(haendler)")}
+        if "airtime_prozent" not in h_spalten:
+            self.con.execute("ALTER TABLE haendler ADD COLUMN airtime_prozent REAL NOT NULL DEFAULT 0")
+        if "staffel" not in h_spalten:
+            self.con.execute("ALTER TABLE haendler ADD COLUMN staffel TEXT")
         self.con.execute("UPDATE meta SET wert=? WHERE schluessel='schema_version'", (str(SCHEMA_VERSION),))
         self.con.commit()
 
@@ -149,30 +174,34 @@ class Datenbank:
         shutil.copyfile(quelle, ziel)
 
     # ------------------------------------------------------------------ Händler
+    @staticmethod
+    def _haendler_aus(r) -> Haendler:
+        return Haendler(r["id"], r["name"], r["ansprechpartner"], r["email"], r["notiz"], r["standard_prozent"],
+                        bool(r["aktiv"]), r["airtime_prozent"] or 0.0, regeln.staffel_laden(r["staffel"]))
+
     def haendler_liste(self, nur_aktive: bool = False) -> list[Haendler]:
         sql = "SELECT * FROM haendler" + (" WHERE aktiv=1" if nur_aktive else "") + " ORDER BY name"
-        return [Haendler(r["id"], r["name"], r["ansprechpartner"], r["email"], r["notiz"],
+        return [self._haendler_aus(r) for r in self.con.execute(sql)]
-                         r["standard_prozent"], bool(r["aktiv"])) for r in self.con.execute(sql)]
 
     def haendler(self, hid: int) -> Haendler | None:
         r = self.con.execute("SELECT * FROM haendler WHERE id=?", (hid,)).fetchone()
-        if not r:
+        return self._haendler_aus(r) if r else None
-            return None
-        return Haendler(r["id"], r["name"], r["ansprechpartner"], r["email"], r["notiz"],
-                        r["standard_prozent"], bool(r["aktiv"]))
 
     def haendler_speichern(self, h: Haendler, kennungen: list[tuple[str, str]]) -> int:
         """Legt an (h.id == 0) oder aktualisiert. kennungen = [(anbieter, wert), ...]"""
+        staffel = regeln.staffel_text(regeln.staffel_pruefen(h.staffel)) if h.staffel is not None else None
+        werte = (h.name, h.ansprechpartner, h.email, h.notiz, h.standard_prozent, int(h.aktiv),
+                 h.airtime_prozent or 0.0, staffel)
         with self.con:
             if h.id:
                 self.con.execute(
-                    "UPDATE haendler SET name=?, ansprechpartner=?, email=?, notiz=?, standard_prozent=?, aktiv=? WHERE id=?",
+                    "UPDATE haendler SET name=?, ansprechpartner=?, email=?, notiz=?, standard_prozent=?, aktiv=?, "
-                    (h.name, h.ansprechpartner, h.email, h.notiz, h.standard_prozent, int(h.aktiv), h.id))
+                    "airtime_prozent=?, staffel=? WHERE id=?", werte + (h.id,))
                 hid = h.id
             else:
                 cur = self.con.execute(
-                    "INSERT INTO haendler (name, ansprechpartner, email, notiz, standard_prozent, aktiv) VALUES (?,?,?,?,?,?)",
+                    "INSERT INTO haendler (name, ansprechpartner, email, notiz, standard_prozent, aktiv, "
-                    (h.name, h.ansprechpartner, h.email, h.notiz, h.standard_prozent, int(h.aktiv)))
+                    "airtime_prozent, staffel) VALUES (?,?,?,?,?,?,?,?)", werte)
                 hid = cur.lastrowid
             self.con.execute("DELETE FROM kennung WHERE haendler_id=?", (hid,))
             for anbieter, wert in kennungen:
@@ -206,15 +235,31 @@ class Datenbank:
         kmap = self.kennung_map()
         caps = kmap.get((CAPS_ANBIETER, CAPS_WERT))
         aktive = {h.id for h in self.haendler_liste(nur_aktive=True)}
+        eigene = set(self.eigene_kennungen())
 
         def finde(anbieter: str, kennung: str, name: str | None = None, fest: int | None = None) -> int:
             if fest is not None:
                 return fest if (fest == UNZUGEORDNET or fest in aktive) else UNZUGEORDNET
             if caps and anbieter == "vodafone" and ist_grossgeschrieben(name):
                 return caps
-            return kmap.get((anbieter, kennung), UNZUGEORDNET)
+            hid = kmap.get((anbieter, kennung), UNZUGEORDNET)
+            if hid == UNZUGEORDNET and (anbieter, kennung) in eigene:
+                return EIGEN
+            return hid
         return finde
 
+    # ------------------------------------------------------------------ eigene Kennungen
+    def eigene_kennungen(self) -> list[tuple[str, str]]:
+        return [(r[0], r[1]) for r in self.con.execute("SELECT anbieter, wert FROM eigen ORDER BY anbieter, wert")]
+
+    def eigene_setzen(self, anbieter: str, wert: str, eigen: bool = True) -> None:
+        wert = (wert or "").strip()
+        with self.con:
+            if eigen:
+                self.con.execute("INSERT OR IGNORE INTO eigen (anbieter, wert) VALUES (?,?)", (anbieter, wert))
+            else:
+                self.con.execute("DELETE FROM eigen WHERE anbieter=? AND wert=?", (anbieter, wert))
+
     # ------------------------------------------------------------------ Regeln
     def regeln(self, hid: int) -> dict[str, float]:
         return {r[0]: r[1] for r in self.con.execute(
@@ -229,8 +274,53 @@ class Datenbank:
                                  "ON CONFLICT(haendler_id, provisionsart) DO UPDATE SET prozent=excluded.prozent",
                                  (hid, provisionsart, prozent))
 
+    # ------------------------------------------------------------------ Typen der Provisionsarten
+    def art_typen(self) -> dict[str, str]:
+        """Fest eingestellte Typen je Provisionsart (alles andere wird automatisch erkannt)."""
+        return {r[0]: r[1] for r in self.con.execute("SELECT provisionsart, typ FROM art_typ")}
+
+    def art_typ_setzen(self, provisionsart: str, typ: str | None) -> None:
+        """typ=None: wieder automatisch erkennen."""
+        if typ is not None and typ not in regeln.TYPEN:
+            raise ValueError(f"Unbekannter Typ: {typ}")
+        with self.con:
+            if typ is None:
+                self.con.execute("DELETE FROM art_typ WHERE provisionsart=?", (provisionsart,))
+            else:
+                self.con.execute("INSERT INTO art_typ (provisionsart, typ) VALUES (?,?) "
+                                 "ON CONFLICT(provisionsart) DO UPDATE SET typ=excluded.typ", (provisionsart, typ))
+
+    def provisionsarten(self) -> list[tuple[str, str, int]]:
+        """Alle bekannten Provisionsarten: (Provisionsart, automatisch erkannter Typ, Anzahl Positionen)."""
+        arten: dict[str, list] = {}
+        for r in self.con.execute("SELECT provisionsart, dienst, tarif FROM position"):
+            art = r["provisionsart"] or ""
+            e = arten.setdefault(art, [regeln.NORMAL, 0])
+            erkannt = regeln.erkennen(art, r["dienst"], r["tarif"])
+            if erkannt != regeln.NORMAL:
+                e[0] = erkannt
+            e[1] += 1
+        for art in self.art_typen():
+            arten.setdefault(art, [regeln.erkennen(art), 0])
+        return sorted(((a, t, n) for a, (t, n) in arten.items()), key=lambda x: x[0].lower())
+
+    # ------------------------------------------------------------------ Jahresbonus-Staffel
+    def standard_staffel(self) -> regeln.Staffel:
+        r = self.con.execute("SELECT wert FROM meta WHERE schluessel='staffel_standard'").fetchone()
+        return (regeln.staffel_laden(r[0]) if r else None) or list(regeln.STANDARD_STAFFEL)
+
+    def standard_staffel_setzen(self, staffel) -> None:
+        text = regeln.staffel_text(regeln.staffel_pruefen(staffel))
+        with self.con:
+            self.con.execute("INSERT INTO meta VALUES ('staffel_standard', ?) "
+                             "ON CONFLICT(schluessel) DO UPDATE SET wert=excluded.wert", (text,))
+
+    def staffel_fuer(self, hid: int) -> regeln.Staffel:
+        h = self.haendler(hid) if hid > 0 else None
+        return h.staffel if h and h.staffel is not None else self.standard_staffel()
+
     def prozent_fuer(self, hid: int, provisionsart: str) -> float:
-        if hid == UNZUGEORDNET:
+        if hid <= 0:  # nicht zugeordnet / eigene Filiale
             return 100.0
         r = self.con.execute("SELECT prozent FROM regel WHERE haendler_id=? AND provisionsart=?",
                              (hid, provisionsart)).fetchone()
@@ -277,7 +367,6 @@ class Datenbank:
             self.con.execute("DELETE FROM abrechnung_datei WHERE id=?", (datei_id,))
 
     def importieren(self, aid: int, erg: ImportErgebnis) -> int:
-        finde = self.zuordner()
         start = self.con.execute("SELECT coalesce(max(reihenfolge), 0) FROM position WHERE abrechnung_id=?",
                                  (aid,)).fetchone()[0]
         with self.con:
@@ -286,45 +375,109 @@ class Datenbank:
                 (aid, erg.datei, erg.sha256, erg.format, _now(), len(erg.positionen)))
             did = cur.lastrowid
             for i, p in enumerate(erg.positionen, start=start + 1):
-                hid = finde(p.anbieter, p.kennung, p.name)
-                proz = self.prozent_fuer(hid, p.provisionsart)
                 self.con.execute(
                     "INSERT INTO position (abrechnung_id, datei_id, reihenfolge, anbieter, zeitraum, provisionsart, kennung, "
                     "datum, rufnummer, imei, geraet, vorname, name, tarif, netz, dienst, aktionscode, quelle, "
-                    "betrag_orig, betrag, prozent, manuell, roh) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,0,?)",
+                    "betrag_orig, betrag, prozent, manuell, roh) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,NULL,0,?)",
                     (aid, did, i, p.anbieter, p.zeitraum, p.provisionsart, p.kennung,
                      p.datum.isoformat() if p.datum else None, p.rufnummer, p.imei, p.geraet, p.vorname, p.name,
-                     p.tarif, p.netz, p.dienst, p.aktionscode, p.quelle, p.betrag_cent,
+                     p.tarif, p.netz, p.dienst, p.aktionscode, p.quelle, p.betrag_cent, p.betrag_cent,
-                     apply_percent(p.betrag_cent, proz), proz, json.dumps(p.roh, ensure_ascii=False, default=str)))
+                     json.dumps(p.roh, ensure_ascii=False, default=str)))
             self.con.execute("UPDATE abrechnung SET geaendert=? WHERE id=?", (_now(), aid))
+        neue = {r[0] for r in self.con.execute("SELECT id FROM position WHERE datei_id=?", (did,))}
+        self._regeln_anwenden(aid, neue, auch_manuelle=True)
         return len(erg.positionen)
 
     def positionen(self, aid: int) -> list[dict]:
-        """Alle Positionen mit aktueller Händler-Zuordnung (über die Kennungen)."""
+        """Alle Positionen mit aktueller Händler-Zuordnung (über die Kennungen) und Typ (regeln.py)."""
         finde = self.zuordner()
+        fest = self.art_typen()
         out = []
         for r in self.con.execute("SELECT * FROM position WHERE abrechnung_id=? ORDER BY reihenfolge", (aid,)):
             d = dict(r)
             d["haendler_id"] = finde(d["anbieter"], d["kennung"], d["name"], d["haendler_fest"])
+            d["typ"] = regeln.typ_von(d, fest)
             out.append(d)
         return out
 
+    # ------------------------------------------------------------------ Berechnung nach Regeln
+    def _rechner(self):
+        """Funktion (position, händler_id, typ, karten) -> (auszahlung_cent, prozent).
+        prozent ist None, wenn der Betrag aus der Jahresbonus-Staffel kommt."""
+        haendler = {h.id: h for h in self.haendler_liste()}
+        art_regeln: dict[int, dict[str, float]] = {}
+        for r in self.con.execute("SELECT haendler_id, provisionsart, prozent FROM regel"):
+            art_regeln.setdefault(r[0], {})[r[1]] = r[2]
+        std_staffel = self.standard_staffel()
+
+        def rechne(p: dict, hid: int, typ: str, karten: int) -> tuple[int, float | None]:
+            orig = p["betrag_orig"]
+            h = haendler.get(hid) if hid > 0 else None
+            if h is None:  # nicht zugeordnet / eigene Filiale: unverändert
+                return orig, 100.0
+            regel = art_regeln.get(hid, {}).get(p["provisionsart"])
+            if regel is not None:  # ausdrücklich je Provisionsart festgelegt -> hat Vorrang
+                proz = regel
+            elif typ == regeln.AIRTIME:
+                proz = h.airtime_prozent
+            elif typ == regeln.JAHRESBONUS:
+                return regeln.bonus_betrag(h.staffel if h.staffel is not None else std_staffel, karten, orig), None
+            else:
+                proz = h.standard_prozent
+            return apply_percent(orig, proz), proz
+        return rechne
+
+    @staticmethod
+    def karten_zaehlen(positionen: list[dict]) -> dict[tuple[int, str], int]:
+        """Anzahl Karten je (Händler, Anbieter) für die Jahresbonus-Staffel (Stornos zählen ab)."""
+        karten: dict[tuple[int, str], int] = {}
+        for p in positionen:
+            if p["typ"] == regeln.JAHRESBONUS and p["betrag_orig"]:
+                k = (p["haendler_id"], p["anbieter"])
+                karten[k] = karten.get(k, 0) + (1 if p["betrag_orig"] > 0 else -1)
+        return {k: max(0, n) for k, n in karten.items()}
+
+    def _regeln_anwenden(self, aid: int, pids: set[int] | None = None, auch_manuelle: bool = False) -> int:
+        """Berechnet die Auszahlung nach den Händler-Regeln neu: für `pids` (None = alle) und immer für
+        alle Jahresbonus-Positionen (deren Staffel hängt von der Anzahl aller Karten ab).
+        Von Hand geänderte Beträge bleiben, außer auch_manuelle=True. Gibt die Anzahl Änderungen zurück."""
+        alle = self.positionen(aid)
+        karten = self.karten_zaehlen(alle)
+        rechne = self._rechner()
+        n = 0
+        with self.con:
+            for p in alle:
+                if pids is not None and p["id"] not in pids and p["typ"] != regeln.JAHRESBONUS:
+                    continue
+                if p["manuell"] and not (auch_manuelle and (pids is None or p["id"] in pids)):
+                    continue
+                betrag, proz = rechne(p, p["haendler_id"], p["typ"], karten.get((p["haendler_id"], p["anbieter"]), 0))
+                if betrag != p["betrag"] or proz != p["prozent"] or p["manuell"]:
+                    self.con.execute("UPDATE position SET betrag=?, prozent=?, manuell=0 WHERE id=?",
+                                     (betrag, proz, p["id"]))
+                    n += 1
+        return n
+
+    def _abrechnungen_von(self, pids: list[int]) -> list[int]:
+        if not pids:
+            return []
+        marken = ",".join("?" * len(pids))
+        return [r[0] for r in self.con.execute(
+            f"SELECT DISTINCT abrechnung_id FROM position WHERE id IN ({marken})", list(pids))]
+
     def haendler_zuweisen(self, pids: list[int], hid: int | None) -> None:
         """Weist Positionen fest einem Händler zu (hid=None: wieder automatisch zuordnen).
         Nicht manuell geänderte Beträge werden nach den Regeln des neuen Händlers berechnet."""
         with self.con:
             for pid in pids:
                 self.con.execute("UPDATE position SET haendler_fest=? WHERE id=?", (hid, pid))
-        finde = self.zuordner()
+        for aid in self._abrechnungen_von(pids):
-        with self.con:
+            self._regeln_anwenden(aid, set(pids))
-            for pid in pids:
+
-                r = self.con.execute("SELECT * FROM position WHERE id=?", (pid,)).fetchone()
+    def regeln_wiederherstellen(self, pids: list[int]) -> None:
-                if r is None or r["manuell"]:
+        """Ausgewählte Positionen wieder nach den Händler-Regeln berechnen (auch von Hand geänderte)."""
-                    continue
+        for aid in self._abrechnungen_von(pids):
-                neu_hid = finde(r["anbieter"], r["kennung"], r["name"], r["haendler_fest"])
+            self._regeln_anwenden(aid, set(pids), auch_manuelle=True)
-                proz = self.prozent_fuer(neu_hid, r["provisionsart"])
-                self.con.execute("UPDATE position SET betrag=?, prozent=? WHERE id=?",
-                                 (apply_percent(r["betrag_orig"], proz), proz, pid))
 
     def betrag_setzen(self, pid: int, cent: int) -> None:
         with self.con:
@@ -345,17 +498,7 @@ class Datenbank:
     def neu_berechnen(self, aid: int, auch_manuelle: bool = False) -> int:
         """Wendet die aktuell hinterlegten Händler-Regeln auf alle (nicht manuellen) Positionen an.
         Nötig z. B. wenn ein Händler erst nach dem Import angelegt wurde."""
-        n = 0
+        return self._regeln_anwenden(aid, None, auch_manuelle=auch_manuelle)
-        with self.con:
-            for p in self.positionen(aid):
-                if p["manuell"] and not auch_manuelle:
-                    continue
-                proz = self.prozent_fuer(p["haendler_id"], p["provisionsart"])
-                neu = apply_percent(p["betrag_orig"], proz)
-                if neu != p["betrag"] or proz != p["prozent"] or p["manuell"]:
-                    self.con.execute("UPDATE position SET betrag=?, prozent=?, manuell=0 WHERE id=?", (neu, proz, p["id"]))
-                    n += 1
-        return n
 
     def touch(self, aid: int) -> None:
         with self.con:

provtool/export.py

@@ -2,7 +2,10 @@
 
 Spalten:  A Zeitraum | B Provisionsart | C Unterhändler-/VO-Nr | D Datum | E Rufnummer | F IMEI/SN |
           G Gerät | H Vorname | I Name | J Tarif | K Betrag (Auszahlung) | L Netz | M Dienst | N Aktionscode
-Sortierung: Zeitraum → Provisionsart → Datum (sonst Reihenfolge der Abrechnung).
+Sortierung: Zeitraum -> Provisionsart -> Datum (sonst Reihenfolge der Abrechnung).
+
+Je Händler entstehen zwei Dateien: die Abrechnung (Airtime darin nur als eine Summenzeile) und die
+Airtime-Liste mit den Einzelposten. Positionen mit 0,00 € werden weggelassen.
 """
 from __future__ import annotations
 
@@ -12,6 +15,7 @@ from pathlib import Path
 
 from provtool.importer import ANBIETER
 from provtool.money import to_euro
+from provtool.regeln import AIRTIME
 
 SPALTEN = [
     ("Zeitraum", 20), ("Provisionsart", 38), ("Unterhändler", 11), ("Datum", 11), ("Rufnummer", 13),
@@ -38,8 +42,19 @@ def dateiname(text: str) -> str:
     return re.sub(r'[<>:"/\\|?*\x00-\x1f]', "_", text).strip(" .") or "Export"
 
 
+AIRTIME_TEXT = "Airtime"
+
+
+def airtime_zeile(airtime: list[dict]) -> dict:
+    """Eine Zeile „Airtime = Summe“ für die Abrechnung."""
+    zeitraeume = sorted({p.get("zeitraum") or "" for p in airtime} - {""})
+    return {"zeitraum": zeitraeume[0] if len(zeitraeume) == 1 else "", "provisionsart": AIRTIME_TEXT,
+            "tarif": "Summe laut Airtime-Liste", "betrag": sum(p["betrag"] for p in airtime), "_summe": True}
+
+
 def schreibe_xlsx(ziel: str | Path, positionen: list[dict], *, kopfzeile: bool = False, summe: bool = True,
-                  blattname: str = "Tabelle1") -> Path:
+                  blattname: str = "Tabelle1", schluss: list[dict] | None = None) -> Path:
+    """schluss: Zeilen, die nach den sortierten Positionen kommen (z. B. die Airtime-Summe)."""
     import openpyxl
     from openpyxl.styles import Font
     from openpyxl.utils import get_column_letter
@@ -59,7 +74,7 @@ def schreibe_xlsx(ziel: str | Path, positionen: list[dict], *, kopfzeile: bool =
         zeile += 1
 
     erste = zeile
-    for p in sortiert(positionen):
+    for p in sortiert(positionen) + list(schluss or []):
         werte = [
             p.get("zeitraum") or None,
             p.get("provisionsart") or None,
@@ -78,7 +93,7 @@ def schreibe_xlsx(ziel: str | Path, positionen: list[dict], *, kopfzeile: bool =
         ]
         for c, v in enumerate(werte, start=1):
             cell = ws.cell(zeile, c, v)
-            cell.font = font
+            cell.font = bold if p.get("_summe") and c in (2, 11) else font
         ws.cell(zeile, 4).number_format = "DD.MM.YYYY"
         ws.cell(zeile, 5).number_format = "0"
         ws.cell(zeile, 6).number_format = "0"
@@ -104,20 +119,35 @@ def schreibe_xlsx(ziel: str | Path, positionen: list[dict], *, kopfzeile: bool =
 
 
 def exportiere_haendler(ordner: str | Path, haendler_name: str, positionen: list[dict], titel: str, *,
-                        pro_anbieter: bool = True, kopfzeile: bool = False, summe: bool = True) -> list[Path]:
+                        pro_anbieter: bool = False, kopfzeile: bool = False, summe: bool = True,
-    """Schreibt eine (oder je Anbieter eine) Datei für einen Händler. Gibt die erzeugten Pfade zurück."""
+                        null_weglassen: bool = True) -> list[Path]:
+    """Schreibt die Abrechnung eines Händlers (bei pro_anbieter je Anbieter eine) und – falls es Airtime
+    gibt – die Airtime-Liste. In der Abrechnung steht Airtime nur als eine Summenzeile.
+    Gibt die erzeugten Pfade zurück."""
     ordner = Path(ordner)
+    if null_weglassen:
+        positionen = [p for p in positionen if p["betrag"]]
     if not positionen:
         return []
     gruppen: dict[str, list[dict]] = {}
-    if pro_anbieter:
     for p in positionen:
-            gruppen.setdefault(p["anbieter"], []).append(p)
+        gruppen.setdefault(p["anbieter"] if pro_anbieter else "", []).append(p)
-    else:
+
-        gruppen[""] = positionen
+    def name(*teile) -> str:
+        return dateiname(" - ".join(t for t in (haendler_name,) + teile + (titel,) if t)) + ".xlsx"
+
     out = []
     for anbieter, pos in sorted(gruppen.items()):
-        teile = [haendler_name] + ([ANBIETER.get(anbieter, anbieter)] if anbieter else []) + [titel]
+        provision = [p for p in pos if p.get("typ") != AIRTIME]
-        name = dateiname(" - ".join(t for t in teile if t)) + ".xlsx"
+        airtime = [p for p in pos if p.get("typ") == AIRTIME]
-        out.append(schreibe_xlsx(ordner / name, pos, kopfzeile=kopfzeile, summe=summe))
+        schluss = [airtime_zeile(airtime)] if airtime else []
+        if schluss and null_weglassen and not schluss[0]["betrag"]:
+            schluss = []
+        if provision or schluss:
+            out.append(schreibe_xlsx(ordner / name(ANBIETER.get(anbieter, anbieter) if anbieter else ""),
+                                     provision, kopfzeile=kopfzeile, summe=summe, schluss=schluss))
+    airtime = [p for p in positionen if p.get("typ") == AIRTIME]
+    if airtime:
+        out.append(schreibe_xlsx(ordner / name(AIRTIME_TEXT), airtime, kopfzeile=kopfzeile, summe=summe,
+                                 blattname=AIRTIME_TEXT))
     return out

provtool/gui/app.py

@@ -14,8 +14,13 @@ from tkinter import filedialog
 
 from provtool import APP_NAME, config
 from provtool import export as exp
-from provtool.db import UNZUGEORDNET, Datenbank
+from provtool import regeln
+from provtool.db import EIGEN, UNZUGEORDNET, Datenbank
+from provtool.gui import assistent as ass
 from provtool.gui import dialogs as dlg
+from provtool.gui import menue as mn
+from provtool.gui import modal
+from provtool.gui import rahmen as rh
 from provtool.gui import win95 as w
 from provtool.importer import ANBIETER, ImportFehler, lies_datei
 from provtool.money import fmt, fmt_percent, parse_cent
@@ -33,7 +38,7 @@ def _datum_de(iso: str | None) -> str:
 
 
 def _zeitraum_kurz(z: str | None) -> str:
-    """'2026.10.01-2026.10.07' → '01.10.–07.10.'"""
+    """'2026.10.01-2026.10.07' -> '01.10.–07.10.'"""
     m = re.fullmatch(r"(\d{4})\.(\d{2})\.(\d{2})\s*-\s*(\d{4})\.(\d{2})\.(\d{2})", (z or "").strip())
     if m:
         return f"{m[3]}.{m[2]}.–{m[6]}.{m[5]}."
@@ -62,73 +67,93 @@ class App:
         self.haendler_namen: dict[int, str] = {}
         self.ansicht: int = ALLE
         self._edit: tk.Entry | None = None
+        self._schliesst = False   # Beenden angefordert (offene Dialoge werden gerade geschlossen)
+        self._beendet = False     # Datenbank und Fenster sind zu
 
         w.apply(root)
         self.icons = w.Icons(root)
         root._app_icon = self.icons("app", 2)  # type: ignore[attr-defined]
         root.iconphoto(True, self.icons("app", 2), self.icons("app", 1))
-        root.title(APP_NAME)
-        root.geometry(self.settings.get("fenster", "1200x720"))
-        root.minsize(900, 520)
         root.protocol("WM_DELETE_WINDOW", self.beenden)
         root.report_callback_exception = self._fehler_handler
+        klassisch = bool(self.settings.get("klassischer_rahmen", True))
+        w.KLASSISCH = klassisch
+        self.rahmen = rh.Hauptrahmen(root, APP_NAME, self.icons("app"), self.beenden, klassisch=klassisch)
+        self.rahmen.set_titel(APP_NAME)
+        self.inhalt = self.rahmen.inhalt
 
         self._menue()
         self._toolbar()
         self._body()
-        self.status = w.Statusleiste(root, [("info", 0), ("pos", 16), ("orig", 22), ("ausz", 22)])
+        self.status = w.Statusleiste(self.inhalt, [("info", 0), ("pos", 16), ("orig", 22), ("ausz", 22)])
+        griff = self.rahmen.griff(self.status)
+        if griff:
+            griff.pack(side="right", anchor="se")
         self.status.pack(side="bottom", fill="x")
         self._tasten()
+        self.rahmen.geometrie_setzen(self.settings.get("fenster"), self.settings.get("maximiert", False))
+        if self.settings.get("trenner"):
+            root.after(200, lambda: self.pw.sash_place(0, int(self.settings["trenner"]), 0))
 
         abr = self.db.abrechnungen()
         if abr:
             self.oeffnen(abr[0]["id"])
         else:
             self._aktualisieren()
-            root.after(300, self._willkommen)
+        if not self.settings.get("assistent_erledigt") and not self.db.haendler_liste():
+            root.after(400, self.assistent)
+        elif self.settings.get("tipps_beim_start", True):
+            root.after(500, self.tipp_des_tages)
 
     # ================================================================= Aufbau
     def _menue(self):
-        m = tk.Menu(self.root, tearoff=0)
+        self.menueleiste = mn.Menueleiste(self.inhalt, self.root)
-        d = tk.Menu(m, tearoff=0)
+        self.menueleiste.pack(side="top", fill="x")
-        d.add_command(label="Neue Abrechnung…", accelerator="Strg+N", command=self.neu)
+        d = self.menueleiste.menue("Datei")
-        d.add_command(label="Abrechnung öffnen…", accelerator="Strg+O", command=self.abrechnung_waehlen)
+        d.add_command(label="Neue Abrechnung...", accelerator="Strg+N", command=self.neu)
+        d.add_command(label="Abrechnung öffnen...", accelerator="Strg+O", command=self.abrechnung_waehlen)
         d.add_separator()
-        d.add_command(label="Dateien importieren…", accelerator="Strg+I", command=self.importieren)
+        d.add_command(label="Dateien importieren...", accelerator="Strg+I", command=self.importieren)
-        d.add_command(label="Importierte Dateien…", command=self.dateien)
+        d.add_command(label="Importierte Dateien...", command=self.dateien)
-        d.add_command(label="Exportieren…", accelerator="Strg+E", command=self.exportieren)
+        d.add_command(label="Exportieren...", accelerator="Strg+E", command=self.exportieren)
         d.add_separator()
-        d.add_command(label="Datensicherung erstellen…", command=self.sicherung)
+        d.add_command(label="Datensicherung erstellen...", command=self.sicherung)
-        d.add_command(label="Datensicherung einspielen…", command=self.wiederherstellen)
+        d.add_command(label="Datensicherung einspielen...", command=self.wiederherstellen)
-        d.add_command(label="Einstellungen…", command=self.einstellungen)
+        d.add_command(label="Einstellungen...", command=self.einstellungen)
         d.add_separator()
         d.add_command(label="Beenden", accelerator="Alt+F4", command=self.beenden)
-        m.add_cascade(label="Datei", menu=d, underline=0)
 
-        b = tk.Menu(m, tearoff=0)
+        b = self.menueleiste.menue("Bearbeiten")
-        b.add_command(label="Betrag ändern…", accelerator="F2", command=self.betrag_bearbeiten)
+        b.add_command(label="Betrag ändern...", accelerator="F2", command=self.betrag_bearbeiten)
-        b.add_command(label="Auszahlung in Prozent…", accelerator="F4", command=self.prozent)
+        b.add_command(label="Auszahlung in Prozent...", accelerator="F4", command=self.prozent)
         b.add_command(label="Auf Regel zurücksetzen", command=self.zuruecksetzen)
         b.add_separator()
         b.add_command(label="Alle Beträge neu berechnen", command=self.neu_berechnen)
-        m.add_cascade(label="Bearbeiten", menu=b, underline=0)
 
-        h = tk.Menu(m, tearoff=0)
+        h = self.menueleiste.menue("Händler")
-        h.add_command(label="Händler verwalten…", accelerator="Strg+H", command=self.haendler)
+        h.add_command(label="Händler verwalten...", accelerator="Strg+H", command=self.haendler)
-        h.add_command(label="Kennung des Eintrags zuordnen…", command=self.kennung_zuordnen_auswahl)
+        h.add_command(label="Kennung des Eintrags zuordnen...", command=self.kennung_zuordnen_auswahl)
-        h.add_command(label="Auswahl fest einem Händler zuweisen…", command=self.haendler_zuweisen)
+        h.add_command(label="Auswahl fest einem Händler zuweisen...", command=self.haendler_zuweisen)
         h.add_command(label="Auswahl automatisch zuordnen", command=lambda: self.haendler_zuweisen(automatisch=True))
-        m.add_cascade(label="Händler", menu=h, underline=0)
+        h.add_separator()
+        h.add_command(label="Eigene Kennungen (ausblenden)...", command=self.eigene_verwalten)
+        h.add_command(label="Kennung der Auswahl als eigene ausblenden", command=self.eigene_ausblenden)
+        h.add_separator()
+        h.add_command(label="Provisionsarten (Airtime / Jahresbonus)...", command=self.provisionsarten)
+        h.add_command(label="Standard-Staffel Jahresbonus...", command=self.standard_staffel)
 
-        hi = tk.Menu(m, tearoff=0)
+        hi = self.menueleiste.menue("?", underline=None)
         hi.add_command(label="Kurzanleitung", accelerator="F1", command=self.hilfe)
+        hi.add_command(label="Rundgang durch das Programm", command=self.rundgang)
+        hi.add_command(label="Tipp des Tages...", command=self.tipp_des_tages)
         hi.add_separator()
-        hi.add_command(label=f"Info über {APP_NAME}…", command=lambda: dlg.InfoDialog(self.root).zeigen())
+        hi.add_command(label="Einrichtungs-Assistent...", command=self.assistent)
-        m.add_cascade(label="?", menu=hi)
+        hi.add_separator()
-        self.root.configure(menu=m)
+        hi.add_command(label=f"Info über {APP_NAME}...", command=lambda: dlg.InfoDialog(self.root).zeigen())
 
     def _toolbar(self):
-        tb = tk.Frame(self.root, bg=w.FACE, bd=1, relief="raised")
+        tb = tk.Frame(self.inhalt, bg=w.FACE, bd=1, relief="raised")
+        self.tb: dict[str, w.ToolbarButton] = {}
         tb.pack(side="top", fill="x")
         for text, icon, cmd, tip in (
             ("Neu", "neu", self.neu, "Neue Abrechnung anlegen (Strg+N)"),
@@ -144,20 +169,27 @@ class App:
             if text is None:
                 w.trenner(tb).pack(side="left", fill="y", padx=4, pady=3)
                 continue
-            w.ToolbarButton(tb, text, self.icons(icon), cmd, tip).pack(side="left", padx=1, pady=1)
+            self.tb[text] = w.ToolbarButton(tb, text, self.icons(icon), cmd, tip)
+            self.tb[text].pack(side="left", padx=1, pady=1)
         self.v_suche = tk.StringVar()
         sf = tk.Frame(tb, bg=w.FACE)
         sf.pack(side="right", padx=8)
         tk.Label(sf, text="Suchen:").pack(side="left")
         e = tk.Entry(sf, textvariable=self.v_suche, width=22)
         e.pack(side="left", padx=4)
-        self.v_suche.trace_add("write", lambda *_: self._tabelle())
+        self._suche_geplant = None
+        self.v_suche.trace_add("write", lambda *_: self._suche_planen())
         self._suchfeld = e
+        self._suchrahmen = sf
 
     def _body(self):
-        desk = tk.Frame(self.root, bg=w.TEAL)
+        desk = tk.Frame(self.inhalt, bg=w.TEAL)
         desk.pack(side="top", fill="both", expand=True)
-        pw = tk.PanedWindow(desk, orient="horizontal", bg=w.TEAL, sashwidth=6, bd=0)
+        # Trennlinie zwischen den Spalten: grau und erhaben wie ein Win95-Splitter, mit der Maus ziehbar.
+        # Wie im Win95-Explorer wandert beim Ziehen nur eine Linie mit; neu aufgebaut wird erst beim
+        # Loslassen (flüssig, auch mit vielen Positionen).
+        pw = self.pw = tk.PanedWindow(desk, orient="horizontal", bg=w.FACE, sashwidth=7, sashrelief="raised",
+                                      bd=0, opaqueresize=False, sashcursor="sb_h_double_arrow")
         pw.pack(fill="both", expand=True, padx=6, pady=6)
 
         # --- Händler-Fenster
@@ -202,8 +234,9 @@ class App:
 
         leiste = tk.Frame(self.f_p.inhalt, bg=w.FACE)
         leiste.pack(fill="x", pady=(4, 0))
-        w.knopf(leiste, "Prozent…", self.prozent, self.icons("prozent")).pack(side="left")
+        self.b_prozent = w.knopf(leiste, "Prozent...", self.prozent, self.icons("prozent"))
-        w.knopf(leiste, "Betrag ändern…", self.betrag_bearbeiten, self.icons("rechner")).pack(side="left", padx=4)
+        self.b_prozent.pack(side="left")
+        w.knopf(leiste, "Betrag ändern...", self.betrag_bearbeiten, self.icons("rechner")).pack(side="left", padx=4)
         w.knopf(leiste, "Zurücksetzen", self.zuruecksetzen).pack(side="left")
         self.v_alle_auf = tk.BooleanVar(value=True)
         w.knopf(leiste, "Alle zuklappen", lambda: self._klappen(False)).pack(side="right")
@@ -214,13 +247,18 @@ class App:
 
     def _tasten(self):
         r = self.root
-        r.bind_all("<Control-n>", lambda e: self.neu())
+
-        r.bind_all("<Control-o>", lambda e: self.abrechnung_waehlen())
+        def frei(befehl):
-        r.bind_all("<Control-i>", lambda e: self.importieren())
+            # Tastenkürzel des Hauptfensters nicht ausführen, solange ein Dialog offen ist
-        r.bind_all("<Control-e>", lambda e: self.exportieren())
+            # (sonst öffnete z. B. Strg+N im Dialog einen zweiten Dialog darüber)
-        r.bind_all("<Control-h>", lambda e: self.haendler())
+            return lambda e: None if modal.offen() else befehl()
-        r.bind_all("<Control-f>", lambda e: self._suchfeld.focus_set())
+        r.bind_all("<Control-n>", frei(self.neu))
-        r.bind_all("<F1>", lambda e: self.hilfe())
+        r.bind_all("<Control-o>", frei(self.abrechnung_waehlen))
+        r.bind_all("<Control-i>", frei(self.importieren))
+        r.bind_all("<Control-e>", frei(self.exportieren))
+        r.bind_all("<Control-h>", frei(self.haendler))
+        r.bind_all("<Control-f>", frei(self._suchfeld.focus_set))
+        r.bind_all("<F1>", frei(self.hilfe))
         self.ptree.bind("<F2>", lambda e: self.betrag_bearbeiten())
         self.ptree.bind("<Return>", lambda e: self.betrag_bearbeiten())
         self.ptree.bind("<F4>", lambda e: self.prozent())
@@ -235,19 +273,29 @@ class App:
         if self.aid and self.db.abrechnung(self.aid):
             self.positionen = self.db.positionen(self.aid)
             titel = self.db.abrechnung(self.aid)["titel"]
-            self.root.title(f"{APP_NAME} - [{titel}]")
+            self.rahmen.set_titel(f"{APP_NAME} - [{titel}]")
             self.status.set("info", f" Abrechnung: {titel}")
         else:
             self.aid = None
             self.positionen = []
-            self.root.title(APP_NAME)
+            self.rahmen.set_titel(APP_NAME)
-            self.status.set("info", " Keine Abrechnung geöffnet – Datei ▸ Neue Abrechnung oder Import")
+            self.status.set("info", " Keine Abrechnung geöffnet – Datei > Neue Abrechnung oder Import")
         self._haendlerliste(behalte_auswahl)
         self._tabelle()
 
+    def _suche_planen(self):
+        """Suche erst kurz nach dem letzten Tastendruck ausführen (flüssiges Tippen)."""
+        if self._suche_geplant is not None:
+            self.root.after_cancel(self._suche_geplant)
+        self._suche_geplant = self.root.after(150, self._suche_ausfuehren)
+
+    def _suche_ausfuehren(self):
+        self._suche_geplant = None
+        self._tabelle()
+
     def _gefiltert(self) -> list[dict]:
         if self.ansicht == ALLE:
-            return self.positionen
+            return [p for p in self.positionen if p["haendler_id"] != EIGEN]
         return [p for p in self.positionen if p["haendler_id"] == self.ansicht]
 
     def _haendlerliste(self, behalte_auswahl=True):
@@ -259,7 +307,7 @@ class App:
             s[0] += 1
             s[1] += p["betrag"]
             s[2] += p["betrag_orig"]
-        ges = [sum(s[0] for s in stat.values()), sum(s[1] for s in stat.values())]
+        ges = [sum(s[0] for k, s in stat.items() if k != EIGEN), sum(s[1] for k, s in stat.items() if k != EIGEN)]
         t.insert("", "end", iid=str(ALLE), text="(Alle Positionen)", values=(ges[0], fmt(ges[1])), tags=("fett",))
         for h in self.db.haendler_liste():
             s = stat.get(h.id, [0, 0, 0])
@@ -269,6 +317,10 @@ class App:
         if s:
             t.insert("", "end", iid=str(UNZUGEORDNET), text="(Nicht zugeordnet)", values=(s[0], fmt(s[1])),
                      tags=("grau",))
+        s = stat.get(EIGEN)
+        if s:
+            t.insert("", "end", iid=str(EIGEN), text="(Eigene – ausgeblendet)", values=(s[0], fmt(s[2])),
+                     tags=("grau",))
         ziel = str(self.ansicht) if behalte_auswahl and t.exists(str(self.ansicht)) else str(ALLE)
         self.ansicht = int(ziel)
         t.selection_set(ziel)
@@ -285,9 +337,11 @@ class App:
             self.haendler(self.ansicht)
         elif self.ansicht == UNZUGEORDNET:
             self.kennung_zuordnen_auswahl()
+        elif self.ansicht == EIGEN:
+            self.eigene_verwalten()
 
     def _gruppe_von(self, p: dict) -> str:
-        if self.ansicht == UNZUGEORDNET:
+        if self.ansicht in (UNZUGEORDNET, EIGEN):
             return f"{ANBIETER.get(p['anbieter'], p['anbieter'])} · Kennung {p['kennung'] or '(leer)'}"
         if self.ansicht == ALLE:
             name = self.haendler_namen.get(p["haendler_id"], "(Nicht zugeordnet)")
@@ -318,6 +372,9 @@ class App:
             so = sum(p["betrag_orig"] for p in plist)
             sa = sum(p["betrag"] for p in plist)
             proz = {p["prozent"] for p in plist}
+            if all(_ist_staffel(p) for p in plist):
+                pz = "Staffel"
+            else:
                 pz = fmt_percent(next(iter(proz))) if len(proz) == 1 and None not in proz else ("gemischt" if so else "")
             t.insert("", "end", iid=giid, text=f"{gname}  ({len(plist)})", open=(war_leer or giid in offen or bool(such)),
                      values=("", "", "", "", "", fmt(so), pz, fmt(sa)), tags=("gruppe",))
@@ -332,9 +389,11 @@ class App:
                          values=(_datum_de(p["datum"]), p["rufnummer"], p["tarif"], _zeitraum_kurz(p["zeitraum"]),
                                  p["kennung"] + (" (fest)" if p["haendler_fest"] is not None else ""),
                                  fmt(p["betrag_orig"]),
-                                 "manuell" if p["manuell"] else fmt_percent(p["prozent"]), fmt(p["betrag"])),
+                                 "manuell" if p["manuell"] else ("Staffel" if _ist_staffel(p) else fmt_percent(p["prozent"])),
+                                 fmt(p["betrag"])),
                          tags=tuple(tags))
-        name = {ALLE: "Alle Positionen", UNZUGEORDNET: "Nicht zugeordnet"}.get(
+        name = {ALLE: "Alle Positionen", UNZUGEORDNET: "Nicht zugeordnet",
+                EIGEN: "Eigene Kennungen (ausgeblendet, werden nicht exportiert)"}.get(
             self.ansicht, self.haendler_namen.get(self.ansicht, ""))
         self.f_p.set_titel(f"Positionen – {name}")
         so = sum(p["betrag_orig"] for p in pos)
@@ -447,8 +506,10 @@ class App:
                 u[0] += 1
                 u[1] += p["betrag_orig"]
         res = dlg.ImportBericht(self.root, bericht, [(a, k, n, s) for (a, k), (n, s) in sorted(unbekannt.items())]).zeigen()
-        if res:
+        if res and res[0] == "zuordnen":
-            self.kennung_zuordnen(*res)
+            self.kennung_zuordnen(res[1], res[2])
+        elif res and res[0] == "eigen":
+            self.eigene_ausblenden(res[1])
 
     def dateien(self):
         if not self.aid:
@@ -468,6 +529,17 @@ class App:
                 self.status.set("info", f" {n} Position(en) nach neuen Händler-Regeln berechnet")
         self._aktualisieren()
 
+    def provisionsarten(self):
+        if dlg.ProvisionsartenDialog(self.root, self.db).zeigen():
+            self._nach_haendler_aenderung()
+
+    def standard_staffel(self):
+        neu = dlg.StaffelDialog(self.root, self.db.standard_staffel(), "Standard-Staffel Jahresbonus Neuaktivierung",
+                                standard=list(regeln.STANDARD_STAFFEL)).zeigen()
+        if neu is not None:
+            self.db.standard_staffel_setzen(neu)
+            self._nach_haendler_aenderung()
+
     def kennung_zuordnen(self, anbieter: str, kennung: str):
         res = dlg.KennungZuordnen(self.root, self.db, anbieter, kennung).zeigen()
         if not res:
@@ -532,8 +604,7 @@ class App:
         sel, pids, ps = self._auswahl_info()
         if not ps:
             return
-        for p in ps:
+        self.db.regeln_wiederherstellen([p["id"] for p in ps])
-            self.db.prozent_anwenden([p["id"]], self.db.prozent_fuer(p["haendler_id"], p["provisionsart"]))
         self.db.touch(self.aid)
         self._aktualisieren()
         self._auswahl_wiederherstellen(sel)
@@ -579,10 +650,12 @@ class App:
         self.ptree.see(iid)
         self.ptree.update_idletasks()
         bbox = self.ptree.bbox(iid, "ausz")
-        if not bbox:
-            return
         pid = int(iid[1:])
         p = next(x for x in self.positionen if x["id"] == pid)
+        if not bbox:
+            # Zelle gerade nicht sichtbar (z. B. Spalte zu schmal) -> kleiner Dialog statt Inline-Feld
+            self._betrag_dialog(p)
+            return
         x, y, bw, bh = bbox
         var = tk.StringVar(value=fmt(p["betrag"], symbol=False))
         e = tk.Entry(self.ptree, textvariable=var, justify="right", bd=1, relief="solid", font=w.FONT)
@@ -631,26 +704,81 @@ class App:
         e.bind("<Escape>", abbruch)
         e.bind("<FocusOut>", speichern)
 
+    def _betrag_dialog(self, p: dict):
+        kunde = " ".join(x for x in (p["vorname"], p["name"]) if x) or "(ohne Name)"
+        while True:
+            text = w.eingabe(self.root, "Betrag ändern",
+                             f"Auszahlung für {kunde}\n{p['provisionsart']} – Provision {fmt(p['betrag_orig'])}:",
+                             fmt(p["betrag"], symbol=False))
+            if text is None:
+                return
+            try:
+                cent = parse_cent(text)
+            except ValueError:
+                w.warnung(self.root, "Betrag ändern", "Bitte einen Betrag eingeben, z. B. 25 oder 12,50.")
+                continue
+            break
+        if cent != p["betrag"]:
+            self.db.betrag_setzen(p["id"], cent)
+            self.db.touch(self.aid)
+            self._aktualisieren()
+
     def _kontextmenue(self, e):
         iid = self.ptree.identify_row(e.y)
         if not iid:
             return
         if iid not in self.ptree.selection():
             self.ptree.selection_set(iid)
-        m = tk.Menu(self.root, tearoff=0)
+        m = mn.Popup(self.root)
         if iid.startswith("p"):
-            m.add_command(label="Betrag ändern…", command=lambda: self.betrag_bearbeiten(iid))
+            m.add_command(label="Betrag ändern...", command=lambda: self.betrag_bearbeiten(iid))
-        m.add_command(label="Auszahlung in Prozent…", command=self.prozent)
+        m.add_command(label="Auszahlung in Prozent...", command=self.prozent)
         m.add_command(label="Auf Regel zurücksetzen", command=self.zuruecksetzen)
         m.add_separator()
         m.add_command(label="Auszahlung 0 € (nicht auszahlen)", command=lambda: self._null())
         m.add_separator()
-        m.add_command(label="Händler zuweisen…", command=self.haendler_zuweisen)
+        m.add_command(label="Händler zuweisen...", command=self.haendler_zuweisen)
         m.add_command(label="Automatisch zuordnen", command=lambda: self.haendler_zuweisen(automatisch=True))
         if self.ansicht == UNZUGEORDNET or self.ansicht == ALLE:
-            m.add_command(label="Kennung einem Händler zuordnen…", command=self.kennung_zuordnen_auswahl)
+            m.add_command(label="Kennung einem Händler zuordnen...", command=self.kennung_zuordnen_auswahl)
+        _, _, ps = self._auswahl_info()
+        if any(p["haendler_id"] == UNZUGEORDNET for p in ps):
+            m.add_separator()
+            m.add_command(label="Kennung als eigene ausblenden", command=self.eigene_ausblenden)
+        if any(p["haendler_id"] == EIGEN for p in ps):
+            m.add_separator()
+            m.add_command(label="Kennung wieder einblenden", command=self.eigene_einblenden)
         m.tk_popup(e.x_root, e.y_root)
 
+    # ----- Eigene Kennungen (eigene Filiale) ausblenden
+    def _kennungen_der_auswahl(self, nur: int) -> list[tuple[str, str]]:
+        _, _, ps = self._auswahl_info()
+        return sorted({(p["anbieter"], p["kennung"]) for p in ps if p["haendler_id"] == nur})
+
+    def eigene_ausblenden(self, kennungen: list[tuple[str, str]] | None = None):
+        kennungen = kennungen if kennungen is not None else self._kennungen_der_auswahl(UNZUGEORDNET)
+        if not kennungen:
+            w.info(self.root, "Eigene Kennung", "Bitte zuerst nicht zugeordnete Positionen auswählen.")
+            return
+        liste = "\n".join(f"   {ANBIETER.get(a, a)}: {k or '(leer)'}" for a, k in kennungen)
+        if not w.frage(self.root, "Eigene Kennung ausblenden",
+                       f"Diese Kennung(en) gehören zur eigenen Filiale und werden künftig ausgeblendet "
+                       f"(nicht angezeigt, nicht mitgerechnet, nicht exportiert):\n\n{liste}\n\n"
+                       "Rückgängig jederzeit unter Händler > Eigene Kennungen."):
+            return
+        for a, k in kennungen:
+            self.db.eigene_setzen(a, k, True)
+        self._aktualisieren()
+
+    def eigene_einblenden(self):
+        for a, k in self._kennungen_der_auswahl(EIGEN):
+            self.db.eigene_setzen(a, k, False)
+        self._aktualisieren()
+
+    def eigene_verwalten(self):
+        if dlg.EigeneKennungenDialog(self.root, self.db).zeigen():
+            self._aktualisieren()
+
     def haendler_zuweisen(self, automatisch: bool = False):
         sel, pids, _ = self._auswahl_info()
         if not pids:
@@ -681,7 +809,7 @@ class App:
             return
         stat: dict[int, list[int]] = defaultdict(lambda: [0, 0])
         for p in self.positionen:
-            if p["haendler_id"] != UNZUGEORDNET:
+            if p["haendler_id"] > 0:  # nicht: nicht zugeordnet / eigene Kennungen
                 stat[p["haendler_id"]][0] += 1
                 stat[p["haendler_id"]][1] += p["betrag"]
         if not stat:
@@ -702,13 +830,13 @@ class App:
                 pos = [p for p in self.positionen if p["haendler_id"] == hid]
                 erzeugt += exp.exportiere_haendler(res["ordner"], self.haendler_namen[hid], pos, res["titel"],
                                                    pro_anbieter=res["pro_anbieter"], kopfzeile=res["kopfzeile"],
-                                                   summe=res["summe"])
+                                                   summe=res["summe"], null_weglassen=res["null_weglassen"])
         except PermissionError as exc:
             w.fehler(self.root, "Export", f"Die Datei konnte nicht geschrieben werden:\n{exc.filename}\n\n"
                                           "Ist sie vielleicht noch in Excel geöffnet?")
             return
         w.info(self.root, "Export", f"{len(erzeugt)} Datei(en) gespeichert in:\n{res['ordner']}\n\n"
-               + "\n".join(p.name for p in erzeugt[:15]) + ("\n…" if len(erzeugt) > 15 else ""))
+               + "\n".join(p.name for p in erzeugt[:15]) + ("\n..." if len(erzeugt) > 15 else ""))
         if res["oeffnen"]:
             _oeffne_ordner(res["ordner"])
 
@@ -746,67 +874,209 @@ class App:
         self.ansicht = ALLE
         self._aktualisieren()
 
-    def einstellungen(self):
+    def db_wechseln(self, pfad: str | None):
-        neu = dlg.EinstellungenDialog(self.root, self.settings, str(self.db.path)).zeigen()
+        """Öffnet (oder legt an) eine andere Datenbank. pfad=None: Standard-Speicherort."""
-        if neu and Path(neu) != self.db.path:
+        ziel = Path(pfad) if pfad else config.app_dir() / "provisionen.db"
-            try:
+        db = Datenbank(ziel)  # wirft bei Fehler – alte DB bleibt dann offen
-                db = Datenbank(neu)
-            except Exception as exc:
-                w.fehler(self.root, "Einstellungen", f"Datenbank konnte nicht geöffnet werden:\n{exc}")
-                return
         self.db.close()
         self.db = db
-            self.settings["db_pfad"] = neu
+        self.settings["db_pfad"] = str(ziel) if pfad else None
         config.save(self.settings)
         abr = self.db.abrechnungen()
         self.aid = abr[0]["id"] if abr else None
         self.ansicht = ALLE
         self._aktualisieren()
 
+    def einstellungen(self):
+        res = dlg.EinstellungenDialog(self.root, self.settings, str(self.db.path)).zeigen()
+        if not res:
+            return
+        if res["klassisch"] != bool(self.settings.get("klassischer_rahmen", True)):
+            self.settings["klassischer_rahmen"] = res["klassisch"]
+            config.save(self.settings)
+            w.info(self.root, "Einstellungen", "Die Änderung der Titelleiste wird beim nächsten Programmstart wirksam.")
+        if res["pfad"] and Path(res["pfad"]) != self.db.path:
+            try:
+                self.db_wechseln(res["pfad"])
+            except Exception as exc:
+                w.fehler(self.root, "Einstellungen", f"Datenbank konnte nicht geöffnet werden:\n{exc}")
+
     def hilfe(self):
         w.info(self.root, "Kurzanleitung",
-               "1.  Händler anlegen (Strg+H): Name, Standard-Auszahlung in % und die Kennungen –\n"
+               "1.  Händler anlegen (Strg+H): Name, Standard-Auszahlung in %, Airtime in % (0 % = keine)\n"
-               "     bei freenet die Unterhändlernummer, bei Vodafone die VO-Nr. oder die Regel\n"
+               "     und die Kennungen – bei freenet die Unterhändlernummer, bei Vodafone die VO-Nr.\n"
-               "     „Name in GROSSBUCHSTABEN“. Einzelne Positionen: Rechtsklick ▸ Händler zuweisen.\n\n"
+               "     oder das Häkchen „Nachnamen in GROSSBUCHSTABEN“. Jahresbonus Neuaktivierung:\n"
+               "     Standard-Staffel oder eigene Staffel je Händler.\n"
+               "     Einzelne Positionen: Rechtsklick > Händler zuweisen.\n\n"
                "2.  Neue Abrechnung (Strg+N), z. B. „Oktober 2026“.\n\n"
                "3.  Dateien importieren (Strg+I) – mehrere CSV/Excel auf einmal möglich,\n"
                "     auch alle Wochenlisten eines Monats.\n\n"
                "4.  Links den Händler wählen. Positionen sind nach Provisionsart gruppiert.\n"
-               "     • Gruppe wählen + „Prozent…“ (F4): Auszahlung für die ganze Provisionsart,\n"
+               "     - Gruppe wählen + „Prozent...“ (F4): Auszahlung für die ganze Provisionsart,\n"
                "       optional als Standard für diesen Händler merken.\n"
-               "     • Doppelklick / F2 auf eine Position: Betrag frei ändern\n"
+               "     - Doppelklick / F2 auf eine Position: Betrag frei ändern\n"
-               "       (Enter = speichern, ↓/Tab = nächste Zeile, Esc = abbrechen).\n\n"
+               "       (Enter = speichern, Pfeil runter/Tab = nächste Zeile, Esc = abbrechen).\n\n"
-               "5.  Exportieren (Strg+E): je Händler eine Excel-Datei im Abrechnungsformat.\n\n"
+               "5.  Exportieren (Strg+E): je Händler eine Excel-Datei im Abrechnungsformat (freenet\n"
+               "     und Vodafone zusammen, Airtime als eine Summenzeile) und eine Airtime-Liste.\n"
+               "     Positionen mit 0,00 € werden weggelassen.\n\n"
+               "Welche Provisionsart Airtime bzw. Jahresbonus ist, wird automatisch erkannt –\n"
+               "umstellbar unter Händler > Provisionsarten.\n\n"
                "Alles wird automatisch in der Datenbank gespeichert.")
 
-    def _willkommen(self):
+    def assistent(self):
-        if not self.db.haendler_liste():
+        res = ass.Einrichtungsassistent(self).zeigen()
-            if w.frage(self.root, "Willkommen",
+        if self._schliesst:
-                       f"Willkommen beim {APP_NAME}!\n\nEs sind noch keine Händler angelegt.\n"
+            return  # Programm wird gerade beendet – beim nächsten Start erscheint der Assistent erneut
-                       "Jetzt die Unterhändler mit ihren Kennungen anlegen?"):
+        self.settings["assistent_erledigt"] = True
-                self.haendler()
+        config.save(self.settings)
+        self._aktualisieren()
+        if not res:
+            return
+        if res["titel"]:
+            self.aid = self.db.abrechnung_neu(res["titel"])
+            self.ansicht = ALLE
+            self._aktualisieren()
+            if res["dateien"]:
+                self.importieren(res["dateien"])
+        if res["rundgang"]:
+            self.root.after(200, self.rundgang)
+
+    def rundgang(self):
+        if self._schliesst:
+            return
+        tb = self.tb
+        schritte = [
+            (self.rahmen.titelleiste or self.menueleiste, "Willkommen zum Rundgang!",
+             "In ein paar Schritten sehen Sie, wo Sie was finden.\n\nWeiter geht es mit „Weiter >“ oder der "
+             "Eingabetaste, beenden können Sie jederzeit mit Esc."),
+            (tb["Händler"], "Händler",
+             "Hier legen Sie Ihre Unterhändler an: Name, Auszahlung in % und woran ihre Positionen erkannt werden "
+             "(freenet-Unterhändlernummer, Vodafone-VO-Nr. oder Kundenname in GROSSBUCHSTABEN)."),
+            (tb["Neu"], "Neue Abrechnung",
+             "Für jeden Abrechnungszeitraum – meist ein Monat – legen Sie eine neue Abrechnung an. "
+             "Mit „Öffnen“ holen Sie frühere Abrechnungen wieder hervor."),
+            (tb["Import"], "Dateien importieren",
+             "Wählen Sie die CSV- und Excel-Dateien von freenet und Vodafone – gerne mehrere auf einmal. "
+             "Das Programm erkennt das Format selbst und warnt bei doppelt importierten Dateien."),
+            (self.f_h, "Händlerliste",
+             "Links sehen Sie jeden Händler mit Anzahl der Positionen und Auszahlungssumme.\n\n"
+             "„(Nicht zugeordnet)“ ist alles, was keinem Unterhändler gehört – meist Ihre eigene Filiale. "
+             "Das wird nicht exportiert."),
+            (self.f_p, "Positionen prüfen",
+             "Rechts stehen die Positionen des gewählten Händlers, gruppiert nach Provisionsart.\n\n"
+             "- Doppelklick auf eine Position: Betrag frei ändern\n"
+             "- Rechtsklick: Auszahlung 0 €, Händler zuweisen, ...\n"
+             "- Blau = von Hand geändert, Rot = durch Prozent-Regel geändert"),
+            (self.b_prozent, "Auszahlung in Prozent",
+             "Graue Gruppenzeile (Provisionsart) markieren und hier klicken – z. B. 80 % für den Sonderbonus. "
+             "Mit „Als Standard merken“ gilt das auch in den nächsten Monaten automatisch."),
+            (tb["Export"], "Exportieren",
+             "Zum Schluss erstellt „Export“ für jeden Händler eine Excel-Datei im gewohnten Abrechnungsformat "
+             "(Airtime darin als eine Summenzeile) und – falls vorhanden – die Airtime-Liste."),
+            (self.status, "Summen",
+             "Unten sehen Sie immer die Summe der angezeigten bzw. markierten Positionen: "
+             "Provision laut Anbieter und Ihre Auszahlung."),
+            (self._suchrahmen, "Suchen",
+             "Rufnummer, Name oder Tarif eingeben – die Liste filtert sofort. Tastenkürzel: Strg+F."),
+            (self.menueleiste.knoepfe["?"], "Das war's!",
+             "Diesen Rundgang, den Einrichtungs-Assistenten und die Tipps finden Sie jederzeit hier im Menü „?“.\n\n"
+             "Viel Erfolg mit dem Provisions-Manager 95!"),
+        ]
+        self._rundgang = ass.Rundgang(self, schritte)
+
+    def tipp_des_tages(self):
+        ass.TippDesTages(self).zeigen()
+        config.save(self.settings)
 
     def _fehler_handler(self, exc, val, tb):
         text = "".join(traceback.format_exception(exc, val, tb))
         try:
             with (config.app_dir() / "fehler.log").open("a", encoding="utf-8") as f:
-                f.write(text + "\n")
+                f.write(f"--- {date.today().isoformat()} {APP_NAME}\n{text}\n")
         except OSError:
             pass
+        # Beim/nach dem Beenden keine Meldung mehr zeigen – das Fenster gibt es dann nicht mehr
+        if self._beendet or self._schliesst or not self._lebt():
+            return
+        try:
             w.fehler(self.root, "Allgemeine Schutzverletzung",
                      f"Im Programm ist ein Fehler aufgetreten:\n\n{val}\n\n"
                      f"Details stehen in {config.app_dir() / 'fehler.log'}")
+        except tk.TclError:
+            pass
+
+    def _lebt(self) -> bool:
+        try:
+            return bool(self.root.winfo_exists())
+        except tk.TclError:
+            return False
+
+    def _offene_fenster(self) -> list[tk.Toplevel]:
+        """Alle offenen Dialoge (auch verschachtelte), innerste zuletzt."""
+        out: list[tk.Toplevel] = []
+
+        def suche(widget):
+            for kind in widget.winfo_children():
+                if isinstance(kind, tk.Toplevel):
+                    out.append(kind)
+                suche(kind)
+        if self._lebt():
+            suche(self.root)
+        return out
 
     def beenden(self):
+        """Programm schließen – auch wenn gerade Dialoge, Rückfragen oder der Rundgang offen sind.
+
+        Offene Dialoge werden zuerst geschlossen; der Code, der auf sie gewartet hat, läuft dann mit
+        „abgebrochen“ zu Ende (Datenbank noch offen). Neue Dialoge öffnen sich in dieser Phase nicht
+        mehr. Erst danach werden Einstellungen gespeichert, Datenbank und Fenster geschlossen."""
+        if self._beendet or not self._lebt():
+            return
+        self._schliesst = True
+        self.root._provtool_schliesst = True  # type: ignore[attr-defined]  # Signal an win95.Dialog
+        rg = getattr(self, "_rundgang", None)
+        if rg is not None:
+            rg.beenden()
+        if self._edit is not None:
+            self._edit.destroy()
+            self._edit = None
+        offen = self._offene_fenster()
+        if offen:
+            for t in reversed(offen):
                 try:
-            self.settings["fenster"] = self.root.geometry()
+                    if t.winfo_exists():
+                        t.destroy()
+                except tk.TclError:
+                    pass
+            self.root.after(30, self.beenden)  # wenn alle wartenden Abläufe zurückgekehrt sind
+            return
+        self._beendet = True
+        try:
+            self.settings["trenner"] = self.pw.sash_coord(0)[0]
+            self.settings["fenster"] = self.rahmen.normale_geometrie()
+            self.settings["maximiert"] = self.rahmen.maximiert
             config.save(self.settings)
+        except (tk.TclError, OSError):
+            pass
+        finally:
+            try:
                 self.db.close()
             finally:
+                try:
                     self.root.destroy()
+                except tk.TclError:
+                    pass
+
+
+def _ist_staffel(p: dict) -> bool:
+    """Betrag kommt aus der Jahresbonus-Staffel (nicht aus einem Prozentsatz)."""
+    return p.get("typ") == regeln.JAHRESBONUS and p["prozent"] is None and not p["manuell"] and p["haendler_id"] > 0
 
 
 def main():
+    if len(sys.argv) > 1 and sys.argv[1] == "--selbsttest":
+        from provtool.selbsttest import ausfuehren
+        sys.exit(ausfuehren(sys.argv[2] if len(sys.argv) > 2 else "selbsttest.txt"))
     if sys.platform.startswith("win"):
         try:  # scharfe Darstellung auf HiDPI-Bildschirmen
             import ctypes

provtool/gui/assistent.py

@@ -0,0 +1,616 @@
+"""Ersteinrichtung im Stil der Windows-95-Setup-Assistenten, Programm-Rundgang und „Tipp des Tages“."""
+from __future__ import annotations
+
+import re
+import tkinter as tk
+from collections import Counter, defaultdict
+from pathlib import Path
+from tkinter import filedialog, ttk
+
+from provtool import APP_NAME
+from provtool.db import CAPS_ANBIETER, CAPS_WERT, Haendler, ist_grossgeschrieben
+from provtool.gui import win32
+from provtool.gui import win95 as w
+from provtool.importer import lies_datei
+from provtool.money import fmt, parse_percent
+
+DATEITYPEN = [("Abrechnungen (CSV, Excel)", "*.csv *.xlsx *.xlsm *.xls *.txt"), ("Alle Dateien", "*.*")]
+
+
+def _nummern(text: str) -> list[str]:
+    """'11111102 (6 Pos.), 27518999' -> ['11111102', '27518999']"""
+    out = []
+    for teil in text.split(","):
+        m = re.match(r"\s*([A-Za-z0-9]+)", teil)
+        if m:
+            out.append(m.group(1))
+    return out
+
+
+# =========================================================================== Assistent
+
+class Einrichtungsassistent(w.Dialog):
+    BREITE, HOEHE = 470, 340
+
+    def __init__(self, app):
+        super().__init__(app.root, "Provisions-Manager 95 – Einrichtung")
+        self.app = app
+        self.dateien: list[str] = []
+        self.vorschlaege: dict[str, list[str]] = {"freenet": [], "vodafone": []}
+        self.caps_anzahl = 0
+
+        haupt = tk.Frame(self, bg=w.FACE)
+        haupt.pack(fill="both", expand=True, padx=10, pady=10)
+        bild = tk.Canvas(haupt, width=150, height=self.HOEHE, bg=w.TEAL, bd=2, relief="sunken",
+                         highlightthickness=0)
+        bild.pack(side="left", fill="y")
+        self._bild(bild)
+        self.seite = tk.Frame(haupt, bg=w.FACE, width=self.BREITE, height=self.HOEHE)
+        self.seite.pack(side="left", fill="both", expand=True, padx=(14, 0))
+        self.seite.pack_propagate(False)
+
+        w.trenner(self, vertikal=False).pack(fill="x", padx=10)
+        k = tk.Frame(self, bg=w.FACE)
+        k.pack(fill="x", padx=10, pady=10)
+        self.b_abbr = w.knopf(k, "Abbrechen", self.abbrechen, breite=10)
+        self.b_abbr.pack(side="right")
+        self.b_weiter = w.knopf(k, "Weiter >", self._weiter, breite=10, default="active")
+        self.b_weiter.pack(side="right", padx=(0, 10))
+        self.b_zurueck = w.knopf(k, "< Zurück", self._zurueck, breite=10)
+        self.b_zurueck.pack(side="right")
+        self.bind("<Return>", lambda e: self._weiter() if not isinstance(e.widget, tk.Entry) else None)
+
+        self.v_titel = tk.StringVar(value=app._vorschlag_titel())
+        self.v_abrechnung = tk.BooleanVar(value=True)
+        self.v_rundgang = tk.BooleanVar(value=True)
+        self.v_db_eigen = tk.BooleanVar(value=bool(app.settings.get("db_pfad")))
+        self.v_db_pfad = tk.StringVar(value=str(app.db.path))
+
+        self.seiten = [self._s_willkommen, self._s_datenbank, self._s_haendler, self._s_abrechnung, self._s_fertig]
+        self.nr = 0
+        self._zeige(0)
+
+    # ---------------------------------------------------------------- Rahmen
+    def _bild(self, c: tk.Canvas):
+        self._img = w.make_icon(self, "app", 7)
+        c.create_rectangle(0, self.HOEHE - 70, 160, self.HOEHE + 10, fill="#006060", outline="")
+        for i, (x, y) in enumerate(((20, 30), (120, 55), (35, 120), (128, 150), (60, 20))):
+            c.create_rectangle(x, y, x + 2 + i % 2, y + 2 + i % 2, fill=w.WHITE, outline="")
+        c.create_image(77, self.HOEHE // 2 - 10, image=self._img)
+        c.create_text(77, self.HOEHE - 38, text="Provisions-\nManager 95", fill=w.WHITE, font=w.FONT_BOLD,
+                      justify="center")
+
+    def _leeren(self):
+        for kind in self.seite.winfo_children():
+            kind.destroy()
+
+    def _ueberschrift(self, text: str):
+        tk.Label(self.seite, text=text, font=w.FONT_BIG, anchor="w", justify="left",
+                 wraplength=self.BREITE).pack(fill="x", pady=(0, 10))
+
+    def _text(self, text: str, master=None, **kw):
+        lbl = tk.Label(master or self.seite, text=text, anchor="w", justify="left", wraplength=self.BREITE, **kw)
+        lbl.pack(fill="x", pady=(0, 6))
+        return lbl
+
+    def _zeige(self, nr: int):
+        self.nr = nr
+        self._leeren()
+        self.seiten[nr]()
+        self.b_zurueck.configure(state="normal" if nr > 0 else "disabled")
+        self.b_weiter.configure(text="Fertig stellen" if nr == len(self.seiten) - 1 else "Weiter >")
+        if self.titelleiste:
+            self.titelleiste.set_titel(f"Provisions-Manager 95 – Einrichtung (Schritt {nr + 1} von {len(self.seiten)})")
+
+    def _weiter(self):
+        pruefer = getattr(self, f"_pruefe_{self.nr}", None)
+        if pruefer and not pruefer():
+            return
+        if self.nr == len(self.seiten) - 1:
+            self.result = dict(titel=self.v_titel.get().strip() if self.v_abrechnung.get() else "",
+                               dateien=list(self.dateien) if self.v_abrechnung.get() else [],
+                               rundgang=self.v_rundgang.get())
+            self.destroy()
+            return
+        self._zeige(self.nr + 1)
+
+    def _zurueck(self):
+        if self.nr > 0:
+            self._zeige(self.nr - 1)
+
+    def abbrechen(self):
+        if w.frage(self, "Einrichtung abbrechen",
+                   "Möchten Sie die Einrichtung wirklich abbrechen?\n\n"
+                   "Bereits angelegte Händler bleiben gespeichert. Den Assistenten finden Sie jederzeit "
+                   "unter  ?  >  Einrichtungs-Assistent.", default_ja=False):
+            self.result = None
+            self.destroy()
+
+    # ---------------------------------------------------------------- Seite 1
+    def _s_willkommen(self):
+        self._ueberschrift(f"Willkommen beim {APP_NAME}!")
+        self._text("Dieser Assistent richtet das Programm in wenigen Schritten ein:")
+        for punkt in ("Speicherort der Daten festlegen",
+                      "Unterhändler mit ihren Kennungen anlegen",
+                      "die erste Abrechnung anlegen und Dateien importieren"):
+            self._text(f"     -  {punkt}")
+        self._text("\nDanach zeigt Ihnen ein kurzer Rundgang, wo Sie was finden.\n\n"
+                   "Alle Angaben lassen sich später jederzeit ändern.")
+        self._text("Klicken Sie auf „Weiter“, um fortzufahren.", fg=w.NAVY)
+
+    # ---------------------------------------------------------------- Seite 2
+    def _s_datenbank(self):
+        self._ueberschrift("Wo sollen die Daten gespeichert werden?")
+        self._text("In der Datenbank liegen Ihre Händler, die Auszahlungsregeln und alle Abrechnungen "
+                   "mit Ihren Änderungen.")
+        f = tk.Frame(self.seite, bg=w.FACE)
+        f.pack(fill="x", pady=6)
+        from provtool import config
+        standard = str(config.app_dir() / "provisionen.db")
+        tk.Radiobutton(f, text="Auf diesem Computer (empfohlen)", variable=self.v_db_eigen, value=False,
+                       command=lambda: self.v_db_pfad.set(standard)).pack(anchor="w")
+        tk.Label(f, text=standard, fg=w.SHADOW, anchor="w", wraplength=self.BREITE - 30,
+                 justify="left").pack(anchor="w", padx=22)
+        tk.Radiobutton(f, text="An einem eigenen Ort, z. B. auf einem Netzlaufwerk:", variable=self.v_db_eigen,
+                       value=True).pack(anchor="w", pady=(10, 0))
+        zeile = tk.Frame(f, bg=w.FACE)
+        zeile.pack(fill="x", padx=22, pady=2)
+        e = tk.Entry(zeile, textvariable=self.v_db_pfad)
+        e.pack(side="left", fill="x", expand=True)
+        e.bind("<Key>", lambda ev: self.v_db_eigen.set(True))
+        w.knopf(zeile, "Durchsuchen...", self._db_waehlen).pack(side="left", padx=(4, 0))
+        self._text("\nTipp: Auf einem Netzlaufwerk können mehrere PCs dieselben Händler nutzen – "
+                   "bitte aber nicht gleichzeitig damit arbeiten.", fg=w.SHADOW)
+
+    def _db_waehlen(self):
+        p = filedialog.asksaveasfilename(parent=self, title="Speicherort der Datenbank", defaultextension=".db",
+                                         initialfile="provisionen.db", confirmoverwrite=False,
+                                         filetypes=[("Datenbank", "*.db"), ("Alle Dateien", "*.*")])
+        if p:
+            self.v_db_pfad.set(p)
+            self.v_db_eigen.set(True)
+
+    def _pruefe_1(self) -> bool:
+        from provtool import config
+        ziel = self.v_db_pfad.get().strip() if self.v_db_eigen.get() else str(config.app_dir() / "provisionen.db")
+        if not ziel:
+            w.warnung(self, "Speicherort", "Bitte einen Speicherort angeben.")
+            return False
+        if Path(ziel) != Path(self.app.db.path):
+            try:
+                self.app.db_wechseln(ziel if self.v_db_eigen.get() else None)
+            except Exception as exc:
+                w.fehler(self, "Speicherort", f"Die Datenbank konnte nicht angelegt werden:\n{exc}")
+                return False
+        return True
+
+    # ---------------------------------------------------------------- Seite 3
+    def _s_haendler(self):
+        db = self.app.db
+        tk.Label(self.seite, text="Unterhändler anlegen", font=w.FONT_BIG, anchor="w").pack(fill="x")
+        self._text("Für jeden Unterhändler: Name, Auszahlung und woran seine Positionen zu erkennen sind. "
+                   "Ihre eigene Filiale legen Sie nicht an.", fg=w.SHADOW)
+
+        g = tk.Frame(self.seite, bg=w.FACE)
+        g.pack(fill="x")
+        self.v_name, self.v_proz = tk.StringVar(), tk.StringVar(value="100")
+        self.v_fn, self.v_vf, self.v_caps = tk.StringVar(), tk.StringVar(), tk.BooleanVar()
+        tk.Label(g, text="Name / Firma:").grid(row=0, column=0, sticky="w", pady=1)
+        e_name = tk.Entry(g, textvariable=self.v_name)
+        e_name.grid(row=0, column=1, columnspan=2, sticky="we", pady=1)
+        tk.Label(g, text="Auszahlung:").grid(row=1, column=0, sticky="w", pady=1)
+        pf = tk.Frame(g, bg=w.FACE)
+        pf.grid(row=1, column=1, sticky="w")
+        tk.Entry(pf, textvariable=self.v_proz, width=6, justify="right").pack(side="left")
+        tk.Label(pf, text="% der Provision").pack(side="left", padx=4)
+        tk.Label(g, text="freenet Unterhändler-Nr.:").grid(row=2, column=0, sticky="w", pady=1)
+        self.cb_fn = ttk.Combobox(g, textvariable=self.v_fn, values=self.vorschlaege["freenet"])
+        self.cb_fn.grid(row=2, column=1, columnspan=2, sticky="we", pady=1)
+        tk.Label(g, text="Vodafone VO-Nr.:").grid(row=3, column=0, sticky="w", pady=1)
+        self.cb_vf = ttk.Combobox(g, textvariable=self.v_vf, values=self.vorschlaege["vodafone"])
+        self.cb_vf.grid(row=3, column=1, columnspan=2, sticky="we", pady=1)
+        caps_besitzer = db.kennung_map().get((CAPS_ANBIETER, CAPS_WERT))
+        caps_text = "Vodafone-Kunden mit Nachnamen in GROSSBUCHSTABEN gehören zu diesem Händler"
+        if self.caps_anzahl:
+            caps_text += f" ({self.caps_anzahl} Pos. in der Datei)"
+        cb = tk.Checkbutton(g, text=caps_text, variable=self.v_caps, wraplength=self.BREITE - 30, justify="left")
+        cb.grid(row=4, column=0, columnspan=3, sticky="w", pady=(2, 0))
+        if caps_besitzer:
+            cb.configure(state="disabled", text=f"GROSSBUCHSTABEN-Regel: bereits bei „{db.haendler(caps_besitzer).name}“")
+        g.columnconfigure(1, weight=1)
+
+        k = tk.Frame(self.seite, bg=w.FACE)
+        k.pack(fill="x", pady=(4, 4))
+        w.knopf(k, "Händler hinzufügen", self._haendler_dazu, self.app.icons("haendler")).pack(side="left")
+        w.knopf(k, "Nummern aus Abrechnung vorschlagen...", self._vorschlagen).pack(side="left", padx=6)
+
+        tk.Label(self.seite, text="Bereits angelegt:", anchor="w").pack(fill="x")
+        lf = tk.Frame(self.seite, bg=w.FACE)
+        lf.pack(fill="both", expand=True)
+        self.lb = tk.Listbox(lf, height=4, activestyle="none")
+        self.lb.pack(side="left", fill="both", expand=True)
+        w.knopf(lf, "Entfernen", self._haendler_weg).pack(side="left", anchor="n", padx=(6, 0))
+        self._liste()
+        e_name.focus_set()
+
+    def _liste(self):
+        self.lb.delete(0, "end")
+        self._lb_ids = []
+        for h in self.app.db.haendler_liste():
+            teile = []
+            for anb, wert in self.app.db.kennungen(h.id):
+                teile.append("GROSSBUCHSTABEN" if anb == CAPS_ANBIETER else f"{anb} {wert}")
+            proz = f"{h.standard_prozent:g} %".replace(".", ",")
+            self.lb.insert("end", f"{h.name}  –  {proz}  –  {', '.join(teile) or 'keine Kennung'}")
+            self._lb_ids.append(h.id)
+
+    def _haendler_dazu(self) -> bool:
+        name = self.v_name.get().strip()
+        if not name:
+            w.warnung(self, "Händler", "Bitte einen Namen eingeben.")
+            return False
+        try:
+            proz = parse_percent(self.v_proz.get())
+        except ValueError:
+            w.warnung(self, "Händler", "Die Auszahlung muss eine Zahl sein, z. B. 100 oder 85.")
+            return False
+        kenn = [("freenet", n) for n in _nummern(self.v_fn.get())]
+        kenn += [("vodafone", n) for n in _nummern(self.v_vf.get())]
+        if self.v_caps.get():
+            kenn.append((CAPS_ANBIETER, CAPS_WERT))
+        if not kenn and not w.frage(self, "Händler", f"Für „{name}“ ist keine Kennung angegeben – ihm werden "
+                                                    "daher keine Positionen zugeordnet.\n\nTrotzdem anlegen?"):
+            return False
+        try:
+            self.app.db.haendler_speichern(Haendler(0, name, standard_prozent=proz), kenn)
+        except Exception as exc:
+            msg = str(exc)
+            if "UNIQUE" in msg:
+                msg = f"Es gibt bereits einen Händler „{name}“."
+            w.fehler(self, "Händler", msg)
+            return False
+        for v in (self.v_name, self.v_fn, self.v_vf):
+            v.set("")
+        self.v_proz.set("100")
+        self._zeige(self.nr)  # neu aufbauen (GROSSBUCHSTABEN-Regel evtl. vergeben)
+        return True
+
+    def _haendler_weg(self):
+        sel = self.lb.curselection()
+        if sel:
+            self.app.db.haendler_loeschen(self._lb_ids[sel[0]])
+            self._zeige(self.nr)
+
+    def _vorschlagen(self):
+        dateien = filedialog.askopenfilenames(parent=self, title="Abrechnung zum Auslesen der Nummern wählen",
+                                              filetypes=DATEITYPEN)
+        if not dateien:
+            return
+        anzahl: dict[str, Counter] = defaultdict(Counter)
+        summe: dict[tuple[str, str], int] = defaultdict(int)
+        caps = 0
+        fehler = []
+        for f in dateien:
+            try:
+                erg = lies_datei(f)
+            except Exception as exc:
+                fehler.append(f"{Path(f).name}: {exc}")
+                continue
+            if f not in self.dateien:
+                self.dateien.append(f)
+            for p in erg.positionen:
+                anzahl[p.anbieter][p.kennung] += 1
+                summe[(p.anbieter, p.kennung)] += p.betrag_cent
+                if p.anbieter == "vodafone" and ist_grossgeschrieben(p.name):
+                    caps += 1
+        vergeben = self.app.db.kennung_map()
+        for anb in ("freenet", "vodafone"):
+            self.vorschlaege[anb] = [f"{k}  ({n} Pos., {fmt(summe[(anb, k)])})"
+                                     for k, n in anzahl[anb].most_common() if k and (anb, k) not in vergeben]
+        self.caps_anzahl = caps
+        self._zeige(self.nr)
+        if fehler:
+            w.warnung(self, "Nummern vorschlagen", "Nicht lesbar:\n" + "\n".join(fehler))
+        else:
+            w.info(self, "Nummern vorschlagen",
+                   "Die gefundenen Nummern stehen jetzt in den Auswahllisten (Pfeil-Knopf rechts) bei freenet und Vodafone – "
+                   "sortiert nach Anzahl der Positionen.\n\nDie Nummer mit den meisten Positionen ist meist "
+                   "Ihre eigene Filiale.\n\nDie Dateien werden im nächsten Schritt gleich mit importiert.")
+
+    def _pruefe_2(self) -> bool:
+        if self.v_name.get().strip():
+            if w.frage(self, "Händler", f"„{self.v_name.get().strip()}“ wurde noch nicht hinzugefügt.\n\n"
+                                        "Jetzt hinzufügen?"):
+                return self._haendler_dazu() and False  # Seite bleibt offen, Liste ist aktualisiert
+        if not self.app.db.haendler_liste():
+            return w.frage(self, "Händler", "Es ist noch kein Händler angelegt.\n\n"
+                                            "Trotzdem weiter? (Händler lassen sich später unter „Händler“ anlegen.)",
+                           default_ja=False)
+        return True
+
+    # ---------------------------------------------------------------- Seite 4
+    def _s_abrechnung(self):
+        self._ueberschrift("Die erste Abrechnung")
+        self._text("Pro Abrechnungszeitraum (meist ein Monat) legen Sie eine Abrechnung an und importieren "
+                   "dort alle Dateien dieses Zeitraums – z. B. alle freenet-Wochenlisten und die Vodafone-Datei.")
+        tk.Checkbutton(self.seite, text="Jetzt eine Abrechnung anlegen", variable=self.v_abrechnung,
+                       command=self._s_abrechnung_status).pack(anchor="w")
+        f = tk.Frame(self.seite, bg=w.FACE)
+        f.pack(fill="both", expand=True, padx=(22, 0))
+        z = tk.Frame(f, bg=w.FACE)
+        z.pack(fill="x", pady=4)
+        tk.Label(z, text="Bezeichnung:").pack(side="left")
+        self._e_titel = tk.Entry(z, textvariable=self.v_titel, width=28)
+        self._e_titel.pack(side="left", padx=6)
+        tk.Label(f, text="Diese Dateien gleich importieren (optional):", anchor="w").pack(fill="x", pady=(6, 2))
+        lf = tk.Frame(f, bg=w.FACE)
+        lf.pack(fill="both", expand=True)
+        self.lb_d = tk.Listbox(lf, height=5)
+        self.lb_d.pack(side="left", fill="both", expand=True)
+        kf = tk.Frame(lf, bg=w.FACE)
+        kf.pack(side="left", anchor="n", padx=(6, 0))
+        self._b_dazu = w.knopf(kf, "Hinzufügen...", self._datei_dazu, breite=11)
+        self._b_dazu.pack(pady=(0, 4))
+        self._b_weg = w.knopf(kf, "Entfernen", self._datei_weg, breite=11)
+        self._b_weg.pack()
+        for d in self.dateien:
+            self.lb_d.insert("end", Path(d).name)
+        self._s_abrechnung_status()
+
+    def _s_abrechnung_status(self):
+        st = "normal" if self.v_abrechnung.get() else "disabled"
+        for wdg in (self._e_titel, self.lb_d, self._b_dazu, self._b_weg):
+            wdg.configure(state=st)
+
+    def _datei_dazu(self):
+        for f in filedialog.askopenfilenames(parent=self, title="Dateien zum Import wählen", filetypes=DATEITYPEN):
+            if f not in self.dateien:
+                self.dateien.append(f)
+                self.lb_d.insert("end", Path(f).name)
+
+    def _datei_weg(self):
+        sel = self.lb_d.curselection()
+        if sel:
+            del self.dateien[sel[0]]
+            self.lb_d.delete(sel[0])
+
+    def _pruefe_3(self) -> bool:
+        if self.v_abrechnung.get() and not self.v_titel.get().strip():
+            w.warnung(self, "Abrechnung", "Bitte eine Bezeichnung eingeben, z. B. „Oktober 2026“.")
+            return False
+        return True
+
+    # ---------------------------------------------------------------- Seite 5
+    def _s_fertig(self):
+        self._ueberschrift("Fertig!")
+        n = len(self.app.db.haendler_liste())
+        self._text(f"Der {APP_NAME} ist eingerichtet.")
+        self._text(f"     -  {n} Händler angelegt")
+        if self.v_abrechnung.get():
+            self._text(f"     -  Abrechnung „{self.v_titel.get().strip()}“"
+                       + (f" mit {len(self.dateien)} Datei(en)" if self.dateien else " (noch ohne Dateien)"))
+        self._text("\nSo geht es danach jeden Monat weiter:\n"
+                   "     Neu  >  Import  >  prüfen & anpassen  >  Export")
+        tk.Checkbutton(self.seite, text="Kurzen Rundgang durch das Programm starten", variable=self.v_rundgang
+                       ).pack(anchor="w", pady=(12, 0))
+        self._text("\nKlicken Sie auf „Fertig stellen“.", fg=w.NAVY)
+
+
+# =========================================================================== Rundgang
+
+class Rundgang:
+    """Führt mit gelben Hinweis-Sprechblasen durch die Oberfläche und rahmt das jeweilige Element rot ein."""
+
+    def __init__(self, app, schritte: list[tuple]):
+        """schritte: (widget_oder_funktion, titel, text)"""
+        self.app, self.root, self.schritte = app, app.root, schritte
+        self.nr = 0
+        self.blase: tk.Toplevel | None = None
+        self.rahmen: list[tk.Toplevel] = []
+        self._sperre = None  # Windows: Hauptfenster während des Rundgangs gesperrt (win32.Modal)
+        self._zeige(0)
+
+    @staticmethod
+    def _entsorgen(blase, rahmen):
+        for r in rahmen:
+            try:
+                r.destroy()
+            except tk.TclError:
+                pass
+        if blase is not None:
+            try:
+                blase.grab_release()
+            except tk.TclError:
+                pass
+            try:
+                blase.destroy()
+            except tk.TclError:
+                pass
+
+    def _weg(self):
+        self._entsorgen(self.blase, self.rahmen)
+        self.rahmen = []
+        self.blase = None
+
+    def beenden(self):
+        if self._sperre is not None:  # vor dem Schließen freigeben, sonst springt Windows woandershin
+            self._sperre.beenden()
+            self._sperre = None
+        self._weg()
+
+    def _markieren(self, x, y, bw, bh, dicke=3, farbe="#ff0000"):
+        for gx, gy, gw, gh in ((x - dicke, y - dicke, bw + 2 * dicke, dicke), (x - dicke, y + bh, bw + 2 * dicke, dicke),
+                               (x - dicke, y, dicke, bh), (x + bw, y, dicke, bh)):
+            t = tk.Toplevel(self.root, bg=farbe)
+            t.overrideredirect(True)  # kein transient() – siehe win32.py
+            t.geometry(f"{max(1, gw)}x{max(1, gh)}+{gx}+{gy}")
+            t.update_idletasks()
+            win32.besitzer_setzen(t, self.root)  # bleibt über dem Hauptfenster, auch nach Alt+Tab
+            self.rahmen.append(t)
+
+    def _zeige(self, nr: int):
+        # Die alte Sprechblase verschwindet erst, wenn die neue steht: Wäre kurz kein Popup da,
+        # während das Hauptfenster gesperrt ist, würde Windows ein fremdes Programm aktivieren.
+        alt_blase, alt_rahmen = self.blase, self.rahmen
+        self.blase, self.rahmen = None, []
+        if getattr(self.root, "_provtool_schliesst", False):
+            self._entsorgen(alt_blase, alt_rahmen)
+            return
+        self.nr = nr
+        ziel, titel, text = self.schritte[nr]
+        if callable(ziel) and not isinstance(ziel, tk.Misc):
+            ziel = ziel()
+        self.root.update_idletasks()
+        x, y = ziel.winfo_rootx(), ziel.winfo_rooty()
+        bw, bh = ziel.winfo_width(), ziel.winfo_height()
+        self._markieren(x, y, bw, bh)
+
+        b = self.blase = tk.Toplevel(self.root, bg=w.DARK)
+        b.abbrechen = self.beenden  # Alt+F4 auf der Sprechblase beendet den Rundgang sauber
+        b.withdraw()
+        b.overrideredirect(True)  # kein transient() – Besitzer setzt win32.Modal
+        innen = tk.Frame(b, bg=w.INFO_BG, padx=10, pady=8)
+        innen.pack(padx=1, pady=1)
+        kopf = tk.Frame(innen, bg=w.INFO_BG)
+        kopf.pack(fill="x")
+        self._ic = w.make_icon(b, "birne")
+        tk.Label(kopf, image=self._ic, bg=w.INFO_BG).pack(side="left")
+        tk.Label(kopf, text=titel, bg=w.INFO_BG, font=w.FONT_BOLD).pack(side="left", padx=6)
+        tk.Label(innen, text=text, bg=w.INFO_BG, justify="left", anchor="w", wraplength=330).pack(fill="x", pady=(6, 8))
+        fuss = tk.Frame(innen, bg=w.INFO_BG)
+        fuss.pack(fill="x")
+        tk.Label(fuss, text=f"Schritt {nr + 1} von {len(self.schritte)}", bg=w.INFO_BG,
+                 fg=w.SHADOW).pack(side="left")
+        letzter = nr == len(self.schritte) - 1
+        w.knopf(fuss, "Fertig" if letzter else "Weiter >", self._weiter, default="active").pack(side="right")
+        zb = w.knopf(fuss, "< Zurück", self._zurueck)
+        zb.pack(side="right", padx=4)
+        if nr == 0:
+            zb.configure(state="disabled")
+        if not letzter:
+            w.knopf(fuss, "Beenden", self.beenden).pack(side="right", padx=(0, 8))
+        b.bind("<Return>", lambda e: self._weiter())
+        b.bind("<Right>", lambda e: self._weiter())
+        b.bind("<Left>", lambda e: self._zurueck())
+        b.bind("<Escape>", lambda e: self.beenden())
+
+        # Position: unter dem Element, sonst darüber, sonst innen oben links; immer im Hauptfenster
+        b.update_idletasks()
+        pw, ph = b.winfo_reqwidth(), b.winfo_reqheight()
+        rx, ry = self.root.winfo_rootx(), self.root.winfo_rooty()
+        rw, rh = self.root.winfo_width(), self.root.winfo_height()
+        if y + bh + 12 + ph <= ry + rh:
+            px, py = x, y + bh + 12
+        elif y - 12 - ph >= ry:
+            px, py = x, y - 12 - ph
+        else:
+            px, py = x + 40, y + 40
+        px = min(max(rx + 8, px), rx + rw - pw - 8)
+        py = min(max(ry + 8, py), ry + rh - ph - 8)
+        b.geometry(f"{pw}x{ph}+{px}+{py}")
+        b.deiconify()
+        b.lift()
+        b.update_idletasks()
+        b.focus_force()
+        if self._sperre is None:
+            self._sperre = win32.Modal(b, self.root)
+        else:
+            win32.besitzer_setzen(b, self.root)
+        self._entsorgen(alt_blase, alt_rahmen)
+        try:
+            b.grab_set()
+        except tk.TclError:
+            pass
+        b.focus_force()
+
+    def _weiter(self):
+        if self.nr >= len(self.schritte) - 1:
+            self.beenden()
+        else:
+            self._zeige(self.nr + 1)
+
+    def _zurueck(self):
+        if self.nr > 0:
+            self._zeige(self.nr - 1)
+
+
+# =========================================================================== Tipp des Tages
+
+TIPPS = [
+    "Airtime wird pro Händler in Prozent ausgezahlt (0 % = keine Airtime). Im Export steht sie als eine "
+    "Summenzeile, die Einzelposten kommen in eine eigene Airtime-Liste.",
+    "Der Jahresbonus Neuaktivierung richtet sich nach der Anzahl Karten: Die Staffel stellen Sie unter "
+    "Händler > Standard-Staffel ein – oder im Händler-Dialog eine eigene für einzelne Händler.",
+    "Sie können mehrere Dateien gleichzeitig importieren – zum Beispiel alle freenet-Wochenlisten eines Monats "
+    "und die Vodafone-Datei in einem Rutsch.",
+    "Markieren Sie eine ganze Provisionsart (die graue Zeile) und klicken Sie auf „Prozent...“, um z. B. nur 80 % "
+    "auszuzahlen. Mit dem Häkchen „Als Standard merken“ gilt das automatisch auch in den nächsten Monaten.",
+    "Doppelklick auf eine Position – und Sie können den Auszahlungsbetrag direkt überschreiben. Mit Pfeil runter geht es "
+    "gleich in die nächste Zeile.",
+    "Blau dargestellte Beträge wurden von Hand geändert, rote weichen durch eine Prozent-Regel von der "
+    "Provision ab.",
+    "Eine Position soll gar nicht ausgezahlt werden? Rechtsklick > „Auszahlung 0 €“.",
+    "Die GROSSBUCHSTABEN-Regel hat einen Kunden falsch erwischt? Rechtsklick > „Händler zuweisen...“ – diese "
+    "Zuordnung hat immer Vorrang.",
+    "Unter „(Nicht zugeordnet)“ sehen Sie alles, was keinem Unterhändler gehört – meist Ihre eigene Filiale. "
+    "Diese Positionen werden nicht exportiert.",
+    "Mit Strg+F springen Sie ins Suchfeld. Gesucht wird in Rufnummer, Name, Tarif, Provisionsart und mehr.",
+    "Wurde eine Datei versehentlich doppelt oder falsch importiert? Datei > Importierte Dateien... – dort lässt "
+    "sie sich wieder entfernen.",
+    "Erstellen Sie ab und zu eine Datensicherung: Datei > Datensicherung erstellen...",
+    "Alle Änderungen werden sofort gespeichert. Ein „Speichern“-Knopf ist daher nicht nötig.",
+    "Ein Händler wurde erst nach dem Import angelegt? Kein Problem – die Zuordnung passt sich sofort an.",
+]
+
+
+BILDER = Path(__file__).resolve().parent / "bilder"
+
+
+def tipp_bild(master) -> tk.PhotoImage | None:
+    """Der Büroklammer-Assistent für den Tipp des Tages (liegt auch in der .exe, siehe .spec)."""
+    try:
+        return tk.PhotoImage(master=master, file=str(BILDER / "tipp.png"))
+    except tk.TclError:
+        return None
+
+
+class TippDesTages(w.Dialog):
+    def __init__(self, app):
+        super().__init__(app.root, "Tipp des Tages")
+        self.app = app
+        haupt = tk.Frame(self, bg=w.FACE)
+        haupt.pack(padx=12, pady=12)
+        box = tk.Frame(haupt, bg=w.WHITE, bd=2, relief="sunken")
+        box.pack(side="left", fill="both")
+        self._bild = tipp_bild(self)
+        self.bild_ok = self._bild is not None
+        if self._bild is None:  # Ersatz, falls das Bild fehlt
+            self._bild = w.make_icon(self, "birne", 3)
+        tk.Label(box, image=self._bild, bg=w.WHITE).pack(side="left", anchor="n", padx=(12, 4), pady=10)
+        # fester Textbereich: der Tipp bricht darin um und kann nicht mehr abgeschnitten werden
+        rechts = tk.Frame(box, bg=w.WHITE, padx=12, pady=10, width=380, height=self._bild.height() + 20)
+        rechts.pack(side="left", fill="both")
+        rechts.pack_propagate(False)
+        tk.Label(rechts, text="Wussten Sie schon...", bg=w.WHITE, font=(w.FONT_FAMILY, w.FONT_SIZE + 6, "bold"),
+                 anchor="w").pack(fill="x")
+        tk.Frame(rechts, bg=w.DARK, height=1).pack(fill="x", pady=6)
+        self.text = tk.Label(rechts, bg=w.WHITE, justify="left", anchor="nw", wraplength=380 - 2 * 12)
+        self.text.pack(fill="both", expand=True)
+        knoepfe = tk.Frame(haupt, bg=w.FACE)
+        knoepfe.pack(side="left", anchor="n", padx=(10, 0))
+        w.knopf(knoepfe, "Schließen", self.abbrechen, breite=12, default="active").pack(pady=(0, 6))
+        w.knopf(knoepfe, "Nächster Tipp", self._naechster, breite=12).pack()
+        self.v_start = tk.BooleanVar(value=app.settings.get("tipps_beim_start", True))
+        tk.Checkbutton(self, text="Tipps beim Start anzeigen", variable=self.v_start).pack(anchor="w", padx=12,
+                                                                                           pady=(0, 10))
+        self.bind("<Return>", lambda e: self.abbrechen())
+        self._naechster()
+
+    def _naechster(self):
+        nr = self.app.settings.get("tipp_nr", 0) % len(TIPPS)
+        self.text.configure(text=TIPPS[nr])
+        self.app.settings["tipp_nr"] = nr + 1
+
+    def abbrechen(self):
+        self.app.settings["tipps_beim_start"] = self.v_start.get()
+        self.destroy()

provtool/gui/dialogs.py

@@ -5,15 +5,16 @@ import tkinter as tk
 from tkinter import filedialog, ttk
 
 from provtool import APP_NAME, APP_ORG, __version__
+from provtool import regeln
 from provtool.db import CAPS_ANBIETER, CAPS_WERT, Datenbank, Haendler
 from provtool.gui import win95 as w
 from provtool.importer import ANBIETER
+from provtool.money import fmt, fmt_percent, parse_cent, parse_percent
 
-# Auswahl im Händler-Dialog: Schlüssel → Anzeige
+# Auswahl im Händler-Dialog: Schlüssel -> Anzeige
-KENNUNG_ARTEN = {"freenet": "freenet (Unterhändler-Nr.)", "vodafone": "Vodafone (VO-Nr.)",
+KENNUNG_ARTEN = {"freenet": "freenet (Unterhändler-Nr.)", "vodafone": "Vodafone (VO-Nr.)"}
-                 CAPS_ANBIETER: "Vodafone (Name in GROSSBUCHSTABEN)"}
 CAPS_TEXT = "Kunden-Nachname komplett in GROSSBUCHSTABEN"
-from provtool.money import fmt, fmt_percent, parse_percent
+CAPS_HAKEN = "Vodafone-Kunden mit Nachnamen in GROSSBUCHSTABEN gehören zu diesem Händler"
 
 
 # =========================================================================== Händlerverwaltung
@@ -51,6 +52,7 @@ class HaendlerDialog(w.Dialog):
         g.pack(fill="x")
         self.v_name, self.v_ap, self.v_mail = tk.StringVar(), tk.StringVar(), tk.StringVar()
         self.v_proz, self.v_aktiv = tk.StringVar(value="100"), tk.BooleanVar(value=True)
+        self.v_air = tk.StringVar(value="0")
         for r, (lbl, var) in enumerate((("Name / Firma:", self.v_name), ("Ansprechpartner:", self.v_ap),
                                         ("E-Mail:", self.v_mail))):
             tk.Label(g, text=lbl, anchor="w").grid(row=r, column=0, sticky="w", pady=2)
@@ -61,14 +63,20 @@ class HaendlerDialog(w.Dialog):
         tk.Entry(pf, textvariable=self.v_proz, width=7, justify="right").pack(side="left")
         tk.Label(pf, text="% der Provision").pack(side="left", padx=4)
         tk.Checkbutton(g, text="Aktiv", variable=self.v_aktiv).grid(row=3, column=2, sticky="e")
-        tk.Label(g, text="Notiz:", anchor="nw").grid(row=4, column=0, sticky="nw", pady=2)
+        tk.Label(g, text="Airtime:", anchor="w").grid(row=4, column=0, sticky="w", pady=2)
-        self.t_notiz = tk.Text(g, width=36, height=3, font=w.FONT)
+        af = tk.Frame(g, bg=w.FACE)
-        self.t_notiz.grid(row=4, column=1, columnspan=2, sticky="we", pady=2)
+        af.grid(row=4, column=1, columnspan=2, sticky="w")
+        self.e_air = tk.Entry(af, textvariable=self.v_air, width=7, justify="right")
+        self.e_air.pack(side="left")
+        tk.Label(af, text="% der Airtime   (0 % = keine Airtime)").pack(side="left", padx=4)
+        tk.Label(g, text="Notiz:", anchor="nw").grid(row=5, column=0, sticky="nw", pady=2)
+        self.t_notiz = tk.Text(g, width=36, height=2, font=w.FONT)
+        self.t_notiz.grid(row=5, column=1, columnspan=2, sticky="we", pady=2)
         g.columnconfigure(1, weight=1)
 
         g2 = w.gruppe(rechts, "Kennungen (ordnet Positionen diesem Händler zu)")
         g2.pack(fill="both", expand=True, pady=(8, 0))
-        r2, self.kliste = w.scroll_tree(g2, columns=("anbieter", "wert"), show="headings", height=4,
+        r2, self.kliste = w.scroll_tree(g2, columns=("anbieter", "wert"), show="headings", height=3,
                                         selectmode="browse")
         self.kliste.heading("anbieter", text="Anbieter")
         self.kliste.heading("wert", text="Unterhändler-Nr. / VO-Nr.")
@@ -89,10 +97,27 @@ class HaendlerDialog(w.Dialog):
         ke.bind("<Return>", lambda e: self._kennung_dazu())
         w.knopf(kf, "Hinzufügen", self._kennung_dazu).pack(side="left")
         w.knopf(kf, "Entfernen", self._kennung_weg).pack(side="left", padx=4)
+        self.v_caps = tk.BooleanVar(value=False)
+        self.cb_caps = tk.Checkbutton(g2, text=CAPS_HAKEN, variable=self.v_caps, anchor="w")
+        self.cb_caps.pack(fill="x", pady=(4, 0))
+
+        g4 = w.gruppe(rechts, "Jahresbonus Neuaktivierung (Betrag je Karte nach Staffel)")
+        g4.pack(fill="x", pady=(8, 0))
+        self.v_eigen_staffel = tk.BooleanVar(value=False)
+        sf = tk.Frame(g4, bg=w.FACE)
+        sf.pack(fill="x")
+        tk.Radiobutton(sf, text="Standard-Staffel", variable=self.v_eigen_staffel, value=False,
+                       command=self._staffel_zeigen).pack(side="left")
+        tk.Radiobutton(sf, text="Eigene Staffel für diesen Händler", variable=self.v_eigen_staffel, value=True,
+                       command=self._staffel_zeigen).pack(side="left", padx=(8, 0))
+        w.knopf(sf, "Bearbeiten...", self._staffel_bearbeiten).pack(side="right")
+        self.l_staffel = tk.Label(g4, text="", anchor="w", justify="left", fg=w.NAVY, wraplength=560)
+        self.l_staffel.pack(fill="x", pady=(2, 0))
+        self._eigene_staffel: regeln.Staffel | None = None
 
         g3 = w.gruppe(rechts, "Abweichende Auszahlung je Provisionsart")
         g3.pack(fill="both", expand=True, pady=(8, 0))
-        r3, self.rliste = w.scroll_tree(g3, columns=("art", "proz"), show="headings", height=4, selectmode="browse")
+        r3, self.rliste = w.scroll_tree(g3, columns=("art", "proz"), show="headings", height=3, selectmode="browse")
         self.rliste.heading("art", text="Provisionsart")
         self.rliste.heading("proz", text="Auszahlung")
         self.rliste.column("art", width=240)
@@ -100,7 +125,7 @@ class HaendlerDialog(w.Dialog):
         r3.pack(fill="both", expand=True)
         rf = tk.Frame(g3, bg=w.FACE)
         rf.pack(fill="x", pady=(4, 0))
-        tk.Label(rf, text="Regeln entstehen im Hauptfenster über „Prozent…“.", fg=w.SHADOW).pack(side="left")
+        tk.Label(rf, text="Regeln entstehen im Hauptfenster über „Prozent...“.", fg=w.SHADOW).pack(side="left")
         w.knopf(rf, "Entfernen", self._regel_weg).pack(side="right")
 
         unten = tk.Frame(self, bg=w.FACE)
@@ -112,9 +137,14 @@ class HaendlerDialog(w.Dialog):
         self._liste_laden(auswahl_id)
         if neue_kennung:
             self._neu()
+            if neue_kennung[0] == CAPS_ANBIETER:
+                self.v_caps.set(True)
+            else:
                 self._kennungen = [neue_kennung]
             self._kennungen_zeigen()
-        self.minsize(640, 460)
+        elif self.liste.selection():
+            self._auswahl()  # sofort füllen – sonst wächst der Dialog erst nach der Größenberechnung
+        self.minsize(660, 560)
 
     # ---- intern
     @staticmethod
@@ -122,9 +152,42 @@ class HaendlerDialog(w.Dialog):
         return next((k for k, v in KENNUNG_ARTEN.items() if v == anzeige), anzeige)
 
     def _art_gewaehlt(self):
-        caps = self._anbieter_key(self.v_kanb.get()) == CAPS_ANBIETER
+        self._ke.focus_set()
-        self.v_kwert.set("")
+
-        self._ke.configure(state="disabled" if caps else "normal")
+    def _caps_einstellen(self, hid: int, an: bool):
+        """GROSSBUCHSTABEN-Häkchen: gesperrt, wenn die Regel schon einem anderen Händler gehört."""
+        self.v_caps.set(an)
+        besitzer = self.db.kennung_map().get((CAPS_ANBIETER, CAPS_WERT))
+        if besitzer and besitzer != hid:
+            h = self.db.haendler(besitzer)
+            self.cb_caps.configure(state="disabled", text=f"GROSSBUCHSTABEN-Regel: gehört zu „{h.name if h else '?'}“")
+        else:
+            self.cb_caps.configure(state="normal", text=CAPS_HAKEN)
+
+    def _staffel_zeigen(self):
+        eigen = self.v_eigen_staffel.get()
+        if eigen and self._eigene_staffel is None:
+            self._eigene_staffel = list(self.db.standard_staffel())
+        st = self._eigene_staffel if eigen else self.db.standard_staffel()
+        self.l_staffel.configure(text=("Eigene Staffel: " if eigen else "Standard: ")
+                                 + regeln.staffel_beschreibung(st, kurz=True))
+
+    def _staffel_bearbeiten(self):
+        if not self.v_eigen_staffel.get():
+            if w.frage(self, "Jahresbonus-Staffel",
+                       "Die Standard-Staffel gilt für alle Händler ohne eigene Staffel.\n\n"
+                       "Soll dieser Händler eine eigene Staffel bekommen?\n"
+                       "(Die Standard-Staffel ändern Sie unter Händler > Standard-Staffel Jahresbonus...)",
+                       ja="Eigene Staffel", nein="Abbrechen"):
+                self.v_eigen_staffel.set(True)
+            else:
+                return
+        neu = StaffelDialog(self, self._eigene_staffel or self.db.standard_staffel(),
+                            f"Jahresbonus-Staffel – {self.v_name.get().strip() or 'neuer Händler'}",
+                            standard=self.db.standard_staffel()).zeigen()
+        if neu is not None:
+            self._eigene_staffel = neu
+        self._staffel_zeigen()
 
     def _liste_laden(self, auswahl_id=None):
         self.liste.delete(*self.liste.get_children())
@@ -150,19 +213,22 @@ class HaendlerDialog(w.Dialog):
         self.v_ap.set(h.ansprechpartner)
         self.v_mail.set(h.email)
         self.v_proz.set(fmt_percent(h.standard_prozent).replace(" %", ""))
+        self.v_air.set(fmt_percent(h.airtime_prozent).replace(" %", ""))
         self.v_aktiv.set(h.aktiv)
         self.t_notiz.delete("1.0", "end")
         self.t_notiz.insert("1.0", h.notiz or "")
-        self._kennungen = self.db.kennungen(h.id)
+        kenn = self.db.kennungen(h.id)
+        self._kennungen = [k for k in kenn if k[0] != CAPS_ANBIETER]
+        self._caps_einstellen(h.id, (CAPS_ANBIETER, CAPS_WERT) in kenn)
+        self._eigene_staffel = list(h.staffel) if h.staffel is not None else None
+        self.v_eigen_staffel.set(h.staffel is not None)
+        self._staffel_zeigen()
         self._kennungen_zeigen()
         self._regeln_zeigen()
 
     def _kennungen_zeigen(self):
         self.kliste.delete(*self.kliste.get_children())
         for i, (a, v) in enumerate(self._kennungen):
-            if a == CAPS_ANBIETER:
-                self.kliste.insert("", "end", iid=str(i), values=("Vodafone", CAPS_TEXT))
-            else:
             self.kliste.insert("", "end", iid=str(i), values=(ANBIETER.get(a, a), v))
 
     def _regeln_zeigen(self):
@@ -177,15 +243,20 @@ class HaendlerDialog(w.Dialog):
         for v in (self.v_name, self.v_ap, self.v_mail):
             v.set("")
         self.v_proz.set("100")
+        self.v_air.set("0")
         self.v_aktiv.set(True)
         self.t_notiz.delete("1.0", "end")
         self._kennungen = []
+        self._caps_einstellen(0, False)
+        self._eigene_staffel = None
+        self.v_eigen_staffel.set(False)
+        self._staffel_zeigen()
         self._kennungen_zeigen()
         self._regeln_zeigen()
 
     def _kennung_dazu(self):
         anb = self._anbieter_key(self.v_kanb.get())
-        wert = CAPS_WERT if anb == CAPS_ANBIETER else self.v_kwert.get().strip()
+        wert = self.v_kwert.get().strip()
         if not wert:
             return
         if (anb, wert) not in self._kennungen:
@@ -216,12 +287,21 @@ class HaendlerDialog(w.Dialog):
         except ValueError:
             w.warnung(self, "Händler", "Die Standard-Auszahlung muss eine Zahl sein (z. B. 100 oder 85,5).")
             return
+        try:
+            air = parse_percent(self.v_air.get() or "0")
+        except ValueError:
+            w.warnung(self, "Händler", "Die Airtime-Auszahlung muss eine Zahl sein (z. B. 0, 50 oder 100).")
+            return
         if self.v_kwert.get().strip():
             self._kennung_dazu()
         h = Haendler(self.aktuell.id if self.aktuell else 0, name, self.v_ap.get().strip(), self.v_mail.get().strip(),
-                     self.t_notiz.get("1.0", "end").strip(), proz, self.v_aktiv.get())
+                     self.t_notiz.get("1.0", "end").strip(), proz, self.v_aktiv.get(), air,
+                     self._eigene_staffel if self.v_eigen_staffel.get() else None)
+        kennungen = list(self._kennungen)
+        if self.v_caps.get() and str(self.cb_caps.cget("state")) != "disabled":
+            kennungen.append((CAPS_ANBIETER, CAPS_WERT))
         try:
-            hid = self.db.haendler_speichern(h, self._kennungen)
+            hid = self.db.haendler_speichern(h, kennungen)
         except Exception as exc:  # sqlite3.IntegrityError / ValueError
             msg = str(exc)
             if "UNIQUE" in msg and "haendler.name" in msg:
@@ -292,7 +372,7 @@ class ProzentDialog(w.Dialog):
         from provtool.money import apply_percent
         try:
             p = parse_percent(self.v.get())
-            self.vorschau.configure(text=f"→ Auszahlung ca. {fmt(apply_percent(self.summe_orig, p))}")
+            self.vorschau.configure(text=f"-> Auszahlung ca. {fmt(apply_percent(self.summe_orig, p))}")
         except ValueError:
             self.vorschau.configure(text="(ungültiger Wert)")
 
@@ -309,6 +389,171 @@ class ProzentDialog(w.Dialog):
         return super().zeigen(self._e)
 
 
+# =========================================================================== Jahresbonus-Staffel
+
+class StaffelDialog(w.Dialog):
+    """Staffel bearbeiten: je Stufe „ab N Karten“ und Betrag je Karte (oder „voll“)."""
+
+    def __init__(self, master, staffel: regeln.Staffel, titel: str = "Jahresbonus-Staffel",
+                 standard: regeln.Staffel | None = None):
+        super().__init__(master, titel)
+        self.standard = standard
+        f = tk.Frame(self, bg=w.FACE)
+        f.pack(fill="both", expand=True, padx=12, pady=(10, 4))
+        tk.Label(f, justify="left", anchor="w", wraplength=380, text=(
+            "Jahresbonus Neuaktivierung: Der Händler bekommt je Karte den Betrag der Stufe, die zu seiner "
+            "Anzahl Karten in der Abrechnung passt. „voll“ = ganzer Betrag laut Abrechnung. Nie mehr als "
+            "die Provision laut Abrechnung; Stornos zählen ab.")).pack(fill="x")
+        kopf = tk.Frame(f, bg=w.FACE)
+        kopf.pack(fill="x", pady=(8, 2))
+        tk.Label(kopf, text="ab Karten", width=9, anchor="w").pack(side="left")
+        tk.Label(kopf, text="Betrag je Karte (oder „voll“)", anchor="w").pack(side="left", padx=(8, 0))
+        self.tabelle = tk.Frame(f, bg=w.FACE)
+        self.tabelle.pack(fill="x")
+        self.zeilen: list[tuple[tk.Frame, tk.StringVar, tk.StringVar]] = []
+        for ab, cent in staffel:
+            self._zeile(ab, cent)
+        kk = tk.Frame(f, bg=w.FACE)
+        kk.pack(fill="x", pady=(6, 0))
+        w.knopf(kk, "Stufe hinzufügen", self._dazu).pack(side="left")
+        w.knopf(kk, "Letzte entfernen", self._weg).pack(side="left", padx=4)
+        if standard is not None:
+            w.knopf(kk, "Wie Standard", lambda: self._setzen(standard)).pack(side="right")
+        self.knopfleiste([("OK", self._ok), ("Abbrechen", self.abbrechen)]).pack(pady=(6, 10))
+
+    def _zeile(self, ab: int | str = "", cent: int | None | str = ""):
+        z = tk.Frame(self.tabelle, bg=w.FACE)
+        z.pack(fill="x", pady=1)
+        v_ab = tk.StringVar(value=str(ab))
+        v_bt = tk.StringVar(value="voll" if cent is None else (fmt(cent, symbol=False) if isinstance(cent, int)
+                                                                else str(cent)))
+        tk.Entry(z, textvariable=v_ab, width=8, justify="right").pack(side="left")
+        tk.Entry(z, textvariable=v_bt, width=10, justify="right").pack(side="left", padx=(12, 0))
+        tk.Label(z, text="€ je Karte").pack(side="left", padx=4)
+        self.zeilen.append((z, v_ab, v_bt))
+
+    def _dazu(self):
+        letzte = self.zeilen[-1][1].get() if self.zeilen else "0"
+        try:
+            ab = int(letzte) + 5
+        except ValueError:
+            ab = ""
+        self._zeile(ab, "")
+
+    def _weg(self):
+        if len(self.zeilen) > 1:
+            self.zeilen.pop()[0].destroy()
+
+    def _setzen(self, staffel):
+        for z, _, _ in self.zeilen:
+            z.destroy()
+        self.zeilen = []
+        for ab, cent in staffel:
+            self._zeile(ab, cent)
+
+    def lesen(self) -> regeln.Staffel:
+        out = []
+        for i, (_, v_ab, v_bt) in enumerate(self.zeilen, start=1):
+            try:
+                ab = int(v_ab.get().strip())
+            except ValueError:
+                raise ValueError(f"Stufe {i}: „ab Karten“ muss eine ganze Zahl sein.") from None
+            text = v_bt.get().strip()
+            if text.lower() == "voll":
+                cent = None
+            else:
+                try:
+                    cent = parse_cent(text)
+                except ValueError:
+                    raise ValueError(f"Stufe {i}: Bitte einen Betrag (z. B. 5 oder 7,50) oder „voll“ eingeben.") \
+                        from None
+            out.append((ab, cent))
+        return regeln.staffel_pruefen(out)
+
+    def _ok(self):
+        try:
+            self.result = self.lesen()
+        except ValueError as exc:
+            w.warnung(self, "Staffel", str(exc))
+            return
+        self.destroy()
+
+
+# =========================================================================== Provisionsarten
+
+TYP_AUTO = "Automatisch"
+
+
+class ProvisionsartenDialog(w.Dialog):
+    """Welche Provisionsart ist Airtime bzw. Jahresbonus? Erkannt wird automatisch, umstellbar je Art."""
+
+    def __init__(self, master, db: Datenbank):
+        super().__init__(master, "Provisionsarten", resizable=True)
+        self.db = db
+        self.geaendert = False
+        f = tk.Frame(self, bg=w.FACE)
+        f.pack(fill="both", expand=True, padx=10, pady=10)
+        tk.Label(f, anchor="w", justify="left", text=(
+            "Airtime wird pro Händler mit dem Airtime-Prozentsatz ausgezahlt und im Export als eigene Liste\n"
+            "geführt. Der Jahresbonus Neuaktivierung wird nach der Staffel berechnet.")).pack(fill="x")
+        r, self.tree = w.scroll_tree(f, columns=("art", "anzahl", "typ"), show="headings", height=12,
+                                     selectmode="browse")
+        for c, t, b, a in (("art", "Provisionsart", 300, "w"), ("anzahl", "Pos.", 50, "e"),
+                           ("typ", "Behandlung", 230, "w")):
+            self.tree.heading(c, text=t)
+            self.tree.column(c, width=b, anchor=a)
+        r.pack(fill="both", expand=True, pady=(6, 4))
+        self.tree.bind("<<TreeviewSelect>>", lambda e: self._auswahl())
+        u = tk.Frame(f, bg=w.FACE)
+        u.pack(fill="x")
+        tk.Label(u, text="Behandlung:").pack(side="left")
+        self.v_typ = tk.StringVar(value=TYP_AUTO)
+        self.cb = ttk.Combobox(u, textvariable=self.v_typ, state="readonly", width=36,
+                               values=[TYP_AUTO] + list(regeln.TYPEN.values()))
+        self.cb.pack(side="left", padx=4)
+        w.knopf(u, "Übernehmen", self._setzen).pack(side="left")
+        self.knopfleiste([("Schließen", self.abbrechen)]).pack(pady=(0, 10))
+        self._laden()
+        self.minsize(620, 380)
+
+    def _laden(self, auswahl: str | None = None):
+        self.tree.delete(*self.tree.get_children())
+        fest = self.db.art_typen()
+        self._arten = {}
+        for i, (art, erkannt, n) in enumerate(self.db.provisionsarten()):
+            typ = fest.get(art)
+            text = regeln.TYPEN[typ] if typ else f"{TYP_AUTO}: {regeln.TYPEN[erkannt]}"
+            iid = str(i)
+            self._arten[iid] = art
+            self.tree.insert("", "end", iid=iid, values=(art or "(ohne)", n, text))
+            if art == auswahl:
+                self.tree.selection_set(iid)
+                self.tree.see(iid)
+
+    def _auswahl(self):
+        sel = self.tree.selection()
+        if not sel:
+            return
+        typ = self.db.art_typen().get(self._arten[sel[0]])
+        self.v_typ.set(regeln.TYPEN[typ] if typ else TYP_AUTO)
+
+    def _setzen(self):
+        sel = self.tree.selection()
+        if not sel:
+            w.info(self, "Provisionsarten", "Bitte zuerst eine Provisionsart in der Liste auswählen.")
+            return
+        art = self._arten[sel[0]]
+        wahl = self.v_typ.get()
+        typ = next((k for k, v in regeln.TYPEN.items() if v == wahl), None)
+        self.db.art_typ_setzen(art, typ)
+        self.geaendert = True
+        self._laden(art)
+
+    def abbrechen(self):
+        self.result = self.geaendert
+        self.destroy()
+
+
 # =========================================================================== Abrechnungen
 
 class AbrechnungenDialog(w.Dialog):
@@ -327,7 +572,7 @@ class AbrechnungenDialog(w.Dialog):
         k = tk.Frame(self, bg=w.FACE)
         k.pack(fill="x", padx=10, pady=10)
         w.knopf(k, "Öffnen", self._oeffnen, breite=10, default="active").pack(side="left")
-        w.knopf(k, "Umbenennen…", self._umbenennen, breite=12).pack(side="left", padx=6)
+        w.knopf(k, "Umbenennen...", self._umbenennen, breite=12).pack(side="left", padx=6)
         w.knopf(k, "Löschen", self._loeschen, breite=10).pack(side="left")
         w.knopf(k, "Abbrechen", self.abbrechen, breite=10).pack(side="right")
         self.bind("<Return>", lambda e: self._oeffnen())
@@ -440,7 +685,7 @@ class ImportBericht(w.Dialog):
             tk.Label(self, text="Nicht zugeordnete Kennungen (kein Händler hinterlegt – z. B. eigene Filiale):",
                      anchor="w").pack(fill="x", padx=10, pady=(10, 2))
             r2, self.ut = w.scroll_tree(self, columns=("anbieter", "kennung", "anzahl", "summe"), show="headings",
-                                        height=min(6, len(unbekannt)), selectmode="browse")
+                                        height=min(6, len(unbekannt)), selectmode="extended")
             for c, h, b, a in (("anbieter", "Anbieter", 90, "w"), ("kennung", "Kennung", 140, "w"),
                                ("anzahl", "Pos.", 50, "e"), ("summe", "Summe", 90, "e")):
                 self.ut.heading(c, text=h)
@@ -451,14 +696,80 @@ class ImportBericht(w.Dialog):
         k = tk.Frame(self, bg=w.FACE)
         k.pack(fill="x", padx=10, pady=10)
         if unbekannt:
-            w.knopf(k, "Kennung einem Händler zuordnen…", self._zuordnen).pack(side="left")
+            w.knopf(k, "Kennung einem Händler zuordnen...", self._zuordnen).pack(side="left")
+            w.knopf(k, "Als eigene ausblenden...", self._eigen).pack(side="left", padx=6)
         w.knopf(k, "OK", self.abbrechen, breite=10, default="active").pack(side="right")
         self.bind("<Return>", lambda e: self.abbrechen())
 
     def _zuordnen(self):
         s = self.ut.selection()
         if s:
-            self.result = tuple(s[0].split("\t", 1))
+            a, k = s[0].split("\t", 1)
+            self.result = ("zuordnen", a, k)
+            self.destroy()
+
+    def _eigen(self):
+        s = self.ut.selection()
+        if s:
+            self.result = ("eigen", [tuple(x.split("\t", 1)) for x in s])
+            self.destroy()
+
+
+class EigeneKennungenDialog(w.Dialog):
+    """Kennungen der eigenen Filiale: Positionen damit werden ausgeblendet und nicht exportiert."""
+
+    def __init__(self, master, db: Datenbank):
+        super().__init__(master, "Eigene Kennungen")
+        self.db, self.geaendert = db, False
+        tk.Label(self, text="Positionen mit diesen Kennungen gehören zur eigenen Filiale. Sie werden\n"
+                            "ausgeblendet, nicht mitgerechnet und nicht exportiert.\n"
+                            "(Ist eine Kennung einem Händler zugeordnet, hat der Händler Vorrang.)",
+                 justify="left", anchor="w").pack(fill="x", padx=10, pady=(10, 4))
+        r, self.tree = w.scroll_tree(self, columns=("anbieter", "wert"), show="headings", height=7,
+                                     selectmode="extended")
+        self.tree.heading("anbieter", text="Anbieter")
+        self.tree.heading("wert", text="Unterhändler-Nr. / VO-Nr.")
+        self.tree.column("anbieter", width=100)
+        self.tree.column("wert", width=200)
+        r.pack(fill="both", expand=True, padx=10)
+        z = tk.Frame(self, bg=w.FACE)
+        z.pack(fill="x", padx=10, pady=6)
+        self.v_anb = tk.StringVar(value="freenet")
+        ttk.Combobox(z, textvariable=self.v_anb, values=list(ANBIETER.values()), width=10,
+                     state="readonly").pack(side="left")
+        self.v_wert = tk.StringVar()
+        e = tk.Entry(z, textvariable=self.v_wert, width=18)
+        e.pack(side="left", padx=4)
+        e.bind("<Return>", lambda ev: self._dazu())
+        w.knopf(z, "Hinzufügen", self._dazu).pack(side="left")
+        w.knopf(z, "Entfernen", self._weg).pack(side="left", padx=4)
+        self.knopfleiste([("Schließen", self.abbrechen)]).pack(pady=(0, 10))
+        self._laden()
+
+    def _laden(self):
+        self.tree.delete(*self.tree.get_children())
+        for a, k in self.db.eigene_kennungen():
+            self.tree.insert("", "end", iid=f"{a}\t{k}", values=(ANBIETER.get(a, a), k))
+
+    def _dazu(self):
+        wert = self.v_wert.get().strip()
+        if not wert:
+            return
+        anb = next((k for k, v in ANBIETER.items() if v == self.v_anb.get()), self.v_anb.get())
+        self.db.eigene_setzen(anb, wert, True)
+        self.v_wert.set("")
+        self.geaendert = True
+        self._laden()
+
+    def _weg(self):
+        for iid in self.tree.selection():
+            a, k = iid.split("\t", 1)
+            self.db.eigene_setzen(a, k, False)
+            self.geaendert = True
+        self._laden()
+
+    def abbrechen(self):
+        self.result = self.geaendert
         self.destroy()
 
 
@@ -473,7 +784,7 @@ class KennungZuordnen(w.Dialog):
         self.v = tk.StringVar(value="__neu__")
         f = tk.Frame(self, bg=w.FACE)
         f.pack(fill="x", padx=20)
-        tk.Radiobutton(f, text="Neuem Händler …", variable=self.v, value="__neu__").pack(anchor="w")
+        tk.Radiobutton(f, text="Neuem Händler ...", variable=self.v, value="__neu__").pack(anchor="w")
         haendler = db.haendler_liste()
         if haendler:
             tk.Radiobutton(f, text="Bestehendem Händler:", variable=self.v, value="__alt__").pack(anchor="w")
@@ -515,7 +826,7 @@ class HaendlerWaehlen(w.Dialog):
         self.cb = ttk.Combobox(self, values=list(self._hmap) + [self.KEINER], state="readonly", width=40)
         self.cb.pack(padx=12, pady=4)
         tk.Label(self, text="Die feste Zuweisung hat Vorrang vor Kennungen und der GROSSBUCHSTABEN-Regel.\n"
-                            "Rückgängig: Rechtsklick ▸ „Automatisch zuordnen“.", justify="left",
+                            "Rückgängig: Rechtsklick > „Automatisch zuordnen“.", justify="left",
                  fg=w.SHADOW).pack(fill="x", padx=12)
         self.bind("<Return>", lambda e: self._ok())
         self.knopfleiste([("OK", self._ok), ("Abbrechen", self.abbrechen)]).pack(pady=12)
@@ -546,7 +857,7 @@ class ExportDialog(w.Dialog):
         r, self.tree = w.scroll_tree(f, columns=("name", "anzahl", "summe"), show="tree headings", height=8,
                                      selectmode="extended")
         self.tree.heading("#0", text="")
-        self.tree.column("#0", width=30, stretch=False)
+        self.tree.column("#0", width=40, stretch=False)
         for c, t, b, a in (("name", "Händler", 220, "w"), ("anzahl", "Pos.", 50, "e"), ("summe", "Auszahlung", 100, "e")):
             self.tree.heading(c, text=t)
             self.tree.column(c, width=b, anchor=a)
@@ -571,19 +882,23 @@ class ExportDialog(w.Dialog):
         tk.Label(g, text="Zielordner:").grid(row=1, column=0, sticky="w")
         self.v_ordner = tk.StringVar(value=settings.get("export_ordner") or "")
         tk.Entry(g, textvariable=self.v_ordner, width=40).grid(row=1, column=1, sticky="we", pady=2)
-        w.knopf(g, "Durchsuchen…", self._ordner).grid(row=1, column=2, padx=(4, 0))
+        w.knopf(g, "Durchsuchen...", self._ordner).grid(row=1, column=2, padx=(4, 0))
-        self.v_anb = tk.BooleanVar(value=settings.get("export_pro_anbieter", True))
+        # Neuer Schlüssel: freenet und Vodafone stehen jetzt standardmäßig in EINER Datei
+        self.v_anb = tk.BooleanVar(value=settings.get("export_anbieter_getrennt", False))
+        self.v_null = tk.BooleanVar(value=settings.get("export_null_weglassen", True))
         self.v_kopf = tk.BooleanVar(value=settings.get("export_kopfzeile", False))
         self.v_sum = tk.BooleanVar(value=settings.get("export_summe", True))
         self.v_auf = tk.BooleanVar(value=True)
-        tk.Checkbutton(g, text="Pro Anbieter (freenet / Vodafone) eine eigene Datei",
+        for zeile, (text, var) in enumerate((
-                       variable=self.v_anb).grid(row=2, column=0, columnspan=3, sticky="w")
+                ("freenet und Vodafone in getrennte Dateien (sonst beide in einer)", self.v_anb),
-        tk.Checkbutton(g, text="Kopfzeile mit Spaltennamen", variable=self.v_kopf).grid(row=3, column=0, columnspan=3,
+                ("Positionen mit 0,00 € weglassen", self.v_null),
-                                                                                         sticky="w")
+                ("Kopfzeile mit Spaltennamen", self.v_kopf),
-        tk.Checkbutton(g, text="Summenzeile unter der Tabelle", variable=self.v_sum).grid(row=4, column=0,
+                ("Summenzeile unter der Tabelle", self.v_sum),
-                                                                                          columnspan=3, sticky="w")
+                ("Ordner nach dem Export öffnen", self.v_auf)), start=2):
-        tk.Checkbutton(g, text="Ordner nach dem Export öffnen", variable=self.v_auf).grid(row=5, column=0,
+            tk.Checkbutton(g, text=text, variable=var).grid(row=zeile, column=0, columnspan=3, sticky="w")
-                                                                                          columnspan=3, sticky="w")
+        tk.Label(g, text="Airtime steht in der Abrechnung als eine Summenzeile, die Einzelposten kommen in eine\n"
+                         "eigene Datei „... - Airtime - ...xlsx“.", fg=w.SHADOW, justify="left", anchor="w").grid(
+            row=7, column=0, columnspan=3, sticky="w", pady=(4, 0))
         g.columnconfigure(1, weight=1)
         self.knopfleiste([("Exportieren", self._ok), ("Abbrechen", self.abbrechen)]).pack(pady=(0, 10))
 
@@ -617,11 +932,13 @@ class ExportDialog(w.Dialog):
             self._ordner()
             if not self.v_ordner.get().strip():
                 return
-        self.settings.update(export_ordner=self.v_ordner.get().strip(), export_pro_anbieter=self.v_anb.get(),
+        self.settings.update(export_ordner=self.v_ordner.get().strip(), export_anbieter_getrennt=self.v_anb.get(),
-                             export_kopfzeile=self.v_kopf.get(), export_summe=self.v_sum.get())
+                             export_null_weglassen=self.v_null.get(), export_kopfzeile=self.v_kopf.get(),
+                             export_summe=self.v_sum.get())
+        self.settings.pop("export_pro_anbieter", None)
         self.result = dict(ids=ids, ordner=self.v_ordner.get().strip(), titel=self.v_titel.get().strip(),
-                           pro_anbieter=self.v_anb.get(), kopfzeile=self.v_kopf.get(), summe=self.v_sum.get(),
+                           pro_anbieter=self.v_anb.get(), null_weglassen=self.v_null.get(),
-                           oeffnen=self.v_auf.get())
+                           kopfzeile=self.v_kopf.get(), summe=self.v_sum.get(), oeffnen=self.v_auf.get())
         self.destroy()
 
 
@@ -637,10 +954,16 @@ class EinstellungenDialog(w.Dialog):
             row=0, column=0, columnspan=2, sticky="w")
         self.v = tk.StringVar(value=db_pfad)
         tk.Entry(g, textvariable=self.v, width=56).grid(row=1, column=0, sticky="we", pady=4)
-        w.knopf(g, "Ändern…", self._waehlen).grid(row=1, column=1, padx=(4, 0))
+        w.knopf(g, "Ändern...", self._waehlen).grid(row=1, column=1, padx=(4, 0))
         tk.Label(g, text="Tipp: Liegt die Datei auf einem Netzlaufwerk, können mehrere PCs dieselben\n"
                          "Händler nutzen – aber bitte nicht gleichzeitig damit arbeiten.",
                  justify="left", fg=w.SHADOW).grid(row=2, column=0, columnspan=2, sticky="w")
+        g2 = w.gruppe(self, "Darstellung")
+        g2.pack(fill="x", padx=10, pady=(0, 10))
+        self.v_klassisch = tk.BooleanVar(value=bool(settings.get("klassischer_rahmen", True)))
+        tk.Checkbutton(g2, text="Windows-95-Titelleiste verwenden (sonst die normale von Windows)",
+                       variable=self.v_klassisch).pack(anchor="w")
+        tk.Label(g2, text="Wirkt beim nächsten Programmstart.", fg=w.SHADOW).pack(anchor="w")
         self.knopfleiste([("OK", self._ok), ("Abbrechen", self.abbrechen)]).pack(pady=(0, 10))
 
     def _waehlen(self):
@@ -651,7 +974,7 @@ class EinstellungenDialog(w.Dialog):
             self.v.set(p)
 
     def _ok(self):
-        self.result = self.v.get().strip()
+        self.result = dict(pfad=self.v.get().strip(), klassisch=self.v_klassisch.get())
         self.destroy()
 
 

provtool/gui/menue.py

@@ -0,0 +1,298 @@
+"""Menüs im Windows-95-Stil (Menüleiste, Aufklapp- und Kontextmenüs).
+
+Die nativen Windows-Menüs sind weiß und wechseln nicht mit, wenn man bei offenem Menü mit der
+Maus zum nächsten Menüleisten-Eintrag fährt. Diese Menüs sind selbst gezeichnet:
+- grau, Markierung in Navy, Tastenkürzel rechtsbündig, Trennlinien eingelassen
+- bei offenem Menü wechselt das Menü beim Überfahren der Menüleiste
+- Tastatur: Pfeil hoch/runter wählen, Enter ausführen, Esc schließen, Pfeil links/rechts benachbartes Menü
+- Klick daneben oder Wechsel in ein anderes Programm schließt das Menü
+Die Schnittstelle (add_command, add_separator, tk_popup) entspricht tk.Menu.
+"""
+from __future__ import annotations
+
+import tkinter as tk
+
+from provtool.gui import win95 as w
+
+
+class Popup:
+    """Ein Aufklapp- bzw. Kontextmenü."""
+
+    def __init__(self, master: tk.Misc):
+        self.master = master
+        self.eintraege: list[dict] = []
+        self.fenster: tk.Toplevel | None = None
+        self.zeilen: list[tuple[dict, tk.Frame, list[tk.Label]]] = []
+        self.aktiv = -1
+        self.leiste: Menueleiste | None = None
+        self._pruefer = None
+
+    # ------------------------------------------------------------- tk.Menu-kompatibel
+    def add_command(self, label: str, command=None, accelerator: str = "", state: str = "normal"):
+        self.eintraege.append(dict(art="befehl", label=label, command=command, accelerator=accelerator,
+                                   state=state))
+
+    def add_separator(self):
+        self.eintraege.append(dict(art="trenner"))
+
+    def tk_popup(self, x: int, y: int):
+        self.oeffnen(x, y)
+
+    # ------------------------------------------------------------- Anzeige
+    @property
+    def offen(self) -> bool:
+        try:
+            return self.fenster is not None and bool(self.fenster.winfo_exists())
+        except tk.TclError:
+            return False
+
+    def oeffnen(self, x: int, y: int, leiste: Menueleiste | None = None):
+        self.schliessen()
+        self.leiste = leiste
+        root = self.master._root()
+        f = self.fenster = tk.Toplevel(root, bg=w.FACE, bd=2, relief="raised")
+        f.withdraw()
+        f.overrideredirect(True)
+        self.zeilen = []
+        for e in self.eintraege:
+            if e["art"] == "trenner":
+                t = tk.Frame(f, bg=w.FACE, height=8)
+                t.pack(fill="x")
+                linie = w.trenner(t, vertikal=False)
+                linie.place(relx=0, rely=0.5, relwidth=1, y=-1)
+                continue
+            zeile = tk.Frame(f, bg=w.FACE)
+            zeile.pack(fill="x")
+            grau = e["state"] == "disabled"
+            text = tk.Label(zeile, text=e["label"], bg=w.FACE, anchor="w", padx=18, pady=2,
+                            fg=w.SHADOW if grau else w.DARK)
+            text.pack(side="left", fill="x", expand=True)
+            labels = [text]
+            if e["accelerator"]:
+                acc = tk.Label(zeile, text=e["accelerator"], bg=w.FACE, anchor="e", padx=12, pady=2,
+                               fg=w.SHADOW if grau else w.DARK)
+                acc.pack(side="right")
+                labels.append(acc)
+            idx = len(self.zeilen)
+            for wdg in [zeile] + labels:
+                wdg.bind("<Enter>", lambda ev, i=idx: self._markieren(i))
+                wdg.bind("<ButtonRelease-1>", lambda ev, i=idx: self._ausfuehren(i))
+            self.zeilen.append((e, zeile, labels))
+
+        f.update_idletasks()
+        bw, bh = f.winfo_reqwidth(), f.winfo_reqheight()
+        sw, sh = f.winfo_screenwidth(), f.winfo_screenheight()
+        x = max(0, min(x, sw - bw))
+        y = max(0, min(y, sh - bh))
+        # Größe UND Position zusammen setzen: eine reine Positionsangabe ignoriert Tk unter Windows bei
+        # rahmenlosen Fenstern – das Menü landete sonst oben links in der Bildschirmecke.
+        f.geometry(f"{bw}x{bh}+{x}+{y}")
+        f.deiconify()
+        f.lift()
+        f.update_idletasks()
+        try:
+            from provtool.gui import win32
+            win32.besitzer_setzen(f, root)  # bleibt über dem Hauptfenster
+        except Exception:
+            pass
+
+        # Alle Maus-Ereignisse der Anwendung an das Menü (lokale Tk-Sperre): Klick daneben schließt,
+        # Bewegung über die Menüleiste wechselt das Menü.
+        try:
+            f.grab_set()
+        except tk.TclError:
+            pass
+        f.focus_force()
+        f.bind("<ButtonPress>", self._klick)
+        f.bind("<Motion>", self._bewegung)
+        f.bind("<Escape>", lambda e: self.schliessen())
+        f.bind("<Up>", lambda e: self._schritt(-1))
+        f.bind("<Down>", lambda e: self._schritt(1))
+        f.bind("<Return>", lambda e: self._ausfuehren(self.aktiv))
+        f.bind("<KP_Enter>", lambda e: self._ausfuehren(self.aktiv))
+        f.bind("<Left>", lambda e: self.leiste and self.leiste.nachbar(-1))
+        f.bind("<Right>", lambda e: self.leiste and self.leiste.nachbar(1))
+        self.aktiv = -1
+        self._pruefer = f.after(250, self._fokus_pruefen)
+
+    def schliessen(self):
+        if self._pruefer is not None and self.fenster is not None:
+            try:
+                self.fenster.after_cancel(self._pruefer)
+            except tk.TclError:
+                pass
+        self._pruefer = None
+        if self.offen:
+            try:
+                self.fenster.grab_release()
+            except tk.TclError:
+                pass
+            self.fenster.destroy()
+        self.fenster = None
+        if self.leiste is not None:
+            self.leiste._geschlossen(self)
+
+    # ------------------------------------------------------------- Bedienung
+    def _innerhalb(self, x_root: int, y_root: int) -> bool:
+        """Liegt der Punkt über diesem Menü? Fragt das Fenstersystem, welches Fenster dort liegt –
+        die Geometrie rahmenloser Fenster meldet Tk unter Windows nicht zuverlässig."""
+        f = self.fenster
+        try:
+            unter = f.winfo_containing(x_root, y_root)
+        except (tk.TclError, KeyError):
+            unter = None
+        if unter is not None:
+            return unter.winfo_toplevel() is f
+        return (f.winfo_rootx() <= x_root < f.winfo_rootx() + f.winfo_width()
+                and f.winfo_rooty() <= y_root < f.winfo_rooty() + f.winfo_height())
+
+    def _klick(self, e):
+        if self._innerhalb(e.x_root, e.y_root):
+            return
+        if self.leiste is not None and self.leiste.knopf_bei(e.x_root, e.y_root) is not None:
+            knopf = self.leiste.knopf_bei(e.x_root, e.y_root)
+            if knopf is self.leiste.offener_knopf:
+                self.schliessen()  # Klick auf den eigenen Menütitel klappt zu
+            else:
+                self.leiste.oeffnen(knopf)
+            return "break"
+        self.schliessen()
+        return "break"
+
+    def _bewegung(self, e):
+        if self.leiste is None or self._innerhalb(e.x_root, e.y_root):
+            return
+        knopf = self.leiste.knopf_bei(e.x_root, e.y_root)
+        if knopf is not None and knopf is not self.leiste.offener_knopf:
+            self.leiste.oeffnen(knopf)
+
+    def _markieren(self, i: int):
+        self.aktiv = i
+        for j, (e, zeile, labels) in enumerate(self.zeilen):
+            an = j == i and e.get("state") != "disabled"
+            bg = w.NAVY if an else w.FACE
+            fg = w.WHITE if an else (w.SHADOW if e.get("state") == "disabled" else w.DARK)
+            zeile.configure(bg=bg)
+            for lbl in labels:
+                lbl.configure(bg=bg, fg=fg)
+
+    def _schritt(self, richtung: int):
+        if not self.zeilen:
+            return
+        i = self.aktiv
+        for _ in range(len(self.zeilen)):
+            i = (i + richtung) % len(self.zeilen)
+            if self.zeilen[i][0].get("state") != "disabled":
+                break
+        self._markieren(i)
+
+    def _ausfuehren(self, i: int):
+        if not (0 <= i < len(self.zeilen)):
+            return
+        e = self.zeilen[i][0]
+        if e.get("state") == "disabled":
+            return
+        self.schliessen()
+        if e.get("command"):
+            # nach dem Schließen ausführen (der Befehl öffnet evtl. einen Dialog)
+            self.master.after_idle(e["command"])
+
+    def _fokus_pruefen(self):
+        """In ein anderes Programm gewechselt -> Menü schließen."""
+        self._pruefer = None
+        if not self.offen:
+            return
+        try:
+            weg = self.fenster.focus_get() is None
+        except (tk.TclError, KeyError):
+            weg = False
+        if weg:
+            self.schliessen()
+        else:
+            self._pruefer = self.fenster.after(250, self._fokus_pruefen)
+
+
+class Menueleiste(tk.Frame):
+    """Graue Menüleiste mit Popup-Menüs (die native von Windows 10/11 ist weiß)."""
+
+    def __init__(self, master, root: tk.Misc):
+        super().__init__(master, bg=w.FACE)
+        self.root = root
+        self.knoepfe: dict[str, tk.Label] = {}
+        self.menues: dict[tk.Label, Popup] = {}
+        self.offener_knopf: tk.Label | None = None
+
+    def menue(self, label: str, underline: int | None = 0) -> Popup:
+        knopf = tk.Label(self, text=label, bg=w.FACE, padx=7, pady=2, bd=1, relief="flat",
+                         underline=-1 if underline is None else underline)
+        knopf.pack(side="left")
+        popup = Popup(self)
+        self.knoepfe[label] = knopf
+        self.menues[knopf] = popup
+        knopf.bind("<ButtonPress-1>", lambda e, k=knopf: self._klick(k))
+        knopf.bind("<Enter>", lambda e, k=knopf: self._hover(k, True))
+        knopf.bind("<Leave>", lambda e, k=knopf: self._hover(k, False))
+        if underline is not None:
+            taste = label[underline].lower()
+            self.root.bind_all(f"<Alt-KeyPress-{taste}>", lambda e, k=knopf: self._alt(k))
+        return popup
+
+    # ---- Zustand
+    def knopf_bei(self, x_root: int, y_root: int) -> tk.Label | None:
+        for k in self.knoepfe.values():
+            if (k.winfo_rootx() <= x_root < k.winfo_rootx() + k.winfo_width()
+                    and k.winfo_rooty() <= y_root < k.winfo_rooty() + k.winfo_height()):
+                return k
+        return None
+
+    def _darstellen(self):
+        for k in self.knoepfe.values():
+            if k is self.offener_knopf:
+                k.configure(bg=w.NAVY, fg=w.WHITE, relief="flat")
+            else:
+                k.configure(bg=w.FACE, fg=w.DARK, relief="flat")
+
+    # ---- Bedienung
+    def oeffnen(self, knopf: tk.Label):
+        from provtool.gui import modal
+        if modal.offen():
+            return
+        alt = self.offener_knopf
+        if alt is not None and alt is not knopf:
+            self.menues[alt].leiste = None  # ohne Rückmeldung schließen, wir öffnen gleich das nächste
+            self.menues[alt].schliessen()
+        self.offener_knopf = knopf
+        self._darstellen()
+        self.menues[knopf].oeffnen(knopf.winfo_rootx(), knopf.winfo_rooty() + knopf.winfo_height(), leiste=self)
+
+    def schliessen(self):
+        if self.offener_knopf is not None:
+            self.menues[self.offener_knopf].schliessen()
+
+    def _geschlossen(self, popup: Popup):
+        if self.offener_knopf is not None and self.menues.get(self.offener_knopf) is popup:
+            self.offener_knopf = None
+            self._darstellen()
+
+    def nachbar(self, richtung: int):
+        liste = list(self.knoepfe.values())
+        if self.offener_knopf in liste:
+            i = (liste.index(self.offener_knopf) + richtung) % len(liste)
+            self.oeffnen(liste[i])
+
+    def _klick(self, knopf):
+        if self.offener_knopf is knopf:
+            self.schliessen()
+        else:
+            self.oeffnen(knopf)
+        return "break"
+
+    def _hover(self, knopf, drin: bool):
+        if self.offener_knopf is None:
+            knopf.configure(relief="raised" if drin else "flat")
+
+    def _alt(self, knopf):
+        self.oeffnen(knopf)
+        if self.offener_knopf is knopf:
+            self.menues[knopf]._schritt(1)
+        return "break"

provtool/gui/modal.py

@@ -0,0 +1,93 @@
+"""Modale Sperre ohne Tk-„grab“: Nur der INHALT des aufrufenden Fensters wird gesperrt.
+
+Titelleiste und Rand bleiben bedienbar – das Hauptfenster lässt sich also verschieben, maximieren
+und in der Größe ändern, während ein Dialog offen ist. Klickt man auf den gesperrten Inhalt, kommt
+der Dialog nach vorn und blinkt kurz (wie bei Windows).
+
+Technik: Jedes Widget im gesperrten Bereich bekommt vorn das Bindungs-Tag ``Pm95Gesperrt``. Dessen
+Bindungen laufen vor allen anderen und beenden Klicks/Tastendrücke mit „break“.
+"""
+from __future__ import annotations
+
+import tkinter as tk
+
+TAG = "Pm95Gesperrt"
+_stapel: list[tk.Toplevel] = []  # offene modale Fenster, innerstes zuletzt
+
+GESPERRTE_EREIGNISSE = ("<ButtonPress>", "<ButtonRelease>", "<Double-ButtonPress>", "<Triple-ButtonPress>",
+                        "<B1-Motion>", "<KeyPress>", "<KeyRelease>", "<MouseWheel>")
+
+
+def oberstes() -> tk.Toplevel | None:
+    """Das zuletzt geöffnete, noch offene modale Fenster (oder None)."""
+    while _stapel:
+        d = _stapel[-1]
+        try:
+            if d.winfo_exists():
+                return d
+        except tk.TclError:
+            pass
+        _stapel.pop()
+    return None
+
+
+def offen() -> bool:
+    return oberstes() is not None
+
+
+def _gesperrt_geklickt(event):
+    d = oberstes()
+    if d is not None and hasattr(d, "nach_vorn"):
+        d.nach_vorn(blinken=str(event.type) in ("ButtonPress", "4"))
+    return "break"
+
+
+def _einrichten(root: tk.Misc):
+    # Merker am Tk-Objekt selbst (nicht am Namen: das Hauptfenster heißt in jeder Tk-Instanz „.“)
+    if getattr(root, "_pm95_sperre_eingerichtet", False):
+        return
+    for seq in GESPERRTE_EREIGNISSE:
+        root.bind_class(TAG, seq, _gesperrt_geklickt)
+    root._pm95_sperre_eingerichtet = True
+
+
+def sperrbereiche(fenster: tk.Misc) -> list[tk.Misc]:
+    """Welche Widgets eines Fensters gesperrt werden: alles außer Titelleiste (und Rand)."""
+    eigene = getattr(fenster, "sperrbereich", None)
+    if callable(eigene):
+        return list(eigene())
+    titel = getattr(fenster, "titelleiste", None)
+    return [k for k in fenster.winfo_children() if k is not titel and not isinstance(k, tk.Toplevel)]
+
+
+class Sperre:
+    """Sperrt den Inhalt von `fenster`, solange `dialog` offen ist."""
+
+    def __init__(self, fenster: tk.Misc, dialog: tk.Toplevel):
+        _einrichten(fenster._root())
+        self.widgets: list[tk.Misc] = []
+        for bereich in sperrbereiche(fenster):
+            self._sperren(bereich)
+        _stapel.append(dialog)
+        self.dialog = dialog
+
+    def _sperren(self, w: tk.Misc):
+        if isinstance(w, tk.Toplevel):
+            return  # eigene Fenster (z. B. andere Dialoge) nicht anfassen
+        tags = w.bindtags()
+        if TAG not in tags:
+            w.bindtags((TAG,) + tuple(tags))
+            self.widgets.append(w)
+        for kind in w.winfo_children():
+            self._sperren(kind)
+
+    def aufheben(self):
+        for w in self.widgets:
+            try:
+                if w.winfo_exists():
+                    w.bindtags(tuple(t for t in w.bindtags() if t != TAG))
+            except tk.TclError:
+                pass
+        self.widgets = []
+        if self.dialog in _stapel:
+            _stapel.remove(self.dialog)

provtool/gui/nativ.py

@@ -0,0 +1,311 @@
+"""Windows: echtes Programmfenster mit selbst gezeichnetem Win95-Rahmen.
+
+Das Hauptfenster ist für Tk rahmenlos („overrideredirect“). Für Windows war es damit ein Popup ohne
+Größenrahmen – deshalb gingen Andocken (Fenster an den Rand ziehen), Win+Hoch/Runter/Links/Rechts und
+das native Ziehen der Fenstergröße nicht.
+
+Jetzt bekommt das äußere Windows-Fenster die Stile eines normalen Programmfensters (Titelleiste,
+Größenrahmen, Min/Max, Taskleiste), deren Rahmen aber *unsichtbar* bleibt: Bei WM_NCCALCSIZE melden
+wir „der Innenbereich ist das ganze Fenster“. Für Tk bleibt es rahmenlos – Tk rechnet bei
+Größenänderungen also weiter ohne Rahmenaufschlag (sonst würde das Fenster bei jeder internen
+Größenanpassung um die Rahmenbreite wachsen). Windows erledigt alles Weitere selbst:
+- Ziehen an der Titelleiste (WM_NCLBUTTONDOWN/HTCAPTION) mit Andocken links/rechts/oben (Maximieren)
+- Win+Pfeiltasten, Doppelklick, Systemmenü (Alt+Leertaste), Taskleiste, Alt+Tab
+- Größe ändern: Am Rand meldet das Fenster per WM_NCHITTEST „linker Rand“ usw. -> Windows zeigt den
+  passenden Mauszeiger und zieht die Größe selbst (flüssig, kein hängender Zeiger).
+
+WICHTIG: Die Fensterprozeduren hier laufen mitten in Tk. Sie dürfen Tk NICHT aufrufen (Tk-Sperre ->
+Verklemmung), nur Win32-Funktionen.
+"""
+from __future__ import annotations
+
+import ctypes
+import sys
+import tkinter as tk
+from ctypes import wintypes
+
+IS_WIN = sys.platform.startswith("win")
+
+WM_NCDESTROY, WM_NCCALCSIZE, WM_NCHITTEST, WM_NCACTIVATE = 0x0082, 0x0083, 0x0084, 0x0086
+WM_NCLBUTTONDOWN, WM_SYSCOMMAND, WM_SETCURSOR = 0x00A1, 0x0112, 0x0020
+HTCLIENT, HTCAPTION, HTTRANSPARENT = 1, 2, -1
+HT = {"w": 10, "e": 11, "n": 12, "nw": 13, "ne": 14, "s": 15, "sw": 16, "se": 17}
+GWL_STYLE, GWL_EXSTYLE = -16, -20
+WS_CAPTION, WS_THICKFRAME, WS_SYSMENU = 0x00C00000, 0x00040000, 0x00080000
+WS_MINIMIZEBOX, WS_MAXIMIZEBOX = 0x00020000, 0x00010000
+WS_EX_TOOLWINDOW, WS_EX_APPWINDOW = 0x00000080, 0x00040000
+ZEIGER = {"n": 32645, "s": 32645, "w": 32644, "e": 32644, "nw": 32642, "se": 32642, "ne": 32643, "sw": 32643}
+HT_RAND = {v: k for k, v in HT.items()}
+SWP_NOSIZE, SWP_NOMOVE, SWP_NOZORDER, SWP_NOACTIVATE, SWP_FRAMECHANGED = 0x1, 0x2, 0x4, 0x10, 0x20
+SC_MAXIMIZE, SC_RESTORE, SC_MINIMIZE = 0xF030, 0xF120, 0xF020
+
+LRESULT = ctypes.c_ssize_t
+SUBCLASSPROC = ctypes.WINFUNCTYPE(LRESULT, wintypes.HWND, wintypes.UINT, wintypes.WPARAM, wintypes.LPARAM,
+                                  ctypes.c_size_t, ctypes.c_size_t) if IS_WIN else None
+
+
+class NCCALCSIZE_PARAMS(ctypes.Structure):
+    _fields_ = [("rgrc", wintypes.RECT * 3), ("lppos", ctypes.c_void_p)]
+
+
+class MONITORINFO(ctypes.Structure):
+    _fields_ = [("cbSize", wintypes.DWORD), ("rcMonitor", wintypes.RECT), ("rcWork", wintypes.RECT),
+                ("dwFlags", wintypes.DWORD)]
+
+
+_dll = {}
+
+
+def _api():
+    if _dll:
+        return _dll["u"], _dll["c"]
+    u = ctypes.WinDLL("user32", use_last_error=True)
+    c = ctypes.WinDLL("comctl32", use_last_error=True)
+    H, U, W, L = wintypes.HWND, wintypes.UINT, wintypes.WPARAM, wintypes.LPARAM
+    for name, args, res in (
+            ("GetAncestor", [H, U], H), ("GetWindowRect", [H, ctypes.POINTER(wintypes.RECT)], wintypes.BOOL),
+            ("GetClientRect", [H, ctypes.POINTER(wintypes.RECT)], wintypes.BOOL),
+            ("IsZoomed", [H], wintypes.BOOL), ("IsIconic", [H], wintypes.BOOL),
+            ("GetWindowLongW", [H, ctypes.c_int], ctypes.c_long),
+            ("SetWindowLongW", [H, ctypes.c_int, ctypes.c_long], ctypes.c_long),
+            ("SetWindowPos", [H, H, ctypes.c_int, ctypes.c_int, ctypes.c_int, ctypes.c_int, U], wintypes.BOOL),
+            ("MonitorFromRect", [ctypes.POINTER(wintypes.RECT), wintypes.DWORD], wintypes.HMONITOR),
+            ("GetMonitorInfoW", [wintypes.HMONITOR, ctypes.POINTER(MONITORINFO)], wintypes.BOOL),
+            ("ReleaseCapture", [], wintypes.BOOL), ("SendMessageW", [H, U, W, L], LRESULT),
+            ("PostMessageW", [H, U, W, L], wintypes.BOOL), ("ShowWindow", [H, ctypes.c_int], wintypes.BOOL),
+            ("WindowFromPoint", [wintypes.POINT], H),
+            ("LoadCursorW", [wintypes.HINSTANCE, ctypes.c_void_p], wintypes.HANDLE),
+            ("SetCursor", [wintypes.HANDLE], wintypes.HANDLE)):
+        f = getattr(u, name)
+        f.argtypes, f.restype = args, res
+    c.SetWindowSubclass.argtypes = [H, SUBCLASSPROC, ctypes.c_size_t, ctypes.c_size_t]
+    c.SetWindowSubclass.restype = wintypes.BOOL
+    c.RemoveWindowSubclass.argtypes = [H, SUBCLASSPROC, ctypes.c_size_t]
+    c.RemoveWindowSubclass.restype = wintypes.BOOL
+    c.DefSubclassProc.argtypes = [H, U, W, L]
+    c.DefSubclassProc.restype = LRESULT
+    _dll.update(u=u, c=c)
+    return u, c
+
+
+def _rect(h) -> wintypes.RECT:
+    r = wintypes.RECT()
+    _api()[0].GetWindowRect(h, ctypes.byref(r))
+    return r
+
+
+def _xy(lparam: int) -> tuple[int, int]:
+    """Bildschirmkoordinaten aus lParam (vorzeichenbehaftet, mehrere Monitore)."""
+    x, y = lparam & 0xFFFF, (lparam >> 16) & 0xFFFF
+    return (x - 0x10000 if x & 0x8000 else x), (y - 0x10000 if y & 0x8000 else y)
+
+
+def arbeitsbereich_von(rect: wintypes.RECT) -> wintypes.RECT | None:
+    u, _ = _api()
+    mon = u.MonitorFromRect(ctypes.byref(rect), 2)  # MONITOR_DEFAULTTONEAREST
+    mi = MONITORINFO()
+    mi.cbSize = ctypes.sizeof(MONITORINFO)
+    return mi.rcWork if mon and u.GetMonitorInfoW(mon, ctypes.byref(mi)) else None
+
+
+class NativerRahmen:
+    """Macht das Tk-Hauptfenster zu einem echten Windows-Fenster ohne sichtbaren Windows-Rahmen.
+
+    rand_widgets: Tk-Widgets, die am Fensterrand liegen (deren Randbereich wird für die Maus
+    „durchsichtig“, damit Windows dort den Größenrahmen erkennt).
+    """
+
+    def __init__(self, root: tk.Tk, rand: int, ecke: int):
+        self.root = root
+        self.rand, self.ecke = rand, ecke
+        self.hwnd = None
+        self.aktiv = False
+        self._procs: dict[int, object] = {}   # Referenzen halten, sonst räumt Python die Callbacks weg
+        self._rand_hwnds: set[int] = set()
+
+    # ------------------------------------------------------------------ Einrichten
+    def einrichten(self, rand_widgets: list[tk.Misc]) -> bool:
+        """Nach dem ersten Anzeigen aufrufen (vorher gibt es das äußere Windows-Fenster noch nicht)."""
+        if self.aktiv:
+            return True
+        try:
+            u, c = _api()
+            self.root.update_idletasks()
+            h = self.aeusseres_fenster()
+            if not h:
+                return False
+            self.hwnd = h
+            stil = u.GetWindowLongW(h, GWL_STYLE)
+            u.SetWindowLongW(h, GWL_STYLE, stil | WS_CAPTION | WS_THICKFRAME | WS_SYSMENU | WS_MINIMIZEBOX
+                             | WS_MAXIMIZEBOX)
+            ex = u.GetWindowLongW(h, GWL_EXSTYLE)
+            u.SetWindowLongW(h, GWL_EXSTYLE, (ex & ~WS_EX_TOOLWINDOW) | WS_EX_APPWINDOW)
+            if not self._unterklasse(h, self._aussen_proc):
+                return False
+            for wdg in rand_widgets:
+                hw = wdg.winfo_id()
+                if self._unterklasse(hw, self._rand_proc):
+                    self._rand_hwnds.add(hw)
+            self.aktiv = True
+            # Rahmen neu berechnen lassen (jetzt: unsichtbar)
+            u.SetWindowPos(h, None, 0, 0, 0, 0, SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER | SWP_NOACTIVATE
+                           | SWP_FRAMECHANGED)
+            self._ecken_nicht_runden(h)
+            return True
+        except (OSError, AttributeError, tk.TclError):
+            return False
+
+    def aeusseres_fenster(self) -> int | None:
+        """Das äußere Windows-Fenster („wm frame“) – None, solange Tk es noch nicht angelegt hat."""
+        try:
+            h = int(self.root.wm_frame(), 16)
+        except (tk.TclError, ValueError):
+            return None
+        return h if h and h != self.root.winfo_id() else None
+
+    def veraltet(self) -> bool:
+        """Hat Tk das äußere Fenster neu angelegt (z. B. nach „wm resizable“)? Dann neu einrichten."""
+        return self.aktiv and self.aeusseres_fenster() not in (None, self.hwnd)
+
+    def neu_einrichten(self, rand_widgets: list[tk.Misc]) -> bool:
+        self.aktiv = False
+        self._rand_hwnds.clear()
+        return self.einrichten(rand_widgets)
+
+    def _unterklasse(self, h: int, fn) -> bool:
+        _, c = _api()
+        proc = SUBCLASSPROC(fn)
+        if not c.SetWindowSubclass(h, proc, 1, 0):
+            return False
+        self._procs[h] = proc
+        return True
+
+    @staticmethod
+    def _ecken_nicht_runden(h):
+        """Windows 11 rundet Fensterecken – passt nicht zum Win95-Look."""
+        try:
+            wert = ctypes.c_int(1)  # DWMWCP_DONOTROUND
+            ctypes.windll.dwmapi.DwmSetWindowAttribute(wintypes.HWND(h), 33, ctypes.byref(wert), 4)
+        except (OSError, AttributeError):
+            pass
+
+    # ------------------------------------------------------------------ Fensterprozeduren (KEIN Tk!)
+    def randbereich(self, x: int, y: int) -> str:
+        """Welcher Rand liegt am Bildschirmpunkt? '' = keiner (oder maximiert)."""
+        u, _ = _api()
+        h = self.hwnd
+        if not h or u.IsZoomed(h) or u.IsIconic(h):
+            return ""
+        r = _rect(h)
+        if not (r.left <= x < r.right and r.top <= y < r.bottom):
+            return ""
+        d, k = self.rand, self.ecke
+        ns = "n" if y < r.top + d else "s" if y >= r.bottom - d else ""
+        we = "w" if x < r.left + d else "e" if x >= r.right - d else ""
+        if ns and not we:
+            we = "w" if x < r.left + k else "e" if x >= r.right - k else ""
+        elif we and not ns:
+            ns = "n" if y < r.top + k else "s" if y >= r.bottom - k else ""
+        return ns + we
+
+    def _aussen_proc(self, hwnd, msg, wparam, lparam, _id, _ref):
+        _, c = _api()
+        try:
+            if msg == WM_NCCALCSIZE:
+                if wparam:
+                    # Innenbereich = ganzes Fenster. Maximiert legt Windows das Fenster um die (jetzt
+                    # unsichtbare) Rahmenbreite über den Bildschirmrand -> auf den Arbeitsbereich begrenzen.
+                    if _api()[0].IsZoomed(hwnd):
+                        p = ctypes.cast(lparam, ctypes.POINTER(NCCALCSIZE_PARAMS)).contents
+                        arbeit = arbeitsbereich_von(p.rgrc[0])
+                        if arbeit is not None:
+                            p.rgrc[0] = arbeit
+                return 0
+            if msg == WM_NCACTIVATE:
+                # Nicht den (unsichtbaren) Windows-Rahmen neu zeichnen lassen (klassisches Design)
+                return c.DefSubclassProc(hwnd, msg, wparam, -1)
+            if msg == WM_NCHITTEST:
+                rand = self.randbereich(*_xy(lparam))
+                if rand:
+                    return HT[rand]
+                return HTCLIENT
+            if msg == WM_SETCURSOR and (lparam & 0xFFFF) in HT_RAND:
+                u = _api()[0]
+                u.SetCursor(u.LoadCursorW(None, ZEIGER[HT_RAND[lparam & 0xFFFF]]))
+                return 1
+            if msg == WM_NCDESTROY:
+                self._entfernen(hwnd)
+        except Exception:  # niemals eine Ausnahme in die Fensterprozedur durchlassen
+            pass
+        return c.DefSubclassProc(hwnd, msg, wparam, lparam)
+
+    def _rand_proc(self, hwnd, msg, wparam, lparam, _id, _ref):
+        _, c = _api()
+        try:
+            if msg == WM_NCHITTEST and self.randbereich(*_xy(lparam)):
+                return HTTRANSPARENT  # Maus „fällt durch“ zum äußeren Fenster -> Größenrahmen
+            if msg == WM_NCDESTROY:
+                self._entfernen(hwnd)
+        except Exception:
+            pass
+        return c.DefSubclassProc(hwnd, msg, wparam, lparam)
+
+    def _entfernen(self, hwnd):
+        proc = self._procs.pop(hwnd, None)
+        if proc is not None:
+            try:
+                _api()[1].RemoveWindowSubclass(hwnd, proc, 1)
+            except OSError:
+                pass
+            # Callback-Objekt bleibt bis Programmende referenziert (Windows könnte ihn noch einmal rufen)
+            _BEHALTEN.append(proc)
+
+    # ------------------------------------------------------------------ Bedienung
+    def verschieben(self) -> None:
+        """Titelleiste gedrückt: Windows zieht das Fenster (mit Andocken an den Bildschirmrand)."""
+        u, _ = _api()
+        u.ReleaseCapture()
+        u.SendMessageW(self.hwnd, WM_NCLBUTTONDOWN, HTCAPTION, 0)
+
+    def groesse_ziehen(self, rand: str) -> None:
+        u, _ = _api()
+        u.ReleaseCapture()
+        u.SendMessageW(self.hwnd, WM_NCLBUTTONDOWN, HT[rand], 0)
+
+    def maximiert(self) -> bool:
+        return bool(self.hwnd and _api()[0].IsZoomed(self.hwnd))
+
+    def befehl(self, sc: int) -> None:
+        """SC_MAXIMIZE / SC_RESTORE / SC_MINIMIZE – wie über das Systemmenü (mit Windows-Animation)."""
+        _api()[0].SendMessageW(self.hwnd, WM_SYSCOMMAND, sc, 0)
+
+    def aussenmass(self) -> tuple[int, int, int, int]:
+        r = _rect(self.hwnd)
+        return r.left, r.top, r.right - r.left, r.bottom - r.top
+
+    def setzen(self, x: int, y: int, breite: int, hoehe: int) -> None:
+        """Position und Größe des Fensters genau so setzen (ohne Tk-Rahmenaufschlag)."""
+        _api()[0].SetWindowPos(self.hwnd, None, x, y, breite, hoehe, SWP_NOZORDER | SWP_NOACTIVATE)
+
+    def innen_gleich_aussen(self) -> bool:
+        """Für Tests: Ist der Windows-Rahmen wirklich unsichtbar?"""
+        u, _ = _api()
+        a, i = _rect(self.hwnd), wintypes.RECT()
+        u.GetClientRect(self.hwnd, ctypes.byref(i))
+        return (i.right - i.left, i.bottom - i.top) == (a.right - a.left, a.bottom - a.top)
+
+    def stil(self) -> tuple[int, int]:
+        u, _ = _api()
+        return u.GetWindowLongW(self.hwnd, GWL_STYLE), u.GetWindowLongW(self.hwnd, GWL_EXSTYLE)
+
+    def fenster_bei(self, x: int, y: int) -> int | None:
+        """Für Tests: Welches Fenster bekommt die Maus am Bildschirmpunkt (berücksichtigt HTTRANSPARENT)?"""
+        return _api()[0].WindowFromPoint(wintypes.POINT(x, y))
+
+    def trefferpruefung(self, hwnd: int, x: int, y: int) -> int:
+        """Für Tests: Was meldet das Fenster `hwnd` für den Bildschirmpunkt (WM_NCHITTEST)?"""
+        lp = ((y & 0xFFFF) << 16) | (x & 0xFFFF)
+        return _api()[0].SendMessageW(hwnd, WM_NCHITTEST, 0, lp)
+
+
+_BEHALTEN: list = []

provtool/gui/rahmen.py

@@ -0,0 +1,550 @@
+"""Selbst gezeichneter Windows-95-Fensterrahmen.
+
+Windows erlaubt Tk nicht, die echte Titelleiste umzufärben. Deshalb wird sie ausgeblendet
+(overrideredirect) und hier nachgebaut: blaue Titelleiste mit Icon und _ □ x, Verschieben,
+Doppelklick = Maximieren, Größenänderung über den Rand und den Anfasser unten rechts,
+graue Menüleiste.
+
+Unter Windows ist das Hauptfenster trotzdem ein echtes Programmfenster (siehe nativ.py): Windows
+übernimmt Verschieben, Größe ändern, Andocken am Bildschirmrand, Win+Pfeiltasten, Taskleiste und
+Alt+Tab. Auf anderen Systemen (Entwicklung/Tests) macht Tk das selbst.
+"""
+from __future__ import annotations
+
+import sys
+import tkinter as tk
+
+from provtool.gui import win95 as w
+
+IS_WIN = sys.platform.startswith("win")
+
+# --------------------------------------------------------------------------- Glyphen
+
+GLYPHEN = {
+    "min": """
+        ........
+        ........
+        ........
+        ........
+        ........
+        ........
+        kkkkkk..
+        kkkkkk..""",
+    "max": """
+        kkkkkkkkk
+        kkkkkkkkk
+        k.......k
+        k.......k
+        k.......k
+        k.......k
+        k.......k
+        kkkkkkkkk""",
+    "restore": """
+        ..kkkkkk
+        ..kkkkkk
+        ..k....k
+        kkkkkk.k
+        kkkkkk.k
+        k....kkk
+        k....k..
+        kkkkkk..""",
+    "close": """
+        kk....kk
+        .kk..kk.
+        ..kkkk..
+        ...kk...
+        ..kkkk..
+        .kk..kk.
+        kk....kk""",
+}
+
+
+def glyph(master, name: str) -> tk.PhotoImage:
+    rows = [r.strip() for r in GLYPHEN[name].strip("\n").splitlines() if r.strip()]
+    breite = max(len(r) for r in rows)
+    img = tk.PhotoImage(master=master, width=breite, height=len(rows))
+    for y, row in enumerate(rows):
+        for x, ch in enumerate(row):
+            if ch != ".":
+                img.put(w.PALETTE[ch], (x, y))
+    return img
+
+
+def griff_bild(master, groesse: int = 12) -> tk.PhotoImage:
+    """Der typische schraffierte Größen-Anfasser unten rechts."""
+    img = tk.PhotoImage(master=master, width=groesse, height=groesse)
+    for y in range(groesse):
+        for x in range(groesse):
+            d = x + y - (groesse - 1)
+            if d >= 0:
+                farbe = (w.HILITE, w.SHADOW, w.SHADOW, None)[d % 4]
+                if farbe:
+                    img.put(farbe, (x, y))
+    return img
+
+
+# --------------------------------------------------------------------------- Win32-Hilfen
+
+def _hwnd(fenster: tk.Misc) -> int:
+    import ctypes
+    return ctypes.windll.user32.GetParent(fenster.winfo_id())
+
+
+def taskleiste_anzeigen(fenster: tk.Tk) -> None:
+    """Ein overrideredirect-Fenster erscheint unter Windows sonst nicht in Taskleiste/Alt+Tab."""
+    if not IS_WIN:
+        return
+    try:
+        import ctypes
+        GWL_EXSTYLE, WS_EX_APPWINDOW, WS_EX_TOOLWINDOW = -20, 0x00040000, 0x00000080
+        hwnd = _hwnd(fenster)
+        stil = ctypes.windll.user32.GetWindowLongW(hwnd, GWL_EXSTYLE)
+        stil = (stil & ~WS_EX_TOOLWINDOW) | WS_EX_APPWINDOW
+        ctypes.windll.user32.SetWindowLongW(hwnd, GWL_EXSTYLE, stil)
+        fenster.wm_withdraw()
+        fenster.after(10, lambda: (fenster.wm_deiconify(), fenster.focus_force()))
+    except Exception:
+        pass
+
+
+def arbeitsbereich(fenster: tk.Misc) -> tuple[int, int, int, int]:
+    """Bildschirmbereich ohne Taskleiste (des Monitors, auf dem das Fenster steht): x, y, breite, höhe."""
+    if IS_WIN:
+        try:
+            import ctypes
+            from ctypes import wintypes
+
+            class MONITORINFO(ctypes.Structure):
+                _fields_ = [("cbSize", wintypes.DWORD), ("rcMonitor", wintypes.RECT),
+                            ("rcWork", wintypes.RECT), ("dwFlags", wintypes.DWORD)]
+
+            mon = ctypes.windll.user32.MonitorFromWindow(_hwnd(fenster), 2)  # MONITOR_DEFAULTTONEAREST
+            mi = MONITORINFO()
+            mi.cbSize = ctypes.sizeof(MONITORINFO)
+            if ctypes.windll.user32.GetMonitorInfoW(mon, ctypes.byref(mi)):
+                r = mi.rcWork
+                return r.left, r.top, r.right - r.left, r.bottom - r.top
+        except Exception:
+            pass
+    return 0, 0, fenster.winfo_screenwidth(), fenster.winfo_screenheight()
+
+
+# --------------------------------------------------------------------------- Bausteine
+
+class TitelKnopf(tk.Label):
+    def __init__(self, master, bild: tk.PhotoImage, command):
+        super().__init__(master, image=bild, bg=w.FACE, bd=2, relief="raised", width=14, height=12)
+        self.command = command
+        self.bind("<ButtonPress-1>", lambda e: self.configure(relief="sunken"))
+        self.bind("<ButtonRelease-1>", self._los)
+
+    def _los(self, e):
+        self.configure(relief="raised")
+        if 0 <= e.x < self.winfo_width() and 0 <= e.y < self.winfo_height():
+            self.command()
+
+
+class Titelleiste(tk.Frame):
+    """Blaue Win95-Titelleiste. knoepfe: Teilmenge von ("min", "max", "close")."""
+
+    def __init__(self, master, fenster: tk.Misc, titel: str, icon: tk.PhotoImage | None, knoepfe=("close",),
+                 schliessen=None, minimieren=None, maximieren=None):
+        super().__init__(master, bg=w.NAVY, height=20)
+        self.fenster = fenster
+        self._bilder = {n: glyph(self, n) for n in ("min", "max", "restore", "close")}
+        if icon is not None:
+            tk.Label(self, image=icon, bg=w.NAVY).pack(side="left", padx=(2, 0))
+        self.titel_var = tk.StringVar(value=titel)
+        self.titel_lbl = tk.Label(self, textvariable=self.titel_var, bg=w.NAVY, fg=w.WHITE, font=w.FONT_BOLD,
+                                  anchor="w")
+        self.titel_lbl.pack(side="left", fill="x", expand=True, padx=3)
+        self.knoepfe: dict[str, TitelKnopf] = {}
+        if "close" in knoepfe:
+            self.knoepfe["close"] = TitelKnopf(self, self._bilder["close"], schliessen)
+            self.knoepfe["close"].pack(side="right", padx=(2, 2), pady=2)
+        if "max" in knoepfe:
+            self.knoepfe["max"] = TitelKnopf(self, self._bilder["max"], maximieren)
+            self.knoepfe["max"].pack(side="right", pady=2)
+        if "min" in knoepfe:
+            self.knoepfe["min"] = TitelKnopf(self, self._bilder["min"], minimieren)
+            self.knoepfe["min"].pack(side="right", pady=2)
+        self._maximieren = maximieren
+        for widget in (self, self.titel_lbl):
+            widget.bind("<ButtonPress-1>", self._start)
+            widget.bind("<B1-Motion>", self._ziehen)
+            if maximieren:
+                widget.bind("<Double-Button-1>", lambda e: maximieren())
+        self._ab = (0, 0)
+        self.ziehen_erlaubt = lambda: True
+
+    def set_titel(self, t: str):
+        self.titel_var.set(t)
+
+    def max_symbol(self, maximiert: bool):
+        if "max" in self.knoepfe:
+            self.knoepfe["max"].configure(image=self._bilder["restore" if maximiert else "max"])
+
+    def _start(self, e):
+        self._ab = (e.x_root - self.fenster.winfo_rootx(), e.y_root - self.fenster.winfo_rooty())
+        self._nativ = False
+        if NATIV_VERSCHIEBEN and IS_WIN and self.ziehen_erlaubt():
+            # Windows übernimmt das Ziehen: flüssig und mit Andocken am Bildschirmrand
+            from provtool.gui import win32
+            self._nativ = win32.nativ_verschieben(self.fenster)
+            if self._nativ:
+                return "break"
+
+    def _ziehen(self, e):
+        if self._nativ or not self.ziehen_erlaubt():
+            return
+        self.fenster.geometry(f"+{e.x_root - self._ab[0]}+{e.y_root - self._ab[1]}")
+
+    def blinken(self, mal: int = 3):
+        """Titelleiste kurz grau/blau blinken lassen (wie Windows bei gesperrtem Fenster)."""
+        farben = [w.SHADOW, w.NAVY] * mal
+
+        def schritt(i=0):
+            if i >= len(farben) or not self.winfo_exists():
+                return
+            for widget in (self, self.titel_lbl):
+                widget.configure(bg=farben[i])
+            self.after(70, lambda: schritt(i + 1))
+        schritt()
+
+
+NATIV_VERSCHIEBEN = True  # Tests können das abschalten, um den Tk-Weg zu prüfen
+NATIVER_RAHMEN = True     # Windows: echtes Fenster mit unsichtbarem Rahmen (nativ.py)
+
+
+# --------------------------------------------------------------------------- Hauptfenster
+
+class Hauptrahmen:
+    """Umgibt das Hauptfenster. Im klassischen Modus mit eigener Titelleiste, sonst nur ein Container."""
+
+    RAND = 6    # Pixel am Rand, an denen man die Größe ziehen kann (= sichtbarer Rahmen)
+    ECKE = 18   # so weit vom Eck entfernt gilt der Rand noch als Ecke (diagonal ziehen)
+
+    def __init__(self, root: tk.Tk, titel: str, icon: tk.PhotoImage, schliessen, klassisch: bool = True,
+                 minbreite: int = 900, minhoehe: int = 520):
+        self.root, self.klassisch = root, klassisch
+        self.minbreite, self.minhoehe = minbreite, minhoehe
+        self.maximiert = False
+        self._normal_geo: str | None = None
+        self._schliessen = schliessen
+        root.minsize(minbreite, minhoehe)
+        if not klassisch:
+            self.aussen = tk.Frame(root, bg=w.FACE)
+            self.aussen.pack(fill="both", expand=True)
+            self.inhalt = self.aussen
+            self.titelleiste = None
+            root.sperrbereich = lambda: [self.inhalt]  # type: ignore[attr-defined]  # für modal.py
+            return
+
+        root.overrideredirect(True)
+        self.aussen = tk.Frame(root, bg=w.FACE, bd=2, relief="raised", padx=self.RAND - 2, pady=self.RAND - 2)
+        self.aussen.pack(fill="both", expand=True)
+        self.titelleiste = Titelleiste(self.aussen, root, titel, icon, ("min", "max", "close"),
+                                       schliessen=schliessen, minimieren=self.minimieren,
+                                       maximieren=self.umschalten)
+        self.titelleiste.pack(fill="x")
+        # Maximiert darf man nur nativ ziehen (Windows stellt das Fenster dabei wieder her)
+        self.titelleiste.ziehen_erlaubt = lambda: not self.maximiert or self.nativ_an
+        self.inhalt = tk.Frame(self.aussen, bg=w.FACE)
+        self.inhalt.pack(fill="both", expand=True)
+        # Gesperrt wird bei offenem Dialog nur der Inhalt – Titelleiste und Rand bleiben bedienbar
+        root.sperrbereich = lambda: [self.inhalt]  # type: ignore[attr-defined]
+
+        self._rand: str = ""
+        self._resize_geplant = None
+        self.aussen.bind("<Motion>", self._rand_cursor)
+        # Mauszeiger zurücksetzen, sobald der Rand verlassen wird – Kindfenster erben sonst den
+        # Größenänderungs-Zeiger, wenn das letzte Motion-Ereignis am Rand verpasst wurde.
+        self.aussen.bind("<Leave>", self._cursor_zurueck)
+        self.inhalt.bind("<Enter>", self._cursor_zurueck)
+        self.titelleiste.bind("<Enter>", self._cursor_zurueck, add="+")
+        self.aussen.bind("<ButtonPress-1>", self._resize_start)
+        self.aussen.bind("<B1-Motion>", self._resize)
+        root.bind_all("<Alt-F4>", lambda e: self.alt_f4(e.widget))
+
+        self.nativ = None
+        if IS_WIN and NATIVER_RAHMEN:
+            from provtool.gui.nativ import NativerRahmen
+            self.nativ = NativerRahmen(root, self.RAND, self.ECKE)
+            root.bind("<Configure>", self._fenster_geaendert, add="+")
+            root.bind("<Map>", lambda e: e.widget is root and self._nativ_einrichten(), add="+")
+            self._nativ_einrichten()  # möglichst schon vor dem ersten Anzeigen
+        root.after(50, self._fenster_einrichten)
+
+    # ---- natives Windows-Fenster
+    @property
+    def nativ_an(self) -> bool:
+        return self.nativ is not None and self.nativ.aktiv
+
+    def _nativ_einrichten(self) -> bool:
+        if self.nativ is None:
+            return False
+        if self.nativ.aktiv and not self.nativ.veraltet():
+            return True
+        try:
+            sichtbar = bool(self.root.winfo_viewable())
+        except tk.TclError:
+            sichtbar = True
+        if self.nativ.veraltet():  # Tk hat das äußere Fenster neu angelegt
+            ok = self.nativ.neu_einrichten([self.root, self.aussen])
+        else:
+            ok = self.nativ.einrichten([self.root, self.aussen])
+        if ok:
+            # Erst eingerichtet, als das Fenster schon zu sehen war -> Taskleiste muss es neu erfassen
+            self._taskleiste_neu = sichtbar
+        return ok
+
+    _taskleiste_neu = True
+
+    def _fenster_einrichten(self):
+        self._nativ_einrichten()
+        if self.nativ_an and not self._taskleiste_neu:
+            return  # vor dem ersten Anzeigen eingerichtet: Windows kennt den Taskleisten-Stil schon
+        taskleiste_anzeigen(self.root)
+
+    def _fenster_geaendert(self, e):
+        """Zustand nachführen – maximieren/wiederherstellen geht jetzt auch über Windows selbst
+        (Win+Hoch, an den oberen Rand ziehen, Doppelklick, Taskleiste)."""
+        if e.widget is not self.root or self.nativ is None:
+            return
+        if self.nativ.veraltet():
+            self._nativ_einrichten()
+        if not self.nativ_an:
+            return
+        try:
+            maximiert = self.nativ.maximiert()
+            if maximiert != self.maximiert:
+                self.maximiert = maximiert
+                self.titelleiste.max_symbol(maximiert)
+                self._cursor_zurueck()
+            if not maximiert and self.root.wm_state() == "normal":
+                self._normal_geo = self.root.geometry()
+        except Exception:
+            pass
+
+    def alt_f4(self, widget) -> str:
+        """Alt+F4 wie unter Windows: schließt nur das Fenster, in dem man gerade ist."""
+        try:
+            # Ist ein modaler Dialog offen, gilt Alt+F4 immer ihm – egal wo der Tastaturfokus liegt
+            # (unter Windows liefert Tk Tastendrücke an das Fenster mit Fokus, das kann noch das
+            # Hauptfenster sein).
+            from provtool.gui import modal
+            sperre = self.root.grab_current() or modal.oberstes()
+            popup = self._offenes_popup()
+            if sperre is not None and sperre.winfo_toplevel() is not self.root:
+                fenster = sperre.winfo_toplevel()
+            elif popup is not None:  # Sperre (noch) nicht gesetzt – trotzdem gilt Alt+F4 dem Popup
+                fenster = popup
+            else:
+                fenster = widget.winfo_toplevel() if isinstance(widget, tk.Misc) else self.root
+        except tk.TclError:
+            fenster = self.root
+        if fenster is self.root:
+            from provtool.gui import modal
+            offen = modal.oberstes()
+            if offen is not None:  # Alt+F4 bei offenem Dialog schließt den Dialog
+                offen.abbrechen()
+                return "break"
+            self._schliessen()
+        elif hasattr(fenster, "abbrechen"):
+            fenster.abbrechen()
+        else:
+            fenster.destroy()
+        return "break"
+
+    def _offenes_popup(self):
+        """Innerstes sichtbares Popup mit abbrechen() (Dialog, Rückfrage, Rundgang-Sprechblase)."""
+        gefunden = []
+
+        def suche(widget):
+            for kind in widget.winfo_children():
+                # Fensterstatus statt winfo_ismapped(): direkt nach dem Einblenden ist der Status schon
+                # „normal“, gezeichnet ist das Fenster aber evtl. noch nicht (langsamer PC, Wine).
+                if isinstance(kind, tk.Toplevel) and hasattr(kind, "abbrechen"):
+                    try:
+                        offen = kind.winfo_exists() and kind.wm_state() != "withdrawn"
+                    except tk.TclError:
+                        offen = False
+                    if offen:
+                        gefunden.append(kind)
+                suche(kind)
+        suche(self.root)
+        return gefunden[-1] if gefunden else None
+
+    # ---- öffentliche Helfer
+    def set_titel(self, text: str):
+        self.root.title(text)
+        if self.titelleiste:
+            self.titelleiste.set_titel(text)
+
+    def griff(self, master) -> tk.Label | None:
+        """Anfasser für die Statusleiste (nur im klassischen Modus)."""
+        if not self.klassisch:
+            return None
+        self._griff_bild = griff_bild(master)
+        g = tk.Label(master, image=self._griff_bild, bg=w.FACE, cursor="sizing" if not IS_WIN else "size_nw_se")
+        g.bind("<ButtonPress-1>", self._griff_start)
+        g.bind("<B1-Motion>", self._resize)
+        return g
+
+    def _griff_start(self, e):
+        if self.nativ_an and not self.maximiert:
+            self.nativ.groesse_ziehen("se")  # Windows zieht die Größe (flüssig)
+            return "break"
+        self._resize_start(e, "se")
+
+    def geometrie_setzen(self, geo: str | None, maximiert: bool = False):
+        self.root.update_idletasks()
+        if not geo or "+" not in geo:
+            breite, hoehe = 1200, 720
+            if geo and "x" in geo:
+                try:
+                    breite, hoehe = (int(v) for v in geo.split("+")[0].split("x"))
+                except ValueError:
+                    pass
+            x0, y0, bw, bh = arbeitsbereich(self.root)
+            breite, hoehe = min(breite, bw), min(hoehe, bh)
+            geo = f"{breite}x{hoehe}+{x0 + (bw - breite) // 2}+{y0 + (bh - hoehe) // 2}"
+        self.root.geometry(geo)
+        self._normal_geo = geo
+        self._nativ_einrichten()
+        if maximiert and self.klassisch:
+            self.root.after(100, self.maximieren)
+
+    def normale_geometrie(self) -> str:
+        return self._normal_geo if self.maximiert and self._normal_geo else self.root.geometry()
+
+    # ---- Fensterfunktionen
+    def minimieren(self):
+        if IS_WIN:
+            # Direkt über Windows: offene Dialoge (gehören dem Hauptfenster) werden mit aus- und
+            # wieder eingeblendet. NICHT overrideredirect umschalten – Tk baut dabei das Fenster neu
+            # und Windows würde die zugehörigen Dialoge zerstören.
+            from provtool.gui import win32
+            if win32.minimieren(self.root):
+                return
+        # Tk minimiert keine overrideredirect-Fenster -> kurz normalen Rahmen aktivieren
+        geo = self.root.geometry()
+        self.root.overrideredirect(False)
+        self.root.iconify()
+
+        def wieder_da(e):
+            if e.widget is self.root and self.root.state() == "normal":
+                self.root.unbind("<Map>")
+                self.root.overrideredirect(True)
+                self.root.geometry(geo)
+                taskleiste_anzeigen(self.root)
+        self.root.bind("<Map>", wieder_da)
+
+    def maximieren(self):
+        if self.maximiert:
+            return
+        if self.nativ_an:
+            from provtool.gui.nativ import SC_MAXIMIZE
+            self._normal_geo = self.root.geometry()
+            self.nativ.befehl(SC_MAXIMIZE)
+            self.maximiert = self.nativ.maximiert()
+            self.titelleiste.max_symbol(self.maximiert)
+            return
+        self._normal_geo = self.root.geometry()
+        x, y, bw, bh = arbeitsbereich(self.root)
+        self.root.geometry(f"{bw}x{bh}+{x}+{y}")
+        self.maximiert = True
+        self.titelleiste.max_symbol(True)
+
+    def wiederherstellen(self):
+        if not self.maximiert:
+            return
+        if self.nativ_an:
+            from provtool.gui.nativ import SC_RESTORE
+            self.nativ.befehl(SC_RESTORE)
+            self.maximiert = self.nativ.maximiert()
+            self.titelleiste.max_symbol(self.maximiert)
+            return
+        self.maximiert = False
+        if self._normal_geo:
+            self.root.geometry(self._normal_geo)
+        self.titelleiste.max_symbol(False)
+
+    def umschalten(self):
+        self.wiederherstellen() if self.maximiert else self.maximieren()
+
+    # ---- Größe ändern
+    def _welcher_rand(self, x, y) -> str:
+        bw, bh, r, k = self.aussen.winfo_width(), self.aussen.winfo_height(), self.RAND, self.ECKE
+        ns = "n" if y < r else "s" if y >= bh - r else ""
+        we = "w" if x < r else "e" if x >= bw - r else ""
+        # an einer Kante nahe am Eck -> Ecke (diagonal), wie bei Windows
+        if ns and not we:
+            we = "w" if x < k else "e" if x >= bw - k else ""
+        elif we and not ns:
+            ns = "n" if y < k else "s" if y >= bh - k else ""
+        return ns + we
+
+    def _cursor_zurueck(self, _e=None):
+        if self._rand_zeiger:
+            self._rand_zeiger = False
+            try:
+                self.aussen.configure(cursor="")
+            except tk.TclError:
+                pass
+
+    _rand_zeiger = False
+
+    CURSOR_WIN = {"n": "size_ns", "s": "size_ns", "e": "size_we", "w": "size_we",
+                  "nw": "size_nw_se", "se": "size_nw_se", "ne": "size_ne_sw", "sw": "size_ne_sw"}
+    CURSOR_X11 = {"n": "top_side", "s": "bottom_side", "e": "right_side", "w": "left_side",
+                  "nw": "top_left_corner", "se": "bottom_right_corner", "ne": "top_right_corner",
+                  "sw": "bottom_left_corner"}
+
+    def _rand_cursor(self, e):
+        if self.maximiert or self.nativ_an:  # nativ: Windows zeigt den Zeiger selbst
+            return
+        rand = self._welcher_rand(e.x, e.y)
+        zeiger = (self.CURSOR_WIN if IS_WIN else self.CURSOR_X11).get(rand, "")
+        try:
+            self.aussen.configure(cursor=zeiger)
+            self._rand_zeiger = bool(zeiger)
+        except tk.TclError:
+            pass
+
+    def _resize_start(self, e, rand: str | None = None):
+        self._rand = rand or self._welcher_rand(e.x, e.y)
+        if self._rand and self.nativ_an and not self.maximiert:
+            # sollte nicht vorkommen (der Rand ist für Windows durchlässig) – dann eben so
+            self.nativ.groesse_ziehen(self._rand)
+            self._rand = ""
+            return "break"
+        self._start = (e.x_root, e.y_root, self.root.winfo_x(), self.root.winfo_y(),
+                       self.root.winfo_width(), self.root.winfo_height())
+
+    def _resize(self, e):
+        if not self._rand or self.maximiert:
+            return
+        sx, sy, x, y, bw, bh = self._start
+        dx, dy = e.x_root - sx, e.y_root - sy
+        if "e" in self._rand:
+            bw = max(self.minbreite, bw + dx)
+        if "s" in self._rand:
+            bh = max(self.minhoehe, bh + dy)
+        if "w" in self._rand:
+            neu = max(self.minbreite, bw - dx)
+            x, bw = x + (bw - neu), neu
+        if "n" in self._rand:
+            neu = max(self.minhoehe, bh - dy)
+            y, bh = y + (bh - neu), neu
+        # Mausbewegungen bündeln: nur die jeweils letzte Größe anwenden (flüssiger unter Windows)
+        self._resize_ziel = f"{bw}x{bh}+{x}+{y}"
+        if self._resize_geplant is None:
+            self._resize_geplant = self.root.after(15, self._resize_anwenden)
+
+    def _resize_anwenden(self):
+        self._resize_geplant = None
+        try:
+            self.root.geometry(self._resize_ziel)
+        except tk.TclError:
+            pass

provtool/gui/win32.py

@@ -0,0 +1,203 @@
+"""Win32-Hilfen für modale Fenster (nur unter Windows wirksam, sonst ohne Funktion).
+
+Wichtig: Rahmenlose Fenster NICHT zusätzlich mit Tk `transient()` versehen – Tk legt sie dann als
+Kindfenster des Desktops (WS_CHILD) an, und denen kann Windows keinen Besitzer geben.
+
+Rahmenlose Tk-Fenster (overrideredirect) gehören für Windows zu keinem anderen Fenster. Holt man das
+Programm per Taskleiste oder Alt+Tab zurück, kommt dann nur das Hauptfenster nach vorn – ein offener
+Dialog bliebe dahinter verborgen. Deshalb machen wir es wie Windows bei echten modalen Dialogen:
+der Dialog bekommt das aufrufende Fenster als *Besitzer*, und der Besitzer wird solange *deaktiviert*.
+Windows bringt dann bei Klick aufs Hauptfenster, Taskleiste und Alt+Tab automatisch den Dialog nach vorn.
+"""
+from __future__ import annotations
+
+import sys
+import tkinter as tk
+
+IS_WIN = sys.platform.startswith("win")
+GWLP_HWNDPARENT = -8
+GW_OWNER = 4
+
+_u32 = None
+
+
+def user32():
+    """user32 mit korrekten 64-Bit-Signaturen (Fensterhandles dürfen nicht abgeschnitten werden)."""
+    global _u32
+    if _u32 is None:
+        import ctypes
+        from ctypes import wintypes
+        u = ctypes.WinDLL("user32", use_last_error=True)
+        u.GetParent.argtypes = [wintypes.HWND]
+        u.GetParent.restype = wintypes.HWND
+        u.SetWindowLongPtrW.argtypes = [wintypes.HWND, ctypes.c_int, ctypes.c_void_p]
+        u.SetWindowLongPtrW.restype = ctypes.c_void_p
+        u.EnableWindow.argtypes = [wintypes.HWND, wintypes.BOOL]
+        u.EnableWindow.restype = wintypes.BOOL
+        u.IsWindowEnabled.argtypes = [wintypes.HWND]
+        u.IsWindowEnabled.restype = wintypes.BOOL
+        u.GetWindow.argtypes = [wintypes.HWND, wintypes.UINT]
+        u.GetWindow.restype = wintypes.HWND
+        u.GetLastActivePopup.argtypes = [wintypes.HWND]
+        u.GetLastActivePopup.restype = wintypes.HWND
+        u.SetForegroundWindow.argtypes = [wintypes.HWND]
+        u.SetForegroundWindow.restype = wintypes.BOOL
+        u.IsWindow.argtypes = [wintypes.HWND]
+        u.IsWindow.restype = wintypes.BOOL
+        u.GetAncestor.argtypes = [wintypes.HWND, wintypes.UINT]
+        u.GetAncestor.restype = wintypes.HWND
+        u.GetTopWindow.argtypes = [wintypes.HWND]
+        u.GetTopWindow.restype = wintypes.HWND
+        u.BringWindowToTop.argtypes = [wintypes.HWND]
+        u.BringWindowToTop.restype = wintypes.BOOL
+        u.GetWindowLongW.argtypes = [wintypes.HWND, ctypes.c_int]
+        u.GetWindowLongW.restype = ctypes.c_long
+        u.SetWindowLongW.argtypes = [wintypes.HWND, ctypes.c_int, ctypes.c_long]
+        u.SetWindowLongW.restype = ctypes.c_long
+        u.ReleaseCapture.argtypes = []
+        u.ReleaseCapture.restype = wintypes.BOOL
+        u.SendMessageW.argtypes = [wintypes.HWND, wintypes.UINT, wintypes.WPARAM, wintypes.LPARAM]
+        u.SendMessageW.restype = wintypes.LPARAM
+        u.ShowWindow.argtypes = [wintypes.HWND, ctypes.c_int]
+        u.ShowWindow.restype = wintypes.BOOL
+        u.IsIconic.argtypes = [wintypes.HWND]
+        u.IsIconic.restype = wintypes.BOOL
+        u.FlashWindow.argtypes = [wintypes.HWND, wintypes.BOOL]
+        u.FlashWindow.restype = wintypes.BOOL
+        _u32 = u
+    return _u32
+
+
+def hwnd(fenster: tk.Misc) -> int | None:
+    """Handle des äußeren (obersten) Windows-Fensters eines Tk-Toplevels."""
+    if not IS_WIN:
+        return None
+    try:
+        return user32().GetAncestor(fenster.winfo_toplevel().winfo_id(), 2)  # GA_ROOT
+    except (tk.TclError, OSError):
+        return None
+
+
+def stapel(*fenster: tk.Misc) -> list[int]:
+    """Reihenfolge der übergebenen Fenster im Windows-Fensterstapel, oberstes zuerst (Indizes)."""
+    ziele = [hwnd(f) for f in fenster]
+    out, w = [], user32().GetTopWindow(None)
+    while w:
+        if w in ziele:
+            out.append(ziele.index(w))
+        w = user32().GetWindow(w, 2)  # GW_HWNDNEXT
+    return out
+
+
+def nach_vorn(fenster: tk.Misc) -> None:
+    h = hwnd(fenster)
+    if h:
+        user32().SetForegroundWindow(h)
+        user32().BringWindowToTop(h)
+
+
+GWL_EXSTYLE, WS_EX_APPWINDOW, WS_EX_TOOLWINDOW = -20, 0x00040000, 0x00000080
+
+
+def hat_taskleisteneintrag(fenster: tk.Misc) -> bool:
+    h = hwnd(fenster)
+    if not h:
+        return False
+    stil = user32().GetWindowLongW(h, GWL_EXSTYLE)
+    return bool(stil & WS_EX_APPWINDOW) and not (stil & WS_EX_TOOLWINDOW)
+
+
+def taskleisteneintrag(fenster: tk.Misc) -> bool:
+    """Eigener Eintrag in Taskleiste/Alt+Tab (rahmenlose Tk-Fenster haben sonst keinen).
+    Wirkt erst nach erneutem Einblenden – gibt True zurück, wenn das nötig ist."""
+    h = hwnd(fenster)
+    if not h:
+        return False
+    stil = user32().GetWindowLongW(h, GWL_EXSTYLE)
+    neu = (stil & ~WS_EX_TOOLWINDOW) | WS_EX_APPWINDOW
+    if neu != stil:
+        user32().SetWindowLongW(h, GWL_EXSTYLE, neu)
+        return True
+    return False
+
+
+def nativ_verschieben(fenster: tk.Misc) -> bool:
+    """Windows übernimmt das Ziehen (flüssig, mit Andocken am Bildschirmrand). True bei Erfolg."""
+    h = hwnd(fenster)
+    if not h:
+        return False
+    user32().ReleaseCapture()
+    user32().SendMessageW(h, 0x00A1, 2, 0)  # WM_NCLBUTTONDOWN, HTCAPTION
+    return True
+
+
+def minimieren(fenster: tk.Misc) -> bool:
+    """Direkt über Windows minimieren – Tk verweigert das bei rahmenlosen Fenstern. Eigene Popups
+    (Dialoge) werden dabei von Windows mit ausgeblendet und beim Wiederherstellen mit eingeblendet."""
+    h = hwnd(fenster)
+    if not h:
+        return False
+    user32().ShowWindow(h, 6)  # SW_MINIMIZE
+    return True
+
+
+def ist_minimiert(fenster: tk.Misc) -> bool:
+    h = hwnd(fenster)
+    return bool(user32().IsIconic(h)) if h else False
+
+
+def blinken(fenster: tk.Misc) -> None:
+    h = hwnd(fenster)
+    if h:
+        user32().FlashWindow(h, True)
+
+
+def besitzer_setzen(fenster: tk.Misc, besitzer: tk.Misc) -> None:
+    h, b = hwnd(fenster), hwnd(besitzer)
+    if h and b:
+        user32().SetWindowLongPtrW(h, GWLP_HWNDPARENT, b)
+
+
+def besitzer_von(fenster: tk.Misc) -> int | None:
+    h = hwnd(fenster)
+    return user32().GetWindow(h, GW_OWNER) if h else None
+
+
+def bedienbar(fenster: tk.Misc, an: bool) -> None:
+    h = hwnd(fenster)
+    if h and user32().IsWindow(h):
+        user32().EnableWindow(h, bool(an))
+
+
+def ist_bedienbar(fenster: tk.Misc) -> bool:
+    h = hwnd(fenster)
+    return bool(user32().IsWindowEnabled(h)) if h else True
+
+
+def letztes_popup(fenster: tk.Misc) -> int | None:
+    h = hwnd(fenster)
+    return user32().GetLastActivePopup(h) if h else None
+
+
+class Modal:
+    """Macht `fenster` modal zu `besitzer` (Windows-Art). beenden() muss VOR dem Zerstören des
+    Fensters laufen: erst Besitzer wieder freigeben, dann schließen – sonst aktiviert Windows
+    beim Schließen ein fremdes Programm statt unseres Hauptfensters."""
+
+    def __init__(self, fenster: tk.Misc, besitzer: tk.Misc, sperren: bool = True):
+        self.besitzer = besitzer
+        self.gesperrt = False
+        if not IS_WIN:
+            return
+        besitzer_setzen(fenster, besitzer)
+        if sperren and ist_bedienbar(besitzer):
+            bedienbar(besitzer, False)
+            self.gesperrt = True
+
+    def beenden(self) -> None:
+        if self.gesperrt:
+            self.gesperrt = False
+            try:
+                bedienbar(self.besitzer, True)
+            except tk.TclError:
+                pass

provtool/gui/win95.py

@@ -218,6 +218,23 @@ ICONS = {
     ...kkwwwwwwkk...
     .....kkkkkkk....
     ................""",
+    "birne": """
+    .....kkkkk......
+    ....kyyyyyk.....
+    ...kyywwyyyk....
+    ..kyywwyyyyyk...
+    ..kywwyyyyyyk...
+    ..kyyyyyyyyyk...
+    ..kyyyyyyyyyk...
+    ...kyyyyyyyk....
+    ....kyyyyyk.....
+    .....kyyyk......
+    .....kdddk......
+    .....kgggk......
+    .....kdddk......
+    .....kgggk......
+    ......kkk.......
+    ................""",
     "app": """
     ................
     .....kkkkkkk....
@@ -277,6 +294,9 @@ def apply(root: tk.Tk) -> None:
     o("*Background", FACE)
     o("*Foreground", DARK)
     o("*activeBackground", FACE)
+    # Tk-Eigenheit: „activeForeground“ gehört zur Optionsklasse „Background“ – ohne diese Zeile
+    # wäre die Schrift gedrückter Knöpfe grau auf grau (unsichtbar).
+    o("*activeForeground", DARK)
     o("*highlightThickness", 0)
     o("*selectBackground", NAVY)
     o("*selectForeground", WHITE)
@@ -305,6 +325,7 @@ def apply(root: tk.Tk) -> None:
 
     from tkinter import font as tkfont
     zeile = max(18, tkfont.Font(root=root, font=FONT).metrics("linespace") + 5)
+    wort_loeschen_einrichten(root)
     st = ttk.Style(root)
     st.theme_use("classic" if "classic" in st.theme_names() else "default")
     st.configure(".", background=FACE, foreground=DARK, font=FONT, troughcolor=LIGHT,
@@ -324,6 +345,78 @@ def apply(root: tk.Tk) -> None:
     st.configure("Sash", sashthickness=6, background=FACE)
 
 
+# --------------------------------------------------------------------------- Wort löschen
+
+def _wortgrenze(text: str, pos: int, richtung: int) -> int:
+    """Position der nächsten Wortgrenze von pos aus (richtung -1 = links, +1 = rechts),
+    wie Strg+Rücktaste / Strg+Entf unter Windows: erst Leerzeichen, dann das Wort."""
+    if richtung < 0:
+        i = pos
+        while i > 0 and text[i - 1].isspace():
+            i -= 1
+        if i > 0 and text[i - 1].isalnum():
+            while i > 0 and text[i - 1].isalnum():
+                i -= 1
+        elif i > 0:
+            i -= 1  # Satzzeichen einzeln
+        return i
+    i = pos
+    if i < len(text) and text[i].isalnum():
+        while i < len(text) and text[i].isalnum():
+            i += 1
+    elif i < len(text):
+        i += 1
+    while i < len(text) and text[i].isspace():
+        i += 1
+    return i
+
+
+def _wort_weg(event, richtung: int):
+    e = event.widget
+    try:
+        if str(e.cget("state")) in ("disabled", "readonly"):
+            return "break"
+    except tk.TclError:
+        pass
+    try:
+        if e.selection_present():
+            e.delete("sel.first", "sel.last")
+            return "break"
+    except (tk.TclError, AttributeError):
+        pass
+    text, pos = e.get(), e.index("insert")
+    grenze = _wortgrenze(text, pos, richtung)
+    if richtung < 0 and grenze < pos:
+        e.delete(grenze, pos)
+    elif richtung > 0 and grenze > pos:
+        e.delete(pos, grenze)
+    return "break"
+
+
+def _text_wort_weg(event, richtung: int):
+    t = event.widget
+    if str(t.cget("state")) == "disabled":
+        return "break"
+    if t.tag_ranges("sel"):
+        t.delete("sel.first", "sel.last")
+        return "break"
+    if richtung < 0:
+        t.delete("insert -1c wordstart" if t.get("insert -1c").isspace() else "insert wordstart", "insert")
+    else:
+        t.delete("insert", "insert wordend")
+    return "break"
+
+
+def wort_loeschen_einrichten(root: tk.Misc):
+    """Strg+Rücktaste / Strg+Entf löschen das ganze Wort – in allen Eingabefeldern (Tk kann das
+    unter Windows von Haus aus nicht, dort wird nur ein Zeichen gelöscht)."""
+    for klasse in ("Entry", "TEntry", "TCombobox", "Spinbox", "TSpinbox"):
+        root.bind_class(klasse, "<Control-BackSpace>", lambda e: _wort_weg(e, -1))
+        root.bind_class(klasse, "<Control-Delete>", lambda e: _wort_weg(e, 1))
+    root.bind_class("Text", "<Control-BackSpace>", lambda e: _text_wort_weg(e, -1))
+    root.bind_class("Text", "<Control-Delete>", lambda e: _text_wort_weg(e, 1))
+
+
 # --------------------------------------------------------------------------- Bausteine
 
 class Sunken(tk.Frame):
@@ -417,8 +510,12 @@ class Tooltip:
         y = self.widget.winfo_rooty() + self.widget.winfo_height() + 4
         self.tip = tw = tk.Toplevel(self.widget)
         tw.wm_overrideredirect(True)
-        tw.wm_geometry(f"+{x}+{y}")
+        tw.withdraw()
         tk.Label(tw, text=self.text, bg=INFO_BG, bd=1, relief="solid", padx=4, pady=1).pack()
+        tw.update_idletasks()
+        # Größe + Position zusammen (reine Position ignoriert Tk unter Windows bei rahmenlosen Fenstern)
+        tw.wm_geometry(f"{tw.winfo_reqwidth()}x{tw.winfo_reqheight()}+{x}+{y}")
+        tw.deiconify()
 
     def _weg(self, _e=None):
         if self._after:
@@ -480,40 +577,99 @@ def auto_breite(tree: ttk.Treeview, flex: dict[str, float], reserve: int = 4):
 
 # --------------------------------------------------------------------------- Dialoge
 
+# Klassischer Win95-Rahmen auch für Dialoge (wird von der App gesetzt, abschaltbar in den Einstellungen)
+KLASSISCH = False
+
+
 class Dialog(tk.Toplevel):
-    """Modaler Dialog im Win95-Stil."""
+    """Modaler Dialog im Win95-Stil.
+
+    Modal heißt hier: Der INHALT des aufrufenden Fensters ist gesperrt (siehe modal.py), dessen
+    Titelleiste und Rand bleiben bedienbar. Unter Windows gehört der Dialog dem aufrufenden Fenster
+    (bleibt darüber, kommt mit Alt+Tab nach vorn) und hat einen eigenen Taskleisten-Eintrag.
+    """
 
     def __init__(self, master, titel: str, resizable: bool = False):
         super().__init__(master, bg=FACE)
         self.withdraw()
         self.title(titel)
+        if not KLASSISCH:
+            # Rahmenlose Dialoge bekommen ihren Besitzer über win32 – mit transient() würde Tk sie
+            # unter Windows als Kindfenster anlegen, die dann hinter anderen Programmen hängen.
             self.transient(master.winfo_toplevel())
         self.resizable(resizable, resizable)
         self.result = None
+        self._sperre = None
         self.protocol("WM_DELETE_WINDOW", self.abbrechen)
         self.bind("<Escape>", lambda e: self.abbrechen())
         try:
             self.iconphoto(False, master.winfo_toplevel()._app_icon)  # type: ignore[attr-defined]
         except Exception:
             pass
+        self.titelleiste = None
+        if KLASSISCH:
+            from provtool.gui.rahmen import Titelleiste
+            self.overrideredirect(True)
+            self.configure(bd=2, relief="raised", padx=2, pady=2)
+            self.titelleiste = Titelleiste(self, self, titel, None, ("close",), schliessen=self.abbrechen)
+            self.titelleiste.pack(side="top", fill="x")
 
     def zeigen(self, fokus=None):
+        from provtool.gui import modal, win32
+        if getattr(self._root(), "_provtool_schliesst", False):
+            self.destroy()  # Programm wird beendet – keine neuen Dialoge mehr
+            return None
         self.update_idletasks()
         m = self.master.winfo_toplevel()
+        self._aufrufer = m
         w, h = self.winfo_reqwidth(), self.winfo_reqheight()
         x = m.winfo_rootx() + max(0, (m.winfo_width() - w) // 2)
         y = m.winfo_rooty() + max(0, (m.winfo_height() - h) // 3)
-        self.geometry(f"+{x}+{y}")
+        self.geometry(f"{w}x{h}+{max(0, x)}+{max(0, y)}")  # Größe + Position zusammen (siehe Tooltip)
         self.deiconify()
+        self.update_idletasks()
+        if KLASSISCH and win32.IS_WIN:
+            # eigener Taskleisten-Eintrag; wird erst nach kurzem Aus-/Einblenden wirksam
+            if win32.taskleisteneintrag(self):
+                self.withdraw()
+                self.deiconify()
+                self.update_idletasks()
+            win32.besitzer_setzen(self, m)
+        self._sperre = modal.Sperre(m, self)
         self.lift()
-        try:
+        self.focus_force()
-            self.grab_set()
-        except tk.TclError:
-            pass
         (fokus or self).focus_set()
         self.wait_window()
         return self.result
 
+    def nach_vorn(self, blinken: bool = False):
+        """Dialog nach vorn holen (z. B. nach Klick auf das gesperrte Hauptfenster)."""
+        from provtool.gui import win32
+        try:
+            self.lift()
+            self.focus_force()
+            win32.nach_vorn(self)
+        except tk.TclError:
+            return
+        if blinken:
+            self.bell()
+            win32.blinken(self)
+            if self.titelleiste is not None:
+                self.titelleiste.blinken()
+
+    def destroy(self):
+        sperre = getattr(self, "_sperre", None)
+        if sperre is not None:
+            sperre.aufheben()
+            self._sperre = None
+        aufrufer = getattr(self, "_aufrufer", None)
+        super().destroy()
+        try:  # Fokus zurück an das aufrufende Fenster
+            if aufrufer is not None and aufrufer.winfo_exists():
+                aufrufer.focus_force()
+        except tk.TclError:
+            pass
+
     def abbrechen(self):
         self.result = None
         self.destroy()

provtool/regeln.py

@@ -0,0 +1,115 @@
+"""Besondere Provisionsarten: Airtime und Jahresbonus Neuaktivierung (Staffel).
+
+Typ einer Position
+------------------
+- ``normal``       – Auszahlung = Prozent der Provision (Händler-Standard bzw. Regel je Provisionsart)
+- ``airtime``      – Auszahlung = Airtime-Prozent des Händlers (0 % = keine Airtime). Im Export als eine
+                     Summenzeile in der Abrechnung, die Einzelposten in einer eigenen Airtime-Liste.
+- ``jahresbonus``  – Jahresbonus Neuaktivierung: Betrag je Karte nach Staffel, abhängig davon, wie viele
+                     Karten der Händler in der Abrechnung hat (z. B. 1–9 Karten: 5 € je Karte ... ab 40: voll).
+
+Der Typ wird aus Provisionsart/Dienst/Tarif erkannt und kann je Provisionsart fest eingestellt werden.
+"""
+from __future__ import annotations
+
+import json
+
+NORMAL, AIRTIME, JAHRESBONUS = "normal", "airtime", "jahresbonus"
+TYPEN = {NORMAL: "Normale Provision", AIRTIME: "Airtime", JAHRESBONUS: "Jahresbonus Neuaktivierung (Staffel)"}
+
+# Staffel: [(ab Anzahl Karten, Cent je Karte oder None = voller Betrag laut Abrechnung), ...]
+Staffel = list[tuple[int, "int | None"]]
+STANDARD_STAFFEL: Staffel = [(1, 500), (10, 1000), (15, 1500), (20, 2000), (25, 2500), (30, 3000), (35, 3500),
+                             (40, None)]
+
+_AIRTIME_WOERTER = ("airtime", "air time", "air-time", "umsatzbeteiligung")
+
+
+def _text(*teile) -> str:
+    return " ".join(str(t or "") for t in teile).lower()
+
+
+def erkennen(provisionsart: str | None, dienst: str | None = None, tarif: str | None = None) -> str:
+    """Typ aus den Texten der Position erkennen (ohne feste Einstellung)."""
+    art = _text(provisionsart)
+    if "jahresbonus" in art or ("bonus" in art and "neuaktiv" in art):
+        return JAHRESBONUS
+    if any(wort in _text(provisionsart, dienst, tarif) for wort in _AIRTIME_WOERTER):
+        return AIRTIME
+    return NORMAL
+
+
+def typ_von(p: dict, fest: dict[str, str]) -> str:
+    """Typ einer Position: feste Einstellung der Provisionsart, sonst automatisch erkannt."""
+    art = p.get("provisionsart") or ""
+    if art in fest:
+        return fest[art]
+    return erkennen(art, p.get("dienst"), p.get("tarif"))
+
+
+# --------------------------------------------------------------------------- Staffel
+
+def staffel_pruefen(staffel) -> Staffel:
+    """Normalisiert und prüft eine Staffel (aufsteigend, ab >= 1, Beträge >= 0)."""
+    out: Staffel = []
+    for ab, cent in staffel:
+        ab = int(ab)
+        if ab < 1:
+            raise ValueError("Die Anzahl Karten muss mindestens 1 sein.")
+        if cent is not None:
+            cent = int(cent)
+            if cent < 0:
+                raise ValueError("Der Betrag je Karte darf nicht negativ sein.")
+        out.append((ab, cent))
+    out.sort(key=lambda s: s[0])
+    if len({ab for ab, _ in out}) != len(out):
+        raise ValueError("Jede Stufe braucht eine andere Anzahl Karten.")
+    if not out:
+        raise ValueError("Die Staffel braucht mindestens eine Stufe.")
+    return out
+
+
+def staffel_laden(text: str | None) -> Staffel | None:
+    if not text:
+        return None
+    try:
+        return staffel_pruefen(json.loads(text))
+    except (ValueError, TypeError):
+        return None
+
+
+def staffel_text(staffel: Staffel) -> str:
+    return json.dumps([[ab, cent] for ab, cent in staffel])
+
+
+def stufe(staffel: Staffel, karten: int) -> tuple[bool, int | None]:
+    """(gefunden, Cent je Karte oder None = voll) für die Anzahl Karten."""
+    treffer = None
+    for ab, cent in staffel:
+        if karten >= ab:
+            treffer = (True, cent)
+    return treffer or (False, 0)
+
+
+def bonus_betrag(staffel: Staffel, karten: int, betrag_orig: int) -> int:
+    """Auszahlung einer Jahresbonus-Position. Nie mehr als die Provision laut Abrechnung; Stornos
+    (negative Beträge) werden mit derselben Stufe abgezogen."""
+    gefunden, cent = stufe(staffel, karten)
+    if not gefunden:
+        return 0
+    if cent is None:
+        return betrag_orig
+    if betrag_orig >= 0:
+        return min(cent, betrag_orig)
+    return -min(cent, -betrag_orig)
+
+
+def staffel_beschreibung(staffel: Staffel, kurz: bool = False) -> str:
+    from provtool.money import fmt
+    teile = []
+    for i, (ab, cent) in enumerate(staffel):
+        bis = staffel[i + 1][0] - 1 if i + 1 < len(staffel) else None
+        bereich = f"ab {ab}" if bis is None else (f"{ab}" if bis == ab else f"{ab}-{bis}")
+        wert = "voll" if cent is None else fmt(cent)
+        teile.append(f"{bereich}: {wert}")
+    return (", " if kurz else "\n").join(teile)

provtool/selbsttest.py

@@ -0,0 +1,192 @@
+"""Selbsttest der fertigen Programmdatei: `Provisionsmanager95.exe --selbsttest ergebnis.txt`
+
+Läuft im Build (Wine + virtueller Bildschirm) gegen die tatsächlich ausgelieferte .exe. Startet die
+echte Oberfläche in einem Wegwerf-Profil, spielt kritische Abläufe durch und schreibt „OK“ bzw. die
+gefundenen Fehler in die Ergebnisdatei (Exit-Code 0 = bestanden).
+
+Geprüft wird u. a. der Fall „Programm schließen, während der Einrichtungs-Assistent offen ist“
+sowie Import und Export (openpyxl/xlrd müssen in der .exe enthalten sein).
+"""
+from __future__ import annotations
+
+import os
+import sys
+import tempfile
+import time
+import tkinter as tk
+import traceback
+from pathlib import Path
+
+ZEITLIMIT = 60  # Sekunden je Szenario
+
+
+class _Szenario:
+    def __init__(self, name: str, home: Path, einstellungen: str | None = None):
+        self.name, self.home, self.fehler = name, home, []
+        home.mkdir(parents=True, exist_ok=True)
+        os.environ["PROVTOOL_HOME"] = str(home)
+        if einstellungen:
+            (home / "einstellungen.json").write_text(einstellungen, encoding="utf-8")
+        from provtool.gui.app import App
+        self.root = tk.Tk()
+        self.app = App(self.root)
+        echt = self.root.report_callback_exception
+
+        def melden(exc, val, tb):
+            self.fehler.append("".join(traceback.format_exception(exc, val, tb)))
+            try:
+                echt(exc, val, tb)
+            except Exception:
+                self.fehler.append("Fehler-Handler ist abgestürzt:\n" + traceback.format_exc())
+        self.root.report_callback_exception = melden
+
+    def lebt(self) -> bool:
+        try:
+            return bool(self.root.winfo_exists())
+        except tk.TclError:
+            return False
+
+    def dialog(self, typ):
+        from provtool.gui import win95 as w
+        gefunden = []
+
+        def suche(widget):
+            for kind in widget.winfo_children():
+                if isinstance(kind, w.Dialog) and isinstance(kind, typ) and kind.winfo_exists():
+                    gefunden.append(kind)
+                suche(kind)
+        if self.lebt():
+            suche(self.root)
+        return gefunden[0] if gefunden else None
+
+    def ablauf(self, schritte):
+        offen, start = list(schritte), time.time()
+
+        def poll():
+            if not self.lebt():
+                return
+            if time.time() - start > ZEITLIMIT:
+                self.fehler.append(f"Zeitüberschreitung bei: {offen[0][2] if offen else 'Ende'}")
+                try:
+                    self.root.destroy()
+                except tk.TclError:
+                    pass
+                return
+            if offen:
+                try:
+                    bereit = offen[0][0]()
+                except Exception:
+                    bereit = False
+                if bereit:
+                    _, aktion, _ = offen.pop(0)
+
+                    def ausfuehren(a=aktion):
+                        try:
+                            a()
+                        except Exception:
+                            self.fehler.append(traceback.format_exc())
+                    self.root.after(0, ausfuehren)
+            self.root.after(20, poll)
+
+        self.root.after(20, poll)
+        self.root.mainloop()
+        if offen:
+            self.fehler.append("Nicht ausgeführt: " + ", ".join(s[2] for s in offen))
+        log = self.home / "fehler.log"
+        if log.exists() and log.read_text(encoding="utf-8").strip():
+            self.fehler.append("fehler.log:\n" + log.read_text(encoding="utf-8"))
+        return [f"[{self.name}] {f}" for f in self.fehler]
+
+
+def _beispiel_csv(pfad: Path):
+    kopf = ("Zeitraum;Verguetungsart;Haendlernummer;Unterhaendler;Vertragsnummer;Aktiv;Deaktiv;Rufnummer;"
+            "Kartennummer;IMEI_SN;Geraetename;Kundenvorname;Kundename;Tarif-Kurz;Tarif;Prozent;Betrag")
+    zeilen = [kopf,
+              "2026.10.01-2026.10.07;SIM-Karten;1;111;1;05.10.2026;;1601111111;;;;;Muster GmbH;;Allnet;0;8",
+              "2026.10.01-2026.10.07;Sonderbonus Aktion;1;111;2;06.10.2026;;1602222222;;;;;Beispiel KG;;Classic;0;170"]
+    pfad.write_bytes(("\r\n".join(zeilen) + "\r\n").encode("cp1252"))
+
+
+def ausfuehren(ergebnisdatei: str) -> int:
+    from provtool.gui.assistent import Einrichtungsassistent
+    basis = Path(tempfile.mkdtemp(prefix="pm95-selbsttest-"))
+    fehler: list[str] = []
+    immer = lambda: True  # noqa: E731
+    try:
+        # 1) Gemeldeter Absturz: Schließen, während der Einrichtungs-Assistent offen ist
+        s = _Szenario("Schließen bei offenem Assistenten", basis / "a")
+        cmd = s.root.tk.call("wm", "protocol", s.root._w, "WM_DELETE_WINDOW")
+        fehler += s.ablauf([(lambda: s.dialog(Einrichtungsassistent) is not None, lambda: None, "Assistent erscheint"),
+                            (immer, lambda: s.root.tk.call(cmd), "Fenster schließen")])
+
+        # 2) Assistent komplett, Import, Export, Rundgang, Beenden
+        csv = basis / "freenet.csv"
+        _beispiel_csv(csv)
+        s = _Szenario("Assistent, Import, Export", basis / "b")
+        wiz = lambda: s.dialog(Einrichtungsassistent)  # noqa: E731
+        seite = lambda n: (lambda: wiz() is not None and wiz().nr == n)  # noqa: E731
+
+        def haendler():
+            wiz().v_name.set("Selbsttest-Händler")
+            wiz().v_fn.set("111")
+            wiz()._haendler_dazu()
+
+        def abrechnung():
+            wiz().dateien.append(str(csv))
+            wiz().v_rundgang.set(False)
+            wiz()._weiter()
+
+        def import_bericht_zu():
+            from provtool.gui.dialogs import ImportBericht
+            s.dialog(ImportBericht).abbrechen()
+
+        def export():
+            from provtool import export as exp
+            app = s.app
+            pos = [p for p in app.positionen if p["haendler_id"] > 0]
+            dateien = exp.exportiere_haendler(basis / "export", "Selbsttest", pos, "Test")
+            if len(pos) != 2 or len(dateien) != 1 or not dateien[0].exists():
+                s.fehler.append(f"Export fehlerhaft: {len(pos)} Positionen, Dateien {dateien}")
+
+        from provtool.gui.assistent import TippDesTages
+        from provtool.gui.dialogs import ImportBericht
+
+        def fenster_pruefen():
+            """Windows: echtes Programmfenster (Andocken, Win+Pfeiltasten) mit unsichtbarem Rahmen."""
+            r = s.app.rahmen
+            if sys.platform.startswith("win") and r.klassisch:
+                if not r.nativ_an:
+                    s.fehler.append("Natives Fenster (Andocken/Win+Pfeiltasten) wurde nicht eingerichtet")
+                elif not r.nativ.innen_gleich_aussen():
+                    s.fehler.append("Windows-Rahmen des Hauptfensters ist sichtbar")
+
+        def tipp_pruefen():
+            d = s.dialog(TippDesTages)
+            if not d.bild_ok:
+                s.fehler.append("Bild für den Tipp des Tages fehlt in der .exe (provtool/gui/bilder/tipp.png)")
+            d.abbrechen()
+
+        fehler += s.ablauf([
+            (seite(0), lambda: wiz()._weiter(), "Willkommen"),
+            (seite(1), lambda: wiz()._weiter(), "Speicherort"),
+            (seite(2), haendler, "Händler anlegen"),
+            (lambda: len(s.app.db.haendler_liste()) == 1, lambda: wiz()._weiter(), "Händler -> weiter"),
+            (seite(3), abrechnung, "Abrechnung mit Datei"),
+            (seite(4), lambda: wiz()._weiter(), "Fertig stellen"),
+            (lambda: s.dialog(ImportBericht) is not None, import_bericht_zu, "Import-Bericht schließen"),
+            (lambda: len(s.app.positionen) == 2, export, "Export"),
+            (immer, fenster_pruefen, "Fensterrahmen"),
+            (immer, s.app.tipp_des_tages, "Tipp des Tages öffnen"),
+            (lambda: s.dialog(TippDesTages) is not None, tipp_pruefen, "Tipp-Bild in der .exe"),
+            (lambda: s.dialog(TippDesTages) is None, s.app.rundgang, "Rundgang"),
+            (lambda: getattr(s.app, "_rundgang", None) is not None, s.app.beenden, "Beenden während Rundgang"),
+        ])
+    except Exception:
+        fehler.append(traceback.format_exc())
+
+    Path(ergebnisdatei).write_text("OK\n" if not fehler else "FEHLER\n\n" + "\n\n".join(fehler), encoding="utf-8")
+    return 0 if not fehler else 1
+
+
+if __name__ == "__main__":
+    sys.exit(ausfuehren(sys.argv[1] if len(sys.argv) > 1 else "selbsttest.txt"))

pytest.ini

@@ -1,3 +1,8 @@
 [pytest]
 pythonpath = .
 testpaths = tests
+# Kein Test darf den Build blockieren: nach 90 s wird abgebrochen und der Aufrufstapel aller
+# Threads ausgegeben (zeigt, wo es hängt – auch in Windows-Systemaufrufen, wo der Tk-Watchdog
+# der GUI-Tests nicht greift).
+timeout = 90
+timeout_method = thread

requirements-dev.txt

@@ -1,3 +1,4 @@
 -r requirements.txt
 pytest==8.3.3
 pyinstaller==6.11.1
+pytest-timeout==2.3.1

tests/test_kern.py

@@ -159,9 +159,14 @@ def test_zuordnung_regeln_und_export(db, freenet_csv, vodafone_xlsx, tmp_path):
 
     # Export
     eigene = [p for p in db.positionen(aid) if p["haendler_id"] == hid]
-    dateien = export.exportiere_haendler(tmp_path / "out", "Händler A", eigene, "Oktober 2026")
+    dateien = export.exportiere_haendler(tmp_path / "out", "Händler A", eigene, "Oktober 2026", pro_anbieter=True)
     assert [d.name for d in dateien] == ["Händler A - freenet - Oktober 2026.xlsx",
                                          "Händler A - Vodafone - Oktober 2026.xlsx"]
+    # Standard: freenet UND Vodafone in einer Datei (gemeldet: Vodafone fehlte im Export)
+    eine = export.exportiere_haendler(tmp_path / "out1", "Händler A", eigene, "Oktober 2026")
+    assert [d.name for d in eine] == ["Händler A - Oktober 2026.xlsx"]
+    arten = [r[1] for r in openpyxl.load_workbook(eine[0]).active.iter_rows(values_only=True) if r[1]]
+    assert "Freischaltungsvergütung Vodafone" in arten and "SIM-Karten" in arten
     ws = openpyxl.load_workbook(dateien[0]).active
     zeilen = [[c.value for c in r] for r in ws.iter_rows(min_row=1, max_row=4)]
     # Sortierung Zeitraum → Provisionsart → Datum
@@ -265,3 +270,144 @@ def test_migration_alter_datenbank(tmp_path):
     spalten = {r[1] for r in d.con.execute("PRAGMA table_info(position)")}
     assert "haendler_fest" in spalten
     d.close()
+
+
+def test_eigene_kennungen_ausblenden(db, freenet_csv):
+    from provtool.db import EIGEN
+    hid = db.haendler_speichern(Haendler(0, "Händler A"), [("freenet", "111")])
+    aid = db.abrechnung_neu("X")
+    db.importieren(aid, lies_datei(freenet_csv))
+    assert {p["haendler_id"] for p in db.positionen(aid)} == {hid, UNZUGEORDNET}
+    db.eigene_setzen("freenet", "999")
+    ids = {p["kennung"]: p["haendler_id"] for p in db.positionen(aid)}
+    assert ids["999"] == EIGEN and ids["111"] == hid
+    # Händler-Kennung hat Vorrang vor „eigen“
+    db.eigene_setzen("freenet", "111")
+    assert {p["kennung"]: p["haendler_id"] for p in db.positionen(aid)}["111"] == hid
+    db.eigene_setzen("freenet", "999", False)
+    assert {p["kennung"]: p["haendler_id"] for p in db.positionen(aid)}["999"] == UNZUGEORDNET
+
+
+# --------------------------------------------------------------------------- Airtime / Jahresbonus
+
+def _pos(art, betrag, unterh="111", rufnr="1601111111", name="Kunde", dienst="Teilnehmerverhaeltnis"):
+    z = freenet_zeile(art, unterh, "05.10.2026", rufnr, name, "Tarif", betrag).split(";")
+    z[24] = dienst
+    return ";".join(z)
+
+
+@pytest.fixture
+def bonus_csv(tmp_path):
+    zeilen = [FREENET_KOPF,
+              _pos("Grundvergütung Mobilfunk Credit freenet", "50"),
+              _pos("Grundvergütung Mobilfunk Credit freenet", "0"),
+              _pos("Prepaidvergütung", "20", dienst="AirTime Provision"),
+              _pos("Airtime Umsatzbeteiligung", "10,50")]
+    zeilen += [_pos("Jahresbonus Neuaktivierung", "40", rufnr=f"16000000{i:02d}") for i in range(12)]
+    zeilen += [_pos("Jahresbonus Neuaktivierung", "3", rufnr="1600000099")]  # weniger als die Stufe
+    p = tmp_path / "bonus.csv"
+    p.write_bytes(("\r\n".join(zeilen) + "\r\n").encode("cp1252"))
+    return p
+
+
+def test_typ_erkennung():
+    from provtool import regeln
+    assert regeln.erkennen("Prepaidvergütung Vodafone", "AirTime Provision") == regeln.AIRTIME
+    assert regeln.erkennen("Airtime freenet") == regeln.AIRTIME
+    assert regeln.erkennen("Jahresbonus Neuaktivierung") == regeln.JAHRESBONUS
+    assert regeln.erkennen("SIM-Karten", "Teilnehmerverhaeltnis") == regeln.NORMAL
+
+
+def test_staffel_stufen():
+    from provtool import regeln
+    st = regeln.STANDARD_STAFFEL
+    assert regeln.bonus_betrag(st, 0, 4000) == 0
+    assert regeln.bonus_betrag(st, 1, 4000) == 500 and regeln.bonus_betrag(st, 9, 4000) == 500
+    assert regeln.bonus_betrag(st, 10, 4000) == 1000 and regeln.bonus_betrag(st, 14, 4000) == 1000
+    assert regeln.bonus_betrag(st, 39, 4000) == 3500
+    assert regeln.bonus_betrag(st, 40, 4000) == 4000 and regeln.bonus_betrag(st, 80, 6000) == 6000  # voll
+    assert regeln.bonus_betrag(st, 25, 1000) == 1000  # nie mehr als laut Abrechnung
+    assert regeln.bonus_betrag(st, 12, -4000) == -1000  # Storno mit derselben Stufe
+    with pytest.raises(ValueError):
+        regeln.staffel_pruefen([(1, 500), (1, 600)])
+    assert "1-9: 5,00 €" in regeln.staffel_beschreibung(st) and "ab 40: voll" in regeln.staffel_beschreibung(st)
+
+
+def test_airtime_und_jahresbonus(db, bonus_csv, tmp_path):
+    from provtool import regeln
+    hid = db.haendler_speichern(Haendler(0, "Sub", standard_prozent=100), [("freenet", "111")])
+    aid = db.abrechnung_neu("Okt")
+    db.importieren(aid, lies_datei(bonus_csv))
+    pos = db.positionen(aid)
+    air = [p for p in pos if p["typ"] == regeln.AIRTIME]
+    bonus = [p for p in pos if p["typ"] == regeln.JAHRESBONUS]
+    assert len(air) == 2 and len(bonus) == 13
+    assert all(p["betrag"] == 0 for p in air), "Standard: 0 % Airtime = keine Airtime"
+    # 13 Karten -> Stufe 10-14 = 10 € je Karte (die 3-€-Position bleibt bei 3 €)
+    assert sorted(p["betrag"] for p in bonus) == [300] + [1000] * 12
+    assert all(p["prozent"] is None for p in bonus)
+
+    # Airtime 50 %, eigene Staffel
+    h = db.haendler(hid)
+    h.airtime_prozent = 50
+    h.staffel = [(1, 200), (13, None)]
+    db.haendler_speichern(h, db.kennungen(hid))
+    db.neu_berechnen(aid)
+    pos = db.positionen(aid)
+    assert sorted(p["betrag"] for p in pos if p["typ"] == regeln.AIRTIME) == [525, 1000]
+    assert sorted(p["betrag"] for p in pos if p["typ"] == regeln.JAHRESBONUS) == [300] + [4000] * 12
+
+    # Zuweisung ändert die Anzahl Karten -> Staffel der übrigen wird neu berechnet
+    weg = [p["id"] for p in pos if p["typ"] == regeln.JAHRESBONUS][:2]
+    db.haendler_zuweisen(weg, UNZUGEORDNET)
+    rest = [p for p in db.positionen(aid) if p["typ"] == regeln.JAHRESBONUS and p["haendler_id"] == hid]
+    assert len(rest) == 11 and all(p["betrag"] == min(200, p["betrag_orig"]) for p in rest)
+
+    # Typ fest einstellen
+    db.art_typ_setzen("Airtime Umsatzbeteiligung", regeln.NORMAL)
+    assert any(a == "Airtime Umsatzbeteiligung" for a, _, _ in db.provisionsarten())
+    db.neu_berechnen(aid)
+    p = next(p for p in db.positionen(aid) if p["provisionsart"] == "Airtime Umsatzbeteiligung")
+    assert p["typ"] == regeln.NORMAL and p["betrag"] == 1050
+    db.art_typ_setzen("Airtime Umsatzbeteiligung", None)
+
+    # Export: Abrechnung mit Airtime-Summenzeile + eigene Airtime-Liste, 0-€-Positionen weg
+    db.neu_berechnen(aid)
+    eigene = [p for p in db.positionen(aid) if p["haendler_id"] == hid]
+    dateien = export.exportiere_haendler(tmp_path / "out", "Sub", eigene, "Okt")
+    assert [d.name for d in dateien] == ["Sub - Okt.xlsx", "Sub - Airtime - Okt.xlsx"]
+    zeilen = [r for r in openpyxl.load_workbook(dateien[0]).active.iter_rows(values_only=True)]
+    daten = [r for r in zeilen if r[1]]
+    assert all(r[10] != 0 for r in daten), "0-€-Positionen dürfen nicht im Export stehen"
+    assert daten[-1][1] == "Airtime" and daten[-1][10] == 15.25
+    assert not any(r[1] == "Prepaidvergütung" for r in daten), "Airtime-Einzelposten gehören in die eigene Liste"
+    air_zeilen = [r for r in openpyxl.load_workbook(dateien[1]).active.iter_rows(values_only=True) if r[1]]
+    assert sorted(r[10] for r in air_zeilen) == [5.25, 10.0]
+
+    # 0 % Airtime: keine Airtime-Zeile, keine Airtime-Datei
+    h = db.haendler(hid)
+    h.airtime_prozent = 0
+    db.haendler_speichern(h, db.kennungen(hid))
+    db.neu_berechnen(aid)
+    eigene = [p for p in db.positionen(aid) if p["haendler_id"] == hid]
+    dateien = export.exportiere_haendler(tmp_path / "out0", "Sub", eigene, "Okt")
+    assert [d.name for d in dateien] == ["Sub - Okt.xlsx"]
+    assert not any(r[1] == "Airtime" for r in openpyxl.load_workbook(dateien[0]).active.iter_rows(values_only=True))
+
+
+def test_migration_v2_haendler_ohne_airtime(tmp_path):
+    import sqlite3
+    pfad = tmp_path / "v2.db"
+    con = sqlite3.connect(pfad)
+    con.executescript("""CREATE TABLE haendler (id INTEGER PRIMARY KEY, name TEXT NOT NULL UNIQUE COLLATE NOCASE,
+        ansprechpartner TEXT DEFAULT '', email TEXT DEFAULT '', notiz TEXT DEFAULT '',
+        standard_prozent REAL NOT NULL DEFAULT 100, aktiv INTEGER NOT NULL DEFAULT 1);
+        INSERT INTO haendler (name, standard_prozent) VALUES ('Alt', 90);""")
+    con.close()
+    d = Datenbank(pfad)
+    h = d.haendler_liste()[0]
+    assert h.name == "Alt" and h.airtime_prozent == 0 and h.staffel is None
+    assert d.staffel_fuer(h.id) == d.standard_staffel()
+    d.standard_staffel_setzen([(1, 100), (5, None)])
+    assert d.staffel_fuer(h.id) == [(1, 100), (5, None)]
+    d.close()