diff --git a/docs/BETRIEB.md b/docs/BETRIEB.md index 9bd4aff..ed9c523 100644 --- a/docs/BETRIEB.md +++ b/docs/BETRIEB.md @@ -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 | -| Scheduler-Auslöser | **Extern vorzusehen:** Strato laut Nutzer minimal stündlich; n8n-Vorlage vorbereitet, noch nicht eingerichtet (§6) | einrichten | +| Scheduler-Auslöser | **n8n-Entwurf eingerichtet und einmalig getestet, noch unveröffentlicht** (§6); Strato laut Nutzer minimal stündlich | 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). @@ -90,7 +90,9 @@ ## 6. Erledigt / offen im Testbetrieb - **E-Mail im Testbetrieb** einschalten (§5a): Versandweg SMTP + Passwort; Betriebsart steht auf Testbetrieb mit Testadresse lars@stommer.com. - **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. + Der Header `Authorization: Bearer ` liegt nach ausdrücklicher Freigabe in der verschlüsselten n8n-Zugangsdatenverbindung **FewoPortal Scheduler (stommer.info)** vom Typ **Header Auth**, Feldname `Authorization`. Der [zugehörige Workflowentwurf](https://privat.stommer.com:5678/workflow/23581e4b70324812) ist angelegt; die gespeicherte verschlüsselte Form und die korrekte Zuordnung wurden lesend bestätigt. Die Repository-Vorlage enthält nur eine 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. + Der separat freigegebene einmalige manuelle Workflow-Test hat am **27.10.2026 um 20:42:47 Uhr MEZ** eine gültige authentifizierte JSON-Antwort des Schedulers erhalten. Für den parallelen CLI-Test wurde ausschließlich im Testprozess ein anderer lokaler Task-Broker-Port verwendet; die laufende n8n-Instanz wurde nicht neu gestartet. Der Test lag außerhalb einer Fünf-Minuten-Marke und führte deshalb keinen Kalenderimport aus. Lesend um 20:43 bestätigt: Kanal 1 importfähig, letzter erfolgreicher Import weiterhin 19:21:17 Uhr; Kanal 2 Import ausgeschaltet. Der Workflow bleibt unveröffentlicht. Das ist ein Nachweis der Workflow-Verbindung, noch kein Nachweis regelmäßiger automatischer Kalenderimporte. + **Nächster Schritt:** Workflow in der n8n-Oberfläche öffnen und **Veröffentlichen / Publish** wählen. Danach mindestens zwei aufeinanderfolgende automatische Kalenderimporte im Sync-Protokoll nachweisen und den Status hier aktualisieren. 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. Tokenfreier lokaler Nachweis: `storage/app/private/n8n-scheduler/setup-result.json` (Git-ignoriert). - 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 a7a15e4..5751d92 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -4,7 +4,7 @@ # 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). +**Externer Scheduler als n8n-Entwurf eingerichtet (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. In der vorhandenen n8n-Instanz 2.7.5 auf dem Pi wurde nach ausdrücklicher Freigabe der [Workflow „FewoPortal Scheduler (stommer.info)“](https://privat.stommer.com:5678/workflow/23581e4b70324812) angelegt und der vorhandene Scheduler-Token als Header-Auth-Zugangsdaten übernommen; verschlüsselte Speicherung und Zuordnung lesend bestätigt. Tokenfreie [Workflowvorlage](../scripts/n8n-fewo-scheduler.json), JSON und installierte Node-Schemata geprüft. Der separat freigegebene einmalige Test über den tatsächlichen Workflow war erfolgreich: authentifizierte Scheduler-Antwort vom **27.10. um 20:42:47 Uhr MEZ**. Außerhalb einer Fünf-Minuten-Marke wurde dabei kein Kalenderimport ausgeführt; kein zusätzlicher Kalenderabgleich durch die Prüfung erzwungen. **Entwurf nach dem Test weiterhin unveröffentlicht, automatischer Betrieb noch nicht aktiv.** Nächster Schritt: in der n8n-Oberfläche veröffentlichen und mindestens zwei aufeinanderfolgende automatische Importläufe im Sync-Protokoll nachweisen. Details in [BETRIEB.md §6](BETRIEB.md#6-erledigt--offen-im-testbetrieb); tokenfreier lokaler Nachweis Git-ignoriert unter `storage/app/private/n8n-scheduler/setup-result.json`. **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`. @@ -85,7 +85,7 @@ ## 2. Stand auf stommer.info (Testbetrieb) | Konten | `lars@stommer.com` ist Betreiber und Mandanten-Administrator von Stommer (Passwort und 2FA unverändert). Admin unter https://stommer.info/admin am 23.10.2026 geprüft und funktionsfähig. Konto für Brigitte noch anzulegen (Mandanten-Administrator, **einfache Ansicht**) | | Daten | Wohnung, Preise 2026, 39 Fotos, Seiten, 5 Erscheinungsbilder; **Testbuchung 2026-0002** („E2E Testgast“, angenommenes Angebot) – darf gelöscht werden | | E-Mail | Betriebsart **Testbetrieb** (System › Betrieb), Testadresse `lars@stommer.com` – alle Mails gingen nur dorthin. Versandweg aber noch `log` (nichts wird zugestellt): `MAIL_MAILER=smtp` + `MAIL_PASSWORD` (Postfach **info@fewo-stommer.de** = Absender) in `shared/.env` selbst eintragen, dann `artisan mail:test` (BETRIEB.md §5a) | -| Cronjob | **noch nicht eingerichtet** – ohne ihn laufen Fristabläufe, Erinnerungen, Kalenderabgleich, Backups nicht automatisch (BETRIEB.md §6) | +| Scheduler | **n8n-Entwurf angelegt und einmalig getestet, noch unveröffentlicht** – automatischer Betrieb und aufeinanderfolgende Sync-Läufe noch nicht nachgewiesen (BETRIEB.md §6) | | Typischer Anreisetag | noch nicht eingetragen (Preise & Angebote › Saisons › Regeln Mindestaufenthalt) | ## 3. Offen @@ -100,7 +100,7 @@ ## 3. Offen - Sprachen: nur Deutsch oder auch Englisch? **Technik** -- Externen minütlichen Scheduler-Auslöser über n8n einrichten und automatische Läufe nachweisen (BETRIEB.md §6). +- Vorhandenen minütlichen n8n-Scheduler-Entwurf veröffentlichen 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). diff --git a/docs/architecture/ical-kanalkonfiguration.md b/docs/architecture/ical-kanalkonfiguration.md index f2585cf..14d4400 100644 --- a/docs/architecture/ical-kanalkonfiguration.md +++ b/docs/architecture/ical-kanalkonfiguration.md @@ -151,7 +151,7 @@ ## 9. Überwachung und Abrufzeiten Die Kanalliste zeigt Importzustand, letzten erfolgreichen Import, letzte Fehlerzeit, Anzahl zuletzt übernommener Ereignisse, Warnungen, Prüffallzahl, Exportmodus und Exportzustand. Die letzten 30 Protokolle sind einsehbar. Ein manueller Lauf bleibt für eingeschaltete eingerichtete Importe verfügbar. -Unser Aufgabenplan sieht `channels:sync` alle fünf Minuten vor. Der erwartete externe Abrufabstand ist dagegen nur eine Vermutung zum Portal und steuert diesen Plan nicht. Ohne eingerichteten Scheduler erfolgt kein regelmäßiger Abgleich. Der bisher dokumentierte Einrichtungsbedarf auf dem Testserver wurde hier nicht verändert. +Unser Aufgabenplan sieht `channels:sync` alle fünf Minuten vor. Der erwartete externe Abrufabstand ist dagegen nur eine Vermutung zum Portal und steuert diesen Plan nicht. Ohne eingerichteten Scheduler erfolgt kein regelmäßiger Abgleich. Stand 27.10.2026: Strato erlaubt laut Nutzer minimal stündliche Cron-Ausführung. Ein minütlicher externer Auslöser ist deshalb als n8n-Workflowentwurf mit verschlüsselten Zugangsdaten angelegt und einmalig erfolgreich gegen den Scheduler-Endpunkt getestet. Der Entwurf ist noch unveröffentlicht; regelmäßige automatische Kalenderimporte sind noch nicht nachgewiesen. Veröffentlichung und Betriebsnachweis: [BETRIEB.md §6](../BETRIEB.md#6-erledigt--offen-im-testbetrieb). `last_export_requested_at` zeigt einen beobachteten Abruf dieser Feedadresse, in der Kachel als **„Letzter Abruf“** getrennt vom Sync-Lauf. Die ergänzte **Abrufhistorie** hält je Kanal die letzten 100 verarbeiteten GET-/HEAD-Aufrufe mit Empfangszeit, Antwortstatus, Exportzustand und unbestätigter Clientkennung fest. IP-Adressen und Token werden dort nicht gespeichert. Ein eigener Test, Monitor oder weitergegebener Link kann denselben Abruf auslösen. Der Zeitpunkt beweist weder den Portalclient noch eine erfolgreiche Verarbeitung dort. Getrennte bestätigte Portal-Synchronisationszeiten werden weiterhin nicht automatisch ermittelt; persönliche Sichtkontrollen sind ein eigenes Feld. Auch Prüffälle müssen persönlich bearbeitet werden; ein technisch erfolgreicher Import bedeutet nicht konfliktfreien Bestand.