184 lines
4.9 KiB
Markdown
184 lines
4.9 KiB
Markdown
# Scanner Service und Frontend Software (Kugelstoßmeeting Rochlitz)
|
|
- Geschrieben von Mario Voigt (2024 - 2025)
|
|
- License: MIT
|
|
|
|
## WARNUNG: UGLY SOFTWARE. Das ist ein "works for me" Projekt
|
|
|
|
## Konzept
|
|
- ein eigenständiger Scan-Service läuft permanent und speichert alle gescannten Barcodes, die von einem Eyoyo Barcode Scanner per USB-Anschluss kommen, in eine SQLite DB ab.
|
|
- der Scan-Service (usb-scanner.py) basiert auf https://github.com/vpatron/barcode_scanner_python/tree/master
|
|
- läuft nur, wenn der Scanner angeschlossen und aktiv ist. Anderfalls gibt es Fehlermeldungen
|
|
- wird als systemd Service installiert
|
|
- ein separat gestartetes Frontend (GUI) greift auf diese Datenbank zu und prüft die Eingaben bzw. reichert sie an
|
|
- Frontend (sqlite.py) basiert auf https://github.com/tonypdavis/Raspberry-Pi-Barcode-Scanner-/blob/master/ipad_bs_v1.2.py
|
|
- ruft die gleiche Datenbank auf und liest/schreibt Änderungen
|
|
|
|
**Achtung: Frontend und Scan-Service müssen auf die gleiche Datenbankdatei konfiguriert werden!**
|
|
|
|
## Installation
|
|
Siehe auch https://pypi.org/project/cysystemd/
|
|
|
|
Fedora:
|
|
```
|
|
dnf install -y systemd-devel python3-venv
|
|
sudo usermod -G dialout -a $USER #den aktuellen User zu dialout hinzufügen
|
|
```
|
|
Ubuntu:
|
|
```
|
|
apt install build-essential libsystemd-dev systemd-dev python3-venv
|
|
sudo usermod -G dialout -a $USER #den aktuellen User zu dialout hinzufügen
|
|
```
|
|
|
|
```
|
|
cd /opt/
|
|
git clone https://gitea.fablabchemnitz.de/vmario/kugelstossmeeting-ticketing.git
|
|
cd kugelstossmeeting-ticketing/
|
|
python3 -m venv venv
|
|
venv/bin/pip install -r requirements.txt
|
|
```
|
|
|
|
## USB Scanner betriebsbereit machen
|
|
|
|
USB-Geräte anzeigen und nach Scanner prüfen:
|
|
```
|
|
lsusb -v
|
|
#idVendor 0x0581 Racal Data Group
|
|
#idProduct 0x0115 Tera 5100
|
|
lsusb
|
|
#Bus 003 Device 003: ID 0581:0115 Racal Data Group Tera 5100
|
|
```
|
|
|
|
USB-Gerät Berechtigungen anpassen:
|
|
```
|
|
vim /etc/udev/rules.d/55-barcode-scanner.rules
|
|
```
|
|
```
|
|
# Set permissions to let anyone use barcode scanner
|
|
SUBSYSTEM=="usb", ATTR{idVendor}=="0581", ATTR{idProduct}=="0115", MODE="666"
|
|
```
|
|
|
|
Änderungen übernehmen:
|
|
```
|
|
udevadm control --reload-rules && udevadm trigger
|
|
```
|
|
|
|
Dienst starten und prüfen:
|
|
```
|
|
ln -sf /etc/systemd/system/usb-scanner.service /opt/kugelstossmeeting-ticketing/usb-scanner.service
|
|
systemctl enable usb-scanner.service --now
|
|
journalctl -f -u usb-scanner.service
|
|
```
|
|
|
|
## Codes scannen
|
|
Folgende Codes scannen wir ein, um den Scanner korrekt zu konfigurieren:
|
|
|
|
|
|
**Der Scanner kann zurückgesetzt werden, indem wir ihn per QR Code ausschalten und vom USB-Port trennen.**
|
|
|
|
## Datenbankoperationen
|
|
|
|
**SQLite installieren:**
|
|
|
|
Fedora:
|
|
```
|
|
sudo dnf install sqlite3
|
|
```
|
|
Ubuntu:
|
|
```
|
|
sudo apt install sqlite3
|
|
```
|
|
|
|
**Datenbank per Shell leeren:**
|
|
|
|
```
|
|
sqlite3 kugelstossmeeting-prod.db "DELETE FROM tickets;"
|
|
sqlite3 kugelstossmeeting-prod.db "DELETE FROM scans;"
|
|
sqlite3 kugelstossmeeting-prod.db "VACUUM;"
|
|
```
|
|
|
|
**Datenbank per DB Browser for SQLite bearbeiten/ansehen:**
|
|
|
|
Fedora:
|
|
```
|
|
sudo dnf install sqlitebrowser
|
|
```
|
|
Ubuntu:
|
|
```
|
|
sudo apt install sqlitebrowser
|
|
```
|
|
|
|
|
|
|
|
|
|
**Datenbankstruktur erzeugen:**
|
|
```
|
|
CREATE TABLE "tickets" (
|
|
"BarcodeContent" TEXT,
|
|
"Nr" INTEGER,
|
|
"VIP" TEXT,
|
|
"Ticketbeschriftung" INTEGER,
|
|
"BarcodeFile" TEXT,
|
|
"Medium" TEXT,
|
|
"Aushändigung" TEXT,
|
|
"Bestellnummer/Verwendungszweck" TEXT,
|
|
"Bezahlt am" TEXT,
|
|
"Hinweise" TEXT,
|
|
"Besteller" TEXT,
|
|
"Typ" TEXT
|
|
);
|
|
```
|
|
```
|
|
CREATE TABLE "scans" (
|
|
"unixtimestamp_created" INTEGER NOT NULL,
|
|
"barcode" TEXT NOT NULL,
|
|
"validated" INTEGER,
|
|
"hint" TEXT,
|
|
"unixtimestamp_checked" INTEGER,
|
|
"skipped" INTEGER
|
|
);
|
|
```
|
|
|
|
**Datenbankstruktur ändern (Spalten):**
|
|
|
|
Die Reihenfolge der Spalten in der Tabelle ist entscheidend, da diese statisch im Quellcode referenziert wird. Anpassungen (Löschen) zum Beispiel wie folgt:
|
|
```
|
|
ALTER TABLE tickets DROP COLUMN 'BarcodeFile';
|
|
ALTER TABLE tickets DROP COLUMN 'Ticketbeschriftung';
|
|
```
|
|
|
|
**Test-Scan mit Pseudo-Barcode und Zeitstempel erzeugen:**
|
|
|
|
```
|
|
INSERT
|
|
INTO scans(unixtimestamp_created,barcode,validated,hint,unixtimestamp_checked,skipped)
|
|
VALUES(CAST(unixepoch('now') AS FLOAT)*1e9,'12345',0,'None',CAST(unixepoch('now') AS FLOAT)*1e9,0)
|
|
;
|
|
```
|
|
|
|
## GUI starten
|
|
```
|
|
/opt/kugelstossmeeting-ticketing/venv/bin/python3 /opt/kugelstossmeeting-ticketing/sqlite.py
|
|
```
|
|
|
|
... oder
|
|
```
|
|
/opt/kugelstossmeeting-ticketing/sqlite.py #siehe python3 Header
|
|
```
|
|
|
|
... oder die .desktop-Verknüpfung benutzen
|
|
|
|
|
|
|
|
## Notwendig für den Betrieb
|
|
- Notebook mit Netzteil
|
|
- USB Scanner mit USB-C Kabel
|
|
- Stempel + Stempelfarbe
|
|
- Alle Tickets als PDF-Backup (falls es nicht klappt)
|
|
- eine aktuell befüllte SQ-Lite Datenbank
|
|
|
|
## Mögliche Verbesserungen der Software
|
|
- SQLite DB gegen netzwerkfähige MySQL/PGSQL tauschen und multimandantenfähig machen (2 Rechner, 2 Barcode Scanner)
|
|
- Programm so beschränken, dass es nicht mehrfach gestartet werden kann (PID Kontrolle o.ä.)
|
|
- siehe Code-Kommentare
|
|
- TK GUI modernisieren
|