Skip to content
ver .md original

Acompanhe o progresso de uma meta

Mostre como uma meta do Dailybot está indo: metas com progresso e projetos, a flag is_partial e as tarefas em aberto por trás de uma meta.

Beta

Plan está em beta. Tudo o que está em /plan no aplicativo web, os comandos da CLI e da agent skill para projetos, metas, quadros e tarefas, e a API pública /v1/plan/ podem mudar antes da disponibilidade geral. Quer testar com sua equipe? Escreva para [email protected].

Uma meta diz para que serve o trabalho; as tarefas dos projetos dela dizem como ele está indo. Esta receita monta um relatório de status das metas: todas as metas ativas hoje com o respectivo progresso e, depois, as tarefas em aberto por trás de uma delas.

1. Metas ativas hoje, com progresso

curl -sS "https://api.dailybot.com/v1/plan/goals/?active_on=$(date +%F)&include=progress,projects" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" \
  | jq '.results[] | {name, status, done: .progress.completed, total: .progress.total, percent: .progress.percent_complete, partial: .progress.is_partial}'
  • active_on mantém as metas cujo período inclui essa data.
  • include=progress,projects acrescenta o consolidado de progresso e os projetos vinculados. Eles ficam ausentes por padrão porque cada um é um agregado; um token desconhecido retorna 400 invalid_filter_value.
  • status é o status declarado da meta (on_track, at_risk, …); progress é medido a partir das tarefas. Mostre os dois.

Pela CLI:

dailybot plan goal list --include progress --include projects

2. Uma meta em detalhe

O endpoint de detalhe sempre inclui progress, projects e project_count:

curl -sS "https://api.dailybot.com/v1/plan/goals/$GOAL/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"
{
  "uuid": "00000000-0000-4000-8000-000000000006",
  "name": "Q4 Roadmap",
  "status": "on_track",
  "period_start": "2026-10-01",
  "period_end": "2026-12-31",
  "progress": { "total": 40, "completed": 18, "open": 22, "blocked": 3, "overdue": 2, "percent_complete": 45, "is_partial": true },
  "project_count": 2,
  "projects": [ { "uuid": "00000000-0000-4000-8000-000000000001", "name": "Platform", "health": "on_track" } ]
}

Pela CLI:

dailybot plan goal get "$GOAL"

3. Respeite o is_partial

O progresso conta apenas as tarefas que você pode ver. Quando parte do trabalho da meta está em quadros que você não pode ver, is_partial é true. Deixe isso claro onde quer que você mostre o número, por exemplo “45% do trabalho visível para você”. Nunca o apresente como o progresso da organização.

4. As tarefas em aberto por trás da meta

O filtro goal da lista de tarefas considera a meta da própria tarefa ou a meta que ela herda do projeto, a mesma regra que o consolidado de progresso usa, então a lista e os números batem:

curl -sS "https://api.dailybot.com/v1/plan/tasks/?goal=$GOAL&state=open&sort=due_date" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" | jq '.results[] | {key, title, due_date, state: .state.name}'

Acrescente &blocked=true para ver o que está travado, ou &due_before=$(date +%F) para ver o que está atrasado.

Referência