Einführung in HagiTask

Für wen: Personen, die das HagiTask-Ökosystem nutzen, pflegen oder dazu beitragen möchten.

Voraussetzungen: Keine. Zum Installieren oder Ausführen von Aufgaben benötigen Sie die HagiCode-Anwendung und ihren Backend-Dienst.

Was ist HagiTask?

HagiTask ist das Modell für Aufgabenpakete und vordefinierte Aufgaben in HagiCode. Ein Aufgabenpaket vereint Aufgabenkennung, Frontend-Panel, Backend-Prompts, Vorlagen, Oberflächentexte und Beschreibung für den Store in einem überprüfbaren Verzeichnis. So kann die Anwendung Aufgaben finden, installieren, verwalten und ausführen.

Ein Aufgabenpaket ist nicht die Anwendung selbst und ersetzt auch nicht deren Laufzeitkonfiguration. Die Anwendung lädt Aufgaben und führt die von ihnen deklarierten Funktionen aus; das Paket stellt lediglich Ressourcen in einem vereinbarten Format bereit.

Die Rollen im Ökosystem

Komponente	Zuständigkeit
HagiTask	Verwaltet das gemeinsame Schema und die mit dem Produkt ausgelieferten integrierten Vorlagenpakete; maßgebliche Quelle für das Paketformat.
Integrierte Vorlagen	Mit Anwendung oder Laufzeit bereitgestellte Aufgaben, etwa normal-session und research-investigation.
Community Packages	Verwaltet die Quelldaten der Community-Aufgaben unter data/<taskId>/.
HagiTask Site	Erzeugt aus den Community-Paketquellen den Katalog, Detail-JSON-Dateien und ZIP-Archive und veröffentlicht sie in der Community Gallery.
HagiCode-Anwendung	Zeigt Aufgaben an, installiert Pakete, speichert deren Aktivierungsstatus und führt Aufgaben zur Laufzeit aus.

Integrierte Vorlagen und Community-Aufgaben verwenden dasselbe Paketschema, unterscheiden sich aber in Herkunft und Lebenszyklus: Die integrierten Vorlagen werden im HagiTask-Repository gepflegt, Community-Aufgaben im Repository Community Packages. /index.json, Detaildokumente und ZIP-Dateien der Website sind generierte Artefakte und keine Quelldateien, die Beitragende direkt bearbeiten.

Paketverwaltung ist nicht dasselbe wie Quellenverwaltung

Die Installation einer ZIP-Datei aus der Gallery kopiert das Paket in das Datenverzeichnis der Anwendung und erfasst Version, Herkunft und Aktivierungsstatus. Bei der Verwaltung serverseitiger Quellen werden dagegen Verzeichnisse konfiguriert, die der Server sehen kann und in denen die Laufzeit nach Aufgaben sucht. Dadurch wird kein lokaler Browserordner als Installationspaket hochgeladen.

Welche Schritte wofür vorgesehen sind und wie Verzeichnisquellen funktionieren, erfahren Sie unter HagiTask verwenden. Wenn Sie ein Paket installieren möchten, lesen Sie HagiTask installieren; zum Erstellen oder Veröffentlichen einer Aufgabe lesen Sie Zur Community beitragen.

Zuständigkeiten der maßgeblichen Quellen

• Die Dokumentation pflegt Anleitungen und Erläuterungen für Nutzende und Beitragende.
• HagiTask pflegt das gemeinsame Schema und die Quellen der integrierten Vorlagen.
• Community Packages pflegt die Quelldaten der Community-Pakete.
• HagiTask Site veröffentlicht den aus den Paketquellen erzeugten Katalog, die Details und Archive.

Nächster Schritt: HagiTask installieren.