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/features/admin/routes.ts

@@ -14,6 +14,7 @@ const AdminBackupView = () => import('./views/settings/AdminBackupView.vue')
 const AdminFileDiskView = () => import('./views/settings/AdminFileDiskView.vue')
 const AdminFontView = () => import('./views/settings/AdminFontView.vue')
 const AdminUpdateAppView = () => import('./views/settings/AdminUpdateAppView.vue')
+const AdminAppearanceView = () => import('./views/settings/AdminAppearanceView.vue')
 
 export const adminRoutes: RouteRecordRaw[] = [
   {
@@ -126,6 +127,14 @@ export const adminRoutes: RouteRecordRaw[] = [
             },
             component: AdminUpdateAppView,
           },
+          {
+            path: 'appearance',
+            name: 'admin.settings.appearance',
+            meta: {
+              isSuperAdmin: true,
+            },
+            component: AdminAppearanceView,
+          },
         ],
       },
     ],

resources/scripts/features/admin/views/AdminSettingsView.vue

@@ -98,6 +98,11 @@ const menuItems = computed<SettingsMenuItem[]>(() => [
     link: '/admin/administration/settings/update-app',
     icon: 'ArrowPathIcon',
   },
+  {
+    title: t('settings.menu_title.appearance'),
+    link: '/admin/administration/settings/appearance',
+    icon: 'PaintBrushIcon',
+  },
 ])
 
 watchEffect(() => {

resources/scripts/features/admin/views/settings/AdminAppearanceView.vue

@@ -0,0 +1,37 @@
+<script setup lang="ts">
+import { computed } from 'vue'
+import { useI18n } from 'vue-i18n'
+import { useGlobalStore } from '@/scripts/stores/global.store'
+
+const { t } = useI18n()
+const globalStore = useGlobalStore()
+
+const showSidebarGroupLabels = computed<boolean>({
+  get: () => globalStore.globalSettings?.show_sidebar_group_labels === 'YES',
+  set: async (enabled) => {
+    await globalStore.updateGlobalSettings({
+      data: {
+        settings: {
+          show_sidebar_group_labels: enabled ? 'YES' : 'NO',
+        },
+      },
+      message: t('general.setting_updated'),
+    })
+  },
+})
+</script>
+
+<template>
+  <BaseSettingCard
+    :title="$t('settings.appearance.title')"
+    :description="$t('settings.appearance.description')"
+  >
+    <div class="mt-14">
+      <BaseSwitchSection
+        v-model="showSidebarGroupLabels"
+        :title="$t('settings.appearance.sidebar_group_labels')"
+        :description="$t('settings.appearance.sidebar_group_labels_desc')"
+      />
+    </div>
+  </BaseSettingCard>
+</template>