۱) آپلود فایل: فایل zip را با فایل‌منیجر هاست (یا FTP) در مسیر
/shop.venhub.ir/updates/pycoffee/ بگذارید
— معادل وب:
https://shop.venhub.ir/updates/pycoffee/
(مثلاً
pycoffee-1.0.1.zip).
۲) ثبت نسخه: دکمه‌ی «ثبت نسخه‌ی جدید» — نسخه + مسیر فایل را به‌صورت نسبی بدهید:
updates/pycoffee/pycoffee-1.0.1.zip
(آدرس کامل را سرور خودش می‌سازد). ثبت‌شده = آخرین نسخه برای همه‌ی دستگاه‌ها.
۳) روی دستگاه: برنامه‌ی پایتون → تنظیمات → «بررسی به‌روزرسانی» → «دانلود و اعمال»
→ بسته و دوباره اجرا. (تسک «بررسی به‌روزرسانی» هم هر ۶ ساعت خودش چک می‌کند.)
محتوای zip — دو حالت، هر دو درست:
- کامل: کل پوشه‌ی پروژه (پوشه‌ی
pycoffee/ یا مستقیم app/ در ریشه‌ی zip)
- پچ کوچک: فقط فایل‌های تغییر کرده — با مسیر درست، مثل
app/ui/sankui.py. فایل‌های غایب از zip حذف نمی‌شوند و دست‌نخورده می‌مانند.
چه چیزی replace می‌شود؟ فقط فایل‌های موجود در zip، روی محلی‌ها کپی می‌شوند (اتوماتیک، بعد از بکاپ کامل نسخه‌ی فعلی در
backup-app/).
هرگز دست نمی‌خورد:
app/config.json (توکن‌ها و تنظیمات دستگاه)،
.venv،
__pycache__، پوشه‌ی بکاپ.
SHA-256: اختیاری — اگر وارد شود، دستگاه قبل از اعمال فایل را چک می‌کند (خرابی دانلود لو می‌رود).
برگشت (rollback): آخرین ۳ نسخه در
backup-app/ دستگاه می‌مانند — کپی برگشتن همان پوشه کافی است.