Stelle das U0-Fundament mit CMS, Mitgliedern und Filament bereit.
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
89b35ac480
commit
2035c46edd
130 files changed
+18519
-50
No files matched your search
@@ -17,8 +17,8 @@ ## 0. Was die Challenger-Prüfung ergeben hat
|
||||
| Was hielt | die Gesamtarchitektur „Kern plus Community-Satellit“, das Vier-Ebenen-Modell, die Paketauflösung, die eingefrorene Bestellkopie, die unveränderlichen Fassungen, das Verbot der Rechtekombination, der Verzicht auf DRM |
|
||||
| Was nicht hielt | die Berechtigungsquelle (ein kostenloses Angebot hätte nur ein Mitglied bedient); die Berechtigungsentscheidung (Zugriff auf Medien nicht erworbener Artikel war nicht ausgeschlossen); die Upgrade-Mechanik (verschlechterte erworbene Rechte); mehrere Abläufe bei Gleichzeitigkeit und falscher Meldungsreihenfolge; die Sicherungs- und Wiederanlaufziele; die fehlende Schadensbegrenzung nach Überwindung einer Komponente; die Abgrenzung von Organisationslizenzen im ersten Schnitt |
|
||||
| Was sich durch neue Beschlüsse geändert hat | Die Updatepolitik ist entschieden (alle später freigegebenen Fassungen desselben Artikels); das konfigurierbare Versionsanspruchsmodell ist entfallen |
|
||||
| Technologie | Die Empfehlung „Django + Wagtail, knapp“ ist nicht bestätigt. Die Stapelwahl ist offen; ein abgegrenzter Machbarkeitsnachweis entscheidet (`10`, Abschnitt 2.1) |
|
||||
| Review-Gate | Die korrigierte Architektur reicht als Grundlage der Implementierungsplanung, mit **einer** blockierenden Voraussetzung: der Stapelwahl (`13`, Abschnitt 10) |
|
||||
| Technologie | **Beschlossen am 15.11.2026:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL (ADR-02). Die frühere Empfehlung „Django + Wagtail, knapp“ gilt nicht |
|
||||
| Review-Gate | Die Stapelwahl blockiert die Umsetzung nicht mehr. Offen bleiben die Geschäftsentscheidungen in `13`, die den Verkaufsstart betreffen |
|
||||
|
||||
---
|
||||
|
||||
@@ -133,7 +133,7 @@ ## 7. Entscheidungen, die als Nächstes anstehen
|
||||
|---|---|---|
|
||||
| 1 | Die Korrekturen der Challenger-Prüfung bestätigen oder zurückweisen, insbesondere die ersetzten ADR-02, ADR-09, ADR-10, die neuen ADR-23 bis ADR-27 und die Annahme A-14 | `13`, Abschnitte 9 und 10; `12` |
|
||||
| 2 | Gesamtarchitektur mit den beiden Auflagen bestätigen oder verwerfen | ADR-01, `02`, Abschnitt 7 |
|
||||
| 3 | **Machbarkeitsnachweis zur Stapelwahl beauftragen, danach Kernstapel entscheiden** – die einzige Voraussetzung, die die Implementierungsplanung blockiert | E-18; `10`, Abschnitt 2.1 |
|
||||
| 3 | Kernstapel ist entschieden (ADR-02, 15.11.2026). Kein weiterer Machbarkeitsnachweis | E-18 erledigt |
|
||||
| 4 | Freigabe einer rein lesenden Bestandsprüfung am Server | A-05 bis A-08 |
|
||||
| 5 | Ziele für Datenverlust und Wiederanlauf festlegen; Außer-Haus-Sicherungsziel wählen | E-22, A-15 |
|
||||
| 6 | Steuerstatus, Kundenkreis, Zahlungs- und Rechnungsweg | OPEN-06, E-09 |
|
||||
|
||||
@@ -176,7 +176,7 @@ ### 8.1 Einschätzung für den Kern nach der Challenger-Prüfung
|
||||
|
||||
**Was gegen S2 spricht:** Entwurf, Vorschau, Revisionen und Wiederherstellung für Seiten sind Eigenbau oder Zukauf. Das vorhandene Sektionssystem des FewoPortals bietet dafür laut dessen Projektbeschreibung keine Grundlage über die Bausteinidee hinaus. Dieser Aufwand wird leicht unterschätzt.
|
||||
|
||||
**Einschätzung:** Die Wahl ist **offen**. Keine Fachanforderung entscheidet sie; beide Stapel tragen die Zielarchitektur aus `03` bis `09`, die deshalb weiterhin stapelneutral formuliert ist. Unter dem gegebenen Betriebsrahmen spricht mehr für S2, **sofern** die Redaktionsanforderung WEB-005 dort mit vertretbarem Aufwand erfüllbar ist. S1 ist vorzuziehen, wenn redaktionelle Freiheit und Freigabeabläufe für Seiten hoch gewichtet werden oder der Nachweis für S2 scheitert.
|
||||
**Einschätzung:** **Seit dem 15.11.2026 entschieden: Laravel 13, Filament 5, PostgreSQL (ADR-02).** Der Vergleich davor: Keine Fachanforderung entscheidet sie; beide Stapel tragen die Zielarchitektur aus `03` bis `09`, die deshalb weiterhin stapelneutral formuliert ist. Unter dem gegebenen Betriebsrahmen spricht mehr für S2, **sofern** die Redaktionsanforderung WEB-005 dort mit vertretbarem Aufwand erfüllbar ist. S1 ist vorzuziehen, wenn redaktionelle Freiheit und Freigabeabläufe für Seiten hoch gewichtet werden oder der Nachweis für S2 scheitert.
|
||||
|
||||
**Nicht empfohlen** bleiben S4 (entspricht Variante B) und S3 (anstehender Hauptversionswechsel, kein erkennbarer Vorteil für dieses Vorhaben).
|
||||
|
||||
|
||||
@@ -29,6 +29,8 @@ ## 1. Bestandsumgebung (lesende Sichtung)
|
||||
|
||||
## 2. Kernanwendung: Framework und CMS
|
||||
|
||||
**Beschlossen am 15.11.2026 (ADR-02):** Laravel 13, Filament 5, PHP 8.4, PostgreSQL, server-gerendert. Die Tabelle bleibt der Vergleich, der zu dieser Entscheidung geführt hat. Die Urteile „Entscheidung offen“ sind damit überholt.
|
||||
|
||||
| Kandidat | Stand und Lizenz | Redaktion | Eignung für den Lizenzkern | Betrieb | Urteil |
|
||||
|---|---|---|---|---|---|
|
||||
| **Django + Wagtail** | Wagtail 7.4 ist LTS (05.05.2026), verlangt Django 5.2 oder neuer, Sicherheitskorrekturen bis 02.11.2027; die Linie 8.x ist erschienen (stabile Dokumentation 8.1), nächste LTS 8.3 für Mai 2027 geplant [B][1][61]. Django 5.2 LTS wird bis April 2028 gepflegt, 6.2 LTS ist für April 2027 angekündigt; ab 2028 jährliche Veröffentlichungen mit je drei Jahren Unterstützung [B][4][60]. BSD-Lizenz [E]. | Für **Seiten**: Seitenbaum, Bausteinfelder, Entwurf, Vorschau, Revisionen mit Vergleich, Freigabe-Workflows, zeitgesteuerte Veröffentlichung. Für andere Objekte sind Entwurf, Revision, Vorschau und Workflow einzeln zuschaltbar [B][55]. | relationales ORM mit Transaktionen und Datenbank-Constraints. Der Aufgabenrahmen des Frameworks liefert **keine ausführende Komponente**; eine dauerhafte Warteschlange braucht ein Zusatzpaket [B][57]. | ein Prozess plus Worker; Container | **Kandidat A** – Entscheidung offen, siehe 2.1 |
|
||||
|
||||
@@ -1,13 +1,15 @@
|
||||
# 12 – Entscheidungsprotokoll (ADR)
|
||||
|
||||
Status aller Einträge: **vorgeschlagen**. Die Entscheidung liegt beim Auftraggeber. Kein Eintrag gibt eine Technologie als vorgegeben aus. ADRs sind Architekturvorschläge, keine Fachregeln.
|
||||
Status der Einträge: **vorgeschlagen**, sofern nicht anders vermerkt. Die Entscheidung liegt beim Auftraggeber. ADRs sind Architekturvorschläge, keine Fachregeln.
|
||||
|
||||
**ADR-02 ist am 15.11.2026 beschlossen:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL, server-gerendert. Die Umsetzung hat begonnen. Die übrigen Einträge bleiben Vorschläge.
|
||||
|
||||
**Stand nach der Challenger-Prüfung vom 14.11.2026** (`13`, Abschnitte 8 und 9): ADR-02, ADR-09 und ADR-10 sind **ersetzt**; ADR-01, ADR-11, ADR-12, ADR-14, ADR-18 und ADR-20 sind **ergänzt**; ADR-23 bis ADR-27 sind **neu**. Die übrigen wurden geprüft und unverändert beibehalten. Die frühere Fassung der ersetzten Einträge ist jeweils unter „Abgelöst“ in einem Satz festgehalten.
|
||||
|
||||
| Nr. | Thema | Empfehlung in einem Satz |
|
||||
|---|---|---|
|
||||
| ADR-01 | Gesamtarchitektur | Integrierter modularer Kern mit Community als Satellit, mit getrennten Rechten im Innern |
|
||||
| ADR-02 | Stapel des Kerns | **Offen:** Laravel + Filament oder Django + Wagtail auf PostgreSQL; Entscheidung nach abgegrenztem Machbarkeitsnachweis |
|
||||
| ADR-02 | Stapel des Kerns | **Beschlossen (15.11.2026):** Laravel 13, Filament 5, PHP 8.4, PostgreSQL, server-gerendert |
|
||||
| ADR-03 | Vier Ebenen des Produktmodells | Inhalt, Lizenzartikel, Angebot, Berechtigung mit je eigener Identität |
|
||||
| ADR-04 | Artikelgrenze | ausdrückliche Deklaration, keine Ableitung aus dem Inhaltsgraphen |
|
||||
| ADR-05 | Berechtigung als unteilbares Bündel | Entscheidung je einzelner Berechtigung, nie Vereinigung |
|
||||
@@ -48,10 +50,10 @@ ## ADR-01 – Integrierter modularer Kern mit Community-Satellit
|
||||
## ADR-02 – Technologiestapel des Kerns (ersetzt)
|
||||
|
||||
**Kontext.** Redaktionsarbeitsplatz (WEB-005), Lizenzkern mit umfangreicher Verwaltung, Hintergrundverarbeitung, Medienverarbeitung; ein Betreiber mit begrenzter Wartungszeit, der Laravel/Filament aktuell betreibt und Python/PostgreSQL/Docker kennt.
|
||||
**Entscheidung.** **Noch keine.** Zwei tragfähige Kandidaten: Laravel + Filament oder Django + Wagtail, jeweils auf PostgreSQL, server-gerendert. Unter dem gegebenen Betriebsrahmen spricht mehr für Laravel + Filament, sofern die Redaktionsanforderung für Seiten dort mit vertretbarem Aufwand erfüllbar ist. Das entscheidet ein abgegrenzter Machbarkeitsnachweis mit festem Abbruchkriterium (`10`, Abschnitt 2.1).
|
||||
**Entscheidung.** **Beschlossen am 15.11.2026 mit Beginn der Umsetzung:** Laravel 13, Filament 5, PHP 8.4 und PostgreSQL. Die Seiten sind server-gerendert; Entwurf, Vorschau, Veröffentlichung und Wiederherstellung einer Revision sind Bestandteil der Anwendung. Der frühere Vergleich bleibt als Begründung stehen: Unter dem Betriebsrahmen sprach mehr für Laravel + Filament. Der Machbarkeitsnachweis aus `10`, Abschnitt 2.1, wird durch die laufende Umsetzung ersetzt und nicht erneut als Studie geführt.
|
||||
**Alternativen.** Next.js + Payload; FastAPI + React + Headless CMS (beide weiterhin nicht empfohlen).
|
||||
**Begründung.** Keine Fachanforderung entscheidet zwischen den beiden Kandidaten. Django + Wagtail bringt die Redaktion öffentlicher Seiten fertig mit und hat längere Pflegezeiträume. Laravel + Filament bringt die Verwaltungsoberflächen des Lizenzkerns (größter Einzelaufwand), die Hintergrundverarbeitung und die vorhandene Betriebserfahrung mit und vermeidet einen dritten Stapel.
|
||||
**Folgen.** Stufe A0 enthält den Machbarkeitsnachweis. Die Zielarchitektur bleibt stapelneutral. Die Entscheidung ist umkehrbar bis zum Beginn der Umsetzung, danach nicht mehr mit vertretbarem Aufwand.
|
||||
**Folgen.** Die Umsetzung hat begonnen. Ein Wechsel des Stapels ist nicht mehr mit vertretbarem Aufwand möglich. Die Modulgrenzen aus `03` bleiben bestehen; die Formulierung älterer Kapitel ist weiterhin stapelneutral und wird nicht neu geschrieben.
|
||||
**Abgelöst.** Frühere Fassung: „Django + Wagtail, knapp, wegen fertiger Redaktion und Medienwerkzeugen im selben Sprachraum“. Das Medienargument hielt der Prüfung nicht stand, das Redaktionsargument nur für öffentliche Seiten (Befunde CH-52, CH-53).
|
||||
|
||||
## ADR-03 – Vier Ebenen des Produktmodells
|
||||
|
||||
@@ -105,7 +105,7 @@ ## 4. Offene fachliche Entscheidungen
|
||||
| OPEN-05 | Co-Branding- und Kennzeichnungsverfahren | Stufen K0–K4; Tiefe des Video-Brandings | Stufenmodell | K0–K2 vor A2; K4 nach Versuch |
|
||||
| OPEN-06 | Zahlungs-, Rechnungs-, Steuerweg | direkter Zahlungsdienst mit eigener Rechnungsstellung / Verkäufermodell (`10`, Abschnitt 6 und 7) | Adapter | **früh**: vor Beginn der Umsetzung von A1, nach Steuerberatung |
|
||||
| OPEN-07 | Community-Sichtbarkeit, Kontakt, Moderation | öffentlich lesbar oder nur Mitglieder; Kontaktwege; Moderationsteam | Konfiguration je Bereich und je Profilangabe | vor A3 |
|
||||
| OPEN-08 | Konkrete Technologien | `10` | ADR-02, ADR-12, ADR-14, ADR-16 | Kernstapel vor A0-Abschluss |
|
||||
| OPEN-08 | Konkrete Technologien | `10` | ADR-12, ADR-14, ADR-16 bleiben offen. **ADR-02 ist am 15.11.2026 beschlossen** (Laravel 13, Filament 5, PostgreSQL) | Kernstapel erledigt |
|
||||
| E-09 | Dürfen Verbraucher kaufen? | ja mit Widerrufsablauf / nur Unternehmer | Kundenart an der Bestellung | vor A1 |
|
||||
| E-10 | Verhalten kostenloser Berechtigungen bei Angebotsende (L-04) | dauerhaft / solange aktiv / befristet | Laufzeitregel | vor dem ersten kostenlosen Angebot |
|
||||
| E-11 | Teilerstattung von Paketen (L-06) | Positionswahl / Kulanz ohne Rechteänderung | geführter Vorgang | vor A2 |
|
||||
@@ -115,7 +115,7 @@ ## 4. Offene fachliche Entscheidungen
|
||||
| E-15 | Umgang mit geladenen Dateien nach Ablauf oder Erstattung (L-13) | Weiternutzung / Löschpflicht | Vertragstext; Nachweis | vor A2 |
|
||||
| E-16 | Aufbewahrungsfristen für Nachweise und Protokolle | `11`, Abschnitt 8.3 | Konfiguration | vor A1 |
|
||||
| E-17 | Vier-Augen-Prinzip für Freigabe und manuelle Vergabe | aus / an | Konfiguration | jederzeit änderbar |
|
||||
| E-18 | Kernstapel: Laravel + Filament oder Django + Wagtail | Entscheidung nach dem Machbarkeitsnachweis mit Abbruchkriterium (`10`, Abschnitt 2.1; `02`, Abschnitt 8) | ADR-02 | vor Beginn von A1 |
|
||||
| E-18 | Kernstapel | **Entschieden am 15.11.2026:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL | ADR-02 | erledigt |
|
||||
| E-19 | Kriterien des Betreibers für „neue Fassung desselben Artikels“ gegen „eigenständiges neues Produkt“ (VER-010) | eigene Kriterienliste; Orientierung in `06`, Abschnitt 7.2 | Einordnungspflicht mit Begründung; Auswirkungsbericht | vor der ersten Überarbeitung eines verkauften Artikels |
|
||||
| E-20 | Sind auch Stände zugänglich, die vor dem Erwerb abgelöst wurden (Annahme A-14)? In welchen Fällen wird bei der Sperre einer Altfassung aktiv informiert? | ja / nur ab Erwerb; je Vorgang entschieden | eine Bedingung; Benachrichtigung je Vorgang | vor der ersten Überarbeitung eines verkauften Artikels |
|
||||
| E-21 | Upgrades: Preisformel; abhängig oder eigenständig je Upgrade-Angebot; Laufzeit im Verhältnis zur Ausgangslizenz (LIC-012 lässt das offen) | Differenzpreis mit Abhängigkeit / Vollpreis eigenständig | Bedingung in Angebotsfassung und Bestellung (`05`, Abschnitt 8.2) | vor A2 |
|
||||
@@ -123,7 +123,7 @@ ## 4. Offene fachliche Entscheidungen
|
||||
| E-23 | Sollen Institutionen schon vor Stufe A4 bedient werden? | (a) nein, bis A4 warten; (b) A4 vorziehen; (c) Institution bezahlt klar so benannte **persönliche** Lizenzen namentlich bestimmter Trainer, die beim Trainer bleiben | Angebotsfassung trägt die Inhaberart; keine Organisationsangebote im ersten Schnitt | vor dem ersten Anliegen einer Institution |
|
||||
| E-24 | Community-Produkt und Betriebsform (selbst betrieben oder gehostet) | `10`, Abschnitt 4 | ADR-12 | vor A3, nach dem kleinen Nachweis aus `10`, Abschnitt 11 Nr. 2 |
|
||||
|
||||
**Früh nötige Geschäftsentscheidungen** (LIC-011 verlangt deren Benennung): OPEN-06 mit Steuerstatus, E-09 Kundenkreis, OPEN-03 Lizenztypen und Preise der ersten Angebote, E-22 Wiederherstellungsziele, E-18 Kernstapel. Die Updatepolitik (früher OPEN-01) ist entschieden und steht nicht mehr auf dieser Liste.
|
||||
**Früh nötige Geschäftsentscheidungen** (LIC-011 verlangt deren Benennung): OPEN-06 mit Steuerstatus, E-09 Kundenkreis, OPEN-03 Lizenztypen und Preise der ersten Angebote, E-22 Wiederherstellungsziele. Die Updatepolitik (früher OPEN-01) und der Kernstapel (E-18, 15.11.2026) sind entschieden und stehen nicht mehr auf dieser Liste.
|
||||
|
||||
## 5. Wie weit trägt die technische Planung ohne die Geschäftsentscheidungen?
|
||||
|
||||
@@ -139,7 +139,7 @@ ## 5. Wie weit trägt die technische Planung ohne die Geschäftsentscheidungen?
|
||||
| Betrieb | vollständig nach Bestandsprüfung | Zielhöhe der Wiederherstellung (E-22) |
|
||||
| Sicherheit | Grenzen, Rollen, Negativtests vollständig | – |
|
||||
|
||||
Keine offene Geschäftsregel verhindert den Beginn der Umsetzung. Mehrere verhindern den **Verkaufsstart**. Vor dem Beginn von Stufe A1 steht allein die Wahl des Kernstapels (E-18).
|
||||
Keine offene Geschäftsregel verhindert den Beginn der Umsetzung. Mehrere verhindern den **Verkaufsstart**. Die Wahl des Kernstapels (E-18) ist am 15.11.2026 getroffen.
|
||||
|
||||
## 6. Ehrliche Aufwandseinordnung
|
||||
|
||||
|
||||
@@ -35,8 +35,8 @@ ### A0 – Fundament und Nachweise
|
||||
| Arbeitspaket | Ergebnis |
|
||||
|---|---|
|
||||
| Bestandsprüfung am Server (lesend): Ressourcen, Anbindung, Erreichbarkeit, Reverse Proxy, NAS, Gitea, Netztrennung zum privaten Netz | Annahmen A-05 bis A-08 bestätigt oder korrigiert |
|
||||
| **Machbarkeitsnachweis Kernstapel** mit vier Punkten und Abbruchkriterium (`10`, Abschnitt 2.1) | Grundlage für E-18 |
|
||||
| Entscheidung Kernstapel (E-18) | ADR-02 beschlossen; **einzige Voraussetzung, die die Implementierungsplanung blockiert** (`13`, Abschnitt 10) |
|
||||
| **Machbarkeitsnachweis Kernstapel** | durch die Umsetzung ab dem 15.11.2026 ersetzt, nicht als eigene Studie wiederholt |
|
||||
| Entscheidung Kernstapel (E-18) | **erledigt am 15.11.2026:** Laravel 13, Filament 5, PHP 8.4, PostgreSQL (ADR-02) |
|
||||
| **Sicherheitsbasis:** drei Herkunftsadressen; getrennte Datenbankrollen und Einhängepunkte je Betriebsart; Alltags- und Systemkonto; Alarmkanal außerhalb der Plattform | Grenzen aus `03`, Abschnitt 6 stehen, bevor Fachcode entsteht |
|
||||
| **Sicherungsbasis:** Außer-Haus-Ziel mit nur anfügbarem Zugang ausgewählt (A-15); fortlaufendes Änderungsprotokoll an beide Ziele; Spiegel von Quellcode und Abbildern; Sicherheitsjournal und Audit-Anker; Entscheidung über die Ziele (E-22) | `11`, Abschnitt 3 eingerichtet; erste Standortausfall-Übung mit Zeitmessung |
|
||||
| Steuer- und Rechtsberatung: Steuerstatus, Kundenkreis, Zahlungs- und Rechnungsweg, Bestellablauf, Lizenzbedingungen | OPEN-06, E-09 entschieden; Textaufträge erteilt |
|
||||
|
||||
@@ -128,7 +128,7 @@ ### 6.1 Entscheidungen, die vorliegen müssen
|
||||
|
||||
| Entscheidung | Verweis |
|
||||
|---|---|
|
||||
| Kernstapel, nach dem Machbarkeitsnachweis | E-18 |
|
||||
| Kernstapel | E-18, **entschieden am 15.11.2026:** Laravel 13, Filament 5, PostgreSQL |
|
||||
| Steuerstatus, Kundenkreis, Zahlungs- und Rechnungsweg | OPEN-06, E-09 |
|
||||
| Lizenztypen, Preise und Bedingungen der Startangebote | OPEN-03 |
|
||||
| Ziele für Datenverlust und Wiederanlauf | E-22 |
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# LUF – Deployment (Stand 2026-11-15)
|
||||
|
||||
Abgeleitet aus dem Shinkan-Verfahren, siehe [Bestandsaufnahme_Deployment_2026-11-15.md](Bestandsaufnahme_Deployment_2026-11-15.md).
|
||||
**Status: geschrieben, aber noch nicht gelaufen.** Es gibt noch keine Laravel-Anwendung im Repo (kommt mit U0), und lokal stehen weder Docker noch Composer zur Verfügung. Geprüft wurden nur Shell-Syntax und YAML.
|
||||
**Status: Anwendung U0 liegt im Repo. Ein Deploy ist erst gelaufen, wenn ein Push auf `develop` den Workflow grün durchlaufen hat.** Lokal gibt es PHP 8.4 und Node. Docker liegt auf dem Runner, nicht auf dem Entwicklungsrechner.
|
||||
|
||||
## Ablauf
|
||||
|
||||
@@ -66,10 +66,10 @@ ## Annahmen und offene Punkte
|
||||
|
||||
- **Repository-Zugriff der Runner [?]:** Die Workflows klonen `http://192.168.2.144:3000/Lars/laraundfelix.git` ohne Zugangsdaten, wie Shinkan. Ist das Repository privat und der Runner nicht angemeldet, schlägt der Clone fehl.
|
||||
- **Gitea-Actions-Syntax [?]:** `needs:` und `github.sha` sind Standard, wurden aber auf dieser Gitea-Version nicht ausprobiert. `actions/checkout` wird bewusst nicht benutzt.
|
||||
- **Laravel-Gerüst fehlt:** Das Dockerfile erwartet `composer.json`, `composer.lock`, `package.json` und `npm run build` im Repo-Root, außerdem die Standardroute `/up`.
|
||||
- **Laravel-Gerüst:** `composer.json`, `composer.lock`, `package.json` und `package-lock.json` liegen im Root. Die Health-Route ist `/up`. Das Image veröffentlicht die Filament-Assets beim Bau (`php artisan filament:assets`) und baut das Frontend mit `npm run build`.
|
||||
- **Zeilenenden:** `.gitattributes` erzwingt LF für Skripte, weil lokal `core.autocrlf=true` gesetzt ist.
|
||||
- **Öffentliche Uploads:** Der Web-Container hat kein `storage`-Volume. Werden Dateien über `storage:link` ausgeliefert, muss das mit U0 geklärt werden.
|
||||
- **Reverse Proxy:** Laravel braucht vertrauenswürdige Proxys (`X-Forwarded-Proto`), sonst stimmen `https`-URLs nicht. In U0 konfigurieren.
|
||||
- **Öffentliche CMS-Bilder:** Der Web-Prozess schreibt nicht nach `/media/public`. Ein Upload liegt zuerst auf dem beschreibbaren Storage-Volume (`cms_incoming`). Die Queue kopiert nach `/media/public`. Ausgeliefert wird die Datei über die Anwendung unter `/medien/…`, zuerst aus dem öffentlichen Medienpfad, ersatzweise aus dem Eingang. `storage:link` wird dafür nicht gebraucht. Die Env-Datei braucht `MEDIA_PUBLIC_PATH`, `MEDIA_DERIVED_PATH` und `MEDIA_ORIGINALS_PATH` (siehe `deploy/luf.env.example`).
|
||||
- **Reverse Proxy:** Die Anwendung vertraut weitergeleiteten Proxy-Kopfzeilen. Nginx reicht `X-Forwarded-Proto`, `X-Forwarded-Host`, `X-Forwarded-Port` und `X-Forwarded-For` an PHP weiter. Der Proxy vor dem Container muss `X-Forwarded-Proto` setzen, damit Adressen `https` bleiben.
|
||||
- **Queue:** Datenbank-Queue (`QUEUE_CONNECTION=database`), kein Redis. Reicht für den Start.
|
||||
- **Gate vor Prod:** Merge-Schutz ist eine Gitea-Einstellung und gehört nicht in die Workflows.
|
||||
- **Umzug Test auf den Pi:** Werte oben in `deploy-test.yml` ändern (Label `ubuntu-latest`, Guard auf `raspberrypi5`/`aarch64`, Pfade, Port). Das Dockerfile baut auch für ARM64. Vorher Speicherlage auf dem Pi klären.
|
||||
Reference in new issue
Block a user