# KFE Viewer

Leichtgewichtiger Web-Viewer für die ZVEH-Kalkulationshilfe (KFE). Liest die
dBase/FoxPro-Dateien des originalen KFE-Viewers direkt ein – keine Konvertierung,
keine Abhängigkeiten außer Python ≥ 3.8.

## Daten

Die KFE-Daten sind **nicht** in diesem Repository enthalten. Sie sind lizenzpflichtig
(Herausgeber ZVEH, Vertrieb META Handelsgesellschaft). Benötigt wird das Datenverzeichnis des
originalen KFE-Viewers, auf der KFE-CD unter `0_software/KFE_ViewerCD3/Daten`. Darin liegen
u. a. `KFE.DBF`/`.FPT`, `VORTEXT.DBF`/`.FPT`, `GRUPPEN.DBF`, `STDPARAM.DAT`, `LOHNSTD.DBF` und `Projekt/*.prj`.

Am einfachsten kopierst du den Inhalt nach `./data` (per `.gitignore` ausgeschlossen) oder gibst den Pfad mit `--data` an.

## Start

```bash
python server.py
```

Öffnet automatisch http://127.0.0.1:8765. Unter Windows geht auch ein Doppelklick auf `start.bat`.

| Option | Bedeutung |
|---|---|
| `--data PFAD` | Verzeichnis mit `KFE.DBF`. Standard: `./data`, alternativ `../2020-05-12-NEU/0_software/KFE_ViewerCD3/Daten` |
| `--port 8765` | Port |
| `--host 0.0.0.0` | im LAN erreichbar machen |
| `--no-browser` | Browser nicht automatisch öffnen |
| `--static kfe.html` | eine einzelne HTML-Datei mit eingebetteten Daten erzeugen (ohne Server nutzbar, ca. 5 MB) |

Alle Optionen lassen sich auch per Umgebungsvariable setzen: `KFE_DATA`, `KFE_HOST`, `KFE_PORT`, `KFE_NO_BROWSER=1`.

## Docker

Das Image enthält nur die App (ca. 80 MB, Basis `python:3.13-alpine`, läuft als Nicht-root-Benutzer).
Die Daten werden schreibgeschützt nach `/data` gemountet.

```bash
cp .env.example .env      # KFE_DATA_DIR auf das Datenverzeichnis setzen (Standard: ./data)
docker compose up -d --build
```

Danach erreichbar unter http://127.0.0.1:8765. Weitere Befehle: `docker compose logs`, `docker compose down`.
Für Zugriff aus dem LAN in `compose.yaml` den Port auf `"8765:8765"` ändern.

Ohne Compose:

```bash
docker build -t kfe-viewer .
docker run -d -p 127.0.0.1:8765:8765 -v /pfad/zu/Daten:/data:ro --name kfe-viewer kfe-viewer
```

## Funktionen

- **Live-Suche** über Positionsnummer, Matchcode, Kurztext, Zusatztext und optional den Langtext (Vortext)
  - mehrere Begriffe = UND, `-wort` schließt aus, `"genaue phrase"`
  - `04.03` sucht nach Positionsnummer-Präfix
  - Umlaute/Komma egal: `schutzkontakt` findet „Schutzkontakt“, `3x1.5` findet „3x1,5“
- **Filter** mit Trefferzahlen: Kapitel → Gruppe, Einheit, Lohngruppe, Rohstoff (Cu/Al), Änderungsjahr, Bauzeit- und Preisbereich
- **Kalkulation live**: Stundensätze je Lohngruppe (Satz 1/2 oder eigene), Materialzuschlag, Bauzeitfaktor,
  aktuelle DEL-Notiz für Kupfer/Aluminium (Rohstoff-Mehr-/Minderpreis), netto/brutto
- **Detailansicht** mit Langtext, Kalkulationsaufschlüsselung, den vier KFE-Kalkulationssätzen, Rohstoffdaten
- **Merkliste** mit Mengen, Summen (Lohn/Material/netto/brutto/Bauzeit) und CSV-Export; die 60 Muster-LVs
  (`Daten/Projekt/*.prj`) lassen sich direkt übernehmen
- URL enthält Suche und Filter (Lesezeichen/teilen), Tastatur: `/` Suche, `↑`/`↓` Auswahl, `Enter` Details, `+` merken, `Esc` schließen
- Hell/Dunkel-Modus, mobil nutzbar

## Preisformel

```
EP = Bauzeit[min] × Bauzeitfaktor × Stundensatz(LG) / 60  +  (Material + Rohstoffzuschlag) × (1 + Zuschlag %)
Rohstoffzuschlag = (DEL − Basis) / 100 × Cu-Zahl[kg/km] / 1000
```

Mit den Standardwerten (43,75 €/h, 20 %, Cu 550) stimmen die Preise mit dem GAEB-Export der KFE überein.