Files
fewo-stommer/docs/ZUSAMMENARBEIT.md
T
LarsandClaude Opus 5.5 791786ed3e Saisonfotos am Foto statt am Erscheinungsbild
Ein Foto gehoert zu keinem (ganzjaehrig) oder mehreren Erscheinungsbildern und
erscheint nur dort, vor den ganzjaehrigen Fotos. Bausteine waehlen "automatisch"
oder eine eigene Auswahl; Titelbereich und Abschluss zeigen das erste passende
Foto ihrer Liste. Titelbild und "Bilder je Baustein" des Erscheinungsbilds werden
in die Bausteine uebernommen und entfallen dort.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 18:53:56 +01:00

11 KiB
Raw 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
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