Files
fewo-stommer/docs/ZUSAMMENARBEIT.md
T
Lars StommerandClaude Opus 5 c459f7f83c
Deploy / test (push) Failing after 3s
Deploy / deploy (push) Skipped
Doku: Bildwelten und Marke in STATUS, Plan und Vertragsprotokoll; Platzhalter-Hash korrigiert
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-26 07:38:45 +01:00

9.5 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 main (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 main && 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/main      # 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 main – oder lokal git checkout main && 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)

  • Nur aus main, nur nach git pull, nur mit grünen Tests. Das Skript baut den letzten Commit des lokalen Stands. Wer aus einem Feature- oder Theme-Branch ausliefert, nimmt alle Änderungen der anderen Session vom Server.
  • Theme-Vorschau auf stommer.info: erst nach dem Zusammenführen in main, dann bash scripts/deploy.sh staging deploy und 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
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