4. Dateien und Verzeichnisse¶
4.1. Repository-Root¶
planer: zentraler Entwicklungs-, Betriebs- und Migrationsbefehlcompose.yaml: lokale Docker-Compose-Umgebungcompose.production.yaml: produktive Docker-Compose-UmgebungDockerfile: PHP-/Node-Build- und Laufzeit-Imagesbackup.yaml: nicht versionierte Backup-Konfigurationscripts/: Root-Betriebs-, Backup-, Migrations- und Testskriptedocs/manual/: drei veröffentlichte Handbücher und gemeinsame Mediensrc/: Laravel-Anwendung als Git-Subtree
Der empfohlene Einstieg für eine neue Umgebung ist Installation und Erstbetrieb mit Docker. Die Datei beschreibt auch, welche Daten außerhalb des Quellcodes persistent bleiben müssen.
4.2. Anwendungsquellcode unter src/¶
app/: Anwendungslogikapp/Http/Controllers/Api/: API-Controllerapp/Actions/: fachliche Aktionenapp/Models/: Domänenmodelleconfig/: Laufzeitkonfigurationdatabase/: Migrationen, Factories, Seederconfig/manual.php: Zuordnung von Anwendungsrouten zu Handbuchkapitelnresources/js/: Vue- und Inertia-Frontendroutes/: Web-, API- und Teilroutenscripts/: Build-, Release- und Hilfsskriptestorage/: Logs und lokale Laufzeitdaten der Laravel-Anwendungstorage/inbox/: gemeinsamer Eingang des FTP-Dienstes für noch nicht verarbeitete Scanner-Dateien; dauerhaft gespeicherte Anhänge liegen in MinIO
4.3. Dokumentationsrelevante Dateien¶
../docs/manual/: gemeinsame Manual-Quelle aus Sicht vonsrc/scripts/build-manual-site.js: baut alle drei Manuals als statische Site und PDFscripts/deploy-manual-site.js: deployt die gebaute Handbook-Siteapp/Console/Commands/DevBuilder/BuildManualPages.php: erzeugt Benutzerhandbuch-Seiten wie Versionsangaben und Lizenzen../scripts/manual.sh: Root-Dispatcher für Manual-Build, Dusk, Site und Veröffentlichung
4.4. Betriebs- und Update-relevante Dateien¶
compose.yaml: lokale Entwicklungsumgebung einschließlich Manual-Containercompose.production.yaml: Produktionsumgebungftp_inbox: persistentes Compose-Volume für den FTP-Eingang; nicht mit dem MinIO-Bucket verwechselnplaner: zentraler Einstieg für Betrieb, Updates und Datenpflegescripts/update-production.sh: abgesicherter Produktions-Update-Ablauf
4.5. API-relevante Dateien¶
routes/api.php: lädt alle API-Teilroutenroutes/api/*.php: Route-Definitionenapp/Console/Commands/GenerateOpenApiSpec.php: erzeugtopenapi.jsonapp/Http/Controllers/Api/OpenApiSpec.php: zentrale OpenAPI-Tags und Serverdefinition