ENERGIETEC TESTSERVER – INSTALLATION
===================================

Voraussetzungen
---------------
- PHP 8.4.1 oder neuer
- MySQL/MariaDB und die ueblichen Laravel-PHP-Erweiterungen
- Apache mit mod_rewrite und erlaubten .htaccess-Dateien
- Document-URL: https://IHRE-DOMAIN.TLD/energietec

Ordnerstruktur
--------------
Der gesamte Inhalt des Ordners "energietec" gehoert nach:
public_html/energietec

Die oeffentlichen Dateien liegen direkt dort. Der Laravel-Kern liegt im
gesperrten Unterordner _app und ist nicht ueber den Browser erreichbar.

Einrichtung per SSH

Auf diesem Server PHP 8.4 verwenden:
   PHP84=/opt/cpanel/ea-php84/root/usr/bin/php
-------------------
1. In public_html/energietec/_app wechseln.
2. Konfiguration anlegen:
   cp .env.server.example .env
3. APP_URL, DB_*, ADMIN_EMAIL und ADMIN_PASSWORD in .env eintragen.
4. Schreibrechte setzen:
   chmod -R 775 storage bootstrap/cache
5. Anwendungsschluessel erzeugen:
   "$PHP84" artisan key:generate --force
6. Tabellen und Inhalte anlegen:
   "$PHP84" artisan migrate --seed --force
7. Medienverknuepfung erstellen:
   "$PHP84" artisan storage:link
8. Alte Caches entfernen:
   "$PHP84" artisan optimize:clear

9. Sichere Produktionscaches aufbauen:
   "$PHP84" artisan config:cache
   "$PHP84" artisan view:cache

Wichtig: Für diese Vorschau im Unterordner nicht `artisan optimize` verwenden.
Der Befehl erzeugt zusätzlich einen Route-Cache. Diesen erst aktivieren, wenn alle
GET- und POST-Routen auf dem Zielserver vollständig geprüft wurden.

Wichtig
-------
- Eine echte .env-Datei und Zugangsdaten sind nicht im ZIP enthalten.
- Der Link public_html/energietec/storage wird erst durch "storage:link"
  erzeugt und zeigt auf _app/storage/app/public.
- Fuer den Testversand von Formularen SMTP konfigurieren. Mit MAIL_MAILER=log
  wird keine Nachricht versendet; sie steht nur im Laravel-Log.
- Nach dem Einrichten APP_DEBUG=false beibehalten.
