/contratos · "Painel" (primeiro item do menu lateral; é a tela que abre ao entrar no módulo para quem tem "Ver o painel")contratos.bi ("Ver o painel") — o item do menu, a tela e o banco (bi_painel: "Sem permissão para ver o painel de contratos (chave "Ver o painel")") conferem a mesma chave; quem não a tem entra no módulo pela lista de Contratos. Os números contam só os contratos que a pessoa enxerga (contratos de gestão que gerencia, ou todos com contratos.visualizar_todos, mais os contratos em que é fiscal ou gestor).Para que serve
É o retrato da carteira de contratos: quantos estão vigentes, quanto está comprometido, o que vence nos próximos 30/60/90 dias, quanto do saldo dos itens já foi consumido e quais itens estão acabando. Serve a duas perguntas diferentes — quem administra contrato quer saber o que vence; quem compra quer saber o que está acabando — e cada um escolhe os indicadores que ficam à vista. Nada aqui se altera: é só leitura. Tudo vem numa consulta só; trocar o tipo de gráfico não volta ao servidor.
A tela, marcação por marcação
As figuras abaixo mostram a tela como ela aparece para quem usa. Os números em vermelho marcam os botões e campos; logo abaixo de cada figura, cada número é explicado: onde fica, o que faz e o que acontece depois.
Visão geral da tela

- Onde fica: último cartão da régua (tracejado, ícone de ajustes).
- O que faz: abre a janela "Quais indicadores ficam à vista".
- Onde fica: último ícone da fila de cada gráfico.
- O que faz: baixa um CSV com o rótulo e o valor de cada ponto do gráfico.
Como a tela está organizada (de cima para baixo)
- Filtro "Contrato de gestão" (alto, à esquerda; lista com busca "Contrato de gestão Todos os contratos de gestão") — "Todos os contratos de gestão" ou um deles. Enquanto busca, aparece "Carregando…" ao lado.
- Régua de indicadores — cartões em grade (4 por linha no computador). Cada cartão: ícone colorido, título, número grande, uma linha de detalhe e uma seta. Por padrão: "Contratos vigentes", "Valor contratado", "Vencidos", "Vencem em 30 dias", "Consumido", "Itens acabando", "Itens esgotados", "Com saldo por item". O último cartão (tracejado) é "Escolher indicadores".
- Detalhe do indicador clicado (abre logo abaixo da régua) — título e número grande; "Como este número é apurado"; "Composição" (tabela); "O que fazer" (caixa laranja, só quando há algo a fazer); à direita, os gráficos do assunto; botão "Fechar".
- Gráficos (duas colunas no computador): "Valor contratado por contrato de gestão", "Consumo por contrato de gestão", "Fornecedores por valor contratado", "Consumo mês a mês", "Contratos a vencer por mês", "Itens por faixa de consumo", "Itens mais consumidos", "Situação dos contratos", "Critério de julgamento", "Tipo de controle".
- Duas listas lado a lado:
- "Itens perto do fim do saldo" — contrato (com o fornecedor embaixo), item, saldo (com "+ N autorizados" em laranja quando houve autorização de estouro, ou "estouro sem autorização" em vermelho) e o consumo em % (vermelho a partir de 90%, laranja abaixo). Vazia: "Nenhum item acima de 75% do saldo."
- "Contratos a vencer" — "Primeiro os que vencem nos próximos seis meses (até 25, do mais próximo ao mais distante); depois os já vencidos ainda marcados como vigentes (até 25, do mais recente ao mais antigo)." Colunas: contrato, fornecedor, "Vence em" (selo: "vencido há Nd" vermelho, "N dias" laranja até 30, cinza depois; a data embaixo) e valor. Vazia: "Nenhum contrato vence nos próximos seis meses e nenhum vigente está vencido."
- "Aditivos por finalidade" (último gráfico, só quando há aditivo) — quantos aditivos mexeram em prazo, quantidade e valor, mês a mês.
Cada barra do gráfico de contrato de gestão usa a cor que o Compras deu àquele contrato de gestão.
Os indicadores (o que cada um conta)
| Indicador | O que conta | "O que fazer" aparece quando |
|---|---|---|
| Contratos vigentes | Assinados com fim de vigência ainda não passado (contando o prazo esticado por aditivo). Detalhe: "N no total" | — |
| Valor contratado | Soma do valor atual (assinado + aditivos de valor e quantidade − supressões) dos contratos vigentes — encerrados e rescindidos não entram. Detalhe: "inicial R$ …" | Os aditivos passam de 25% do valor assinado: acréscimo além do limite legal pede processo novo |
| Vencidos | Fim de vigência passado sem encerrar nem prorrogar e sem "ciente — não será renovado" (enquanto isso não se emite ordem nem se atesta contra eles) | Há vencidos: encerrar com o saldo apurado ou substituir por contratação nova |
| Vencem em 30 / 60 / 90 dias | Vigentes com fim nessa janela | 30 dias: o aditivo de prazo tem de estar assinado antes do último dia |
| Com saldo por item | Contratos que trouxeram a planilha de itens e baixam saldo a cada ordem ("controlam quantidade, não só prazo") | — |
| Itens contratados | Linhas das planilhas de itens dos contratos vigentes que controlam quantidade | — |
| Consumido | Quanto as ordens já baixaram, pelo preço do contrato ("N% do contratado"). Não é pagamento: é saldo consumido | Passou de 90% do saldo: começar o aditivo ou o processo novo |
| Vencido (fora do "Consumido") | Saldo de período anterior que venceu numa prorrogação com renovação da quantidade. Não entra em "Consumido", em "Consumo mês a mês" nem em "Itens mais consumidos"; o percentual de consumo do item é o do período vigente | Ver o que venceu na tela do contrato, aba "Itens e saldo", coluna "Vencido" |
| Itens acabando | Itens com 90% ou mais consumido e ainda com sobra (a lista "Itens perto do fim do saldo" começa em 75%) | Há itens: comparar o consumo com o prazo que resta |
| Itens esgotados | Saldo zerado: nenhuma ordem nova contra a linha. A composição separa "passaram do contratado com autorização registrada" e "sem autorização" | Há itens: aditivo de quantidade ou processo novo |
Situações
| Situação | Como aparece | O que se pode fazer |
|---|---|---|
| Carregando | "Carregando…" ao lado do filtro | Esperar |
| Erro na consulta | Caixa vermelha "Não foi possível carregar o painel: <motivo>" (a tela inteira vira só essa caixa) | Recarregar; se persistir, avisar o suporte |
| Sem dados num gráfico | "Ainda não há dados para este período." dentro do cartão | — |
Botões
Os botões marcados nas figuras estão explicados junto de cada figura (seção “A tela, marcação por marcação”). A seguir, os demais botões desta tela — os que só aparecem em outras situações —, com o que fazem e onde ficam.
Cartão de indicador (ao passar o mouse: Abrir o detalhe deste indicador)
- Onde fica: régua de indicadores.
- O que faz: abre (ou fecha, se clicado de novo) o detalhe logo abaixo da régua, com a explicação, a composição e os gráficos daquele assunto.
"Fechar" (no detalhe do indicador)
- Onde fica: canto superior direito do detalhe aberto.
- O que faz: fecha o detalhe.
Botões de tipo de gráfico (no alto de cada gráfico)
- Onde fica: fila de ícones à direita do título de cada gráfico.
- O que faz: redesenha a mesma série como "Colunas", "Barras horizontais", "Linha", "Área", "Pizza", "Rosca, com o total no meio", "Pareto — os poucos que respondem pela maior parte", "Mapa de área — a fatia de cada um", "Radar — o perfil em todas as frentes", "Funil — o que entra e o que sobra em cada etapa" ou "Dispersão". O tipo escolhido fica marcado (botão cheio).
Janelas
"Quais indicadores ficam à vista"

"Voltar ao padrão" (os 8 do padrão)
- Botões: "Voltar ao padrão" (os 8 do padrão) · "Pronto".
- Abre por: "Escolher indicadores".
- Mostra: "A escolha vale só para você e fica guardada neste navegador…" e uma caixa de marcar para cada indicador (Contratos vigentes, Valor contratado, Vencidos, Vencem em 30 dias, Vencem em 60 dias, Vencem em 90 dias, Com saldo por item, Itens contratados, Consumido, Itens acabando, Itens esgotados).
- Botões: "Voltar ao padrão" (os 8 do padrão) · "Pronto".
- Regras: marcar/desmarcar já muda a régua; a escolha fica neste navegador (outro computador mostra o padrão).
Perguntas que as pessoas fazem
- O "Consumido" é o que já foi pago? → não. É o saldo que as ordens e os consumos baixaram dos itens, pelo preço do contrato. Pagamento é no Financeiro.
- Por que um contrato vencido aparece em "Contratos a vencer"? → a lista mostra os vigentes que vencem nos próximos seis meses e também os já vencidos ("vencido há Nd") para não sumirem de vista. São duas partes: até 25 que ainda vão vencer (os mais próximos primeiro) e, depois, até 25 vencidos (os mais recentes primeiro) — os vencidos não tiram da lista os que vão vencer. A lista completa está nas abas "A vencer" e "Vencidos e encerrados" da tela Contratos.
- O painel mostra só alguns contratos de gestão. → conta o que você enxerga: os contratos de gestão que você gerencia (ou todos, com a chave de ver todos) e os contratos de que é fiscal ou gestor.
- Troquei os indicadores e no outro computador voltou ao padrão. → a escolha fica guardada só no navegador em que foi feita.
- "Estouro sem autorização" — o que é? → o item consumiu mais do que o contratado sem autorização registrada. Faça o aditivo de quantidade.
Ligações com outros módulos e telas
- Contratos (/contratos/contratos) — a lista que estes números resumem.
- Aditivos e documentos (/contratos/aditivos) — onde se resolve o que vence e o que acaba.
- Pontos de atenção (/contratos/alertas) — garantias, sanções, cronograma e glosas que pedem ação.
- Gestão de Materiais — as ordens de compra são o que baixa o saldo ("Consumido").
- Compras — a cor de cada contrato de gestão vem do cadastro de lá.