7.1 أماكن تخزين الإعدادات

الملف / المخزن المحتوى
Windows Credential Manager (عبر flutter_secure_storage) الإعدادات الحساسة: مفتاح API، إعدادات الترخيص، المتجر النشط
%APPDATA%\UrBit\settings_mirror.dat (+ .bak) نسخة استرداد مشفرة من الإعدادات (مرتبطة ببصمة الجهاز)
%APPDATA%\UrBit\bootstrap_flags.json قبول شروط الاستخدام، آخر مستخدم، تذكّر المستخدم
%APPDATA%\UrBit\stores\stores_manifest.json سجل المتاجر وأسماؤها
%APPDATA%\UrBit\stores\<store_id>\store_meta.json بيانات المتجر الواحد

لا توجد ملفات إعداد نصية يحرّرها المستخدم يدوياً (مثل .env أو .ini). كل الإعدادات تُدار من واجهة البرنامج.

7.2 أهم الإعدادات ومعانيها وقيمها الافتراضية

الإعداد المعنى القيمة الافتراضية
locale لغة الواجهة ar (العربية)
themeId الثيم (فاتح/داكن) حسب الثيم الافتراضي للبرنامج
use24HourFormat نظام الوقت 12/24 ساعة 12 ساعة
textScale حجم الخط العام 1.0
animationsEnabled تشغيل الحركات مفعّل
sidebarDisplayMode عرض القائمة الجانبية الوضع الافتراضي للبرنامج
invoiceEditorLayout نمط محرر الفواتير كلاسيك برو
printerName / printerUrl الطابعة المستخدمة غير محددة
printCopies عدد نسخ الطباعة 1
printPaperSizeKey مقاس الورق حسب القالب (A4 / حراري 80 مم / 58 مم)
printOrientation اتجاه الصفحة عمودي
micId / speakerId ميكروفون ومكبر الصوت (للالتصال الصوتي PTT) الافتراضي في النظام
autoSearch البحث التلقائي في الشبكة مفعّل
terms_accepted قبول شروط الاستخدام غير مقبول حتى الموافقة
منفذ الخادم (api_port) منفذ خادم API 8080
requireAuth إلزام المصادقة على API true
مفتاح API (api_key) مفتاح وصول للتكاملات يُولَّد تلقائياً (32 خانة) عند أول تشغيل

7.3 إعدادات الشبكة

  • الخادم: من شاشة الشبكة يمكن تشغيل/إيقاف الخادم المدمج، وتغيير المنفذ (1024–65535)، وتوليد مفتاح API جديد.
  • الاتصال السريع: شاشة الشبكة تعرض رمز QR يحتوي {url, apiKey, id, name} لتسهيل ربط العملاء.
  • الربط البعيد (WAN): إعدادات النفق SSH (المضيف، منفذ SSH 22، المنفذ العام 8443، منفذ النفق 18080).

7.4 حساب الأدمن

البند القيمة
الإنشاء أثناء معالج الإعداد الأول (أو بعد استعادة نسخة لا تحتوي مستخدمين)
اسم المستخدم يختاره المستخدم
كلمة المرور إلزامية، 6 أحرف على الأقل
التخزين SHA-256(password + salt) مع Salt عشوائي 32 خانة
بيانات افتراضية لا توجد — لا يوجد أي حساب جاهز مسبقاً
الصلاحيات 160+ صلاحية، و4 أدوار مدمجة (مدير/مشرف/كاشير/مشاهد)

7.5 المتاجر المتعددة

  • تُنشأ المتاجر من شاشة اختيار المتجر قبل الدخول ("إضافة متجر جديد").
  • لكل متجر مجلد مستقل وقواعد بيانات مستقلة داخل %APPDATA%\UrBit\stores\.
  • عند التبديل بين المتاجر يُعاد تشغيل البرنامج — هذا سلوك طبيعي وليس خطأً.
  • لا يمكن حذف المتجر الوحيد المتبقي، وحذف المتجر يتطلب كلمة مرور المدير.