54 lines
2.2 KiB
Markdown
54 lines
2.2 KiB
Markdown
|
# QR-Tabellen
|
|||
|
|
|
|||
|
|
Kleines selbst gehostetes Web-Tool für den Schuleinsatz: CSV-Tabellen
|
|||
|
|
(Stationenlernen, Materiallisten, Linksammlungen) werden hochgeladen und als
|
|||
|
|
statische HTML-Seite veröffentlicht — Link-Spalten bekommen automatisch
|
|||
|
|
QR-Codes. Läuft auf **https://table.lehrstun.de** (Admin unter `/admin/`,
|
|||
|
|
Basic Auth).
|
|||
|
|
|
|||
|
|
Die Dateneingabe bleibt bewusst in Excel/LibreOffice; ausgetauscht wird nur
|
|||
|
|
CSV. QR-Codes werden lokal per [segno](https://pypi.org/project/segno/)
|
|||
|
|
erzeugt — kein externer API-Aufruf (DSGVO/Schulkontext).
|
|||
|
|
|
|||
|
|
## Workflow
|
|||
|
|
|
|||
|
|
1. **Tabelle anlegen** (`/admin/neu`): Spalten benennen und Typ wählen
|
|||
|
|
(`text`, `text_long`, `number`, `date`, `url`, `rating_5`).
|
|||
|
|
2. **CSV-Vorlage herunterladen** — Semikolon + UTF-8-BOM, öffnet in
|
|||
|
|
deutschem Excel/LibreOffice direkt korrekt.
|
|||
|
|
3. **Befüllen** in Excel/LibreOffice, als CSV speichern.
|
|||
|
|
4. **In die Dropzone ziehen** — die Zieltabelle wird am Dateinamen erkannt,
|
|||
|
|
sonst an der Spalten-Signatur, sonst manuell wählbar. Validierungsfehler
|
|||
|
|
(kaputte URLs, Bewertung außerhalb 1–5) werden mit Zeile/Spalte gemeldet;
|
|||
|
|
fehlerhafte CSVs werden komplett abgelehnt.
|
|||
|
|
5. **Fertig:** Seite liegt unter `https://table.lehrstun.de/<slug>/`,
|
|||
|
|
jede Link-Zelle mit QR-Code. Die Linkliste im Admin zeigt alle Tabellen
|
|||
|
|
mit QR-Code und allen CSV-Versionen zum Download.
|
|||
|
|
|
|||
|
|
## Technik
|
|||
|
|
|
|||
|
|
- Python 3.12+ · Flask · segno · gunicorn (nur Produktion) — sonst Stdlib
|
|||
|
|
- Öffentliche Seiten: beim Upload fertig gerendertes, in sich geschlossenes
|
|||
|
|
HTML (QR als Inline-SVG), von Nginx statisch ausgeliefert — bleiben auch
|
|||
|
|
bei gestoppter App online
|
|||
|
|
- Admin-Panel: Flask hinter Nginx Basic Auth, Ablage im Dateisystem
|
|||
|
|
(`data/tables/<slug>/schema.json` + `versions/*.csv`), keine Datenbank
|
|||
|
|
|
|||
|
|
## Entwicklung
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python -m venv venv
|
|||
|
|
venv/Scripts/pip install -r requirements.txt # Windows
|
|||
|
|
venv/Scripts/python -m flask --app app.main run # Admin: http://localhost:5000/admin/
|
|||
|
|
venv/Scripts/python tests/test_engine.py # Engine-Selbsttest
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Deployment (Hetzner)
|
|||
|
|
|
|||
|
|
Details in `deploy/` (systemd-Unit + Nginx-Vhost) und `CLAUDE.md`. Update:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
ssh herb@46.225.114.15
|
|||
|
|
cd ~/qr-tabellen && git pull && sudo systemctl restart qr-tabellen
|
|||
|
|
```
|