From 1fb839b24e72b8ae6294e9e928a11e6f93cd83fa Mon Sep 17 00:00:00 2001 From: Lars Date: Tue, 27 Oct 2026 19:44:49 +0100 Subject: [PATCH] Externen FewoPortal-Scheduler als n8n-Workflow vorbereiten [skip ci] --- docs/BETRIEB.md | 10 +-- docs/STATUS.md | 6 +- scripts/n8n-fewo-scheduler.json | 104 ++++++++++++++++++++++++++++++++ 3 files changed, 113 insertions(+), 7 deletions(-) create mode 100644 scripts/n8n-fewo-scheduler.json diff --git a/docs/BETRIEB.md b/docs/BETRIEB.md index 71382bb..9bd4aff 100644 --- a/docs/BETRIEB.md +++ b/docs/BETRIEB.md @@ -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 ` 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 ` 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 diff --git a/docs/STATUS.md b/docs/STATUS.md index 6b1286a..a7a15e4 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -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. diff --git a/scripts/n8n-fewo-scheduler.json b/scripts/n8n-fewo-scheduler.json new file mode 100644 index 0000000..60f3ed5 --- /dev/null +++ b/scripts/n8n-fewo-scheduler.json @@ -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": {} +}