c42fecacb9
Bisher liess sich pro Rechnung nur ein Teil kalkulieren. Ein Objekt aus
mehreren Teilen musste in getrennten Rechnungen abgebildet werden.
Positionen:
- Die Kalkulation arbeitet mit einer Positionsliste statt einem
Einzelteil. Bezeichnung, Material, Preis/kg, Druckzeit, Arbeitszeit
und Stueckzahl gelten je Position -- verschiedene Teile nutzen oft
unterschiedliche Filamente und brauchen unterschiedlich viel Nacharbeit.
- Drucker, Strom, Stundenlohn, Marge und Steuer bleiben auftragsweit.
- Jede Position wird eine eigene Rechnungszeile mit Menge, Einzelpreis
und Zeilensumme. Bei vielen Positionen bricht das PDF auf weitere
Seiten um.
- Die Auftragssumme ist die Summe der bereits gerundeten Zeilen, damit
die Rechnung zeilenweise nachrechenbar bleibt.
- saubere_positionen() normalisiert jede Liste aus Config oder Client
(Typen, Wertebereiche, Obergrenze 50); es bleibt immer mindestens
eine Position bestehen.
- Alte Configs mit den Flachfeldern werden in eine einzelne Position
migriert, die Altfelder entfernt.
- sammlePositionen() liefert null auf Seiten ohne Positionsliste, damit
ein Tastendruck auf der Einstellungs- oder Rechnungsseite die
Positionen nicht loescht.
Projekte:
- Benannte Kalkulationen lassen sich speichern und wieder laden,
Ablage in druckkalkulation_projekte.yaml (ein Mapping fuer alle
Projekte, Schluessel ist der Projektname).
- Gesichert werden nur PROJEKT_FELDER: Name, Positionen, Kundendaten,
Rechnungsnummer, Rechnungs- und Leistungsdatum. Betriebswerte gehoeren
bewusst nicht dazu -- sonst wuerde das Laden eines alten Projekts den
aktuellen Stundenlohn oder das Steuerregime ueberschreiben.
- Neue Routen: GET /projekte sowie POST /projekte/{speichern,laden,loeschen}.
- Eigenes Lock, gleiche atomare Schreibtechnik wie die Config.
- Ueberschreiben, Laden bei ungespeicherten Aenderungen und Loeschen
fragen jeweils nach.
- Der offene Autosave-Debounce wird vor dem Speichern durchgedrueckt,
damit wirklich der aktuelle Stand ins Projekt geht.
Die beiden Teile stehen in einem Commit, weil die Aenderungen in app.py,
script.js und index.html ineinandergreifen und ein aufgetrennter
Zwischenstand nicht als solcher getestet wurde.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
100 lines
5.0 KiB
Markdown
100 lines
5.0 KiB
Markdown
# AGENTS.md — 3D-Druck Kostenkalkulation
|
|
|
|
## Project structure
|
|
|
|
- `app.py` — Flask web app
|
|
- `templates/index.html` — Hauptseite mit Formular und Live-Ergebnissen
|
|
- `templates/invoice.html` — Rechnungsseite mit PDF-Download
|
|
- `templates/settings.html` — Einstellungsseite (Druckerabschreibung, Arbeitskosten, Marge, MwSt., Firmendaten, Logo)
|
|
- `static/style.css` — Light-/Dark-Mode-Theming
|
|
- `static/script.js` — Live-Berechnung + Auto-Save beim Tippen
|
|
- `druckkalkulation_config.yaml` — auto-created/auto-saved state (in .gitignore)
|
|
- `proxmox-setup.sh` — Proxmox LXC-Ersteinrichtung
|
|
- `proxmox-update.sh` — Proxmox LXC-Update
|
|
- `.venv/` — virtual environment with all deps
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
source .venv/bin/activate
|
|
```
|
|
|
|
**Dependencies**: gepinnt in `requirements.txt` (`pip install -r requirements.txt`).
|
|
`flask`, `fpdf2` (imported as `fpdf`), `PyYAML`. Alle in `.venv`.
|
|
|
|
## Run
|
|
|
|
```bash
|
|
python app.py # Debug aus, lauscht auf 0.0.0.0:5001
|
|
FLASK_DEBUG=1 python app.py # Debug an, dann nur 127.0.0.1
|
|
```
|
|
|
|
`HOST` und `PORT` ueberschreiben die Defaults.
|
|
|
|
Kein Test, Lint, Typecheck oder CI vorhanden. README.md und AGENTS.md enthalten die Projektdokumentation.
|
|
|
|
## Routes
|
|
|
|
| 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 (Druckerabschreibung, Arbeitskosten, Marge, MwSt.) |
|
|
| POST | `/upload_logo` | Logo hochladen (PNG/JPEG/WebP) |
|
|
| POST | `/delete_logo` | Logo loschen |
|
|
|
|
## Config
|
|
|
|
`druckkalkulation_config.yaml` wird beim Start gelesen und bei jeder Eingabe automatisch gespeichert (debounced 500ms via AJAX). Enthaelt alle Formularwerte plus `dark_mode`. Wird automatisch erstellt — kein manuelles Setup.
|
|
|
|
## Wichtige Fallstricke
|
|
|
|
- `fpdf` kommt via `fpdf2`-Paket, Import ist `from fpdf import FPDF`.
|
|
Die Legacy-API (`ln=True`, `output(dest='S')`, Font "Arial") ist abgeloest
|
|
durch `new_x/new_y`, `output()` und "Helvetica" -- nicht zurueckbauen.
|
|
- PDF-Kernfonts koennen nur latin-1. Jeder Freitext muss durch `pdf_text()`,
|
|
sonst wirft die PDF-Route bei Sonderzeichen einen UnicodeEncodeError.
|
|
- `load_config()` wirft `ConfigError`, wenn die YAML kaputt ist. Nicht
|
|
abfangen und auf Defaults zurueckfallen -- das wuerde die Datei beim
|
|
naechsten Autosave endgueltig ueberschreiben.
|
|
- `/save_config` uebernimmt nur Keys aus `DEFAULT_VALUES`.
|
|
- **Steuerlogik**: `steuerregime` ist die Quelle der Wahrheit und kennt drei
|
|
Werte (`STEUERREGIME`): 'privat' | 'kleinunternehmer' | 'regel'.
|
|
'privat' ist rechtlich NICHT dasselbe wie 'kleinunternehmer': ein
|
|
Privatverkaeufer ist kein Unternehmer nach §2 UStG, daher duerfen weder
|
|
§19-Hinweis noch Steuernummer/USt-IdNr. auf den Beleg -- auch dann nicht,
|
|
wenn die Felder in der Config gefuellt sind (`calc['ist_unternehmer']`). `mwst_ausweisen` ist davon *abgeleitet*
|
|
und wird in `_migriere()` gesetzt -- nie direkt schreiben. `_migriere()`
|
|
laeuft in `load_config()` VOR dem Auffuellen mit Defaults (sonst greift
|
|
die Ableitung aus Alt-Configs nicht) und in `/save_config` nach dem
|
|
Update (sonst steht Widerspruechliches auf der Platte).
|
|
- Der MwSt.-Satz kommt aus `mwst_satz`, nicht mehr hartcodiert.
|
|
- **Positionen**: `config['positionen']` ist eine Liste von Dicts mit den
|
|
Feldern aus `DEFAULT_POSITION`. `calculate()` liefert `calc['positionen']`
|
|
(je Position `stueckpreis` und `zeilensumme`) plus die Auftragssummen.
|
|
Jede Liste aus Config oder Client geht durch `saubere_positionen()` --
|
|
nie ungeprueft uebernehmen. Es gibt immer mindestens eine Position.
|
|
- Die Auftragssumme ist die Summe der bereits gerundeten Zeilen, damit die
|
|
Rechnung zeilenweise nachrechenbar bleibt.
|
|
- `sammlePositionen()` im Frontend liefert `null` auf Seiten ohne
|
|
Positionsliste (Einstellungen, Rechnung). Dann darf `positionen` NICHT
|
|
mitgesendet werden -- sonst wuerde ein Tastendruck dort die Positionen
|
|
loeschen.
|
|
- **Projekte**: `druckkalkulation_projekte.yaml` haelt benannte Staende,
|
|
Schluessel ist der Projektname. Nur `PROJEKT_FELDER` werden gesichert --
|
|
Betriebswerte (Marge, Steuer, Drucker, Firmendaten) gehoeren bewusst NICHT
|
|
dazu, sonst wuerde das Laden eines alten Projekts sie ueberschreiben.
|
|
Eigenes Lock `_projekte_lock`, gleiche atomare Schreibtechnik wie die Config.
|
|
Die Preise in der Projektliste werden mit den AKTUELLEN Betriebswerten
|
|
gerechnet, nicht mit denen von damals.
|
|
- `druckkalkulation_config.yaml` ist der Arbeitsstand, nicht das Archiv.
|
|
- Alte Configs mit den Flachfeldern (`materialGewicht` etc.) migriert
|
|
`_migriere()` in eine einzelne Position und entfernt die Altfelder.
|
|
- **Saeamtliche UI-Texte sind Deutsch** — Labels, Fehlermeldungen, Rechnungsinhalte.
|
|
- Nur `.venv/`, `druckkalkulation_config.yaml` und `static/logo.*` werden ignoriert.
|
|
- `3dDruckKalkulator.py` ist die alte Tkinter-Version und wird nicht mehr verwendet (nicht im Tracking).
|