Présentation de HagiTask
Public concerné : personnes qui utilisent, maintiennent ou souhaitent contribuer à l’écosystème HagiTask.
Prérequis : aucun. Pour installer ou exécuter des tâches, préparez l’application HagiCode et son service backend.
Qu’est-ce que HagiTask ?
HagiTask est le modèle de paquets de tâches et de tâches prédéfinies de HagiCode. Un paquet regroupe l’identifiant de la tâche, son panneau frontend, ses prompts backend, ses modèles, ses textes d’interface et sa présentation dans la boutique au sein d’un répertoire vérifiable. L’application peut ainsi découvrir, installer, gérer et exécuter des tâches.
Un paquet de tâches n’est pas l’application elle-même et ne remplace pas sa configuration d’exécution. L’application charge les tâches et exécute les fonctionnalités qu’elles déclarent ; le paquet fournit uniquement des ressources organisées selon un format convenu.
Les rôles dans l’écosystème
| Composant | Responsabilité |
|---|---|
| HagiTask | Gère le schéma partagé et les paquets de préréglages intégrés livrés avec le produit ; il fait autorité pour le format des paquets. |
| Préréglages intégrés | Tâches fournies avec l’application ou son environnement d’exécution, telles que normal-session et research-investigation. |
| Community Packages | Gère les données sources des tâches communautaires dans data/<taskId>/. |
| HagiTask Site | Génère le catalogue, les fichiers JSON détaillés et les archives ZIP à partir des sources communautaires, puis les publie dans la Community Gallery. |
| Application HagiCode | Affiche les tâches, installe les paquets, conserve leur état d’activation et exécute les tâches. |
Les préréglages intégrés et les tâches communautaires utilisent le même schéma de paquet, mais leur origine et leur cycle de vie diffèrent : les premiers sont maintenus dans le dépôt HagiTask, les secondes dans le dépôt Community Packages. Le fichier /index.json, les documents détaillés et les fichiers ZIP du site sont des artefacts générés, et non des sources à modifier directement par les contributeurs.
Gestion des paquets et gestion des sources : deux opérations distinctes
Installer un ZIP depuis la Gallery revient à copier le paquet dans le répertoire de données de l’application et à enregistrer sa version, son origine et son état d’activation. La gestion des sources côté serveur, elle, configure les répertoires visibles par le serveur afin que l’environnement d’exécution y découvre des tâches. Elle ne téléverse pas un dossier local du navigateur en tant que paquet à installer.
Pour comprendre la portée de chaque opération et l’usage des répertoires sources, consultez Utiliser HagiTask. Pour installer un paquet, poursuivez avec Installer HagiTask ; pour créer ou publier une tâche, consultez Contribuer à la communauté.
Responsabilités des sources de référence
- La documentation fournit les explications et les procédures destinées aux utilisateurs et aux contributeurs.
- HagiTask maintient le schéma partagé et les sources des préréglages intégrés.
- Community Packages maintient les données sources des paquets communautaires.
- HagiTask Site publie le catalogue, les détails et les archives générés à partir de ces sources.
Étape suivante : Installer HagiTask.