feat(menu): priority-sorted menu groups, user-menu items, sidebar appearance toggle

Every main_menu entry moves from numeric group (1/2/3) to string-based group + group_label + priority. Groups now carry their own i18n label and child entries are sorted by an explicit priority field instead of config-array order, so module-contributed menu items can slot into any existing group at any position.

BootstrapController merges module-registered menu items into main_menu (previously they lived in a separate module_menu response key) and introduces a user_menu response key for items modules want to place in the avatar dropdown. The global store follows suit: moduleMenu becomes userMenu, menuGroups is a computed that sorts by priority, and hasActiveModules drops out.

New admin Appearance setting page with a single toggle for whether sidebar group labels render — so instances that prefer a compact sidebar can hide the Documents/Administration/Modules headings without losing the grouping itself. CompanyLayout watches route meta and re-bootstraps when the admin-mode flag flips so the sidebar repaints with the right menu on navigation across the admin boundary.

Test suites updated: module menu merging is asserted against main_menu (name: 'module-{slug}') rather than the old module_menu response; HelloWorldIntegrationTest verifies the schema translation path; CompanyModulesIndexTest covers the display_name attachment.

resources/scripts/layouts/partials/SiteHeader.vue

@@ -144,13 +144,30 @@
             </BaseDropdownItem>
           </router-link>
 
+          <router-link
+            v-for="item in globalStore.userMenu"
+            :key="item.name"
+            :to="item.link"
+          >
+            <BaseDropdownItem>
+              <BaseIcon
+                :name="item.icon"
+                class="w-5 h-5 mr-3 text-subtle group-hover:text-muted"
+                aria-hidden="true"
+              />
+              {{ item.title }}
+            </BaseDropdownItem>
+          </router-link>
+
+          <div class="my-1 border-t border-line-light" />
+
           <BaseDropdownItem @click="logout">
             <BaseIcon
               name="ArrowRightOnRectangleIcon"
-              class="w-5 h-5 mr-3 text-subtle group-hover:text-muted"
+              class="w-5 h-5 mr-3 text-red-400"
               aria-hidden="true"
             />
-            {{ $t('navigation.logout') }}
+            <span class="text-red-600">{{ $t('navigation.logout') }}</span>
           </BaseDropdownItem>
         </BaseDropdown>
       </li>

resources/scripts/layouts/partials/SiteSidebar.vue

@@ -99,34 +99,6 @@
                 {{ $t(item.title) }}
               </router-link>
             </nav>
-
-            <!-- Dynamic Modules section (one entry per active module's registered settings link) -->
-            <nav v-if="globalStore.hasActiveModules" class="mt-5 space-y-1">
-              <div class="px-4 mt-6 mb-2 text-xs font-semibold text-subtle uppercase tracking-wider">
-                {{ $t('modules.sidebar.section_title') }}
-              </div>
-              <router-link
-                v-for="(item, idx) in globalStore.moduleMenu"
-                :key="`module-${idx}`"
-                :to="item.link"
-                :class="[
-                  hasActiveUrl(item.link)
-                    ? 'text-primary-600 bg-primary-50 font-semibold'
-                    : 'text-body hover:bg-hover',
-                  'cursor-pointer mx-3 px-3 py-2.5 flex items-center rounded-lg text-sm not-italic font-medium transition-colors',
-                ]"
-                @click="globalStore.setSidebarVisibility(false)"
-              >
-                <BaseIcon
-                  :name="item.icon"
-                  :class="[
-                    hasActiveUrl(item.link) ? 'text-primary-500' : 'text-subtle',
-                    'mr-3 shrink-0 h-5 w-5',
-                  ]"
-                />
-                {{ $t(item.title) }}
-              </router-link>
-            </nav>
           </div>
         </div>
       </TransitionChild>
@@ -154,16 +126,18 @@
       :key="index"
       class="p-0 m-0 mt-4 list-none"
     >
-      <div
-        v-if="menu[0] && menu[0].group_label && !globalStore.isSidebarCollapsed"
-        class="px-6 mt-6 mb-2 text-xs font-semibold text-subtle uppercase tracking-wider whitespace-nowrap"
-      >
-        {{ $t(menu[0].group_label) }}
-      </div>
-      <div
-        v-else-if="menu[0] && menu[0].group_label && globalStore.isSidebarCollapsed"
-        class="mx-3 my-2 border-t border-line-light"
-      />
+      <template v-if="menu[0] && menu[0].group_label">
+        <div
+          v-if="showGroupLabels && !globalStore.isSidebarCollapsed"
+          class="px-6 mt-6 mb-2 text-xs font-semibold text-subtle uppercase tracking-wider whitespace-nowrap"
+        >
+          {{ $t(menu[0].group_label) }}
+        </div>
+        <div
+          v-else-if="globalStore.isSidebarCollapsed"
+          class="mx-3 my-2 border-t border-line-light"
+        />
+      </template>
       <router-link
         v-for="item in menu"
         :key="item.name"
@@ -196,49 +170,6 @@
       </router-link>
     </div>
 
-    <!-- Dynamic Modules section: one shortcut per active module's registered
-         settings link. Hidden when no modules are active. -->
-    <div
-      v-if="globalStore.hasActiveModules"
-      class="p-0 m-0 mt-4 list-none"
-    >
-      <div
-        v-if="!globalStore.isSidebarCollapsed"
-        class="px-6 mt-6 mb-2 text-xs font-semibold text-subtle uppercase tracking-wider whitespace-nowrap"
-      >
-        {{ $t('modules.sidebar.section_title') }}
-      </div>
-      <div
-        v-else
-        class="mx-3 my-2 border-t border-line-light"
-      />
-      <router-link
-        v-for="(item, idx) in globalStore.moduleMenu"
-        :key="`module-desktop-${idx}`"
-        :to="item.link"
-        v-tooltip="globalStore.isSidebarCollapsed ? { content: $t(item.title), placement: 'right' } : null"
-        :class="[
-          hasActiveUrl(item.link)
-            ? 'text-primary-600 bg-primary-50 font-semibold'
-            : 'text-body hover:bg-hover',
-          globalStore.isSidebarCollapsed
-            ? 'cursor-pointer mx-2 px-0 py-2.5 group flex items-center justify-center rounded-lg text-sm font-medium transition-colors'
-            : 'cursor-pointer mx-3 px-3 py-2.5 group flex items-center rounded-lg text-sm not-italic font-medium transition-colors',
-        ]"
-      >
-        <BaseIcon
-          :name="item.icon"
-          :class="[
-            hasActiveUrl(item.link) ? 'text-primary-500' : 'text-subtle group-hover:text-body',
-            globalStore.isSidebarCollapsed ? 'shrink-0 h-6 w-6' : 'mr-3 shrink-0 h-5 w-5',
-          ]"
-        />
-        <span v-if="!globalStore.isSidebarCollapsed" class="whitespace-nowrap">
-          {{ $t(item.title) }}
-        </span>
-      </router-link>
-    </div>
-
     <!-- Bottom toolbar -->
     <div class="mt-auto sticky bottom-0 border-t border-white/10 bg-surface/80 backdrop-blur-xl p-2 flex flex-col items-center gap-1">
       <button
@@ -267,6 +198,7 @@ import {
   TransitionChild,
   TransitionRoot,
 } from '@headlessui/vue'
+import { computed } from 'vue'
 import { useRoute } from 'vue-router'
 import { useGlobalStore } from '@/scripts/stores/global.store'
 import MainLogo from '@/scripts/components/icons/MainLogo.vue'
@@ -282,7 +214,20 @@ interface MenuItemData {
 const route = useRoute()
 const globalStore = useGlobalStore()
 
+const showGroupLabels = computed<boolean>(() => {
+  return globalStore.globalSettings?.show_sidebar_group_labels === 'YES'
+})
+
+const activeMenuLink = computed<string | null>(() => {
+  const allLinks = globalStore.menuGroups.flat().map((item) => item.link)
+  const matches = allLinks.filter(
+    (url) => route.path === url || route.path.startsWith(url + '/'),
+  )
+  // Return the longest (most specific) match
+  return matches.sort((a, b) => b.length - a.length)[0] ?? null
+})
+
 function hasActiveUrl(url: string): boolean {
-  return route.path.indexOf(url) > -1
+  return url === activeMenuLink.value
 }
 </script>