# 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
