DÜSK - Düsseldorfer Schülerinventar (Lazarus/Free Pascal)


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
- Installation
- Starten der Anwendung
- Bedienungsanleitung
- API-Endpunkte
- Projektstruktur
- Kompilierung
- Fehlerbehandlung
- Lizenz

🎯 Ü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, Diagrammen, Statistik und Items |
| 📊 Korrelation | Berechnung der Übereinstimmung zwischen SE und FE |
| 📈 Zeitreihe | Verlaufsdarstellung aller Profile einer Gruppe mit Diagramm |
| 👥 Gruppenverwaltung | Gruppen hinzufügen, löschen und zuordnen |
| 🖥️ Grafische Diagramme | Liniendiagramme für SE, FE und Vergleich (TAChart) |

💻 Technische Voraussetzungen

- Lazarus 2.0.6 oder höher
- Free Pascal Compiler 3.0.4 oder höher
- Internetverbindung (für API-Zugriff auf https://paul-koop.org/api/)
- Betriebssystem: Windows, macOS, Linux

Benötigte Pakete

- TAChartLazarusPkg (für Diagramme) - ist normalerweise bereits enthalten

📦 Installation

1. Repository klonen oder Dateien herunterladen

`bash
git clone https://github.com/yourusername/duesk-lazarus.git
cd duesk-lazarus
`

2. Projekt in Lazarus öffnen

1. Lazarus starten
2. Projekt → Projekt öffnen...
3. project1.lpi auswählen

🚀 Starten der Anwendung

In Lazarus:

- Drücken Sie F9 (Ausführen)

Als eigenständige .exe:

`bash

Windows

project1.exe

Linux

./project1

macOS

open project1.app
`

📖 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

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

Aktionen pro Profil (Buttons unter der Tabelle):
- Anzeigen - Zeigt das komplette Profil mit Diagrammen
- Bearbeiten - Ändert die Item-Werte des Profils
- Löschen - Entfernt das Profil (mit Bestätigung)
- Zeitreihe - Zeigt die Entwicklung der 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

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
- Liniendiagramm der Werte

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

#### 3. Statistik
- Korrelation zwischen SE und FE
- Übereinstimmung in Prozent
- Vergleichsdiagramm (SE vs. FE)
- Interpretation in verständlicher Sprache

#### 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.

Zeitreihe

Zeigt alle Profile einer Gruppe mit:
- Liniendiagramm der ausgewählten Kompetenz
- Tabelle mit allen Kompetenzwerten

Gruppenverwaltung

- Hinzufügen - Neue Gruppe mit Namen erstellen
- Löschen - Vorhandene Gruppe entfernen

🔌 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 |
| api_norms.php | GET | Normtabellen abrufen |

📁 Projektstruktur

`
duesk_lazarus/
├── project1.lpr # Hauptprogramm
├── project1.lpi # Projektinformationen
├── u_login.pas + .lfm # Login-Formular
├── u_profilelist.pas + .lfm # Profilliste
├── u_profiledetail.pas + .lfm # Profildetail mit Diagrammen
├── u_profileedit.pas + .lfm # Profil bearbeiten/neu
├── u_timeseries.pas + .lfm # Zeitreihe
├── u_groups.pas + .lfm # Gruppenverwaltung
├── u_api.pas # API-Kommunikation
├── u_norms.pas # Normwerte und Konstanten
└── u_chart.pas # Diagramm-Komponente
`

🔧 Kompilierung

In Lazarus:

1. Projekt öffnen (project1.lpi)
2. Ausführen → Kompilieren (Strg+F9)
3. Ausführen → Start (F9)

Kommandozeile (fpc):

`bash
fpc project1.lpr
`

Für verschiedene Betriebssysteme:

Windows:
`bash
fpc -Twin64 project1.lpr
`

Linux:
`bash
fpc -Tlinux project1.lpr
`

macOS:
`bash
fpc -Tdarwin project1.lpr
`

⚠️ Fehlerbehandlung

| Fehler | Ursache | Lösung |
|--------|---------|--------|
| Keine Verbindung | Internet offline | Internetverbindung prüfen |
| Login fehlgeschlagen | Falsche Zugangsdaten | Benutzername/Passwort prüfen |
| Keine Profile | API nicht erreichbar | Server-Status prüfen |
| Diagramm nicht sichtbar | TAChart nicht installiert | Paket nachinstallieren |

📄 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

👨‍💻 Autor

Paul Koop M.A.
- Website: https://paul-koop.org

🙏 Danksagung

Die PHP-API und die Datenbankstruktur basieren auf der bestehenden DÜSK-Online-Anwendung.