easy qr scan bot

@easyqrscanbot - ماسح رمز الاستجابة السريعة لـ Telegram - تطبيق صغير

قم بمسح رموز QR بسهولة باستخدام Telegram!

يحتوي هذا المستودع على رمز @easyqrscanbot، وهو تطبيق Telegram Mini لمسح رموز QR.

كيفية استخدام الماسح الضوئي لرمز الاستجابة السريعة

تأكد من تحديث تطبيق Telegram، الحد الأدنى المطلوب لإصدار Telegram API هو 6.9 .

1. ابحث عن @easyqrscanbot على Telegram وابدأ محادثة خاصة.
2. اضغط على زر القائمة في الزاوية اليسرى السفلية ( Scan QR ).

3. ابدأ في مسح رموز QR!

التوافق

يتم دعم الماسح الضوئي لرمز QR على عملاء Telegram للهواتف الذكية (Android وiOS) مع إصدارات Telegram API الأكبر من 6.9 . لسوء الحظ، لا يتوفر مسح QR على عملاء Telegram Web. ومع ذلك، لا يزال بإمكانك الوصول إلى التطبيق المصغر على Web Client ومراجعة سجل الفحص الخاص بك.

حول المشروع

يعد هذا المشروع بمثابة توضيح لإنشاء تطبيق Telegram Mini باستخدام إطار عمل JavaScript حديث مثل Vue. ويوضح أيضًا كيفية الاستفادة من أحدث الميزات المقدمة في Telegram API الإصدار 6.9، بما في ذلك:

• مسح رمز الاستجابة السريعة
• استخدام Telegram Cloud Storage، وهي قاعدة بيانات ذات قيمة أساسية يمكن الوصول إليها من خلال التطبيق المصغر

يمثل المشروع تطبيق Vue Front-End خالصًا يستخدم Telegram Cloud Storage Back-End لتخزين عمليات الفحص المكتسبة.

نشر التطبيق المصغر

تتم عملية النشر بشكل تلقائي بالكامل باستخدام إجراءات GitHub. مع كل دفعة إلى الفرع master ، يتم إنشاء التطبيق الصغير تلقائيًا ونشره على موقع صفحات GitHub المرتبط.

قم بالوصول إلى التطبيق المصغر هنا: رابط التطبيق المصغر.

للمطورين

للبدء بالمشروع، اتبع الخطوات التالية:

1. استنساخ المستودع:

 git clone https://github.com/MBoretto/easy-qr-scan-bot.git
cd easy-qr-scan-bot

2. تثبيت التبعيات:

 npm install

3. بناء المشروع:

 npm run build

لتشغيل عملية فحص التعليمات البرمجية، استخدم الأمر التالي:

 npm run lint

ترميز سعيد!

انشر تطبيقك المصغر

قبل أن تبدأ، تأكد من أن لديك Telegram Bot. إذا لم يكن لديك واحد بعد، فيمكنك إنشاء واحد باستخدام دليل Telegram هذا.

استنساخ ونشر

إذا كنت تريد نشر التطبيق المصغر الخاص بك، فاتبع الخطوات التالية:

1. استنساخ هذا المستودع.

2. قم بتمكين صفحات GitHub لمستودعك من خلال الانتقال إلى Settings -> Pages -> تحديد GitHub Actions كمصدر. سيقوم GitHub تلقائيًا بنشر التطبيق المصغر على صفحات GitHub المرتبطة بمستودعك.

يمكنك أيضًا اختيار نشر تطبيقك المصغر باستخدام أي خدمة استضافة تدعم https:// .

ابدأ تشغيل التطبيق المصغر باستخدام قائمة Telegram Bot

هذه هي أسهل طريقة لبدء التطبيق المصغر، لأنها تتطلب منك تكوين قائمة Telegram Bot مرة واحدة فقط. فيما يلي خطوات ربط التطبيق المصغر بقائمة الروبوت الخاصة بك:

1. افتح @BotFather bot وأرسل الأمر /mybots .
2. حدد الروبوت الذي تريد ربطه بالتطبيق المصغر:

3. اضغط على "إعدادات الروبوت":

4. اضغط على زر القائمة:

5. اضغط على زر "تكوين القائمة":

6. أدخل عنوان URL لتطبيقك المصغر وحدد اسم زر القائمة.

الآن، يمكنك تشغيل تطبيقك المصغر من قائمة Telegram Bot.

ابدأ تشغيل التطبيق المصغر باستخدام أمر Telegram Bot

هذه الطريقة مفيدة أثناء مرحلة التطوير، مما يسمح لك بتحديد عناوين URL مختلفة للتطبيق المصغر دون إعادة تكوين قائمة Telegram Bot. ومع ذلك، فهو يتطلب خدمة Telegram bot قيد التشغيل. اتبع الخطوات التالية:

1. تثبيت مكتبة python-telegram-bot:

 pip3 install python-telegram-bot --upgrade

2. أعد تسمية config-example.py في config.py :

 mv config-example.py config.py

3. قم بتحرير ملف config.py وأدخل رمز Telegram Bot Token TOKEN (يمكنك الحصول عليه من @BotFather)، وروابط URL و URL_TEST .

4. قم بتشغيل البرنامج web-app-launcher.py :

 python3 web-app-launcher.py

5. افتح Telegram Bot الخاص بك وأرسل الأمر /start (لرابط الإنتاج) أو /dev (لرابط الاختبار) إلى الروبوت.
6. اضغط على الزر لفتح نسخة من التطبيق المصغر

الآن، يمكنك بدء واختبار تطبيقك المصغر باستخدام رابط الاختبار.

نموذج البيانات

Telegram Cloud Storage عبارة عن قاعدة بيانات ذات قيمة أساسية يمكن الوصول إليها من أي عميل Telegram. يسمح لك بتخزين ما يصل إلى 1024 مفتاحًا لكل مستخدم لكل روبوت، مع حد أقصى لكل قيمة يبلغ 4096 حرفًا. ترتبط البيانات بحساب Telegram الخاص بالمستخدم وتستمر عبر الأجهزة. بعد مسح رمز الاستجابة السريعة ضوئيًا، يتم تخزين السلسلة الأولية باستخدام الطابع الزمني كمفتاح.

يقوم التطبيق المصغر بتحميل سجل الفحص الكامل عند بدء التشغيل ويخزنه محليًا. يتم تخزين عمليات الفحص اللاحقة في Telegram Cloud Storage ومحليًا.

يتم معالجة البيانات الأولية المستردة لاستخراج المعلومات وفقًا لمحتوى رمز الاستجابة السريعة. أنواع محتوى رمز الاستجابة السريعة المدعومة:

• عنوان URL
• بطاقة فيديو
• واي فاي
• جغرافية
• نص

احذف بياناتك

في علامة تبويب السجل، قم بتوسيع رمز QR الذي ترغب في حذفه واضغط على زر Bin . يؤدي هذا الإجراء إلى إزالة رمز الاستجابة السريعة من كل من Telegram Cloud Storage والتخزين المحلي. لا يقوم التطبيق المصغر بتخزين أي بيانات أخرى، ولا يتم استخدام ملفات تعريف الارتباط.

المسح المستمر

عادةً ما يتم إغلاق الماسح الضوئي لرمز الاستجابة السريعة بعد التعرف على الرمز. ومع ذلك، يمكنك تمكين وضع المسح المستمر من خلال الانتقال إلى علامة تبويب الإعدادات والضغط على زر Continuous Scan . لتعطيل وضع المسح المستمر، اضغط على الزر مرة أخرى. يمكنك الخروج من الوضع المستمر بالضغط على السهم العلوي الأيسر.

ردود الفعل اللمسية

بعد مسح رمز الاستجابة السريعة بنجاح، سيهتز الجهاز لتقديم الملاحظات.

تصحيح الأخطاء واستكشاف الأخطاء وإصلاحها

في قسم إعدادات التطبيق المصغر، ستجد أدوات مفيدة لتصحيح الأخطاء والتطوير:

• زر Sync Cloud Storage : يقوم هذا الزر بمزامنة التخزين المحلي للتطبيق المصغر مع Telegram Cloud Storage، وهو ما يعادل فتح وإغلاق التطبيق المصغر.
• زر Enrich QR codes : يقوم بتشغيل حساب رموز QR الأولية لجميع عمليات المسح.
• تمكين Show debug :
  • قائمة بمفاتيح التخزين السحابي المخزنة مؤقتًا محليًا
  • قائمة القيم الرئيسية للتخزين السحابي المخزن مؤقتًا محليًا
  • قائمة بمعلومات مفاتيح التخزين السحابي المخصبة محليًا

عناصر

يستخدم المشروع Vuetify، وهي مكتبة Vue Components Framework.

رخصة

يتم توزيع الكود بموجب ترخيص MIT