# 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/`) | alles **außer** `resources/themes//**` | | **B – Design** | privater PC, Plugin `frontend-design` | ein **neues, zusätzliches Theme** | `theme/` (z. B. `theme/ostsee-nacht`) | nur `resources/themes//**`, `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) ```bash git clone https://gitea.stommer.de/Lars/fewo-stommer.git && cd fewo-stommer # einmalig git checkout main && git pull git checkout -b theme/ # einmalig php artisan themes:make --name="…" --description="…" # … arbeiten (docs/THEME-ERSTELLUNG.md) … git add resources/themes/ package.json package-lock.json && git commit -m "Theme : …" git push -u origin theme/ ``` **Täglich vor der Arbeit** den Stand der Anwendung übernehmen, damit Vorlagen-Vertrag und Tests aktuell sind: ```bash 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 ` ohne Fehler und `php artisan test --compact` grün ist, Merge-Request in Gitea von `theme/` nach `main` – oder lokal `git checkout main && git pull && git merge --no-ff theme/ && 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 ` (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/` | | 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 |