# 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
- Flexible Systemkategorien (z.B. Strom, Internet, Kabel, Sat)
- 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)

### 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

## 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