Add contextual user guide help buttons across mapped pages and dialogs

enferno/admin/templates/admin/jsapi.jinja2

@@ -23,6 +23,21 @@ tfaAuthentication_ : "{{ _('2FA Authentication') }}",
 recoveryCodes_ : "{{ _('Recovery Codes') }}",
 securityKeys_ : "{{ _('Security Keys') }}",
 userGuides_ : "{{ _('User Guides') }}",
+learnAbout_ : (title) => "{{ _('Learn about {title}') }}".replace("{title}", title),
+whatIsBayanat_ : "{{ _('What is Bayanat?') }}",
+activityMonitor_ : "{{ _('Activity Monitor') }}",
+dynamicFields_ : "{{ _('Dynamic Fields') }}",
+locations_ : "{{ _('Locations') }}",
+labels_ : "{{ _('Labels') }}",
+sources_ : "{{ _('Sources') }}",
+events_ : "{{ _('Events') }}",
+permissions_ : "{{ _('Permissions') }}",
+accessControl_ : "{{ _('Access Control') }}",
+mediaManagement_ : "{{ _('Media Management') }}",
+mediaImport_ : "{{ _('Media Import') }}",
+dataImport_ : "{{ _('Data Import') }}",
+videoDeduplication_ : "{{ _('Video Deduplication') }}",
+dataExport_ : "{{ _('Data Export') }}",
 support_ : "{{ _('Support') }}",
 reportABug_ : "{{ _('Report a Bug') }}",
 logout_ : "{{ _('Logout') }}",

enferno/admin/templates/nav-bar.html

@@ -26,6 +26,19 @@
     </v-tooltip>
     {% endif %}
 
+    <v-tooltip v-if="currentHelpUrl" location="bottom">
+      <template v-slot:activator="{ props }">
+        <v-btn
+          v-bind="props"
+          icon="mdi-help-circle-outline"
+          :href="currentHelpUrl"
+          target="_blank"
+          rel="noopener noreferrer"
+        ></v-btn>
+      </template>
+      ${currentHelpLabel}
+    </v-tooltip>
+
     <v-tooltip location="bottom">
       <template v-slot:activator="{ props }">
         <v-btn id="language-menu-activator" v-bind="props" icon="mdi-translate"></v-btn>

enferno/static/js/common/config.js

@@ -460,6 +460,38 @@ const routes = [
 
 ];
 
+const contextualHelpLinks = {
+    dashboard: { titleKey: 'whatIsBayanat_', url: 'https://docs.bayanat.org/guide/what-is-bayanat.html' },
+    activity: { titleKey: 'activityMonitor_', url: 'https://docs.bayanat.org/guide/activity.html' },
+    actors: { titleKey: 'actors_', url: 'https://docs.bayanat.org/guide/actors.html' },
+    actor: { titleKey: 'actors_', url: 'https://docs.bayanat.org/guide/actors.html' },
+    'actor-fields': { titleKey: 'dynamicFields_', url: 'https://docs.bayanat.org/guide/dynamic-fields.html' },
+    bulletins: { titleKey: 'bulletins_', url: 'https://docs.bayanat.org/guide/bulletins.html' },
+    bulletin: { titleKey: 'bulletins_', url: 'https://docs.bayanat.org/guide/bulletins.html' },
+    'bulletin-fields': { titleKey: 'dynamicFields_', url: 'https://docs.bayanat.org/guide/dynamic-fields.html' },
+    incidents: { titleKey: 'incidents_', url: 'https://docs.bayanat.org/guide/incidents.html' },
+    incident: { titleKey: 'incidents_', url: 'https://docs.bayanat.org/guide/incidents.html' },
+    'incident-fields': { titleKey: 'dynamicFields_', url: 'https://docs.bayanat.org/guide/dynamic-fields.html' },
+    locations: { titleKey: 'locations_', url: 'https://docs.bayanat.org/guide/locations.html' },
+    location: { titleKey: 'locations_', url: 'https://docs.bayanat.org/guide/locations.html' },
+    labels: { titleKey: 'labels_', url: 'https://docs.bayanat.org/guide/labels.html' },
+    sources: { titleKey: 'sources_', url: 'https://docs.bayanat.org/guide/sources.html' },
+    eventtypes: { titleKey: 'events_', url: 'https://docs.bayanat.org/guide/events.html' },
+    roles: { titleKey: 'accessControl_', url: 'https://docs.bayanat.org/guide/access-control.html' },
+    users: { titleKey: 'permissions_', url: 'https://docs.bayanat.org/guide/permissions.html' },
+    user: { titleKey: 'permissions_', url: 'https://docs.bayanat.org/guide/permissions.html' },
+    medias: { titleKey: 'mediaManagement_', url: 'https://docs.bayanat.org/guide/media.html' },
+    media: { titleKey: 'mediaManagement_', url: 'https://docs.bayanat.org/guide/media.html' },
+    'account-security': { titleKey: 'accountSecurity_', url: 'https://docs.bayanat.org/guide/account-security.html' },
+    'import-media': { titleKey: 'mediaImport_', url: 'https://docs.bayanat.org/guide/media-import.html' },
+    'import-sheets': { titleKey: 'dataImport_', url: 'https://docs.bayanat.org/guide/data-import.html' },
+    'import-logs': { titleKey: 'dataImport_', url: 'https://docs.bayanat.org/guide/data-import.html' },
+    'import-log': { titleKey: 'dataImport_', url: 'https://docs.bayanat.org/guide/data-import.html' },
+    'deduplication-dashboard': { titleKey: 'videoDeduplication_', url: 'https://docs.bayanat.org/guide/deduplication.html' },
+    exports: { titleKey: 'dataExport_', url: 'https://docs.bayanat.org/guide/data-export.html' },
+    export: { titleKey: 'dataExport_', url: 'https://docs.bayanat.org/guide/data-export.html' },
+};
+
 const router = createRouter({
     history: createWebHistory(),
     routes: routes,

enferno/static/js/mixins/global-mixin.js

@@ -61,6 +61,20 @@ const globalMixin = {
   beforeUnmount() {
     document.removeEventListener('global-axios-error', this.showSnack);
   },
+  computed: {
+    currentHelpLink() {
+      return contextualHelpLinks[this.$route?.name] || null;
+    },
+    currentHelpUrl() {
+      return this.currentHelpLink?.url || null;
+    },
+    currentHelpLabel() {
+      const translations = window.translations || {};
+      if (!this.currentHelpLink?.titleKey) return translations.userGuides_;
+      const title = translations[this.currentHelpLink.titleKey];
+      return translations.learnAbout_(title);
+    },
+  },
   methods: {
     /**
      * Format a date with Day.js supporting timezone, locale, and special formats.