Testdaten: erfundene statt echter Kundennummer

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

.gitea/workflows/windows-build.yml

@@ -1,7 +1,7 @@
-# Baut die Windows-Version (Provisionsmanager95.exe) mit Windows-Python unter Wine.
-#  - jeder Push / PR: Tests + .exe als Build-Artefakt
-#  - Tag "v*" (z. B. v1.0.0): zusätzlich Gitea-Release mit .exe und .zip
-name: Windows-Build
+# Baut die Windows-Version (.exe, mit Windows-Python unter Wine) und die Linux-Version.
+#  - jeder Push / PR: Tests + Programmdateien als Build-Artefakte
+#  - Tag "v*" (z. B. v1.0.0): zusätzlich Gitea-Release mit .exe, .zip und Linux-.tar.gz
+name: Build
 
 on:
   push:
@@ -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:
@@ -22,7 +23,7 @@ jobs:
       - name: Werkzeuge für Checkout/Upload installieren
         run: |
           apt-get update -qq
-          apt-get install -y -qq --no-install-recommends git nodejs ca-certificates >/dev/null
+          apt-get install -y -qq --no-install-recommends git nodejs ca-certificates xdotool >/dev/null
 
       - uses: actions/checkout@v4
 
@@ -37,23 +38,40 @@ jobs:
             dist/Provisionsmanager95.exe
             dist/Provisionsmanager95-*.zip
 
-      - name: Release erstellen
+      - name: Release erstellen / ergänzen
         if: startsWith(github.ref, 'refs/tags/v')
         env:
           TOKEN: ${{ secrets.RELEASE_TOKEN || secrets.GITEA_TOKEN }}
           API: ${{ github.server_url }}/api/v1/repos/${{ github.repository }}
           TAG: ${{ github.ref_name }}
+        run: build/release_hochladen.sh dist/Provisionsmanager95.exe dist/Provisionsmanager95-$(tr -d '\r\n' < dist/VERSION).zip
+
+  linux:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    container:
+      image: python:3.12-bookworm
+    steps:
+      - name: Werkzeuge installieren
         run: |
-          set -eu
-          VERSION=$(cat dist/VERSION | tr -d '\r\n')
-          if [ "v$VERSION" != "$TAG" ]; then
-            echo "Tag $TAG passt nicht zu provtool/__init__.py (Version $VERSION)"; exit 1
-          fi
-          resp=$(curl -sf -X POST "$API/releases" -H "Authorization: token $TOKEN" -H "Content-Type: application/json" \
-            -d "{\"tag_name\":\"$TAG\",\"name\":\"Provisions-Manager 95 $TAG\",\"body\":\"Windows-Version $VERSION – einfach die .exe herunterladen und starten.\"}")
-          id=$(echo "$resp" | grep -o '"id":[0-9]*' | head -1 | cut -d: -f2)
-          for f in dist/Provisionsmanager95.exe dist/Provisionsmanager95-$VERSION.zip; do
-            curl -sf -X POST "$API/releases/$id/assets?name=$(basename "$f")" \
-              -H "Authorization: token $TOKEN" -F "attachment=@$f" >/dev/null
-            echo "hochgeladen: $f"
-          done
+          apt-get update -qq
+          apt-get install -y -qq --no-install-recommends git nodejs ca-certificates xvfb xauth fonts-dejavu-core >/dev/null
+
+      - uses: actions/checkout@v4
+
+      - name: Tests + Build (Linux)
+        run: ./build/build_linux.sh
+
+      - name: Build-Artefakt hochladen
+        uses: actions/upload-artifact@v3
+        with:
+          name: Provisionsmanager95-Linux
+          path: dist/Provisionsmanager95-linux-*.tar.gz
+
+      - name: Release ergänzen
+        if: startsWith(github.ref, 'refs/tags/v')
+        env:
+          TOKEN: ${{ secrets.RELEASE_TOKEN || secrets.GITEA_TOKEN }}
+          API: ${{ github.server_url }}/api/v1/repos/${{ github.repository }}
+          TAG: ${{ github.ref_name }}
+        run: build/release_hochladen.sh dist/Provisionsmanager95-linux-x86_64-*.tar.gz

.gitignore

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

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 (Name in GROSSBUCHSTABEN)“: alle Vodafone-Positionen, deren Kundenname komplett
-     großgeschrieben ist (so erfasst unser Unterhändler seine Kunden). Diese Regel kann nur ein
-     Händler haben und hat Vorrang vor der Vo-Nr.
+   - Vodafone → Spalte **Vo-Nr** (z. B. `80000002`, `EU000001`) **oder** das Häkchen
+     „Vodafone-Kunden mit Nachnamen in GROSSBUCHSTABEN“: alle Vodafone-Positionen, deren Kundenname
+     komplett großgeschrieben ist (so erfasst unser Unterhändler seine Kunden). Diese Regel kann nur
+     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,26 @@ 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.
+
+**Zeitraum abrechnen:** Im Export-Dialog „Nur von … bis …“ eintragen (oder „Vormonat“), wahlweise nach
+Aktivierungsdatum oder Abrechnungszeitraum des Anbieters. Exportierte Positionen werden als *abgerechnet*
+gekennzeichnet (grau) und nie wieder exportiert – auch nicht, wenn dieselbe Position später in einer
+anderen Datei oder Abrechnung auftaucht. Versehentlich? Rechtsklick ▸ *Kennzeichnung „abgerechnet“ aufheben*.
+*Datei ▸ Abrechnung erledigt / wieder öffnen* sperrt eine fertige Abrechnung gegen Änderungen.
+
+**Design:** Standard ist ein modernes, helles Design (wie Windows 11); das Windows-95-Design gibt es weiter
+unter *Datei ▸ Einstellungen ▸ Darstellung* (wirkt nach Neustart).
+
+**Linux:** `Provisionsmanager95-linux-x86_64-<Version>.tar.gz` entpacken und `Provisionsmanager95` starten
+(ab Debian 12 / Ubuntu 24.04). Daten liegen unter `~/.config/Provisionsmanager95`.
+
 Alles wird sofort in der Datenbank gespeichert (`%APPDATA%\Provisionsmanager95\provisionen.db`).
 Speicherort änderbar unter *Datei ▸ Einstellungen*, Datensicherung über *Datei ▸ Datensicherung*.
 
@@ -75,6 +120,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 +131,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_linux.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# Baut die Linux-Version (einzelne Programmdatei) – im Container python:3.12-bookworm (glibc 2.36:
+# läuft ab Debian 12, Ubuntu 24.04, Linux Mint 22; Debian 11 ist ausgelaufen).
+# Ergebnis: dist/Provisionsmanager95-linux-x86_64-<version>.tar.gz
+set -euo pipefail
+cd "$(dirname "$0")/.."
+export LANG=C.UTF-8 LC_ALL=C.UTF-8
+
+if ! command -v Xvfb >/dev/null; then
+  apt-get update -qq && apt-get install -y -qq --no-install-recommends xvfb xauth fonts-dejavu-core >/dev/null
+fi
+Xvfb :91 -screen 0 1280x800x24 -nolisten tcp >/dev/null 2>&1 &
+XVFB_PID=$!
+trap 'kill $XVFB_PID 2>/dev/null || true' EXIT
+export DISPLAY=:91
+sleep 1
+
+python3 --version
+python3 -m pip install --disable-pip-version-check -q -r requirements-dev.txt
+
+echo "== Tests inkl. Oberfläche (Linux) =="
+PROVTOOL_GUI_TESTS=1 timeout 900 python3 -m pytest -v -p no:cacheprovider
+
+VERSION=$(python3 -c "import provtool; print(provtool.__version__)")
+echo "== PyInstaller (Version $VERSION) =="
+python3 -m PyInstaller --noconfirm --clean --distpath dist --workpath build/tmp build/provisionsmanager.spec
+test -x dist/Provisionsmanager95
+
+echo "== Selbsttest des fertigen Programms =="
+rm -f selbsttest.txt
+set +e
+timeout 300 dist/Provisionsmanager95 --selbsttest selbsttest.txt
+CODE=$?
+set -e
+cat selbsttest.txt 2>/dev/null || echo "(keine Ergebnisdatei)"
+if [ "$CODE" -ne 0 ] || ! head -1 selbsttest.txt 2>/dev/null | grep -qx OK; then
+  echo "Selbsttest FEHLGESCHLAGEN (Exit-Code $CODE)"; exit 1
+fi
+echo "Selbsttest bestanden"
+
+PAKET="Provisionsmanager95-linux-x86_64-$VERSION"
+rm -rf "dist/$PAKET" && mkdir -p "dist/$PAKET"
+cp dist/Provisionsmanager95 assets/app.png "dist/$PAKET/"
+cp README.md "dist/$PAKET/LIESMICH.md"
+cat > "dist/$PAKET/provisionsmanager95.desktop" <<DESKTOP
+[Desktop Entry]
+Type=Application
+Name=Provisions-Manager 95
+Comment=Provisionsabrechnung für Unterhändler
+Exec=sh -c '"\$(dirname "%k")/Provisionsmanager95"'
+Icon=app
+Terminal=false
+Categories=Office;Finance;
+DESKTOP
+tar -C dist -czf "dist/$PAKET.tar.gz" "$PAKET"
+echo "$VERSION" > dist/VERSION
+ls -la dist

build/build_windows.sh

@@ -9,11 +9,28 @@ 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) =="
-$PY -m pytest -q
+echo "== Tests inkl. Oberfläche (Windows-Python unter Wine) =="
+# 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 "== Maustest (echte Maus: Fenster ziehen, Rand ziehen, maximiert ziehen) =="
+PY="$PY" timeout 300 bash build/maustest.sh
 
 echo "== Version =="
 VERSION=$($PY build/version_info.py | tr -d '\r')
@@ -23,6 +40,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_icon.py

@@ -1,20 +0,0 @@
-"""Erzeugt assets/app.ico aus der Pixel-Grafik in provtool/gui/win95.py (benötigt Pillow, nur zum Entwickeln)."""
-import sys
-from pathlib import Path
-
-from PIL import Image
-
-ROOT = Path(__file__).resolve().parents[1]
-sys.path.insert(0, str(ROOT))
-from provtool.gui.win95 import PALETTE, _icon_rows  # noqa: E402
-
-img = Image.new("RGBA", (16, 16), (0, 0, 0, 0))
-for y, row in enumerate(_icon_rows("app")):
-    for x, ch in enumerate(row):
-        if ch != ".":
-            img.putpixel((x, y), tuple(int(PALETTE[ch][i:i + 2], 16) for i in (1, 3, 5)) + (255,))
-groessen = [16, 32, 48, 64, 128, 256]
-big = img.resize((256, 256), Image.NEAREST)
-big.save(ROOT / "assets" / "app.ico", sizes=[(s, s) for s in groessen])
-big.save(ROOT / "assets" / "app.png")
-print("assets/app.ico geschrieben")

build/make_moderne_icons.py

@@ -0,0 +1,117 @@
+"""Zeichnet die modernen Symbole (flach, wie Windows 11) und das Programm-Icon.
+
+Ausgabe: provtool/gui/bilder/modern/<name>.png (20 px) und <name>_gross.png (40 px),
+assets/app.ico und assets/app.png. Benötigt Pillow – nur zum Entwickeln, nicht zur Laufzeit.
+"""
+from pathlib import Path
+
+from PIL import Image, ImageDraw, ImageFont
+
+ROOT = Path(__file__).resolve().parents[1]
+ZIEL = ROOT / "provtool" / "gui" / "bilder" / "modern"
+N = 160  # Zeichenfläche (8-fach), danach weich verkleinert
+LINIE, AKZENT, HELL = (66, 66, 66, 255), (0, 95, 184, 255), (255, 255, 255, 255)
+GELB, ROT, ORANGE = (240, 190, 70, 255), (196, 43, 28, 255), (247, 168, 0, 255)
+S = 9  # Strichstärke auf der Zeichenfläche
+SCHRIFT = "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf"
+
+
+def leinwand():
+    img = Image.new("RGBA", (N, N), (0, 0, 0, 0))
+    return img, ImageDraw.Draw(img)
+
+
+def zeichen(d, text, farbe, groesse=104):
+    f = ImageFont.truetype(SCHRIFT, groesse)
+    d.text((N / 2, N / 2 + 4), text, font=f, fill=farbe, anchor="mm")
+
+
+def prozent(d, farbe, s=S):
+    d.ellipse((28, 28, 68, 68), outline=farbe, width=s)
+    d.ellipse((92, 92, 132, 132), outline=farbe, width=s)
+    d.line((120, 30, 40, 130), fill=farbe, width=s + 2)
+
+
+def neu(d):
+    d.polygon([(34, 14), (96, 14), (126, 44), (126, 146), (34, 146)], outline=LINIE, width=S, fill=HELL)
+    d.line([(96, 14), (96, 44), (126, 44)], fill=LINIE, width=S)
+    d.ellipse((86, 86, 150, 150), fill=AKZENT)
+    d.line((118, 100, 118, 136), fill=HELL, width=S)
+    d.line((100, 118, 136, 118), fill=HELL, width=S)
+
+
+def oeffnen(d):
+    d.polygon([(14, 34), (62, 34), (76, 50), (146, 50), (146, 132), (14, 132)], fill=GELB, outline=(193, 140, 30, 255),
+              width=S - 2)
+    d.rectangle((14, 66, 146, 132), fill=(250, 210, 100, 255), outline=(193, 140, 30, 255), width=S - 2)
+
+
+def ablage(d, hoch: bool):
+    d.line([(18, 96), (18, 140), (142, 140), (142, 96)], fill=LINIE, width=S, joint="curve")
+    oben, unten = (14, 104) if hoch else (14, 104)
+    d.line((80, oben, 80, unten), fill=AKZENT, width=S + 2)
+    if hoch:
+        d.polygon([(80, 8), (52, 42), (108, 42)], fill=AKZENT)
+    else:
+        d.polygon([(80, 118), (52, 82), (108, 82)], fill=AKZENT)
+
+
+def haendler(d):
+    d.ellipse((24, 26, 74, 76), outline=LINIE, width=S)
+    d.arc((8, 82, 90, 170), 180, 360, fill=LINIE, width=S)
+    d.ellipse((88, 34, 132, 78), fill=AKZENT)
+    d.pieslice((74, 86, 152, 166), 180, 360, fill=AKZENT)
+
+
+def rechner(d):  # Stift: Betrag ändern
+    d.polygon([(110, 18), (142, 50), (58, 134), (26, 102)], fill=HELL, outline=LINIE, width=S)
+    d.polygon([(26, 102), (58, 134), (16, 144)], fill=AKZENT)
+    d.line((98, 30, 130, 62), fill=LINIE, width=S)
+
+
+def birne(d):
+    d.ellipse((34, 10, 126, 102), fill=GELB, outline=(193, 140, 30, 255), width=S - 2)
+    d.rectangle((56, 96, 104, 122), fill=GELB)
+    d.rectangle((56, 122, 104, 150), fill=(120, 120, 120, 255))
+    d.line((60, 134, 100, 134), fill=HELL, width=4)
+
+
+def kreis(d, farbe, text):
+    d.ellipse((6, 6, 154, 154), fill=farbe)
+    zeichen(d, text, HELL)
+
+
+def warnung(d):
+    d.polygon([(80, 8), (156, 148), (4, 148)], fill=ORANGE)
+    zeichen(d, "!", (30, 30, 30, 255), 92)
+
+
+def app(d):
+    d.rounded_rectangle((4, 4, 156, 156), radius=34, fill=AKZENT)
+    prozent(d, HELL, 13)
+
+
+ICONS = {
+    "neu": neu, "oeffnen": oeffnen, "import": lambda d: ablage(d, False), "export": lambda d: ablage(d, True),
+    "haendler": haendler, "prozent": lambda d: prozent(d, AKZENT), "rechner": rechner, "birne": birne,
+    "info": lambda d: kreis(d, AKZENT, "i"), "frage": lambda d: kreis(d, AKZENT, "?"),
+    "fehler": lambda d: kreis(d, ROT, "×"), "warnung": warnung, "app": app,
+}
+
+
+def main():
+    ZIEL.mkdir(parents=True, exist_ok=True)
+    for name, zeichne in ICONS.items():
+        img, d = leinwand()
+        zeichne(d)
+        img.resize((20, 20), Image.LANCZOS).save(ZIEL / f"{name}.png")
+        img.resize((40, 40), Image.LANCZOS).save(ZIEL / f"{name}_gross.png")
+        if name == "app":
+            gross = img.resize((256, 256), Image.LANCZOS)
+            gross.save(ROOT / "assets" / "app.png")
+            gross.save(ROOT / "assets" / "app.ico", sizes=[(s, s) for s in (16, 24, 32, 48, 64, 128, 256)])
+    print(f"{len(ICONS)} Symbole nach {ZIEL} geschrieben, assets/app.ico + app.png erneuert")
+
+
+if __name__ == "__main__":
+    main()

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/maus_app.py

@@ -0,0 +1,37 @@
+"""Für build/maustest.sh: startet die App und schreibt laufend Lage und Zustand des Hauptfensters.
+
+Kein pytest-Test – wird im Windows-Build mit echter Maus (xdotool) bedient. Hintergrund: v1.3.0 stürzte
+beim Ziehen an der Titelleiste hart ab; das sieht man nur mit echter Maus.
+"""
+import faulthandler
+import json
+import os
+import sys
+import tempfile
+import tkinter as tk
+
+aus = sys.argv[1]
+faulthandler.enable(open(os.path.join(aus, "absturz.txt"), "w"))
+home = tempfile.mkdtemp()
+os.environ["PROVTOOL_HOME"] = home
+with open(os.path.join(home, "einstellungen.json"), "w") as f:
+    json.dump({"assistent_erledigt": True, "tipps_beim_start": False, "fenster": "900x560+100+100",
+               "design": "win95"}, f)  # nur Win95 hat den eigenen Fensterrahmen
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+from provtool.gui import app as A  # noqa: E402
+
+root = tk.Tk()
+a = A.App(root)
+fehler = []
+root.report_callback_exception = lambda *e: fehler.append(repr(e[1]))
+
+
+def melden():
+    with open(os.path.join(aus, "status.txt"), "a") as f:
+        f.write(f"{root.winfo_x()} {root.winfo_y()} {root.winfo_width()} {root.winfo_height()} "
+                f"{int(a.rahmen.maximiert)} {len(fehler)}\n")
+    root.after(250, melden)
+
+
+root.after(250, melden)
+root.mainloop()

build/maustest.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# Echte Maus im virtuellen Bildschirm (xdotool): Fenster an der Titelleiste ziehen, am Rand die Größe
+# ziehen, maximieren und aus „maximiert“ herausziehen. v1.3.0 stürzte dabei hart ab – das sieht nur
+# ein Test mit echter Maus (Windows-Verschiebeschleife). Aufruf aus build_windows.sh (DISPLAY gesetzt).
+set -uo pipefail
+cd "$(dirname "$0")/.."
+PY="${PY:-wine python}"
+AUS="$(mktemp -d)"
+command -v xdotool >/dev/null || { apt-get update -qq >/dev/null && apt-get install -y -qq xdotool >/dev/null; }
+command -v xdotool >/dev/null || { echo "xdotool fehlt"; exit 1; }
+
+$PY build/maus_app.py "$(winepath -w "$AUS" 2>/dev/null || echo "$AUS")" > "$AUS/app.log" 2>&1 &
+PID=$!
+for i in $(seq 1 120); do [ -s "$AUS/status.txt" ] && break; sleep 0.5; done
+sleep 3
+lage() { tail -1 "$AUS/status.txt" | tr -d '\r'; }
+lebt() { kill -0 "$PID" 2>/dev/null; }
+fehler=0
+pruefe() {  # $1 = Schritt
+  sleep 1.5
+  if ! lebt; then echo "ABSTURZ bei: $1"; fehler=1; return 1; fi
+  echo "$1: $(lage)"
+}
+ziehen() {  # x y dx dy
+  xdotool mousemove "$1" "$2"; sleep 0.4; xdotool mousedown 1; sleep 0.3
+  for i in 1 2 3 4 5 6; do xdotool mousemove_relative -- "$(( $3 / 6 ))" "$(( $4 / 6 ))"; sleep 0.15; done
+  sleep 0.2; xdotool mouseup 1
+}
+
+read -r X Y W H M F <<< "$(lage)"
+echo "Start: $X $Y $W $H maximiert=$M"
+ziehen $(( X + 300 )) $(( Y + 14 )) 60 42;              pruefe "Titelleiste ziehen" || true
+read -r X2 Y2 W2 H2 M2 F2 <<< "$(lage)"
+[ "$X2" -ne "$X" ] || [ "$Y2" -ne "$Y" ] || { echo "Fenster hat sich nicht bewegt"; fehler=1; }
+ziehen $(( X2 + W2 - 2 )) $(( Y2 + H2 / 2 )) 60 0;      pruefe "Rand ziehen" || true
+read -r X3 Y3 W3 H3 M3 F3 <<< "$(lage)"
+[ "$W3" -gt "$W2" ] || { echo "Größe am Rand nicht geändert ($W2 -> $W3)"; fehler=1; }
+xdotool mousemove $(( X3 + 300 )) $(( Y3 + 14 )); sleep 0.3
+xdotool click --repeat 2 --delay 60 1;                   pruefe "Doppelklick (maximieren)" || true
+read -r X4 Y4 W4 H4 M4 F4 <<< "$(lage)"
+[ "$M4" = "1" ] || { echo "nicht maximiert"; fehler=1; }
+# Unter echtem Windows wird das Fenster dabei wiederhergestellt, unter Wine nicht – hier zählt: kein Absturz
+ziehen $(( X4 + 400 )) $(( Y4 + 12 )) 0 150;             pruefe "aus maximiert herausziehen" || true
+
+if lebt; then kill "$PID" 2>/dev/null; fi
+sleep 1
+if [ -s "$AUS/absturz.txt" ]; then echo "== Absturzprotokoll:"; cat "$AUS/absturz.txt"; fehler=1; fi
+if grep -q "Fatal Python error" "$AUS/app.log"; then cat "$AUS/app.log"; fehler=1; fi
+read -r _ _ _ _ _ FE <<< "$(lage)"
+[ "${FE:-0}" = "0" ] || { echo "Fehler in Tk-Callbacks: $FE"; fehler=1; }
+[ "$fehler" = 0 ] && echo "Maustest bestanden" || echo "Maustest FEHLGESCHLAGEN"
+exit "$fehler"

build/provisionsmanager.spec

@@ -1,6 +1,9 @@
-# PyInstaller-Spezifikation – erzeugt eine einzelne Provisionsmanager95.exe
-# Aufruf (unter Windows oder Wine):  pyinstaller --noconfirm build/provisionsmanager.spec
+# PyInstaller-Spezifikation – erzeugt eine einzelne Programmdatei (Windows: .exe, Linux: ELF)
+# Aufruf:  pyinstaller --noconfirm build/provisionsmanager.spec
 import os
+import sys
+
+WIN = sys.platform.startswith("win")
 
 ROOT = os.path.abspath(os.path.join(SPECPATH, ".."))
 
@@ -8,6 +11,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,
 )
@@ -19,8 +23,8 @@ exe = EXE(
     a.datas,
     [],
     name="Provisionsmanager95",
-    icon=os.path.join(ROOT, "assets", "app.ico"),
-    version=os.path.join(ROOT, "build", "version_info.txt"),
+    icon=os.path.join(ROOT, "assets", "app.ico") if WIN else None,
+    version=os.path.join(ROOT, "build", "version_info.txt") if WIN else None,
     console=False,
     upx=False,
     debug=False,

build/release_hochladen.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Hängt Dateien an das Gitea-Release des Tags (legt es an, falls es noch fehlt – Windows- und
+# Linux-Job laufen parallel, wer zuerst fertig ist, legt es an).
+# Aufruf: TOKEN=… API=…/api/v1/repos/<owner>/<repo> TAG=v1.2.3 build/release_hochladen.sh datei…
+set -eu
+VERSION=$(tr -d '\r\n' < dist/VERSION)
+if [ "v$VERSION" != "$TAG" ]; then
+  echo "Tag $TAG passt nicht zu provtool/__init__.py (Version $VERSION)"; exit 1
+fi
+release_id() { curl -sf "$API/releases/tags/$TAG" -H "Authorization: token $TOKEN" | grep -o '"id":[0-9]*' | head -1 | cut -d: -f2; }
+id=$(release_id || true)
+if [ -z "$id" ]; then
+  curl -sf -X POST "$API/releases" -H "Authorization: token $TOKEN" -H "Content-Type: application/json" \
+    -d "{\"tag_name\":\"$TAG\",\"name\":\"Provisions-Manager 95 $TAG\",\"body\":\"Windows: .exe herunterladen und starten. Linux: tar.gz entpacken, Provisionsmanager95 starten (ab Debian 12 / Ubuntu 24.04).\"}" \
+    >/dev/null || sleep 5   # Gleichzeitig angelegt? Dann gibt es das Release jetzt.
+  id=$(release_id)
+fi
+for f in "$@"; do
+  curl -sf -X POST "$API/releases/$id/assets?name=$(basename "$f")" \
+    -H "Authorization: token $TOKEN" -F "attachment=@$f" >/dev/null
+  echo "hochgeladen: $f"
+done

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.4.1"
 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

@@ -1,6 +1,7 @@
 """SQLite-Datenbank: Händler, deren Kennungen, Auszahlungsregeln und gespeicherte Abrechnungen."""
 from __future__ import annotations
 
+import hashlib
 import json
 import shutil
 import sqlite3
@@ -8,10 +9,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 = 4
 
 SCHEMA = """
 CREATE TABLE IF NOT EXISTS meta (schluessel TEXT PRIMARY KEY, wert TEXT);
@@ -23,7 +25,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 +55,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,
@@ -79,9 +97,18 @@ CREATE TABLE IF NOT EXISTS position (
     roh TEXT
 );
 CREATE INDEX IF NOT EXISTS ix_position_abr ON position(abrechnung_id);
+
+-- Abgerechnete Positionen (Fingerabdruck), über alle Abrechnungen hinweg: taucht eine schon
+-- ausgezahlte Position in einer späteren Datei/Abrechnung wieder auf, wird sie nicht erneut abgerechnet.
+CREATE TABLE IF NOT EXISTS abgerechnet_fp (
+    fp TEXT PRIMARY KEY,
+    wann TEXT NOT NULL,
+    abrechnung TEXT NOT NULL
+);
 """
 
 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.
@@ -89,6 +116,27 @@ CAPS_ANBIETER = "vodafone_caps"
 CAPS_WERT = "*"
 
 
+FP_FELDER = ("anbieter", "zeitraum", "provisionsart", "kennung", "datum", "rufnummer", "imei", "vorname", "name",
+             "tarif", "dienst", "aktionscode", "betrag_orig")
+
+
+def fingerabdruecke(zeilen: list[dict]) -> list[str]:
+    """Fingerabdruck je Position einer Datei. Gleiche Zeilen innerhalb einer Datei (z. B. zwei gleiche
+    SIM-Karten-Gutschriften) werden durchgezählt, damit beide als eigene Positionen gelten."""
+    gesehen: dict[str, int] = {}
+    out = []
+    for z in zeilen:
+        roh = "\x1f".join(str(z.get(k) if z.get(k) is not None else "").strip() for k in FP_FELDER)
+        h = hashlib.sha1(roh.encode("utf-8")).hexdigest()[:24]
+        gesehen[h] = gesehen.get(h, 0) + 1
+        out.append(f"{h}#{gesehen[h]}")
+    return out
+
+
+class AbrechnungErledigt(Exception):
+    """Die Abrechnung ist als erledigt gekennzeichnet und darf nicht mehr verändert werden."""
+
+
 def ist_grossgeschrieben(name: str | None) -> bool:
     buchstaben = [c for c in (name or "") if c.isalpha() and c != "ß"]
     return len(buchstaben) >= 2 and all(c.isupper() for c in buchstaben)
@@ -103,6 +151,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,9 +176,33 @@ 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")
+        if "abgerechnet" not in spalten:
+            # Zeitpunkt der Abrechnung (NULL = offen), Händler zum Zeitpunkt der Abrechnung (eingefroren),
+            # Fingerabdruck (erkennt dieselbe Position in späteren Dateien)
+            self.con.execute("ALTER TABLE position ADD COLUMN abgerechnet TEXT")
+            self.con.execute("ALTER TABLE position ADD COLUMN abgerechnet_hid INTEGER")
+            self.con.execute("ALTER TABLE position ADD COLUMN fp TEXT")
+        a_spalten = {r[1] for r in self.con.execute("PRAGMA table_info(abrechnung)")}
+        if "erledigt" not in a_spalten:
+            self.con.execute("ALTER TABLE abrechnung ADD COLUMN erledigt TEXT")
+        self._fingerabdruecke_nachtragen()
         self.con.execute("UPDATE meta SET wert=? WHERE schluessel='schema_version'", (str(SCHEMA_VERSION),))
         self.con.commit()
 
+    def _fingerabdruecke_nachtragen(self):
+        """Für Positionen aus älteren Versionen den Fingerabdruck berechnen."""
+        dateien = [r[0] for r in self.con.execute("SELECT DISTINCT datei_id FROM position WHERE fp IS NULL")]
+        for did in dateien:
+            zeilen = [dict(r) for r in self.con.execute(
+                "SELECT * FROM position WHERE datei_id IS ? ORDER BY reihenfolge", (did,))]
+            for pid, fp in zip([z["id"] for z in zeilen], fingerabdruecke(zeilen)):
+                self.con.execute("UPDATE position SET fp=? WHERE id=? AND fp IS NULL", (fp, pid))
+
     def close(self):
         self.con.close()
 
@@ -149,30 +223,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"],
-                         r["standard_prozent"], bool(r["aktiv"])) for r in self.con.execute(sql)]
+        return [self._haendler_aus(r) 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 None
-        return Haendler(r["id"], r["name"], r["ansprechpartner"], r["email"], r["notiz"],
-                        r["standard_prozent"], bool(r["aktiv"]))
+        return self._haendler_aus(r) if r else None
 
     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=?",
-                    (h.name, h.ansprechpartner, h.email, h.notiz, h.standard_prozent, int(h.aktiv), h.id))
+                    "UPDATE haendler SET name=?, ansprechpartner=?, email=?, notiz=?, standard_prozent=?, aktiv=?, "
+                    "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 (?,?,?,?,?,?)",
-                    (h.name, h.ansprechpartner, h.email, h.notiz, h.standard_prozent, int(h.aktiv)))
+                    "INSERT INTO haendler (name, ansprechpartner, email, notiz, standard_prozent, 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 +284,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 +323,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()
@@ -249,6 +388,7 @@ class Datenbank:
     def abrechnungen(self) -> list[sqlite3.Row]:
         return list(self.con.execute(
             "SELECT a.*, (SELECT count(*) FROM position p WHERE p.abrechnung_id=a.id) AS anzahl, "
+            "(SELECT count(*) FROM position p WHERE p.abrechnung_id=a.id AND p.abgerechnet IS NOT NULL) AS abgerechnet, "
             "(SELECT group_concat(dateiname, ', ') FROM abrechnung_datei d WHERE d.abrechnung_id=a.id) AS dateien "
             "FROM abrechnung a ORDER BY a.geaendert DESC"))
 
@@ -272,12 +412,15 @@ class Datenbank:
             (sha256,))]
 
     def datei_entfernen(self, datei_id: int) -> None:
+        r = self.con.execute("SELECT abrechnung_id FROM abrechnung_datei WHERE id=?", (datei_id,)).fetchone()
+        if r:
+            self._nicht_erledigt(r[0])
         with self.con:
             self.con.execute("DELETE FROM position WHERE datei_id=?", (datei_id,))
             self.con.execute("DELETE FROM abrechnung_datei WHERE id=?", (datei_id,))
 
     def importieren(self, aid: int, erg: ImportErgebnis) -> int:
-        finde = self.zuordner()
+        self._nicht_erledigt(aid)
         start = self.con.execute("SELECT coalesce(max(reihenfolge), 0) FROM position WHERE abrechnung_id=?",
                                  (aid,)).fetchone()[0]
         with self.con:
@@ -286,51 +429,133 @@ 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,
-                     apply_percent(p.betrag_cent, proz), proz, json.dumps(p.roh, ensure_ascii=False, default=str)))
+                     p.tarif, p.netz, p.dienst, p.aktionscode, p.quelle, p.betrag_cent, p.betrag_cent,
+                     json.dumps(p.roh, ensure_ascii=False, default=str)))
             self.con.execute("UPDATE abrechnung SET geaendert=? WHERE id=?", (_now(), aid))
+            zeilen = [dict(r) for r in self.con.execute(
+                "SELECT * FROM position WHERE datei_id=? ORDER BY reihenfolge", (did,))]
+            for z, fp in zip(zeilen, fingerabdruecke(zeilen)):
+                self.con.execute("UPDATE position SET fp=? WHERE id=?", (fp, z["id"]))
+        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()
+        schon = dict(self.con.execute("SELECT fp, abrechnung FROM abgerechnet_fp").fetchall())
         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"])
+            if d["abgerechnet"] and d["abgerechnet_hid"] is not None:
+                d["haendler_id"] = d["abgerechnet_hid"]  # abgerechnet: Zuordnung eingefroren
+            else:
+                d["haendler_id"] = finde(d["anbieter"], d["kennung"], d["name"], d["haendler_fest"])
+            d["typ"] = regeln.typ_von(d, fest)
+            # schon anderswo abgerechnet (dieselbe Position in einer früheren Datei/Abrechnung)?
+            d["doppelt"] = schon.get(d["fp"]) if d["fp"] and not d["abgerechnet"] else None
             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."""
+        if self.erledigt(aid):
+            return 0  # erledigte Abrechnungen bleiben, wie sie abgerechnet wurden
+        alle = self.positionen(aid)
+        karten = self.karten_zaehlen(alle)
+        rechne = self._rechner()
+        n = 0
+        with self.con:
+            for p in alle:
+                if p["abgerechnet"]:
+                    continue  # schon ausgezahlt: Betrag bleibt
+                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."""
+        pids = self._offene(pids)
         with self.con:
             for pid in pids:
                 self.con.execute("UPDATE position SET haendler_fest=? WHERE id=?", (hid, pid))
-        finde = self.zuordner()
-        with self.con:
-            for pid in pids:
-                r = self.con.execute("SELECT * FROM position WHERE id=?", (pid,)).fetchone()
-                if r is None or r["manuell"]:
-                    continue
-                neu_hid = finde(r["anbieter"], r["kennung"], r["name"], r["haendler_fest"])
-                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))
+        for aid in self._abrechnungen_von(pids):
+            self._regeln_anwenden(aid, set(pids))
+
+    def regeln_wiederherstellen(self, pids: list[int]) -> None:
+        """Ausgewählte Positionen wieder nach den Händler-Regeln berechnen (auch von Hand geänderte)."""
+        for aid in self._abrechnungen_von(pids):
+            self._regeln_anwenden(aid, set(pids), auch_manuelle=True)
 
     def betrag_setzen(self, pid: int, cent: int) -> None:
+        if not self._offene([pid]):
+            raise AbrechnungErledigt("Die Position ist bereits abgerechnet.")
         with self.con:
             self.con.execute("UPDATE position SET betrag=?, manuell=1, prozent=NULL WHERE id=?", (cent, pid))
 
     def prozent_anwenden(self, pids: list[int], prozent: float, auch_manuelle: bool = True) -> int:
+        pids = self._offene(pids)
         n = 0
         with self.con:
             for pid in pids:
@@ -345,18 +570,81 @@ 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."""
+        return self._regeln_anwenden(aid, None, auch_manuelle=auch_manuelle)
+
+    # ------------------------------------------------------------------ abgerechnet / erledigt
+    def _offene(self, pids) -> list[int]:
+        """Nur Positionen, die noch geändert werden dürfen (nicht abgerechnet, Abrechnung nicht erledigt)."""
+        pids = list(pids)
+        if not pids:
+            return []
+        marken = ",".join("?" * len(pids))
+        return [r[0] for r in self.con.execute(
+            f"SELECT p.id FROM position p JOIN abrechnung a ON a.id=p.abrechnung_id "
+            f"WHERE p.id IN ({marken}) AND p.abgerechnet IS NULL AND a.erledigt IS NULL", pids)]
+
+    def erledigt(self, aid: int) -> str | None:
+        r = self.con.execute("SELECT erledigt FROM abrechnung WHERE id=?", (aid,)).fetchone()
+        return r[0] if r else None
+
+    def _nicht_erledigt(self, aid: int) -> None:
+        if self.erledigt(aid):
+            raise AbrechnungErledigt("Diese Abrechnung ist als erledigt gekennzeichnet.")
+
+    def abrechnen(self, pids: list[int], wann: str | None = None) -> int:
+        """Positionen als abgerechnet kennzeichnen: Betrag und Händler werden eingefroren, der
+        Fingerabdruck gemerkt (dieselbe Position wird später nicht noch einmal abgerechnet).
+        Nur Positionen echter Händler, die noch offen und nicht schon anderswo abgerechnet sind."""
+        wann = wann or _now()
+        ids = set(pids)
         n = 0
-        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"]))
+        for aid in self._abrechnungen_von(list(ids)):
+            titel = self.abrechnung(aid)["titel"]
+            with self.con:
+                for p in self.positionen(aid):
+                    if p["id"] not in ids or p["abgerechnet"] or p["doppelt"] or p["haendler_id"] <= 0:
+                        continue
+                    self.con.execute("UPDATE position SET abgerechnet=?, abgerechnet_hid=? WHERE id=?",
+                                     (wann, p["haendler_id"], p["id"]))
+                    if p["fp"]:
+                        self.con.execute("INSERT OR REPLACE INTO abgerechnet_fp (fp, wann, abrechnung) VALUES (?,?,?)",
+                                         (p["fp"], wann, titel))
                     n += 1
         return n
 
+    def abrechnung_aufheben(self, pids: list[int]) -> int:
+        """Kennzeichnung „abgerechnet“ zurücknehmen (z. B. versehentlich exportiert)."""
+        n = 0
+        for aid in self._abrechnungen_von(list(pids)):
+            self._nicht_erledigt(aid)
+        with self.con:
+            for pid in pids:
+                r = self.con.execute("SELECT fp, abgerechnet FROM position WHERE id=?", (pid,)).fetchone()
+                if not r or not r["abgerechnet"]:
+                    continue
+                self.con.execute("UPDATE position SET abgerechnet=NULL, abgerechnet_hid=NULL WHERE id=?", (pid,))
+                if r["fp"]:
+                    self.con.execute("DELETE FROM abgerechnet_fp WHERE fp=?", (r["fp"],))
+                n += 1
+        return n
+
+    def erledigt_setzen(self, aid: int, erledigt: bool, positionen_aufheben: bool = False) -> int:
+        """Abrechnung als erledigt kennzeichnen (alle offenen Händler-Positionen werden dabei
+        abgerechnet) bzw. wieder öffnen (auf Wunsch samt Kennzeichnung der Positionen).
+        Gibt die Anzahl der dabei (ab)gerechneten Positionen zurück."""
+        n = 0
+        if erledigt:
+            wann = _now()
+            n = self.abrechnen([p["id"] for p in self.positionen(aid)], wann)
+            with self.con:
+                self.con.execute("UPDATE abrechnung SET erledigt=?, geaendert=? WHERE id=?", (wann, wann, aid))
+        else:
+            with self.con:
+                self.con.execute("UPDATE abrechnung SET erledigt=NULL, geaendert=? WHERE id=?", (_now(), aid))
+            if positionen_aufheben:
+                n = self.abrechnung_aufheben([p["id"] for p in self.positionen(aid)])
+        return n
+
     def touch(self, aid: int) -> None:
         with self.con:
             self.con.execute("UPDATE abrechnung SET geaendert=? WHERE id=?", (_now(), aid))

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,27 @@ def dateiname(text: str) -> str:
     return re.sub(r'[<>:"/\\|?*\x00-\x1f]', "_", text).strip(" .") or "Export"
 
 
+AIRTIME_TEXT = "Airtime"
+
+
+def spalte_a(p: dict):
+    """Spalte A: bei freenet der Zeitraum, bei Vodafone das Aktivierungsdatum (dort steht als Zeitraum
+    nur der Abrechnungslauf wie „VF2609“ – kein Datum)."""
+    if p.get("anbieter") == "vodafone" and p.get("datum"):
+        return date.fromisoformat(p["datum"])
+    return p.get("zeitraum") or None
+
+
+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,9 +82,9 @@ 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,
+            spalte_a(p),
             p.get("provisionsart") or None,
             _zahl_oder_text(p.get("kennung")),
             date.fromisoformat(p["datum"]) if p.get("datum") else None,
@@ -78,8 +101,10 @@ 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"
+        if isinstance(werte[0], date):
+            ws.cell(zeile, 1).number_format = "DD.MM.YYYY"
         ws.cell(zeile, 5).number_format = "0"
         ws.cell(zeile, 6).number_format = "0"
         ws.cell(zeile, 11).number_format = EURO_FORMAT
@@ -104,20 +129,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]:
-    """Schreibt eine (oder je Anbieter eine) Datei für einen Händler. Gibt die erzeugten Pfade zurück."""
+                        pro_anbieter: bool = False, kopfzeile: bool = False, summe: bool = True,
+                        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)
-    else:
-        gruppen[""] = positionen
+    for p in positionen:
+        gruppen.setdefault(p["anbieter"] if pro_anbieter else "", []).append(p)
+
+    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]
-        name = dateiname(" - ".join(t for t in teile if t)) + ".xlsx"
-        out.append(schreibe_xlsx(ordner / name, pos, kopfzeile=kopfzeile, summe=summe))
+        provision = [p for p in pos if p.get("typ") != AIRTIME]
+        airtime = [p for p in pos if p.get("typ") == AIRTIME]
+        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

@@ -12,10 +12,15 @@ from datetime import date
 from pathlib import Path
 from tkinter import filedialog
 
-from provtool import APP_NAME, config
+from provtool import config
 from provtool import export as exp
-from provtool.db import UNZUGEORDNET, Datenbank
+from provtool import regeln
+from provtool.db import EIGEN, UNZUGEORDNET, AbrechnungErledigt, 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,95 @@ 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.design_setzen(self.settings.get("design", "modern"))
         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 = w.DESIGN == "win95"  # Win95: eigene Titelleiste; modern: normaler Windows-Rahmen
+        w.KLASSISCH = klassisch
+        self.rahmen = rh.Hauptrahmen(root, w.APP_NAME, self.icons("app"), self.beenden, klassisch=klassisch)
+        self.rahmen.set_titel(w.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)
-        d = tk.Menu(m, tearoff=0)
-        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)
+        self.menueleiste = mn.Menueleiste(self.inhalt, self.root)
+        self.menueleiste.pack(side="top", fill="x")
+        d = self.menueleiste.menue("Datei")
+        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="Importierte Dateien…", command=self.dateien)
-        d.add_command(label="Exportieren…", accelerator="Strg+E", command=self.exportieren)
+        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="Exportieren...", accelerator="Strg+E", command=self.exportieren)
+        d.add_command(label="Abrechnung erledigt / wieder öffnen...", command=self.erledigt_umschalten)
         d.add_separator()
-        d.add_command(label="Datensicherung erstellen…", command=self.sicherung)
-        d.add_command(label="Datensicherung einspielen…", command=self.wiederherstellen)
-        d.add_command(label="Einstellungen…", command=self.einstellungen)
+        d.add_command(label="Datensicherung erstellen...", command=self.sicherung)
+        d.add_command(label="Datensicherung einspielen...", command=self.wiederherstellen)
+        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.add_command(label="Betrag ändern…", accelerator="F2", command=self.betrag_bearbeiten)
-        b.add_command(label="Auszahlung in Prozent…", accelerator="F4", command=self.prozent)
+        b = self.menueleiste.menue("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="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.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="Auswahl fest einem Händler zuweisen…", command=self.haendler_zuweisen)
+        h = self.menueleiste.menue("Händler")
+        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="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())
-        m.add_cascade(label="?", menu=hi)
-        self.root.configure(menu=m)
+        hi.add_command(label="Einrichtungs-Assistent...", command=self.assistent)
+        hi.add_separator()
+        hi.add_command(label=f"Info über {w.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=0 if w.MODERN else 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 +171,28 @@ 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="flat" if w.MODERN else "raised",
+                                      bd=0, opaqueresize=False, sashcursor="sb_h_double_arrow")
         pw.pack(fill="both", expand=True, padx=6, pady=6)
 
         # --- Händler-Fenster
@@ -195,6 +230,7 @@ class App:
         self.ptree.tag_configure("manuell", foreground="#0000c0")
         self.ptree.tag_configure("abw", foreground="#a00000")
         self.ptree.tag_configure("negativ", foreground="#a00000")
+        self.ptree.tag_configure("abgerechnet", foreground=w.SHADOW)
         r2.pack(fill="both", expand=True)
         self.ptree.bind("<Double-1>", self._doppelklick)
         self.ptree.bind("<Button-3>", self._kontextmenue)
@@ -202,25 +238,31 @@ 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")
-        w.knopf(leiste, "Betrag ändern…", self.betrag_bearbeiten, self.icons("rechner")).pack(side="left", padx=4)
+        self.b_prozent = w.knopf(leiste, "Prozent...", self.prozent, self.icons("prozent"))
+        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")
         w.knopf(leiste, "Alle aufklappen", lambda: self._klappen(True)).pack(side="right", padx=4)
-        tk.Label(leiste, text="Blau = von Hand · Rot = abweichend", fg=w.SHADOW).pack(
+        tk.Label(leiste, text="Blau = von Hand · Rot = abweichend · Grau = abgerechnet", fg=w.SHADOW).pack(
             side="left", padx=8)
         pw.add(self.f_p, minsize=500)
 
     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())
-        r.bind_all("<Control-i>", lambda e: self.importieren())
-        r.bind_all("<Control-e>", lambda e: self.exportieren())
-        r.bind_all("<Control-h>", lambda e: self.haendler())
-        r.bind_all("<Control-f>", lambda e: self._suchfeld.focus_set())
-        r.bind_all("<F1>", lambda e: self.hilfe())
+
+        def frei(befehl):
+            # Tastenkürzel des Hauptfensters nicht ausführen, solange ein Dialog offen ist
+            # (sonst öffnete z. B. Strg+N im Dialog einen zweiten Dialog darüber)
+            return lambda e: None if modal.offen() else befehl()
+        r.bind_all("<Control-n>", frei(self.neu))
+        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())
@@ -234,20 +276,30 @@ class App:
         self.haendler_namen = {h.id: h.name for h in self.db.haendler_liste()}
         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}]")
+            titel = self.db.abrechnung(self.aid)["titel"] + (" – erledigt" if self.db.erledigt(self.aid) else "")
+            self.rahmen.set_titel(f"{w.APP_NAME} - [{titel}]")
             self.status.set("info", f" Abrechnung: {titel}")
         else:
             self.aid = None
             self.positionen = []
-            self.root.title(APP_NAME)
-            self.status.set("info", " Keine Abrechnung geöffnet – Datei ▸ Neue Abrechnung oder Import")
+            self.rahmen.set_titel(w.APP_NAME)
+            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 +311,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 +321,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 +341,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,12 +376,17 @@ 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}
-            pz = fmt_percent(next(iter(proz))) if len(proz) == 1 and None not in proz else ("gemischt" if so else "")
+            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",))
             for p in plist:
                 tags = []
-                if p["manuell"]:
+                if p["abgerechnet"] or p["doppelt"]:
+                    tags.append("abgerechnet")
+                elif p["manuell"]:
                     tags.append("manuell")
                 elif p["betrag"] != p["betrag_orig"]:
                     tags.append("abw")
@@ -332,9 +395,12 @@ 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"])),
+                                 "abgerechnet" if p["abgerechnet"] or p["doppelt"] else
+                                 "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)
@@ -411,7 +477,7 @@ class App:
         if not dateien:
             return
         self.settings["import_ordner"] = str(Path(dateien[0]).parent)
-        if not self._brauche_abrechnung():
+        if not self._brauche_abrechnung() or self._gesperrt():
             return
         bericht = []
         self.root.configure(cursor="watch")
@@ -435,8 +501,12 @@ class App:
                     bericht.append((name, erg.format, 0, 0, "übersprungen (bereits importiert)"))
                     continue
                 n = self.db.importieren(self.aid, erg)
+                did = self.db.dateien(self.aid)[-1]["id"]
+                doppelt = sum(1 for p in self.db.positionen(self.aid) if p["datei_id"] == did and p["doppelt"])
+                hinweise = list(erg.warnungen) + ([f"{doppelt} Pos. bereits abgerechnet (werden nicht erneut "
+                                                   "exportiert)"] if doppelt else [])
                 bericht.append((name, erg.format, n, sum(p.betrag_cent for p in erg.positionen),
-                                "; ".join(erg.warnungen) or "OK"))
+                                "; ".join(hinweise) or "OK"))
         finally:
             self.root.configure(cursor="")
         self._aktualisieren()
@@ -447,8 +517,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:
-            self.kennung_zuordnen(*res)
+        if res and res[0] == "zuordnen":
+            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 +540,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:
@@ -495,7 +578,45 @@ class App:
         ps = [p for p in self.positionen if p["id"] in set(pids)]
         return sel, pids, ps
 
+    def _gesperrt(self) -> bool:
+        """Erledigte Abrechnung: keine Änderungen (Hinweis statt stillem Nichtstun)."""
+        if self.aid and self.db.erledigt(self.aid):
+            w.info(self.root, "Abrechnung erledigt", "Diese Abrechnung ist als erledigt gekennzeichnet und kann "
+                   "nicht mehr geändert werden.\n\nZum Ändern: Datei > Abrechnung erledigt / wieder öffnen.")
+            return True
+        return False
+
+    def erledigt_umschalten(self):
+        if not self.aid:
+            return
+        titel = self.db.abrechnung(self.aid)["titel"]
+        if self.db.erledigt(self.aid):
+            if not w.frage(self.root, "Wieder öffnen", f"Abrechnung „{titel}“ wieder öffnen?"):
+                return
+            auch = w.frage(self.root, "Wieder öffnen", "Sollen die Positionen auch wieder als NICHT abgerechnet "
+                           "gelten (z. B. um sie neu zu exportieren)?", ja="Ja, freigeben", nein="Nein",
+                           default_ja=False)
+            self.db.erledigt_setzen(self.aid, False, positionen_aufheben=auch)
+        else:
+            if not w.frage(self.root, "Abrechnung erledigt",
+                           f"Abrechnung „{titel}“ als erledigt kennzeichnen?\n\nAlle Händler-Positionen gelten dann "
+                           "als abgerechnet und werden auch in späteren Dateien nicht noch einmal abgerechnet. "
+                           "Die Abrechnung kann danach nicht mehr geändert werden."):
+                return
+            self.db.erledigt_setzen(self.aid, True)
+        self._aktualisieren()
+
+    def abgerechnet_aufheben(self):
+        if self._gesperrt():
+            return
+        _, pids, _ = self._auswahl_info()
+        n = self.db.abrechnung_aufheben(pids)
+        self._aktualisieren()
+        self.status.set("info", f" {n} Position(en) wieder offen")
+
     def prozent(self):
+        if self._gesperrt():
+            return
         sel, pids, ps = self._auswahl_info()
         if not ps:
             w.info(self.root, "Auszahlung", "Bitte zuerst eine Provisionsart (Gruppe) oder einzelne Positionen "
@@ -529,17 +650,18 @@ class App:
             self.ptree.see(vorhanden[0])
 
     def zuruecksetzen(self):
+        if self._gesperrt():
+            return
         sel, pids, ps = self._auswahl_info()
         if not ps:
             return
-        for p in ps:
-            self.db.prozent_anwenden([p["id"]], self.db.prozent_fuer(p["haendler_id"], p["provisionsart"]))
+        self.db.regeln_wiederherstellen([p["id"] for p in ps])
         self.db.touch(self.aid)
         self._aktualisieren()
         self._auswahl_wiederherstellen(sel)
 
     def neu_berechnen(self):
-        if not self.aid:
+        if not self.aid or self._gesperrt():
             return
         manuell = sum(1 for p in self.positionen if p["manuell"])
         auch = False
@@ -567,6 +689,8 @@ class App:
         self.betrag_bearbeiten(iid)
 
     def betrag_bearbeiten(self, iid: str | None = None):
+        if self._gesperrt():
+            return
         if iid is None:
             sel = [i for i in self.ptree.selection() if i.startswith("p")]
             if len(sel) != 1:
@@ -579,10 +703,16 @@ 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 p["abgerechnet"]:
+            w.info(self.root, "Betrag ändern", "Diese Position ist bereits abgerechnet.\n\n"
+                   "Zum Ändern: Rechtsklick > Kennzeichnung „abgerechnet“ aufheben.")
+            return
+        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,27 +761,87 @@ 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="Auszahlung in Prozent…", command=self.prozent)
+            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="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)
+        if any(p["abgerechnet"] for p in ps):
+            m.add_separator()
+            m.add_command(label="Kennzeichnung „abgerechnet“ aufheben", command=self.abgerechnet_aufheben)
         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):
+        if self._gesperrt():
+            return
         sel, pids, _ = self._auswahl_info()
         if not pids:
             w.info(self.root, "Händler zuweisen", "Bitte zuerst Positionen oder eine Gruppe auswählen.")
@@ -667,6 +857,8 @@ class App:
         self._aktualisieren()
 
     def _null(self):
+        if self._gesperrt():
+            return
         sel, pids, _ = self._auswahl_info()
         self.db.prozent_anwenden(pids, 0.0)
         self.db.touch(self.aid)
@@ -679,14 +871,19 @@ class App:
             w.info(self.root, "Export", "Diese Abrechnung enthält noch keine Positionen.\n"
                                         "Bitte zuerst Dateien importieren.")
             return
+        # nur offene Positionen echter Händler (nicht: nicht zugeordnet, eigene, schon abgerechnet)
+        offen = [p for p in self.positionen if p["haendler_id"] > 0 and not p["abgerechnet"] and not p["doppelt"]]
         stat: dict[int, list[int]] = defaultdict(lambda: [0, 0])
-        for p in self.positionen:
-            if p["haendler_id"] != UNZUGEORDNET:
-                stat[p["haendler_id"]][0] += 1
-                stat[p["haendler_id"]][1] += p["betrag"]
+        for p in offen:
+            stat[p["haendler_id"]][0] += 1
+            stat[p["haendler_id"]][1] += p["betrag"]
         if not stat:
-            w.warnung(self.root, "Export", "Keine Position ist einem Händler zugeordnet.\n\n"
-                                           "Lege unter „Händler“ die Unterhändler mit ihren Kennungen an.")
+            if any(p["haendler_id"] > 0 for p in self.positionen):
+                w.info(self.root, "Export", "Alle Positionen dieser Abrechnung sind bereits abgerechnet.\n\n"
+                       "Zum erneuten Export: Datei > Abrechnung erledigt / wieder öffnen (Positionen freigeben).")
+            else:
+                w.warnung(self.root, "Export", "Keine Position ist einem Händler zugeordnet.\n\n"
+                                               "Lege unter „Händler“ die Unterhändler mit ihren Kennungen an.")
             return
         liste = [(hid, self.haendler_namen[hid], n, s) for hid, (n, s) in
                  sorted(stat.items(), key=lambda x: self.haendler_namen[x[0]].lower())]
@@ -696,19 +893,27 @@ class App:
         if not res:
             return
         config.save(self.settings)
-        erzeugt = []
+        erzeugt, exportiert = [], []
+        zeit = res["zeitraum"]
         try:
             for hid in res["ids"]:
-                pos = [p for p in self.positionen if p["haendler_id"] == hid]
+                pos = [p for p in offen if p["haendler_id"] == hid and (zeit is None or zeit.enthaelt(p))]
                 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"])
+                exportiert += pos
         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 ""))
+        hinweis = ""
+        if res["kennzeichnen"] and exportiert:
+            n = self.db.abrechnen([p["id"] for p in exportiert])
+            hinweis = f"\n\n{n} Position(en) als abgerechnet gekennzeichnet."
+            self._aktualisieren()
+        w.info(self.root, "Export", f"{len(erzeugt)} Datei(en) gespeichert in:\n{res['ordner']}"
+               + (f"\nZeitraum: {zeit.text()}" if zeit else "") + "\n\n"
+               + "\n".join(p.name for p in erzeugt[:15]) + ("\n..." if len(erzeugt) > 15 else "") + hinweis)
         if res["oeffnen"]:
             _oeffne_ordner(res["ordner"])
 
@@ -746,67 +951,213 @@ class App:
         self.ansicht = ALLE
         self._aktualisieren()
 
+    def db_wechseln(self, pfad: str | None):
+        """Öffnet (oder legt an) eine andere Datenbank. pfad=None: Standard-Speicherort."""
+        ziel = Path(pfad) if pfad else config.app_dir() / "provisionen.db"
+        db = Datenbank(ziel)  # wirft bei Fehler – alte DB bleibt dann offen
+        self.db.close()
+        self.db = db
+        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):
-        neu = dlg.EinstellungenDialog(self.root, self.settings, str(self.db.path)).zeigen()
-        if neu and Path(neu) != self.db.path:
+        res = dlg.EinstellungenDialog(self.root, self.settings, str(self.db.path)).zeigen()
+        if not res:
+            return
+        if res["design"] != w.DESIGN:
+            self.settings["design"] = res["design"]
+            config.save(self.settings)
+            w.info(self.root, "Einstellungen", "Das neue Design wird beim nächsten Programmstart wirksam.")
+        if res["pfad"] and Path(res["pfad"]) != self.db.path:
             try:
-                db = Datenbank(neu)
+                self.db_wechseln(res["pfad"])
             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
-            config.save(self.settings)
-            abr = self.db.abrechnungen()
-            self.aid = abr[0]["id"] if abr else None
-            self.ansicht = ALLE
-            self._aktualisieren()
 
     def hilfe(self):
         w.info(self.root, "Kurzanleitung",
-               "1.  Händler anlegen (Strg+H): Name, Standard-Auszahlung in % und die Kennungen –\n"
-               "     bei freenet die Unterhändlernummer, bei Vodafone die VO-Nr. oder die Regel\n"
-               "     „Name in GROSSBUCHSTABEN“. Einzelne Positionen: Rechtsklick ▸ Händler zuweisen.\n\n"
+               "1.  Händler anlegen (Strg+H): Name, Standard-Auszahlung in %, Airtime in % (0 % = keine)\n"
+               "     und die Kennungen – bei freenet die Unterhändlernummer, bei Vodafone die VO-Nr.\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"
-               "       (Enter = speichern, ↓/Tab = nächste Zeile, Esc = abbrechen).\n\n"
-               "5.  Exportieren (Strg+E): je Händler eine Excel-Datei im Abrechnungsformat.\n\n"
+               "     - Doppelklick / F2 auf eine Position: Betrag frei ändern\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 (freenet\n"
+               "     und Vodafone zusammen, Airtime als eine Summenzeile) und eine Airtime-Liste.\n"
+               "     Positionen mit 0,00 € werden weggelassen.\n\n"
+               "Zeitraum: Im Export-Dialog „Nur von … bis …“ (oder „Vormonat“). Exportierte Positionen\n"
+               "gelten als abgerechnet (grau) und werden nicht noch einmal abgerechnet – auch nicht, wenn\n"
+               "sie in einer späteren Datei wieder auftauchen. Datei > Abrechnung erledigt sperrt eine\n"
+               "fertige Abrechnung.\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):
-        if not self.db.haendler_liste():
-            if w.frage(self.root, "Willkommen",
-                       f"Willkommen beim {APP_NAME}!\n\nEs sind noch keine Händler angelegt.\n"
-                       "Jetzt die Unterhändler mit ihren Kennungen anlegen?"):
-                self.haendler()
+    def assistent(self):
+        res = ass.Einrichtungsassistent(self).zeigen()
+        if self._schliesst:
+            return  # Programm wird gerade beendet – beim nächsten Start erscheint der Assistent erneut
+        self.settings["assistent_erledigt"] = True
+        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"
+             f"Viel Erfolg mit dem {w.APP_NAME}!"),
+        ]
+        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()} {w.APP_NAME}\n{text}\n")
         except OSError:
             pass
-        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'}")
+        # 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:
+                    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["fenster"] = self.root.geometry()
+            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)
-            self.db.close()
+        except (tk.TclError, OSError):
+            pass
         finally:
-            self.root.destroy()
+            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.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, f"{w.APP_NAME} – 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=w.APP_NAME.replace("-", "-\n", 1), 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"{w.APP_NAME} – 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 {w.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 {w.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")
+        # Büroklammer nur im Win95-Design; modern eine schlichte Glühbirne
+        self._bild = None if w.MODERN else tipp_bild(self)
+        self.bild_ok = self._bild is not None or w.MODERN
+        if self._bild is None:
+            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=max(self._bild.height(), 170) + 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

@@ -4,16 +4,18 @@ from __future__ import annotations
 import tkinter as tk
 from tkinter import filedialog, ttk
 
-from provtool import APP_NAME, APP_ORG, __version__
-from provtool.db import CAPS_ANBIETER, CAPS_WERT, Datenbank, Haendler
+from provtool import APP_ORG, __version__
+from provtool import regeln
+from provtool import zeitraum as zr
+from provtool.db import CAPS_ANBIETER, CAPS_WERT, AbrechnungErledigt, 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
-KENNUNG_ARTEN = {"freenet": "freenet (Unterhändler-Nr.)", "vodafone": "Vodafone (VO-Nr.)",
-                 CAPS_ANBIETER: "Vodafone (Name in GROSSBUCHSTABEN)"}
+# Auswahl im Händler-Dialog: Schlüssel -> Anzeige
+KENNUNG_ARTEN = {"freenet": "freenet (Unterhändler-Nr.)", "vodafone": "Vodafone (VO-Nr.)"}
 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 +53,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 +64,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)
-        self.t_notiz = tk.Text(g, width=36, height=3, font=w.FONT)
-        self.t_notiz.grid(row=4, column=1, columnspan=2, sticky="we", pady=2)
+        tk.Label(g, text="Airtime:", anchor="w").grid(row=4, column=0, sticky="w", pady=2)
+        af = tk.Frame(g, bg=w.FACE)
+        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 +98,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 +126,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 +138,14 @@ class HaendlerDialog(w.Dialog):
         self._liste_laden(auswahl_id)
         if neue_kennung:
             self._neu()
-            self._kennungen = [neue_kennung]
+            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 +153,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.v_kwert.set("")
-        self._ke.configure(state="disabled" if caps else "normal")
+        self._ke.focus_set()
+
+    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,20 +214,23 @@ 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))
+            self.kliste.insert("", "end", iid=str(i), values=(ANBIETER.get(a, a), v))
 
     def _regeln_zeigen(self):
         self.rliste.delete(*self.rliste.get_children())
@@ -177,15 +244,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 +288,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 +373,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 +390,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):
@@ -316,9 +562,9 @@ class AbrechnungenDialog(w.Dialog):
         super().__init__(master, "Abrechnung öffnen", resizable=True)
         self.db = db
         tk.Label(self, text="Gespeicherte Abrechnungen:", anchor="w").pack(fill="x", padx=10, pady=(10, 2))
-        r, self.tree = w.scroll_tree(self, columns=("titel", "geaendert", "anzahl", "dateien"), show="headings",
-                                     height=12, selectmode="browse")
-        for c, t, b in (("titel", "Bezeichnung", 180), ("geaendert", "Zuletzt geändert", 120),
+        r, self.tree = w.scroll_tree(self, columns=("titel", "status", "geaendert", "anzahl", "dateien"),
+                                     show="headings", height=12, selectmode="browse")
+        for c, t, b in (("titel", "Bezeichnung", 180), ("status", "Status", 110), ("geaendert", "Zuletzt geändert", 120),
                         ("anzahl", "Positionen", 70), ("dateien", "Dateien", 260)):
             self.tree.heading(c, text=t)
             self.tree.column(c, width=b, anchor="e" if c == "anzahl" else "w")
@@ -327,7 +573,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())
@@ -336,8 +582,9 @@ class AbrechnungenDialog(w.Dialog):
     def _laden(self, sel=None):
         self.tree.delete(*self.tree.get_children())
         for a in self.db.abrechnungen():
+            status = "erledigt" if a["erledigt"] else (f"{a['abgerechnet']} abgerechnet" if a["abgerechnet"] else "offen")
             self.tree.insert("", "end", iid=str(a["id"]),
-                             values=(a["titel"], a["geaendert"][:16], a["anzahl"], a["dateien"] or ""))
+                             values=(a["titel"], status, a["geaendert"][:16], a["anzahl"], a["dateien"] or ""))
         kids = self.tree.get_children()
         if sel and self.tree.exists(str(sel)):
             self.tree.selection_set(str(sel))
@@ -410,7 +657,11 @@ class DateienDialog(w.Dialog):
         name = self.tree.item(s[0], "values")[0]
         if w.frage(self, "Datei entfernen", f"Alle Positionen aus „{name}“ aus dieser Abrechnung entfernen?\n"
                                             "Von Hand geänderte Beträge dieser Datei gehen verloren.", default_ja=False):
-            self.db.datei_entfernen(int(s[0]))
+            try:
+                self.db.datei_entfernen(int(s[0]))
+            except AbrechnungErledigt as exc:
+                w.info(self, "Datei entfernen", str(exc))
+                return
             self.geaendert = True
             self._laden()
 
@@ -440,7 +691,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,16 +702,82 @@ 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()
+
 
 class KennungZuordnen(w.Dialog):
     """Fragt, ob eine Kennung einem bestehenden oder neuen Händler zugeordnet werden soll."""
@@ -473,7 +790,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 +832,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 +863,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,22 +888,50 @@ 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))
-        self.v_anb = tk.BooleanVar(value=settings.get("export_pro_anbieter", True))
+        w.knopf(g, "Durchsuchen...", self._ordner).grid(row=1, column=2, padx=(4, 0))
+        # 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",
-                       variable=self.v_anb).grid(row=2, column=0, columnspan=3, sticky="w")
-        tk.Checkbutton(g, text="Kopfzeile mit Spaltennamen", variable=self.v_kopf).grid(row=3, column=0, columnspan=3,
-                                                                                         sticky="w")
-        tk.Checkbutton(g, text="Summenzeile unter der Tabelle", variable=self.v_sum).grid(row=4, column=0,
-                                                                                          columnspan=3, sticky="w")
-        tk.Checkbutton(g, text="Ordner nach dem Export öffnen", variable=self.v_auf).grid(row=5, column=0,
-                                                                                          columnspan=3, sticky="w")
+        for zeile, (text, var) in enumerate((
+                ("freenet und Vodafone in getrennte Dateien (sonst beide in einer)", self.v_anb),
+                ("Positionen mit 0,00 € weglassen", self.v_null),
+                ("Kopfzeile mit Spaltennamen", self.v_kopf),
+                ("Summenzeile unter der Tabelle", self.v_sum),
+                ("Ordner nach dem Export öffnen", self.v_auf)), start=2):
+            tk.Checkbutton(g, text=text, variable=var).grid(row=zeile, column=0, 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)
+
+        z = w.gruppe(f, "Zeitraum und Abrechnung")
+        z.pack(fill="x", pady=(8, 0))
+        zf = tk.Frame(z, bg=w.FACE)
+        zf.pack(fill="x")
+        tk.Label(zf, text="Nur von:").pack(side="left")
+        self.v_von, self.v_bis = tk.StringVar(), tk.StringVar()
+        tk.Entry(zf, textvariable=self.v_von, width=11).pack(side="left", padx=4)
+        tk.Label(zf, text="bis:").pack(side="left")
+        tk.Entry(zf, textvariable=self.v_bis, width=11).pack(side="left", padx=4)
+        w.knopf(zf, "Vormonat", self._vormonat).pack(side="left", padx=(4, 0))
+        self.v_basis = tk.StringVar(value=zr.BASEN[settings.get("export_basis", zr.AKTIVIERUNG)])
+        ttk.Combobox(z, textvariable=self.v_basis, values=list(zr.BASEN.values()), state="readonly",
+                     width=40).pack(anchor="w", pady=(4, 0))
+        tk.Label(z, text="(leer = alle offenen Positionen; Datum als TT.MM.JJJJ)", fg=w.SHADOW, anchor="w").pack(
+            fill="x")
+        self.v_kennz = tk.BooleanVar(value=True)
+        tk.Checkbutton(z, text="Exportierte Positionen als abgerechnet kennzeichnen (werden dann nicht noch "
+                               "einmal abgerechnet)", variable=self.v_kennz, anchor="w").pack(fill="x", pady=(4, 0))
         self.knopfleiste([("Exportieren", self._ok), ("Abbrechen", self.abbrechen)]).pack(pady=(0, 10))
 
+    def _vormonat(self):
+        von, bis = zr.vormonat()
+        self.v_von.set(von.strftime("%d.%m.%Y"))
+        self.v_bis.set(bis.strftime("%d.%m.%Y"))
+
     def _klick(self, e):
         if self.tree.identify_column(e.x) == "#0":
             iid = self.tree.identify_row(e.y)
@@ -613,15 +958,26 @@ class ExportDialog(w.Dialog):
         if not ids:
             w.warnung(self, "Export", "Bitte mindestens einen Händler anhaken.")
             return
+        try:
+            von, bis = zr.datum_lesen(self.v_von.get()), zr.datum_lesen(self.v_bis.get())
+        except ValueError as exc:
+            w.warnung(self, "Zeitraum", str(exc))
+            return
+        basis = next(k for k, v in zr.BASEN.items() if v == self.v_basis.get())
         if not self.v_ordner.get().strip():
             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(),
-                             export_kopfzeile=self.v_kopf.get(), export_summe=self.v_sum.get())
+        self.settings.update(export_ordner=self.v_ordner.get().strip(), export_anbieter_getrennt=self.v_anb.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(),
-                           oeffnen=self.v_auf.get())
+                           pro_anbieter=self.v_anb.get(), null_weglassen=self.v_null.get(),
+                           kopfzeile=self.v_kopf.get(), summe=self.v_sum.get(), oeffnen=self.v_auf.get(),
+                           zeitraum=zr.Zeitraum(von, bis, basis) if (von or bis) else None,
+                           kennzeichnen=self.v_kennz.get())
+        self.settings["export_basis"] = basis
         self.destroy()
 
 
@@ -637,10 +993,17 @@ 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_design = tk.StringVar(value=settings.get("design", "modern"))
+        tk.Radiobutton(g2, text="Modern (wie Windows 11)", variable=self.v_design, value="modern").pack(anchor="w")
+        tk.Radiobutton(g2, text="Klassisch (Windows 95, Legacy)", variable=self.v_design, value="win95").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 +1014,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(), design=self.v_design.get())
         self.destroy()
 
 
@@ -659,7 +1022,7 @@ class EinstellungenDialog(w.Dialog):
 
 class InfoDialog(w.Dialog):
     def __init__(self, master):
-        super().__init__(master, f"Info über {APP_NAME}")
+        super().__init__(master, f"Info über {w.APP_NAME}")
         top = tk.Frame(self, bg=w.FACE)
         top.pack(padx=14, pady=14)
         c = tk.Canvas(top, width=110, height=110, bg=w.TEAL, bd=2, relief="sunken", highlightthickness=0)
@@ -668,7 +1031,7 @@ class InfoDialog(w.Dialog):
         c.create_image(57, 57, image=self._img)
         rechts = tk.Frame(top, bg=w.FACE)
         rechts.pack(side="left", padx=(14, 0), anchor="n")
-        tk.Label(rechts, text=APP_NAME, font=w.FONT_BIG).pack(anchor="w")
+        tk.Label(rechts, text=w.APP_NAME, font=w.FONT_BIG).pack(anchor="w")
         tk.Label(rechts, text=f"Version {__version__}", anchor="w").pack(anchor="w")
         w.trenner(rechts, vertikal=False).pack(fill="x", pady=8)
         tk.Label(rechts, text=f"Lizenziert für:\n{APP_ORG}\n\nProvisionsabrechnung für Unterhändler\n"

provtool/gui/menue.py

@@ -0,0 +1,304 @@
+"""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")
+        if w.MODERN:
+            f.configure(bg=w.WHITE, bd=0, relief="flat", highlightthickness=1, highlightbackground=w.RAND)
+        f.withdraw()
+        f.overrideredirect(True)
+        self.zeilen = []
+        grund, py = (w.WHITE, 4) if w.MODERN else (w.FACE, 2)
+        for e in self.eintraege:
+            if e["art"] == "trenner":
+                t = tk.Frame(f, bg=grund, 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=grund)
+            zeile.pack(fill="x")
+            grau = e["state"] == "disabled"
+            text = tk.Label(zeile, text=e["label"], bg=grund, anchor="w", padx=18, pady=py,
+                            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=grund, anchor="e", padx=12, pady=py,
+                               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.SEL_BG if an else (w.WHITE if w.MODERN else w.FACE)
+            fg = w.SEL_FG 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.SEL_BG, fg=w.SEL_FG, 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:
+            if w.MODERN:
+                knopf.configure(bg=w.LIGHT if drin else w.FACE)
+            else:
+                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,285 @@
+"""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: Den Größen-Mauszeiger am Rand zeigt Tk (rahmen.py) – so weiß Tk immer, welcher Zeiger
+  gilt, und setzt ihn beim Zurückfahren in das Fenster wieder richtig. Beim Drücken auf den Rand zieht
+  Windows die Größe (flüssig).
+
+WICHTIG:
+- Die Fensterprozeduren hier laufen mitten in Tk. Sie dürfen Tk NICHT aufrufen (Tk-Sperre ->
+  Verklemmung), nur Win32-Funktionen.
+- Verschieben/Größe ziehen NIE synchron (SendMessage) aus einem Tk-Ereignis heraus starten: Windows
+  läuft dann in einer eigenen Schleife, in der Tk Python-Ereignisse (z. B. <Configure>) ausführt,
+  während Python das nicht erwartet -> harter Absturz („PyEval_RestoreThread … thread state is
+  NULL“). Deshalb PostMessage: Die Schleife startet, sobald Tk wieder in seiner Ereignisschleife ist.
+"""
+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 = 0x00A1, 0x0112
+HTCLIENT, HTCAPTION = 1, 2
+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
+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)):
+        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."""
+
+    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
+
+    # ------------------------------------------------------------------ Einrichten
+    def einrichten(self) -> bool:
+        """Sobald Tk das äußere Windows-Fenster angelegt hat (möglichst vor dem ersten Anzeigen)."""
+        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
+            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) -> bool:
+        self.aktiv = False
+        return self.einrichten()
+
+    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_NCDESTROY:
+                self._entfernen(hwnd)
+        except Exception:  # niemals eine Ausnahme in die Fensterprozedur durchlassen
+            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).
+        PostMessage, nicht SendMessage – siehe Modulbeschreibung."""
+        u, _ = _api()
+        u.ReleaseCapture()
+        u.PostMessageW(self.hwnd, WM_NCLBUTTONDOWN, HTCAPTION, 0)
+
+    def groesse_ziehen(self, rand: str) -> None:
+        u, _ = _api()
+        u.ReleaseCapture()
+        u.PostMessageW(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 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,552 @@
+"""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
+        self.nativ = None
+        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))
+
+        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()
+        else:
+            ok = self.nativ.einrichten()
+        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:
+            self._cursor_zurueck()
+            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:
+            # Den Zeiger zeigt Tk (weiß dann immer, welcher gilt); ziehen lässt Windows (flüssig,
+            # mit Andocken). Angestoßen per PostMessage – siehe nativ.py.
+            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,207 @@
+"""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.PostMessageW.argtypes = [wintypes.HWND, wintypes.UINT, wintypes.WPARAM, wintypes.LPARAM]
+        u.PostMessageW.restype = wintypes.BOOL
+        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()
+    # PostMessage statt SendMessage: Die Verschiebe-Schleife von Windows darf nicht innerhalb eines
+    # Tk-Ereignisses laufen (Tk führt darin Python-Ereignisse aus -> harter Absturz, siehe nativ.py).
+    user32().PostMessageW(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

@@ -1,8 +1,13 @@
-"""Windows-95-Optik für Tkinter: Farben, Schriften, Pixel-Icons und ein paar Bausteine."""
+"""Optik für Tkinter: Farben, Schriften, Pixel-Icons und ein paar Bausteine.
+
+Zwei Designs: „modern“ (hell und flach, wie Windows 11 – Standard) und „win95“ (klassisch, Legacy).
+design_setzen() muss VOR dem Aufbau der Oberfläche laufen; alle Module lesen die Farben als w.FACE usw.
+"""
 from __future__ import annotations
 
 import sys
 import tkinter as tk
+from pathlib import Path
 from tkinter import ttk
 
 FACE = "#c0c0c0"
@@ -14,6 +19,20 @@ NAVY = "#000080"
 TEAL = "#008080"
 WHITE = "#ffffff"
 INFO_BG = "#ffffe1"
+SEL_BG, SEL_FG = NAVY, WHITE   # Auswahl/Markierung
+RAND = SHADOW                  # dünne Rahmenlinien (nur modern)
+DESIGN = "win95"
+MODERN = False
+APP_NAME = "Provisions-Manager 95"   # modern: ohne „95“
+
+_PALETTEN = {
+    "win95": dict(FACE="#c0c0c0", HILITE="#ffffff", LIGHT="#dfdfdf", SHADOW="#808080", DARK="#000000",
+                  NAVY="#000080", TEAL="#008080", WHITE="#ffffff", INFO_BG="#ffffe1", SEL_BG="#000080",
+                  SEL_FG="#ffffff", RAND="#808080"),
+    "modern": dict(FACE="#f3f3f3", HILITE="#ffffff", LIGHT="#ebebeb", SHADOW="#8a8a8a", DARK="#1b1b1b",
+                   NAVY="#005fb8", TEAL="#e6eef6", WHITE="#ffffff", INFO_BG="#ffffff", SEL_BG="#cce4f7",
+                   SEL_FG="#1b1b1b", RAND="#d1d1d1"),
+}
 
 IS_WIN = sys.platform.startswith("win")
 FONT_FAMILY = "MS Sans Serif" if IS_WIN else "DejaVu Sans"
@@ -23,6 +42,25 @@ FONT_BOLD = (FONT_FAMILY, FONT_SIZE, "bold")
 FONT_BIG = (FONT_FAMILY, FONT_SIZE + 4, "bold")
 FONT_MONO = ("Courier New" if IS_WIN else "DejaVu Sans Mono", FONT_SIZE + 1)
 
+
+def design_setzen(name: str) -> None:
+    """„modern“ oder „win95“ – setzt Farben und Schriften (Feinschliff der Schrift in apply())."""
+    global DESIGN, MODERN, FONT_FAMILY, FONT_SIZE, APP_NAME
+    DESIGN = name if name in _PALETTEN else "modern"
+    MODERN = DESIGN == "modern"
+    APP_NAME = "Provisions-Manager" if MODERN else "Provisions-Manager 95"
+    globals().update(_PALETTEN[DESIGN])
+    FONT_FAMILY = ("Segoe UI" if MODERN else "MS Sans Serif") if IS_WIN else "DejaVu Sans"
+    FONT_SIZE = 9 if (MODERN or not IS_WIN) else 8
+    _schriften()
+
+
+def _schriften():
+    global FONT, FONT_BOLD, FONT_BIG
+    FONT = (FONT_FAMILY, FONT_SIZE)
+    FONT_BOLD = (FONT_FAMILY, FONT_SIZE, "bold")
+    FONT_BIG = (FONT_FAMILY, FONT_SIZE + 4, "bold")
+
 # --------------------------------------------------------------------------- Pixel-Icons (16x16)
 PALETTE = {
     "k": "#000000", "w": "#ffffff", "g": "#c0c0c0", "d": "#808080", "y": "#ffff00", "Y": "#808000",
@@ -218,6 +256,23 @@ ICONS = {
     ...kkwwwwwwkk...
     .....kkkkkkk....
     ................""",
+    "birne": """
+    .....kkkkk......
+    ....kyyyyyk.....
+    ...kyywwyyyk....
+    ..kyywwyyyyyk...
+    ..kywwyyyyyyk...
+    ..kyyyyyyyyyk...
+    ..kyyyyyyyyyk...
+    ...kyyyyyyyk....
+    ....kyyyyyk.....
+    .....kyyyk......
+    .....kdddk......
+    .....kgggk......
+    .....kdddk......
+    .....kgggk......
+    ......kkk.......
+    ................""",
     "app": """
     ................
     .....kkkkkkk....
@@ -243,7 +298,13 @@ def _icon_rows(name: str) -> list[str]:
     return [r.ljust(16, ".")[:16] for r in rows[:16]] + ["." * 16] * (16 - len(rows))
 
 
+MODERNE_ICONS = Path(__file__).resolve().parent / "bilder" / "modern"
+
+
 def make_icon(master, name: str, scale: int = 1) -> tk.PhotoImage:
+    datei = MODERNE_ICONS / f"{name}{'_gross' if scale > 1 else ''}.png"
+    if MODERN and datei.exists():  # glatte Symbole aus build/make_moderne_icons.py
+        return tk.PhotoImage(master=master, file=str(datei))
     img = tk.PhotoImage(master=master, width=16 * scale, height=16 * scale)
     for y, row in enumerate(_icon_rows(name)):
         for x, ch in enumerate(row):
@@ -271,12 +332,22 @@ class Icons:
 # --------------------------------------------------------------------------- Theme
 
 def apply(root: tk.Tk) -> None:
+    global FONT_FAMILY
+    if MODERN and not IS_WIN:  # Linux: die erste vorhandene moderne Schrift
+        from tkinter import font as tkfont
+        vorhanden = set(tkfont.families(root))
+        FONT_FAMILY = next((f for f in ("Segoe UI", "Noto Sans", "Cantarell", "Ubuntu", "DejaVu Sans")
+                            if f in vorhanden), FONT_FAMILY)
+        _schriften()
     root.configure(bg=FACE)
     o = root.option_add
     o("*Font", FONT)
     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 +376,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,
@@ -322,6 +394,117 @@ def apply(root: tk.Tk) -> None:
            selectforeground=[("readonly", DARK)])
     st.configure("TPanedwindow", background=FACE)
     st.configure("Sash", sashthickness=6, background=FACE)
+    if MODERN:
+        _modern(root, st, zeile)
+
+
+def _modern(root: tk.Tk, st: ttk.Style, zeile: int) -> None:
+    """Flach und hell: dünne graue Rahmen statt 3D-Kanten, Akzentfarbe beim Fokus."""
+    o = root.option_add
+    for klasse in ("Entry", "Text", "Listbox", "Spinbox"):
+        o(f"*{klasse}.relief", "flat")
+        o(f"*{klasse}.borderWidth", 3)
+        o(f"*{klasse}.highlightThickness", 1)
+        o(f"*{klasse}.highlightBackground", RAND)
+        o(f"*{klasse}.highlightColor", NAVY)
+    o("*Button.relief", "flat")
+    o("*Button.borderWidth", 0)
+    o("*Button.highlightThickness", 1)
+    o("*Button.highlightBackground", RAND)
+    o("*Button.background", WHITE)
+    o("*Button.activeBackground", SEL_BG)
+    o("*Button.padY", 3)
+    o("*Checkbutton.activeBackground", FACE)
+    o("*Radiobutton.activeBackground", FACE)
+    o("*Menu.relief", "flat")
+    st.theme_use("clam")
+    st.configure(".", background=FACE, foreground=DARK, font=FONT, troughcolor=FACE, selectbackground=SEL_BG,
+                 selectforeground=SEL_FG, fieldbackground=WHITE, bordercolor=RAND, lightcolor=WHITE,
+                 darkcolor=RAND, focuscolor=NAVY)
+    st.configure("Treeview", background=WHITE, fieldbackground=WHITE, rowheight=zeile + 4, borderwidth=0, font=FONT)
+    st.map("Treeview", background=[("selected", SEL_BG)], foreground=[("selected", SEL_FG)])
+    st.configure("Treeview.Heading", background=WHITE, relief="flat", borderwidth=1, font=FONT, padding=(6, 3),
+                 bordercolor=RAND, lightcolor=WHITE, darkcolor=RAND)
+    st.map("Treeview.Heading", background=[("active", LIGHT)], relief=[("pressed", "flat")])
+    st.configure("TScrollbar", background=LIGHT, troughcolor=FACE, arrowcolor=SHADOW, bordercolor=FACE,
+                 lightcolor=LIGHT, darkcolor=LIGHT, relief="flat", arrowsize=12, width=12)
+    st.map("TScrollbar", background=[("active", RAND)])
+    st.configure("TCombobox", fieldbackground=WHITE, background=WHITE, arrowcolor=DARK, padding=3,
+                 bordercolor=RAND, lightcolor=WHITE, darkcolor=WHITE)
+    st.map("TCombobox", fieldbackground=[("readonly", WHITE)], selectbackground=[("readonly", WHITE)],
+           selectforeground=[("readonly", DARK)], bordercolor=[("focus", NAVY)])
+
+
+# --------------------------------------------------------------------------- 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
@@ -330,6 +513,8 @@ class Sunken(tk.Frame):
     """Eingelassener Rahmen (Doppellinie wie bei Win95-Listen)."""
 
     def __init__(self, master, **kw):
+        if MODERN:
+            kw.update(bd=0, relief="flat", highlightthickness=1, highlightbackground=RAND)
         kw.setdefault("bd", 2)
         kw.setdefault("relief", "sunken")
         super().__init__(master, **kw)
@@ -339,6 +524,15 @@ class Fenster(tk.Frame):
     """Ein „Fenster im Fenster“ mit blauer Titelleiste – reine Optik, gliedert die Oberfläche."""
 
     def __init__(self, master, titel: str, icon: tk.PhotoImage | None = None, **kw):
+        if MODERN:  # schlichte Überschrift statt blauer Titelleiste
+            super().__init__(master, bd=0, bg=FACE, **kw)
+            self.titel_var = tk.StringVar(value=titel)
+            self.titelleiste = tk.Label(self, textvariable=self.titel_var, bg=FACE, fg=DARK, font=FONT_BOLD,
+                                        anchor="w")
+            self.titelleiste.pack(fill="x", pady=(0, 4))
+            self.inhalt = tk.Frame(self, bg=FACE)
+            self.inhalt.pack(fill="both", expand=True)
+            return
         super().__init__(master, bd=2, relief="raised", bg=FACE, **kw)
         self.titelleiste = tk.Frame(self, bg=NAVY, height=18)
         self.titelleiste.pack(fill="x", padx=1, pady=1)
@@ -360,7 +554,7 @@ class Statusleiste(tk.Frame):
         self.vars: dict[str, tk.StringVar] = {}
         for i, (key, breite) in enumerate(felder):
             v = tk.StringVar()
-            lbl = tk.Label(self, textvariable=v, bd=1, relief="sunken", anchor="w", padx=4)
+            lbl = tk.Label(self, textvariable=v, bd=1, relief="flat" if MODERN else "sunken", anchor="w", padx=4)
             if breite:
                 lbl.configure(width=breite)
                 lbl.pack(side="left", padx=(0, 2), pady=2)
@@ -373,8 +567,11 @@ class Statusleiste(tk.Frame):
 
 
 def knopf(master, text: str, command=None, icon: tk.PhotoImage | None = None, breite: int | None = None, **kw):
-    b = tk.Button(master, text=text, command=command, bd=2, relief="raised", bg=FACE,
-                  activebackground=FACE, **kw)
+    if MODERN:
+        b = tk.Button(master, text=text, command=command, **kw)  # Aussehen aus apply()/_modern()
+    else:
+        b = tk.Button(master, text=text, command=command, bd=2, relief="raised", bg=FACE,
+                      activebackground=FACE, **kw)
     if icon is not None:
         b.configure(image=icon, compound="left", padx=6)
     if breite:
@@ -389,6 +586,15 @@ class ToolbarButton(tk.Label):
         super().__init__(master, text=text, image=icon, compound="top", bd=1, relief="flat", bg=FACE,
                          padx=6, pady=2, font=FONT)
         self.command = command
+        if MODERN:  # Hervorhebung durch Farbe statt 3D-Kante
+            self.configure(bd=0, padx=8, pady=4)
+            self.bind("<Enter>", lambda e: self.configure(bg=LIGHT))
+            self.bind("<Leave>", lambda e: self.configure(bg=FACE))
+            self.bind("<ButtonPress-1>", lambda e: self.configure(bg=SEL_BG))
+            self.bind("<ButtonRelease-1>", self._release)
+            if tooltip:
+                Tooltip(self, tooltip)
+            return
         self.bind("<Enter>", lambda e: self.configure(relief="raised"))
         self.bind("<Leave>", lambda e: self.configure(relief="flat"))
         self.bind("<ButtonPress-1>", lambda e: self.configure(relief="sunken"))
@@ -397,7 +603,7 @@ class ToolbarButton(tk.Label):
             Tooltip(self, tooltip)
 
     def _release(self, e):
-        self.configure(relief="raised")
+        self.configure(bg=LIGHT) if MODERN else self.configure(relief="raised")
         if 0 <= e.x < self.winfo_width() and 0 <= e.y < self.winfo_height() and self.command:
             self.command()
 
@@ -417,8 +623,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:
@@ -431,6 +641,10 @@ class Tooltip:
 
 def trenner(master, vertikal: bool = True):
     f = tk.Frame(master, bg=FACE)
+    if MODERN:
+        tk.Frame(f, width=1, height=1, bg=RAND).pack(side="left", fill="y") if vertikal else \
+            tk.Frame(f, height=1, bg=RAND).pack(fill="x")
+        return f
     if vertikal:
         tk.Frame(f, width=1, bg=SHADOW).pack(side="left", fill="y")
         tk.Frame(f, width=1, bg=HILITE).pack(side="left", fill="y")
@@ -441,6 +655,8 @@ def trenner(master, vertikal: bool = True):
 
 
 def gruppe(master, titel: str, **kw) -> tk.LabelFrame:
+    if MODERN:
+        return tk.LabelFrame(master, text=titel, bd=0, relief="flat", bg=FACE, padx=4, pady=2, font=FONT_BOLD, **kw)
     return tk.LabelFrame(master, text=titel, bd=2, relief="groove", bg=FACE, padx=6, pady=4, **kw)
 
 
@@ -480,40 +696,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)
-        self.transient(master.winfo_toplevel())
+        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.grab_set()
-        except tk.TclError:
-            pass
+        self.focus_force()
         (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,193 @@
+"""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)
+        # Win95-Design: prüft auch den nativen Fensterrahmen (Szenario 1 läuft im modernen Standard)
+        s = _Szenario("Assistent, Import, Export (Win95)", basis / "b", '{"design": "win95"}')
+        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"))

provtool/zeitraum.py

@@ -0,0 +1,94 @@
+"""Zeitraum für Ansicht und Export: nur Positionen von–bis abrechnen.
+
+Bezugsdatum einer Position („basis“):
+- ``aktivierung``  – Aktivierungs-/Anschaltdatum der Position (Spalte „Datum“)
+- ``abrechnung``   – Abrechnungszeitraum des Anbieters: bei freenet der Beginn der Abrechnungswoche
+                     („2026.10.01-2026.10.07“), bei Vodafone der Monat des Abrechnungslaufs („VF2609“,
+                     „CY202609UM“ -> 1.9.2026). Ist er nicht lesbar, gilt das Aktivierungsdatum.
+"""
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from datetime import date, timedelta
+
+AKTIVIERUNG, ABRECHNUNG = "aktivierung", "abrechnung"
+BASEN = {AKTIVIERUNG: "nach Aktivierungsdatum", ABRECHNUNG: "nach Abrechnungszeitraum des Anbieters"}
+
+
+@dataclass(frozen=True)
+class Zeitraum:
+    von: date | None = None
+    bis: date | None = None
+    basis: str = AKTIVIERUNG
+
+    def enthaelt(self, p: dict) -> bool:
+        d = bezugsdatum(p, self.basis)
+        if d is None:
+            return False  # ohne Datum lässt sich nicht sagen, ob sie dazugehört
+        return (self.von is None or d >= self.von) and (self.bis is None or d <= self.bis)
+
+    def text(self) -> str:
+        von = self.von.strftime("%d.%m.%Y") if self.von else "Anfang"
+        bis = self.bis.strftime("%d.%m.%Y") if self.bis else "heute"
+        return f"{von} – {bis} ({BASEN[self.basis]})"
+
+
+def datum_lesen(text: str) -> date | None:
+    """'1.10.2026', '01.10.26', '2026-10-01' -> date; leer -> None; sonst ValueError."""
+    s = (text or "").strip()
+    if not s:
+        return None
+    m = re.fullmatch(r"(\d{1,2})\.(\d{1,2})\.(\d{2}|\d{4})", s)
+    if m:
+        t, mo, j = (int(x) for x in m.groups())
+        if j < 100:
+            j += 2000
+        return date(j, mo, t)
+    m = re.fullmatch(r"(\d{4})-(\d{1,2})-(\d{1,2})", s)
+    if m:
+        return date(*(int(x) for x in m.groups()))
+    raise ValueError(f"Kein gültiges Datum: {text!r} (bitte TT.MM.JJJJ)")
+
+
+def abrechnungsdatum(zeitraum: str | None) -> date | None:
+    s = (zeitraum or "").strip()
+    m = re.match(r"(\d{4})\.(\d{2})\.(\d{2})", s)  # freenet: 2026.10.01-2026.10.07
+    if m:
+        try:
+            return date(*(int(x) for x in m.groups()))
+        except ValueError:
+            return None
+    m = re.match(r"(?:VF|CY)(\d{4}|\d{2})(\d{2})", s.upper())  # Vodafone: VF2609, CY202609UM
+    if m:
+        j, mo = int(m.group(1)), int(m.group(2))
+        if j < 100:
+            j += 2000
+        if 1 <= mo <= 12:
+            return date(j, mo, 1)
+    return None
+
+
+def bezugsdatum(p: dict, basis: str) -> date | None:
+    if basis == ABRECHNUNG:
+        d = abrechnungsdatum(p.get("zeitraum"))
+        if d is not None:
+            return d
+    if p.get("datum"):
+        try:
+            return date.fromisoformat(p["datum"])
+        except ValueError:
+            return None
+    return None
+
+
+def vormonat(heute: date | None = None) -> tuple[date, date]:
+    heute = heute or date.today()
+    ende = heute.replace(day=1) - timedelta(days=1)
+    return ende.replace(day=1), ende
+
+
+def dieser_monat(heute: date | None = None) -> tuple[date, date]:
+    heute = heute or date.today()
+    naechster = (heute.replace(day=28) + timedelta(days=4)).replace(day=1)
+    return heute.replace(day=1), naechster - timedelta(days=1)

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,22 @@ 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"]
+    zeilen1 = [r for r in openpyxl.load_workbook(eine[0]).active.iter_rows(values_only=True) if r[1]]
+    arten = [r[1] for r in zeilen1]
+    assert "Freischaltungsvergütung Vodafone" in arten and "SIM-Karten" in arten
+    # Spalte A: Vodafone mit Aktivierungsdatum, freenet mit Zeitraum
+    vf = next(r for r in zeilen1 if r[1] == "Freischaltungsvergütung Vodafone")
+    assert vf[0] == datetime(2026, 9, 8)
+    assert next(r for r in zeilen1 if r[1] == "SIM-Karten")[0] == "2026.10.01-2026.10.07"
+    ws1 = openpyxl.load_workbook(eine[0]).active
+    zeile_vf = next(c.row for c in ws1["B"] if c.value == "Freischaltungsvergütung Vodafone")
+    assert ws1.cell(zeile_vf, 1).number_format == "DD.MM.YYYY"
     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 +278,240 @@ 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()
+
+
+# --------------------------------------------------------------------------- Zeitraum / abgerechnet / erledigt
+
+def test_zeitraum_lesen_und_bezugsdatum():
+    from datetime import date
+    from provtool import zeitraum as zr
+    assert zr.datum_lesen("1.10.2026") == date(2026, 10, 1) and zr.datum_lesen("01.10.26") == date(2026, 10, 1)
+    assert zr.datum_lesen("") is None
+    with pytest.raises(ValueError):
+        zr.datum_lesen("32.13.2026")
+    assert zr.abrechnungsdatum("2026.10.08-2026.10.15") == date(2026, 10, 8)
+    assert zr.abrechnungsdatum("VF2609") == date(2026, 9, 1) == zr.abrechnungsdatum("CY202609UM")
+    assert zr.abrechnungsdatum("VF2609P6     Fil 0") == date(2026, 9, 1)
+    p = {"zeitraum": "VF2609", "datum": "2026-08-30"}
+    assert zr.bezugsdatum(p, zr.AKTIVIERUNG) == date(2026, 8, 30)
+    assert zr.bezugsdatum(p, zr.ABRECHNUNG) == date(2026, 9, 1)
+    okt = zr.Zeitraum(date(2026, 10, 1), date(2026, 10, 31))
+    assert okt.enthaelt({"datum": "2026-10-31"}) and not okt.enthaelt({"datum": "2026-11-01"})
+    assert not okt.enthaelt({"datum": None})
+    assert zr.vormonat(date(2026, 3, 15)) == (date(2026, 2, 1), date(2026, 2, 28))
+    assert zr.dieser_monat(date(2026, 12, 5)) == (date(2026, 12, 1), date(2026, 12, 31))
+
+
+def test_abgerechnet_einfrieren_und_doppelt_erkennen(db, freenet_csv):
+    from provtool.db import AbrechnungErledigt
+    hid = db.haendler_speichern(Haendler(0, "A"), [("freenet", "111")])
+    a1 = db.abrechnung_neu("Okt")
+    db.importieren(a1, lies_datei(freenet_csv))
+    pos = [p for p in db.positionen(a1) if p["haendler_id"] == hid]
+    assert len(pos) == 4 and all(p["fp"] for p in pos)
+    erste = pos[:2]
+    assert db.abrechnen([p["id"] for p in erste]) == 2
+    # abgerechnet: Betrag und Händler eingefroren
+    h = db.haendler(hid)
+    h.standard_prozent = 50
+    db.haendler_speichern(h, [])  # Kennung weg, 50 %
+    db.neu_berechnen(a1)
+    nach = {p["id"]: p for p in db.positionen(a1)}
+    for p in erste:
+        assert nach[p["id"]]["haendler_id"] == hid and nach[p["id"]]["betrag"] == p["betrag"]
+    with pytest.raises(AbrechnungErledigt):
+        db.betrag_setzen(erste[0]["id"], 1)
+    assert db.prozent_anwenden([erste[0]["id"]], 10) == 0
+
+    # dieselbe Datei in einer neuen Abrechnung: die beiden abgerechneten Positionen sind „doppelt“
+    db.haendler_speichern(db.haendler(hid), [("freenet", "111")])
+    a2 = db.abrechnung_neu("Nov")
+    db.importieren(a2, lies_datei(freenet_csv))
+    doppelt = [p for p in db.positionen(a2) if p["doppelt"]]
+    assert len(doppelt) == 2 and all(p["doppelt"] == "Okt" for p in doppelt)
+    assert db.abrechnen([p["id"] for p in doppelt]) == 0, "doppelte Positionen dürfen nicht erneut abgerechnet werden"
+
+    # Kennzeichnung aufheben -> nicht mehr doppelt
+    assert db.abrechnung_aufheben([p["id"] for p in erste]) == 2
+    assert not any(p["doppelt"] for p in db.positionen(a2))
+
+
+def test_abrechnung_erledigt_sperrt(db, freenet_csv):
+    from provtool.db import AbrechnungErledigt
+    hid = db.haendler_speichern(Haendler(0, "A"), [("freenet", "111")])
+    aid = db.abrechnung_neu("Okt")
+    db.importieren(aid, lies_datei(freenet_csv))
+    assert db.erledigt_setzen(aid, True) == 4  # nur die 4 Händler-Positionen, nicht die unzugeordnete
+    assert db.erledigt(aid)
+    assert all(p["abgerechnet"] for p in db.positionen(aid) if p["haendler_id"] == hid)
+    with pytest.raises(AbrechnungErledigt):
+        db.importieren(aid, lies_datei(freenet_csv))
+    with pytest.raises(AbrechnungErledigt):
+        db.datei_entfernen(db.dateien(aid)[0]["id"])
+    unz = next(p for p in db.positionen(aid) if p["haendler_id"] <= 0)
+    db.haendler_zuweisen([unz["id"]], hid)
+    assert next(p for p in db.positionen(aid) if p["id"] == unz["id"])["haendler_id"] <= 0, "erledigt: keine Änderung"
+    assert db.abrechnungen()[0]["abgerechnet"] == 4
+    # wieder öffnen, Positionen bleiben abgerechnet bzw. werden auf Wunsch freigegeben
+    db.erledigt_setzen(aid, False)
+    assert not db.erledigt(aid) and all(p["abgerechnet"] for p in db.positionen(aid) if p["haendler_id"] == hid)
+    db.erledigt_setzen(aid, True)
+    db.erledigt_setzen(aid, False, positionen_aufheben=True)
+    assert not any(p["abgerechnet"] for p in db.positionen(aid))
+
+
+def test_migration_v3_fingerabdruck(tmp_path, freenet_csv):
+    import sqlite3
+    d = Datenbank(tmp_path / "x.db")
+    aid = d.abrechnung_neu("Alt")
+    d.importieren(aid, lies_datei(freenet_csv))
+    d.close()
+    con = sqlite3.connect(tmp_path / "x.db")  # wie eine v3-Datenbank: ohne Fingerabdrücke
+    con.execute("UPDATE position SET fp=NULL")
+    con.commit()
+    con.close()
+    d = Datenbank(tmp_path / "x.db")
+    assert all(p["fp"] for p in d.positionen(aid))
+    assert len({p["fp"] for p in d.positionen(aid)}) == 5
+    d.close()