إعدادات

يقرأ برنامج التشغيل config.json من جذر التطبيق:

المجمعة القابلة للتنفيذ: بجوار plato-printer.exe.
التطوير: دليل العمل الحالي.

إذا كان config.json مفقودًا، فسيقوم برنامج التشغيل بإنشاء واحد باستخدام الإعدادات الافتراضية المعقمة.

مثال التكوين

{
  "server": {
    "port": 8080
  },
  "features": {
    "meshEnabled": true,
    "httpsEnabled": true
  },
  "caddy": {
    "enabled": true,
    "domain": "plato-printer.local",
    "httpsPort": 443,
    "version": "2.6.4"
  },
  "redis": {
    "mode": "embedded",
    "version": "6.2.14",
    "host": "127.0.0.1",
    "port": 6379,
    "db": 0,
    "username": "",
    "password": "",
    "diskSync": true,
    "snapshotIntervalSec": 30
  },
  "queue": {
    "retryDelayMs": 5000,
    "maxAttempts": 2147483647
  }
}

الخادم

مجال	تقصير	ملحوظات
`server.port`	`8080`	منفذ HTTP لجميع نقاط النهاية API.

يمكّن تطبيق Express CORS وAccess-Control-Allow-Private-Network: true من السماح لعملاء المتصفح POS بالاتصال بالسائق من الشبكات المحلية/الخاصة.

سمات

مجال	تقصير	ملحوظات
`features.meshEnabled`	`true`	لتمكين إشارات PeerJS على `/mesh`.
`features.httpsEnabled`	`true`	يسمح بإعداد HTTPS عند تمكين Caddy أيضًا.

يبدأ تشغيل HTTPS فقط عندما يكون كل من features.httpsEnabled وcaddy.enabled صحيحين.

العلبة

مجال	تقصير	ملحوظات
`caddy.enabled`	`true`	تمكين مسار الوكيل العكسي Caddy.
`caddy.domain`	`plato-printer.local`	اسم المضيف المستخدم لـ HTTPS.
`caddy.httpsPort`	`443`	منفذ المستمع HTTPS.
`caddy.version`	`2.6.4`	مثبت للتوافق مع نظام التشغيل Windows 7.

في نظام التشغيل Windows 7 أو الإصدارات الأقدم، يرفض برنامج التشغيل تكوينات HTTPS التي تستخدم إصدار Caddy بخلاف 2.6.4.

Redis

مجال	تقصير	ملحوظات
`redis.mode`	`embedded`	يقوم `embedded` بتشغيل Redis من برنامج التشغيل؛ يستخدم `external` خادم Redis موجود.
`redis.version`	`6.2.14`	مطلوب إصدار Redis المضمن.
`redis.host`	`127.0.0.1`	Redis ربط/ربط المضيف.
`redis.port`	`6379`	منفذ Redis.
`redis.db`	`0`	رقم قاعدة البيانات Redis.
`redis.username`	فارغ	يستخدم لمصادقة Redis الخارجية عند التعيين.
`redis.password`	فارغ	يستخدم لمصادقة Redis الخارجية عند التعيين.
`redis.diskSync`	تم إنشاء `false` بشكل افتراضي	يكتب لقطات Redis إلى `dump.rdb` عندما يكون صحيحًا. يقوم تكوين الإنتاج المخصص بتعيين هذا على `true`.
`redis.snapshotIntervalSec`	`30`	يتم استخدام الفاصل الزمني للقطات عند تمكين مزامنة القرص.

يؤدي بدء تشغيل Redis المضمن إلى إحباط برنامج التشغيل بالكامل إذا تعذر بدء تشغيل Redis أو إذا كان إصدار Redis الفعلي لا يتطابق مع redis.version.

طابور

مجال	تقصير	ملحوظات
`queue.retryDelayMs`	`5000`	تم إصلاح التراجع عن إعادة المحاولة لمهام الطباعة الفاشلة.
`queue.maxAttempts`	`2147483647`	الحد الأقصى للمحاولات لكل مهمة. يقوم التكوين الحالي بإعادة المحاولة بشكل فعال إلى الأبد.

التعقيم

يقوم قارئ التكوين بتعقيم القيم:

يجب أن تكون المنافذ والإعدادات الرقمية أعدادًا صحيحة موجبة.
يمكن أن تكون القيم المنطقية منطقية أو سلاسل "true" / "false".
يجب أن يكون redis.mode embedded أو external.
تعود السلاسل الفارغة إلى الإعدادات الافتراضية للحقول المشابهة للمجال/الإصدار/المضيف.

​إعدادات

​مثال التكوين

​الخادم

​سمات

​العلبة

​Redis

​طابور

​التعقيم