Files
fewo-stommer/docs/BETRIEB.md
T

20 KiB
Raw Blame History

Betrieb: Umgebungen, Zugänge, Einrichtung

Stand: 27.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.

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. Überblick

Testbetrieb (staging) Produktion
Adresse https://stommer.info später https://www.fewo-stommer.de (heute noch WordPress)
Ordner auf dem Webspace test.fewo-stommer.de/ prod.fewo-stommer.de/ angelegt; .env/Datenbank und Freigabe noch offen
Deploy-Konfiguration (lokal, nicht committet) scripts/deploy.staging.env scripts/deploy.production.env (anlegen aus deploy.example.env)
Datenbank MariaDB 11.8, siehe §3 eigene Datenbank anlegen
E-Mail MAIL_MAILER=log – verschickt nichts Strato-SMTP
Postfach-Abruf (Portal-Mails) aus (FEWO_MAILBOX_HOST leer) imap.strato.de
Suchmaschinen noindex (alles außer APP_ENV=production) indexiert
Scheduler-Auslöser Extern vorzusehen: Strato laut Nutzer minimal stündlich; n8n-Vorlage vorbereitet, noch nicht eingerichtet (§6) einrichten

Git: https://gitea.stommer.de/Lars/fewo-stommer.git. Automatischer Testdeploy nach Push auf develop; Produktion über Merge-Commit von develop nach main, derzeit gesperrt. Gebaut wird der exakte Workflow-Commit mit PipelineManager; Details in DEPLOYMENT.md.

2. Strato-Paket (Hosting Pro)

  • SSH/SFTP-Server: 51539426.ssh.w1.strato.hosting (paketspezifisch, nicht ssh.strato.de – der lehnt ab). Port 22.
  • SSH-Benutzer: stu100093250 (Kundenlogin › Datenbanken und Webspace › SFTP & SSH › Details). Startverzeichnis / = Webspace-Wurzel.
  • Absoluter Pfad des Webspace: /mnt/web508/e3/26/51539426/htdocs/ (für Cronjobs).
  • PHP-CLI: /opt/RZphp84/bin/php-cli (8.4). Die Web-PHP-Version des Pakets ist eine andere (8.3); die .htaccess im Deploy-Ordner setzt per AddType application/x-httpd-php84 .php 8.4 nur für diesen Ordner.
  • Andere Inhalte im Webspace nicht anfassen: u. a. www.fewo-stommer.de/ (bestehendes WordPress), fewo, Karate-Wiki, Moodle. Das Deploy-Skript arbeitet ausschließlich unterhalb von DEPLOY_PATH.
  • Domains: SSL-Zertifikate gibt es im Paket nur für Hauptdomains, nicht für Subdomains. Deshalb läuft der Test unter stommer.info (Ziel: Ordner test.fewo-stommer.de, SSL aktiv, www.stommer.info ebenso). Die Subdomain test.fewo-stommer.de wird nicht mehr gebraucht.
  • Domain-Ziel = Deploy-Ordner selbst (Strato kann kein Symlink-Ziel wählen). Die dort vom Skript geschriebene .htaccess leitet auf releases/<aktive Version>/public und sperrt alles Interne mit 403.

3. Datenbank (staging)

  • Host database-5021719836.webspace-host.com, Port 3306, Datenbank dbs16257975, Benutzer dbu2231025, DB_CONNECTION=mariadb.
  • Passwort: nur in test.fewo-stommer.de/shared/.env (und Vaultwarden).

4. SSH-Zugang einrichten (neuer Rechner, z. B. privater PC)

  1. Schlüssel erzeugen: ssh-keygen -t ed25519 -f ~/.ssh/strato_fewo -C "fewo-deploy <rechner>".
  2. Öffentlichen Schlüssel beim Server eintragen (fragt einmal das SSH-Passwort des Strato-Benutzers ab): ssh-copy-id -i ~/.ssh/strato_fewo.pub stu100093250@51539426.ssh.w1.strato.hosting (Windows ohne ssh-copy-id: Inhalt von strato_fewo.pub per SSH an ~/.ssh/authorized_keys anhängen.)
  3. Test: ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting "ls".
  4. Den privaten Schlüssel nur im Vaultwarden sichern, nie committen oder weitergeben.
  5. Aufräumen: Der Schlüssel des Firmen-Laptops (Kommentar in ~/.ssh/authorized_keys auf dem Server) wird entfernt, sobald der private PC eingerichtet ist.

Lokale Werkzeuge: PHP 8.4 CLI, Composer, Node/npm, Git, Bash (Windows: Git Bash). Danach scripts/deploy.example.env nach scripts/deploy.staging.env kopieren und mit den Werten aus §2 füllen (DEPLOY_PATH=test.fewo-stommer.de, DEPLOY_URL=https://stommer.info, DEPLOY_SSH_KEY=~/.ssh/strato_fewo; unter Windows ggf. COMPOSER_BIN="php /c/…/composer.phar").

5. Konfiguration auf dem Server (shared/.env)

Vorlage: .env.production.example. Bearbeiten nur direkt auf dem Server, damit Passwörter nicht durch Chat oder Repository laufen:

ssh -t -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting "nano test.fewo-stommer.de/shared/.env"
bash scripts/deploy.sh staging artisan optimize     # danach Konfiguration neu einlesen

Gesetzte Werte im Testbetrieb (Geheimnisse ausgelassen):

Schlüssel Wert Bemerkung
APP_ENV staging nicht production → noindex
APP_DEBUG false
APP_URL https://stommer.info alle erzeugten Links bauen darauf auf (URL::forceRootUrl)
APP_KEY gesetzt nie ändern – sonst sind 2FA-Schlüssel und Sitzungen unlesbar
DB_* siehe §3
SESSION_DRIVER / CACHE_STORE database
SESSION_SECURE_COOKIE true Anmeldung nur über HTTPS
QUEUE_CONNECTION sync keine Worker auf Shared Hosting
MAIL_MAILER log Testbetrieb verschickt keine E-Mails (landen in shared/storage/logs)
FEWO_MAILBOX_HOST leer Testbetrieb liest kein echtes Postfach
FEWO_BANK_* leer für Verträge/Angebote noch einzutragen
FEWO_HEALTH_TOKEN, FEWO_SCHEDULER_TOKEN, FEWO_AUTOMATION_SECRET gesetzt für n8n (Überwachung, Scheduler-Ersatz, Webhooks)

5a. E-Mail: Testbetrieb und scharf schalten

  • Betriebsart in der Verwaltung: System › Betrieb (nur Administratoren). Jede Installation beginnt im Testbetrieb: alle E-Mails (an Gäste, Vermieterin, Benachrichtigungen) gehen ausschließlich an die dort eingetragene Testadresse (ohne Eintrag: FEWO_NOTIFICATION_EMAIL), egal was auf der Webseite eingetragen wurde. Ein gelber Hinweis oben in der Verwaltung zeigt das an. Erst „Scharf geschaltet“ liefert an die echten Empfänger.
  • Adressen der internen Kommunikation ebenfalls unter System › Betrieb: Benachrichtigungen an (mehrere Adressen: neue Anfragen, Angebotsantworten, Fristabläufe, Bewertungen, Portal-Mails/-Aufgaben, Kopie der Zahlungserinnerungen), Kontakt- und Antwortadresse (Webseite, Mietvertrag, Antwortadresse der Gäste-Mails), Absendername/-adresse (muss zum SMTP-Postfach MAIL_USERNAME passen – das Formular warnt). Ohne Eintrag gelten FEWO_NOTIFICATION_EMAIL, FEWO_OWNER_EMAIL, MAIL_FROM_* aus shared/.env.
  • FEWO_MAIL_REDIRECT_TO in shared/.env ist eine harte Überschreibung für Testserver (gilt auch bei „scharf“); normalerweise leer lassen.
  • Versandweg: Standard MAIL_MAILER=log – dann wird gar nichts zugestellt (auch nicht im Protokoll gespeichert). Für echten Versand in shared/.env MAIL_MAILER=smtp und MAIL_PASSWORD=<Passwort des Postfachs info@fewo-stommer.de> (nur selbst eintragen; Absender und SMTP-Anmeldung: info@fewo-stommer.de, Antwortadresse und Benachrichtigungen weiter FEWO_OWNER_EMAIL/FEWO_NOTIFICATION_EMAIL = fewo@stommer.de), dann bash scripts/deploy.sh staging artisan optimize.
  • Versand prüfen: bash scripts/deploy.sh staging artisan mail:test – zeigt Versandweg, Umleitung und Fehler (z. B. SMTP-Anmeldung) und schickt eine Testmail.
  • Dass jede Mail-Vorlage fehlerfrei aufgebaut wird (17 Mail-Typen, in ihrem echten Zustand), prüft tests/Feature/MailRenderingTest.php.

6. Erledigt / offen im Testbetrieb

Erledigt (22.10.2026): Ordnerstruktur, shared/.env, Migrationen, Grunddaten (ProductionSeeder: Wohnung, Saisons 2026, Inhalte, Seiten, Erscheinungsbilder), HTTPS unter stommer.info, Gesundheitscheck mit automatischem Rollback, Admin-Konto lars@stommer.com mit 2FA, 39 Fotos importiert und von Metadaten bereinigt, Ende-zu-Ende-Durchlauf Anfrage → Angebot → Annahme (Testbuchung 2026-0002, darf gelöscht werden).

Offen:

  • Konto für Brigitte anlegen: System › Benutzer, Rolle Administrator, Ansicht Einfach (§7).
  • E-Mail im Testbetrieb einschalten (§5a): Versandweg SMTP + Passwort; Betriebsart steht auf Testbetrieb mit Testadresse lars@stommer.com.
  • Scheduler-Auslöser: Lars hat am 27.10.2026 im Strato-Kundenbereich als kleinstes Intervall stündliche Ausführung festgestellt. Das genügt nicht für den vorgesehenen Kalenderimport alle fünf Minuten. Deshalb ist ein externer minütlicher Aufruf vorgesehen; kein zusätzlicher stündlicher Strato-Scheduler für dieselbe Instanz. Auf dem bestehenden Pi läuft n8n 2.7.5. Die 29 vorhandenen Workflows wurden auf einen bereits vorhandenen FewoPortal-/stommer.info-Aufruf geprüft; keiner gefunden. Die tokenfreie Vorlage scripts/n8n-fewo-scheduler.json ist gegen die installierten Schedule- und HTTP-Node-Schemata geprüft. Sie ruft jede volle Minute https://stommer.info/automation/scheduler auf. Laravel führt die jeweils fälligen Aufgaben aus, einschließlich aktiver Kalenderimporte alle fünf Minuten; auch die anderen in routes/console.php definierten Aufgaben werden dadurch zeitgesteuert ausgeführt. Der Header Authorization: Bearer <FEWO_SCHEDULER_TOKEN> gehört in eine verschlüsselte n8n-Zugangsdatenverbindung vom Typ Header Auth, Feldname Authorization. Die Vorlage enthält nur deren Platzhalterreferenz. Token weder in die Workflow-Datei noch in eine URL oder das Repository schreiben. Erfolgreiche Ausführungsdaten werden nicht dauerhaft gespeichert; HTTP-Fehler bleiben Fehler. Noch keine Zugangsdatenübernahme, kein Workflowimport und keine Aktivierung erfolgt. Nach Einrichtung den n8n-Workflow veröffentlichen und mindestens zwei aufeinanderfolgende automatische Kalenderimporte im Sync-Protokoll nachweisen. Die n8n-CLI-Dokumentation verlangt nach CLI-Veröffentlichung einen Neustart; Veröffentlichung in der Oberfläche vermeidet diesen zusätzlichen Neustart.
  • Bankdaten, Vertrags- und AGB-Texte, Rechtstexte prüfen.

Fotos aus dem alten WordPress übernehmen

Die Auswahl (39 aktuelle Fotos: Wohnung, Garten/Terrasse/Luftbilder, Umgebung – ohne Theme-Platzhalter, Logos, Vorschaugrößen und veraltete Einrichtung) mit Kategorie und Bildbeschreibung steht in database/data/wordpress-photos.csv. Der Import liest die Dateien nur aus dem WordPress-Ordner (dort wird nichts verändert), legt Original + WebP-Größen in shared/storage/app/public ab und überspringt bereits importierte Fotos (wiederholbar):

bash scripts/deploy.sh staging artisan photos:import /mnt/web508/e3/26/51539426/htdocs/www.fewo-stommer.de/wp-content/uploads --manifest=database/data/wordpress-photos.csv

Danach in der Verwaltung (Webseite › Fotos) Reihenfolge, Sichtbarkeit und Texte prüfen.

  • Gitea-Runner für automatisches Deployment (DEPLOYMENT.md §5).

7. Zugang zur Verwaltung (/admin)

Benutzer anlegen – der erste Administrator per Befehl (das Passwort wird verdeckt im eigenen Terminal eingegeben, nie als Argument):

ssh -t -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting \
  "cd test.fewo-stommer.de/current && /opt/RZphp84/bin/php-cli artisan users:create lars@stommer.com --name='Lars Stommer' --role=admin"

Weitere Benutzer legt ein Administrator in der Verwaltung an (System › Benutzer): Name, E-Mail, Rolle (was die Person darf) und Ansicht (was das Menü zeigt), Passwort. Rollen: admin (alles inkl. Benutzer), rentals (Vermietung), content (Inhalte); ohne Rolle kein Zugang. Festlegung 22.10.2026: Lars und Brigitte beide admin (dürfen alles); Brigitte mit einfacher Ansicht (beim Anlegen „Ansicht: Einfach“ wählen, sonst erhalten Administratoren die Expertenansicht).

Ansichten: Einfache Ansicht – Anfragen & Buchungen (Angebot senden, Mietvertrag, Zahlungen), Sperrzeiten, Preise & Angebote (Saisons, Sonderangebote/Rabattcodes, Extras), Gäste, Portal-Aufgaben, Bewertungen, Bilder. Expertenansicht – alle Einstellungen, die die Rolle erlaubt (Preise, Angebote, Portale, Webseite, System). Ohne Auswahl: Administratoren Experten-, alle anderen einfache Ansicht. Umschalten jederzeit über das Benutzermenü oben rechts („Zur … Ansicht wechseln“). Die Ansicht blendet nur Menüpunkte aus; Rechte regelt allein die Rolle.

Passwort vergessen: Ein Administrator vergibt unter System › Benutzer › Bearbeiten ein neues Passwort (eine Selbst-Zurücksetzung per E-Mail gibt es bewusst nicht). Handy verloren: dort Aktion „2FA zurücksetzen“ – die Person richtet die 2FA bei der nächsten Anmeldung neu ein.

Zwei-Faktor-Anmeldung (2FA): Filament-eigene Lösung mit Authenticator-App (TOTP, z. B. Bitwarden/Vaultwarden, Google oder Microsoft Authenticator) und Wiederherstellungscodes.

  • Pflicht für alle Konten (Entscheidung 22.10.2026): Nach der ersten Anmeldung wird man auf die Einrichtungsseite geleitet (QR-Code scannen, Code bestätigen, Wiederherstellungscodes sichern). Filament-Standard (multiFactorAuthentication(isRequired: true)).
  • Schlüssel und Codes liegen verschlüsselt (mit APP_KEY) in users.app_authentication_secret / app_authentication_recovery_codes.
  • Handy verloren: Anmeldung mit einem Wiederherstellungscode. Sind auch die weg, setzt ein Administrator mit Serverzugang die 2FA zurück:
    bash scripts/deploy.sh staging artisan tinker --execute='App\Models\User::where("email", "lars@stommer.com")->update(["app_authentication_secret" => null, "app_authentication_recovery_codes" => null]);'
    
    Danach bei der nächsten Anmeldung neu einrichten.

Lokal (nur Entwicklung, php artisan migrate:fresh --seed): admin@example.com / password, 2FA wird bei der ersten Anmeldung eingerichtet.

7a. Datensicherung, Löschfristen, Automationen

  • Datenbank-Backup: täglich 02:30 per Scheduler (php artisan backup:database) als shared/storage/app/private/backups/fewo-<datum>.sql.gz; es bleiben die neuesten 14 (FEWO_BACKUP_KEEP). Wiederherstellen: Datei entpacken und mit mysql bzw. phpMyAdmin (Strato) einspielen.
  • Sicherung aufs NAS / einen Rechner (holt eine frische Datenbank-Sicherung plus Fotos und Verträge; auf dem Server wird nichts verändert):
    bash scripts/backup-pull.sh staging /pfad/zum/nas/fewo-backup
    
    Regelmäßig z. B. per Aufgabenplanung des NAS/PC ausführen (braucht den SSH-Schlüssel aus §4).
  • Löschfristen (Vorschläge, rechtlich zu bestätigen – config/fewo.php bzw. .env): Gästedaten 10 Jahre nach letztem Aufenthalt (FEWO_GUEST_RETENTION_YEARS), nie verbindlich gewordene Anfragen/Angebote 6 Monate (FEWO_RETENTION_INQUIRY_MONTHS), Textauszüge von Portal-Mails 90 Tage (FEWO_RETENTION_PORTAL_EMAIL_EXCERPT_DAYS), Herkunftsangaben/UTM 24 Monate (FEWO_RETENTION_ATTRIBUTION_MONTHS). Läuft täglich 03:00. Anonymisierung ersetzt Name, Kontaktdaten, Nachrichten, Notizen, Herkunft und Bewertungs-Anzeigenamen; Buchung, Preise und Zahlungen bleiben als Beleg.
  • Bot-Schutz der Buchungsanfrage (ohne externen Captcha-Dienst, config/fewo.php › spam): verstecktes Köderfeld, Zeitsperre (Absenden schneller als 4 s nach dem Öffnen = Bot, wird still ignoriert), höchstens 5 Anfragen/Stunde je IP, 3/Tag je E-Mail-Adresse, 30/Stunde insgesamt, höchstens 2 gleichzeitig vorgemerkte Anfragen je E-Mail-Adresse (sonst könnten Bots den Kalender blockieren), keine Links in Namen und höchstens 1 Link in der Nachricht.
  • Automationen (n8n): Token bitte als Header Authorization: Bearer <token> senden (landet nicht in Server-Logs); ?token= funktioniert übergangsweise weiter.
  • Fotos: Beim Hochladen werden Metadaten (GPS, Kamera) aus dem Original entfernt; bestehende Fotos einmalig: php artisan photos:strip-metadata (--force bearbeitet auch bereits markierte erneut). Hinweis: bewusst mit GD – Imagick (auf Strato installiert) behält EXIF beim Speichern.

8. Bekannte Eigenheiten und Lösungen

Problem Ursache Lösung (umgesetzt)
Nach dem Umschalten lief die alte Version weiter Strato-OPcache speichert Skripte unter dem Symlink-Pfad current/… .htaccess zeigt auf den konkreten Ordner releases/<version>/public und wird bei jedem Umschalten neu geschrieben
Links mit /current/public (z. B. Sitemap) Laravel leitet den Basis-Pfad aus dem Skript-Pfad ab URL::forceRootUrl(APP_URL) außerhalb von local/testing (AppServiceProvider)
HTTP 500 „Composer platform“ Web-PHP des Pakets ist 8.3 AddType application/x-httpd-php84 .php in der Ordner-.htaccess
Im Admin hochgeladenes Foto erscheint in der Fotoliste, auf der Website/im Grundriss-Editor aber als leeres Bild (HTTP 403) Upload-Feld nahm Filaments Standard-Speicher FILESYSTEM_DISK=local (privat, storage/app/private/<media-id>); Import und Website nutzen public Seit 23.10.2026 (1871c04): Fotos immer auf public (Photo-Sammlung useDisk('public'), Upload-Feld ->disk('public')); Migration 2026_10_23_171001_move_photo_media_to_the_public_disk hat vorhandene private Fotos verschoben (stommer.info: Foto 41). Direkt nach dem Verschieben kann Strato die Adresse kurz noch mit 403 beantworten
SSH „connection closed“ falscher Server ssh.strato.de paketspezifischer Server (§2)
Domain-Ziel current/public nicht wählbar Strato erlaubt kein Symlink-Ziel Domain auf den Deploy-Ordner, .htaccess leitet weiter
Ersteinrichtung mit Factories schlägt fehl Produktion ohne Dev-Pakete ProductionSeeder
Kein SSL für Subdomain Paket erlaubt SSL nur für Hauptdomains Testbetrieb auf stommer.info
Disk quota exceeded beim Hochladen / Hinweis „zu viele Dateien“ Webspace-Kontingent voll (geteilt mit allen anderen Seiten/Backups im Paket); jede Version belegt ~136 MB Es ist die Anzahl der Dateien (Inode-Limit), nicht der Platz. Der Server behält nur die aktive Version (Geschichte als Git-Tags in Gitea), vendor wird beim Build ausgedünnt (~15.000 statt ~19.500 Dateien je Version); Reste abgebrochener Läufe räumt das nächste Deployment selbst weg. Ordner außerhalb des Deploy-Ordners entscheidet nur Lars (teils produktiv).
Signierte Links (Angebot, Bewertung, Newsletter, Vorschau) mit 403 Strato meldet nach der .htaccess-Weiterleitung den internen Pfad /releases/<version>/public/… in REQUEST_URI public/index.php entfernt dieses Präfix vor dem Start von Laravel
Keine E-Mails im Testbetrieb, auch nicht im Protokoll MAIL_MAILER=log schreibt auf Stufe debug, LOG_LEVEL=info verwirft das Zum Testen SMTP einschalten; FEWO_MAIL_REDIRECT_TO leitet dann alle Mails an eine Adresse (gesetzt: lars@stommer.com)
Foto-Metadaten (GPS) blieben erhalten Spatie Image nutzt Imagick, wenn installiert (Strato), und Imagick behält EXIF StripImageMetadata erzwingt GD
Windows: Symlinks, php nicht im PATH Git Bash Deploy nur gegen Strato testen; export PATH="<php-ordner>:$PATH"

9. Nützliche Befehle

bash scripts/deploy.sh staging deploy                 # ausliefern (letzter Commit)
bash scripts/deploy.sh staging releases               # aktive Version + Deploy-Tags in Git
bash scripts/deploy.sh staging deploy deploy/staging/<zeitstempel>   # frühere Version erneut ausliefern
bash scripts/deploy.sh staging artisan about          # Zustand der Installation
bash scripts/deploy.sh staging artisan migrate:status
ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting \
  "tail -n 50 test.fewo-stommer.de/shared/storage/logs/laravel-$(date +%F).log"   # Fehlerprotokoll