Acompanhamento da Feature

Integração API Títulos - BMAC Method

Painel de leitura da documentação, planejamento e implementação por feature, com seleção centralizada antes da navegação.

Progresso Total da Feature
Feature `integracao-api-titulos`
1 concluídas, 0 em review, 0 prontas para dev, 0 ainda não iniciadas.
Andamento estimado
100%
Próximos Passos
BMAC Nenhum próximo passo automático identificado com o estado atual dos artefatos.
Filtros de Stories
docs/manual-metas-premios.md

Manual de uso: Metas e Prêmios

DOCS MD

Manual de uso: Metas e Prêmios

O que esta tela faz

Esta tela permite:

  • cadastrar metas mensais da operação
  • informar o valor da meta, o valor atingido e o prêmio associado
  • editar metas já cadastradas
  • excluir metas quando necessário
  • consultar o histórico das metas já registradas
  • solicitar uma sugestão automática de nova meta para um mês e ano alvo

Quando usar

Use esta tela quando a gerência precisar:

  • criar a meta de um novo mês
  • ajustar uma meta já cadastrada
  • revisar valores de prêmio por meta atingida
  • consultar o histórico de metas anteriores
  • obter uma sugestão inicial de meta antes da definição final

Como usar

1. Consultar metas já cadastradas

Ao abrir a tela, a tabela principal mostra:

  • mês
  • ano
  • valor da meta
  • valor atingido
  • prêmio
  • ações disponíveis

Use essa grade para revisar rapidamente o histórico já salvo.

2. Criar uma nova meta

Para cadastrar uma nova meta:

  1. clique em + Nova Meta
  2. preencha o formulário do modal
  3. informe:
    • Mês
    • Ano
    • Meta (R$)
    • Valor Atingido (R$), se já existir valor parcial ou final
    • Prêmio Meta Atingida (R$)
  4. clique em Salvar Meta

3. Editar uma meta existente

Na coluna Ações, use a opção de edição para:

  • corrigir valor da meta
  • atualizar valor atingido
  • ajustar prêmio do mês

Depois de editar, salve novamente para persistir a alteração.

4. Excluir uma meta

Na coluna Ações, use a opção de exclusão quando a meta tiver sido criada de forma indevida.

Faça isso somente quando houver certeza, para não apagar um histórico válido do mês.

5. Usar a sugestão de meta (IA)

Na seção Sugerir Nova Meta (IA):

  1. escolha o Mês Alvo
  2. escolha o Ano Alvo
  3. clique em Sugerir Meta

O sistema retorna:

  • Valor Sugerido
  • Justificativa textual para apoiar a análise gerencial

Como interpretar a sugestão

A sugestão automática serve como apoio à decisão, não como fechamento definitivo.

Ela deve ser usada como referência inicial para:

  • discutir a meta do período
  • comparar com comportamento histórico
  • calibrar expectativa de resultado
  • documentar o racional preliminar da meta

Regras importantes

Regra de acesso

Esta tela é destinada ao perfil de gerência.

Usuários sem esse perfil não devem acessar nem alterar metas.

Regra do cadastro mensal

Cada meta representa um período mensal específico, identificado por:

  • mês
  • ano

Antes de cadastrar, confirme se o período já não existe na base.

Regra do prêmio

O campo Prêmio Meta Atingida representa o valor adicional previsto quando a meta do período for alcançada.

Esse valor deve ser coerente com a política vigente da operação.

Regra do valor atingido

O campo Valor Atingido pode ser utilizado para acompanhar o desempenho do mês ou para registrar o valor consolidado final.

Regra da sugestão automática

A sugestão gerada pela IA:

  • não substitui aprovação gerencial
  • não grava meta automaticamente
  • não altera cadastro sem ação explícita do usuário

Ela apenas apresenta uma proposta inicial com justificativa.

Boas práticas

  • valide mês e ano antes de salvar
  • use a sugestão automática como apoio, não como decisão final isolada
  • revise prêmio e valor da meta antes da confirmação
  • mantenha a base de metas organizada, sem duplicidade de período
  • evite excluir registros históricos válidos

Dúvidas comuns

1. A sugestão de meta grava automaticamente?

Não. A sugestão apenas exibe um valor recomendado e uma justificativa. O cadastro continua sendo manual.

2. Posso ajustar o ano da sugestão?

Sim. A tela permite escolher o mês alvo e o ano alvo antes de solicitar a sugestão.

3. Posso cadastrar a meta sem informar valor atingido?

Sim. O valor atingido pode começar em zero e ser atualizado depois, conforme a operação evoluir.

4. O prêmio é obrigatório?

Depende da política da operação. A tela permite registrar o prêmio para o mês, mas o preenchimento deve seguir a regra gerencial vigente.

Resumo rápido

  • + Nova Meta: abre o formulário de cadastro
  • Salvar Meta: grava ou atualiza o registro
  • Ações: permite editar ou excluir
  • Sugerir Meta: gera um valor sugerido com justificativa
  • ícone de ajuda: abre este manual diretamente na Central de Ajuda