b6e5a59daa
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>
138 lines
4.2 KiB
Markdown
138 lines
4.2 KiB
Markdown
# 3D-Druck Kostenkalkulation
|
|
|
|
Web-App zur Kalkulation von 3D-Druck-Kosten mit PDF-Rechnung und TXT-Export.
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
source .venv/bin/activate
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
## Start
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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
|
|
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
|
|
bash -c "$(curl -fsSL https://gitea.teamthiele.de/ethiele/3ddruckkalkulation/raw/branch/main/proxmox-setup.sh)" - 105 mein-container
|
|
```
|
|
|
|
**Container-Zugriff:**
|
|
|
|
```bash
|
|
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:**
|
|
|
|
```bash
|
|
./proxmox-update.sh
|
|
```
|
|
|
|
**Vom Proxmox-Host aus:**
|
|
|
|
```bash
|
|
./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
|