منصوبے کے بارے میں

ڈیسک ٹاپ پینل ایک ڈیسک ٹاپ کنٹرول پینل ہے جو سرکاری RPi ٹچ اسکرین والے راسپبیری پائی کے لیے ڈیزائن کیا گیا ہے۔ یہ مصنف کے SmartBedroomPanel پروجیکٹ کا دوبارہ تشکیل شدہ جانشین ہے اور ڈوکر امیج (mrtux/desktop-panel) کے طور پر تقسیم کیا جاتا ہے۔ سیٹ اپ نوٹس بیک لائٹ کنٹرول کا احاطہ کرتے ہیں: ایک udev رول بیک لائٹ برائٹنس اور bl_power sysfs اندراجات تک غیر روٹ تحریری رسائی فراہم کرتا ہے۔ اگر کوئی معلوم بورڈ کا پتہ نہ چلے تو بیک لائٹ sysfs ماحول کو عارضی ڈائریکٹری میں جعلی بنایا جاتا ہے، جو ترقی کے لیے مفید ہے۔ ڈوکر کے ساتھ چلانے کے لیے بلند رسائی درکار ہے کیونکہ ایپلیکیشن کئی سسٹم وسائل کو چھوتی ہے۔ کنٹینر توقع کرتا ہے کہ ایک کنفیگریشن ڈائریکٹری /app/configuration پر صرف پڑھنے کے لیے ماؤنٹ ہو جس میں desktop-panel-config.json اور issuelist.json شامل ہوں، نیز ایک اختیاری قابل تحریر اسکرین شاٹس ڈائریکٹری /app/screenshots پر۔ مثال کا کمانڈ --privileged، --restart always، ایک TZ ماحول متغیر، اور بائنڈ ماؤنٹس استعمال کرتا ہے؛ کنفیگریشن ماؤنٹ اب بھی ایپ کو JSON فائل تبدیلیوں پر ردعمل ظاہر کرنے دیتا ہے۔ انٹیگریشن بنیادی طور پر پیغام پر مبنی ہے۔ AMQP پر، رسائی اور اسناد amqp.host، amqp.user اور amqp.passwd سے سیٹ کی جاتی ہیں۔ اگر amqp.declare درست ہے تو وسائل پینل کی طرف سے اعلان کیے جاتے ہیں، ورنہ سیٹ اپ بیرونی ہے۔ پینل amqp.command_channel (ڈیفالٹ command.DesktopPanel) پر کمانڈز سنتا ہے۔ کمانڈز JSON آبجیکٹ ہیں جن میں ایک کمانڈ شناخت کنندہ اور ایک آرگیومنٹس آبجیکٹ ہوتا ہے؛ موجودہ نفاذ صرف درخواست پر مبنی ہے اور اس میں کوئی عمومی RPC جوابی طریقہ کار نہیں ہے۔ معلوم کمانڈز میں screenshot (اسکرین شاٹس ڈائریکٹری میں ایک تصویر محفوظ کرتا ہے) اور show page شامل ہیں، جو page آرگیومنٹ میں نامزد صفحے پر سوئچ کرتا ہے اور go_back_if_current کو نیویگیشن اسٹیک پاپ کرنے اور block_input کو کلک جیکنگ روکنے کے لیے سپورٹ کرتا ہے۔ ایک سسلاگ چینل System صفحے پر اہم سسلاگ پیغامات دکھا سکتا ہے۔ پیغامات amqp.syslog_channel میں نامزد قطار سے استعمال کیے جاتے ہیں (کوئی ڈیفالٹ نہیں؛ غیر فعال کرنے کے لیے چھوڑ دیں)۔ انہیں syslog-ng کے AMQP منزل سے آنا چاہیے، تمام معلومات AMQP پیغام پراپرٹی ہیڈرز (DATE، FACILITY، HOST/HOST_FROM، MESSAGE، PRIORITY، PROGRAM) میں اور ایک خالی باڈی کے ساتھ۔ صرف error شدت اور اس سے اوپر معنی خیز ہیں؛ syslog-ng فلٹرز یا RabbitMQ بائنڈنگز کو صرف ان شدتوں کو روٹ کرنا چاہیے۔ README ایک مخصوص پائیدار قطار (مثلاً syslog.DesktopPanel) کی سفارش کرتا ہے جو syslog-ng ٹاپک ایکسچینج سے منسلک ہو، جب قطار بیرونی طور پر منظم ہو تو amqp.declare کو غلط پر سیٹ کریں، اور ایک کنفیگریشن JSON اسنیپٹ دیتا ہے۔ جب System صفحہ فعال نہ ہو تو نیا پیغام آنے پر، System ٹیب بٹن crit/critical/alert/emerg/panic کے لیے سرخ اور error/err کے لیے پیلا روشن ہوتا ہے؛ صفحہ کھلنے پر اطلاع صاف ہو جاتی ہے۔ MQTT پر، اگر mqtt.presence-topic کنفیگر ہو تو موجودگی کی حیثیت خام اسٹیٹس متن کے طور پر شائع کی جاتی ہے۔ پروجیکٹ Streamline Icons Pack سے مفت آئیکنز استعمال کرتا ہے اور MIT کے تحت لائسنس یافتہ ہے (© 2021 Stefan Haun اور معاونین)۔ جامد تجزیے کے لیے ایک CodeQL ورک فلو شامل ہے۔