easy qr scan bot
1.0.0
Scannez facilement les codes QR à l'aide de Telegram !
Ce référentiel contient le code de @easyqrscanbot, une application Telegram Mini pour scanner les codes QR.
Assurez-vous d'avoir mis à jour votre application Telegram, la version minimale requise de l'API Telegram est 6.9 .
@easyqrscanbot sur Telegram et lancez une discussion privée.Scan QR ). 
Le scanner de code QR est pris en charge sur les clients smartphones Telegram (Android et iOS) avec des versions d'API Telegram supérieures à 6.9 . Malheureusement, la numérisation QR n'est pas disponible sur les clients Web Telegram. Cependant, vous pouvez toujours accéder à la mini-application sur le client Web et consulter votre historique d'analyse.
Ce projet sert d'illustration à la création d'une Telegram Mini App à l'aide d'un framework JavaScript moderne comme Vue. Il montre également comment exploiter les dernières fonctionnalités introduites dans la version 6.9 de l'API Telegram, notamment :
Le projet représente une pure application Vue Front-End qui utilise le back-end Telegram Cloud Storage pour stocker les analyses acquises.
Le processus de déploiement est entièrement automatisé à l'aide de GitHub Actions. À chaque poussée vers la branche master , la mini-application est automatiquement créée et déployée sur le site GitHub Pages associé.
Accédez à la mini application ici : Mini App Link.
Pour démarrer le projet, suivez ces étapes :
git clone https://github.com/MBoretto/easy-qr-scan-bot.git
cd easy-qr-scan-bot
npm install
npm run build
Pour exécuter le linting de code, utilisez la commande suivante :
npm run lint
Bon codage !
Avant de commencer, assurez-vous de disposer d'un Telegram Bot. Si vous n'en avez pas encore, vous pouvez en créer un à l'aide de ce guide Telegram.
Si vous souhaitez déployer votre propre mini-application, procédez comme suit :
Clonez ce référentiel.
Activez les pages GitHub pour votre référentiel en accédant à Settings -> Pages -> Sélectionnez GitHub Actions comme source. GitHub déploiera automatiquement la mini-application sur les pages GitHub associées à votre référentiel.
Vous pouvez également choisir de déployer votre mini-application à l'aide de n'importe quel service d'hébergement prenant en charge https:// .
C'est le moyen le plus simple de démarrer la mini-application, car elle ne vous oblige à configurer le menu Telegram Bot qu'une seule fois. Voici les étapes pour lier la mini-application au menu de votre bot :
/mybots .
Maintenant, vous pouvez démarrer votre mini application à partir du menu Telegram Bot.
Cette méthode est utile pendant la phase de développement, vous permettant de spécifier différentes URL pour la mini-application sans reconfigurer le menu Telegram Bot. Cependant, cela nécessite un service de robot Telegram en cours d’exécution. Suivez ces étapes :
pip3 install python-telegram-bot --upgrade
config-example.py dans config.py : mv config-example.py config.py
Modifiez le fichier config.py et insérez votre TOKEN Telegram Bot Token (vous pouvez l'obtenir auprès de @BotFather), les liens URL et URL_TEST .
Exécutez le script web-app-launcher.py :
python3 web-app-launcher.py
/start (pour le lien de production) ou /dev (pour le lien de test) au bot.Maintenant, vous pouvez démarrer et tester votre mini-application en utilisant le lien de test.
Telegram Cloud Storage est une base de données clé-valeur accessible depuis n'importe quel client Telegram. Il vous permet de stocker jusqu'à 1024 clés par utilisateur et par bot, chaque valeur ayant une limite de 4096 caractères. Les données sont associées au compte Telegram de l'utilisateur et sont conservées sur tous les appareils. Après avoir scanné un code QR, la chaîne brute est stockée en utilisant l'horodatage comme clé.
La mini-application charge l'historique complet des analyses au démarrage et le stocke localement. Les analyses ultérieures sont stockées à la fois dans Telegram Cloud Storage et localement.
Les données brutes récupérées sont manipulées pour extraire des informations en fonction du contenu du code QR. Types de contenu de code QR pris en charge :
Dans l'onglet Historique, développez le code QR que vous souhaitez supprimer et appuyez sur le bouton Bin . Cette action supprime le code QR du stockage Telegram Cloud et du stockage local. La Mini App ne stocke aucune autre donnée et aucun cookie n'est utilisé.
Le scanner de code QR se ferme généralement après avoir reconnu un code. Cependant, vous pouvez activer le mode d'analyse continue en accédant à l'onglet Paramètres et en appuyant sur le bouton Continuous Scan . Pour désactiver le mode de numérisation continue, appuyez à nouveau sur le bouton. Vous pouvez quitter le mode continu en appuyant sur la flèche en haut à gauche.
Après avoir scanné avec succès un code QR, l'appareil vibrera pour fournir des commentaires.
Dans la section des paramètres de la mini-application, vous trouverez des outils utiles pour le débogage et le développement :
Sync Cloud Storage : cela synchronise le stockage local de la mini-application avec le stockage cloud Telegram, ce qui équivaut à l'ouverture et à la fermeture de la mini-application.Enrich QR codes : déclenche le calcul des codes QR bruts pour toutes les analyses.Show debug affiche :Le projet utilise Vuetify, une bibliothèque de framework de composants Vue.
Le code est distribué sous la licence MIT
