kundenkarte/README.md
2026-01-31 08:18:54 +01:00

86 lines
2.8 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
- 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