Doku und Vorlage auf build-conf.txt umstellen (Karte 961)

[daniel-marthaler]

Das README beschrieb einen Weg, der nicht funktioniert

Abschnitt 2 liess Consumer-Projekte eine plaintext-build.cfg anlegen, während load_build_conf() ausschließlich build-conf.txt sucht. Wer der Anleitung folgte, bekam ERROR: build-conf.txt not found.

Gemessen in plaintext-scripts/*.sh:

build-conf.txt          27 Vorkommen
plaintext-build.cfg      0 (außer einem Kommentar)
PLAINTEXT_BUILD_CONFIG   0     <- die Doku führte es als Priorität 2
(Kontrolle: load_build_conf 4, PLAINTEXT_CONFIG_DIR 17 — die Suche funktioniert)

Was sich ändert

1. Vorlage umbenannt, Inhalt unverändert: plaintext-build.cfg.template → build-conf.txt.template (per git mv).

2. Abschnitt 2 legt jetzt build-conf.txt an, mit dem Hinweis, dass der Dateiname nicht frei wählbar ist.

3. Die Prioritätenliste war zur Hälfte erfunden. Sie versprach vier Ebenen, davon existieren zwei nicht:

- | 1 | Individual environment variables | CI overrides, one-off changes |
- | 2 | `PLAINTEXT_BUILD_CONFIG` env     | GitHub Actions                |
- | 3 | `plaintext-build.cfg` file       | Local development             |
- | 4 | `build-conf.txt` file            | Legacy support                |
+ | 1 | `$PLAINTEXT_CONFIG_DIR/<projektname>/build-conf.txt` | zentrale Konfiguration |
+ | 2 | `<projektverzeichnis>/build-conf.txt`                | Projekte außerhalb     |

Dazu ein Hinweis, der praktisch wichtig ist: load_build_conf() setzt die Werte per export und überschreibt damit gleichnamige Umgebungsvariablen. Eine Variable vorher zu setzen wirkt also nicht als Übersteuerung — die Doku behauptete mit „Individual environment variables (highest wins)" genau das Gegenteil.

4. tui-modules-logic.sh:28: der Kommentar read WEBAPP_MODULE from build-conf.txt or plaintext-build.cfg ist richtiggestellt. Der Code darunter las immer nur build-conf.txt — dieser Kommentar war der einzige Treffer im ganzen Skript-Repo und hat bei der Untersuchung zu Karte 961 zunächst eine falsche Fährte gelegt.

Zusammenhang

Die sechs plaintext-build.cfg in plaintext-config entfernt Plaintext-Gmbh/plaintext-config#86. Beide PRs zusammen stellen sicher, dass es nur noch eine Build-Konfiguration gibt — eine Korrektur in der falschen Datei hat bei Karte 955 einen Deploy-Zyklus gekostet.

Was ich NICHT geprüft habe

Ob außerhalb dieser Organisation jemand die Vorlage unter ihrem alten Namen einbindet. Innerhalb wird sie nur vom README referenziert (2 Stellen, beide angepasst).