add build version tracking with commit SHA, version number, and build timestamp to frontend

.gitea/workflows/deploy.yml

@@ -43,6 +43,8 @@ jobs:
         with:
           context: ./frontend
           push: true
+          build-args: |
+            GITEA_SHA=${{ gitea.sha }}
           tags: |
             gitea.gitea.chedius.ru/${{ gitea.repository_owner }}/delivery-tracker/frontend:latest
             gitea.gitea.chedius.ru/${{ gitea.repository_owner }}/delivery-tracker/frontend:${{ gitea.sha }}

frontend/Dockerfile

@@ -5,6 +5,9 @@ FROM node:20-alpine AS builder
 
 WORKDIR /app
 
+ARG GITEA_SHA
+ARG COMMIT_SHA
+
 # Copy package files
 COPY package.json yarn.lock ./
 RUN yarn install --frozen-lockfile

frontend/src/components/ui/UpdatePrompt.tsx

@@ -4,21 +4,31 @@ import { useRegisterSW } from 'virtual:pwa-register/react';
 // Check for SW updates every hour and on tab focus/visibility change
 const UPDATE_INTERVAL_MS = 60 * 60 * 1000;
 
+const buildLabel = `${__APP_VERSION__}-${__APP_COMMIT__}`;
+
 export function UpdatePrompt() {
   const {
     needRefresh: [needRefresh],
     updateServiceWorker,
   } = useRegisterSW({
     onRegisteredSW(_swUrl, registration) {
+      console.info('[App] version', {
+        version: __APP_VERSION__,
+        commit: __APP_COMMIT__,
+        builtAt: __APP_BUILT_AT__,
+        serviceWorker: registration ? 'registered' : 'unavailable',
+      });
+
       if (!registration) return;
 
       const checkForUpdate = async () => {
         if (registration.installing || !navigator) return;
         if ('connection' in navigator && !navigator.onLine) return;
         try {
+          console.debug('[PWA] checking for update', { version: buildLabel });
           await registration.update();
         } catch {
-          // network error — ignore, will retry
+          console.debug('[PWA] update check failed, will retry later', { version: buildLabel });
         }
       };
 
@@ -34,7 +44,9 @@ export function UpdatePrompt() {
 
   useEffect(() => {
     if (needRefresh) {
-      console.log('[PWA] New version detected, auto-updating...');
+      console.info('[PWA] new version detected, applying automatically', {
+        currentVersion: buildLabel,
+      });
       updateServiceWorker(true);
     }
   }, [needRefresh, updateServiceWorker]);

frontend/src/vite-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="vite/client" />
+
+declare const __APP_VERSION__: string;
+declare const __APP_COMMIT__: string;
+declare const __APP_BUILT_AT__: string;

frontend/vite.config.ts

@@ -3,8 +3,22 @@ import react from '@vitejs/plugin-react'
 import tailwindcss from '@tailwindcss/vite'
 import { VitePWA } from 'vite-plugin-pwa'
 
+const appVersion = process.env.npm_package_version ?? '0.0.0'
+const appCommit = (
+  process.env.GITEA_SHA ??
+  process.env.GITHUB_SHA ??
+  process.env.COMMIT_SHA ??
+  'dev'
+).slice(0, 12)
+const appBuiltAt = new Date().toISOString()
+
 // https://vite.dev/config/
 export default defineConfig({
+  define: {
+    __APP_VERSION__: JSON.stringify(appVersion),
+    __APP_COMMIT__: JSON.stringify(appCommit),
+    __APP_BUILT_AT__: JSON.stringify(appBuiltAt),
+  },
   plugins: [
     react(),
     tailwindcss(),
@@ -35,4 +49,4 @@ export default defineConfig({
       },
     },
   },
-})
+})