Floke/Brancheneinstufung2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Structure documentation, archive legacy files and clean up docker-compose.yml [30388f42]

Browse Source
This commit is contained in:
Floke
2026-03-05 21:30:16 +00:00
parent 149d69c03d
commit bffd400878
52 changed files with 6 additions and 427 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
docs/UNSUBSCRIBE_FEATURE_SUMMARY.md Normal file
View File

@@ -0,0 +1,33 @@
# Abschluss des Features "Unsubscribe-Link"
## Zusammenfassung der Implementierung
In dieser Session wurde eine vollständige, sichere Unsubscribe-Funktion für die Marketing-Automation im `company-explorer` implementiert. Dies umfasst ein Datenbank-Update mit sicheren Tokens, einen öffentlichen API-Endpunkt zur Abmeldung und die Integration in den SuperOffice-Provisionierungsprozess.
## Nächste technische Schritte zur Inbetriebnahme
Um das Feature vollständig zu nutzen, sind die folgenden Schritte im **connector-superoffice** und der **Infrastruktur** notwendig:
1. **Konfiguration der `APP_BASE_URL`:**
* **Was?** In der Konfiguration des `company-explorer` (z.B. in einer `.env`-Datei oder direkt in der `docker-compose.yml`) muss die Umgebungsvariable `APP_BASE_URL` gesetzt werden.
* **Warum?** Diese URL ist die öffentliche Basis-Adresse, die für den Bau des Unsubscribe-Links verwendet wird (z.B. `APP_BASE_URL="https://www.ihre-domain.de"`).
* **Beispiel (in `docker-compose.yml`):**
```yaml
services:
company-explorer:
# ...
environment:
- APP_BASE_URL=https://www.robo-planet.de
# ...
```
2. **Anpassung des `connector-superoffice` Workers:**
* **Was?** Der Worker-Prozess im `connector-superoffice`, der die Daten vom `company-explorer` empfängt, muss angepasst werden. Er muss das neue Feld `unsubscribe_link` aus der API-Antwort auslesen.
* **Warum?** Aktuell kennt der Connector dieses Feld noch nicht und würde es ignorieren.
* **Wo?** In der Datei `connector-superoffice/worker.py` (oder ähnlich), in der Funktion, die die `/provision`-Antwort verarbeitet.
3. **Schreiben des Links in das SuperOffice UDF:**
* **Was?** Die Logik im `connector-superoffice` Worker, die Daten nach SuperOffice schreibt, muss erweitert werden. Der ausgelesene `unsubscribe_link` muss in das von Ihnen angelegte Textfeld mit der ProgID `SuperOffice:9` geschrieben werden.
* **Warum?** Nur so wird der Link im CRM gespeichert und kann in E-Mail-Vorlagen verwendet werden.
* **Wo?** An der Stelle, an der die `SuperOfficeAPI.update_person` (oder eine ähnliche Funktion) mit den UDF-Daten aufgerufen wird.
Nach diesen drei Schritten ist der gesamte Prozess von der Generierung des Links bis zur Speicherung im CRM und der Nutzung in E-Mails funktionsfähig.