Freigabe vor dem Beleg - mit Zeitstempel im gemeinsamen Nummernbuch

Sein Grund, woertlich (06.09.2026):

  "ich will fuer den pruefer sichtbar machen: ich wollte das so. die software
   dokumentiert das, und damit wird es nachvollziehbar, weil es einen checkmark
   nun gibt in der sqlite"  -  "das soll alles von anfang bis ende pruefbar sein"

WAS PASSIERT

Vor dem Schreiben eines Belegs fragt das Programm einmal ausdruecklich nach.
Der Text nennt, was gleich entsteht und was daran bindend ist:

  Rechnung: ausgestellt im Sinne des § 14 UStG; die Nummer ist danach vergeben
            und darf kein zweites Mal verwendet werden (§ 14 Abs. 4 Nr. 4 UStG);
            zehn Jahre aufzubewahren (§ 147 Abs. 3 AO); nachtraeglich nicht
            aenderbar (§ 146 Abs. 4 AO) - eine falsche Rechnung wird nicht
            ueberschrieben, sondern storniert.
  Angebot:  unverbindlich, KEINE Rechnung, weist keine Steuer aus, verbraucht
            keine Rechnungsnummer, wird nirgends gebucht.

Storno/Korrektur und Berichtigung haben ihre eigene Rueckfrage - sie wird nicht
verdoppelt (ein Schritt pro Fenster).

DIE SPUR

Ein Popup allein waere fuer einen Pruefer wertlos, es hinterlaesst nichts.
Deshalb bekommt die Tabelle "nummern" im gemeinsamen Buch eine Spalte
"freigabe": der ISO-Zeitstempel der ausdruecklichen Freigabe, an der
Rechnungsnummer haengend. Bestehende Buecher werden per ALTER TABLE nachgezogen;
alte Zeilen bleiben LEER - dort wurde nie gefragt, und ein nachtraeglich
erfundener Zeitstempel waere schlimmer als keiner.

gemeinsam.py liegt in beiden Programmen gleich und wurde mit hinuebergezogen.

PRUEFSTAND

pruef_freigabe.py prueft beide Richtungen, weil jede einzeln wertlos waere:
  NEIN -> kein PDF, Zaehler unveraendert, Nummer im Feld unveraendert,
          Nummernbuch leer
  JA   -> genau ein PDF, eine Nummer im Buch, Freigabe gesetzt und ein ISO-Datum

Die sieben Pruefstaende, die Belege erzeugen, melden die Freigabe jetzt
ausdruecklich an (pruefsteuerung bricht bei unangemeldeten Dialogen absichtlich
ab - kein stilles "ja").

Alle 16 Pruefstaende gruen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V4t48uxDok5rJXhC9bX1Ax
This commit is contained in:
TheMockTv 2026-09-06 15:42:55 +02:00
parent b3cb19743f
commit 95a9063ce1
10 changed files with 232 additions and 2 deletions

39
app.py
View file

@ -912,7 +912,11 @@ class RechnungsApp(ThemeMixin, MeldungMixin, KorrekturMixin, EinstellungenMixin,
ersetzt=str(kopf.get("ersetzt", "") or ""),
berichtigt_zu=str(kopf.get("berichtigt_zu", "") or ""),
vorlage=str(kopf.get("vorlage", "") or ""),
quelle="rechnungstool", herkunft="pdf", pdf_pfad=pdf_pfad)
quelle="rechnungstool", herkunft="pdf", pdf_pfad=pdf_pfad,
# Zeitstempel der ausdruecklichen Freigabe. Leer heisst: nicht
# gefragt (Beleg aus einer Fassung vor dem 06.09.2026 oder ueber
# einen Weg ohne Rueckfrage, z. B. Storno/Berichtigung mit eigener).
freigabe=str(kopf.get("freigabe", "") or ""))
except Exception as e: # noqa: BLE001 - die PDF ist schon geschrieben
print("[nummernbuch] Eintragen fehlgeschlagen:", e)
self.melden_warnung(
@ -1568,6 +1572,39 @@ class RechnungsApp(ThemeMixin, MeldungMixin, KorrekturMixin, EinstellungenMixin,
self.r_nummer.set(nummer)
kopf["rechnungsnummer"] = nummer
# ---- Freigabe durch den Benutzer, BEVOR ein Beleg entsteht --------------
# Ein Beleg ist kein Ausdruck, den man wegwerfen kann: die Nummer ist
# danach verbraucht (§ 14 Abs. 4 Nr. 4 UStG), das Blatt ist aufzubewahren
# (§ 147 Abs. 3 AO) und darf nicht mehr geaendert werden (§ 146 Abs. 4 AO).
# Deshalb wird einmal ausdruecklich gefragt, was gleich entsteht.
#
# Storno/Korrektur und Berichtigung haben ihre eigene Rueckfrage weiter
# oben - die wird nicht verdoppelt (ein Schritt pro Fenster).
if not stand and not ber:
if angebot:
titel = "Angebot jetzt erstellen?"
text = (f"Das Angebot {nummer} ist unverbindlich und ist KEINE Rechnung.\n\n"
"Es weist keine Steuer aus, verbraucht keine "
"Rechnungsnummer und wird nirgends gebucht.\n\n"
"Jetzt erstellen?")
else:
titel = "Rechnung jetzt erstellen?"
text = (f"Die Rechnung {nummer} wird als Rechnung im Sinne des "
"§ 14 UStG ausgestellt.\n\n"
"Die Nummer ist damit vergeben und darf kein zweites Mal "
"verwendet werden (§ 14 Abs. 4 Nr. 4 UStG). Das Blatt ist "
"zehn Jahre aufzubewahren (§ 147 Abs. 3 AO) und darf "
"nachträglich nicht geändert werden (§ 146 Abs. 4 AO). "
"Eine falsche Rechnung wird nicht überschrieben, sondern "
"storniert.\n\n"
"Jetzt erstellen?")
print(f"[freigabe] frage: {titel} (Nummer {nummer})")
if not self.frage(titel, text, default="yes"):
print(f"[freigabe] abgelehnt - kein Beleg, Nummer {nummer} bleibt frei")
return
kopf["freigabe"] = datetime.datetime.now().isoformat(timespec="seconds")
print(f"[freigabe] erteilt fuer {nummer} um {kopf["freigabe"]}")
if angebot:
name = f"Angebot_{safe_filename(nummer)}"
if self.k_name.get().strip():

View file

@ -55,6 +55,9 @@ CREATE TABLE IF NOT EXISTS nummern (
quelle TEXT NOT NULL DEFAULT '', -- rechnungstool|journal
herkunft TEXT NOT NULL DEFAULT '', -- pdf|xlsx|manuell
pdf_pfad TEXT NOT NULL DEFAULT '',
freigabe TEXT NOT NULL DEFAULT '', -- ISO-Zeitstempel der
-- ausdruecklichen Freigabe
-- durch den Betreiber
geaendert TEXT NOT NULL DEFAULT '' -- ISO-Zeitstempel
);
CREATE INDEX IF NOT EXISTS idx_nummern_jahr ON nummern (jahr);
@ -83,7 +86,8 @@ CREATE TABLE IF NOT EXISTS nachrichten (
FELDER = ("jahr", "datum", "nachname", "vorname", "naechte", "zwischensumme",
"steuer_satz", "steuer_betrag", "gesamt", "art", "vorgang", "storno_zu",
"ersetzt", "berichtigt_zu", "vorlage", "quelle", "herkunft", "pdf_pfad")
"ersetzt", "berichtigt_zu", "vorlage", "quelle", "herkunft", "pdf_pfad",
"freigabe")
def pfad_zur_datei(ordner):
@ -197,6 +201,12 @@ class Nummernbuch:
spalten = {z["name"] for z in con.execute("PRAGMA table_info('laeuft')")}
if spalten and "port" not in spalten:
con.execute("ALTER TABLE laeuft ADD COLUMN port INTEGER NOT NULL DEFAULT 0")
# Ebenso die Freigabe-Spalte: ein Buch aus der Fassung vor dem 06.09.2026
# kennt sie noch nicht. Alte Zeilen bleiben leer - dort wurde nie gefragt,
# und ein nachtraeglich erfundener Zeitstempel waere schlimmer als keiner.
spalten_n = {z["name"] for z in con.execute("PRAGMA table_info('nummern')")}
if spalten_n and "freigabe" not in spalten_n:
con.execute("ALTER TABLE nummern ADD COLUMN freigabe TEXT NOT NULL DEFAULT ''")
return con
# ---- Lesen -------------------------------------------------------------

View file

@ -84,6 +84,9 @@ def askyesno(titel, text, **kw):
raise AssertionError(f"unangemeldeter Dialog: {titel!r}")
# Die Freigabe vor dem Beleg (§ 14 UStG) wird bewusst bejaht - geprueft wird hier
# der Ablauf DANACH. Dass ein "Nein" keinen Beleg erzeugt, prueft pruef_freigabe.py.
antworten["jetzt erstellen?"] = True
messagebox.askyesno = askyesno
messagebox.showinfo = lambda *a, **k: None
warnungen = []

View file

@ -77,6 +77,9 @@ def askyesno(titel, text, **kw):
raise AssertionError(f"unangemeldeter Dialog: {titel!r}")
# Die Freigabe vor dem Beleg (§ 14 UStG) wird bewusst bejaht - geprueft wird hier
# der Ablauf DANACH. Dass ein "Nein" keinen Beleg erzeugt, prueft pruef_freigabe.py.
antworten["jetzt erstellen?"] = True
messagebox.askyesno = askyesno
messagebox.showinfo = lambda *a, **k: None
messagebox.showwarning = lambda *a, **k: warnungen.append(a[0] if a else "")

162
pruef_freigabe.py Normal file
View file

@ -0,0 +1,162 @@
# -*- coding: utf-8 -*-
"""Pruefstand: die Freigabe vor dem Beleg - und ihre Spur in der SQLite.
Sein Satz vom 06.09.2026:
"ich will fuer den pruefer sichtbar machen: ich wollte das so. die software
dokumentiert das, und damit wird es nachvollziehbar, weil es einen
checkmark nun gibt in der sqlite" - "das soll alles von anfang bis ende
pruefbar sein"
Geprueft wird beides, weil jedes einzeln wertlos waere:
1. NEIN -> es entsteht KEIN Beleg, die Nummer bleibt frei, im Buch steht
nichts. Ein Popup, das man verneint und trotzdem eine Rechnung
bekommt, waere schlimmer als gar keins.
2. JA -> der Beleg entsteht UND im Nummernbuch steht ein Zeitstempel der
Freigabe. Ohne diesen Eintrag koennte spaeter niemand belegen,
dass ausdruecklich freigegeben wurde.
"""
import json
import os
import re
import shutil
import sys
import tempfile
import threading
QUELLE = r"C:\claude\rechnungstool"
sys.path.insert(0, QUELLE)
fehler = []
def pruefe(bedingung, text):
zeile = (" OK | " if bedingung else "FEHLER | ") + text
kod = sys.stdout.encoding or "utf-8"
print(zeile.encode(kod, "replace").decode(kod))
if not bedingung:
fehler.append(text)
def _reissleine():
print("ABBRUCH | Pruefstand haengt (Zeitgrenze)")
os._exit(2)
_wecker = threading.Timer(120, _reissleine)
_wecker.daemon = True
_wecker.start()
tmp = tempfile.mkdtemp(prefix="freigabe_pruef_")
ordner = os.path.join(tmp, "rechnungen")
install = os.path.join(tmp, "install")
os.makedirs(ordner)
os.makedirs(install)
import config # noqa: E402
shutil.copy(os.path.join(QUELLE, "config.json"), os.path.join(tmp, "config.json"))
config.CONFIG_PATH = os.path.join(tmp, "config.json")
roh = json.load(open(config.CONFIG_PATH, encoding="utf-8"))
roh["rechnung_jahr"], roh["rechnung_zaehler"] = 2026, 0
roh["nummer_eingerichtet"] = False
roh["output_dir"] = ordner
roh["gemeinsam_ordner"] = install
json.dump(roh, open(config.CONFIG_PATH, "w", encoding="utf-8"),
ensure_ascii=False, indent=2)
os.environ["CAMPINGHOF_TEST"] = "1"
import app as A # noqa: E402
import gemeinsam # noqa: E402
from tkinter import messagebox # noqa: E402
antworten = {"Fertig": False, "Hausnummer": True}
gefragt = []
def askyesno(titel, text, **kw):
gefragt.append(titel)
for schlue, wert in antworten.items():
if schlue in titel:
return wert
raise AssertionError(f"unangemeldeter Dialog: {titel!r}")
messagebox.askyesno = askyesno
messagebox.showinfo = lambda *a, **k: None
warnungen = []
messagebox.showwarning = lambda *a, **k: warnungen.append(a[0] if a else "")
messagebox.showerror = lambda *a, **k: print("[fehler]", a[0] if a else "")
f = A.RechnungsApp()
f.update()
f.cfg["output_dir"] = ordner
# Im laufenden Programm oeffnet ein 400-ms-Timer das gemeinsame Buch. Den
# erreicht ein Pruefstand nie - also wird dieselbe Stelle direkt gerufen.
# Abgekuerzt wird damit nur das Warten, nicht der Weg.
f._frage_gemeinsam_falls_noetig()
pruefe(f.buch is not None, "das gemeinsame Nummernbuch ist offen")
def kunde_fuellen():
f.k_vorname.set("Anna")
f.k_name.set("Beispiel")
f.k_strasse.set("Musterweg 1")
f.k_plzort.set("12345 Musterstadt")
f.r_anreise.set("01.08.2026")
f.r_abreise.set("05.08.2026")
erste = sorted(f.anzahl_vars)[0]
f.anzahl_vars[erste].set("4")
f.update()
# ---- 1. NEIN: es darf nichts entstehen ----------------------------------
antworten["jetzt erstellen?"] = False
kunde_fuellen()
zaehler_vorher = f.cfg.get("rechnung_zaehler")
nummer_vorher = f.r_nummer.get()
f.pdf_erstellen()
pdfs = [x for x in os.listdir(ordner) if x.lower().endswith(".pdf")]
pruefe(not pdfs, f"nach Nein: kein PDF im Ordner (gefunden: {pdfs})")
pruefe(any("jetzt erstellen?" in t for t in gefragt),
"die Freigabe wurde ueberhaupt gefragt")
pruefe(f.cfg.get("rechnung_zaehler") == zaehler_vorher,
"nach Nein: der Rechnungszaehler ist unveraendert")
pruefe(f.r_nummer.get() == nummer_vorher,
"nach Nein: die Nummer im Feld ist unveraendert")
buch = gemeinsam.Nummernbuch(install)
pruefe(not buch.nummern(), f"nach Nein: das Nummernbuch ist leer ({buch.nummern()})")
# ---- 2. JA: Beleg entsteht und die Freigabe steht in der SQLite ---------
antworten["jetzt erstellen?"] = True
kunde_fuellen()
f.pdf_erstellen()
pdfs = [x for x in os.listdir(ordner) if x.lower().endswith(".pdf")]
pruefe(len(pdfs) == 1, f"nach Ja: genau ein PDF ({pdfs})")
nummern = sorted(buch.nummern())
pruefe(len(nummern) == 1, f"nach Ja: eine Nummer im Buch ({nummern})")
freigabe = ""
if nummern:
with buch._verbindung() as con:
zeile = con.execute("SELECT freigabe FROM nummern WHERE nummer=?",
(nummern[0],)).fetchone()
freigabe = (zeile["freigabe"] if zeile else "") or ""
pruefe(bool(freigabe), "die Freigabe steht in der SQLite")
pruefe(bool(re.fullmatch(r"\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}", freigabe)),
f"der Zeitstempel ist ein ISO-Datum ({freigabe!r})")
_wecker.cancel()
f.destroy()
shutil.rmtree(tmp, ignore_errors=True)
if fehler:
print(f"ROT | {len(fehler)} Punkt(e) nicht erfuellt")
sys.exit(1)
print("GRUEN | Freigabe wirkt und wird dokumentiert")

View file

@ -95,6 +95,9 @@ def askyesno(titel, text="", **kw):
raise AssertionError(f"unangemeldeter Dialog: {titel!r} — {text[:80]!r}")
# Die Freigabe vor dem Beleg (§ 14 UStG) wird bewusst bejaht - geprueft wird hier
# der Ablauf DANACH. Dass ein "Nein" keinen Beleg erzeugt, prueft pruef_freigabe.py.
antworten["jetzt erstellen?"] = True
messagebox.askyesno = askyesno
messagebox.showinfo = lambda *a, **k: meldungen.append(("info", a[0] if a else ""))
messagebox.showwarning = lambda *a, **k: meldungen.append(("warnung", a[0] if a else ""))

View file

@ -90,6 +90,9 @@ def askyesno(titel, text="", **kw):
raise AssertionError(f"unangemeldeter Dialog: {titel!r}")
# Die Freigabe vor dem Beleg (§ 14 UStG) wird bewusst bejaht - geprueft wird hier
# der Ablauf DANACH. Dass ein "Nein" keinen Beleg erzeugt, prueft pruef_freigabe.py.
antworten["jetzt erstellen?"] = True
messagebox.askyesno = askyesno
messagebox.showinfo = messagebox.showwarning = messagebox.showerror = \
lambda *a, **k: None

View file

@ -86,6 +86,9 @@ def askyesno(titel, text, **kw):
warnungen = []
# Die Freigabe vor dem Beleg (§ 14 UStG) wird bewusst bejaht - geprueft wird hier
# der Ablauf DANACH. Dass ein "Nein" keinen Beleg erzeugt, prueft pruef_freigabe.py.
antworten["jetzt erstellen?"] = True
messagebox.askyesno = askyesno
messagebox.showinfo = lambda *a, **k: None
messagebox.showwarning = lambda *a, **k: warnungen.append(a[0] if a else "")

View file

@ -122,6 +122,9 @@ def askyesno(titel, text, **kw):
raise AssertionError(f"unangemeldeter Dialog: {titel!r}")
# Die Freigabe vor dem Beleg (§ 14 UStG) wird bewusst bejaht - geprueft wird hier
# der Ablauf DANACH. Dass ein "Nein" keinen Beleg erzeugt, prueft pruef_freigabe.py.
antworten["jetzt erstellen?"] = True
messagebox.askyesno = askyesno
tool = A.RechnungsApp()

View file

@ -92,6 +92,9 @@ def askyesno(titel, text, **kw):
antworten["Fertig"] = False # "jetzt oeffnen?" - nie oeffnen im Pruefstand
antworten["endgültig erstellen"] = True # die Sicherheitsfrage bejahen
antworten["Hausnummer"] = True # "Musterweg 1" hat eine, greift nur im Sonderfall
# Die Freigabe vor dem Beleg (§ 14 UStG) wird bewusst bejaht - geprueft wird hier
# der Ablauf DANACH. Dass ein "Nein" keinen Beleg erzeugt, prueft pruef_freigabe.py.
antworten["jetzt erstellen?"] = True
messagebox.askyesno = askyesno
messagebox.showinfo = lambda *a, **k: None
warnungen = []