feat(apps): version on every build, a «what changed» modal, and a clean update

- The build number is the commit count, so every build raises it with no
  file to bump. scripts/app-version.mjs bakes it into each front-end
  (__APP_BUILD__) and writes dist/version.json with that app's notes.
- Notes come from commit messages: only Persian lines that start with
  one of the four app tags are shown, each to its own app
  (docs/RELEASE-NOTES.md).
- Both customer apps and the admin panel poll version.json (every 5
  minutes and on return to the tab, bypassing caches). A newer build opens
  a modal that cannot be dismissed. «به‌روزرسانی» unregisters the service
  worker, empties Cache Storage and reloads; localStorage (sign-in, cart,
  settings) is kept.
- Replaces legacy's version dialog, which compared against a
  package.json version that was never bumped and so never opened, and
  useRefresh, which swapped in a new service worker silently.
- nginx (all three apps and nginx-spa.conf): index.html, sw.js and
  version.json are never cached. sw.js used to fall under the 6-month rule,
  which could pin a browser to an old release.

Checked: served with the real nginx config, a newer version.json opens
the modal with its notes; the same build does not.

اپ: اجرت هر کالا حالا همان است که در فاکتور حساب می‌شود؛ درصد خود شما و تخفیف‌ها هم در آن آمده است.
اپ: علاقه‌مندی‌های شما ذخیره می‌شوند و در هر دستگاهی که وارد شوید دیده می‌شوند.
اپ: از این به بعد هر نسخه‌ی تازه با فهرست تغییراتش اعلام می‌شود.
پنل: بخش تازه‌ی «اجرت»: فرمول اجرت را با یک نمونه امتحان و بعد تأیید کنید.
پنل: شهرها مثل قبل به‌صورت درخت‌اند (کشور، استان، شهر، محله)؛ شهری که درصد ندارد درصد شهر بالاتر را می‌گیرد.
پنل: «تاریخ تولد» به فرم مشتری عمده و تکی برگشت.
پنل: در گزارش تجمیعی سفارش‌ها، دکمه‌ی «دریافت فایل اکسل» اضافه شد.
پنل: رد احراز هویت مشتری حالا دلیل هم می‌گیرد.
پنل: با تأیید یا رد سند مالی، به مشتری پیامک می‌رود؛ در پیامک گروهی، %name با نام مشتری عوض می‌شود.
پنل: از این به بعد هر نسخه‌ی تازه‌ی پنل با فهرست تغییراتش اعلام می‌شود.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

apps/user-app/src/App.vue

@@ -1,6 +1,6 @@
 <!--
   Ported from legacy henza_pwa/src/App.vue — layout switching, RTL shell, and
-  the app-version-check / service-worker update dialog.
+  and the update gate (components/AppUpdateGate.vue).
 
   Not ported (deliberate): Firebase push init and WebOTP autofill. Both were
   already commented out in legacy's own App.vue, so neither ran there either.
@@ -19,25 +19,7 @@
       </router-view>
     </component>
 
-    <DialogVantOneButton :timeOut="-1" v-model:show="versionDialog" :closeOnClickOverlay="true">
-      <template v-slot:img>
-        <!-- Still (first frame) in reduced-motion mode. -->
-        <DotLottieVue
-          class="w-full aspect-square"
-          :autoplay="!appearance.isReducedMotion"
-          :loop="!appearance.isReducedMotion"
-          src="https://lottie.host/cb620e8e-c64a-42e8-a6b5-8844146e5999/nmft7oBO8q.json"
-        />
-      </template>
-
-      <template v-slot:title>
-        <div class="p-8 text-justify">نسخه جدید منتزر منتشر شد!</div>
-      </template>
-
-      <template v-slot:button>
-        <div class="text-center text-[color:var(--c-primary)]" @click="update()">به روز رسانی</div>
-      </template>
-    </DialogVantOneButton>
+    <AppUpdateGate />
 
     <ProductMorph />
     <ToastHost />
@@ -45,22 +27,19 @@
 </template>
 
 <script setup lang="ts">
-import { computed, onMounted, ref } from 'vue'
+import { computed } from 'vue'
 import { useRouter } from 'vue-router'
-import { DotLottieVue } from '@lottiefiles/dotlottie-vue'
 import { useRegisterSW } from 'virtual:pwa-register/vue'
 import MasterLayout from './layout/MasterLayout.vue'
 import FullPageLayout from './layout/FullPageLayout.vue'
-import DialogVantOneButton from './components/DialogVantOneButton.vue'
+import AppUpdateGate from './components/AppUpdateGate.vue'
 import ToastHost from './components/ui/ToastHost.vue'
 import ProductMorph from './components/product/ProductMorph.vue'
-import { useRefresh } from './composables/useRefresh'
-import { useAppearanceStore } from './stores/appearanceStore'
-import pkg from '../package.json'
 
 const router = useRouter()
-const appearance = useAppearanceStore()
-const { updateServiceWorker } = useRegisterSW()
+// Registers the service worker (offline, install). Updates are not applied
+// here: AppUpdateGate shows what changed and applies them on the user's tap.
+useRegisterSW()
 
 const getLayout = computed(() => {
   if (router.currentRoute.value.meta && router.currentRoute.value.meta.layout === 'FullPage') {
@@ -68,30 +47,6 @@ const getLayout = computed(() => {
   }
   return MasterLayout
 })
-
-// Ported from legacy App.vue:52-74 — compare the stored version against the
-// bundled package version and offer a one-tap service-worker update.
-const versionDialog = ref(false)
-
-function checkVersion() {
-  const version = localStorage.getItem('version')
-  if (version) {
-    if (version !== pkg.version) versionDialog.value = true
-  } else {
-    localStorage.setItem('version', pkg.version)
-  }
-}
-
-function update() {
-  localStorage.setItem('version', pkg.version)
-  updateServiceWorker()
-  window.location.reload()
-}
-
-onMounted(() => {
-  useRefresh()
-  checkVersion()
-})
 </script>
 
 <style lang="less">