Add detailed comments and app flow documentation for BlazorWasm

Added comprehensive inline comments (mainly in German) to key files (index.html, Program.cs, App.razor, MainLayout.razor, NavMenu.razor, Catalogs.razor, CatalogApiClient.cs) to clarify their roles and the overall application flow. Updated Home.razor with a clearer heading and intro. Introduced Ablauf.cs, which documents the loading order and responsibilities of each major component. These changes enhance codebase clarity and maintainability, especially for German-speaking developers.
This commit is contained in:
OlgunR
2026-01-28 15:03:52 +01:00
parent 05964eb02e
commit 98b841196e
9 changed files with 152 additions and 36 deletions

View File

@@ -1,34 +1,51 @@
<!DOCTYPE html>
<html lang="en">
<!--
• Ist der technische Einstiegspunkt der Blazor WebAssembly-Anwendung.
• Sie lädt die notwendigen Ressourcen (z. B. das Blazor-Skript blazor.webassembly.js)
und definiert den Platzhalter <div id="app">, in dem die Blazor-Komponenten gerendert werden.
• Ohne diese Datei könnte die Blazor-Anwendung nicht starten, da sie die Verbindung
zwischen der statischen HTML-Welt und der Blazor-Welt herstellt.
kurz: Startet die Anwendung und lädt die Blazor-Umgebung.
-->
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>DbFirst.BlazorWasm</title>
<base href="/" />
<link rel="stylesheet" href="_content/DevExpress.Blazor.Themes/bootstrap-external.bs5.min.css" />
<link rel="stylesheet" href="_content/DevExpress.Blazor.Themes/icons.css" />
<link rel="stylesheet" href="css/bootstrap/bootstrap.min.css" />
<link rel="stylesheet" href="css/app.css" />
<link rel="icon" type="image/png" href="favicon.png" />
<link href="DbFirst.BlazorWasm.styles.css" rel="stylesheet" />
</head>
<!DOCTYPE html>
<html lang="en">
<body>
<div id="app">
<svg class="loading-progress">
<circle r="40%" cx="50%" cy="50%" />
<circle r="40%" cx="50%" cy="50%" />
</svg>
<div class="loading-progress-text"></div>
</div>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>DbFirst.BlazorWasm</title>
<base href="/" />
<div id="blazor-error-ui">
An unhandled error has occurred.
<a href="" class="reload">Reload</a>
<a class="dismiss">🗙</a>
</div>
<script src="_framework/blazor.webassembly.js"></script>
</body>
<!-- Stylesheets für DevExpress und Bootstrap -->
<link rel="stylesheet" href="_content/DevExpress.Blazor.Themes/bootstrap-external.bs5.min.css" />
<link rel="stylesheet" href="_content/DevExpress.Blazor.Themes/icons.css" />
<link rel="stylesheet" href="css/bootstrap/bootstrap.min.css" />
<link rel="stylesheet" href="css/app.css" />
<!-- Favicon und App-spezifische Styles -->
<link rel="icon" type="image/png" href="favicon.png" />
<link href="DbFirst.BlazorWasm.styles.css" rel="stylesheet" />
</head>
<body>
<!-- Einstiegspunkt der Blazor-Anwendung -->
<div id="app">
<svg class="loading-progress">
<circle r="40%" cx="50%" cy="50%" />
<circle r="40%" cx="50%" cy="50%" />
</svg>
<div class="loading-progress-text"></div>
</div>
<!-- Fehler-UI für unvorhergesehene Fehler -->
<div id="blazor-error-ui">
An unhandled error has occurred.
<a href="" class="reload">Reload</a>
<a class="dismiss">🗙</a>
</div>
<!-- Blazor WebAssembly-Skript -->
<script src="_framework/blazor.webassembly.js"></script>
</body>
</html>