Introdução ao HagiTask

Para quem é este guia: Usuários, mantenedores e colaboradores que desejam conhecer o ecossistema HagiTask.

Pré-requisitos: Nenhum. Para instalar ou executar tarefas, tenha o aplicativo HagiCode e seu serviço de backend disponíveis.

O que é o HagiTask

O HagiTask é o modelo de pacotes de tarefas e tarefas predefinidas do HagiCode. Um pacote reúne a identidade da tarefa, o painel de frontend, os prompts de backend, os modelos, os textos da interface e a apresentação na loja em um único diretório verificável. Assim, o aplicativo pode descobrir, instalar, gerenciar e executar tarefas.

O pacote não é o aplicativo em si nem substitui a configuração de execução do aplicativo. O aplicativo carrega as tarefas e executa as funcionalidades declaradas por elas; o pacote apenas fornece recursos organizados em um formato definido.

Papéis no ecossistema

Componente	Responsabilidade
HagiTask	Mantém o Schema compartilhado e os pacotes de predefinições integradas distribuídos com o produto; é a fonte de referência para o formato dos pacotes.
Predefinições integradas	Tarefas prontas fornecidas com o aplicativo ou o ambiente de execução, como normal-session e research-investigation.
Community Packages	Mantém os dados de origem das tarefas da comunidade em data/<taskId>/.
HagiTask Site	Gera o catálogo, os JSONs de detalhes e os arquivos ZIP a partir dos pacotes da comunidade e os publica na Community Gallery.
Aplicativo HagiCode	Exibe tarefas, instala pacotes, salva o estado de ativação e executa tarefas.

As predefinições integradas e as tarefas da comunidade usam o mesmo Schema de pacote, mas têm origens e ciclos de vida diferentes: as predefinições são mantidas no repositório HagiTask; as tarefas da comunidade, no repositório Community Packages. O /index.json, os documentos de detalhes e os ZIPs do site são artefatos gerados, não arquivos de origem editados diretamente por colaboradores.

Gerenciar pacotes não é o mesmo que gerenciar fontes

Instalar um ZIP da Gallery copia o pacote para o diretório de dados do aplicativo e registra sua versão, origem e estado de ativação. Já o gerenciamento de fontes do servidor configura diretórios acessíveis ao servidor para que o ambiente de execução descubra tarefas neles; ele não envia uma pasta local do navegador como pacote instalável.

Para entender essa distinção e as fontes baseadas em pastas, leia Como usar o HagiTask. Para começar a instalar, consulte Como instalar o HagiTask; para criar ou publicar tarefas, leia Como contribuir com a comunidade.

Responsabilidades pelas fontes de referência

• A documentação mantém as explicações e os guias operacionais para usuários e colaboradores.
• O HagiTask mantém o Schema compartilhado e as predefinições integradas.
• O Community Packages mantém os dados de origem dos pacotes da comunidade.
• O HagiTask Site publica o catálogo, os detalhes e os arquivos gerados a partir dos pacotes.

Próximo passo: Como instalar o HagiTask.