Mandantenabschluss: Marken, Vertragsdateien und Archive trennen
Deploy FeWo mit PipelineManager / deploy (push) Successful in 2m23s

This commit is contained in:
Lars committed 2026-10-26 17:07:11 +01:00
1 parent 86374b1659
commit 06df80e4db
45 files changed
+592 -99

No files matched your search

+1 -1
View File
@@ -1,6 +1,6 @@
# Betrieb: Umgebungen, Zugänge, Einrichtung
Stand: 22.10.2026. Dieses Dokument beschreibt den **tatsächlichen Stand** der Installationen, damit jede neue Arbeitssitzung (Mensch oder KI) ohne Vorwissen weitermachen kann. Allgemeine Abläufe des Deployments stehen in [DEPLOYMENT.md](DEPLOYMENT.md), das fachliche Konzept in [KONZEPT.md](KONZEPT.md).
Stand: 26.10.2026. Aktuell bestätigt: Test unter **www.stommer.info** und `stommer.info`, SSH-Serverpfad **`test.fewo-stommer.de/`**. `dev.fewo-stommer.de/` existiert nicht. Produktion ist noch nicht eingerichtet: ein vorhandener leerer Ordner ist keine fertige Umgebung; eigene MariaDB, `.env`, persistente Daten und Domainzuordnung fehlen. Produktion bleibt in `pipeline.toml` gesperrt. Entwicklung und Testdeploy laufen über `develop` und PipelineManager; die manuellen Skripte unten sind Wartungswerkzeuge. Weitere Abläufe: [DEPLOYMENT.md](DEPLOYMENT.md).
> **Geheimnisse stehen nie im Repository und nie im Chat.** Passwörter (Datenbank, E-Mail), `APP_KEY`, Tokens und private SSH-Schlüssel liegen nur in `shared/.env` auf dem Server bzw. im Vaultwarden von Lars. Hier ist nur dokumentiert, *wo* sie liegen.
+1 -1
View File
@@ -21,7 +21,7 @@ ## 1. Prinzip
Auf dem Server werden nur **bash, tar und PHP-CLI** gebraucht – kein Composer, kein Node, kein Git, kein rsync.
Die Werkzeugumgebung wird im eigenen Repository `C:\dev\pipelinemanager` entwickelt und als lokales Image `pipeline-manager:0.1.0` auf dem Pi freigegeben. Das Image bleibt nach dem Entfernen eines Job-Containers erhalten. Der Ablauf folgt Tsumugus Docker-Aufträgen auf dem vorhandenen Host-Runner (`ubuntu-latest`), führt Tests jedoch am exakten Commit vor dem Upload aus. Keine PHP-/Node-Installation auf dem Host und kein Build auf dem Entwicklungsrechner für automatische Deployments.
Die Werkzeugumgebung wird im eigenen Repository `C:\dev\pipelinemanager` entwickelt und als lokales Image `pipeline-manager:0.1.1` auf dem Pi freigegeben. Das Image bleibt nach dem Entfernen eines Job-Containers erhalten. Der Ablauf folgt Tsumugus Docker-Aufträgen auf dem vorhandenen Host-Runner (`ubuntu-latest`), führt Tests jedoch am exakten Commit vor dem Upload aus. Keine PHP-/Node-Installation auf dem Host und kein Build auf dem Entwicklungsrechner für automatische Deployments.
FeWo definiert nur seine prepare/test/finalize-Befehle, erforderlichen Dateien, Laravel-Hooks, persistenten Pfade und Ziele in `pipeline.toml`. Gemeinsame Paket-, Sicherungs-, Upload- und Rückfalllogik liegt im PipelineManager. Der bisherige manuelle Weg über `scripts/deploy.sh` bleibt als bestehender Wartungsweg erhalten, bis die neue Anbindung vollständig auf Test bestätigt ist.
+3 -3
View File
@@ -1,6 +1,6 @@
# Mandantenfähigkeit – Umbauplan
Stand: 26.10.2026 · **Phasen 1 bis 5, Anwendungsseite von Phase 6 und Kern von Phase 7 umgesetzt und ausgeliefert.** Offen: der Theme-Teil von Phase 6 (§6 der Zusammenarbeit); optionale neue Wohnungsübersichts-/Suchbausteine sind nicht Teil des abgeschlossenen Phase-7-Kerns · Anforderungen: [MANDANTEN-ANFORDERUNGEN.md](MANDANTEN-ANFORDERUNGEN.md) · Design: [DESIGN-KONZEPT.md](DESIGN-KONZEPT.md) §7 · Übergabe: [STATUS.md](STATUS.md) Abschnitt 7
Stand: 26.10.2026 · **Phasen 1–6 und Kern von Phase 7 umgesetzt.** Abschließender Testdeploy des Theme-/Dateiabschlusses ausstehend, siehe STATUS. Neue Wohnungsübersichts-/Suchbausteine und Subscription/Abrechnung gehören zur funktionalen Weiterentwicklung. Anforderungen: [MANDANTEN-ANFORDERUNGEN.md](MANDANTEN-ANFORDERUNGEN.md).
Kein Portal, kein Marktplatz. Das Produkt bleibt die eigene Website eines Vermieters mit Vermietung. Wenige Mandanten, eine gemeinsame Datenbank, Laravel und Filament bleiben die Basis. Ein Python-Dienst ist nicht Teil dieses Umbaus.
@@ -261,7 +261,7 @@ ### Phase 5 – Abnahme der Trennung und Kündigung · umgesetzt
Tests: Nach der Löschung von A ist B vollständig da, inklusive Dateien und Buchungsnummern. Export von A enthält keine Zeile von B.
### Phase 6 – Marke und Bildwelt · Anwendungsseite umgesetzt (24.10.), Theme-Teil offen
### Phase 6 – Marke und Bildwelt · vollständig umgesetzt (26.10.)
A14, A18, A19, A20, A22. Nicht zusammen mit Phase 1–5, und nicht solange der Branch `theme/<key>` die Vorlagen noch nicht nachziehen kann.
@@ -271,7 +271,7 @@ ### Phase 6 – Marke und Bildwelt · Anwendungsseite umgesetzt (24.10.), Theme-
**Umgesetzt am 24.10. (ohne eine Theme-Datei zu ändern):** Bildwelten als Pakete in `resources/image-worlds/<key>/`, Registry, Auswahl an der Website, Überschreibung an der Wohnung; `$theme->motif()`/`hasMotif()`/`imageWorld()` als Platz-API; `image-worlds:check`. Marke als Medien der Website mit `$theme->brand()`, eingebettet im Mietvertrag. Die Ostsee-Grafiken wurden **kopiert**, nicht verschoben.
**Offen und ein Vertragsfall (ZUSAMMENARBEIT.md §6):** `ostsee-licht` von `partials/brand` auf Plätze umstellen, das Favicon in beiden Themes zuerst bei `$theme->brand('favicon')` erfragen, und Seebads `motifs/`-Ordner gegen die Bildwelt tauschen. `public/brand/` entfällt erst danach.
**Abschluss 26.10.:** Beide Themes nutzen Website-Marke und Bildwelt-Plätze; ohne Marke wird keine fremde Identität angezeigt. Alte Grafikdateien bleiben nur als Importquellen erhalten. `sites:import-stommer-brand <site-id>` übernimmt die vorhandene Stommer-Marke ohne Überschreiben. Auch HTML-/Textmails sind mandanteneigen. Verträge und Angebote haben getrennte Speicherpfade; Export/Löschung schließen Website-Medien und Vertragsdateien ein. Regressionstests: `TenantBrandRenderingTest`, `TenantFilesTest`. Der Vorlagenvertrag ist in ZUSAMMENARBEIT §6 eingetragen.
### Phase 7 – Mehrere Wohnungen je Website · Kern umgesetzt und ausgeliefert (26.10.)
+10 -2
View File
@@ -1,9 +1,17 @@
# Projektstand
Stand: 26.10.2026 · automatischer PipelineManager-Testdeploy erfolgreich (erster Nachweis: Lauf 4656, Commit `e7f79e4`) · 285 Feature-Tests grün
Stand: 26.10.2026 · Mandantenabschluss auf `feature/mandanten-abschluss` umgesetzt; abschließender Pipeline-Testdeploy noch ausstehend. Bisheriger Serverstand: `86374b1`.
> Dieses Dokument ist der Einstieg für jede neue Arbeitssitzung. Bitte bei größeren Änderungen fortschreiben (Abschnitte „Fertig“, „Offen“, „Nächste Schritte“).
**Fachliche Funktionsdokumentation (26.10.2026):** [docs/architecture/README.md](architecture/README.md) führt durch die vorhandenen Funktionen nach fachlichen Ebenen und Bereichen. [Planung und offene Punkte](architecture/planung-und-offene-punkte.md) trennt geplante Erweiterungen, Optionen und noch nötige Inbetriebnahme. Abgeglichen mit dem lokalen Anwendungsstand; keine Auslieferung durch diese Dokumentationsarbeit. Neu festgehaltene offene Abweichung: Sonderangebote können im aktuellen Preisrechner die absolute Mindestnächtezahl umgehen (Details: [Preise und Angebote](architecture/preise-und-angebote.md)).
**Mandantenabschluss (26.10.):** Beide Themes nutzen Website-Logo/Favicon und die gewählte Bildwelt, auch für Bildplatzhalter. HTML- und Textmails tragen den eigenen Namen; HTML bettet das Dokumentlogo ein. Vertragsdateien liegen getrennt unter `contracts/tenants/<id>/bookings/<id>/`; Export/Löschung berücksichtigen Website-Medien, Bildkonvertierungen und Dokumentversionen. Bestehende flache Vertragsdateien bleiben lesbar; mehrdeutig von mehreren Mandanten referenzierte Altdateien stoppen die Löschung. Marken-Uploads erlauben PNG/WebP bzw. PNG/ICO; SVG wird ausschließlich aus geprüften Repository-Quellen importiert. `sites:import-stommer-brand <site-id>` übernimmt die bisherige Marke nur für Stommer, wiederholbar und ohne vorhandene Uploads zu ersetzen.
**Abnahme lokal:** 303 Feature-Tests / 1409 Assertions grün (18 zusätzliche Fälle), beide Themes mit `themes:check` geprüft, `image-worlds:check` erfolgreich, Vite-Build und Pint erfolgreich. Die leere Unit-Suite aus `phpunit.xml` entfernt; der normale PHPUnit-Aufruf funktioniert damit wieder. Keine neue Migration, Abhängigkeit oder lokale Datenbank. Die bestehenden Nutzerdateien unter `styles/` und ein parallel entstandener Ordner `docs/architecture/` bleiben unberührt.
**Verbindliche Umgebung:** Test unter **https://www.stommer.info** (auch `stommer.info`), Serverpfad **`test.fewo-stommer.de/`**, nur per SSH verwaltet. `dev.fewo-stommer.de/` existiert nicht (SSH-Prüfung und Bestätigung Lars 26.10.). Der Produktionsordner ist höchstens eine leere Vorbereitung; Produktion bleibt gesperrt. Vor deren Aufbau ist eine eigene MariaDB-Datenbank zusätzlich zur Testdatenbank einzurichten, keine Datenbank pro Mandant. Weiterhin bestehender PipelineManager-Ablauf: `develop` → Staging; kein zusätzlicher MariaDB-Testjob und keine neue lokale Umgebung.
## 1. Fertig (umgesetzt, getestet, auf stommer.info)
**Vermietung**
@@ -167,7 +175,7 @@ ### Phase 7: Kern umgesetzt und ausgeliefert
### Ebenfalls offen
- **Theme-Teil von Phase 6:** Favicon und `partials/brand` in beiden Themes auf `$theme->brand()` bzw. Plätze umstellen, Seebads `motifs/`-Ordner gegen die Bildwelt tauschen. Steht als Aufgabe in ZUSAMMENARBEIT.md §6 und gehört der Theme-Sitzung.
- **Theme-Teil von Phase 6:** im Mandantenabschluss umgesetzt; bestehende Stommer-Marke nach Auslieferung einmal mit `sites:import-stommer-brand <site-id>` übernehmen. Abnahme und Deploymentnachweis stehen am Dokumentanfang.
- **Subscription und Abrechnung** – nicht Teil des Mandanten-Plans (§9 schließt sie aus). `service_usages` liegt als Grundlage bereit und zählt nichts.
- **Zertifikatsfrage bei Strato:** Ob eine Domain eines Mandanten aufgeschaltet werden kann **und** ein Zertifikat bekommt. Eine Subdomain bekommt keines. Davon hängt ab, ob „Mandant bringt seine Domain mit“ auf diesem Hosting trägt – das ist keine Code-Frage.
+1
View File
@@ -84,6 +84,7 @@ ## 6. Änderungsprotokoll Vorlagen-Vertrag
| Datum | Änderung | Betrifft |
|---|---|---|
| 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 |