Files
3ddruckkalkulation/README.md
Erik Thiele b6e5a59daa Sicherheit, PDF-Robustheit, Stueckzahl und Besteuerung ueberarbeitet
Sicherheit:
- debug=True aus app.run() entfernt. Der Werkzeug-Debugger erlaubt
  Codeausfuehrung ueber das Netz und lief bisher im LXC-Container mit.
  Neu ueber FLASK_DEBUG/HOST/PORT steuerbar; mit FLASK_DEBUG=1 bindet
  die App automatisch nur an 127.0.0.1.
- Wirkungsloses --no-reload aus dem systemd-ExecStart entfernt
  (app.run() wertet sys.argv nicht aus).
- /save_config uebernimmt nur noch Keys aus DEFAULT_VALUES.

PDF:
- pdf_text() transliteriert Zeichen, die die latin-1-Kernfonts nicht
  koennen (Gedankenstrich, typografische Anfuehrungszeichen, Euro-Zeichen).
  Vorher warf jeder solche Kundenname einen UnicodeEncodeError -> HTTP 500.
- Legacy-fpdf2-API abgeloest: ln=True -> new_x/new_y, output(dest='S')
  -> output(), Font "Arial" -> "Helvetica". Alle drei waren als
  "will soon be removed" markiert.

Kalkulation:
- Stueckzahl wirkt jetzt in der Hauptansicht. Vorher zeigte "GESAMT"
  den Preis pro Stueck, obwohl die Stueckzahl direkt darueber eingegeben
  wurde. Anzeige jetzt getrennt nach PRO STUECK und AUFTRAG.
- Rundung auf Cent-Basis des Stueckpreises, damit die Rechnungszeile
  nachrechenbar bleibt (Einzelpreis x Menge == Zeilensumme).
- as_stueckzahl() faengt '', '1.5' und 0 ab (vorher ValueError -> 500).
- Gewinnmarge im Ergebnis kommt vom Server; das Label zeigte auf der
  Startseite immer 20 %, weil es ein nicht vorhandenes Feld auslas.

Besteuerung (drei Regime statt eines Bool-Schalters):
- 'privat'           - kein Unternehmer nach §2 UStG: weder MwSt. noch
                       Steuernummer noch §19-Hinweis auf dem Beleg
- 'kleinunternehmer' - §19 UStG mit Pflichthinweis
- 'regel'            - MwSt. mit konfigurierbarem Satz (19 % / 7 %)
Steuernummer, USt-IdNr. und Leistungsdatum (§14 UStG) ergaenzt; sie
erscheinen nur in den beiden Unternehmer-Modi, unabhaengig davon, ob
die Felder in der Config gefuellt sind.

Config-Handling:
- save_config() schreibt atomar (tmp + os.replace + fsync), ein Lock
  serialisiert die Read-modify-write-Zyklen.
- load_config() wirft ConfigError bei beschaedigter YAML, statt still
  auf Defaults zu fallen -- sonst haette der naechste Autosave die
  Datei endgueltig ueberschrieben.
- _migriere() leitet steuerregime aus dem alten mwst_ausweisen ab und
  laeuft vor dem Auffuellen mit Defaults sowie nach jedem Speichern.

Frontend:
- Dark-Mode-Toggle schrieb "Light"/"Dark" als Textknoten in den
  Icon-Button und liess das Icon in der falschen Richtung stehen.
- recalculate() steigt auf Seiten ohne Ergebnisblock aus; auf der
  Einstellungsseite warf bisher jeder Tastendruck eine TypeError.
- Live-Berechnung entprellt (150 ms) statt ein Request pro Tastendruck.

Sonstiges:
- requirements.txt mit gepinnten Versionen; beide Proxmox-Skripte
  nutzen sie statt loser Paketlisten und ohne blindes --upgrade.
- Falsche Port-Ausgabe in proxmox-setup.sh korrigiert (5000 -> 5001).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-22 10:51:45 +02:00

4.2 KiB

3D-Druck Kostenkalkulation

Web-App zur Kalkulation von 3D-Druck-Kosten mit PDF-Rechnung und TXT-Export.

Setup

source .venv/bin/activate
pip install -r requirements.txt

Start

python app.py

-> http://127.0.0.1:5001

Der Debug-Modus ist standardmaessig aus (der Werkzeug-Debugger erlaubt sonst Codeausfuehrung ueber das Netz). Zum Entwickeln:

FLASK_DEBUG=1 python app.py

Mit FLASK_DEBUG=1 lauscht die App nur auf 127.0.0.1. Host und Port lassen sich ueber HOST und PORT ueberschreiben.

Funktionen

  • Live-Berechnung bei jeder Eingabe (Material, Strom, Abschreibung, Arbeit, Gewinn)
  • Dark Mode (persistiert in YAML-Konfiguration)
  • PDF-Rechnung mit Logo, Kundendaten und Positionstabelle (via fpdf2)
  • TXT-Export der Kalkulation
  • Auto-Save aller Werte via AJAX (debounced 500ms)
  • Einstellungsseite für Druckerabschreibung, Arbeitskosten, Stromkosten, Firmendaten, Logo
  • Besteuerung mit drei Modi:
    • Privatverkauf — kein Unternehmer nach §2 UStG: keine MwSt., keine Steuernummer, kein §19-Hinweis, nur „Privatverkauf. Kein Ausweis von Umsatzsteuer."
    • Kleinunternehmer — §19 UStG: keine MwSt., dafür der Pflichthinweis
    • Regelbesteuert — MwSt. mit 19 % oder 7 %
  • Rechnungspflichtangaben nach §14 UStG (Steuernummer/USt-IdNr., Leistungsdatum) — nur in den beiden Unternehmer-Modi
  • Logo-Upload (PNG/JPEG/WebP) für die Rechnung

Installation auf Proxmox (LXC-Container)

Das Skript proxmox-setup.sh erstellt einen Ubuntu-24.04-LXC-Container, klont das Repository, installiert alle Abhangigkeiten und richtet einen systemd-Service ein.

Auf dem Proxmox-Host als root ausfuhren:

bash -c "$(curl -fsSL https://gitea.teamthiele.de/ethiele/3ddruckkalkulation/raw/branch/main/proxmox-setup.sh)"

Nach Abschluss ist die App unter http://<CONTAINER-IP>:5001 erreichbar. Container-ID und Name konnen als Argumente ubergeben werden:

bash -c "$(curl -fsSL https://gitea.teamthiele.de/ethiele/3ddruckkalkulation/raw/branch/main/proxmox-setup.sh)" - 105 mein-container

Container-Zugriff:

pct enter 201                  # Shell im Container
systemctl status 3ddruck-kalkulation.service
journalctl -u 3ddruck-kalkulation.service -f

Update des Containers

proxmox-update.sh aktualisiert den Container via Git und startet den Service neu.

Im Container ausfuhren:

./proxmox-update.sh

Vom Proxmox-Host aus:

./proxmox-update.sh 201

Das Skript holt via curl die aktuelle Version aus dem Gitea-Repo, pullt, installiert ggf. neue Dependencies und restartet den systemd-Service.

Technik

Komponente Technologie
Backend Flask (Python)
Frontend Tabler CSS, Bootstrap 5
Icons Tabler Icons
PDF fpdf2 (importiert als fpdf)
Config YAML (Auto-Save, atomar geschrieben)

Projektstruktur

app.py                         # Flask-Server mit allen Routen
templates/index.html           # Hauptseite (Formular + Ergebnisse)
templates/invoice.html         # Rechnungsseite
templates/settings.html        # Einstellungen
static/style.css               # Minimales Custom-CSS
static/script.js               # Live-Berechnung + Auto-Save
proxmox-setup.sh               # Ersteinrichtung LXC-Container
proxmox-update.sh              # Update LXC-Container
druckkalkulation_config.yaml   # Automatisch erstellte Konfiguration (ignoriert)

Routen

Methode Pfad Beschreibung
GET / Hauptseite mit Formular
POST /calculate JSON-Berechnung (AJAX)
POST /save_config Speichert Werte in YAML
GET /invoice Rechnungsseite
POST /invoice/pdf PDF-Download
POST /export TXT-Download
GET /settings Einstellungsseite
POST /upload_logo Logo hochladen
POST /delete_logo Logo loschen

Hinweise

  • fpdf2 wird als fpdf importiert (alte API, from fpdf import FPDF)
  • Alle UI-Texte sind Deutsch
  • Die YAML-Config wird automatisch erstellt und bei jedem Tastendruck gespeichert
  • druckkalkulation_config.yaml und static/logo.* sind in .gitignore ausgeschlossen