frontend/ci: Build-Hinweis in die App-Quelle, env-gesteuert; Prod-Build ohne

Der Latest-Build-Hinweis wandert vom Workflow-sed in die App (app.js,
mountBuildBadge), damit ihn auch der Dev-Server zeigt — ein Post-Build-sed
erreicht den Dev-Server nicht. Logik umgekehrt: Hinweis ist der Normalfall,
nur die produktive Installation schaltet ihn ab.

Drei Zustaende ueber Vite-Env VITE_BUILD_BADGE (Auswertung in app.js):
- Dev-Server (import.meta.env.DEV) -> 🔧 "Vorschau/lokaler Entwicklungsstand"
- Default `npm run build` (Env ungesetzt) -> 🚧 "latest build"; der Pages-
  Deploy nutzt den Default und traegt den Hinweis dadurch automatisch (die
  sed-Injektion entfaellt).
- `npm run build:prod` (Vite-Modus prod, .env.prod: VITE_BUILD_BADGE=none)
  -> KEIN Badge; esbuild eliminiert den Zweig als toten Code.

Verifiziert zur Laufzeit (Dev + `vite preview` auf beiden Builds): 🔧 im Dev,
🚧 im Default-Build, gar nichts im Prod-Build (Titel sauber "Werkbaum").
34 Vitest-Tests gruen, Workflow-YAML/Shell gueltig.

Doku: D16 fortgeschrieben (quellbasiert/env statt sed, Begruendung); README
(de/en) mit Prod-Build-Anleitung inkl. LICENSE-/Versions-Caveats; frontend/
CLAUDE.md; .claude/launch.json bekommt einen frontend-dist-Preview (vite
preview, Port 8138) zum Verifizieren gebauter Dateien.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
mhoennig
2026-07-22 05:56:59 +02:00
co-authored by Claude Opus 4.8
parent b7bf9182ea
commit 0f27bab905
10 changed files with 135 additions and 23 deletions
+3 -8
View File
@@ -39,6 +39,9 @@ jobs:
# als ES-Module unter frontend/src/, Vite bündelt sie zu EINER
# self-contained frontend/dist/index.html (JS+CSS+Favicon inline). Tests
# laufen zuerst — schlägt Vitest fehl, wird nicht deployt.
# Hinweis: der Default-`npm run build` trägt den 🚧-„latest build"-Hinweis
# hinter dem Titel automatisch in sich (app.js/mountBuildBadge, D16) — der
# Pages-Deploy ist bewusst der latest build. Nur `build:prod` ließe ihn weg.
- name: Node einrichten
uses: actions/setup-node@v4
with:
@@ -75,16 +78,8 @@ jobs:
BUILD_VERSION="${MAJORMINOR}.${MICRO}"
COMMIT_URL="https://github.com/mhoennig/werkbaum/commit/$(git rev-parse HEAD)"
echo "Footer-Version: ${BUILD_VERSION} -> ${COMMIT_URL}"
# Latest-Build-Hinweis (Symbol + Tooltip) hinter dem Titel: kennzeichnet
# NUR diese Pages-Veröffentlichung als Entwicklungsstand. Wird bewusst
# erst hier auf der Site-Kopie injiziert (wie Version/LICENSE), damit die
# Quelle und jede andere Instanz (schlichter `npm run build`) ihn nicht
# tragen. Literale UTF-8-Zeichen (kein `#`/`&`, sonst kollidiert der
# sed-Delimiter); Anker `</h1>` ist im Bundle eindeutig.
BADGE='<span class="build-badge" role="img" aria-label="Latest build may be buggy" title="Aktueller Entwicklungsstand (latest build) kann noch Fehler enthalten · Latest development build may still be buggy" style="margin-left:.45em;font-size:.58em;vertical-align:middle;cursor:help;user-select:none;text-decoration:none">🚧</span>'
mkdir -p site
sed -e 's#\.\./LICENSE#LICENSE#g' \
-e "s#</h1>#${BADGE}</h1>#" \
-e "s#\(<a class=\"ver\" href=\"\)[^\"]*#\1${COMMIT_URL}#" \
-e "s#\(<a class=\"ver\"[^>]*>\)[0-9.]\+</a>#\1${BUILD_VERSION}</a>#" \
frontend/dist/index.html > site/index.html