rechnungstool/hinweis.py

# -*- coding: utf-8 -*-
"""Der Hinweis auf die Erprobungsfassung - und die Kenntnisnahme des Nutzers.

WARUM ES DAS GIBT
-----------------
Beide Programme schreiben Belege, die steuerlich zaehlen. Solange sie erprobt
werden, muss der Betreiber wissen, woran er ist: dass es eine Erprobungsfassung
ist, dass fuer falsch ausgestellte Belege nicht gehaftet wird, und dass er jeden
Beleg vor dem Herausgeben SELBST ansehen muss - dafuer gibt es die Vorschau.

Sein Wortlaut (06.09.2026):

    "bei jedem oeffnen, solange wir die testen, ein popup, dass dies eine
     experimentelle software ist und ich keine haftung fuer irgendwelche falsch
     ausgestellten uebernehme. der user muss selbst pruefen ueber den vorschau
     button auf beiden tools, ob das alles seine richtigkeit hat. wenn nicht,
     auf dem link eine issue erstellen. und das alles auch noch mal in die info
     mit signatur: user hat dies gelesen und zur kenntnis genommen. wenn er nein
     drueckt oder ablehnt, schliesst sich die software und geht beim naechsten
     start wieder mit dem selben auf, bis er auf ja drueckt."

WIE ES WIRKT
------------
* Beim Start kommt der Hinweis, BEVOR gearbeitet werden kann.
* "Nein" beendet das Programm. Es wird nichts geschrieben, nichts gespeichert.
* "Ja" wird mit Benutzername, Zeitpunkt und Fassung in der Konfiguration
  vermerkt - das ist die Signatur. Danach kommt der Hinweis nicht mehr.
* Aendert sich der TEXT (also FASSUNG), wird erneut gefragt. Eine Zustimmung
  gilt fuer das, was dagestanden hat, nicht fuer alles Kuenftige.
* Unter "Info" steht derselbe Text dauerhaft, mit der Signaturzeile darunter.

Diese Datei liegt in BEIDEN Programmen gleich. Wer sie aendert, kopiert sie
hinueber - sonst steht in zwei Programmen zweierlei.
"""

import datetime
import getpass

# Fassung des HINWEISTEXTES, nicht des Programms. Wird der Text geaendert,
# gehoert dieses Datum mitgeaendert - dann wird die Kenntnisnahme neu eingeholt.
FASSUNG = "2026-09-06"

# Wo Fehler gemeldet werden. Je Programm eine eigene Adresse.
#
# Das frueher "Beherbergungssteuer" genannte Programm heisst seit dem
# 06.09.2026 STEUERRECHNUNGSTOOL - so wie sein Repository. Der lokale Ordner
# heisst noch beherbergungssteuer: der Pfad steht in mehreren Pruefstaenden und
# in den Spec-Dateien fest, das ist ein eigener Schritt.
ISSUES = {
    "rechnungstool": "https://git.pcore.de/TheMockTv/rechnungstool",
    "steuerrechnungstool": "https://git.pcore.de/TheMockTv/Steuerrechnungstool",
}

TITEL = "Erprobungsfassung – bitte lesen"


def text(programm):
    """Der Hinweistext. `programm` ist ein Schluessel aus ISSUES."""
    url = ISSUES.get(programm, "")
    return (
        "Diese Software ist eine ERPROBUNGSFASSUNG.\n\n"
        "Sie wird noch getestet. Für Belege, die falsch ausgestellt werden, "
        "wird keine Haftung übernommen.\n\n"
        "Prüfen Sie jeden Beleg selbst, bevor Sie ihn herausgeben oder "
        "verbuchen. Nutzen Sie dafür die Vorschau – in diesem Programm und im "
        "jeweils anderen. Stimmt etwas nicht, melden Sie es bitte als Fehler "
        "unter:\n\n"
        f"    {url}\n\n"
        "Mit „Ja\" bestätigen Sie, dass Sie diesen Hinweis gelesen und zur "
        "Kenntnis genommen haben.\n"
        "Mit „Nein\" wird das Programm beendet; der Hinweis erscheint beim "
        "nächsten Start erneut."
    )


def _stand(cfg):
    return (str(cfg.get("hinweis_fassung", "") or ""),
            str(cfg.get("hinweis_zeit", "") or ""),
            str(cfg.get("hinweis_benutzer", "") or ""))


def angenommen(cfg):
    """Hat der Nutzer GENAU DIESE Fassung schon zur Kenntnis genommen?"""
    fassung, zeit, benutzer = _stand(cfg)
    return fassung == FASSUNG and bool(zeit) and bool(benutzer)


def vermerken(cfg):
    """Die Kenntnisnahme festhalten. Gibt die Signaturzeile zurueck."""
    cfg["hinweis_fassung"] = FASSUNG
    cfg["hinweis_zeit"] = datetime.datetime.now().isoformat(timespec="seconds")
    try:
        cfg["hinweis_benutzer"] = getpass.getuser()
    except Exception:  # noqa: BLE001 - ohne Benutzernamen ist es kein Grund zu scheitern
        cfg["hinweis_benutzer"] = "unbekannt"
    return signatur(cfg)


def signatur(cfg):
    """Die Zeile fuer den Info-Dialog - oder '' , wenn nichts vorliegt."""
    fassung, zeit, benutzer = _stand(cfg)
    if not (fassung and zeit and benutzer):
        return ""
    try:
        wann = datetime.datetime.fromisoformat(zeit).strftime("%d.%m.%Y um %H:%M")
    except ValueError:
        wann = zeit
    return (f"Gelesen und zur Kenntnis genommen von {benutzer} "
            f"am {wann} (Fassung {fassung}).")