- Table floor_plans (tenant_id, one per apartment, picture = website photo, rooms as JSON with corners in percent of the picture), model FloorPlan with BelongsToTenant, Property::floorPlan() - Admin › Webseite › Grundriss: room list with name, description, photos, equipment (from the equipment list), accessibility hint, visibility, and an area editor (click the corners on the picture) - Section floor_plan: base view without JavaScript (areas jump to the room list), Seebad view with room buttons, highlighted area and a cartouche per room (theme.js initFloorPlans) - Tests: tenant inheritance, point parsing, website output, admin create incl. validation; the render test for all themes now includes the floor plan - Docs: THEMES §5, ZUSAMMENARBEIT §6, STATUS §6 (incl. note for tenancy phase 5) - styles/grundriss: revised rendering, WebP renditions, room areas of the Stommer flat in percent Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
93 lines
8.1 KiB
Markdown
93 lines
8.1 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 | `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)
|
||
|
||
```bash
|
||
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:
|
||
|
||
```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 <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.
|
||
|
||
```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.*`) | offen |
|
||
| 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 |
|
||
| 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 |
|