📘 ClassTests-Handbuch

1. Erste Schritte

ClassTests ist eine Plattform für digitale Prüfungen — vom Erstellen einer Aufgabe bis zur freigegebenen Note. Drei Schritte zum Start:

1. Account erstellen auf /registrieren mit E-Mail + Passwort. Eine Bestätigungsmail aktiviert das Konto.
2. Erste Klasse anlegen unter „Klassen → + Neue Klasse" (Schuljahr + Fach optional).
3. Erste Prüfung erstellen unter „Prüfungen → + Neue Prüfung". Aufgaben hinzufügen, Klasse zuweisen, aktivieren — der 6-stellige Beitritts-Code erscheint.

2. Klassen verwalten

Eine Klasse in ClassTests ist eine permanente Gruppe — Sie als Lehrer sind Eigentümer, optional können Sie Co-Lehrer einladen. Schüler sind nicht direkt einer Klasse zugeordnet; sie treten via Beitritts-Code zu jeder einzelnen Prüfung neu bei.

Klasse anlegen

„Klassen → + Neue Klasse". Pflichtfeld: Name. Optional: Schuljahr, Fach.

Co-Lehrer einladen

„Klasse öffnen → Teilen". Sie geben eine Lehrer-E-Mail ein und das System schickt einen Einladungs-Link. Wenn der Co-Lehrer annimmt, hat er Zugriff auf alle Prüfungen, die Sie dieser Klasse zugewiesen haben.

Klasse verlassen / löschen

Co-Lehrer können „Klasse verlassen". Eigentümer können die Klasse löschen — dabei werden alle Prüfungen mit dieser Klassen-Zuordnung NICHT gelöscht (sie behalten ihre Versuche und Bewertungen).

3. Prüfungen erstellen

„Prüfungen → + Neue Prüfung". Eine Prüfung läuft durch fünf Status: draft (Entwurf, bearbeitbar) → active (Schüler treten bei) → ended (Bewertung läuft) → graded (Lehrer hat korrigiert) → returned (an Schüler freigegeben).

Aufgabentypen

• Multiple Choice — eine oder mehrere richtige Antworten, optional mit Sub-Fragen für Mehrfach-Items in einer Aufgabe.
• Freitext kurz / Freitext lang — Schüler tippt Text. Lehrer korrigiert manuell oder per KI.
• Aufgabe — offene Aufgabenstellung, freier Text als Antwort.
• Lückentext — Lückenwörter werden gegen eine Liste richtiger Antworten geprüft.
• Zuordnung (Matching) — Begriffe links zu Definitionen rechts.
• Reading Comprehension (Q&A) — Lese-Material + mehrere Sub-Fragen, jede einzeln bewertet.

Klassen zuweisen + Aktivieren

Wählen Sie eine oder mehrere Klassen aus. Beim Aktivieren generiert ClassTests einen 6-stelligen Beitritts-Code (z.B. ABC123) — geben Sie ihn an Ihre Schüler weiter (mündlich, per Mail, an die Tafel).

Vorlagen

Bestehende Prüfungen lassen sich via „Duplizieren" als Basis für neue verwenden — alle Aufgaben + Bewertungsbögen werden mitkopiert.

4. Bewertungsbögen & KI-Musterbewertung

Pro Aufgabe (vor allem Freitext / Aufgabe) können Sie einen Bewertungsbogen anlegen — eine tabellarische Bewertungsvorgabe (z.B. „Inhalt 40 % · Sprache 30 % · Struktur 30 %").

Manuell

Im Aufgabe-Editor: „Bewertungsbogen für diese Aufgabe (optional)". Spalten + Zeilen + Punkte pro Zelle eintragen.

KI-Musterbewertung (Stufen)

Im Bewertungs-Block einer Aufgabe: KI-gestützt → „🎯 Musterbewertung jetzt generieren". Voraussetzungen: Aufgabentext, Schulart, Schulstufe, Maximalpunkte (für Punkte-Skala). Mistral generiert pro Note (1–5 oder 1–6) Kriterien + Beispielantwort. Sie können die Sprache der Beispielantwort wählen (auto / Deutsch / Englisch / Französisch / …).

Bewertungsbogen-PDF

Vom Prüfungs-Detail → „Bewertungsbogen-PDF" — eine druckbare Übersicht aller Kriterien für Ihre Akten.

5. Anti-Cheat-Einstellungen

Pro Prüfung in den Einstellungen aktivierbar:

• Vollbild erzwingen — Schüler muss in den Vollbildmodus wechseln. Verlassen wird mitgezählt.
• Tab-Wechsel-Limit — Maximal-Anzahl erlaubter Wechsel zu einem anderen Browser-Tab/Fenster. Bei Überschreitung Warnung an Schüler + Live-Eintrag im Lehrer-Monitoring.
• Copy/Paste-Block — Verhindert das Kopieren des Aufgabentextes und das Einfügen externer Inhalte.
• Fragen mischen — Jeder Schüler bekommt die Aufgaben in zufälliger Reihenfolge.

📱 Apple-Geräte (iPad/iPhone, Safari)

iOS und iPadOS lassen Browser-Apps keinen Vollbild-Zwang durchsetzen — Apple schließt den Vollbild-Modus automatisch, sobald die Bildschirm-Tastatur erscheint. ClassTests erkennt iOS-Geräte automatisch und deaktiviert den Vollbild-Zwang dort komplett, statt den Schüler mit Fehl-Warnungen zu blockieren.

Was bleibt aktiv:

• Tab- und App-Wechsel werden auch auf iOS zuverlässig erkannt (Control Center, Home-Wisch, App-Switcher) und zählen ins Tab-Wechsel-Limit.
• Copy/Paste-Block funktioniert.
• Server-Heuristik erkennt verdächtige Texteinfügungen (Burst > 120 Zeichen in < 300 ms oder Paste-Event) und loggt sie als „Einfügen vermutet".
• Verbindungsabbrüche länger als 15 Sekunden werden als „Verbindung lang abgebrochen" eskaliert.

Was Sie im Monitoring sehen: jeder iOS-Versuch trägt ein 📱-Badge neben dem Schülernamen — sowohl im Live-Monitor als auch in der Versuche-Liste der Prüfung. So wissen Sie sofort, welche Versuche Sie genauer beobachten sollten.

6. Schüler einladen

Zwei Wege, wie Ihre Schüler:innen an einer Prüfung teilnehmen können:

Variante A — Gast-Beitritt per Code (ohne Account)

Beim Aktivieren erscheint der 6-stellige Beitritts-Code. Schüler:innen gehen auf die ClassTests-Startseite, klicken „Beitreten", geben Code + Vor- und Nachname (+ optional E-Mail) ein. Kein Account nötig — schnell, anonym, ideal für einmalige Klassenarbeiten.

Pro Versuch entsteht ein temporärer Gast-Account. Sie können ihn später jederzeit einem echten Schüler-Account zuordnen (siehe unten „Nachträgliche Zuordnung").

Variante B — Eingeloggter Schüler-Account (empfohlen für Stammklassen)

Sie legen pro Schüler:in einmal einen Account an. Vorteile:

• Schüler:in sieht im eigenen Dashboard alle freigegebenen Prüfungen als Archiv (mit PDF-Download).
• Sie als Lehrer:in haben eine zentrale Schüler-Liste mit Login-Statistik.
• Bei Klassen-Zuordnung erscheint die Prüfung sofort im Schüler-Dashboard mit „Jetzt starten"-Button — der Code muss nicht extra geteilt werden.
• Eindeutige Identität — keine Verwechslungen bei ähnlichen Namen.

Schüler:innen-Accounts anlegen

Sidebar → Schüler:innen → + Schüler:innen anlegen. Sie haben zwei Wege:

• Einzeln: Vorname, Nachname, E-Mail eintippen — fertig.
• CSV-Datei hochladen: Laden Sie eine Liste aus dem Schulinfo-Programm oder Google Sheets (.csv/.tsv). Im zweiten Schritt wählen Sie per Dropdown, welche Spalte für Vorname, Nachname und (optional) E-Mail steht — Auto-Erkennung schlägt typische Spalten-Namen direkt vor. Eine Vorschau-Tabelle zeigt mit Farb-Badges, welche Spalte wofür benutzt wird.

ClassTests generiert automatisch ein 8-Zeichen-Passwort (Kleinbuchstaben + 1 Ziffer + 1 Sonderzeichen, ohne verwechselbare Zeichen wie o/0) und zeigt es einmalig als druckbare Karte an. Das Passwort wird zusätzlich verschlüsselt gespeichert — über den 👁 Anzeigen-Button in der Schüler-Liste können Sie es jederzeit erneut einsehen.

Login-Daten verteilen: Drucken oder „Alle kopieren"-Button → in einer Mail an die Schüler:innen. Bei vergessenem Passwort klicken Sie in der Liste auf 🔑 PW und generieren ein neues.

Klassen-Zuweisung

In der Klassen-Detail-Seite gibt es einen Abschnitt „Schüler:innen" mit „+ Hinzufügen"-Button. Wählen Sie die Mitglieder aus Ihren angelegten Accounts. Sobald Sie in dieser Klasse eine Prüfung aktivieren, sehen alle Mitglieder sie auf ihrem Dashboard.

Nachträgliche Zuordnung (Gast → Account)

In der Versuche-Liste einer Prüfung trägt jeder Gast-Versuch ein gelbes Gast 🔗-Badge. Klick darauf öffnet ein Modal, in dem Sie den Versuch entweder einem vorhandenen Schüler-Account zuordnen oder direkt einen neuen Account anlegen lassen. Bewertungen und Antworten bleiben unverändert — nur die Account-Verknüpfung wechselt.

E-Mail-Modus (nur für Gast-Beitritt relevant)

• Off — Schüler braucht keine E-Mail. Sie können die Korrektur dann nur als ZIP-Download exportieren.
• Optional — Schüler kann eine E-Mail angeben. Wenn ja, bekommt er die Korrektur per Mail.
• Required — E-Mail ist Pflicht. Empfohlen wenn Schüler die Note unbedingt zugestellt bekommen sollen.

Bei eingeloggten Schüler-Accounts ist die E-Mail bereits im Account hinterlegt — die Korrektur wird automatisch dorthin geschickt, sobald Sie sie freigeben.

Fairness

Gast-Schüler:innen können nur einmal pro Code beitreten — der Versuch ist eindeutig an Vor- und Nachname gebunden. Doppel-Beitritt mit dem gleichen Namen wird erkannt.

7. Live-Monitoring

Während eine Prüfung aktiv ist, sehen Sie auf der Detail-Seite eine Live-Liste aller Versuche mit Status (in_progress, submitted) und das Aktivitätslog (Tab-Wechsel, Pasten, etc.).

• Status pro Schüler — wer ist verbunden, wer hat schon abgegeben?
• Anti-Cheat-Events — z.B. „Tab-Wechsel #3" oder „Vollbild verlassen".
• Force-Submit — falls ein Schüler hängt, können Sie als Lehrer die Abgabe erzwingen.
• Versuch zuweisen — wenn ein Schüler den falschen Code eingegeben hat, können Sie seinen Versuch einem anderen Schüler-Slot zuweisen.

Prüfung beenden

„Prüfung beenden" stoppt alle laufenden Versuche und übernimmt automatisch die letzten Auto-Save-Werte als Abgabe.

8. Bewertung (manuell)

Pro Versuch öffnen Sie den Bewertungs-Editor („Bewerten"-Button). Pro Aufgabe sehen Sie die Schülerantwort (Original) + einen editierbaren Korrektur-Block.

Inline-Markierungen

• Strikethrough — Wort markieren → automatisch durchgestrichen (Fehler).
• Ruby-Annotationen — Korrektur-Vorschlag über/unter dem Originalwort (rot/gelb/grün).
• Zeilen-Annotationen — pro Zeile freie Anmerkungen.

Punkte und Note

Punkte pro Aufgabe, Gesamtnote (automatisch aus Notenskala oder manuell überschrieben). Auto-Save speichert alle 3 Sekunden — kein Datenverlust bei Tab-Wechsel.

„Nächster Schüler"-Workflow

Nach dem Speichern als „korrigiert" oder „freigegeben" springt das System automatisch zum nächsten unkorrigierten Versuch — Sie müssen nicht zur Liste zurück.

9. KI-Korrektur

ClassTests bietet drei Wege für KI-gestützte Korrektur — als Vorschlag, den Sie anschließend prüfen und ggf. anpassen.

Server-Mistral (Standard)

Im Bewertungs-Editor pro Aufgabe: „✨ KI-Vorschlag". Mistral generiert eine Korrektur basierend auf Aufgabe + Bewertungsbogen + KI-Musterbewertung. Wochen-Quota: 50 Korrekturen pro Woche pro Lehrer (gratis).

BYO-Keys (Bring Your Own Keys)

Unter „Profil → KI-Provider" können Sie eigene API-Keys hinterlegen (OpenAI, Anthropic, Google Gemini, eigener Mistral-Account). Keys werden verschlüsselt in der DB gespeichert.

KI-Bulk-Korrektur (alle Aufgaben aller Schüler)

Auf der Prüfungs-Detail-Seite: „✨ KI: alle Aufgaben". Asynchroner Job — KI korrigiert alle unkorrigierten Antworten als Batch. Status-Polling zeigt Fortschritt. Sie prüfen danach jede Korrektur und akzeptieren oder ändern sie.

KI-Bulk-Export / -Import

Falls Sie eine externe KI nutzen wollen: Aufgabe auf der Detail-Seite → „KI-Bulk-Export" gibt alle Schülerantworten als Text. Sie füttern sie in Ihre bevorzugte KI, kopieren die Ergebnisse zurück → „KI-Import" verarbeitet sie.

10. Notenfreigabe

Nach der Korrektur haben Sie drei Speichern-Optionen:

• Speichern (Entwurf) — Status bleibt graded, Schüler sieht nichts.
• Als korrigiert speichern — Status corrected. Nächster Versuch öffnet sich automatisch.
• Speichern & freigeben — Status returned. Schüler bekommt eine E-Mail mit Link zum Korrektur-PDF (sofern E-Mail vorhanden).

Bulk-Freigabe

In der Versuche-Liste mehrere Versuche markieren → „✓ Markierte freigeben" — alle ausgewählten gehen in einem Schritt an die Schüler raus.

11. ClassCheck-Anbindung

Wenn Sie ClassCheck als Notenraster nutzen, übernimmt ClassCheck Prüfungs-Ergebnisse direkt aus ClassTests — kein Abtippen. ClassCheck holt die freigegebenen Ergebnisse selbst ab (Pull); Sie hinterlegen dafür einmalig einen Verbindungs-Token.

Einrichten (einmalig)

1. In ClassTests: „Profil → ClassCheck-Anbindung" → „Neuen Token erzeugen" → kopieren.
2. In ClassCheck: „Einstellungen → ClassTests verbinden" → Token einfügen → „Verbinden & testen".

Importieren

1. Prüfung benoten und freigeben (zurückgeben) — nur freigegebene Ergebnisse sind importierbar.
2. Import starten: in ClassCheck (Fach → „ClassTests-Import") oder hier auf der Prüfungs-Seite über „📥 In ClassCheck importieren".
3. Prüfung & Ziel-Fach wählen, Schüler-Zuordnung prüfen (Auto-Match), „Importieren". Der Spaltentyp (Punkte/Note/Prozent) wird aus dem Prüfungsschema abgeleitet.

ClassCheck weist im Dashboard auf neue importierbare Prüfungen hin (mit „Importieren" / „Ignorieren"). Bereits übertragene Versuche zeigen in der Versuche-Liste das Badge „✓ ClassCheck".

Bei E2EE-Fächern verschlüsselt ClassCheck die Werte im Browser der Lehrkraft (Vault entsperren) — keine Klartext-Werte verlassen den Tab.

12. Datenexport & PDFs

• Korrektur-PDF (pro Versuch) — Schüler-Antwort + Ihre Anmerkungen + Note. Einzeln oder als ZIP für alle Versuche der Prüfung.
• Prüfung als PDF — Druck-Version der Aufgaben (mit oder ohne Lösungen).
• Leeres Prüfungs-PDF — Blanko-Druck zum Verteilen auf Papier.
• Bewertungsbogen-PDF — alle Kriterien tabellarisch.
• DSGVO-Datenexport (Profil → Datenexport) — alle Ihre Daten als ZIP (JSON + Korrektur-PDFs).

13. Profil & Sicherheit

• Name / E-Mail / Passwort ändern — Profil-Seite. E-Mail-Wechsel braucht Bestätigung über die alte Adresse.
• Aktive Sitzungen — alle „Angemeldet bleiben"-Tokens. Sie können einzelne oder alle anderen Geräte abmelden.
• KI-Provider — siehe Sektion 9.
• ClassCheck-Anbindung — siehe Sektion 11.
• Account löschen — unwiderruflich. Alle Ihre Klassen + Prüfungen + Schüler-Versuche werden mit gelöscht.

1. Prüfung beitreten

Es gibt zwei Wege, an eine Prüfung zu kommen:

Variante A — schnell ohne Account

Dein Lehrer gibt dir einen 6-stelligen Code (z.B. ABC123). Auf der ClassTests-Startseite klickst du auf „Prüfung beitreten" und gibst ein:

• Den Beitritts-Code
• Deinen Vor- und Nachnamen (so wie dein Lehrer dich kennt)
• Optional: deine E-Mail-Adresse — dann bekommst du die Korrektur später als PDF zugeschickt

Variante B — mit deinem Schüler-Account

Wenn dein Lehrer dir Login-Daten gegeben hat (E-Mail + Passwort), logge dich oben rechts ein. Dann siehst du auf deinem Dashboard direkt alle Prüfungen deiner Klasse — ohne Code eingeben zu müssen. Klick auf „Jetzt starten" und du bist drin. Für andere Prüfungen, die nicht für deine Klasse aktiviert wurden, kannst du oben rechts „+ Code eingeben" nutzen.

2. Mein Schüler-Account

Wenn dein Lehrer dir Login-Daten ausgehändigt hat, kannst du dich mit deiner E-Mail-Adresse und dem Passwort einloggen.

Dashboard

• Neu für deine Klasse — Prüfungen, die dein Lehrer gerade aktiviert hat und an denen du teilnehmen kannst. Klick „Jetzt starten" und du bist drin.
• In Bearbeitung — laufende Versuche, die du noch nicht abgegeben hast. Hier landest du, wenn du eine Prüfung unterbrichst und später weitermachen willst.
• Abgeschlossene Prüfungen — alles, was du abgegeben hast. Bewertete und freigegebene Versuche zeigen Note + Prozent + Link zum Ergebnis-PDF. Solange dein Lehrer noch nicht freigegeben hat, steht dort „Wird bewertet" — die Note bleibt geheim.

Passwort vergessen?

Wende dich an deinen Lehrer — er kann dir mit einem Klick ein neues Passwort generieren und dir geben.

3. Während der Prüfung

Aufgaben-Navigation

Links siehst du eine Liste aller Aufgaben mit Status (✓ beantwortet, ○ noch leer). Du kannst zwischen ihnen springen.

Auto-Save

Jede Antwort wird automatisch alle paar Sekunden gespeichert. Zusätzlich werden alle Antworten im deinem Browser zwischengespeichert — bei Internet-Abbruch gehen sie nicht verloren. Beim Wieder-Online-Sein werden sie automatisch nachgesendet.

Timer

Falls dein Lehrer ein Zeitlimit gesetzt hat, läuft oben rechts ein Timer. Bei 0:00 wird die Prüfung automatisch abgegeben.

Anti-Cheat-Hinweise

Je nach Einstellung deines Lehrers kann es sein, dass:

• Du im Vollbildmodus bleiben musst (verlassen wird gezählt)
• Tab-Wechsel zu anderen Browser-Tabs/Fenstern gezählt werden
• Kopieren und Einfügen blockiert ist

Das ist normal und kein Hinweis auf Misstrauen — nur eine technische Maßnahme. Dein Bildschirm wird nicht aufgezeichnet.

Selbst-Check vor Abgabe

Bevor du abgibst, zeigt dir ein Dialog alle noch unbeantworteten Aufgaben — klickbare Liste, mit der du direkt zur entsprechenden Aufgabe springen kannst.

4. Abgabe

Klick auf „Prüfung abgeben" oben rechts. Du bekommst:

• Eine Liste der unbeantworteten Aufgaben (falls welche da sind)
• Bestätigungs-Dialog — danach ist die Abgabe endgültig
• Bestätigungs-Nachricht und Logout — du wirst auf die Startseite zurückgeschickt

5. Ergebnis ansehen

Sobald dein Lehrer die Note freigegeben hat:

• Mit E-Mail-Adresse: du bekommst eine E-Mail mit einem Link zu deiner Korrektur. Klick öffnet ein PDF mit deinen Antworten + Anmerkungen + Note.
• Ohne E-Mail: dein Lehrer teilt dir die Note auf anderem Weg mit.

6. Auf dem iPad oder iPhone (Safari)

ClassTests funktioniert auch auf Apple-Geräten. Ein paar Dinge laufen aber anders als am Computer:

• Kein Vollbild-Zwang — Apple lässt das nicht zu, sobald du tippst. Du brauchst dich nicht zu wundern, wenn der Vollbild-Knopf nicht erscheint oder die Tastatur den Vollbild schließt. Du bekommst keine roten Warn-Fenster deswegen.
• App-Wechsel zählt — wenn du Safari verlässt, das Control Center öffnest oder zum Home-Bildschirm wischt, zählt das genauso als „Fenster verlassen" wie ein Tab-Wechsel am PC.
• Wörterbuch/Auto-Korrektur sind in den Antwort-Feldern abgeschaltet, damit kein automatisch eingefügter Vorschlag fälschlich als Einfügen erkannt wird.

7. Wenn etwas hakt

Internet-Abbruch

Deine Antworten werden lokal in deinem Browser gespeichert und bei der nächsten Verbindung automatisch nachgesendet. Du kannst weiter tippen, auch wenn rechts oben „Speichern fehlgeschlagen" steht.

Browser-Crash / Tab geschlossen

Solange die Prüfung noch aktiv ist, kannst du mit dem gleichen Code + Namen erneut beitreten — du landest beim gleichen Versuch und siehst alle bisher gespeicherten Antworten.

Vollbild verlassen (nur am Computer)

Eine Warnung erscheint. Du klickst „Wieder Vollbild" und kannst weiter machen. Der Lehrer sieht im Monitoring, wie oft das passiert ist. Auf iPad/iPhone ist das nicht relevant — siehe Abschnitt 6.

Tab-Wechsel-Limit überschritten

Du bekommst eine Warnung, kannst aber weiter machen. Der Lehrer entscheidet, wie er mit der Häufigkeit umgeht.