Files
fewo-stommer/docs/ZUSAMMENARBEIT.md
LarsandClaude Sonnet 5.5 545008baab
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m39s
Compliance-Kern: HTTPS-Erzwingung, Datenschutzlink im Buchungsformular, signierte Links/Feeds von Adress-Weiterleitung ausnehmen
- ForceHttps-Middleware (abschaltbar per FEWO_FORCE_HTTPS)
- Datenschutzerklaerung im Buchungsformular verlinkt
- ResolveTheme: angebot/bewertung/angebote/kalender/automation/health bleiben auf der aufgerufenen Adresse
- Berichte MVP-TECHNICAL-GATE / MVP-COMPLIANCE-ACCEPTANCE, Regeln fuer parallele Agenten (ZUSAMMENARBEIT 7)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-30 22:28:20 +01:00

13 KiB
Raw Permalink Blame History

Zusammenarbeit – parallele Sessions ohne Konflikte

Stand: 22.10.2026 · gilt für alle Arbeitssitzungen (Mensch oder KI), die gleichzeitig am Projekt arbeiten

1. Wer arbeitet woran

Session Rechner Aufgabe Branch Darf ändern
A – Anwendung Firmen-Laptop (oder jeder andere) Funktionen, Verwaltung, Abläufe, Betrieb, Deployment develop (größere Vorhaben: feature/<thema>) alles außer resources/themes/<neues-theme>/**
B – Design privater PC, Plugin frontend-design ein neues, zusätzliches Theme theme/<key> (z. B. theme/ostsee-nacht) nur resources/themes/<key>/**, package.json/package-lock.json (nur @fontsource-Schriften), docs/STATUS.md (eigener Abschnitt)

Session B ändert nicht: app/**, config/**, database/**, routes/**, resources/views/** (auch nicht die Livewire-Formulare), resources/themes/ostsee-licht/**, public/brand/**, andere Dokumente. Braucht das Theme etwas aus diesen Bereichen (neue Daten in einem Baustein, ein neuer Baustein, eine Schrift-Lizenzfrage …), trägt Session B den Wunsch in §5 ein. Session A setzt ihn um.

2. Ablauf Session B (Design)

git clone https://gitea.stommer.de/Lars/fewo-stommer.git && cd fewo-stommer   # einmalig
git checkout develop && git pull
git checkout -b theme/<key>                                                    # einmalig
php artisan themes:make <key> --name="…" --description="…"
# … arbeiten (docs/THEME-ERSTELLUNG.md) …
git add resources/themes/<key> package.json package-lock.json && git commit -m "Theme <key>: …"
git push -u origin theme/<key>

Täglich vor der Arbeit den Stand der Anwendung übernehmen, damit Vorlagen-Vertrag und Tests aktuell sind:

git fetch origin && git merge origin/develop      # Konflikte kann es nur in package-lock.json geben, siehe §4
php artisan migrate && npm ci && php artisan test --compact

Zusammenführen: Sobald php artisan themes:check <key> ohne Fehler und php artisan test --compact grün ist, Merge-Request in Gitea von theme/<key> nach develop – oder lokal git checkout develop && git pull && git merge --no-ff theme/<key> && git push. Ein unfertiges Theme darf zusammengeführt werden. Es ist installiert, aber nicht aktiv, solange es niemand unter Admin › Websites auswählt. Zusammenführen hilft sogar, weil dann die Vorschau auf stommer.info möglich ist.

3. Ausliefern (Deployment)

  • Zielablauf mit PipelineManager: Feature- und Theme-Branches gehen nach develop; dessen Push startet Tests und Deployment auf das Testsystem. Produktion entsteht durch Merge-Commit develop → main und ist bis zur Einrichtung gesperrt. Gemeinsame Deployment-Werkzeuge werden im separaten Repository PipelineManager gepflegt. Details und Freigabestand: docs/DEPLOYMENT.md, docs/STATUS.md. Der manuelle Weg bleibt als ausdrücklich gewählter Wartungsweg verfügbar; normale Auslieferungen laufen über Gitea.
  • Theme-Vorschau auf stommer.info: nach dem Zusammenführen in develop und erfolgreichem automatischem Testdeploy; danach bash scripts/deploy.sh staging artisan themes:preview <key> (gibt die Vorschau-Links aus).
  • Das neue Theme aktivieren (Admin › System › Websites › Theme) entscheidet Lars, nach Sichtung der Vorschau.
  • shared/.env auf dem Server ändert nur Lars (Passwörter); Sessions ändern dort höchstens nicht geheime Werte und dokumentieren das in BETRIEB.md.
  • Jede Session braucht ihren eigenen SSH-Schlüssel für Strato (BETRIEB.md §4); keine Schlüssel kopieren.

4. Konflikte vermeiden

Datei/Bereich Regel
package.json, package-lock.json Während der Theme-Phase installiert nur Session B neue npm-Pakete (Schriften). Bei Konflikt: Version von main übernehmen, dann eigene Pakete neu installieren: git checkout --theirs package-lock.json && npm install @fontsource/<schrift>
Vorlagen-Vertrag (app/Themes/**, Bausteine, Basis-Theme ostsee-licht, THEMES.md §4/§5, THEME-ERSTELLUNG.md §6) Ändert nur Session A – und trägt jede Änderung in §6 ein, damit Session B sie nachzieht
docs/STATUS.md Beide dürfen schreiben – Session B nur in einem eigenen Abschnitt „Design-Theme“
public/build Wird nicht committet (Build-Ergebnis); nie von Hand ändern
Datenbank-Migrationen Nur Session A

4a. Automatische Synchronisation (optional, je Rechner)

scripts/git-autosync.ps1 zieht alle 5 Minuten neue Commits von Gitea – nur per Vorspulen (--ff-only), nie bei lokalen, nicht committeten Änderungen an versionierten Dateien und nie, wenn beide Seiten neue Commits haben (dann Hinweis im Protokoll, bitte von Hand git pull). Protokoll: storage/logs/git-autosync.log, inklusive Hinweis, wenn danach npm ci && npm run build, composer install oder php artisan migrate nötig ist.

scripts\git-autosync.ps1 -Register      # einrichten (Windows-Aufgabenplanung, aktueller Benutzer)
scripts\git-autosync.ps1 -Unregister    # entfernen
scripts\git-autosync.ps1                # einmal von Hand

Eingerichtet auf: Firmen-Laptop (23.10.2026).

Lock-Datei: Nach jeder Paketänderung npm install ausführen und package-lock.json mit committen; vor dem Push prüfen, dass npm ci fehlerfrei durchläuft – das Deploy-Skript und die CI bauen mit npm ci und brechen sonst ab (am 23.10. passiert: Lock-Datei passte nicht zu package.json).

5. Wünsche der Design-Session an die Anwendung

(Session B trägt hier ein, was sie braucht; Session A erledigt es und vermerkt „erledigt in “.)

Datum Wunsch Status
23.10.2026 Theme-Optionen in theme.json › options (Auswahl/Schalter, z. B. Titelbild Bogen/Rechteck, Bewegung an/aus), im Admin unter Websites und je Erscheinungsbild überschreibbar (DESIGN-KONZEPT §7 Nr. 1) offen
23.10.2026 Darstellungsvarianten je Baustein (theme.json › variants), Feld „Darstellung“ im Seiten-Baukasten (DESIGN-KONZEPT §7 Nr. 2) offen
23.10.2026 Baustein „Tipps der Gastgeberin“: Orte mit Kategorie (Strand, Seebrücke, Bahn, Rad, Wald …), Weg/Gehzeit, Text, Foto, Karten-Link; saisonal filterbar. Seebad zeigt je Kategorie eine Vignette der Bildwelt (DESIGN-KONZEPT §7 Nr. 4) offen
23.10.2026 Baustein „Gut zu wissen“: strukturierte Angaben (Zugang/Stufen, Dusche, Rollstuhl, Haustiere, An-/Abreisezeiten, Parken) an der Wohnung; Seebad stellt ihn in der Kartusche dar (DESIGN-KONZEPT §7 Nr. 5) offen
23.10.2026 Bildwelt-System (MANDANTEN-ANFORDERUNGEN A18–A20): Seebad nutzt schon Plätze über partials/motif (mark, divider, closing, crest, gulls, vignette.*) erledigt in 4e66add – Anwendungsseite steht, siehe §6
23.10.2026 Hilfetext „Wort wird hervorgehoben“ im Titelbereich ist theme-abhängig (Seebad hebt nicht hervor) – Hinweis neutral formulieren offen
23.10.2026 Menübild je Seite (Feld an der Seite, Auswahl aus den Fotos, PhotoSelect) und optional ein kurzer Menütext – Seebad zeigt beides in den Menü-Tafeln; heute nur SEO-Beschreibung und Sprunglinks offen

6. Änderungsprotokoll Vorlagen-Vertrag

(Session A trägt hier jede Änderung ein, die Theme-Vorlagen betrifft.)

Datum Änderung Betrifft
30.10.2026 Video, freie Termine, Rundgang, Ablauf: hero bekommt $video und $freeStays (Partials video-loop, free-stays im Basis-Theme, Seebad: Fahrkarten). Neuer Baustein tour (Rundgang mit Kapiteln) mit Basis-Vorlage; floor_plan-Räume tragen videoChapter. booking: $showSteps/$steps; das Livewire-Formular steht jetzt rechts allein, der Preis links unter dem Kalender. Neu in theme.js (Basis): [data-video-loop], [data-tour*], [data-reveal]. Seebad: Sonnenaufgang statt Dauer-Drift am Trenner unter dem Titel. Vertrag: THEMES.md §5. sections/hero, tour, floor_plan, booking; partials/video-loop, free-stays
29.10.2026 Banner: partials/banner liest $theme->banner() (text, linkLabel, linkUrl, tone → data-tone) statt Notice::visible() und $theme->text('banner.*'); die Schlüssel banner.* gibt es am Erscheinungsbild nicht mehr. Beide Themes angepasst. partials/banner
29.10.2026 Fotos und Saisons: Variablen der Vorlagen unverändert ($photo, $photos). Entfallen: $theme->heroPhoto(), sectionPhotoIds(), sectionPhotoMode(), Section::photoSlots() und die Saison-Helfer seasonalPhoto(s)/withSeasonalPhotos; neu $theme->sharePhoto($sections), chosenPhotos(), automaticPhotos(), sourcedPhotos(). Titelbereich/Abschluss: data.photo_ids statt photo_id. Neue Fotokategorie plan erscheint nie automatisch. nur Bausteinklassen; Vorlagen nicht betroffen
26.10.2026 Mandantenabschluss: Beide Themes beziehen Logo und Favicon ausschließlich aus der Website-Marke; ohne Marke bleibt die Darstellung neutral. Dekoration und Bild-Platzhalter kommen aus Bildwelt-Plätzen. partials/brand bleibt als kompatible Platz-Zuordnung erhalten; Seebads partials/motif nutzt die Bildwelt-API. Bestehende Stommer-Marken werden vor Aktivierung ausdrücklich für diese Website importiert. layouts/app, partials/brand, partials/logo, partials/motif, partials/image, header
22.10.2026 theme-base.css (Schriften, Token-Mapping, Basis-Klassen) von theme.css getrennt – Child-Themes importieren theme-base.css theme.css
22.10.2026 Markengrafiken: @include('theme::partials.brand', ['name' => 'mark', 'class' => '…']) (mark, logo, wave-divider, icon-apartment/-sea/-terrace/-location); Farben über --brand-navy/-teal/-wave/-sun (navy = Textfarbe) header, footer, facts, location, image
22.10.2026 hero: $featuredOffer (wichtigstes hervorgehobenes Angebot oder null) sections/hero
22.10.2026 offers: $display (grid/list/rotating), $offers = AdvertisedOffer (Termin, Preis, bookingUrl()); rollierend über data-rotator* sections/offers
23.10.2026 Neuer Baustein floor_plan (Grundriss interaktiv): Vertrag in THEMES.md §5; Basis-Vorlage ostsee-licht/views/sections/floor_plan.blade.php (ohne JS: Flächen springen zur Raumliste), Seebad interaktiv (theme.js initFloorPlans). Neue Themes brauchen keine eigene Vorlage (Vererbung) sections/floor_plan
24.10.2026 Bildwelt-System steht (Anwendungsseite). $theme->motif($slot, $class, $label) liefert das Inline-SVG des Platzes, $theme->hasMotif($slot) sagt, ob der Platz gefüllt ist, $theme->imageWorld() nennt die aktive Bildwelt. Bildwelten liegen in resources/image-worlds/<key>/ (world.json + svg/), Auswahl an der Website, Überschreibung an der Wohnung. Die Ostsee-Grafiken sind als Bildwelt ostsee kopiert – resources/themes/seebad/motifs/ ist unverändert. Seebad kann jetzt sein partials/motif.blade.php auf {!! $theme->motif($slot, $class ?? null, $label ?? null) !!} verkürzen und seinen motifs/-Ordner löschen. php artisan image-worlds:check zeigt, welcher Platz von welcher Bildwelt gefüllt wird. sections/*, partials/motif
24.10.2026 Marke je Website (A14/A22): `$theme->brand('logo' 'favicon'
22.10.2026 Seiten außerhalb der Bausteine, die das Theme-Layout nutzen: Angebotsseite resources/views/offer.blade.php, Bewertung resources/views/review.blade.php – beim Theme-Test mitprüfen layouts/app

7. Mehrere Agenten im selben Arbeitsverzeichnis (Stand 30.10.2026)

Zurzeit arbeiten drei Agenten im selben Verzeichnis auf develop: (1) Visualisierung/Video/Admin dazu, (2) Buchungsprozess, (3) Compliance/Go-live. Jeder Push auf develop deployt automatisch auf stommer.info, das künftig die Produktion ist.

  • Committen nur mit Pfadangabe (git add <Dateien>), nie git add -A/git commit -a: sonst landen halbfertige Änderungen der anderen im Commit. Vor dem Commit git status und git diff --stat prüfen, danach die Gesamtsuite.
  • Vor jedem Push die vollständige Feature-Suite ausführen. Läuft sie gleichzeitig bei zwei Agenten, kann sie wegen des gemeinsamen Testspeichers zufällig scheitern – dann einzeln wiederholen.
  • Prozesse anderer nicht beenden (kein taskkill php.exe).
  • Gemeinsame Dateien (Absprache vor größeren Änderungen, kleine additive Änderungen sind erlaubt): resources/views/livewire/booking-request.blade.php und app/Livewire/BookingRequest.php (Buchung + Barrierefreiheit + Layout), config/fewo.php, routes/web.php, bootstrap/app.php, app/Http/Middleware/ResolveTheme.php, docs/STATUS.md, resources/themes/ostsee-licht/theme.js.
  • Migrationen nur additiv/nullable; sie laufen beim Deployment automatisch auf der operativen Datenbank.
  • Domainwechsel: Signierte Links (angebot/*, bewertung/*, angebote/*) und Feeds (kalender/*) sowie automation/* und health/* werden von der Nebenadress-Weiterleitung in ResolveTheme ausgenommen (staysOnRequestedAddress). Diese Ausnahme nicht entfernen, solange alte Angebotslinks oder Portal-Feed-URLs auf die frühere Adresse zeigen.