""" HFS Abrechnung – Minimal Flask-App (Flask + SQLAlchemy + MariaDB) --------------------------------------------------------------- Funktionen: - CRUD für grunddaten, kurs, rechnungen - Simple Verknüpfung: rechnungen.dgid -> grunddaten.elleid - PDF-Rechnung pro Kunde/Einrichtung (grunddaten) und Datumsbereich - Einfache HTML-Views via render_template_string (keine externen Templates nötig) Voraussetzungen: - Python 3.10+ - pip install flask SQLAlchemy pymysql reportlab python-dotenv - Laufende MariaDB mit Schema/Tables wie vom Nutzer beschrieben - .env mit DB_URL (siehe unten) Start: export FLASK_APP=hfs_app.py flask run --debug Beispiel .env: DB_URL=mysql+pymysql://www_usr:yOPbAI8Pd@localhost:3306/hfs?charset=utf8mb4 Hinweis Sicherheit: Bitte die echten Zugangsdaten nicht commiten. Für Produktion weitere Härtung (Auth, CSRF, Rollen, etc.). """ from __future__ import annotations import io import os from datetime import date, datetime, time from decimal import Decimal from typing import Optional from flask import Flask, request, redirect, url_for, send_file from flask import render_template_string, flash from sqlalchemy import create_engine, Column, Integer, String, DECIMAL, Date, Time, ForeignKey, select, func from sqlalchemy.orm import declarative_base, sessionmaker, relationship, scoped_session from reportlab.lib.pagesizes import A4 from reportlab.pdfgen import canvas from reportlab.lib.units import mm from reportlab.lib.utils import simpleSplit from dotenv import load_dotenv load_dotenv() DB_URL = os.getenv("DB_URL", "mysql+pymysql://www_usr:yOPbAI8Pd@localhost:3306/hfs?charset=utf8mb4") engine = create_engine(DB_URL, pool_pre_ping=True, future=True) SessionLocal = scoped_session(sessionmaker(bind=engine, autoflush=False, autocommit=False, future=True)) Base = declarative_base() # --- Models entsprechend vorhandener Tabellen --- class Grunddaten(Base): __tablename__ = "grunddaten" elleid = Column(Integer, primary_key=True, autoincrement=True) firma = Column(String(25)) bereich = Column(String(25)) abteilung = Column(String(25)) strasse = Column(String(45)) plz = Column(String(5)) ort = Column(String(45)) verguetung1 = Column(DECIMAL(6, 2)) verguetung2 = Column(DECIMAL(6, 2)) rechnungen = relationship("Rechnung", back_populates="kunde", cascade="all, delete-orphan") def __repr__(self): return f"" class Kurs(Base): __tablename__ = "kurs" elleid = Column(Integer, primary_key=True, autoincrement=True) kurs = Column(String(25)) status = Column(String(25)) bemerkung = Column(String(255)) def __repr__(self): return f"" class Rechnung(Base): __tablename__ = "rechnungen" elleid = Column(Integer, primary_key=True, autoincrement=True) datum = Column(Date) von = Column(Time) bis = Column(Time) stunden = Column(Time) # gespeichert als HH:MM:SS bemerkung = Column(String(45)) km = Column(Integer) kurs = Column(String(25)) # Hinweis: String-Ref auf kurs.kurs dgid = Column(Integer, ForeignKey("grunddaten.elleid", ondelete="CASCADE")) kunde = relationship("Grunddaten", back_populates="rechnungen") def stunden_decimal(self) -> Decimal: """Wandelt stunden (Time) in Dezimalstunden um (z. B. 01:30:00 -> 1.5).""" if not self.stunden: return Decimal("0") h, m, s = self.stunden.hour, self.stunden.minute, self.stunden.second return Decimal(h) + Decimal(m) / Decimal(60) + Decimal(s) / Decimal(3600) # --- Flask App --- app = Flask(__name__) app.secret_key = os.getenv("FLASK_SECRET", "dev-secret") # --- Helpers --- BASE_HTML = """ HFS Abrechnung

HFS Abrechnung

{% with messages = get_flashed_messages() %} {% if messages %}
{{ messages[0] }}
{% endif %} {% endwith %} {{ body|safe }} """ def page(content: str) -> str: return render_template_string(BASE_HTML, body=content) # --- Dashboard --- @app.get("/") def index(): db = SessionLocal() try: kunden = db.scalar(select(func.count(Grunddaten.elleid))) or 0 kurse = db.scalar(select(func.count(Kurs.elleid))) or 0 rechs = db.scalar(select(func.count(Rechnung.elleid))) or 0 finally: db.close() body = f"""

Überblick

Kunden/Einrichtungen: {kunden}

Kurse: {kurse}

Rechnungszeilen: {rechs}

""" return page(body) # --- CRUD: Grunddaten --- @app.get("/grunddaten") def grunddaten_list(): db = SessionLocal() try: rows = db.execute(select(Grunddaten).order_by(Grunddaten.elleid.desc())).scalars().all() finally: db.close() body = """

Grunddaten

Neu
{% for g in rows %} {% endfor %}
IDFirmaBereichAbteilungAdresseVergütung1Vergütung2Aktion
{{ g.elleid }} {{ g.firma or '' }} {{ g.bereich or '' }} {{ g.abteilung or '' }} {{ (g.strasse or '') + ', ' + (g.plz or '') + ' ' + (g.ort or '') }} {{ g.verguetung1 or '' }} {{ g.verguetung2 or '' }} Bearbeiten Löschen
""" return page(render_template_string(body, rows=rows)) @app.get("/grunddaten/new") def grunddaten_new(): body = """

Grunddaten anlegen

""" return page(body) @app.post("/grunddaten") def grunddaten_create(): db = SessionLocal() try: g = Grunddaten( firma=request.form.get("firma"), bereich=request.form.get("bereich"), abteilung=request.form.get("abteilung"), strasse=request.form.get("strasse"), plz=request.form.get("plz"), ort=request.form.get("ort"), verguetung1=request.form.get("verguetung1") or None, verguetung2=request.form.get("verguetung2") or None, ) db.add(g) db.commit() flash("Gespeichert.") finally: db.close() return redirect(url_for("grunddaten_list")) @app.get("/grunddaten/") def grunddaten_edit(id: int): db = SessionLocal() try: g = db.get(Grunddaten, id) finally: db.close() if not g: return page("

Nicht gefunden.

") body = render_template_string("""

Grunddaten bearbeiten #{{ g.elleid }}

""", g=g) return page(body) @app.post("/grunddaten/") def grunddaten_update(id: int): db = SessionLocal() try: g = db.get(Grunddaten, id) if not g: return page("

Nicht gefunden.

") for field in ["firma","bereich","abteilung","strasse","plz","ort"]: setattr(g, field, request.form.get(field)) g.verguetung1 = request.form.get("verguetung1") or None g.verguetung2 = request.form.get("verguetung2") or None db.commit() flash("Aktualisiert.") finally: db.close() return redirect(url_for("grunddaten_list")) @app.get("/grunddaten//delete") def grunddaten_delete(id: int): db = SessionLocal() try: g = db.get(Grunddaten, id) if g: db.delete(g) db.commit() flash("Gelöscht.") finally: db.close() return redirect(url_for("grunddaten_list")) # --- CRUD: Kurs --- @app.get("/kurs") def kurs_list(): db = SessionLocal() try: rows = db.execute(select(Kurs).order_by(Kurs.elleid.desc())).scalars().all() finally: db.close() body = render_template_string("""

Kurse

Neu
{% for k in rows %} {% endfor %}
IDKursStatusBemerkungAktion
{{ k.elleid }} {{ k.kurs or '' }} {{ k.status or '' }} {{ k.bemerkung or '' }} Bearbeiten Löschen
""", rows=rows) return page(body) @app.get("/kurs/new") def kurs_new(): body = """

Kurs anlegen

""" return page(body) @app.post("/kurs") def kurs_create(): db = SessionLocal() try: k = Kurs(kurs=request.form.get("kurs"), status=request.form.get("status"), bemerkung=request.form.get("bemerkung")) db.add(k) db.commit() flash("Gespeichert.") finally: db.close() return redirect(url_for("kurs_list")) @app.get("/kurs/") def kurs_edit(id: int): db = SessionLocal() try: k = db.get(Kurs, id) finally: db.close() if not k: return page("

Nicht gefunden.

") body = render_template_string("""

Kurs bearbeiten #{{ k.elleid }}

""", k=k) return page(body) @app.post("/kurs/") def kurs_update(id: int): db = SessionLocal() try: k = db.get(Kurs, id) if not k: return page("

Nicht gefunden.

") k.kurs = request.form.get("kurs") k.status = request.form.get("status") k.bemerkung = request.form.get("bemerkung") db.commit() flash("Aktualisiert.") finally: db.close() return redirect(url_for("kurs_list")) @app.get("/kurs//delete") def kurs_delete(id: int): db = SessionLocal() try: k = db.get(Kurs, id) if k: db.delete(k) db.commit() flash("Gelöscht.") finally: db.close() return redirect(url_for("kurs_list")) # --- CRUD: Rechnungen (Zeiterfassung/Positionen) --- @app.get("/rechnungen") def rechnungen_list(): db = SessionLocal() try: rows = ( db.execute( select(Rechnung).order_by(Rechnung.datum.desc(), Rechnung.elleid.desc()) ).scalars().all() ) kunden = {g.elleid: g for g in db.execute(select(Grunddaten)).scalars().all()} finally: db.close() body = render_template_string("""

Rechnungs-Positionen

Neu
{% for r in rows %} {% endfor %}
IDDatumVonBisStundenKMKursKundeBemerkungAktion
{{ r.elleid }} {{ r.datum }} {{ r.von }} {{ r.bis }} {{ r.stunden }} {{ r.km or 0 }} {{ r.kurs or '' }} {{ kunden.get(r.dgid).firma if kunden.get(r.dgid) else r.dgid }} {{ r.bemerkung or '' }} Bearbeiten Löschen
""", rows=rows, kunden=kunden) return page(body) @app.get("/rechnungen/new") def rechnung_new(): db = SessionLocal() try: kunden = db.execute(select(Grunddaten).order_by(Grunddaten.firma)).scalars().all() kurse = db.execute(select(Kurs).order_by(Kurs.kurs)).scalars().all() finally: db.close() body = render_template_string("""

Position anlegen

""", kunden=kunden, kurse=kurse, nowdate=date.today().isoformat()) return page(body) @app.post("/rechnungen") def rechnung_create(): def parse_time(val: Optional[str]) -> Optional[time]: if not val: return None try: hh, mm = map(int, val.split(":")) return time(hour=hh, minute=mm) except Exception: return None db = SessionLocal() try: r = Rechnung( datum=datetime.strptime(request.form.get("datum"), "%Y-%m-%d").date() if request.form.get("datum") else None, von=parse_time(request.form.get("von")), bis=parse_time(request.form.get("bis")), stunden=parse_time(request.form.get("stunden")), bemerkung=request.form.get("bemerkung"), km=int(request.form.get("km")) if request.form.get("km") else None, kurs=request.form.get("kurs"), dgid=int(request.form.get("dgid")) if request.form.get("dgid") else None, ) db.add(r) db.commit() flash("Gespeichert.") finally: db.close() return redirect(url_for("rechnungen_list")) @app.get("/rechnungen/") def rechnung_edit(id: int): db = SessionLocal() try: r = db.get(Rechnung, id) kunden = db.execute(select(Grunddaten).order_by(Grunddaten.firma)).scalars().all() kurse = db.execute(select(Kurs).order_by(Kurs.kurs)).scalars().all() finally: db.close() if not r: return page("

Nicht gefunden.

") body = render_template_string("""

Position bearbeiten #{{ r.elleid }}

""", r=r, kunden=kunden, kurse=kurse) return page(body) @app.post("/rechnungen/") def rechnung_update(id: int): def parse_time(val: Optional[str]) -> Optional[time]: if not val: return None try: hh, mm = map(int, val.split(":")) return time(hour=hh, minute=mm) except Exception: return None db = SessionLocal() try: r = db.get(Rechnung, id) if not r: return page("

Nicht gefunden.

") r.datum = datetime.strptime(request.form.get("datum"), "%Y-%m-%d").date() if request.form.get("datum") else None r.von = parse_time(request.form.get("von")) r.bis = parse_time(request.form.get("bis")) r.stunden = parse_time(request.form.get("stunden")) r.km = int(request.form.get("km")) if request.form.get("km") else None r.kurs = request.form.get("kurs") r.dgid = int(request.form.get("dgid")) if request.form.get("dgid") else None r.bemerkung = request.form.get("bemerkung") db.commit() flash("Aktualisiert.") finally: db.close() return redirect(url_for("rechnungen_list")) @app.get("/rechnungen//delete") def rechnung_delete(id: int): db = SessionLocal() try: r = db.get(Rechnung, id) if r: db.delete(r) db.commit() flash("Gelöscht.") finally: db.close() return redirect(url_for("rechnungen_list")) # --- Rechnungs-Tools --- @app.get("/rechnung-tools") def rechnung_tools(): db = SessionLocal() try: kunden = db.execute(select(Grunddaten).order_by(Grunddaten.firma)).scalars().all() finally: db.close() body = render_template_string("""

Rechnung erstellen

""", kunden=kunden, first_day=date.today().replace(day=1).isoformat(), last_day=date.today().isoformat()) return page(body) @app.get("/rechnung-preview") def rechnung_preview(): dgid = int(request.args.get("dgid")) dfrom = datetime.strptime(request.args.get("from"), "%Y-%m-%d").date() dto = datetime.strptime(request.args.get("to"), "%Y-%m-%d").date() db = SessionLocal() try: kunde = db.get(Grunddaten, dgid) items = ( db.execute( select(Rechnung).where(Rechnung.dgid == dgid, Rechnung.datum >= dfrom, Rechnung.datum <= dto).order_by(Rechnung.datum) ).scalars().all() ) sum_stunden = sum([i.stunden_decimal() for i in items], Decimal("0")) # einfacher Tarif: verguetung1 pro Stunde, km-Pauschale optional (0.35 €/km Beispiel) satz = Decimal(kunde.verguetung1 or 0) betrag_stunden = (sum_stunden * satz).quantize(Decimal("0.01")) sum_km = sum([i.km or 0 for i in items]) km_satz = Decimal("0.35") betrag_km = (Decimal(sum_km) * km_satz).quantize(Decimal("0.01")) netto = (betrag_stunden + betrag_km).quantize(Decimal("0.01")) mwst_satz = Decimal("0.19") mwst = (netto * mwst_satz).quantize(Decimal("0.01")) brutto = (netto + mwst).quantize(Decimal("0.01")) finally: db.close() body = render_template_string("""

Vorschau Rechnung

Kunde: {{ kunde.firma }} – {{ kunde.strasse }}, {{ kunde.plz }} {{ kunde.ort }}

Zeitraum: {{ dfrom }} bis {{ dto }}

{% for i in items %} {% endfor %}
DatumKursStunden (dezimal)KMBemerkung
{{ i.datum }} {{ i.kurs or '' }} {{ '%.2f' % i.stunden_decimal() }} {{ i.km or 0 }} {{ i.bemerkung or '' }}
Summe{{ '%.2f' % sum_stunden }}{{ sum_km }}

Stundensatz: {{ satz }} € | Stundenbetrag: {{ betrag_stunden }} €
KM-Satz: 0.35 € | KM-Betrag: {{ betrag_km }} €

Netto: {{ netto }} € | MwSt 19%: {{ mwst }} € | Brutto: {{ brutto }} €

Als PDF erzeugen

""", kunde=kunde, dfrom=dfrom, dto=dto, items=items, sum_stunden=sum_stunden, sum_km=sum([i.km or 0 for i in items]), satz=satz, betrag_stunden=betrag_stunden, km_satz=Decimal("0.35"), betrag_km=betrag_km, netto=netto, mwst=mwst, brutto=brutto, dgid=dgid) return page(body) @app.get("/rechnung-pdf") def rechnung_pdf(): dgid = int(request.args.get("dgid")) dfrom = datetime.strptime(request.args.get("dfrom"), "%Y-%m-%d").date() dto = datetime.strptime(request.args.get("dto"), "%Y-%m-%d").date() db = SessionLocal() try: kunde = db.get(Grunddaten, dgid) items = ( db.execute( select(Rechnung).where(Rechnung.dgid == dgid, Rechnung.datum >= dfrom, Rechnung.datum <= dto).order_by(Rechnung.datum) ).scalars().all() ) sum_stunden = sum([i.stunden_decimal() for i in items], Decimal("0")) satz = Decimal(kunde.verguetung1 or 0) betrag_stunden = (sum_stunden * satz).quantize(Decimal("0.01")) sum_km = sum([i.km or 0 for i in items]) km_satz = Decimal("0.35") betrag_km = (Decimal(sum_km) * km_satz).quantize(Decimal("0.01")) netto = (betrag_stunden + betrag_km).quantize(Decimal("0.01")) mwst_satz = Decimal("0.19") mwst = (netto * mwst_satz).quantize(Decimal("0.01")) brutto = (netto + mwst).quantize(Decimal("0.01")) finally: db.close() # --- PDF generieren --- buf = io.BytesIO() c = canvas.Canvas(buf, pagesize=A4) w, h = A4 margin = 20 * mm def draw_text(x, y, text, max_width=None): lines = simpleSplit(text, 'Helvetica', 10, max_width or (w - 2*margin)) for idx, ln in enumerate(lines): c.drawString(x, y - 12*idx, ln) return y - 12*len(lines) c.setTitle("Rechnung") y = h - margin c.setFont("Helvetica-Bold", 14) c.drawString(margin, y, "Rechnung") c.setFont("Helvetica", 10) y -= 18 y = draw_text(margin, y, f"Kunde: {kunde.firma}\n{kunde.strasse}\n{kunde.plz} {kunde.ort}") y -= 12 c.drawString(margin, y, f"Zeitraum: {dfrom.isoformat()} bis {dto.isoformat()}") y -= 18 # Tabelle Kopf c.setFont("Helvetica-Bold", 10) c.drawString(margin, y, "Datum") c.drawString(margin + 80, y, "Kurs") c.drawString(margin + 250, y, "Stunden") c.drawString(margin + 320, y, "KM") c.drawString(margin + 370, y, "Bemerkung") y -= 12 c.setFont("Helvetica", 10) for i in items: if y < 60: c.showPage() y = h - margin c.drawString(margin, y, i.datum.isoformat()) c.drawString(margin + 80, y, (i.kurs or "")[:30]) c.drawRightString(margin + 310, y, f"{i.stunden_decimal():.2f}") c.drawRightString(margin + 350, y, str(i.km or 0)) c.drawString(margin + 370, y, (i.bemerkung or "")[:40]) y -= 12 y -= 12 c.setFont("Helvetica-Bold", 10) c.drawRightString(margin + 310, y, f"Summe Stunden: {sum_stunden:.2f}") c.drawRightString(margin + 350, y - 12, f"Summe KM: {sum_km}") y -= 30 c.drawString(margin, y, f"Stundensatz: {satz} € -> Betrag: {betrag_stunden} €") y -= 12 c.drawString(margin, y, f"KM-Satz: 0.35 € -> Betrag: {betrag_km} €") y -= 12 c.drawString(margin, y, f"Netto: {netto} € | MwSt 19%: {mwst} € | Brutto: {brutto} €") c.showPage() c.save() buf.seek(0) filename = f"rechnung_{dgid}_{dfrom.isoformat()}_{dto.isoformat()}.pdf" return send_file(buf, as_attachment=True, download_name=filename, mimetype="application/pdf") if __name__ == "__main__": app.run(debug=True)