agent foundation

docs/frontend-javascript.md

@@ -1,6 +1,6 @@
 # Frontend JavaScript
 
-Letzte Aktualisierung: 2026-03-04
+Letzte Aktualisierung: 2026-03-05
 
 ## Ordnerstruktur
 
@@ -283,9 +283,24 @@ Für standardisierte Detailseiten gilt zusätzlich:
 Für allgemeine Form-/Button-Confirms außerhalb der Detail-Policy gilt:
 
 - zentral über `web/js/components/app-confirm-actions.js`
-- Confirm-Text über `data-confirm-message`
+- Dialog-Engine zentral über `web/js/core/app-confirm-dialog.js` (`confirmDialog.confirm(...)`)
+- Confirm-Text über `data-confirm-message` bzw. auf Detail-Aktionen `data-detail-confirm-message`
+- optionale Dialog-Meta über
+  - `data-confirm-title`, `data-confirm-confirm-label`, `data-confirm-cancel-label`, `data-confirm-variant`, `data-confirm-focus`
+  - analog für Detail-Aktionen: `data-detail-confirm-*`
+- kein direktes `window.confirm(...)` in App-JS
 - keine inline `onclick="return confirm(...)"` / `onsubmit="return confirm(...)"` verwenden
 
+### Frontend Telemetry Standard
+
+Für UX-/Fehler-Telemetrie im Frontend gilt:
+
+- zentral über `web/js/core/app-telemetry.js` (`telemetry.capture(...)`)
+- `warnOnce(...)` sendet standardisiert `frontend.warn_once`
+- AJAX-/Fetch-Fehler laufen zentral über den globalen Fetch-Hook als `frontend.ajax_error`
+- keine neuen Console-only-Warnpfade für relevante UX-Probleme ohne Telemetrie
+- Payloads nur mit Whitelist-Feldern und ohne sensitive Rohdaten (keine Tokens/Query-Parameter/Stacktraces)
+
 ### Detail Validation Summary Standard
 
 Für serverseitige Formularfehler in Create/Edit-Templates gilt: