📖 Tutorial: entenda cada tela

O sistema foi feito para você entender sozinho o que fazer. Esta página explica o papel de cada tela e quando usar (ou não usar) cada uma. Em dúvida no dia a dia, o Norteador no Dashboard sempre aponta o próximo passo.

🚀 Como o sistema funciona (em 30 segundos)

O MedeAI cuida do ciclo completo da medição contratual. O fluxo é sempre o mesmo:

  • •1. ONBOARDING: você parametriza o contrato uma única vez (documentos, PQ, disciplinas, critérios)
  • •2. MEDIÇÃO: todo mês o sistema gera a planilha, o campo preenche, você importa de volta
  • •3. CONFERÊNCIA: o Auditor compara com o mês anterior e aponta o que não fecha
  • •4. ENTREGA: você baixa o Resumo em R$, o relatório fotográfico e o Pacote de Entrega prontos
  • •Regra de ouro: a IA propõe, o humano confirma. Nada entra no boletim sem alguém aprovar.

🧭 Norteador (a seta no topo do Dashboard)

É o GPS do sistema. Ele olha o estado do seu contrato e diz qual é o PRÓXIMO passo, com link direto.

  • •Em dúvida sobre o que fazer agora? Olhe o Norteador primeiro.
  • •Ele muda sozinho conforme você avança: cadastrou o contrato, ele pede os documentos; devolveu a planilha, ele manda conferir o BM.

🏗️ Onboarding: parametrizar o contrato (faça uma vez só)

Aqui você ensina o contrato ao sistema. É a tela mais importante do início. A ordem é de cima para baixo:

  • •1. DADOS DO CONTRATO: nome, número, cliente, valor
  • •2. DOCUMENTOS: suba o contrato, a PQ (planilha de quantidades), o critério de medição e o orçamento aprovado. Clique no nome de qualquer documento para abrir e ver o que o sistema está considerando
  • •3. LER PQ: o agente lê a planilha e traz os itens com código, descrição, unidade, quantidade e preço. Você confere antes de salvar
  • •4. MODELO DE MEDIÇÃO: as definições GERAIS do contrato (modelo predominante, ciclo, dia de corte). O botão de análise pede ao agente uma recomendação da forma mais exata de medir. Você aceita ou mantém a sua
  • •5. PQ: fica como veio no contrato. Ela é contratual e o sistema nunca altera
  • •6. DISCIPLINAS: aqui mora a parametrização fina de cada frente. Critério (etapas e percentuais que fecham 100%), unidade de controle (kg, h, m², un), evidências exigidas POR ETAPA, e composição unitária dos itens de HH/verba (o agente propõe lendo o orçamento, você confirma)
  • •Contrato sem take-off (medição direta por item)? Marque 'sem take-off' no critério da disciplina e o sistema gera a planilha por item, sem colunas de peso.

📐 Take-off: a lista de peças

Só para contratos medidos por peça/peso. O agente lê o desenho/LDO e extrai a lista de peças. Você confere na tela de conferência e aprova.

  • •Se o seu contrato é por HH, verba ou avanço direto por item, você NÃO usa esta tela.
  • •Revisão de projeto? Suba a nova remessa: o sistema compara com a base travada e mostra só o que mudou.

📁 BM existente (base): só para quem JÁ tem medição rodando

Esta tela serve para um caso específico: o contrato já tinha boletins aprovados ANTES do MedeAI.

  • •Suba o último BM aprovado e ele vira a base de comparação do próximo mês.
  • •Contrato começando do zero no sistema? Pule esta tela. Ela não faz parte do seu fluxo.

🧾 Medição (BMs): o coração do ciclo mensal

Três passos, sempre na mesma ordem:

  • •PASSO 1, GERAR: o sistema monta a planilha de medição (MC) do período, já no formato do seu critério. Só as células amarelas ficam liberadas para preencher
  • •PASSO 2, DEVOLVER: o campo preencheu? Suba a planilha de volta. O sistema importa, calcula o avanço e monta o boletim
  • •PASSO 3, CONFERIR E APROVAR: confira os números, rode o 'Conferir antes de aprovar' (o Auditor compara com o mês anterior peça a peça) e aprove. Aprovado fica TRAVADO e vira a base do próximo mês
  • •No Passo 3, abra o '❓ O que é cada botão do boletim?' para ver a diferença entre Resumo do BM (planilha de valores para o faturamento), Relatório fotográfico (só as fotos, por item) e Pacote de Entrega (o book completo).

📷 Evidências: as provas do que foi medido

Avanço sem evidência é avanço que o cliente pode glosar. Aqui ficam as fotos e documentos de cada peça/item.

  • •As fotos podem entrar por esta tela ou direto pelo WhatsApp de campo (o jeito mais prático).
  • •O Checklist de evidências (no Passo 3 da Medição) confere se cada item medido tem o que o critério exige.

💬 WhatsApp de campo: o encarregado não precisa abrir o sistema

Quem está na obra manda foto pelo WhatsApp e o sistema faz o resto:

  • •Foto com legenda (TAG e fase): entra direto como evidência da peça certa
  • •Foto sem legenda: o agente pergunta o que falta, em linguagem simples
  • •Texto relatando um problema (chuva, frente parada, falta de material): vira OCORRÊNCIA DE CAMPO e acende o sinal vermelho no Dashboard e no Maestro
  • •A tela Monitor WhatsApp mostra tudo que chegou e permite autorizar novos números.

📋 Pendências: o que precisa de resposta

Quando o Auditor encontra divergência entre o BM atual e o aprovado, ela cai aqui.

  • •Cada pendência diz exatamente ONDE corrigir (aba e linha da planilha) ou permite justificar por escrito.
  • •Pendência aberta trava o fechamento. Resolvidas e justificadas ficam no histórico, com rastro.

🔎 Auditor: o segundo engenheiro

Parecer consolidado de tudo que pode dar problema, num lugar só. Ele não altera nada: aponta, explica e diz onde resolver.

  • •Cadastro: critério que não fecha 100%, item sem disciplina, item de HH/verba sem composição
  • •Continuidade: divergências entre boletins e itens que estouraram o teto da PQ
  • •Evidências: o que o pacote do BM aberto ainda deve
  • •Documento: o que o critério em PDF exige e o cadastro ainda não considera.

🧭 Maestro (gerencial): quem deve o quê

A tela do gestor. Enquanto o Auditor confere a verdade dos números, o Maestro cobra as pessoas:

  • •Ocorrências de campo abertas aparecem em vermelho, com espaço para responder e resolver
  • •As cobranças vêm agrupadas por responsável: Campo, Escritório e Gestão
  • •Semáforo do período + o que se moveu nas últimas 24h.

📊 Dashboard: a foto do contrato

Avanço físico e financeiro, pendências em aberto e alertas. É a primeira tela do dia:

  • •Banner vermelho no topo? Tem ocorrência de campo aberta. Clique e vá direto ao Maestro.
  • •Card de pendências? Clique e resolva na tela de Pendências.

💬 Feedback de Teste: achou algo estranho?

Esta versão é beta e está em evolução. Registre qualquer coisa esquisita, dúvida ou ideia nesta tela:

  • •Não precisa formatar nada. Escreva do seu jeito que a gente lê tudo.
  • •Quanto mais específico (qual tela, o que você esperava, o que aconteceu), mais rápido melhora.

Resumo do resumo

Parametrize uma vez no Onboarding. Todo mês: gerar planilha, campo preenche, devolver, conferir, aprovar, entregar. O Norteador guia, o Auditor confere, o Maestro cobra. Quem resolve tá aqui.