DÜSK - Düsseldorfer Schülerinventar (Desktop-Version)

Eine Desktop-Anwendung für das Düsseldorfer Schülerinventar (DÜSK) - ein Instrument zur Erfassung von Schülerkompetenzen durch Selbst- und Fremdeinschätzung.

📋 Inhaltsverzeichnis

- Über das Projekt
- Features
- Technische Voraussetzungen
- Starten der Anwendung
- Bedienungsanleitung
- API-Endpunkte
- Datenbankstruktur
- Normtabellen
- Fehlerbehandlung

🎯 Über das Projekt

Das Düsseldorfer Schülerinventar (DÜSK) ist ein diagnostisches Instrument zur Erfassung von Schülerkompetenzen in sechs Bereichen:

1. Arbeitsverhalten - Zuverlässigkeit, Arbeitstempo, Arbeitsplanung, Organisation
2. Lernverhalten - Selbstständigkeit, Belastbarkeit, Konzentration
3. Sozialverhalten - Teamfähigkeit, Hilfsbereitschaft, Kommunikation
4. Fachkompetenz - Schreiben, Lesen, Mathematik, Naturwissenschaften
5. Personale Kompetenz - Eigeninitiative, Leistungsbereitschaft, Reflexion
6. Methodenkompetenz - Problemlösung, Abstraktion, Präsentation

Die Anwendung ermöglicht die Erfassung von Selbsteinschätzung (SE) und Fremdeinschätzung (FE) über 36 Items und berechnet daraus Profilwerte im Vergleich zu Normtabellen (Hauptschule/Förderschule).

✨ Features

| Funktion | Beschreibung |
|----------|--------------|
| 🔐 Login | Authentifizierung mit Benutzername/Passwort (Gastzugang: gast/gast) |
| 📋 Profilübersicht | Tabellarische Liste aller Profile mit Name, Gruppe und ID |
| ➕ Neues Profil | Vollständige Erfassung aller 36 Items für SE und FE |
| ✏️ Profil bearbeiten | Nachträgliche Änderung vorhandener Profile |
| 👁️ Profil anzeigen | Detaillierte Ansicht mit SE/FE-Tabellen, Statistik und Items |
| 📊 Korrelation | Berechnung der Übereinstimmung zwischen SE und FE |
| 📈 Zeitreihe | Verlaufsdarstellung aller Profile einer Gruppe |
| 👥 Gruppenverwaltung | Gruppen hinzufügen, löschen und zuordnen |
| 🖥️ Reine Textdarstellung | Keine Grafiken, nur klare Tabellen und Texte |

💻 Technische Voraussetzungen

- Python 3.8 oder höher
- Internetverbindung (für API-Zugriff auf https://paul-koop.org/api/)
- Betriebssystem: Windows, macOS, Linux

Benötigte Python-Pakete (werden automatisch installiert)

`
requests >= 2.25.0
`

Die GUI verwendet tkinter - dies ist in der Standard-Python-Installation enthalten.

Die Anwendung öffnet sich mit einem Login-Fenster.

📖 Bedienungsanleitung

Login

| Feld | Standardwert | Beschreibung |
|------|--------------|--------------|
| Benutzername | gast | Ihr persönlicher Benutzername |
| Passwort | gast | Ihr persönliches Passwort |

> Hinweis: Bei der ersten Anmeldung mit neuen Zugangsdaten wird automatisch ein Benutzerkonto erstellt.

Hauptfenster

Nach erfolgreichem Login sehen Sie eine Tabelle mit allen Ihren Profilen.

Toolbar-Buttons:
- Neues Profil - Erstellt ein neues Profil
- Aktualisieren - Lädt die Profilliste neu
- Gruppen verwalten - Öffnet den Gruppenmanager
- Abmelden - Beendet die Sitzung

Aktionen pro Profil (Buttons unter der Tabelle):
- Anzeigen - Zeigt das komplette Profil mit allen Details
- Bearbeiten - Ändert die Item-Werte des Profils
- Löschen - Entfernt das Profil (mit Bestätigung)
- Zeitreihe - Zeigt alle Profile der gleichen Gruppe

Neues Profil / Profil bearbeiten

1. Profil-Informationen
- Name des Schülers/der Schülerin
- Auswahl einer vorhandenen Gruppe oder Erstellung einer neuen Gruppe

2. Selbsteinschätzung (36 Items)
- Bewertungsskala: 4 = trifft voll zu, 3 = trifft zu, 2 = trifft teilweise zu, 1 = trifft nicht zu
- Standardwert ist 2 (trifft teilweise zu)

3. Fremdeinschätzung (36 Items)
- Gleiche Bewertungsskala wie bei Selbsteinschätzung

Profil anzeigen

Die Profilansicht ist in vier Reiter unterteilt:

#### 1. Selbsteinschätzung (SE)
- Tabelle mit X-Markierungen für die 6 Kompetenzen (Werte 1-5)
- Textuelle Zusammenfassung der Werte

#### 2. Fremdeinschätzung (FE)
- Gleiche Darstellung wie bei SE

#### 3. Statistik
- Korrelation - Statistischer Zusammenhang zwischen SE und FE (Werte zwischen -1 und 1)
- Übereinstimmung - Prozentuale Übereinstimmung der 36 Items
- Interpretation - Verständliche Erklärung der Ergebnisse
- Auswertung - Detaillierte Bewertung jeder Kompetenz

#### 4. Alle Items
- Vollständige Liste aller 36 Items mit SE- und FE-Werten

Normauswahl: Oben rechts können Sie zwischen Hauptschule (HS) und Förderschule (FS) wechseln - die Profilwerte werden neu berechnet.

Zeitreihe

Zeigt alle Profile einer Gruppe mit ihren Kompetenzwerten:
- Profil-ID
- Name
- Werte für alle 6 Kompetenzen (1-5)

Ideal zur Verlaufsbeobachtung einer Person über mehrere Messzeitpunkte.

Gruppenverwaltung

- Hinzufügen - Neue Gruppe mit Namen erstellen
- Löschen - Vorhandene Gruppe entfernen (nur möglich, wenn keine Profile mehr enthalten sind)

🔌 API-Endpunkte

Die Anwendung kommuniziert mit folgenden API-Endpunkten:

| Endpunkt | Methode | Beschreibung |
|----------|---------|--------------|
| api_login.php | POST | Authentifizierung und Session-Erstellung |
| api_profiles.php | GET | Liste aller Profile oder Einzelprofil |
| api_profiles.php | POST | Neues Profil erstellen |
| api_profiles.php | PUT | Profil aktualisieren |
| api_profiles.php | DELETE | Profil löschen |
| api_groups.php | GET | Gruppenliste abrufen |
| api_groups.php | POST | Neue Gruppe erstellen |
| api_groups.php | DELETE | Gruppe löschen |
| api_logout.php | POST | Session beenden |

🗄️ Datenbankstruktur

Die Anwendung nutzt folgende MySQL-Tabellen:

user

| Feld | Typ | Beschreibung |
|------|-----|--------------|
| ID | INT | Primärschlüssel |
| user | VARCHAR(50) | Benutzername |
| pass | VARCHAR(50) | Passwort |

anmeldung

| Feld | Typ | Beschreibung |
|------|-----|--------------|
| sessionID | INT | Primärschlüssel |
| userID | INT | Fremdschlüssel zu user.ID |
| session | VARCHAR(50) | Session-Token |

gruppe

| Feld | Typ | Beschreibung |
|------|-----|--------------|
| gruppeID | INT | Primärschlüssel |
| userID | INT | Fremdschlüssel zu user.ID |
| name | VARCHAR(50) | Gruppenname |

profil

| Feld | Typ | Beschreibung |
|------|-----|--------------|
| profilID | INT | Primärschlüssel |
| userID | INT | Fremdschlüssel zu user.ID |
| gruppeID | INT | Fremdschlüssel zu gruppe.gruppeID |
| name | VARCHAR(50) | Profilname |
| item1..item36 | INT | Selbsteinschätzung (1-4) |
| feitem1..feitem36 | INT | Fremdeinschätzung (1-4) |
| kompetenz1..kompetenz6 | INT | Berechnete Kompetenzwerte (1-5) |

Normtabellen

- normSEhs, normFEhs - Hauptschule-Normen
- normSEfs, normFEfs - Förderschule-Normen

📊 Normtabellen

Hauptschule (HS)

| Kompetenz | p1 | p2 | p3 | p4 | p5 |
|-----------|----|----|----|----|----|
| Arbeitsverhalten | 21.33 | 25.33 | 29.33 | 33.32 | 37.32 |
| Lernverhalten | 20.87 | 24.95 | 29.03 | 33.13 | 37.18 |
| Sozialverhalten | 17.93 | 21.37 | 24.80 | 28.23 | 31.67 |
| Fachkompetenz | 13.98 | 17.71 | 21.44 | 25.17 | 28.90 |
| Personale Kompetenz | 24.60 | 28.55 | 33.04 | 37.53 | 42.01 |
| Methodenkompetenz | 15.53 | 18.97 | 22.40 | 25.83 | 29.27 |

Förderschule (FS)

| Kompetenz | p1 | p2 | p3 | p4 | p5 |
|-----------|----|----|----|----|----|
| Arbeitsverhalten | 17.54 | 24.03 | 30.53 | 37.02 | 43.51 |
| Lernverhalten | 17.80 | 24.26 | 30.73 | 37.19 | 43.65 |
| Sozialverhalten | 18.03 | 22.41 | 26.79 | 31.17 | 35.55 |
| Fachkompetenz | 14.28 | 15.55 | 16.83 | 18.10 | 19.37 |
| Personale Kompetenz | 20.69 | 27.49 | 34.29 | 41.09 | 47.89 |
| Methodenkompetenz | 12.44 | 18.06 | 23.68 | 29.29 | 34.91 |

⚠️ Fehlerbehandlung

Die Anwendung behandelt folgende Fehlersituationen:

| Fehler | Anzeige | Lösung |
|--------|---------|--------|
| Keine Internetverbindung | "Verbindungsfehler" | Internetverbindung prüfen |
| Falsche Login-Daten | "Anmeldung fehlgeschlagen" | Benutzername/Passwort prüfen |
| API nicht erreichbar | "HTTP Fehler" | Server-Status prüfen |
| Kein Profil ausgewählt | "Bitte wählen Sie ein Profil aus" | Profil in Tabelle markieren |