Handbuch

Projekte: Materialien und Kontext

Projektmaterialien sind bewusst freigegebene Kopien oder Uploads. Ephraim nutzt sie als Projektquelle, ohne den privaten Dateispeicher der Lehrkraft oder der Lernenden zu öffnen.

· Stand: Oktober 2026

1. Projektmaterial ist eine eigene Kopie

Eine Lehrkraft fügt Material auf zwei Wegen hinzu: durch neuen Upload oder durch Kopie aus „Meine Dateien“. Bei einer Kopie entschlüsselt Ephraim die private Quelldatei in der laufenden Sitzung der Lehrkraft, verschlüsselt sie sofort mit einem Projektschlüssel neu und speichert sie als Projektdatei. Die private Originaldatei bleibt im persönlichen Speicher der Lehrkraft. Eine Kopie aus „Meine Dateien“ ist erst möglich, wenn die private Quelle fertig für die Suche verarbeitet ist.

Klare Grenze: Eine private Datei wird nicht durch ihre Existenz im Konto zum Projektmaterial. Erst die bewusste Aufnahme in die Projektmappe erzeugt die projektbezogene Kopie.

Projektbuilder mit Projektentwurf, Dateien-Schaltfläche und den Bereichen Mit Ephraim planen und Als Schüler ausprobieren — Über „Dateien“ öffnet die Lehrkraft die Projektmaterialien. Links entwickelt sie den Entwurf mit Ephraim, rechts probiert sie den Projektchat aus Schülersicht aus.

2. Status der Verarbeitung

Nach dem Upload oder Kopieren durchläuft Material eine Verarbeitungskette. Die Oberfläche unterscheidet hochgeladen, Text wird gelesen, Text gelesen, Suchindex wird erstellt, im Projektchat nutzbar und Indexierung fehlgeschlagen. Erst im Zustand „im Projektchat nutzbar“ stehen verschlüsselte Textabschnitte und passende Suchvektoren bereit. Hängengebliebene Verarbeitung wird ebenfalls erkennbar. Die Lehrkraft kann fehlgeschlagenes Material bereinigen und erneut hochladen oder kopieren.

Die Embeddings werden über den lokalen SGLang-Dienst school-ui-embedding berechnet. Dafür sieht die Spark den freigegebenen Textabschnitt nur während des aktuellen Verarbeitungsschritts. Sie speichert weder Projektmaterial-Klartexte noch Embedding-Vektoren dauerhaft. Die dauerhafte Ablage liegt verschlüsselt bei Ephraim.

3. Wie Material in eine Antwort gelangt

Ephraim sendet nicht automatisch jede Projektdatei vollständig an das Modell. Bei einer neuen Frage berechnet Ephraim eine Suchanfrage, vergleicht sie mit den eingebetteten Materialabschnitten und übernimmt nur die passendsten Ausschnitte bis zur eingestellten Kontextgrenze. Der Projektchat erhält diese Ausschnitte mit Dateiname und Abschnittsnummer.

Wenn eine Nutzerin oder ein Nutzer eine konkrete Projektdatei auswählt, begrenzt Ephraim die Suche auf diese Datei. Ohne konkrete Frage fügt Ephraim keinen sinnlosen Materialblock ein, sondern fordert eine Frage zum Material ein.

4. Sichtbarkeit und Download

Projektmaterial gehört zum Projekt. Berechtigte Teilnehmende können die Materialliste lesen sowie freigegebene Dateien ansehen und herunterladen. Nach Ende oder Ablauf des Projekts endet dieser Materialzugriff für Teilnehmende. Ein Zugriff auf private Originaldateien entsteht daraus nicht. Entfernt die Lehrkraft ein Material aus der Projektmappe, wird es nicht mehr angezeigt und nicht mehr für neue Antworten verwendet. Die Admin-Rolle allein gewährt keinen allgemeinen Lesezugriff auf fremdes Projektmaterial.

5. Datei- und Speicherregeln

Projektmaterialien unterliegen denselben grundlegenden Dateiregeln wie andere Uploads: erlaubte Dateitypen, Größenlimits, Quoten, Sicherheitsprüfung und verschlüsselte Speicherung. Projektdateien zählen zur systemweiten Belegung. Eine abgelehnte Datei wird nicht als Projektmaterial verfügbar.