Files
fewo-stommer/docs/Prozessarchitektur/Implementierungsstände/ABSCHLUSSBERICHT_PROZESSARCHITEKTUR_V2.md
LarsandClaude Opus 5.5 4410fb3ee0
Deploy FeWo mit PipelineManager / deploy (push) Successful in 6m16s
Abschlussbericht: Bereitstellung auf stommer.info und technische Prüfung
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-04 16:09:34 +01:00

9.9 KiB
Raw Permalink Blame History

Abschlussbericht: Kontrolliert modulare Prozessarchitektur V2

Stand: 04.11.2026 · Grundlage: Architekturdokumente docs/Prozessarchitektur/Architektur/00–06 (750c1ed), Implementierungsauftrag vom 04.11.2026 mit den Entscheidungen O1–O5 und den Anforderungen T1–T3.

Dieser Bericht nennt nur Nachgewiesenes. Was nicht geprüft werden konnte, steht unter „Offen“.

1. Repository und Bereitstellung

Umsetzungszweig feature/prozessarchitektur-v2 (von feature/aufenthalt @ 750c1ed, Code-Stand = develop 7e4e208)
Commits 98df5e9 U-0 · 7e22e12 U-A/U-B · d695566 Analysebefehle, O4 · c255783 U-C · 0689c0a U-D/U-E/O5 · Dokumentation (siehe Git-Historie)
Merge nach develop, Deployment siehe §8 (wird nach dem Deployment ergänzt)
main unverändert, kein Produktivdeployment

2. Implementierte Funktionen

  • Prozesskern (U-A):

    • ProcessRunner mit harten und weichen Abhängigkeiten, Neubewertung nach jedem Schritt, Auslösern aus der Moduldefinition und Aussetzen nach O4.
    • CaseActivities und CaseAutomation sind Fassaden darüber.
    • Die Automatik von CreateReservation, TakeOverExternalBooking, SubmitBookingWish und bookings:auto-offers läuft über den Runner.
  • Fachmodule: 25 registrierte Module (config/process.php, MODULMATRIX.md), davon 2 nur im Tester (Loyalty). Jedes hat eine ModuleDefinition als Vertrag.

  • Prozessmodelle: a1.offer (Varianten standard, loyalty = nur Tester), a1.information, a2.offer, a2.information, a3/a4/a5.portal_booking, a6.internal, jeweils Version 1. Jedes mit Erweiterungspunkten, festen und variablen Verantwortungen und festgelegten Einstellungen.

  • Prozessplan:

    • wird beim Eingang in bookings.profile.plan eingefroren (Modell, Version, Variante, Modulversionen, Schritteinstellungen, Bezeichnungen);
    • Bestandsfälle ohne Plan erhalten beim Lesen den abgeleiteten Plan (keine Datenänderung).
  • Preis-Erweiterungspunkt (U-B): CasePricing in SendOffer::quoteFor. Ohne Beiträge ist das Ergebnis gleich PriceCalculator; für verbindliche Fälle gibt es nie Beiträge.

  • Loyalty-Nachweis (U-B): guest.loyalty_status und pricing.loyalty_discount. Für echte Vorgänge technisch nicht aktivierbar (Konfigurator und Plan weisen ab).

  • Kanalkonfigurator (U-C): Kanal › Ablauf. Je Eingangsart werden die zulässigen Modelle nach Kanalprofil angeboten (O2). Die Schritte stehen nach Phasen, mit:

    • Schalter (nur optionale Schritte);
    • Ausführungsart;
    • Ausführenden im Rahmen des Modells;
    • Fristen mit Herkunft „hier gesetzt / geerbt“ und Zurücksetzen;
    • Vorschau und „Ablauf testen“ mit dem ungespeicherten Entwurf.

    Gespeichert wird über ConfigureChannelProcess. Die flache Liste im Kanalformular entfällt.

  • Prozess-Tester (U-D): Szenarien

    • vollständige Anfrage;
    • fehlende Anschrift mit später Antwort (Link oder E-Mail);
    • Portalanfrage;
    • Stammgast;
    • Mailausfall;
    • Portalbuchung mit Duplikat, Beträgen und Storno-Meldung.

    Die Szenarien laufen schrittweise in einem eigenen PHP-Prozess. Der Bericht wird gespeichert und nach 30 Tagen gelöscht.

  • Kanalereignisse (U-E): IncomingBooking, BookingCancelledByChannel, BookingChangedByChannel, PaymentReported, PayoutReported mit Provenance, dazu ChannelEventHandler und die Schnittstellen DeliversEvents/ReceivesWebhooks. iCal und Mail bleiben unverändert.

  • Entscheidungen:

    • O1 und O2 über Verantwortungsmatrix und Kanalprofile;
    • O3: Löschfrist 30 Tage;
    • O4: OutwardSuspension;
    • O5: Klärungsart beim kaufmännischen Abschluss.
  • Analyse:

    • process:check (Katalog; mit --cases die eingefrorenen Pläne aller Vorgänge; --matrix), läuft in der CI;
    • process:impact <modul>;
    • process:fingerprint (Prüfsummen vor/nach Deployment).

3. Geänderte bestehende Anwendungskomponenten

Datei Änderung
Process/CaseActivities, Process/CaseAutomation Fassaden über ProcessRunner (Ableitung in Module verschoben)
Process/CaseRecorder friert den Plan mit ein
Process/ProcessSettings, ProcessProfile Festlegungen des gewählten Modells (Herkunft „Ablaufmodell“)
Process/CaseClosure O5: Klärungsart bei offener Portal-Auszahlung
Actions/CreateReservation, TakeOverExternalBooking, SubmitBookingWish, Console/SendPendingAutoOffers Automatik über den Runner
Actions/SendOffer Preis über CasePricing
Actions/SendBookingReminders, RequestReviews O4; Bewertungsbitte je Kanal abschaltbar
Actions/AnonymizeGuests, Support/SystemSettings, config/fewo.php Löschfrist Testberichte (O3), PHP-Programm des Testers
Channels/Intake/PortalIntake, Actions/TakeOverExternalBooking, Models/IntakeObservation Quelle api, reportToCase
Filament/.../ChannelResource, EditChannel, ChannelForm, HandlesWishAndStay, effective-settings Seiten Ablauf/Ablauf testen, Kanalprofil, Klärungsart
Providers/AppServiceProvider, bootstrap/app.php Registerdienst; Sandbox-Bootstrap nur im Testprozess; keine Betreibereinstellungen im Testprozess
config/channels.php Kanalprofile (O2)
pipeline.toml process:check in der CI, process:sandbox-template nach migrate

Fachlogik der übrigen Actions, PriceCalculator, Fakteneingang, Datenbeschaffung, Posteingang/KI, Mail-Schranke, SyncChannel, ProcessPortalMail: unverändert.

4. Migrationen

Eine neue Tabelle process_test_runs (2026_11_07_100000). Keine Änderung bestehender Tabellen oder Daten. Bestandsvorgänge erhalten keinen Plan geschrieben; er wird beim Lesen abgeleitet.

5. Testresultate (lokal, SQLite)

Lauf Ergebnis
Ausgangsstand U-0 (7e4e208 + Testwerkzeug) 772 Tests, 771 grün; 1 im Gesamtlauf instabil (TenantBrandRenderingTest, einzeln grün; F-003)
nach U-A 785/785
nach U-C 820/820
nach U-D/U-E/O5 (Endstand vor dem Merge) 856/856 (Laufzeit 6,3 min)
process:check 25 Module, 8 Modelle, ohne Befund
npm run build erfolgreich

Verhaltensvergleich v0.11 → V2:

  • 11 Abläufe mit 39 Ereignissen und 198 Zustandskonstellationen in acht Dimensionen sind gleich.
  • Abweichungen gibt es nur bei I-004/I-005, den Korrekturen der Fehler F-001/F-002.
  • 12 eingefrorene Bestandsfälle liefern gleiche Stornokosten, Fälligkeiten und Vertragstext-Hashes. Die einzige Abweichung ist I-005 im Detailtext. Die Automatik ändert keine Vertragsdaten.

6. Sicherheitsnachweise des Prozess-Testers (T2)

  • 15 Negativtests (ProcessTesterSecurityTest):

    • andere Datenbankverbindung;
    • neue Verbindung auf die Betriebsdatei;
    • umgeleitete Sandbox-Verbindung;
    • Betriebstabellen;
    • Netz, Webhook, IMAP, fremder Mailer, Dateiablage außerhalb, fremder Cache;
    • Umgebung und Zugangsdaten mit eigenem Schlüssel und ohne echte Vorgänge;
    • signierter Link außerhalb ungültig;
    • Laufbefehl ohne vorbereiteten Lauf;
    • zweiter Lauf desselben Vermieters;
    • Aufräumen abgebrochener Läufe.

    Jeder Verstoß wird aufgezeichnet und bricht den Lauf ab. Der Prüfsummenvergleich der „Betriebsdatenbank“ (eigene SQLite-Datei) ergibt jeweils keine Änderung.

  • Statischer Wächter SideEffectPathsTest: keine nativen Netz-, Mail-, Datenbank-, Datei- oder Programmaufrufe und kein env() in app/ außerhalb einer begründeten Positivliste.

  • Restrisiko: Auf Shared Hosting gibt es keine Trennung auf Betriebssystemebene (04 §3.1a, BETRIEB.md §7b). Nativer Code könnte shared/.env lesen; das verhindert nur der statische Wächter.

7. Bekannte Einschränkungen

Siehe 06 §10:

  • API- und iCal-Sperre derselben Buchung stehen bis zur Klärung nebeneinander (ein Vorgang).
  • Die E-Mail-Antwort im Tester wird als ausgewertete Angaben eingespielt.
  • „So arbeite ich“ ist noch nicht auf die Schrittansicht umgestellt.
  • ActivityDetails::EVENT_TYPES bleibt als zweite Liste bestehen (I-001 entfällt).

8. Bereitstellung auf stommer.info

Bereitgestellt am 04.11.2026.

  • Vor dem Merge geprüft: origin/develop unverändert auf 7e4e208, keine parallelen Änderungen; aktives Release 20261103170806-7e4e208d; keine ausstehenden Migrationen; beide Mandanten im Testbetrieb.
  • Merge und Push: Merge nach develop (--no-ff, Merge-Commit 79f3344, Bereitstellungsstand 9f63059). Push 7e4e208..9f63059; das automatische Deployment hat das Release 20261104150804-9f630594 aktiviert.
  • Technische Prüfung des Releases:
    • Migration 2026_11_07_100000_create_process_test_runs_table: Ran.
    • process:check --cases: 25 Module, 8 Modelle, ohne Befund (auch die eingefrorenen Pläne aller Vorgänge).
    • Testvorlage shared/storage/app/sandbox/template.sqlite beim Deployment erzeugt.
    • process:fingerprint gleich wie vor dem Deployment: 10 Buchungen, 7 Kanäle, 13 Sperren; h_bookings ab8b708e0479aeb3bd902b3fd538462b, h_overrides b3ea60a060bea2b417fc78bba5dd852b, h_blocks d6305a420d17c1928cfce54f0c94bb8b. Bestehende Buchungen, Kanalprofile und Sperren sind unverändert.
  • Nicht per SSH prüfbar: ob das Web-PHP (Handler x-httpd-php84) proc_open erlaubt. Das zeigt die Seite Kanal › Ablauf › „Ablauf testen“ nach der Anmeldung: Ist es gesperrt, nennt sie den Grund, und der Tester bleibt gesperrt (Abnahmeblocker nach T2).
  • Nächster Schritt: fachliche Abnahme nach Drehbuch Teil B.

9. Offene Fehler, Risiken, Entscheidungen

  • F-003: instabiler Test TenantBrandRenderingTest (nicht prozessbezogen).
  • Risiko: Ob proc_open im Web-PHP von Strato erlaubt ist, zeigt erst das Testsystem. Ist es gesperrt, bleibt der Tester gesperrt, und die Hosting-Voraussetzung ist ein Abnahmeblocker (T2).
  • Verbleibende fachliche Entscheidungen:
    • keine neuen aus der Umsetzung;
    • für eine spätere produktive Loyalty: Berechtigung, Staffel, Kombination und Umbuchung (E5–E7);
    • Freigabe weiterer Modelle für FeWo-direkt (O2) nach Klärung FW-01 bis FW-07.