docs/manual-metas-premios.md
Manual de uso: Metas e Prêmios
DOCS
MD
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
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.
Para cadastrar uma nova meta:
- clique em + Nova Meta
- preencha o formulário do modal
- informe:
- Mês
- Ano
- Meta (R$)
- Valor Atingido (R$), se já existir valor parcial ou final
- Prêmio Meta Atingida (R$)
- clique em Salvar Meta
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.
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.
Na seção Sugerir Nova Meta (IA):
- escolha o Mês Alvo
- escolha o Ano Alvo
- 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:
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
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.
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