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>
11 KiB
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-Commitdevelop→mainund 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
developund erfolgreichem automatischem Testdeploy; danachbash 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/.envauf 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 |