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: Juni 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.

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, Materialien und Testchat
Im Projektbuilder bearbeitet die Lehrkraft Auftrag, Zielgruppe, Laufzeit, Projektmaterialien und den Testchat.

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. Für die semantische Suche zählt der Zustand „im Projektchat nutzbar“: Erst dann liegen verschlüsselte Textabschnitte und passende Embeddings vor.

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. Teilnehmende mit gültiger Projektmitgliedschaft lesen die Projektmaterialliste und laden freigegebene Projektdateien herunter. Ein Zugriff auf private Originaldateien entsteht daraus nicht. Entfernt die Lehrkraft ein Material aus der Projektmappe, wird es als Projektmaterial nicht mehr angezeigt und nicht mehr für neue Kontextsuche verwendet.

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.