Stacks / Sammlungen

Stacks sind die thematischen Sammelbehälter der Future-Box. Ein Stack hält mehrere Memos zusammen, gruppiert nach Thema, Projekt, Lernfeld oder Phase. Über Stack-Vorlagen werden vorbereitete Strukturen ausgerollt; über Code-Freigaben (auch „Vorlagen“ genannt) können einzelne Lernende Inhalte miteinander teilen.

Überblick

Ein Stack vereint:

• Titel, Untertitel und Beschreibung als Rahmen
• ein Titelbild zur visuellen Wiedererkennung
• eine Sammlung von Memos (Reihenfolge nach Datum, sortiert)
• eine Sortierung gegenüber anderen Stacks (Feld sort)
• optional: Verknüpfung zu einer Stack-Vorlage (Portfoliotemplate), deren Titel/Untertitel/Beschreibung dann durchscheinen

Stacks sind das oberste Strukturelement im persönlichen Bereich. Im Hauptmenü erscheinen sie als Dashboard (Renaming navigation_portfolio).

⚠️ Begriffshinweis: Im Code- und URL-Kontext heißen Stacks „Portfolios“ (Modell Portfolio). In der Standardterminologie der Oberfläche sind es „Stacks“. Über die Renaming-Funktion lässt sich das je Instanz anpassen — beachten Sie auch den verwandten Renaming-Schlüssel category_singular/category_plural (Default „Aufgabenbereich“/„Aufgabenbereiche“), der an einigen Stellen für Stacks verwendet wird.

Für wen ist dieser Bereich?

🎓 Lernende / 👩‍🏫 Lehrende / ⚙️ Admin

Alle Personen mit Berechtigung use_portfolio haben einen eigenen Stack-Bereich. Sichtbarkeit ist persönlich: Niemand sieht die Stacks anderer Personen direkt — nur über Link-Freigaben oder importierte Code-Freigaben.

---

Die Stack-Übersicht (Dashboard)

🎓 Lernende

• Menü: Dashboard
• URL: /portfolio/portfolios

Die Übersicht ist in zwei Bereiche gegliedert:

• System-Stacks (Renaming systemcategory_plural) — Stacks, die aus einer Stack-Vorlage entstanden sind
• Eigene Stacks — frei erstellte Stacks

Jede Kachel zeigt Titel, Titelbild und (sofern vorhanden) eine Markierung für ungelesene Feedbacks. Per Klick auf einen Stack öffnen Sie die enthaltenen Memos.

Stack-Liste (Verwaltungs-Ansicht)

🎓 Lernende

• Menü: Einstellungen → (Stack-Liste)
• URL: /portfolio/portfolios/list

Diese Ansicht ist tabellarisch und für die Verwaltung gedacht. Sie zeigt System-Stacks und eigene Stacks getrennt, je 5 pro Seite, mit Aktions-Buttons für Bearbeiten und Löschen.

---

Stack erstellen

🎓 Lernende

1. Dashboard öffnen.
2. Auf „Neuer Stack“ klicken (oder Schaltfläche im Stack-Listen-Tab).
3. Felder ausfüllen:
   • Titel (Pflicht)
   • Untertitel (optional)
   • Beschreibung — Rich-Text mit Hintergrund/Anleitung zum Stack-Thema
   • Tags — optional Schlagwörter
   • Medien-Verlinkungen — z. B. weiterführende Materialien
   • Titelbild — Bild hochladen + zuschneiden (Cropper.js)
   • Sortierung (sort) — Reihenfolge in der Stack-Übersicht
4. „Speichern“ klicken.

Der neue Stack ist sofort in der Übersicht sichtbar und bereit, Memos aufzunehmen.

💡 Tipp: Sortierung in 10er-Schritten (10, 20, 30 …) ist hilfreich — so können Sie später zwischen zwei Stacks einen weiteren einsortieren, ohne alles zu verschieben.

---

Stack bearbeiten

🎓 Lernende

1. Stack-Liste öffnen → Stift-Symbol klicken (oder direkt /portfolio/portfolios/{id}/edit).
2. Felder ändern.
3. „Speichern“.

⚠️ Hinweis: Bei Stacks, die aus einer Stack-Vorlage entstanden sind (isTemplated = true), sind Titel, Untertitel und Beschreibung nicht editierbar — diese werden aus der Vorlage geerbt. Editierbar bleibt nur die Sortierung. Wenn Sie den Inhalt ändern wollen: separat neuen, freien Stack anlegen.

---

Stack löschen

🎓 Lernende

1. Stack-Liste öffnen → Lösch-Symbol klicken.
2. Bestätigungsdialog beantworten.

Schutzregeln

• Stacks mit Memos können nicht gelöscht werden. Fehlermeldung: „… kann nicht gelöscht werden, da er Einträge enthält.“ Lösung: Memos zuvor in einen anderen Stack verschieben oder löschen.
• System-Stacks aus Vorlage (isTemplated = true) können nicht gelöscht werden. Fehlermeldung: „… ist ein festes Template.“ Stack-Vorlagen werden ausschließlich durch die Administration verwaltet.

💡 Hinweis: Die Schutzregel verhindert Datenverlust durch Versehen. Wenn Sie einen Stack mit Inhalt loswerden wollen, gehen Sie über die Memo-Liste und löschen die Inhalte einzeln — oder verschieben sie via Memo-Bearbeiten in einen anderen Stack.

---

Stack-Vorlage in einen eigenen Stack ausrollen

🎓 Lernende

Stack-Vorlagen (Templates) sind durch die Administration angelegte Strukturen, mit denen Sie ohne Schreibarbeit einen vorbereiteten Stack erzeugen können (z. B. „Wochenbericht“, „Reflexion zum Praktikum“). Wie das praktisch geht:

1. Dashboard öffnen.
2. Im Bereich „System-Stacks“ auf eine angebotene Vorlage klicken.
3. Die Future-Box erstellt einen neuen Stack, dessen Titel, Untertitel und Beschreibung aus der Vorlage stammen.
4. Sie füllen Memos hinein wie üblich.

Details zur Konfiguration: Templates.

---

Code-Freigaben („Vorlagen“)

🎓 Lernende

Mit Code-Freigaben teilen Sie Stacks oder Memos innerhalb der Instanz mit anderen Nutzer:innen. Die Empfänger geben den Code ein und importieren den Inhalt als eigenständige Kopie. Die Future-Box bietet zwei separate Mechanismen:

Variante	URL	Was wird kopiert?	Editierbarkeit nach Import
Stack-Freigabe	/portfolio/shares/stacks	Stacks (inkl. Memos), Lernorte, Tags	Empfänger kann frei bearbeiten
Memo-Freigabe	/portfolio/shares/memos	Einzelne Memos, optional Lernorte, Tags	Optional: lock via can_edit_trainee

⚠️ Begriffshinweis: Code-Freigaben heißen in der UI standardmäßig „Vorlagen“ (Renaming-Schlüssel share_singular/share_plural/shares_title). Sie sind nicht zu verwechseln mit den admin-erstellten Stack-Vorlagen (siehe Templates).

Stack-Freigabe erstellen

🎓 Lernende

1. Teilen → Vorlagen öffnen oder direkt /portfolio/shares/stacks/create.
2. Name der Freigabe eingeben (rein zur Identifikation für Sie).
3. Auswählen, was in die Freigabe einfließen soll:
   • Stacks — ein oder mehrere; zugehörige Memos werden automatisch mitgegeben.
   • Lernorte — die der Empfänger:in nützlich sein können, damit der Kontext stimmt.
   • Tags — analog.
4. „Speichern“ — die Future-Box generiert einen 6-stelligen Code (Str::random(6)).
5. Den Code an die Empfänger:in weitergeben (Mail, Chat, Plakat).

Memo-Freigabe erstellen

🎓 Lernende / 👩‍🏫 Lehrende

Funktioniert wie die Stack-Freigabe, nur mit einzelnen Memos. Zusätzlich verfügbar:

• „Empfänger dürfen die Memos bearbeiten“ (can_edit_trainee) — wenn deaktiviert, können Empfänger mit der Rolle user (Auszubildende) die importierten Memos nicht ändern oder löschen. Nützlich für Lehr-Materialien, die im Wortlaut bewahrt bleiben sollen.

💡 Tipp für Lehrende: Wenn Sie Aufgabenstellungen oder Beispiel-Memos verteilen möchten, lassen Sie das Häkchen „Empfänger dürfen bearbeiten“ weg — die Memos kommen dann „read-only“ bei den Lernenden an.

Eine Code-Freigabe importieren

🎓 Lernende

1. Teilen → Vorlagen öffnen.
2. Auf „Code eingeben“ klicken.
3. Den 6-stelligen Code eingeben.
4. Vorschau-Modal prüft:
   • Ungültiger Code → Fehlermeldung „Nummer ungültig“.
   • Eigene Freigabe → Hinweis „Eigene Exports können nicht importiert werden“.
   • Sonst: Liste der Stacks, Memos, Lernorte und Tags, die importiert werden würden.
5. „Importieren“ bestätigt den Import.

Was geschieht beim Import?

• Stack-Freigabe: Hintergrund-Job (ImportStackJob) erstellt eine Kopie der Stacks (inkl. enthaltener Memos), Lernorte und Tags in Ihrem Account. Die Originale beim Sender bleiben unverändert.
• Memo-Freigabe: Memos werden ebenfalls kopiert, ggf. mit Lock (siehe can_edit_trainee oben).

In beiden Fällen erscheinen ein Status-Hinweis im Dashboard, solange Import-Jobs noch in der Warteschlange sind: „Vorlagen-Import läuft noch …“.

Code-Freigabe bearbeiten oder löschen

🎓 Lernende

In der Liste der eigenen Code-Freigaben:

• Bearbeiten — Inhalt der Freigabe ändern (Stacks/Memos/Lernorte/Tags neu auswählen). Beim Speichern werden die alten shareables-Verknüpfungen gelöscht und neu angelegt.
• Löschen — entfernt die Freigabe inkl. aller Verknüpfungen. Empfänger, die den Code danach noch eingeben, erhalten „Nummer ungültig“.

⚠️ Wichtig: Bei einer Code-Freigabe wird beim Empfänger eine eigenständige Kopie angelegt. Bearbeitungen oder Löschungen Ihrer Freigabe wirken sich nicht auf bereits importierte Inhalte aus.

---

Hinweise & Tipps

• Kachel-Sortierung über sort: Stacks werden in der Übersicht aufsteigend nach sort angeordnet. Vergeben Sie sinnvolle Werte für eine logische Reihenfolge (z. B. nach Lerneinheit, Halbjahr).
• Eine Geschichte pro Stack: Statt alles in einen einzigen Stack zu kippen, ergeben mehrere thematisch klar abgegrenzte Stacks oft die schönere Berichtsheft- oder Bewerbungs-Datei.
• System-Stacks lassen Inhalt frei: Auch wenn Titel/Beschreibung aus der Vorlage geerbt werden, sind Memos darin frei wählbar — füllen Sie System-Stacks mit Ihrem Material.
• Code-Freigabe für Synchronisation: Sie nutzen die Future-Box mit zwei Accounts (privat + Schul-Account)? Code-Freigaben sind eine einfache Methode, Inhalte in beide Accounts zu spiegeln.
• Lehrkräfte-Workflow: Lehrkraft erstellt Memo-Freigabe mit gesperrtem Editieren → Code-Aushang im Klassenraum → alle Lernenden importieren → einheitlicher Ausgangspunkt.
• Code aufschreiben: Der Code wird zufällig generiert (6 Zeichen). Wenn Sie ihn nicht direkt notieren, finden Sie ihn jederzeit in der Liste Ihrer Code-Freigaben wieder.

Verwandte Bereiche

• Memos – die Inhalte eines Stacks
• Templates – admin-erstellte Stack-Vorlagen
• Link-Freigaben – die öffentliche Variante des Teilens
• PDF-Generator – Stacks als PDF
• Zentrale Funktionen – Vergleich der drei Verwertungswege
• Hauptmenü – wo Stacks und Vorlagen im Menü erscheinen
• Rechte & Rollen – can_edit_trainee und Policy-Schutz für importierte Memos