Orçamento de tempo do plano de aula
Uma aula de 50 minutos com aquecimento, explicação, prática guiada e tíquete de saída com pesos 1, 3, 4 e 2 vira 5, 15, 20 e 10 minutos. Você define quanto cada parte importa e os minutos sempre somam a duração da aula. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Duração (min)
- 50
- Quantidade de atividades
- 4
- Soma dos pesos
- 10
- Minutos
- 5, 15, 20, 10
Professores, formadores pedagógicos e plataformas de currículo enfrentam sempre a mesma pergunta de planejamento: se esta aula tem cinquenta minutos, quantos minutos devem caber ao aquecimento, à instrução direta, à prática guiada e ao bilhete de saída? Pesos relativos capturam a intenção melhor do que adivinhar números absolutos: um bloco pode merecer o dobro de atenção de outro sem que ninguém saiba ainda o repasse final em minutos. Esta calculadora de orçamento de tempo do plano de aula aceita uma duração total positiva em minutos mais uma lista ordenada de atividades nomeadas com pesos relativos não negativos e devolve minutos proporcionais por linha de modo que as partes somem o comprimento da aula.
Como funciona a alocação proporcional de tempo
Um orçamento de tempo do plano de aula trata o período como uma torta fixa e cada atividade planejada como uma fatia cujo tamanho é definido por um peso relativo, e não por um chute absoluto de minutos. Pesos iguais produzem minutos iguais; um peso dois ao lado de um peso um significa o dobro de duração, quer você escreva 2 e 1 ou 10 e 5.
Essa invariância de escala é útil quando a equipe negocia prioridades primeiro e só depois trava o horário do sinal: mude D de quarenta e cinco para sessenta e cada parte escala sem redigitar pesos. Peso zero é permitido em uma linha que você queira manter no plano como marcador nomeado que não recebe tempo nesta passagem; o que não se permite é todos os pesos serem zero, porque a divisão por uma soma nula é indefinida.
Pesos negativos são rejeitados porque uma fatia negativa do período não tem sentido em sala.
Casos de uso
Planejamento de blocos e horário do sinal
Realoque minutos de aquecimento, instrução, prática e bilhete de saída quando a duração do período mudar, mantendo os mesmos pesos relativos de atividade.
Modelos de coaching e observação
Gere cotas de minutos e percentuais planejados para formulários de observação a fim de que o coach compare o tempo de fala previsto com o relógio.
Automação LMS e de ritmo curricular
Chame o mesmo orçamento de tempo ponderado a partir de APIs de boletim ou currículo para que modelos e planejadores humanos não divirjam nos totais de minutos.
Perguntas frequentes
Como os minutos são alocados entre as atividades?
Pesos iguais dão minutos iguais; o dobro de peso dá o dobro de tempo. Os minutos devolvidos somam a duração total.
Uma atividade pode ter peso zero?
Sim. Uma linha com peso zero mantém o nome no plano, mas recebe zero minutos. Se todos os pesos forem zero, a solicitação falha porque a soma dos pesos dividiria por zero.
Preciso de minutos absolutos por atividade de antemão?
Não. Informe pesos relativos e uma única duração total. Altere a duração depois e execute de novo para escalar cada atividade sem reescrever a estrutura do plano.
O que acontece se a duração da aula mudar?
Mantenha os mesmos pesos e mude só o total. Cada atividade acompanha na mesma proporção, então uma aula mais longa ou mais curta mantém a divisão sem redigitar nada, e pesos 2 e 1 equivalem a 10 e 5.
Os minutos sempre somam exatamente a duração da aula?
Sim. Dividir por pesos pode deixar uma pequena sobra de arredondamento, e essa sobra vai para a última atividade com peso maior que zero, então as partes sempre somam a aula informada.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/edu/lesson-plan-time-budget \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"duration_minutes":50,"activities":[{"name":"Warm-up","weight":1},{"name":"Direct instruction","weight":3},{"name":"Guided practice","weight":4},{"name":"Exit ticket","weight":2}]}'const res = await fetch("https://api.kit.forhosting.com/edu/lesson-plan-time-budget", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"duration_minutes": 50,
"activities": [
{
"name": "Warm-up",
"weight": 1
},
{
"name": "Direct instruction",
"weight": 3
},
{
"name": "Guided practice",
"weight": 4
},
{
"name": "Exit ticket",
"weight": 2
}
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/edu/lesson-plan-time-budget",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"duration_minutes": 50,
"activities": [
{
"name": "Warm-up",
"weight": 1
},
{
"name": "Direct instruction",
"weight": 3
},
{
"name": "Guided practice",
"weight": 4
},
{
"name": "Exit ticket",
"weight": 2
}
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/lesson-plan-time-budget", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"duration_minutes":50,"activities":[{"name":"Warm-up","weight":1},{"name":"Direct instruction","weight":3},{"name":"Guided practice","weight":4},{"name":"Exit ticket","weight":2}]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"duration_minutes":50,"activities":[{"name":"Warm-up","weight":1},{"name":"Direct instruction","weight":3},{"name":"Guided practice","weight":4},{"name":"Exit ticket","weight":2}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/lesson-plan-time-budget", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"duration_minutes": 50,
"activities": [
{
"name": "Warm-up",
"weight": 1
},
{
"name": "Direct instruction",
"weight": 3
},
{
"name": "Guided practice",
"weight": 4
},
{
"name": "Exit ticket",
"weight": 2
}
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.lesson_plan_time_budget",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Duração não positiva e soma de pesos zero falham com invalid_input em vez de inventar um horário.
Como funciona a alocação proporcional de tempo
Se duration_minutes é D e a atividade i tem peso w_i, os minutos alocados são D vezes w_i dividido pela soma de todos os pesos. Após a multiplicação proporcional, o arredondamento em ponto flutuante pode deixar um resíduo mínimo de modo que os minutos limpos não somem exatamente D; este endpoint absorve esse resíduo na última atividade com peso positivo para que o array minutes seja sempre uma partição da duração pedida. A resposta também informa share_ratio e percent por atividade para que painéis grafiquem o mesmo rateio sem recalcular a soma dos pesos.
Contrato de entrada, formato da resposta e erros
O campo activities é um array não vazio de objetos, cada um com uma string name não vazia e um weight numérico finito não negativo. Nesta rota parse gratuita aceitam-se até cem atividades. Um array paralelo minutes respeita a ordem de entrada para scripts que só precisam da alocação numérica. Checagens clássicas de sala incluem um bloco de cinquenta minutos com pesos um, três, quatro e dois para aquecimento, instrução direta, prática guiada e bilhete de saída, que produz cinco, quinze, vinte e dez minutos respectivamente. Ligue o formulário gratuito do navegador a um quadro de planejamento para uso humano e chame o mesmo contrato de um serviço de boletim ou guia de ritmo quando a automação precisar dos mesmos números. Envie por POST um corpo JSON com dois campos obrigatórios. O campo duration_minutes é um número finito estritamente maior que zero que representa a duração total da aula em minutos; zero e valores negativos falham com invalid_input nomeando o campo. Campos ausentes, listas vazias, linhas que não são objeto, nomes em branco, números não finitos, pesos negativos e soma de pesos zero falham com invalid_input e não são cobrados. Em sucesso o corpo ecoa duration_minutes, informa activity_count e weight_sum e devolve um array activities de objetos com index, name, weight, share_ratio, minutes e percent. Method é weighted_time_budget e formula reafirma que minutes_i é duration_minutes vezes weight_i sobre a soma dos pesos. Chamadas API bem-sucedidas usam o preço base publicado US$ 0,002 por item; falhas de validação não consomem saldo pré-pago.
Onde uma API de orçamento de tempo de aula vale a pena
Equipes de design instrucional usam uma calculadora de orçamento de tempo do plano de aula para que modelos multiperíodo permaneçam coerentes quando o distrito encurta ou alonga o horário do sinal: mantenha os mesmos pesos relativos e execute de novo com o novo duration_minutes. Ferramentas de coaching embutem o endpoint para que um formulário de observação mostre se a cota planejada de fala do aluno bateu com o relógio observado, usando percent e minutes de uma única fonte da verdade. Construtores de ed-tech evitam enviar seus próprios casos-limite de ponto flutuante —duração zero, todos os pesos zero, arredondamento residual— porque esses caminhos já estão cobertos por invalid_input determinístico ou absorção de resíduo.
Perguntas técnicas
E se a duração total da aula for zero ou negativa?
A tarefa falha com invalid_input. duration_minutes deve ser um número finito estritamente maior que zero; totais não positivos não são cobrados.
Quanto custa a calculadora de orçamento de tempo do plano de aula?
A ferramenta do navegador é gratuita. Pedidos API usam saldo pré-pago KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.