Externen FewoPortal-Scheduler als n8n-Workflow vorbereiten [skip ci]

This commit is contained in:
Lars committed 2026-10-27 19:44:49 +01:00
1 parent 2dca2bccfa
commit 1fb839b24e
3 files changed
+113 -7

No files matched your search

+5 -5
View File
@@ -1,6 +1,6 @@
# Betrieb: Umgebungen, Zugänge, Einrichtung
Stand: 26.10.2026. Aktuell bestätigt: Test unter **www.stommer.info** und `stommer.info`, SSH-Serverpfad **`test.fewo-stommer.de/`**. `dev.fewo-stommer.de/` existiert nicht. Produktion ist noch nicht eingerichtet: ein vorhandener leerer Ordner ist keine fertige Umgebung; eigene MariaDB, `.env`, persistente Daten und Domainzuordnung fehlen. Produktion bleibt in `pipeline.toml` gesperrt. Entwicklung und Testdeploy laufen über `develop` und PipelineManager; die manuellen Skripte unten sind Wartungswerkzeuge. Weitere Abläufe: [DEPLOYMENT.md](DEPLOYMENT.md).
Stand: 27.10.2026. Aktuell bestätigt: Test unter **www.stommer.info** und `stommer.info`, SSH-Serverpfad **`test.fewo-stommer.de/`**. `dev.fewo-stommer.de/` existiert nicht. Produktion ist noch nicht eingerichtet: ein vorhandener leerer Ordner ist keine fertige Umgebung; eigene MariaDB, `.env`, persistente Daten und Domainzuordnung fehlen. Produktion bleibt in `pipeline.toml` gesperrt. Entwicklung und Testdeploy laufen über `develop` und PipelineManager; die manuellen Skripte unten sind Wartungswerkzeuge. Weitere Abläufe: [DEPLOYMENT.md](DEPLOYMENT.md).
> **Geheimnisse stehen nie im Repository und nie im Chat.** Passwörter (Datenbank, E-Mail), `APP_KEY`, Tokens und private SSH-Schlüssel liegen nur in `shared/.env` auf dem Server bzw. im Vaultwarden von Lars. Hier ist nur dokumentiert, *wo* sie liegen.
@@ -15,7 +15,7 @@ ## 1. Überblick
| E-Mail | `MAIL_MAILER=log` – **verschickt nichts** | Strato-SMTP |
| Postfach-Abruf (Portal-Mails) | aus (`FEWO_MAILBOX_HOST` leer) | `imap.strato.de` |
| Suchmaschinen | `noindex` (alles außer `APP_ENV=production`) | indexiert |
| Cronjob | **noch offen** (§6) | einrichten |
| Scheduler-Auslöser | **Extern vorzusehen:** Strato laut Nutzer minimal stündlich; n8n-Vorlage vorbereitet, noch nicht eingerichtet (§6) | einrichten |
Git: `https://gitea.stommer.de/Lars/fewo-stommer.git`. Automatischer Testdeploy nach Push auf `develop`; Produktion über Merge-Commit von `develop` nach `main`, derzeit gesperrt. Gebaut wird der **exakte Workflow-Commit** mit PipelineManager; Details in [DEPLOYMENT.md](DEPLOYMENT.md).
@@ -88,9 +88,9 @@ ## 6. Erledigt / offen im Testbetrieb
Offen:
- **Konto für Brigitte** anlegen: System › Benutzer, Rolle Administrator, Ansicht Einfach (§7).
- **E-Mail im Testbetrieb** einschalten (§5a): Versandweg SMTP + Passwort; Betriebsart steht auf Testbetrieb mit Testadresse lars@stommer.com.
- **Cronjob** (Kundenlogin › Cronjobs), jede Minute:
`/opt/RZphp84/bin/php-cli /mnt/web508/e3/26/51539426/htdocs/test.fewo-stommer.de/current/artisan schedule:run`
Falls Strato nicht minütlich erlaubt: n8n ruft jede Minute `https://stommer.info/automation/scheduler` mit Header `Authorization: Bearer <FEWO_SCHEDULER_TOKEN>` auf.
- **Scheduler-Auslöser:** Lars hat am 27.10.2026 im Strato-Kundenbereich als kleinstes Intervall stündliche Ausführung festgestellt. Das genügt nicht für den vorgesehenen Kalenderimport alle fünf Minuten. Deshalb ist ein externer minütlicher Aufruf vorgesehen; kein zusätzlicher stündlicher Strato-Scheduler für dieselbe Instanz.
Auf dem bestehenden Pi läuft n8n **2.7.5**. Die 29 vorhandenen Workflows wurden auf einen bereits vorhandenen FewoPortal-/stommer.info-Aufruf geprüft; keiner gefunden. Die tokenfreie Vorlage [scripts/n8n-fewo-scheduler.json](../scripts/n8n-fewo-scheduler.json) ist gegen die installierten Schedule- und HTTP-Node-Schemata geprüft. Sie ruft jede volle Minute `https://stommer.info/automation/scheduler` auf. Laravel führt die jeweils fälligen Aufgaben aus, einschließlich aktiver Kalenderimporte alle fünf Minuten; auch die anderen in `routes/console.php` definierten Aufgaben werden dadurch zeitgesteuert ausgeführt.
Der Header `Authorization: Bearer <FEWO_SCHEDULER_TOKEN>` gehört in eine verschlüsselte n8n-Zugangsdatenverbindung vom Typ **Header Auth**, Feldname `Authorization`. Die Vorlage enthält nur deren Platzhalterreferenz. Token weder in die Workflow-Datei noch in eine URL oder das Repository schreiben. Erfolgreiche Ausführungsdaten werden nicht dauerhaft gespeichert; HTTP-Fehler bleiben Fehler. Noch keine Zugangsdatenübernahme, kein Workflowimport und keine Aktivierung erfolgt. Nach Einrichtung den n8n-Workflow veröffentlichen und mindestens zwei aufeinanderfolgende automatische Kalenderimporte im Sync-Protokoll nachweisen. Die [n8n-CLI-Dokumentation](https://github.com/n8n-io/n8n-docs/blob/main/docs/deploy/host-n8n/configure-n8n/use-the-command-line.md) verlangt nach CLI-Veröffentlichung einen Neustart; Veröffentlichung in der Oberfläche vermeidet diesen zusätzlichen Neustart.
- Bankdaten, Vertrags- und AGB-Texte, Rechtstexte prüfen.
### Fotos aus dem alten WordPress übernehmen
+4 -2
View File
@@ -4,6 +4,8 @@ # Projektstand
> Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“).
**Externer Scheduler vorbereitet (27.10.2026):** Strato bietet laut Lars minimal stündliche Cron-Ausführung. Für den Kalenderimport alle fünf Minuten wird ein externer minütlicher Auslöser benötigt. Bestehendes n8n 2.7.5 auf dem Pi geprüft, kein vorhandener FewoPortal-Workflow gefunden. Tokenfreie [Workflowvorlage](../scripts/n8n-fewo-scheduler.json) mit verschlüsselter Header-Auth-Referenz, minütlichem Aufruf und manuellem Test vorbereitet; JSON und installierte Node-Schemata geprüft. **Noch kein Workflow oder Credential in n8n angelegt, kein automatischer Betrieb aktiviert.** Einrichtung und anschließender Nachweis aufeinanderfolgender Sync-Läufe stehen aus; Details in [BETRIEB.md §6](BETRIEB.md#6-erledigt--offen-im-testbetrieb).
**Visuelle iCal-Regelengine bereitgestellt (27.10.2026):** Echte Kalenderanalyse mit Originalfeldern, Beispielen, Häufigkeiten und Textpräfixen; Regeleditor mit UND/ODER, Literalvergleichen, Priorität und einfacher Textextraktion; Live-Vorschau, getrennte Entwurfs-/Aktivierungsstufen und Neuauswertung vorhandener Einträge ohne neue IDs oder Termine. Fachliche Führungskandidaten unterstützen die persönliche Zuordnung, ohne automatische Datumszusammenführung. Exportzuordnung nach SUMMARY/DESCRIPTION/LOCATION und ausdrückliche Namensfreigabe je Zielkanal. Originale und Interpretation verschlüsselt gespeichert. **409 Feature-Tests / 1935 Assertions lokal erfolgreich, darunter 32 neue Fälle; Pint und Pipeline 4669 erfolgreich.** Additive Migration `2026_10_27_183425_add_ical_analysis_rules_and_event_metadata` in MariaDB-Batch 18, Serverrevision/Release bestätigt. Reale FeWo-direkt-Analyse: **38 Ereignisse, 9 Portalreservierungen, 29 Sperren**, davon 11 zukünftig (3 Reservierungen, 8 Sperren). Beide Regeln als normale Daten aktiviert; 11 vorhandene Einträge ohne geänderte IDs, UIDs, Termine oder Zuordnungen neu klassifiziert. Ostseeklar-Export HTTP 200 mit 11 Ereignissen, davon 3 mit freigegebenen Namensbestandteilen in SUMMARY/DESCRIPTION; Export-IDs/-Zeiträume identisch. **Nutzerbeobachtung: Ostseeklar zeigt weiterhin nur „Belegt“ und bietet für importierte Einträge keine Detailansicht; die gewünschte Namensanzeige ist bisher nicht erreicht.** Eine Prüfung der Textübernahme über Eintragsdetails entfällt; die Unterstützung durch den Portalimporter ist noch zu klären. Weitere GET-Abrufe mit HTTP 200/live sind protokolliert, lassen sich anhand der Clientkennung aber nicht sicher Ostseeklar zuordnen. Ursache und Verarbeitung der Textfelder im Zielportal bleiben offen; keine persönliche Portalbestätigung gesetzt. Browserwerkzeug nicht startbar, daher keine zusätzliche echte Browser-Sichtprüfung behauptet. [Bedienung, Datenabgleich und Grenzen](architecture/ical-regelengine.md). Praktischer Nachweis ohne Namen/Token lokal Git-ignoriert: `storage/app/private/ical-regelengine/real-practical-result.json`.
**iCal-Bereich fachlich abgegrenzt und bereitgestellt (27.10.2026):** Menü und Wohnungsbereich heißen **„Kalenderabgleich (iCal)“**, Datensätze und Anlage **„iCal-Verbindung“**. Übersicht und Formular erklären den Umfang als Austausch von Belegungszeiträumen; weitere Funktionen eines Portals benötigen eigene Anbindungen. Route `/admin/channels`, Daten, Token und Synchronisationsverhalten bleiben erhalten. **66 relevante Tests / 336 Assertions erfolgreich, Pint erfolgreich.** Pipeline 4667 mit Build/Tests/Sicherung/Deployment erfolgreich; Server-REVISION `8927f2e` und Release bestätigt.
@@ -98,7 +100,7 @@ ## 3. Offen
- Sprachen: nur Deutsch oder auch Englisch?
**Technik**
- Cronjob auf Strato einrichten (BETRIEB.md §6).
- Externen minütlichen Scheduler-Auslöser über n8n einrichten und automatische Läufe nachweisen (BETRIEB.md §6).
- Design-Theme Seebad 0.3 ist auf `main` und auf stommer.info aktiv (Abschnitt 6).
- Mandantenfähigkeit: **Phasen 1 bis 5, die Anwendungsseite von Phase 6 und der Kern von Phase 7 sind ausgeliefert**. Bausteine können eine aktive Wohnung ihrer Website wählen; leer = Hauptwohnung. Stand, Bausteine und Fallen stehen in Abschnitt 7. Plan: `docs/MANDANTEN-PLAN.md`.
- Logo in E-Mails und im Vertrags-PDF (`public/brand/logo-600.png` liegt bereit).
@@ -117,7 +119,7 @@ ## 4. Nächste Schritte (Vorschlag)
Für den praktischen iCal-Betrieb unter **Vermietung › Portale & Kalender** die gewünschten Anbieter selbst anlegen, externe Importadressen eintragen und automatisch erzeugte eigene Exportlinks den richtigen Portalen zuordnen. Reale Bestände persönlich klären und den regulären Betrieb einzeln prüfen; [Ablauf und verbleibende Testfälle](architecture/ical-mvp-inbetriebnahme-2026-10-27.md). Bestehende Exportadresse unverändert; keine erneute Auslieferung für die normale Konfiguration nötig.
1. Cronjob einrichten; SMTP einschalten und mit `mail:test` prüfen (Mails landen wegen Testbetrieb nur bei Lars); Konto für Brigitte anlegen.
1. Externen Scheduler-Auslöser einrichten; SMTP einschalten und mit `mail:test` prüfen (Mails landen wegen Testbetrieb nur bei Lars); Konto für Brigitte anlegen.
1a. Vor dem Go-Live: System › Betrieb auf „scharf geschaltet“ stellen – erst dann erhalten Gäste die Mails. Beim Go-Live außerdem unter System › Betrieb › Adressen Kontakt-/Antwortadresse und Benachrichtigungen von fewo@stommer.de auf **info@fewo-stommer.de** umstellen (Entscheidung 23.10.2026; Absender ist bereits info@fewo-stommer.de).
2. Brigitte probt Anfrage → Angebot → Annahme mit einem eigenen Test (Angebotslink über die Aktion „Angebotslink“).
3. Vor einem zweiten Mandanten den Host `stommer.info` unter Webseite › Website eintragen. Sonst antwortet diese Adresse ab dann nicht mehr.
+104
View File
@@ -0,0 +1,104 @@
{
"name": "FewoPortal Scheduler (stommer.info)",
"active": false,
"nodes": [
{
"parameters": {
"rule": {
"interval": [
{
"field": "cronExpression",
"expression": "0 * * * * *"
}
]
}
},
"id": "scheduler-every-minute",
"name": "Jede Minute",
"type": "n8n-nodes-base.scheduleTrigger",
"typeVersion": 1.3,
"position": [0, 0]
},
{
"parameters": {},
"id": "scheduler-manual-test",
"name": "Manuell testen",
"type": "n8n-nodes-base.manualTrigger",
"typeVersion": 1,
"position": [0, 200]
},
{
"parameters": {
"method": "GET",
"url": "https://stommer.info/automation/scheduler",
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"sendHeaders": true,
"headerParameters": {
"parameters": [
{
"name": "User-Agent",
"value": "FewoPortal-n8n-Scheduler/1.0"
}
]
},
"options": {
"redirect": {
"redirect": {
"followRedirects": false
}
},
"response": {
"response": {
"responseFormat": "json",
"neverError": false
}
},
"timeout": 110000
}
},
"id": "scheduler-request",
"name": "Scheduler aufrufen",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [320, 0],
"retryOnFail": false,
"credentials": {
"httpHeaderAuth": {
"id": "FEWO_SCHEDULER_HEADER_AUTH",
"name": "FewoPortal Scheduler (stommer.info)"
}
}
},
{
"parameters": {
"content": "## FewoPortal auf stommer.info\nNach der Veröffentlichung wird der Laravel-Scheduler zu jeder vollen Minute aufgerufen. Er startet aktive Kalenderimporte alle fünf Minuten und führt die weiteren fälligen Anwendungsaufgaben aus.\n\nDer Authorization-Header liegt in den zugeordneten Zugangsdaten. In diese Workflow-Datei gehört kein Token.\n\nErfolgreiche Ausführungsdaten werden nicht dauerhaft gespeichert. Fehler sind im Ausführungsverlauf sichtbar. Kein zusätzlicher Strato-Scheduler für dieselbe Instanz.\n\nDas Abrufintervall externer Portale für unseren Export bleibt davon unabhängig.",
"height": 340,
"width": 540
},
"id": "scheduler-operator-notes",
"name": "Betriebshinweise",
"type": "n8n-nodes-base.stickyNote",
"typeVersion": 1,
"position": [-40, -420]
}
],
"connections": {
"Jede Minute": {
"main": [[{"node": "Scheduler aufrufen", "type": "main", "index": 0}]]
},
"Manuell testen": {
"main": [[{"node": "Scheduler aufrufen", "type": "main", "index": 0}]]
}
},
"settings": {
"executionOrder": "v1",
"timezone": "Europe/Berlin",
"executionTimeout": 120,
"saveDataSuccessExecution": "none",
"saveDataErrorExecution": "all",
"saveManualExecutions": false,
"saveExecutionProgress": false
},
"pinData": {}
}