186 lines
6.0 KiB
Markdown
186 lines
6.0 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:**
|
|
|
|
**Wichtig:** Die Reihenfolge der Spalten in den Tabellen darf nicht verändert werden, da die GUI TreeViews fest zugewiesen sind!
|
|
|
|
```
|
|
CREATE TABLE "tickets" (
|
|
"BarcodeContent" TEXT, /* Barcode (5-stellig) {str} */
|
|
"Nr" INTEGER, /* Ticket Nummer {int} */
|
|
"VIP" TEXT, /* VIP Status {y/n} - VIPs bekommen kostenfreie Verköstigung und Parkplatz */
|
|
"Medium" TEXT, /* {Kartonage; Online-Ticket (PDF) */
|
|
"Aushändigung" TEXT, /* {Barverkauf/Tageskasse; Persönliche Aushänding; Email} */
|
|
"Bestellnummer/Verwendungszweck" TEXT, /* Bestellnummer Online (6-stellig) {str} */
|
|
"Bezahlt am" TEXT, /* {TT.MM.JJJJ} */
|
|
"Hinweise" TEXT, /* {str} - etwaige Bemerkungen */
|
|
"Besteller" TEXT, /* {str} - Vor- und Zuname des Käufers */
|
|
"Typ" TEXT /* {E = Erwachsen; K = Kind; 0 = kostenfrei} */
|
|
);
|
|
```
|
|
|
|
```
|
|
CREATE TABLE "scans" (
|
|
"unixtimestamp_created"INTEGER NOT NULL, /* Zeitstempel, wann der Barcode gescannt wurde */
|
|
"barcode" TEXT NOT NULL, /* Der 5-stellige Barcode */
|
|
"validated" INTEGER, /* {0;1} - Barcode entwertet? */
|
|
"hint" TEXT, /* Der beim Scannen optional eingetragene Kommentar */
|
|
"unixtimestamp_checked" INTEGER, /* Zeitstempel, wann der Barcode entwertet wurde */
|
|
"skipped" INTEGER /* {0;1} - Barcode übersprungen? */
|
|
);
|
|
```
|
|
|
|
**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
|