5.3 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 | 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 nachgit 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, dannbash scripts/deploy.sh staging deployundbash 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 |
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 |