Orçamento

Código Aberto — O GitScrum MCP Server é código aberto sob a licença MIT. Disponível no npm e no GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor e qualquer cliente compatível com MCP têm acesso operacional completo à sua stack de gerenciamento de projetos.

A ferramenta budget fornece 6 ações para acompanhar e gerenciar orçamentos de projetos diretamente através do seu assistente de IA. Monitore gastos em relação às alocações, receba alertas quando orçamentos se aproximam dos limites, identifique projetos em risco antes que excedam os limites e gere previsões financeiras — tudo sem sair da sua IDE ou cliente de IA.

O gerenciamento de orçamento no GitScrum conecta dados financeiros com métricas de entrega. Quando combinado com controle de tempo e análises, a ferramenta de orçamento dá a equipes e gerentes uma visão completa da economia do projeto: quanto foi planejado, quanto foi gasto e se o projeto está no caminho financeiramente.

Visão Geral das Ações

Obtendo Detalhes do Orçamento

A ação get recupera o status atual do orçamento de um projeto específico — orçamento total, valor gasto, saldo restante, moeda e percentual de utilização. Esta é a ação principal para verificar as finanças individuais de projetos.

Parâmetros

You:  "Qual é o status do orçamento do projeto Alpha?"
AI:   Chama budget action=get → retorna orçamento total, gasto, restante e % de utilização

You:  "Quanto de orçamento resta no projeto Backend?"
AI:   Chama budget action=get → "Projeto Backend: $45.000 de $120.000 gastos.
       $75.000 restantes (37,5% utilizado)"

You:  "Estamos dentro do orçamento no projeto Mobile App?"
AI:   Chama budget action=get → AI compara gasto vs. total e reporta o status

Atualizando Orçamentos

A ação update modifica parâmetros do orçamento de um projeto. Você pode atualizar a alocação total do orçamento, registrar gastos ou alterar a moeda. Isso permite que gerentes ajustem orçamentos conforme o escopo do projeto evolui.

Parâmetros Obrigatórios

Parâmetros Opcionais

You:  "Defina o orçamento do projeto Backend para $150.000"
AI:   Chama budget action=update com total_budget=150000
      → "Orçamento atualizado: projeto Backend definido para $150.000"

You:  "Atualize os gastos do projeto Mobile App para $67.500"
AI:   Chama budget action=update com spent=67500
      → "Orçamento atualizado: gastos do Mobile App definidos para $67.500"

You:  "Mude a moeda do orçamento do projeto Alpha para EUR"
AI:   Chama budget action=update com currency="EUR"
      → "Orçamento atualizado: moeda do projeto Alpha definida para EUR"

You:  "Aumente o orçamento do projeto Backend em $25.000"
AI:   Chama budget action=get → total atual é $150.000
      → Chama budget action=update com total_budget=175000
      → "Orçamento atualizado: projeto Backend aumentado para $175.000"

Resumo de Orçamento

A ação summary retorna uma visão consolidada de orçamento de todos os projetos no workspace. Dá aos gerentes uma visão única dos gastos organizacionais — total alocado, total gasto, total restante e breakdowns por projeto.

Parâmetros

You:  "Mostre o resumo de orçamento de todos os projetos"
AI:   Chama budget action=summary → retorna visão geral de orçamento do workspace

You:  "Quanto gastamos em todos os projetos?"
AI:   Chama budget action=summary → "Total gasto: $234.500 de $500.000 alocados
       em 8 projetos (46,9% utilizado)"

You:  "Qual projeto tem a maior utilização de orçamento?"
AI:   Chama budget action=summary → AI classifica projetos por percentual de utilização

Alertas de Orçamento

A ação alerts retorna projetos que estão se aproximando ou excedendo um limite de gastos. Por padrão, sinaliza projetos com 80% de utilização, mas você pode definir um limite personalizado para corresponder à tolerância de risco da sua organização.

Parâmetros

You:  "Tem algum alerta de orçamento?"
AI:   Chama budget action=alerts → retorna projetos acima do limite de 80%

You:  "Defina o limite de alerta de orçamento para 90% e mostre os alertas"
AI:   Chama budget action=alerts com threshold=90
      → retorna projetos acima de 90% de utilização

You:  "Quais projetos estão chegando perto dos limites de orçamento?"
AI:   Chama budget action=alerts com threshold=75
      → "3 projetos acima de 75%: Mobile App (92%), Backend (81%), API v3 (78%)"

You:  "Avise-me sobre qualquer projeto acima de 50% de utilização de orçamento"
AI:   Chama budget action=alerts com threshold=50
      → retorna todos os projetos que excederam metade do orçamento

Projetos em Risco

A ação at_risk identifica especificamente projetos que excederam sua alocação orçamentária — gastos são maiores que o orçamento total. Esta é a ação de alerta crítico para supervisão financeira.

Parâmetros

You:  "Quais projetos estão acima do orçamento?"
AI:   Chama budget action=at_risk → retorna projetos que excederam sua alocação

You:  "Tem algum projeto em dificuldade financeira?"
AI:   Chama budget action=at_risk → "2 projetos acima do orçamento:
       - Mobile App: $98.000 gastos de $85.000 (115%)
       - Migração Legacy: $42.000 gastos de $40.000 (105%)"

You:  "Mostre projetos que precisam de atenção imediata no orçamento"
AI:   Chama budget action=at_risk → AI lista projetos acima do orçamento com valores excedentes

Previsão de Orçamento

A ação forecast projeta gastos futuros baseada na taxa de queima atual e cronograma do projeto. Estima se o projeto ficará dentro do orçamento, quando o orçamento se esgotará e o gasto total projetado na conclusão.

Parâmetros

You:  "Mostre a previsão de orçamento do projeto Backend"
AI:   Chama budget action=forecast → retorna gasto projetado, estimativa de conclusão
       e data de esgotamento do orçamento

You:  "O projeto Mobile App vai ficar dentro do orçamento?"
AI:   Chama budget action=forecast → "Na taxa de queima atual de $12.000/semana,
       o projeto Mobile App excederá seu orçamento de $85.000 em aproximadamente 2 semanas"

You:  "Qual é o custo total projetado para o projeto Alpha?"
AI:   Chama budget action=forecast → retorna gasto total estimado na conclusão

Fluxo de Trabalho de Supervisão Financeira

A ferramenta de orçamento permite gerenciamento financeiro proativo. Aqui está um fluxo de trabalho típico para gerentes e líderes de projeto:

1. Revisão semanal de orçamento

Verifique a saúde financeira geral de todos os projetos.

You:  "Me dê a visão geral de orçamento desta semana"
AI:   Chama budget action=summary → snapshot financeiro do workspace
      Chama budget action=alerts → projetos se aproximando dos limites
      Chama budget action=at_risk → projetos já acima do orçamento
      → Relatório consolidado de status financeiro

2. Investigue projetos sinalizados

Aprofunde em projetos que dispararam alertas.

You:  "Por que o projeto Mobile App está acima do orçamento?"
AI:   Chama budget action=get → breakdown detalhado do orçamento
      Chama budget action=forecast → trajetória projetada
      → "Mobile App está em 115% de utilização. Na taxa de queima atual,
         o projeto precisa de $15.000 adicionais para ser completado"

3. Ajuste orçamentos conforme necessário

Atualize alocações baseado nas descobertas.

You:  "Aumente o orçamento do Mobile App para $100.000"
AI:   Chama budget action=update com total_budget=100000
      → "Orçamento atualizado. Mobile App agora em 98% de utilização de $100.000"

4. Defina limites de monitoramento

Estabeleça limites de alerta para aviso antecipado.

You:  "Alerte-me quando qualquer projeto exceder 70% do orçamento"
AI:   Chama budget action=alerts com threshold=70
      → "5 projetos acima de 70%: [lista com percentuais de utilização]"

Gerenciamento Proativo de Orçamento

Combine dados de orçamento com outras ferramentas MCP para uma visão completa da economia dos projetos:

• Orçamento + Controle de Tempo. Compare custos baseados em tempo com utilização de orçamento. Use time action=reports com taxas horárias junto com budget action=get para verificar se horas faturadas registradas estão alinhadas com registros de gastos.

• Orçamento + Análises. Correlacione tendências de velocidade com taxa de queima. Se a velocidade está declinando enquanto os gastos permanecem constantes, o custo por ponto está aumentando — um indicador precoce de risco orçamentário.

• Orçamento + Sprints. Divida o orçamento total pelas sprints restantes para calcular a alocação de orçamento por sprint. Compare com custos reais de sprint derivados de dados de controle de tempo.

• Orçamento + Atividade. Monitore eventos de atividade relacionados a orçamento para rastrear quem autorizou mudanças de gastos e quando orçamentos foram ajustados pela última vez.

You:  "Compare nossa taxa de queima com a velocidade do projeto Backend"
AI:   Chama budget action=get → dados de gastos
      Chama analytics action=get report="velocity" → taxa de entrega
      → "Backend está gastando $15.000/sprint entregando 32 pontos.
         Custo por ponto: $469. Sprint passada foi $521/ponto — aumento de 11%"

Suporte a Moedas

Valores de orçamento suportam múltiplas moedas. Defina a moeda por projeto usando a ação update com o parâmetro currency. Todos os relatórios de orçamento respeitam a moeda configurada do projeto e exibem valores de acordo.

Formatos de moeda suportados seguem códigos ISO 4217: USD, EUR, GBP, BRL, CAD, AUD, JPY e outros suportados pela plataforma GitScrum.

Próximos Passos

• Análises: Acesse relatórios de saúde e desempenho do projeto junto com dados financeiros.
• Atividade: Monitore alterações incluindo eventos relacionados a orçamento.
• Standup: Revise o progresso diário da equipe junto com utilização de orçamento.
• Controle de Tempo: Acompanhe horas faturáveis que impulsionam o consumo de orçamento.