✕ Fechar

📊 Manual — Relatórios do Field Service

RGM, Cronograma anual, Consumo de Fluido Refrigerante e PMOC — o que cada um é e como tirar.

Nesta página:

1. RGM — Relatório Gerencial Mensal

É a prestação de contas do mês para o cliente: o que foi atendido, dentro do prazo (SLA), por qual técnico e em qual equipamento.

  1. Acesse Field Service → 📊 Relatório Gerencial Mensal (RGM) (tela /fs/rgm).
  2. Escolha o contrato (ou "Consolidado" para ver todos juntos) e a competência (mês/ano) — ou um período personalizado.
  3. Clique em 🔍 Analisar para pré-visualizar os números antes de gerar.
  4. Clique em 📄 Gerar rascunho — o relatório fica travado (fotografia daquele momento) em RASCUNHO.
  5. Revise, ajuste as observações da gestão se quiser, e clique em Liberar — vira LIBERADO.
  6. Envie por e-mail ao cliente (botão Enviar) — vira ENVIADO.

O que o RGM mostra

AbaO que você vê
Por equipamentoQuantos chamados, quantas corretivas, MTTR (tempo médio de reparo) e se o equipamento é reincidente.
Por técnicoOS atendidas, tempo médio de execução, % de SLA cumprido e km rodados.
Por contratoSó aparece no modo "Consolidado" — compara os contratos entre si.
Checklist/causasItens que deram não conformidade e as causas-raiz mais frequentes do período.
Cronograma anualA grid de periodicidade — veja a seção 2 abaixo.
⚠️ Depois de gerado, o RASCUNHO é uma fotografia do período — se novas OS forem concluídas depois, elas não entram automaticamente. Gere de novo se precisar atualizar.
x
Motor: lib/fs/rgm.js computarRgm() — lê FsOrdemServico + alocações + respostas de checklist + FsExecucaoPreventiva no período informado. O snapshot fica congelado em FsRgmRelatorio.dadosJson. Existe também fechamento automático por contrato (dia do mês configurável, avisa por e-mail) na seção "Fechamento automático" da mesma tela.

2. Cronograma anual de manutenção preventiva

É a grade equipamento × mês — de olhar rápido, mostra em quais meses cada equipamento tem manutenção prevista (e se ela já foi feita).

  1. Dentro do RGM (/fs/rgm), clique em 🔍 Analisar com o contrato escolhido.
  2. Clique na aba "Cronograma anual" (a última, ao lado de "Checklist / causas").
  3. Cada linha é um plano de preventiva ativo daquele equipamento; cada coluna é um mês do ano.

Como ler as cores e os códigos

Fundo verde = a manutenção foi executada naquele mês (existe registro real). Fundo lilás = a manutenção está prevista/agendada para aquele mês (projeção, ainda não aconteceu). Célula vazia (·) = sem previsão naquele mês.

CódigoPeriodicidade
DDiário
2DA cada 2 dias
SMSemanal
QZQuinzenal
MSMensal
BMBimestral
TRTrimestral
QDQuadrimestral
SESemestral
ANAnual
HPor horas de uso do equipamento (não por calendário)
PTPontual / sem cadência definida
💡 O código é calculado sozinho a partir da cadência em dias cadastrada no plano de preventiva do equipamento — você não escolhe a letra, ela nasce da configuração.
x
periodicidadeLabel() converte FsPlanoPreventiva.cadenciaDias num código curto; mesesAgendados() simula (stepping de data, a partir da próxima/última execução) em quais meses do ano cai uma ocorrência; execuções reais (FsExecucaoPreventiva) sobrepõem a projeção com o selo "executado". É uma projeção visual, não a agenda oficial de disparo de OS (essa é o job de preventiva do sistema).

3. Consumo de Fluido Refrigerante

Controle de recarga, retirada e vazamento de gás refrigerante — pensado para clientes com controle ambiental mais sério (ex.: relato ao Protocolo de Montreal), que precisam saber quanto Kg de gás foi usado por setor e por tipo, ano a ano.

Como o técnico registra (pela OS)

  1. No app do técnico, abra a OS e role até "🧊 Consumo de fluido refrigerante".
  2. Toque em Registrar consumo de fluido.
  3. Escolha o tipo de evento (Recarga / Retirada / Vazamento detectado), o tipo de gás (R22, R32, R134A, R404A, R407C, R410A, R437A ou Outro) e a quantidade em Kg.
  4. Salve — funciona mesmo sem internet: o registro entra numa fila e sincroniza quando a conexão voltar.

Como a gestão vê o relatório anual

  1. Acesse Field Service → 🧊 Consumo de Fluido Refrigerante (tela /fs/fluidos).
  2. Escolha o ano e clique em 🔍 Gerar relatório.
  3. A grid mostra setor × tipo de gás × mês, em Kg, com o total do ano.
  4. Use 🖨️ Imprimir / PDF para exportar (ex.: para anexar num relatório de sustentabilidade).
  5. Também dá para lançar manualmente (botão + Lançar consumo) — útil quando a informação vem de uma nota fiscal do fornecedor de gás, não de uma OS.
💡 O setor vem do cadastro do equipamento (Field Service → Equipamentos → campo "Setor"). Preencher esse campo é o que faz o relatório agrupar corretamente.
✅ Como o cálculo funciona: recarga e vazamento somam ao consumo do período; retirada abate — o total reflete o saldo líquido movimentado.
x
Model FsRegistroFluido (empresaId, osId?, equipamentoId?, setor snapshot, tipoGas, tipoEvento, quantidadeKg, dataEvento). Endpoint de captura offline-safe: POST /api/fs/app/os/:id/fluido (mesmo padrão do QAI). Relatório: GET /api/fs/fluidos/relatorio-anual?ano=.

4. PMOC — Plano de Manutenção, Operação e Controle

Diferente do RGM (que é um relatório do que já foi feito), o PMOC é o documento formal do que está planejado — exigido pela Portaria MS nº 3.523/1998 para sistemas de climatização. É gerado uma vez por ano, por contrato.

  1. Na tela do RGM (/fs/rgm), selecione um contrato específico (o PMOC não funciona em "Consolidado" — é sempre de um contrato só).
  2. Clique em 📋 Gerar PMOC (Blodoc).
  3. Preencha o ano de referência e os dados do Responsável Técnico (nome, CREA, número da ART).
  4. Clique em Gerar — o documento abre em uma nova aba, já dentro do Blodoc.
  5. No Blodoc você pode revisar, editar o texto, exportar em PDF/Word e coletar assinatura eletrônica.

O que entra automaticamente no documento

SeçãoDe onde vem
Escopo — equipamentos cobertosPuxado dos equipamentos vinculados ao contrato (Field Service → Contratos)
Cronograma anualA mesma grid da seção 2, já calculada para o ano escolhido
Base legalPortaria MS 3.523/98, RE ANVISA 09/2003 e as normas NBR 16401/17037/14679
Procedimentos técnicos padrãoTexto fixo com os critérios de aceitação (filtros, serpentinas, dreno, QAI etc.)
⚠️ O botão só funciona depois que o administrador da conta rodar, uma vez, o comando que cria o modelo do documento no Blodoc. Se aparecer um erro pedindo para "rodar o seed", avise o time técnico.
x
Template Blodoc global "PMOC — Plano de Manutenção, Operação e Controle" (prisma/seeds/seed-blodoc-pmoc.mjs). Endpoint POST /api/fs/pmoc/gerar (fs_rgm.js) monta EQUIPAMENTOS_HTML a partir de FsContratoEquipamento e CRONOGRAMA_HTML via computarCronogramaPreventivo(), e chama gerarDocumentoFromTemplate. O documento gerado é editável/versionável/assinável como qualquer documento do Blodoc.

Qual a diferença entre eles?

DocumentoResponde aFrequênciaFormato
RGM"O que já foi feito no mês?"MensalPDF fechado (rascunho→liberado→enviado)
Cronograma anual"Quando cada equipamento tem manutenção prevista este ano?"Consultivo (aba dentro do RGM)Grid na tela / dentro do PDF do RGM
Consumo de fluido"Quanto Kg de gás usamos, por setor, este ano?"Anual (lançamentos ao longo do ano)Grid na tela, imprimível
PMOC"Qual é o plano/escopo contratado de manutenção?"Anual (1 documento por contrato)Documento Blodoc — editável e assinável

Perguntas frequentes

Preciso gerar o RGM antes de ver o Cronograma anual?
Não precisa gerar (salvar) — basta clicar em "🔍 Analisar" com o contrato escolhido; a aba Cronograma anual já aparece na pré-visualização.
O relatório de fluido substitui alguma obrigação ambiental?
Não é uma certificação — é um controle interno para você ter o dado organizado caso precise reportar (ex.: ao cliente ou a um órgão ambiental).
Posso editar o PMOC depois de gerado?
Sim — ele abre no Blodoc como qualquer documento: dá para editar o texto, gerar nova versão e coletar assinatura.
O técnico precisa de internet para registrar o consumo de fluido?
Não — funciona offline e sincroniza quando a conexão voltar, igual ao checklist e à QAI.
O que acontece se eu não preencher o "Setor" do equipamento?
O relatório de fluido ainda funciona, mas a linha aparece como "(sem setor)" — preencher o campo deixa o relatório organizado por área do cliente.