kundenkarte/README.md
data 71272fa425 fix(schematic): Terminal-Farbpropagierung, Auto-Naming, PWA-Abgänge
- buildTerminalPhaseMap: Schritt 1b - Leitungen mit expliziter Farbe als
  Startpunkte (nur Gerät→Gerät, keine Abgänge)
- buildTerminalPhaseMap: Block-Durchreichung (Top↔Bottom) entfernt
- buildTerminalPhaseMap: Junction-Verbindungen (Terminal→Leitung)
  bidirektional verarbeitet via _connectionById Index
- PWA: Abgangs-Rendering mit Index-Fallback wenn source_terminal_id fehlt
- PWA: Abgangs-Labels max-height 130px, min-height 30px
- Auto-Naming: EquipmentCarrier create/update → 'R' + count
- Auto-Naming: EquipmentPanel update → 'Feld ' + count
- pwa_api.php: Hardcoded Fallbacks 'Feld'/'Hutschiene' entfernt
- pwa.js: Hutschiene Auto-Naming dynamisch aus Panel-Carrier-Anzahl
- kundenkarte.js: Carrier-Dialog Placeholder 'z.B. R1 (automatisch)'
- SW Cache auf v12.5 hochgezählt

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-17 09:57:58 +01:00

117 lines
4.6 KiB
Markdown
Executable file

# KUNDENKARTE FOR [DOLIBARR ERP & CRM](https://www.dolibarr.org)
## Features
Das KundenKarte-Modul erweitert Dolibarr um zwei wichtige Funktionen fuer Kunden und deren Kontakte/Adressen:
### Favoriten-Produkte
- Verwalten von Lieblingsprodukten pro Kunde oder Kontakt/Adresse
- Schnelle Bestellgenerierung aus Favoriten
- Individuelle Standardmengen pro Produkt
- Sortierbare Liste mit Drag & Drop oder Pfeiltasten
### Technische Anlagen (Anlagen)
- Hierarchische Baumstruktur fuer technische Installationen
- Drag & Drop Sortierung der Elemente innerhalb einer Ebene
- Flexible Systemkategorien (z.B. Strom, Internet, Kabel, Sat)
- Kategorie-Auswahl beim Erstellen: Gebaeude/Standort oder Element/Geraet
- Typ-Select mit FontAwesome-Icons und Farbkodierung (Select2)
- Gebaeude-Typen gruppiert nach Ebene (Gebaeude, Etage, Fluegel, Raum, Bereich)
- Konfigurierbare Element-Typen mit individuellen Feldern
- Datei-Upload mit Bild-Vorschau und PDF-Anzeige
- Separate Verwaltung pro Kunde oder pro Kontakt/Adresse (z.B. verschiedene Gebaeude)
- Kabelverbindungen zwischen Anlagen-Elementen dokumentieren
- Visuelle Darstellung mit parallelen vertikalen Linien fuer jedes Kabel
- Automatische Gruppierung mit Abstaenden zwischen Kabel-Gruppen
### Verteilungsdokumentation (Schaltplan-Editor)
- Interaktiver SVG-basierter Schaltplan-Editor
- Felder (Panels) und Hutschienen visuell verwalten
- Equipment-Bloecke per Drag & Drop positionieren
- Sammelschienen (Busbars) fuer Phasenverteilung mit konfigurierbaren Typen
- Phasenschienen per Drag & Drop verschiebbar (auch zwischen Hutschienen)
- Verbindungen zwischen Geraeten zeichnen (automatisch oder manuell)
- Abgaenge und Anschlusspunkte dokumentieren
- Klickbare Hutschienen zum Bearbeiten
- Zoom und Pan fuer grosse Schaltplaene
- Block-Bilder fuer Equipment-Typen (individuelle Darstellung)
- Reihenklemmen mit gestapelten Terminals (Mehrstockklemmen)
- Bruecken zwischen Reihenklemmen
### PDF Export
- Export der Anlagenstruktur als PDF
- Upload einer PDF-Vorlage als Briefpapier/Hintergrund
- Konfigurierbare Schriftgroessen (Ueberschriften, Inhalte, Felder)
- Professionelle Baumdarstellung mit farbcodierten Ebenen und Rahmen
### Kontakt/Adressen-Unterstuetzung
- Beide Funktionen (Favoriten + Anlagen) sind sowohl auf Kundenebene als auch auf Kontakt-/Adressebene verfuegbar
- Ideal fuer Kunden mit mehreren Standorten/Gebaeuden
- Vollstaendige Trennung der Daten zwischen Kunde und Kontakten
## Tabs
Das Modul fuegt folgende Tabs hinzu:
| Tab | Objekt | Beschreibung |
|-----|--------|--------------|
| Favoriten | Kunde (Thirdparty) | Favoriten-Produkte fuer den Kunden |
| Favoriten | Kontakt/Adresse | Favoriten-Produkte fuer einen spezifischen Kontakt |
| Anlagen | Kunde (Thirdparty) | Technische Anlagen des Kunden |
| Anlagen | Kontakt/Adresse | Technische Anlagen eines spezifischen Kontakts/Gebaeudes |
## Admin-Bereich
Im Admin-Bereich (Home > Setup > Module > KundenKarte) koennen Sie:
- **Anlagen-Systeme**: System-Kategorien anlegen (z.B. Strom, Internet)
- **Element-Typen**: Geraetetypen definieren (z.B. Zaehler, Router, Wallbox)
- **Typ-Felder**: Individuelle Felder pro Geraetetyp konfigurieren
- **Gebaeudetypen**: Strukturtypen (Haus, Etage, Raum etc.) fuer die Gebaeude-Hierarchie
- **Kabeltypen**: Verbindungsmedien (NYM, NYY, CAT etc.) mit Spezifikationen
- **Equipment-Typen**: Schaltplan-Komponenten (z.B. Sicherungsautomaten, FI-Schalter) mit Breite (TE), Farbe und Terminal-Konfiguration
- **Phasenschienen-Typen**: Sammelschienen/Phasenschienen-Vorlagen (L1, L2, L3, N, PE, 3P+N etc.) mit Farben und Linien-Konfiguration
## Berechtigungen
| Berechtigung | Beschreibung |
|--------------|--------------|
| kundenkarte read | Favoriten und Anlagen ansehen |
| kundenkarte write | Favoriten und Anlagen bearbeiten |
| kundenkarte delete | Favoriten und Anlagen loeschen |
## Installation
### Voraussetzungen
- Dolibarr ERP & CRM >= 19.0
- PHP >= 7.1
### Installation via ZIP
1. ZIP-Datei herunterladen
2. In Dolibarr: Home > Setup > Module > Externes Modul deployen
3. ZIP-Datei hochladen
4. Modul aktivieren unter Home > Setup > Module
### Manuelle Installation
1. Modul-Ordner in `/custom/kundenkarte` kopieren
2. In Dolibarr: Home > Setup > Module
3. Modul "KundenKarte" aktivieren
### Nach der Aktivierung
- Die SQL-Tabellen werden automatisch erstellt
- Systemkategorien und Typen im Admin-Bereich anlegen
- Fertig!
## Translations
Uebersetzungen befinden sich in:
- `langs/de_DE/kundenkarte.lang` (Deutsch)
- `langs/en_US/kundenkarte.lang` (Englisch)
## License
GPLv3 or (at your option) any later version. See file COPYING for more information.
## Author
Alles Watt laeuft - Eduard Wisch