Load external modules once and added documentation

Author: dbeuchler

docs/articles/launcher/Launcher.md

@@ -0,0 +1,42 @@
+# Launcher
+
+## Sorting
+
+To sort your modules in the launcher, you can use the `SortIndex` property within the `appsettings.json`. This property allows you to define the order of modules by assigning them an index value. Modules with lower index values will appear before those with higher values.
+
+````json
+{
+  "Shell": {
+    "SortIndex": {
+      "moduleA-route": 10,
+      "moduleB-route": 20,
+      "moduleC-route": 15
+    }
+  }
+}
+````
+
+## External Modules
+
+To define external modules in the launcher configuration, you can use the `ExternalModules` property within the `appsettings.json`. This allows you to specify
+modules that should be loaded from external sources rather than being bundled with your application.
+
+External modules are integrated with the `<embed>` tag; the external web-page must support being embedded in an iframe.
+
+````json
+{
+  "Shell": {
+    "SortIndex": {
+      "example": 10
+    },
+    "ExternalModules": [
+      {
+        "Route": "example",
+        "Title": "Example",
+        "Url": "http://www.example.com",
+        "Icon": "globe"
+      }
+    ]
+  }
+}
+````

docs/migrations/v8_to_v10.md

@@ -44,24 +44,7 @@ The `ProductFileEntity` has been removed from the data model as it was not utili
 
 ## Removal of Modules-Analytics
 
-The analytics module was doing nothing and the web module was replaced by supporting external modules in `Launcher`. Its now supported to embed external web-pages into the shell.
-Extend your `appsettings.json` by the following:
-
-````json
-"Shell": {
-  "SortIndex": {
-    ...
-  },
-  "ExternalModules": [
-    {
-      "Route": "example",
-      "Title": "Example",
-      "Url": "http://www.example.com",
-      "Icon": "globe"
-    }
-  ]
-}
-````
+The analytics module was doing nothing and the web module was replaced by supporting external modules in `Launcher`. Its now supported to embed external web-pages into the shell. Refer to the [Launcher](/docs/articles/launcher/Launcher.md) documentation for more information.
 
 ## Rarely used features removed
 

src/Moryx.Launcher/Pages/External.cshtml.cs

@@ -23,6 +23,7 @@ public class ShellNavigator : IShellNavigator
         private readonly IConfiguration _configuration;
         private readonly ILogger _logger;
         private readonly MoryxAccessManagementClient _client;
+        private readonly IReadOnlyList<ExternalModuleItem> _externalModules;
 
         public EndpointDataSource EndpointsDataSource { get; }
         public PageLoader PageLoader { get; }
@@ -47,6 +48,8 @@ public ShellNavigator(
                     logger.CreateLogger($"{nameof(ShellNavigator)}:{nameof(MoryxAccessManagementClient)}")
                 );
             }
+
+            _externalModules = LoadExternalModules();
         }
 
         /// <inheritdoc />
@@ -77,13 +80,7 @@ public async Task<IReadOnlyList<ModuleItem>> GetModuleItems(HttpContext context)
             var modules = compiledPageActionDescriptors.Select(CreateWebModuleItem)
                 .Where(m => m != null).ToList<ModuleItem>();
 
-            // Load external modules
-            var externalModuleConfigs = _configuration.GetSection("Shell:ExternalModules").Get<ExternalModuleConfig[]>();
-            if (externalModuleConfigs != null)
-            {
-                var externalModules = externalModuleConfigs.Select(CreateExternalModuleItem).ToList();
-                modules.AddRange(externalModules);
-            }
+            modules.AddRange(_externalModules);
 
             // Rudimentary sorting
             var index = 0;
@@ -97,6 +94,12 @@ public async Task<IReadOnlyList<ModuleItem>> GetModuleItems(HttpContext context)
             return modules;
         }
 
+        private ExternalModuleItem[] LoadExternalModules()
+        {
+            var externalModuleConfigs = _configuration.GetSection("Shell:ExternalModules").Get<ExternalModuleConfig[]>();
+            return externalModuleConfigs?.Select(CreateExternalModuleItem).ToArray() ?? [];
+        }
+
         private static ExternalModuleItem CreateExternalModuleItem(ExternalModuleConfig externalModuleConfig)
         {
             return new ExternalModuleItem