Files
fewo-stommer/docs/ZUSAMMENARBEIT.md
T

5.3 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

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

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
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