Organização, workspaces e atividades

Tudo no Kadu pertence a uma organização, e as tarefas dela se arrumam em três níveis:

Organização                 ← a sua empresa; tem um Playbook
└── Workspace               ← um domínio de negócio (Financeiro, Cobrança…)
    └── Atividade           ← um agrupador (Baixa de Recebimentos, Conciliação…)
        └── Tarefa          ← o que o Kadu executa
            └── Execução    ← cada vez que a tarefa roda

Nível	O que é	De onde vem
Organização	A sua empresa no Kadu. Tem o plano contratado, o teto mensal de custo, o fuso horário, os membros e o Playbook.	Criada pela Kobana, ou no cadastro pelo GitHub App.
Workspace	Um domínio de negócio. No Playbook, cada workspace é um plugin.	Criado pela sincronização do repositório, um por plugin.
Atividade	Agrupa tarefas parecidas dentro de um workspace.	Declarada no bloco task: de cada skill (task.activity); a sincronização cria a que falta.
Tarefa	Uma skill que pode ser executada pelo console, por agendamento, pela API ou por chamada HTTP.	Uma skill do repositório com bloco task:.
Execução	Um disparo da tarefa, com histórico, logs, pendências, arquivos, resultado e custo.	Criada a cada disparo.

O repositório manda na estrutura

Workspaces, atividades e tarefas nascem do Playbook da organização e são atualizados a cada push. O console mostra essa estrutura em Configurações → Conteúdo, junto com as skills que ainda não viraram tarefa. Para mudar o nome de uma tarefa, a atividade dela ou os secrets que ela pede, mude o arquivo da skill no repositório. Uma edição feita só no console é desfeita na próxima sincronização.

Ver Kadu Playbook e Sincronização.

Membros e papéis

Quem entra no console é membro da organização, com um papel que define o que pode fazer. As permissões têm o formato agent.<recurso>.<ação>, por exemplo agent.executions.run para disparar uma tarefa ou agent.secrets.update para alterar um secret. Os mesmos papéis valem para quem usa a API com um token pessoal.

Algumas telas também dependem do que a Kobana liberou para a organização: sem a liberação, a tela fica só para leitura ou não aparece.