feat: Add KI-Einstiegsscript for comprehensive project overview
- Introduced `ki_project_overview.py` for automated analysis of EspoCRM project structure, entities, relationships, custom PHP classes, workflows, frontend adjustments, and internationalization. - Created `ki-overview.sh` wrapper script for executing the Python script with various output options. - Updated `README.md` to include a quick start section for the new KI entry script. - Added detailed documentation in `KI_OVERVIEW_README.md` explaining the script's purpose, usage, and output format. - Summarized the new features and files in `KI_OVERVIEW_SUMMARY.md`. - Enhanced `.vscode/settings.json` to approve new scripts for execution.
This commit is contained in:
69
README.md
69
README.md
@@ -1,5 +1,22 @@
|
||||
KI-basierte Bearbeitung von EspoCRM: Struktur und Funktionsweise
|
||||
|
||||
## 🚀 Schnellstart für KI
|
||||
|
||||
**NEU:** Automatisches KI-Einstiegsscript für vollständigen Projekt-Überblick!
|
||||
|
||||
```bash
|
||||
# Vollständige Projekt-Analyse für KI
|
||||
./custom/scripts/ki-overview.sh
|
||||
|
||||
# Nur Schnellübersicht
|
||||
./custom/scripts/ki-overview.sh --stats
|
||||
|
||||
# In Datei speichern
|
||||
./custom/scripts/ki-overview.sh --file /tmp/overview.txt
|
||||
```
|
||||
|
||||
Das Script analysiert automatisch alle Entitäten, Beziehungen, Custom Code, Workflows und Frontend-Anpassungen. Siehe [KI_OVERVIEW_README.md](custom/scripts/KI_OVERVIEW_README.md) für Details.
|
||||
|
||||
## Inhaltsverzeichnis
|
||||
1. [Überblick](#überblick)
|
||||
2. [Custom Directory Struktur](#custom-directory-struktur)
|
||||
@@ -48,9 +65,7 @@ Keine integrierte KI-Schnittstelle existiert, aber mit Dateizugriff können auto
|
||||
|
||||
**Zentrales Tool:** `custom/scripts/validate_and_rebuild.py`
|
||||
|
||||
**NEU ab Januar 2026:** Erweitertes Python-basiertes Validierungs-Tool mit automatischen Checks!
|
||||
|
||||
Dieses Script sollte **IMMER** verwendet werden (nicht manueller Rebuild). Es führt automatisch aus:
|
||||
Dieses Script sollte **IMMER** verwendet werden (niemals manueller Rebuild). Es führt automatisch aus:
|
||||
|
||||
✅ **Validierungen:**
|
||||
- JSON-Syntax-Prüfung aller `.json` Dateien im `custom/` Verzeichnis
|
||||
@@ -1356,28 +1371,6 @@ docker exec espocrm php /var/www/html/custom/scripts/workflow_manager.php import
|
||||
/var/www/html/custom/workflows/vmh-erstberatung-abschliessen.json
|
||||
```
|
||||
|
||||
### Workflow-Entwicklung mit KI
|
||||
|
||||
Für KI-gestützte Workflow-Erstellung:
|
||||
1. Workflow-Definition im `custom/workflows/` Verzeichnis als JSON ablegen
|
||||
2. Mit `import` Befehl in EspoCRM einspielen
|
||||
3. Im Admin-Interface testen und bei Bedarf anpassen
|
||||
4. Mit `export` Befehl aktualisierten Workflow sichern
|
||||
5. JSON-Datei im Repository committen
|
||||
## Projektziele und Zukunftsvision: "Vermieterhelden"
|
||||
|
||||
Das Projekt "Vermieterhelden" ist ein maßgeschneidertes Backend-System auf Basis von EspoCRM für eine Anwaltskanzlei, spezialisiert auf die Durchführung und Verwaltung von immobilienrechtlichen Klagen (z. B. Räumungsklagen, Mietinkasso). Der aktuelle Fokus liegt auf der strukturierten Verwaltung von Stammdaten (Entitäten wie Mietverhältnisse, Mietobjekte, Beteiligte, Dokumente und Klagen) und der Abbildung von rechtlichen Workflows (z. B. automatisierte Tasks bei Statusänderungen, Fristen-Überwachung).
|
||||
|
||||
Zukünftige Ziele:
|
||||
- **Customer Portal**: Integration eines Mandanten-Portals, damit Klienten (Mieter/Vermieter) selbst auf relevante Daten zugreifen können (z. B. Status von Klagen, Dokumente hochladen). Dies nutzt EspoCRMs eingebaute Portal-Funktionalität für Self-Service.
|
||||
- **KI-Integration über Middleware**: Automatisierung von Prozessen via Webhooks und externer Middleware. Beispiele:
|
||||
- Automatische Analyse von Dokumenten (z. B. Verträge scannen und Felder extrahieren).
|
||||
- Intelligente Fristen-Erinnerungen basierend auf rechtlichen Regeln (z. B. Kündigungsfristen berechnen).
|
||||
- Workflow-Optimierung (z. B. Vorschläge für nächste Schritte in Klage-Prozessen).
|
||||
- Die KI soll über APIs/Webhooks angebunden werden, ohne EspoCRMs Core zu modifizieren, um Stabilität zu wahren.
|
||||
- **Erweiterte Features**: Mehrsprachigkeit, Mandanten-Isolation für mehrere Kanzlei-Teams, Integration mit externen Systemen (z. B. Gerichts-APIs, Buchhaltung).
|
||||
|
||||
Die KI kann diese Ziele unterstützen, indem sie JSON-Strukturen analysiert, Änderungen vorschlägt (z. B. neue Felder für Compliance) und Workflows modelliert. Das System soll skalierbar und benutzerfreundlich sein, um die Effizienz in der Rechtsbranche zu steigern.
|
||||
|
||||
6. Bearbeitung von Entitäten und Layouts
|
||||
|
||||
@@ -1482,32 +1475,6 @@ Um Relationship-Panels und Links korrekt zu beschriften, müssen Labels in den i
|
||||
- Bei Relationship-Problemen: Logs nach "404" und "Link does not exist" durchsuchen: `tail -n 500 /var/lib/docker/volumes/vmh-espocrm_espocrm/_data/data/logs/espo-$(date +%Y-%m-%d).log | grep -A 3 "404\|Link does not exist"`
|
||||
- Bei DB-Problemen: Custom-Scripts wie `workflow_manager.php` verwenden.
|
||||
|
||||
### Check & Rebuild Script
|
||||
|
||||
Das Script `custom/scripts/check_and_rebuild.sh` automatisiert die Qualitätssicherung und führt folgende Prüfungen durch:
|
||||
|
||||
1. **JSON-Syntax-Validierung**: Prüft alle `.json` Dateien im `custom/` Verzeichnis auf gültiges JSON
|
||||
2. **Dateirechte-Prüfung**: Stellt sicher, dass alle Dateien `www-data:www-data` als Owner haben
|
||||
3. **System-Checks**: Validiert Existenz von Cache- und Logs-Verzeichnissen
|
||||
4. **Automatischer Rebuild**: Bei Fehlerfreiheit wird der Rebuild durchgeführt
|
||||
|
||||
**Verwendung:**
|
||||
```bash
|
||||
# Im EspoCRM-Root-Verzeichnis ausführen
|
||||
./custom/scripts/check_and_rebuild.sh
|
||||
```
|
||||
|
||||
**Ausgabe:**
|
||||
- ✓ Grün: Alles in Ordnung
|
||||
- ⚠ Gelb: Warnungen (Rebuild wird trotzdem ausgeführt)
|
||||
- ✗ Rot: Fehler (Rebuild wird NICHT ausgeführt)
|
||||
|
||||
**Bei Berechtigungsfehlern:**
|
||||
```bash
|
||||
sudo chown -R www-data:www-data custom/
|
||||
sudo find custom/ -type f -name "*.json" -exec chmod 664 {} \;
|
||||
sudo find custom/ -type d -exec chmod 775 {} \;
|
||||
```
|
||||
|
||||
## 9. Reports und Report-Panels
|
||||
|
||||
|
||||
Reference in New Issue
Block a user