QoL: log version at startup, show backend vs frontend mismatch in system status (#10214)

src-ui/src/app/components/common/system-status-dialog/system-status-dialog.component.html

@@ -20,7 +20,18 @@
           <div class="card-body">
             <dl class="card-text">
               <dt i18n>Paperless-ngx Version</dt>
-              <dd>{{status.pngx_version}}</dd>
+              <dd>
+                {{status.pngx_version}}
+                @if (versionMismatch) {
+                    <button class="btn btn-sm d-inline align-items-center btn-dark text-uppercase small" [ngbPopover]="versionPopover" triggers="click mouseenter:mouseleave">
+                      <i-bs name="exclamation-triangle-fill" class="text-danger lh-1"></i-bs>
+                    </button>
+                }
+                <ng-template #versionPopover>
+                  Frontend version: {{frontendVersion}}<br>
+                  Backend version: {{status.pngx_version}}
+                </ng-template>
+              </dd>
               <dt i18n>Install Type</dt>
               <dd>{{status.install_type}}</dd>
               <dt i18n>Server OS</dt>

src-ui/src/app/components/common/system-status-dialog/system-status-dialog.component.spec.ts

@@ -1,3 +1,18 @@
+// Mock production environment for testing
+jest.mock('src/environments/environment', () => ({
+  environment: {
+    production: true,
+    apiBaseUrl: 'http://localhost:8000/api/',
+    apiVersion: '9',
+    appTitle: 'Paperless-ngx',
+    tag: 'prod',
+    version: '2.4.3',
+    webSocketHost: 'localhost:8000',
+    webSocketProtocol: 'ws:',
+    webSocketBaseUrl: '/ws/',
+  },
+}))
+
 import { Clipboard } from '@angular/cdk/clipboard'
 import { provideHttpClient, withInterceptorsFromDi } from '@angular/common/http'
 import { provideHttpClientTesting } from '@angular/common/http/testing'
@@ -142,4 +157,15 @@ describe('SystemStatusDialogComponent', () => {
       `Task ${PaperlessTaskName.IndexOptimize} started`
     )
   })
+
+  it('shoduld handle version mismatch', () => {
+    component.frontendVersion = '2.4.2'
+    component.ngOnInit()
+    expect(component.versionMismatch).toBeTruthy()
+    expect(component.status.pngx_version).toContain('(frontend: 2.4.2)')
+    component.frontendVersion = '2.4.3'
+    component.status.pngx_version = '2.4.3'
+    component.ngOnInit()
+    expect(component.versionMismatch).toBeFalsy()
+  })
 })

src-ui/src/app/components/common/system-status-dialog/system-status-dialog.component.ts

@@ -1,5 +1,5 @@
 import { Clipboard, ClipboardModule } from '@angular/cdk/clipboard'
-import { Component } from '@angular/core'
+import { Component, OnInit } from '@angular/core'
 import {
   NgbActiveModal,
   NgbModalModule,
@@ -18,6 +18,7 @@ import { PermissionsService } from 'src/app/services/permissions.service'
 import { SystemStatusService } from 'src/app/services/system-status.service'
 import { TasksService } from 'src/app/services/tasks.service'
 import { ToastService } from 'src/app/services/toast.service'
+import { environment } from 'src/environments/environment'
 
 @Component({
   selector: 'pngx-system-status-dialog',
@@ -33,10 +34,12 @@ import { ToastService } from 'src/app/services/toast.service'
     NgxBootstrapIconsModule,
   ],
 })
-export class SystemStatusDialogComponent {
+export class SystemStatusDialogComponent implements OnInit {
   public SystemStatusItemStatus = SystemStatusItemStatus
   public PaperlessTaskName = PaperlessTaskName
   public status: SystemStatus
+  public frontendVersion: string = environment.version
+  public versionMismatch: boolean = false
 
   public copied: boolean = false
 
@@ -55,6 +58,17 @@ export class SystemStatusDialogComponent {
     private permissionsService: PermissionsService
   ) {}
 
+  public ngOnInit() {
+    this.versionMismatch =
+      environment.production &&
+      this.status.pngx_version &&
+      this.frontendVersion &&
+      this.status.pngx_version !== this.frontendVersion
+    if (this.versionMismatch) {
+      this.status.pngx_version = `${this.status.pngx_version} (frontend: ${this.frontendVersion})`
+    }
+  }
+
   public close() {
     this.activeModal.close()
   }