- Webseite > Videos (Datei, Standbild, Kapitel mit Raum im Grundriss); Upload bis 100 MB - Titelbereich: Video statt Foto (stumme Schleife, respektiert Bewegung reduzieren/Save-Data) und naechste freie Termine mit Gesamtpreis (NextFreeStays) - Neuer Baustein Rundgang (Video) mit waehlbarer Anordnung; Grundriss springt ins Video - Buchungsseite: Preis unter dem Kalender, Formular rechts, Ablauf als Grafik - Seebad: Fahrkarten, Fahrplan-Kapitel, Sonnenaufgang als einmaliges Ereignis Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
99 lines
12 KiB
Markdown
99 lines
12 KiB
Markdown
# 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)
|
||
|
||
```bash
|
||
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:
|
||
|
||
```bash
|
||
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-Commit `develop` → `main` und 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 `develop` und erfolgreichem automatischem Testdeploy; danach `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.
|
||
|
||
```powershell
|
||
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 <commit>“.)*
|
||
|
||
| 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 |
|
||
|---|---|---|
|
||
| 30.10.2026 | **Video, freie Termine, Rundgang, Ablauf:** `hero` bekommt `$video` und `$freeStays` (Partials `video-loop`, `free-stays` im Basis-Theme, Seebad: Fahrkarten). **Neuer Baustein `tour`** (Rundgang mit Kapiteln) mit Basis-Vorlage; `floor_plan`-Räume tragen `videoChapter`. `booking`: `$showSteps`/`$steps`; das Livewire-Formular steht jetzt rechts allein, der Preis links unter dem Kalender. Neu in theme.js (Basis): `[data-video-loop]`, `[data-tour*]`, `[data-reveal]`. Seebad: Sonnenaufgang statt Dauer-Drift am Trenner unter dem Titel. Vertrag: THEMES.md §5. | sections/hero, tour, floor_plan, booking; partials/video-loop, free-stays |
|
||
| 29.10.2026 | **Banner:** `partials/banner` liest `$theme->banner()` (`text`, `linkLabel`, `linkUrl`, `tone` → `data-tone`) statt `Notice::visible()` und `$theme->text('banner.*')`; die Schlüssel `banner.*` gibt es am Erscheinungsbild nicht mehr. Beide Themes angepasst. | partials/banner |
|
||
| 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'|'document_logo')` liefert die URL oder null. Gepflegt unter Webseite › Website › Marke. **Noch offen und ein Fall für euch:** `ostsee-licht/views/layouts/app.blade.php` holt das Favicon aus `public/brand/`, Seebad aus seinen eigenen Assets – beide sollten zuerst `$theme->brand('favicon')` fragen und nur sonst auf ihre eigene Datei zurückfallen. Dasselbe gilt für `ostsee-licht/views/partials/brand.blade.php`, das noch fest verdrahtete Ostsee-Grafiken zeigt (A19). | layouts/app, partials/brand |
|
||
| 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 |
|