Q-Matrix

Qualifikationsmatrix, Schulungsverwaltung und Unterweisungen für Frappe Framework 16 — mit mehrsprachiger Belegschaft im Blick.

Die App bildet ab, wer was kann, wer welche Schulung braucht und wer welche Unterweisung wann bestätigt hat — inklusive rechtssicherer digitaler Unterschrift und automatischer Wiedervorlage.

Eine ausführliche Beschreibung aller Masken steht in qmatrix_dokumentation.md.

Kompetenzmatrix über alle Beschäftigten, farbcodiert nach Stufe, mit Lückenanalyse je Mitarbeiter.

Übersicht	Dashboard

Das Mitarbeiter-Portal zeigt jedem Beschäftigten die freigegebene Fassung in seiner Sprache — hier ein türkischsprachiger Staplerfahrer, der die Betriebsanweisung als „Forklift Kullanım Kılavuzu" erhält.

DeepL-Übersetzung	Demodaten

Weitere Ansichten: Schulungskalender

Am einfachsten über das fertige Docker-Setup — dort genügt ein Befehl und es muss weder Python noch Node noch bench auf dem Rechner installiert sein.

Klassisch mit bench:

cd $PATH_TO_YOUR_BENCH
bench get-app https://github.com/saschafo/qmatrix --branch main
bench --site <deine-site> install-app qmatrix

Nach der Installation den Scheduler aktivieren — die Wiederholungs-Automatik und die Fristenüberwachung hängen daran:

bench --site <deine-site> enable-scheduler

Zum Ausprobieren gibt es in der App unter Einstellungen → Demodaten eine Schaltfläche, die einen vollständigen Beispielbetrieb anlegt und ihn genauso wieder entfernt. Angelegt werden Abteilungen, Mitarbeiter, Kompetenzen, Schulungsanbieter, Schulungen, ein Jahres-Schulungsplan mit Kosten, Veranstaltungen und Unterweisungen.

Sämtliche Termine gehen vom heutigen Datum aus, der Schulungsplan läuft immer im laufenden Jahr. Damit sind Kosten- und Kalenderauswertungen unabhängig davon gefüllt, wann die App gestartet wird.

Die acht Demo-Mitarbeiter bekommen einen Portalzugang, zwei davon mit anderer Sprache (Türkisch, Polnisch) — damit lässt sich die Mehrsprachigkeit sofort vorführen, ganz ohne DeepL-Zugang. Zugangsdaten und ein Rundgang stehen in DEMO.md.

Beim Entfernen wird ausschließlich gelöscht, was beim Installieren angelegt wurde — protokolliert im DocType Demodaten, einschließlich der Benutzerkonten. Datensätze, die schon vorher existierten, bleiben unangetastet.

Auch per Kommandozeile möglich:

bench --site <deine-site> execute qmatrix.demo.installieren
bench --site <deine-site> execute qmatrix.demo.entfernen

Schulungen und Unterweisungen lassen sich automatisch in die Sprachen der Belegschaft übersetzen. Portal und Kiosk zeigen jedem Beschäftigten dann die Fassung in seiner Sprache — gesteuert über das Feld Bevorzugte Sprache am Mitarbeiter.

Datenschutz zuerst. Beim Übersetzen werden die Inhalte an DeepL übertragen. Der Free-Tarif untersagt laut DeepL-Nutzungsbedingungen die Verarbeitung personenbezogener Daten und DeepL behält sich vor, übermittelte Inhalte dauerhaft zu speichern. Unterweisungen enthalten häufig Namen, Abteilungen oder Personalnummern — sobald das zutrifft, ist der Free-Tarif vertraglich nicht zulässig und es wird der Pro-Tarif mit Auftragsverarbeitungsvertrag (AVV) benötigt. Der Free-Tarif eignet sich zum Ausprobieren mit Inhalten ohne jeden Personenbezug. Quellen: DeepL Nutzungsbedingungen · Datenschutzerklärung. Das ersetzt keine Rechtsberatung.

1. Auf deepl.com/pro-api einen API-Key erstellen — für den Regelbetrieb den Pro-Tarif.
2. Im Menü Q-Matrix → Einstellungen → DeepL Übersetzung den API-Key eintragen und speichern.
3. Auf Verbindung testen klicken. Es muss eine grüne Erfolgsmeldung mit Tarif und verbrauchtem Kontingent erscheinen. Dabei wird auch die aktuelle Sprachliste von DeepL geladen.
4. Den Datenschutzhinweis bestätigen — ohne diesen Haken startet keine Übersetzung.
5. Unter Sprachen der Belegschaft die Sprachen eintragen, die im Betrieb gesprochen werden. Diese sind später vorausgewählt.

Ob Free- oder Pro-Tarif verwendet wird, erkennt die App am Schlüssel selbst (Free-Keys enden auf :fx) und weist bei Free ausdrücklich darauf hin. Der Key wird verschlüsselt gespeichert und nie im Klartext angezeigt.

Die Auswahl kommt direkt von DeepL und wird beim Verbindungstest aufgefrischt. DeepL unterscheidet dabei streng zwischen Quell- und Zielsprache:

Die Auswahlfelder filtern entsprechend, sodass keine ungültige Kombination entstehen kann. Die Sprache eines Mitarbeiters muss eine Zielsprache sein.

In einer Schulung oder Unterweisung auf Aktionen → 🌐 Mit DeepL übersetzen klicken, die Zielsprachen ankreuzen, starten. Der Lauf passiert im Hintergrund; sobald er fertig ist, erscheint eine Meldung und das Formular lädt sich neu.

Übersetzt werden:

Die Ergebnisse landen als Sprachversion am Dokument und stehen zunächst auf Entwurf. Erst wenn eine Sprachversion auf Freigegeben gesetzt wird, zeigen Portal und Kiosk sie den Beschäftigten an — die maschinelle Übersetzung kann also vorher geprüft und korrigiert werden.

Eine erneute Übersetzung derselben Sprache aktualisiert die vorhandene Sprachversion, statt eine zweite anzulegen.

Diese App nutzt pre-commit für Formatierung und Linting:

cd apps/qmatrix
pre-commit install

Eingesetzt werden ruff, eslint, prettier und pyupgrade.

MIT — siehe license.txt.

Sascha Böhm Software & App, Inhaber Sascha Böhm Hohenschwärz 66, 91322 Gräfenberg, Deutschland USt-IdNr. DE337811439

service@industrie-4-0.org · +49 151 155 20 344 https://website.industrie-4-0.org/ · Impressum