Watch
1
0
Fork
You've already forked arc
0
forked from hesabix/arc
arc/docs/barcode_label_studio/design/print_job_ux.md

4.5 KiB
Raw Permalink Blame History

UX چاپ، اکسل و سریال — فاز C (+ پیوند فاز D)

وضعیت طراحی: ✅
وضعیت پیاده‌سازی: ❌


۱) دیالوگ/صفحه Job چاپ — LabelPrintJobDialog

ورودی‌ها

  • templateId اختیاری (اگر null → resolve default؛ اگر نبود اجبار انتخاب)
  • items: لیست از قبل پرشده از کالاها/instances
  • source: products | instances

مراحل UI (تک‌دیالوگ عریض، نه wizard چندصفحه‌ای خسته‌کننده)

ستون چپ / بالا:

  1. Dropdown طرح‌های published + نشان پیش‌فرض ⭐
  2. دکمه «مدیریت طرح‌ها» → لیست/استودیو
  3. Thumbnail طرح انتخابی

وسط — جدول آیتم‌ها:

☐ تصویرک نام کد مقدار بارکد تعداد
  • ویرایش inline تعداد
  • حذف ردیف
  • «اعمال تعداد به همه»

پایین / راست — Sheet override (جمع‌شو):

  • استفاده از sheet طرح یا override موقت columns/margins/paper

اقدامات:

  • پیش‌نمایش
  • ذخیره PDF
  • اشتراک
  • چاپ سیستم (فاز D — اگر platform support)

حالت‌های خاص

حالت UI
هیچ طرح published نیست Empty state + CTA ساخت از preset / رفتن استودیو
افزونه منقضی Gate قفل + لینک بازار
آیتم بدون بارکد ردیف هشدار؛ قابل حذف یا ادامه اگر طرح binding اجباری ندارد

۲) اتصال به products_page

جایگزین/مکمل آیکون‌های فعلی:

  1. چاپ ساده (هسته) — باقی بماند در منوی ⋮ یا با نگه داشتن
  2. چاپ برچسب حرفه‌ای — اگر افزونه فعال: باز کردن LabelPrintJobDialog

پیشنهاد UX منو:

چاپ برچسب
  ├─ سریع (ساده)           ← هسته
  └─ با طرح سفارشی…        ← افزونه (قفل اگر غیرفعال)

از فرم کالا: دکمه «چاپ برچسب» در actions — همان منطق.

برای unique inventory: ابتدا load instances (مثل امروز) سپس job dialog با source=instances.


۳) چاپ از اکسل

صفحه یا dialog بر پایه ExcelImportDialogShell:

  1. دانلود قالب
  2. انتخاب فایل
  3. انتخاب طرح
  4. Dry-run نتایج:
    • N ردیف OK
    • M خطا (جدول خطا با شماره ردیف)
    • مجموع برچسب‌ها = sum(qty)
  5. تأیید → تولید PDF

ستون‌های قالب: در api_contract.md بخش Excel.

Match کالا: اگر code موجود بود فیلدهای خالی از حسابیکس پر می‌شوند (نام/قیمت) مگر override در اکسل.


۴) چاپ سریالی

فرم:

  • Prefix / Start / End / Pad / Suffix
  • Qty each
  • هدف binding: معمولاً مقدار بارکد یا متن
  • انتخاب طرح
  • پیش‌نمایش ۱۰ مقدار اول به‌صورت chip
  • برآورد تعداد کل برچسب
  • اگر > سقف: مسدود با پیام

۵) هم‌زیستی با هسته

قابلیت هسته افزونه
Code128+QR ثابت ✅ ✅ (از طریق طرح)
ذخیره طرح ❌ ✅
چند طرح / پیش‌فرض ❌ ✅
اکسل تیراژ ❌ ✅
انواع symbology کامل ❌ ✅
تصویر/چینش آزاد ❌ ✅

هیچ regression روی مسیر ساده مجاز نیست.


۶) فاز D — دکمه‌های چاپ (طراحی پیوند)

در LabelPrintJobDialog بعد از PDF:

[ پیش‌نمایش ] [ ذخیره PDF ] [ اشتراک ] [ چاپ... ]

چاپ... روی:

  • Windows / Android IO: Printing.layoutPdf
  • Web: مخفی یا «راهنمای چاپ از PDF»

پروفایل رولی: تب/صفحه جدا «چاپگرهای برچسب» فقط وقتی platform native است.


۷) معیار Done فاز C

  • از انتخاب ۲۰ کالا می‌توان با طرح پیش‌فرض PDF گرفت
  • می‌توان موقع چاپ طرح دوم را انتخاب کرد و preview عوض می‌شود
  • اکسل dry-run و چاپ کار می‌کند
  • سریال ۱..۱۰۰ با pad صحیح در بارکد می‌آید
  • بدون افزونه، چاپ ساده مثل قبل کار می‌کند