forked from hesabix/arc
4.5 KiB
4.5 KiB
UX چاپ، اکسل و سریال — فاز C (+ پیوند فاز D)
وضعیت طراحی: ✅
وضعیت پیادهسازی: ❌
۱) دیالوگ/صفحه Job چاپ — LabelPrintJobDialog
ورودیها
templateIdاختیاری (اگر null → resolve default؛ اگر نبود اجبار انتخاب)items: لیست از قبل پرشده از کالاها/instancessource: products | instances
مراحل UI (تکدیالوگ عریض، نه wizard چندصفحهای خستهکننده)
ستون چپ / بالا:
- Dropdown طرحهای published + نشان پیشفرض ⭐
- دکمه «مدیریت طرحها» → لیست/استودیو
- Thumbnail طرح انتخابی
وسط — جدول آیتمها:
| ☐ | تصویرک | نام | کد | مقدار بارکد | تعداد |
|---|
- ویرایش inline تعداد
- حذف ردیف
- «اعمال تعداد به همه»
پایین / راست — Sheet override (جمعشو):
- استفاده از sheet طرح یا override موقت columns/margins/paper
اقدامات:
- پیشنمایش
- ذخیره PDF
- اشتراک
- چاپ سیستم (فاز D — اگر platform support)
حالتهای خاص
| حالت | UI |
|---|---|
| هیچ طرح published نیست | Empty state + CTA ساخت از preset / رفتن استودیو |
| افزونه منقضی | Gate قفل + لینک بازار |
| آیتم بدون بارکد | ردیف هشدار؛ قابل حذف یا ادامه اگر طرح binding اجباری ندارد |
۲) اتصال به products_page
جایگزین/مکمل آیکونهای فعلی:
- چاپ ساده (هسته) — باقی بماند در منوی ⋮ یا با نگه داشتن
- چاپ برچسب حرفهای — اگر افزونه فعال: باز کردن
LabelPrintJobDialog
پیشنهاد UX منو:
چاپ برچسب
├─ سریع (ساده) ← هسته
└─ با طرح سفارشی… ← افزونه (قفل اگر غیرفعال)
از فرم کالا: دکمه «چاپ برچسب» در actions — همان منطق.
برای unique inventory: ابتدا load instances (مثل امروز) سپس job dialog با source=instances.
۳) چاپ از اکسل
صفحه یا dialog بر پایه ExcelImportDialogShell:
- دانلود قالب
- انتخاب فایل
- انتخاب طرح
- Dry-run نتایج:
- N ردیف OK
- M خطا (جدول خطا با شماره ردیف)
- مجموع برچسبها = sum(qty)
- تأیید → تولید 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 صحیح در بارکد میآید
- بدون افزونه، چاپ ساده مثل قبل کار میکند