aufmass-web/_aufmass_web/ANFORDERUNGEN.md

# Anforderungen – AufmaßWeb v2.35

## Projektübersicht
Flask-basierte Webanwendung zur Verwaltung von Aufmaßen, Projekten und Positionen.

---

## 1. Projektübersicht (`/projekt/`)

### 1.1 Sortierung
- Projekte werden nach **Bezeichnung A-Z** aufsteigend sortiert angezeigt
- NULL-Werte werden als leerer String behandelt (sortieren ans Ende)

### 1.2 Projektsuche
- Suchleiste oben auf der Seite
- Clientseitige Filterung nach Projektname (Bezeichnung / SM-Nr)
- Echtzeit-Filterung bei Eingabe, Clear-Button vorhanden

### 1.3 Baumansicht
- Jedes Projekt als aufklappbarer `<details>`-Block
- Zeigt: Bezeichnung, Summe (€), Anzahl Aufmaße, Anzahl Positionen, Status
- Doppelklick auf Projekt-Header navigiert zur Listenansicht (`/projekt/<id>`)

### 1.4 Aufmaß-Suche
- Suchleiste filtert Aufmaß-Namen innerhalb der Baumansicht

### 1.5 Inline-Bearbeitung Aufmaß-Name
- ✏️-Button pro Aufmaß → Inline-Input für Name
- Speichern: Blur oder Enter
- Abbrechen: Escape
- Kein OK/Abbrechen-Button, kein setTimeout

### 1.6 Inline-Bearbeitung Projekt-Name
- ✏️-Button im Projekt-Header → Inline-Input für Name
- Speichern: Blur oder Enter
- Abbrechen: Escape
- POST an `/projekt/<id>/update-name`

### 1.7 Aufmaß löschen
- ✕-Button pro Aufmaß, keine Bestätigung (ohne `confirm()`)
- Redirect per `request.referrer`: in Baumansicht → bleibt in `index`, in Detailansicht → bleibt in `list`

### 1.8 Aufmaß duplizieren
- Duplizieren-Button (📋) pro Aufmaß, keine Bestätigung
- Erstellt Kopie mit allen Positionen, hängt ` (Kopie)` an den Namen
- Bei Namenskonflikt: automatisch ` (1)`, ` (2)` etc.
- Redirect per `request.referrer` (wie Löschen)

### 1.9 Baum-Status persistent
- `<details>` open/close-Zustand in `localStorage`
- Schlüssel: `tree_open_{projectId}`
- Überlebt Seitenneuladungen nach Aktionen

---

## 2. Neues Aufmaß erstellen

### 2.1 Button
- **"+ Neues Aufmaß"**-Button unter jedem Projekt in der Baumansicht
- Klick klappt ein vollständiges Formular auf (slide-down)

### 2.2 Formular-Felder (Reihenfolge)
1. **Vertrag** (Dropdown, optional)
2. **LV-Name** (Text, optional)
3. **Typ** (Dropdown, optional)
4. **Bezeichnung (Baustelle)** (Text, leer)
5. **Bauabschnitt** (Text, pre-filled aus Projekt)
6. **SM-Nr** (Text, pre-filled aus Projekt)
7. **Abruf-Nr** (Text, pre-filled aus Projekt)
8. **Kopfdaten EV holen** (Button, bedingt sichtbar – siehe Abschnitt 11)
9. **Ansprechpartner** (Trennlinie)
   - Vorname
   - Name
   - Tel
   - Email
10. **Startdatum** (Date)
11. **Endedatum** (Date)
12. **Aufmaß-Name** (readonly, automatisch generiert)

### 2.3 Automatische Aufmaß-Namensgenerierung
- Zusammensetzung: `Bezeichnung + " - " + Bauabschnitt + " - " + SM-Nr + " - " + Abruf-Nr`
- Nur nicht-leere Felder werden berücksichtigt
- Wird live bei Eingabe aktualisiert (readonly-Feld)
- Nur OS/Nextcloud-sichere Zeichen: `< > : " / \ | ? * & # % { } ~ [ ]` werden entfernt, Mehrfachleerzeichen → eines

### 2.4 Speichern
- Aktualisiert Projekt-Metadaten (SM-Nr, Vertrag, LV-Name, Abruf-Nr, Daten, Ansprechpartner)
- `project.bezeichnung` wird NICHT überschrieben
- Erstellt neues Aufmaß mit generiertem Namen und gewähltem Typ
- Redirect zur Projektübersicht

---

## 3. Neues Projekt erstellen (`/projekt/neu`)

### 3.1 Formular (vereinfacht)
- **Projektname / Bezeichnung** (Pflichtfeld)
- **Vertrag** (Dropdown, optional)
- **LV-Name** (Dropdown, optional, abhängig von Vertrag)
- Kein Standard-Aufmaß wird automatisch erstellt

---

## 4. Projekt-Listenansicht (`/projekt/<id>`)

### 4.1 Aufmaß-Liste
- Alle Aufmaße eines Projekts als Tabelle
- Inline-Editing für Name, Typ, Status
- Sofortige visuelle Aktualisierung vor async-fetch
- Kein `resp.status`-Check (Server-Response enthält Aufmaß-Status, nicht 'ok')

### 4.2 Projekt-Name inline bearbeiten
- ✏️-Button in der Projektkopfzeile
- Gleiche Funktionalität wie in Baumansicht (POST `/projekt/<id>/update-name`)

### 4.3 Aufmaß erstellen (in Listenansicht)
- Formular mit Name + Typ + Sortierung

### 4.4 TXT-Import
- 📥 Import-Button → Lädt TXT-Datei
- Parst `[Kopfdaten]` + `[Aufmaßdaten]`
- Erstellt Aufmaß mit Positionen
- Bei doppeltem Namen: automatisch ` (1)`, ` (2)` etc. anfügen

---

## 5. Aufmaß-Editor (`/projekt/<id>/<aufmass_id>`)

### 5.1 Positionstabelle
- Inline-Editing für alle Positionsfelder
- Speichern: Blur oder Enter
- Sofortige visuelle Aktualisierung vor async-fetch
- Kein `resp.status`-Check (Server-Response enthält Aufmaß-Status, nicht 'ok')

### 5.2 Zahlenformat
- Alle Zahleneingaben: `type="text" inputmode="decimal"`
- **Deutsches Format**: Komma = Dezimaltrenner, Punkt = Tausendertrenner
- `germanNum()`: Zahl → deutsche Anzeige (z.B. `1.234,56`)
- `parseNum()`: Deutsche Eingabe → Zahl (z.B. `1.234,56` → `1234.56`)
- `sanitizeNum()`: Entfernt ungültige Zeichen live bei Eingabe
- `validateNumField()`: Rote Border bei ungültigem Format
- **Validierung**: Erlaubt sind `123`, `1.234`, `1,5`, `1.234,56`, `-1,5`
  - Ungültig: Buchstaben, `1,2,3`, `1.2.3`, etc.

### 5.3 ST/LE/STD/h/Psch – Menge-Verhalten
- Faktor-Feld ist immer `1,0` (kein Highlight)
- Bei ST/LE/STD/h/Psch wird **Menge** hervorgehoben (amber `#fff3cd`, fett) und ist **leer** – die Menge ist hier das relevante Feld, muss aber vom Benutzer über die Berechnung (Faktor-Eingabe) bestimmt werden
- Bei M/M2/M3 werden die Dimensionsfelder (Länge/Breite/Tiefe) hervorgehoben
- Menge ist readonly und wird automatisch berechnet: ST/LE/STD/h/Psch → `Faktor × 1`, M → Länge, M2 → L×B, M3 → L×B×T

### 5.4 Formel-Auswahl
- **Standard**: Länge × Breite × Tiefe (abhängig von Einheit)
- **Frei**: Eigenes Formelfeld
- Typabhängige Markierung der Pflichtfelder (Länge, Breite, Tiefe) mit amber

### 5.5 Einfüge-Position ("Am Ende anfügen")
- Checkbox "Am Ende anfügen" (default: checked)
- **checked**: Neue Positionen werden am Ende der Tabelle angefügt
- **unchecked**: Neue Positionen werden unterhalb der zuletzt markierten Position eingefügt
- Klick auf eine Position in der rechten Tabelle setzt die Einfügemarke, ohne die LV-Auswahl zu beeinflussen

### 5.6 LV-Tabelle (linke Seite)
- Spalten: Pos-Nr, Kurztext, EP (deutsch formatiert via `|german_number`), Einheit
- Einfachklick: LV-Zeile markieren, Formular füllen
- **Multi-Select**: Strg+Klick markiert mehrere Zeilen
- **Drag & Drop**: Ziehen einer LV-Zeile überträgt alle markierten IDs (nicht nur die gezogene)
- **Standard-Menge bei Drag**: Nach LV-Drag bleibt menge=0 (keine automatische `berechne_menge()`)
- `fillForm()` setzt `currentLVRow` / `currentLVId` pro Zeile
- Klick auf Positionstabelle löscht NICHT `currentLVRow` oder die LV-Auswahl

### 5.7 Hinzufügen-Button
- **"Hinzufügen"** und **"Auswahl hinzufügen"**: Beide verwenden `selectedSet` (alle markierten LV-Zeilen) + Formularwerte (Overrides)
- Bei Mehrfachauswahl (>1 LV-Zeile) werden Text-Overrides (`pos_nr`, `kurztext`, `abschnitt`, `bemerkung`) **nicht** gesendet – jede Position behält ihre LV-eigenen Textwerte
- Dimensions-Overrides (Faktor, Länge, Breite, Tiefe, Formel) werden immer für alle markierten Positionen verwendet
- Beide nutzen `getInsertIdxFromCheckbox()` für die Einfügeposition

### 5.8 Positionen importieren (TXT)
- 📥 Button "Import TXT" im Tabellen-Footer
- Lädt nur `[Aufmaßdaten]` aus einer TXT-Datei
- Fügt Positionen in das aktuelle Aufmaß ein
- Bestehende Kopfdaten bleiben unverändert

### 5.9 Kontext-Menü (Rechtsklick)
- Rechtsklick auf eine Position in der Tabelle öffnet ein Kontext-Menü
- **Markierte löschen** (✕) – löscht alle markierten Positionen (wie Button unten)
- **Markierte kopieren** (📋) – kopiert alle markierten Positionen (wie Button unten)
- **Leere Zeile einfügen** (📄) – fügt eine leere Zeile unterhalb der angeklickten Position ein
- Beim Rechtsklick ohne Ctrl/Shift wird die angeklickte Zeile zuerst selektiert (Single-Select)
- Rechtsklick auf Trenner/Leerzeilen ist ebenfalls möglich (setzt Einfügepunkt)
- Menü schließt bei Klick außerhalb oder Escape

### 5.10 Spalten-Filter (Excel-ähnlich)
- Jede Spaltenüberschrift (außer Z-Art und ✕) hat einen ▾-Filterbutton
- Klick öffnet ein Dropdown-Menü mit:
  - **↑ Aufsteigend / ↓ Absteigend sortieren** (Sortierung aufheben mit ✕)
  - **Suchen…** (Livesuche filtert Werte-Liste + Tabelle)
  - **Checkbox-Liste** aller vorkommenden Werte mit **Alles**/**Nichts**
- Mehrere Spalten können gleichzeitig gefiltert werden (Und-Verknüpfung)
- Aktive Filter werden durch blaue ▾-Buttons angezeigt
- **↺ Filter zurücksetzen**-Button lädt die Tabelle neu und entfernt alle Filter
- Nur Datenzeilen (mit `data-id`) werden gefiltert – Trenner bleiben sichtbar
- Sortieren + Filtern sind kombinierbar und wirken nur clientseitig (Ansichtsfilter)
- Einfügen, Löschen und Bearbeiten sind auch im gefilterten Zustand möglich

### 5.11 Export (Excel, PDF, TXT) mit Ansichtsfilter
- Buttons: **📊 Excel**, **📄 PDF**, **📄 TXT** in der Kopfzeile
- Checkbox **"Aktuelle Ansicht"** – wenn aktiv, werden nur sichtbare (gefilterte) Positionen exportiert
- TXT-Export erzeugt UTF-8-Datei im Format `[Kopfdaten]` + `[Aufmaßdaten]` (pipe-separiert)
- Export-Route akzeptiert `?visible_ids=1,2,3` zum Filtern

### 5.12 LV-Tabelle Filter
- Gleiches Filter-UI wie Positionstabelle (▾-Buttons in Spaltenüberschriften)
- Spalten: Pos-Nr, Kurztext, EH, EP
- **Sortieren** (↑/↓) und **Suchen** (Text-Livesuche)
- Keine Checkbox-Liste (LV hat zu viele unique values)
- Aktive Filter werden durch blaue ▾-Buttons angezeigt

### 5.13 Spaltenbreite anpassen (ziehen)
- Jede Spaltenüberschrift hat rechts einen unsichtbaren Resize-Handle (5px breit)
- **Ziehen**: Breite ändert sich live, bei Loslassen in `localStorage` gespeichert
- **Doppelklick** auf Handle: automatische optimale Breite (maximale Inhaltsbreite)
- **Rechtsklick** auf Spaltenkopf → Kontext-Menü mit **"💾 Ansicht speichern"**
  - Fixiert die aktuellen Spaltenbreiten als `saved_lv_col_widths` / `saved_pos_col_widths`
  - Nach Seitenneuladung werden gespeicherte Breiten wiederhergestellt
- Funktion `saveColumnWidths()` speichert aktuelle Breiten separat als "gespeicherte Ansicht"
- Gespeicherte Breiten überleben Seitenneuladungen (werden sofort beim Laden angewandt)

### 5.14 Positionstabelle Farben
- `has-background-warning-light` (gelb) nur wenn Wert=0 UND passende Einheit (z.B. Menge=0 bei ST)

### 5.10 LV-Ergebnis EP
- EP-Werte in der LV-Tabelle werden mit deutschem Zahlenformat angezeigt (`|german_number`)

---

## 6. Datenbank

### 6.1 Projekt-Modell (`projekte`)
- `id`, `company_id`, `contract_id`
- `sm_nr`, `bezeichnung`, `vertrag`, `abruf_nr`, `lv_name`
- `datum_start`, `datum_ende`
- `ansprechpartner_vorname`, `ansprechpartner_nachname`, `ansprechpartner_tel`, `ansprechpartner_email`
- `bauabschnitt`, `status`
- `erstellt_von`, `erstellt_am`, `geaendert_am`

### 6.2 Lizenz-Modell (`lizenzen`)
- `uid` (auto-generiert SHA256)
- `max_mitarbeiter`, `max_module_slots`
- `unlimited_users`, `unlimited_modules`
- Properties: `used_users`, `used_module_slots`, `user_slots_display()`, `module_slots_display()`

### 6.3 Datenbank-Engine
- Lokal: SQLite (`data/aufmass.db`)
- Produktion: PostgreSQL via `DATABASE_URL` Umgebungsvariable
- Docker-Setup mit PostgreSQL-Service vorhanden

---

## 7. Docker

### 7.1 Services
- `db`: PostgreSQL 16-alpine mit Healthcheck
- `web`: Flask-App mit Gunicorn (4 Worker)

### 7.2 Konfiguration
- `DATABASE_URL` wird via Environment Variable gesetzt
- `SECRET_KEY` muss vor Produktion geändert werden
- Volume `pgdata` für persistente Daten

---

## 8. Rollen & Berechtigungen

### 8.1 Superadmin
- Zugriff auf alle Projekte, Firmen, Lizenzen
- Firmenverwaltung & Lizenzverwaltung im Menü
- Dashboard: Lizenz-Statistiken, Firmen-Übersicht

### 8.2 Firmadmin
- Zugriff auf Projekte der eigenen Firma
- Mitarbeiterverwaltung, Rechteverwaltung
- Lizenz-Übersicht

### 8.3 Mitarbeiter
- Zugriff nur auf zugewiesene Projekte (ProjectAccess)
- Berechtigungen: lesen, schreiben, aufmass_verwalten, projekte_anlegen, darf_preise_sehen, darf_lv_verwalten

---

## 9. Login-Daten

| Rolle | Email | Passwort |
|---|---|---|
| Superadmin | super@admin.de | admin123 |
| Firmadmin | firmadmin@kpt.de | firma123 |

---

## 10. Wichtige technische Regeln

### 10.1 Inline-Edit
- Blur/Enter speichert, Escape bricht ab
- Keine OK/X-Buttons, kein setTimeout

### 10.2 Visuelle Aktualisierung
- SOFORT vor async-fetch, nicht im Callback

### 10.3 Server-Response (resp.status)
- **`resp.status`** ist das Aufmaß-Statusfeld ('aktiv'), NICHT ein Erfolgsindikator
- **Kein `resp.status !== 'ok'`-Check**

### 10.4 Projekt-Name schützen
- `project.bezeichnung` wird in `aufmass_neu_voll` und `aufmass_import` NICHT überschrieben
- Nur explizit via `POST /projekt/<id>/update-name` änderbar

### 10.5 Redirect-Verhalten
- Löschen, Duplizieren, Import: `request.referrer` prüfen
- Baumansicht (`/projekt/`) → Redirect zu `aufmass.index`
- Detailansicht (`/projekt/<id>`) → Redirect zu `aufmass.aufmass_list`
- Erkennung: `referrer.rstrip('/').endswith('/projekt')`

### 10.6 Namensvalidierung
- Aufmaß-Name: nur OS/Nextcloud-sichere Zeichen
- Entfernt: `< > : " / \ | ? * & # % { } ~ [ ]`
- Mehrfachleerzeichen → eines

---

## 11. E-Vergabe Addon

### 11.1 Firmeneinstellungen (Firmadmin)
- Neuer Bereich **"E-Vergabe"** in den Firmeneinstellungen (`/admin/firma`)
- Sichtbar nur wenn E-Vergabe-Addon für die Firma freigeschaltet ist (durch Superadmin)
- Felder:
  - **Benutzer** (aus `_legacy/daten/conf.ini` → `[EVergabe] Benutzer`)
  - **Passwort** (aus `_legacy/daten/conf.ini` → `[EVergabe] Passwort`)
  - **Name** (aus `_legacy/daten/conf.ini` → `[EVergabe] Name`)

### 11.2 Superadmin – E-Vergabe Addon freigeben
- Superadmin kann E-Vergabe-Addon pro Firma freischalten/deaktivieren
- Dashboard: Spalte "E-Vergabe" mit Status und Toggle-Button (EV +/EV ✕)
- Firma-Detail: E-Vergabe-Bereich mit Status und Freischalten/Deaktivieren-Button

### 11.3 Berechtigungen (User-Ebene)
Drei neue Berechtigungen für Mitarbeiter:
- **E-Vergabe Addon nutzen** (`darf_evergabe_nutzen`) – Grundvoraussetzung für alle E-Vergabe-Funktionen
- **Kopfdaten holen erlauben** (`darf_kopfdaten_holen`) – Erlaubt das Abrufen von Kopfdaten aus der E-Vergabe
- **Aufmaße in E-Vergabe übertragen** (`darf_aufmass_uebertragen`) – Erlaubt das Übertragen von Aufmaßen

### 11.4 "Kopfdaten EV holen" Button
- Sichtbar nur wenn:
  - User hat `darf_evergabe_nutzen` UND `darf_kopfdaten_holen`
  - Firma hat `evergabe_aktiviert = True`
- Anklickbar nur wenn:
  - Firma hat `evergabe_benutzer` UND `evergabe_passwort` hinterlegt
- Mouseover-Hinweis wenn nicht anklickbar: *"Es sind keine E-Vergabe Logindaten hinterlegt."*
- Funktion: Ruft Kopfdaten von der E-Vergabe-API ab und füllt die Formularfelder (Bezeichnung, Bauabschnitt, SM-Nr, Abruf-Nr, Daten, Ansprechpartner)

### 11.5 Company-Modell (neue Felder)
- `evergabe_aktiviert` (Boolean, default=False) –Addon freigeschaltet
- `evergabe_benutzer` (String) – Login-Benutzername
- `evergabe_passwort` (String) – Login-Passwort
- `evergabe_name` (String) – Name/Kennung

### 11.6 E-Vergabe Service (`evergabe_service.py`)
Python-Port der AutoIt `EVvergabeWebobj.au3` Funktionen:
- **`EVergabeClient`** Klasse mit `requests.Session()` für Cookie-Handling
- **`login()`** – Login via POST `/public/login` mit CSRF-Token-Extraktion
- **`search_sm(sm_nr)`** – SM-Nr-Suche via GET `/framework-agreement-call`, extrahiert Title, Bedarfsnr, Belegnr, DetailsID, RV, Daten, Status
- **`get_aspa(details_id)`** – Ansprechpartner-Daten (Name, Email, Tel) aus Details-Seite
- **`hole_kopfdaten(sm_nr)`** – Kombiniert Login + Suche + ASPA → Rückgabe aller Kopfdaten
- **`aufmass_uebertragen(sm_nr, positionen, ...)`** – Überträgt Positionen in E-Vergabe:
  - Erstellt Sheet via `/sheet/create-sheet`
  - Für jede Position: Erstellt Position, dann INSERT je nach Einheit (ST, M, M2, M3, STD, LE)
  - Richtige Headers: User-Agent, Referer, Content-Type, CSRF-Token
  - URL-Encoding aller Parameter

### 11.7 Aufmaß in E-Vergabe übertragen
- Route: `POST /projekt/<id>/aufmass/<aufmass_id>/evergabe-uebertragen`
- Berechtigung: `darf_evergabe_nutzen` + `darf_aufmass_uebertragen`
- Überträgt alle Positionen des Aufmaßes in die E-Vergabe-Plattform
- Rückgabe: JSON mit Erfolg/Fehler pro Position
- `evergabe_sub` (String) – Sub-Kennung

### 11.8 User-Modell (neue Felder)
- `darf_evergabe_nutzen` (Boolean, default=False)
- `darf_kopfdaten_holen` (Boolean, default=False)
- `darf_aufmass_uebertragen` (Boolean, default=False)