Files

T

s.esmaeiliandClaude Opus 5.5 dbead8a6ba 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>

2026-10-10 12:45:52 +03:30

3.1 KiB

Raw Blame History

نسخه و پیام «چه چیزی تغییر کرد»

هر بار که پنل یا اپ‌ها ساخته می‌شوند، شماره‌ی نسخه خودش بالا می‌رود؛ شماره همان تعداد کامیت‌های شاخه است و فایلی برای دستی بالا بردن ندارد.

بعد از انتشار، هر کسی که برنامه را باز دارد حداکثر تا ۵ دقیقه، یا همان لحظه‌ای که دوباره به برنامه برمی‌گردد، پنجره‌ی «نسخه‌ی تازه آماده است» را می‌بیند:

فهرست تغییراتِ همان بخش نشان داده می‌شود: اپ مشتری تغییرات اپ را می‌بیند و پنل تغییرات پنل را.
پنجره بسته نمی‌شود؛ تنها راه، دکمه‌ی «به‌روزرسانی» است.
با زدن دکمه، حافظه‌ی نهان برنامه پاک و صفحه دوباره بار می‌شود.
ورود کاربر، سبد خرید و تنظیمات پاک نمی‌شوند.

متن تغییرات از کجا می‌آید؟

از پیام کامیت‌ها. متن فنی و انگلیسی هیچ‌وقت به کاربر نشان داده نمی‌شود؛ فقط خط‌هایی که با یکی از این برچسب‌ها شروع شوند:

برچسب	کجا نشان داده می‌شود
`اپ:`	هر دو اپ مشتری
`اپ۱:`	فقط اپ نسخه‌ی ۱
`اپ۲:`	فقط اپ نسخه‌ی ۲
`پنل:`	پنل مدیریت

نمونه‌ی پیام کامیت:

fix(cart): keep the cart when the price refreshes

اپ: سبد خرید با به‌روز شدن قیمت دیگر خالی نمی‌شود.
پنل: در فهرست سفارش‌ها، تاریخ ثبت دقیق نشان داده می‌شود.

چطور بنویسیم

برای کاربر بنویسید، نه برنامه‌نویس: «چه چیزی برای او فرق کرده».
یک خط کوتاه برای هر تغییر.
کامیتی که کاربر چیزی از آن نمی‌بیند (تمیزکاری، تست، تغییر داخلی) برچسب نمی‌خواهد.
اگر در یک انتشار هیچ خطِ برچسب‌داری نباشد، پنجره فقط «بهبودها و رفع اشکال‌ها» را نشان می‌دهد.

از نظر فنی

scripts/app-version.mjs موقع ساخت، شماره و یادداشت‌ها را درمی‌آورد و version.json را کنار برنامه می‌گذارد.
useAppUpdate.ts در هر برنامه آن فایل را بدون حافظه‌ی نهان می‌خواند و با شماره‌ی خودش مقایسه می‌کند.
تنظیم nginx هر سه برنامه: index.html، sw.js و version.json هرگز در مرورگر نگه داشته نمی‌شوند. پیش‌تر sw.js شش ماه نگه داشته می‌شد و می‌توانست مرورگر را روی نسخه‌ی قدیمی نگه دارد.

3.1 KiB Raw Blame History Unescape Escape

نسخه و پیام «چه چیزی تغییر کرد»

متن تغییرات از کجا می‌آید؟

چطور بنویسیم

از نظر فنی

3.1 KiB

Raw Blame History