SemioDigital / qrman

Dashboard with QRcode generator from URL and logo, colors in campaign, dynamic QRcode, traking and hitmap. Fork of https://github.com/devdreamsolution/laravel7-qrcode-campaign

✨QRMan✨

Dynamic QR code, logo QR code generate, tracking QR code scan, hitmap dashboard and admin panel using Laravel 9 framework, Vuexy template, endroid/qr-code library and python.

This is based from a fork of https://github.com/devdreamsolution/laravel7-qrcode-campaign. We re trying to fix some problems with the webapp, add docker and fix the documentation since it can be a really useful tool internally and for the community. The tool has been already updated and improved substantially including:

• More recent versions of Laravel and PHP
• Docker support
• Fixed Logo QR Generation
• Possibility to change theme
• Possibility to change registration button
• Fixed some gui problems

Screenshots

Installation

Docker

We suggest to use docker for an easy deployment, make sure to copy the example env files and then edit them accordingly to your needs:

cp .env.docker.example .env
nano .env

cp .env.laravel.example .env.laravel
nano .env.laravel

Notes regarding env files

• When you run the project the first time you should set variable FIRST_TIME to TRUE. It will be then automatically set to false.
• The variable APP_ENV should be set to production when you want to enforce HTTPS. Otherwise, leave local when testing without https.
• The variable APP_DEBUG should be set to FALSE unless you are actually debugging
• The variable APP_REGISTRATION can be set to to enable or disable the possibility to register new users from the login page.

Then run with docker-compose:

docker compose up -d

We suggest to move docker-compose and the env files in a separate location/repo for production.

If you are using a proxy remove the ports directive and point to port 8000.

Manual

If you want to run manually ignore .env.docker.example and copy/edit .env.laravel.example:

cp .env.laravel.example .env
nano .env

Composer install

sudo composer self-update --2
composer install
composer require predis/predis

Laravel key generate

Only when you start the project the first time, run

php artisan key:generate

Node module install

npm i

Mix build

npm run dev

Database migrate and seed

Only when you start the project the first time, run

php artisan migrate --seed

Run server

php artisan storage:link
php artisan serve --host=0.0.0.0