ET-BOOTSTRAP-TOOL-CONTRACT-001

Bootstrap Tool Contract#

Verantwortung#

plant oder materialisiert eine lokale Engineering-Installation aus einer JSON-Beschreibung. Der bestehende Bootstrap Execution Contract konkretisiert die Ausführungs- und Evidenzpflichten.

Eingabe#

engineering-bootstrap.py CONFIG [--apply] [--configure-database] [--force-env] [--report PATH]

CONFIG ist die Installationsbeschreibung im JSON-Format.
Ohne --apply bleibt der Lauf planend und prüfend.
--configure-database autorisiert zusätzlich die ausdrücklich dokumentierte native Datenbankkonfiguration.
--force-env autorisiert das Überschreiben bestehender .env-Dateien.

Ausgaben und #

Der Lauf erzeugt eine nachvollziehbare Planung beziehungsweise einen Report am Standard- oder angegebenen Reportpfad. Secret-Werte dürfen nicht in die übernommen werden.

Seiteneffekte#

Seiteneffekte sind ohne --apply unzulässig. Datenbankänderungen benötigen zusätzlich --configure-database; das Überschreiben vorhandener Umgebungsdateien zusätzlich --force-env.

Wiederholbarkeit#

Der Bootstrap ist idempotent auszulegen. Vorhandene Konfiguration wird ohne ausdrückliche Ausnahme nicht überschrieben. Bereits vorhandene oder entfernte Datenbankobjekte dürfen einen wiederholten Lauf nicht unkontrolliert abbrechen lassen.

Verifikation#

tests/test_engineering_bootstrap.py
../98-tests/bootstrap-contract-test-plan.md
KNOWN-FINDING-DATABASE-VERIFICATION.md