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-v2/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,15 +19,7 @@
       </router-view>
     </component>
 
-    <IslandSheet
-      v-model:show="versionDialog"
-      art="update"
-      title="نسخه جدید منتزر منتشر شد!"
-      description="برای استفاده از آخرین امکانات و بهبودها، برنامه را به روز رسانی کنید."
-      confirm-text="به روز رسانی"
-      cancel-text="بعداً"
-      @confirm="update()"
-    />
+    <AppUpdateGate />
 
     <ProductMorph />
     <ToastHost />
@@ -35,19 +27,19 @@
 </template>
 
 <script setup lang="ts">
-import { computed, onMounted, ref } from 'vue'
+import { computed } from 'vue'
 import { useRouter } from 'vue-router'
 import { useRegisterSW } from 'virtual:pwa-register/vue'
 import MasterLayout from './layout/MasterLayout.vue'
 import FullPageLayout from './layout/FullPageLayout.vue'
-import IslandSheet from './components/ui/IslandSheet.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 pkg from '../package.json'
 
 const router = useRouter()
-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') {
@@ -55,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">