README und AGENTS.md aktualisiert

This commit is contained in:
Erik Thiele
2026-07-02 17:12:10 +02:00
parent 542ad959bd
commit c5b52f4c1c
2 changed files with 26 additions and 9 deletions

View File

@@ -2,13 +2,15 @@
## Project structure ## Project structure
- `app.py` — Flask web app (ersetzt das fruehere Tkinter-GUI) - `app.py` — Flask web app
- `3dDruckKalkulator.py` — alte Tkinter-Version (nicht mehr verwenden)
- `templates/index.html` — Hauptseite mit Formular und Live-Ergebnissen - `templates/index.html` — Hauptseite mit Formular und Live-Ergebnissen
- `templates/invoice.html` — Rechnungsseite mit PDF-Download - `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/style.css` — Light-/Dark-Mode-Theming
- `static/script.js` — Live-Berechnung + Auto-Save beim Tippen - `static/script.js` — Live-Berechnung + Auto-Save beim Tippen
- `druckkalkulation_config.yaml` — auto-created/auto-saved state - `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 - `.venv/` — virtual environment with all deps
## Setup ## Setup
@@ -38,7 +40,9 @@ Kein Test, Lint, Typecheck oder CI vorhanden. README.md und AGENTS.md enthalten
| GET | `/invoice` | Rechnungsseite | | GET | `/invoice` | Rechnungsseite |
| POST | `/invoice/pdf` | PDF-Download | | POST | `/invoice/pdf` | PDF-Download |
| POST | `/export` | TXT-Download | | POST | `/export` | TXT-Download |
| GET | `/settings` | Einstellungsseite (Druckerabschreibung, Arbeitskosten, Marge) | | GET | `/settings` | Einstellungsseite (Druckerabschreibung, Arbeitskosten, Marge, MwSt.) |
| POST | `/upload_logo` | Logo hochladen (PNG/JPEG/WebP) |
| POST | `/delete_logo` | Logo loschen |
## Config ## Config
@@ -48,5 +52,5 @@ Kein Test, Lint, Typecheck oder CI vorhanden. README.md und AGENTS.md enthalten
- `fpdf` kommt via `fpdf2`-Paket, Import ist `from fpdf import FPDF` (alte API). - `fpdf` kommt via `fpdf2`-Paket, Import ist `from fpdf import FPDF` (alte API).
- **Saeamtliche UI-Texte sind Deutsch** — Labels, Fehlermeldungen, Rechnungsinhalte. - **Saeamtliche UI-Texte sind Deutsch** — Labels, Fehlermeldungen, Rechnungsinhalte.
- Nur `.venv/` und `druckkalkulation_config.yaml` ignorieren (kein `.gitignore` vorhanden). - Nur `.venv/`, `druckkalkulation_config.yaml` und `static/logo.*` werden ignoriert.
- `3dDruckKalkulator.py` ist die alte Tkinter-Version und wird nicht mehr verwendet. - `3dDruckKalkulator.py` ist die alte Tkinter-Version und wird nicht mehr verwendet (nicht im Tracking).

View File

@@ -94,13 +94,26 @@ static/style.css # Minimales Custom-CSS
static/script.js # Live-Berechnung + Auto-Save static/script.js # Live-Berechnung + Auto-Save
proxmox-setup.sh # Ersteinrichtung LXC-Container proxmox-setup.sh # Ersteinrichtung LXC-Container
proxmox-update.sh # Update LXC-Container proxmox-update.sh # Update LXC-Container
druckkalkulation_config.yaml # Automatisch erstellte Konfiguration druckkalkulation_config.yaml # Automatisch erstellte Konfiguration (ignoriert)
3dDruckKalkulator.py # Alte Tkinter-Version (unused)
``` ```
## 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 ## Hinweise
- `fpdf2` wird als `fpdf` importiert (alte API, `from fpdf import FPDF`) - `fpdf2` wird als `fpdf` importiert (alte API, `from fpdf import FPDF`)
- Alle UI-Texte sind Deutsch - Alle UI-Texte sind Deutsch
- Die YAML-Config wird automatisch erstellt und bei jedem Tastendruck gespeichert - Die YAML-Config wird automatisch erstellt und bei jedem Tastendruck gespeichert
- Die alte `3dDruckKalkulator.py` (Tkinter) wird nicht mehr verwendet - `druckkalkulation_config.yaml` und `static/logo.*` sind in `.gitignore` ausgeschlossen