Add configuration admin menu link and sort Admin submenu alphabetically - PR_26152_059-admin-menu-configuration-link

Author: ToolboxAid

GameFoundryStudio/assets/js/gamefoundry-partials.js

@@ -18,7 +18,7 @@
         "sound-studio": "tools/sound-studio.html",
         "storage-inspector": "tools/storage-inspector.html",
         "world-vector-studio": "tools/world-vector-studio.html",
-        "configuration-admin": "admin/site-settings.html",
+        "configuration-admin": "tools/groups/configuration-admin.html",
         games: "arcade/index.html",
         arcade: "arcade/index.html",
         "game-action": "arcade/index.html#action",
@@ -72,6 +72,7 @@
 
     const rootPageRoutes = new Set([
         "tools",
+        "configuration-admin",
         "ai-assistant",
         "animation-studio", "asset-studio", "code-studio", "input-studio", "midi-studio",
         "object-vector-studio", "palette-manager", "particle-studio", "sound-studio", "storage-inspector",

GameFoundryStudio/assets/partials/header-nav.html

@@ -43,17 +43,18 @@
       <div class="nav-item">
         <a data-nav-link data-route="admin" href="admin/site-settings.html">Admin &#9662;</a>
         <div class="sub-menu">
-          <a data-nav-link data-route="admin-site-settings" href="admin/site-settings.html">Site Settings</a>
+          <a data-nav-link data-route="admin-analytics" href="admin/analytics.html">Analytics</a>
           <a data-nav-link data-route="admin-branding" href="admin/branding.html">Branding</a>
-          <a data-nav-link data-route="admin-themes" href="admin/themes.html">Themes</a>
-          <a data-nav-link data-route="admin-design-system" href="admin/design-system.html">Design System</a>
           <a data-nav-link data-route="admin-controls" href="admin/controls.html">Controls</a>
+          <a data-nav-link data-route="admin-design-system" href="admin/design-system.html">Design System</a>
           <a data-nav-link data-route="admin-grouping-colors" href="admin/grouping-colors.html">Grouping Colors</a>
+          <a data-nav-link data-route="admin-moderation" href="admin/moderation.html">Moderation</a>
           <a data-nav-link data-route="admin-ratings" href="admin/ratings.html">Ratings</a>
-          <a data-nav-link data-route="admin-users" href="admin/users.html">Users</a>
           <a data-nav-link data-route="admin-roles" href="admin/roles.html">Roles</a>
-          <a data-nav-link data-route="admin-moderation" href="admin/moderation.html">Moderation</a>
-          <a data-nav-link data-route="admin-analytics" href="admin/analytics.html">Analytics</a>
+          <a data-nav-link data-route="configuration-admin" href="/tools/groups/configuration-admin.html">Settings and Admin</a>
+          <a data-nav-link data-route="admin-site-settings" href="admin/site-settings.html">Site Settings</a>
+          <a data-nav-link data-route="admin-themes" href="admin/themes.html">Themes</a>
+          <a data-nav-link data-route="admin-users" href="admin/users.html">Users</a>
         </div>
       </div>
       <div class="nav-item">

docs/dev/reports/admin_menu_configuration_link_validation.md

@@ -0,0 +1,52 @@
+# PR_26152_059 Admin Menu Configuration Link Validation
+
+## Scope
+
+- Changed root shared navigation only:
+  - `GameFoundryStudio/assets/partials/header-nav.html`
+  - `GameFoundryStudio/assets/js/gamefoundry-partials.js`
+- Added Admin submenu item `Settings and Admin`.
+- Routed `configuration-admin` to `/tools/groups/configuration-admin.html` through the shared partial loader.
+- No CSS, Theme V2 CSS, page content, tool runtime behavior, or page migrations were changed.
+
+## Validation
+
+Playwright impacted: Yes. This PR changes rendered root navigation behavior, so a targeted Playwright browser validation was run against `/tools/index.html`.
+
+Lanes executed:
+- root navigation/static - because the shared header partial and route map changed.
+- root navigation/browser - because the partial loader rewrites menu hrefs at runtime.
+
+Lanes skipped:
+- runtime, integration, engine, samples, and recovery/UAT - no tool runtime behavior, engine behavior, sample data, or broader recovery behavior changed.
+
+Samples decision: SKIP because this PR only changes root navigation/menu routing.
+
+Commands:
+- `node --check GameFoundryStudio/assets/js/gamefoundry-partials.js`
+- `git diff --check -- GameFoundryStudio/assets/partials/header-nav.html GameFoundryStudio/assets/js/gamefoundry-partials.js`
+- Inline Node static nav validation for Admin submenu order, expected links, target existence, and no inline script/style/event handlers.
+- Inline Playwright browser validation using a local static server for `/tools/index.html` and Admin submenu link targets.
+- `git diff --name-only -- "*.css"` and `git status --short -- "*.css"`
+
+Results:
+- PASS: `Settings and Admin` appears in the Admin submenu.
+- PASS: Source href is `/tools/groups/configuration-admin.html`.
+- PASS: Runtime rendered href resolves to `/tools/groups/configuration-admin.html` from `/tools/index.html`.
+- PASS: Admin submenu order is alphabetized:
+  `Analytics | Branding | Controls | Design System | Grouping Colors | Moderation | Ratings | Roles | Settings and Admin | Site Settings | Themes | Users`
+- PASS: Existing Admin submenu destinations were preserved.
+- PASS: Existing Admin submenu targets returned HTTP 200:
+  `Analytics=200, Branding=200, Controls=200, Design System=200, Grouping Colors=200, Moderation=200, Ratings=200, Roles=200, Settings and Admin=200, Site Settings=200, Themes=200, Users=200`
+- PASS: `tools/groups/configuration-admin.html` exists and is reachable from the rendered menu.
+- PASS: No CSS files changed.
+- PASS: No unrelated page families changed.
+- PASS: No repo-wide tests were run.
+
+Expected PASS behavior:
+- The root shared Admin menu renders the new `Settings and Admin` link.
+- The link reaches `/tools/groups/configuration-admin.html`.
+- Existing Admin menu links still resolve successfully.
+
+Expected WARN behavior:
+- None for the targeted root navigation lane.