Praktikumsdatenbank – Anleitung für Lehrkräfte

Diese Anleitung erklärt Start, Nutzung und Datenpflege der lokalen Praktikumsdatenbank. Die Datenverarbeitung läuft lokal im Browser; nur die optionale Adresssuche nutzt OpenStreetMap/Nominatim für Suchvorschläge.

Inhalt

1) Voraussetzungen

• Betriebssystem: Windows 10/11 oder macOS
• Browser: Edge, Chrome oder Firefox (aktuell). Safari auf macOS funktioniert ebenfalls.
• Internet: nicht nötig; alles läuft lokal.

2) Start

Öffnen Sie index.html (Doppelklick). Es erscheinen drei Kacheln:

• 🔎 Datenbank-Suche – Schülerinnen und Schüler-App zur Anzeige/Filterung (Reiter „Suchen“).
• 📝 Praktikum eintragen – Schülerinnen und Schüler-App (Reiter „Eintragen“), erzeugt Export-Datei, die dann durch die Lehrkraft mit der Hauptdatenbank zusammengeführt wird.
• 🧩 Merge-Tool – führt viele Schülerinnen und Schüler-Exporte zu einer Datenbank zusammen.

3) Schülerinnen und Schüler-App: Datenbank anzeigen & filtern

Adresse: app/index.html#suche

1. Klicken Sie auf „Lokale Daten laden“ und wählen Sie die public_db.json.
2. Die Ergebnisse erscheinen als Karten; die Suche filtert live.

Suchfelder

• Berufsbezeichnung – Teiltreffer (Groß/Kleinschreibung egal).
• Berufsfeld – Teiltreffer gegen job_field.
• Ort / PLZ – Teiltreffer gegen Adresse.
• Schulzweig –
  • alle Berufe anzeigen → kein Filter
  • geeignet für alle Schulzweige → zeigt nur Einträge mit school_track="alle"
  • H | R | G → zeigt passende Einträge plus die mit school_track="alle"

Weitere Suchfilter

• Firmenname, Straße & Nr., Gesamt-Empfehlung (positiv/neutral/negativ)
• Ø Mindestnote (1–6) – filtert nach Durchschnitt aus Betreuung, Ausgeübte Tätigkeit, Lernfaktor

Ergebnis-Karten

• zeigen Adresse, Kontakt, Branche, Berufe und Berufsfeld(er)
• ein Button „Alle Rückmeldungen anzeigen“ klappt Details je Praktikum auf:
  • Berufsbezeichnung, Berufsfeld, Zeitraum (DD.MM.YYYY – DD.MM.YYYY)
  • optional Kommentar (Schülerinnen und Schüler-Notiz)
  • die ausgewählten Textbausteine (Bewertungs-Rückmeldungen)

4) Schülerinnen und Schüler-App: Praktikum eintragen (Export erstellen)

Adresse: app/index.html#eintragen

Pflichtfelder

• Firmenname, Straße & Nr., PLZ, Ort
• Telefon oder E-Mail (mindestens eines)
• Berufsbezeichnung, Berufsfeld, Schulzweig
• Praktikumszeitraum (Start & Ende)
• Alle Bewertungen (je Kategorie Note 1–6 wählen)

Nach der Notenwahl erscheinen pro Kategorie passende Textbausteine zum Ankreuzen. Die Berufenet-URL ist optional.

Export-Datei

• Beim Klick auf „Import-Datei (.json) erzeugen“ wird eine Datei erstellt, z. B.:
  praktikum_import_Beispielbetrieb_20250312_07482319.json
• Dateiname ist randomisiert, damit beim Einsammeln nichts überschrieben wird.
• Die Datei enthält company (Betrieb) und practicum (Praktikum) in einer JSON-Struktur.

Nach dem Export durch die Lernenden muss die Datei zur Lehrkraft übertragen werden (USB-Stick, Schul-Cloud, …). Diese kann dann über das Merge-Tool alle Dateien der Lernenden mit der Hauptdatenbank zusammenführen (mergen).

5) Merge-Tool: Schülerinnen und Schüler-Exporte zusammenführen

Adresse: app/merge/index.html

1. (Optional) Vorhandene Gesamtdatenbank laden: master_db.json oder public_db.json.
2. Schülerinnen und Schüler-Exportdateien auswählen – mehrere Dateien sind möglich.
3. Umschalter: „Nur public_db.json speichern“ aktivieren, wenn Sie keine Master-Datei benötigen. Diese dient nur zu Wartungs- und Backup-Zwecken.
4. „Zusammenführen & Speichern“ klicken.

Was passiert beim Merge?

• Das Tool erkennt doppelte Betriebe anhand Name + Straße + PLZ + Ort (ohne Sonderzeichen/Leerzeichen).
• Existiert der Betrieb schon, wird das neue Praktikum dort angehängt; sonst wird der Betrieb neu angelegt.
• Ausgabe:
  • public_db.json – für die Schülerinnen und Schüler-App
  • master_db.json – (optional) interne Gesamtdatenbank für zukünftige Merges. Wichtig wenn mehrere Klassen gleichzeitig mit der gleichen public_db.json arbeiten!

Schülerinnen und Schüler/innen
    └─ Export (JSON)
          └─ Lehrkraft: Merge-Tool
                ├─ master_db.json  (optional, interner Bestand)
                └─ public_db.json  (an Klasse verteilen)
                      └─ Schülerinnen und Schüler-App: „Lokale Daten laden“

6) Datenpflege & Verteilung

• Verteilen: Geben Sie die neue public_db.json an die Klasse (USB/Netzlaufwerk). Achten Sie darauf, dass sie die neuste zusammengeführte public-db-Datei verwenden.
• Nutzen: In der Schülerinnen und Schüler-App auf „Lokale Daten laden“ klicken und die Datei auswählen.
• Berufsfeld/Bezeichnung-Vorschläge: Neue Werte aus Eintragungen werden automatisch in den Vorschlagslisten angeboten.
• Sichern: Laden Sie die Datei an der zentralen Stelle mit einem neuen Namen hoch: public_db_HNR_6-11-25.json. So kann der Tool-Admin die Datenbanken anschließend passgenau zusammenführen.

7) Datenschutz

• Die Anwendung arbeitet ohne Server; es werden keine Daten ins Internet gesendet.
• Export- und Datenbankdateien liegen lokal (USB/Netzlaufwerk).
• Vermeiden Sie persönliche Daten, die für den Zweck nicht notwendig sind.

8) Fehlerhilfe (FAQ)

„Es werden keine Ergebnisse angezeigt.“

• Wurde in der Suche „Lokale Daten laden“ geklickt und eine public_db.json gewählt?
• Ist die Datei gültig (aus dem Merge-Tool erzeugt)?

„Export lässt sich nicht speichern.“

• Versuchen Sie einen aktuellen Browser (Edge/Chrome/Firefox). Das Merge-Tool hat zusätzlich einen Fallback für ältere Browser.

„Pflichtfelder fehlen“ beim Eintragen

• Rote Markierung zeigt die Stelle; es erscheint eine Liste mit allen fehlenden Punkten.
• Bewertungen: In allen Kategorien eine Note (1–6) wählen.

„Weitere Suchfilter“ klappt nicht auf

• Seite neu laden (ggf. Strg+F5 / Cmd+Shift+R).

macOS: „.command kann nicht geöffnet werden“

• Rechtsklick → Öffnen wählen; oder öffnen Sie index.html direkt aus dem Ordner.

Firmendaten nachträglich ändern oder löschen

1. Im Merge-Tool unter „Bestehende Master-Datenbank laden“ die aktuelle master_db.json oder public_db.json auswählen.
2. Im Bereich „Geladene Datenbank bearbeiten“ nach dem Betrieb suchen und ihn auswählen.
3. Zum Ändern Firmenname, Anschrift, Kontaktperson oder weitere Stammdaten anpassen und „Änderungen übernehmen“ anklicken.
4. Zum vollständigen Entfernen „Betrieb vollständig löschen“ anklicken und die Sicherheitsabfrage bestätigen. Dabei werden auch alle zugeordneten Praktikumsberichte gelöscht.
5. Die bearbeitete Datenbank erneut herunterladen und die bisherige Datei kontrolliert ersetzen.

Beim Bearbeiten bleibt die Firmen-ID erhalten. Das Löschen kann nach der Bestätigung nicht rückgängig gemacht werden; daher sollte die bisherige Datenbank als Sicherung aufbewahrt werden.