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

166 lines
6.3 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# UX استودیوی طراحی برچسب — فاز B
> وضعیت طراحی: ✅
> وضعیت پیاده‌سازی: ❌
> مخاطب: توسعه‌دهنده Flutter UI
---
## ۱) اهداف تجربه
کاربر باید حس کند در یک **نرم‌افزار طراحی لیبل** کار می‌کند، نه در یک فرم تنظیمات:
- همه چیز با موس قابل انجام است.
- کاربر حرفه‌ای تقریباً بدون موس (کیبورد) کار می‌کند.
- آنچه روی بوم می‌بیند با PDF چاپ‌شده در حد اسکیل mm یکی است.
---
## ۲) صفحه و مسیرها
| مسیر | صفحه |
|------|------|
| `barcode-labels` | لیست طرح‌ها |
| `barcode-labels/studio/new` | استودیو طرح جدید (از preset یا خالی) |
| `barcode-labels/studio/:id` | ویرایش طرح |
| `barcode-labels/print` | چاپ پیشرفته (فاز C) |
| `barcode-labels/print/excel` | اکسل (فاز C) |
Gate: `BarcodeLabelPluginGate` دور shell صفحات.
---
## ۳) آناتومی استودیو
### Header
- فیلد نام طرح (inline edit)
- وضعیت chip: Draft / Published / Archived
- دکمه‌ها: ذخیره · پیش‌نمایش PDF · انتشار · تنظیم به‌عنوان پیش‌فرض (اگر published) · منوی ⋮ (duplicate، archive)
- Undo / Redo
- Zoom controls: − · درصد · + · Fit · 100%
### ستون چپ — Toolbox + Layers
**Toolbox (ایجاد):**
Text · Barcode · QR · DataMatrix · Image · Rectangle · Line
کلیک = ابزار فعال؛ drag روی canvas = ایجاد در نقطه رهاسازی با اندازه پیش‌فرض type.
**Layers:**
لیست از z بالا به پایین؛ drag reorder؛ آیکون چشم/قفل؛ کلیک = select.
### مرکز — Canvas
- پس‌زمینه خاکستری workspace
- کاغذ لیبل سفید با سایه ملایم، ابعاد mm واقعی
- خط‌کش افقی بالا و عمودی چپ (تیک mm)
- Grid نقطه‌ای یا خطی بر اساس `grid_mm`
- Guides قابل کشیدن از خط‌کش
- Safe margin اختیاری (۰.۵ mm داخل لبه) به‌صورت خط‌چین کم‌رنگ
### ستون راست — Inspector
تب‌ها یا سکشن‌ها:
1. **Position** — X Y W H mm، Rotation (اسپینر + فیلد عددی)
2. **Style** — وابسته به type
3. **Data** — Fixed vs Binding + کاتالوگ binding
4. **Arrange** — Align، Distribute، Bring forward/back، Lock
اگر multi-select: فقط خواص مشترک + Align/Distribute.
### Status bar
`X:12.0 Y:4.0 W:46.0 H:6.0 mm | ∠0° | Snap:ON | Grid:1mm | Sel:1 | Zoom:100%`
---
## ۴) حالت‌های ابزار
| ابزار | نشانگر | رفتار |
|-------|--------|--------|
| Select (V) | arrow | select/move/resize |
| Text (T) | I-beam | کلیک-درگ برای باکس متن |
| Barcode (B) | crosshair | درگ باکس بارکد |
| QR (Q) | crosshair | درگ مربع QR |
| Image (I) | crosshair | درگ باکس سپس picker فایل |
| Shape | crosshair | درگ مستطیل/بیضی |
| Pan (Space hold) | hand | جابه‌جایی viewport |
---
## ۵) Selection و Transform
- Bounding box با ۸ handle + rotate handle بالای مرکز
- هنگام move: راهنمای alignment هوشمند (صورتی/آبی) وقتی لبه‌ها تراز می‌شوند
- Snap threshold: ۲ px صفحه (تبدیل به mm در zoom جاری)
- عناصر `locked` قابل select هستند ولی move/resize نمی‌شوند مگر Unlock
- عناصر `visible=false` در layers خاموش؛ روی canvas نیست یا ghost خیلی کم‌رنگ در حالت «show hidden» (اختیاری MVP: فقط hidden کامل)
---
## ۶) داده نمونه روی بوم
سوییچ بالای canvas: **داده نمونه / کالای واقعی**
- پیش‌فرض: payload نمونه ثابت فارسی
- اختیاری: انتخاب یک کالا از جستجو برای preview زنده bindingها
- بارکد روی canvas به‌صورت WYSIWYG تقریبی (پکیج barcode برای preview ویجت) — PDF نهایی منبع حقیقت اسکن
---
## ۷) پیش‌نمایش PDF
- Drawer یا dialog تمام‌صفحه با همان embed الگوی `label_pdf_preview_embed`
- دکمه‌های ذخیره/اشتراک در preview
- اگر validation قرمز وجود دارد: پیش‌نمایش مجاز با بنر هشدار؛ Publish مسدود
---
## ۸) Unsaved changes
- Fingerprint hash از `design_json + sheet_json + name`
- خروج route / بستن: dialog تأیید
- `Ctrl+S` ذخیره و fingerprint را reset می‌کند
- نشانگر «• ذخیره‌نشده» کنار نام
---
## ۹) Sheet settings (پنل جدا یا dialog)
قابل دسترسی از Header «تنظیمات صفحه چاپ»:
- Paper، orientation، margins، columns، rows، gaps
- پیش‌نمایش شماتیک شبکه لیبل روی کاغذ (نه الزماً WYSIWYG کامل در MVP؛ حداقل اعداد + thumbnail ساده)
این تنظیمات در `sheet_json` ذخیره می‌شوند و موقع چاپ override‌پذیرند.
---
## ۱۰) Empty / First-run
ورود به `studio/new`:
1. Dialog انتخاب preset یا «بوم خالی»
2. اگر خالی: اندازه canvas پیش‌فرض ۵۰×۳۰ mm
3. Tooltip اول‌بار (یک‌بار): «از جعبه ابزار بکشید؛ Ctrl+S ذخیره»
---
## ۱۱) دسترس‌پذیری و RTL
- کل shell RTL مطابق حسابیکس
- مختصات منطقی canvas چپ→راست در فضای لیبل (استاندارد چاپ)؛ UI فارسی حول آن
- همه کنترل‌ها `tooltip` و `Semantics` حداقلی
- کنتراست handles روی لیبل تیره/روشن کافی
---
## ۱۲) معیار Done فاز B (پذیرش UX)
- [ ] کاربر می‌تواند فقط با موس یک طرح کامل بسازد و PDF بگیرد
- [ ] کاربر می‌تواند با کیبورد جابه‌جا، duplicate، undo، save کند
- [ ] Zoom و Fit اندازه mm را در PDF تغییر نمی‌دهد
- [ ] Publish بدون رفع خطای EAN نامعتبر ممکن نیست
- [ ] بازگشت با تغییرات ذخیره‌نشده هشدار می‌دهد