README

Bootstrap Installer#

Der Bootstrap materialisiert die dokumentierte Engineering-Installation reproduzierbar.

Führende Beschreibung#

10-bootstrap/config/engineering-installation.example.json

Die Beschreibung legt fest:

• ENGINEERING_HOME
• Repositorypfade
• Test- und Produktionsports
• native MariaDB-Datenbanken und Benutzer
• unterstützte Sprachen
• Seed-Manifest
• externe Abhängigkeiten

Arbeitsweise#

Der Installer ist standardmäßig ein Planungs- und Prüfwerkzeug. Ohne --apply verändert er keine Runtime-Dateien.

cp 10-bootstrap/config/engineering-installation.example.json \
                   10-bootstrap/config/engineering-installation.local.json

                python3 10-bootstrap/engineering-bootstrap.py \
                   10-bootstrap/config/engineering-installation.local.json

Materialisieren:

python3 10-bootstrap/engineering-bootstrap.py \
                   10-bootstrap/config/engineering-installation.local.json \
                   --apply

Native MariaDB ausdrücklich konfigurieren:

python3 10-bootstrap/engineering-bootstrap.py \
                   10-bootstrap/config/engineering-installation.local.json \
                   --apply \
                   --configure-database

Sicherheitsregeln#

• Bestehende .env-Dateien werden nicht überschrieben.
• --force-env ist eine ausdrückliche Ausnahme.
• System- und DB-Änderungen erfolgen nur mit --apply und --configure-database.
• Das Startpasswort user ist ausschließlich eine lokale MVP-Vorgabe und muss vor externer Erreichbarkeit ersetzt werden.
• Reports enthalten keine ausgelesenen Secret-Werte.

Verbindliche Verträge#

• TOOL_CONTRACT.md
• BOOTSTRAP-EXECUTION-CONTRACT.md
• KNOWN-FINDING-DATABASE-VERIFICATION.md