Manual do Usuário
Sistema SSFOB — Subseção de Fiscalização de Obras · Guia completo, do primeiro acesso até o fechamento de uma obra.
1 Login e Acesso
Como entrar no sistema pela primeira vez
Passo 1
Acesse sieafa.com.br/ssfob. Digite seu usuário e senha fornecidos pelo administrador.
Passo 2
No primeiro acesso, o sistema pede para trocar a senha padrão. Escolha uma senha com pelo menos 6 caracteres.
Passo 3
Pronto — você entra direto na lista de obras. A sessão fica ativa por 7 dias, então não precisa logar toda vez que abrir o sistema.
Esqueceu a senha? Peça para um administrador (👥 Usuários) resetar — ela volta para a senha padrão e o sistema pede troca no próximo login.
2 Página Inicial
Visão geral de todas as obras em andamento
A página inicial mostra um card por obra, com:
- Nome da obra e status (Em andamento)
- Número do contrato e empresa contratada
- Valor total e percentual executado (barra de progresso)
- Data da última atualização
Botões disponíveis
| Botão | O que faz |
| Buscar obra | Filtra os cards pelo nome da obra digitado |
| ⬇ Modelo de Planilha | Baixa a planilha padrão (.xlsx) no formato exato que o sistema espera — envie para a empresa preencher antes do upload |
| + Nova Obra | Cria uma obra nova a partir do upload de uma planilha preenchida |
| 📖 Manual | Abre este manual — disponível também dentro de cada obra, no cabeçalho |
| 👥 Usuários | Só aparece para administradores — gerencia quem tem acesso ao sistema |
Clique em qualquer card para entrar no sistema daquela obra.
3 Criar uma Nova Obra
Do zero: subindo a planilha e criando o registro no sistema
Passo 1 Baixe o Modelo de Planilha na página inicial e envie para a empresa contratada preencher (ou preencha você mesmo com a planilha orçamentária).
Passo 2 Clique em + Nova Obra e selecione o arquivo .xlsx preenchido.
Passo 3 O sistema lê automaticamente: título, número do contrato, BDI, IR, desconto de licitação e todos os itens da planilha orçamentária.
Passo 4 Confira o resumo da extração (quantidade de itens encontrados) e confirme a criação.
Itens de aditivo (colunas de Supressão/Acréscimo) e valores de medição não são lidos da planilha — eles são sempre lançados depois, direto no sistema.
Só a
1ª Medição vem criada automaticamente (com nome, período e previsto, se estiverem na planilha). As demais (2ª, 3ª...) você cria manualmente conforme a obra avança, em
Contrato → Gerenciar Medições → + Medição.
Depois de criada, complete os dados que a planilha não traz na aba Contrato: representante da empresa, garantia, comissão de fiscalização, empenhos e datas.
4 Aba Resumo
Visão financeira geral da obra
Primeira tela ao abrir uma obra. Mostra:
- Contrato Original e Total c/ Aditivos (valor atualizado somando os aditivos lançados)
- Realizado Acumulado — soma de tudo já medido, com barra de progresso
- Empenhos — total empenhado e percentual do contrato
- Saldo Restante
- Administração Local — se a obra tiver item(ns) de Adm. Local (grupo 10), aparece aqui um card mostrando o quanto já foi calculado, de forma totalmente automática. Se houver mais de um item no grupo 10, o sistema soma todos.
Gráfico de Avanço por Medição
Barras comparando Previsto x Realizado, mês a mês.
Histórico de Medições
Tabela com todas as medições lançadas: previsto, realizado, reajuste, Adm. Local, acumulado, percentuais e desvio (verde se adiantado, vermelho se atrasado).
A Administração Local é calculada proporcionalmente ao que foi executado no mês — você não precisa lançar esse valor manualmente em nenhum lugar.
5 Aba Planilha
Todos os itens do orçamento, organizados em árvore
Mostra a planilha orçamentária completa, na mesma hierarquia da numeração (grupo → subgrupo → item). Clique em qualquer linha para editar todos os campos daquele item.
Cores das linhas
| Cor | Significado |
| Verde | Item com acréscimo de quantidade (aditivo) |
| Vermelho | Item com supressão de quantidade (aditivo) |
| Amarelo | Item totalmente novo, criado via aditivo |
Busca e filtros
Campo de busca filtra por número do item, descrição ou código. O filtro de medição mostra só itens que tiveram evolução naquele mês.
🔍 Validar Numeração
Botão que confere se o sufixo do item (ex: (ELT), (HID), (ARQ)) bate com o grupo do Manual SEAP-18-30. Se encontrar inconsistência, mostra um pop-up item por item perguntando se quer corrigir.
A validação é uma orientação, não uma regra absoluta — itens de demolição/remoção, por exemplo, legitimamente usam sufixo de outra especialidade. Você pode ignorar o aviso quando fizer sentido.
+ Novo
Cria um item do zero direto na Planilha (fora do fluxo de aditivo).
⬇ CSV
Exporta a planilha inteira em formato CSV.
6 Aba Medições
Lançar os valores realizados mês a mês
Selecione a medição no menu suspenso — um banner azul mostra qual medição está sendo visualizada, o período e o total já lançado.
Como lançar uma medição Clique em qualquer item da lista. O modal simplificado mostra só o essencial: Quantidade Medida, Valor c/BDI (calculado automaticamente), % Execução e Peso.
Se apagar a quantidade e salvar, o valor também é zerado automaticamente — não precisa abrir de novo para limpar.
Itens com valor negativo (ex: retirada de um item já medido antes) aparecem normalmente na lista.
Cores das linhas
Igual à Planilha: itens de aditivo aparecem verde (acréscimo), vermelho (supressão) ou amarelo (item novo), pra você identificar de longe o que veio de um termo aditivo.
Aplicar reajuste no preço
Quando existe um reajuste liquidado (data de pagamento já cumprida) pra data desta medição, ao abrir um item marcado como reajustável aparece uma caixinha amarela: "Aplicar reajuste de X% no preço unitário desta medição". Marcando, o valor calculado usa o preço já reajustado — e ele entra na coluna Vlr Reaj., sem mexer no valor original da coluna Vlr C/BDI.
⚡ Aplicar Reajuste (lote) Na toolbar, aplica o reajuste em todos os itens medidos da medição selecionada de uma vez, sem precisar abrir item por item. ↩ Remover Reajuste desfaz.
Se a soma de tudo que já foi medido de um item (em todas as medições) ultrapassar a quantidade original + aditivo dele, o sistema mostra um aviso na hora de salvar — mas não bloqueia, é só um alerta pra você conferir.
Botões da toolbar
| Botão | Função |
| ⚡ Aplicar Reajuste | Aplica o reajuste liquidado em todos os itens medidos desta medição, de uma vez |
| ↩ Remover Reajuste | Desfaz a aplicação em lote, volta todos ao preço original |
| 📄 Gerar TAM | Abre o Termo de Aceitação de Medição da medição selecionada — veja a seção 12 |
| ⬇ Planilha | Baixa um CSV só com os itens medidos naquela medição |
| 🖨 PDF | Abre uma versão para impressão/PDF da medição |
7 Aba Aditivos
Lançar acréscimos, supressões e itens novos por termo aditivo
Cada aditivo (1º, 2º, 3º...) tem seu próprio bloco, com cabeçalho fixo (não precisa rolar a tela pra ver o total ou adicionar item) e tabela editável direto na linha.
Colunas da tabela
- Qtd Sup. (fundo vermelho) — quantidade suprimida. O sistema já subtrai automaticamente, não precise digitar o sinal negativo.
- Qtd Acr. (fundo verde) — quantidade acrescida, soma normalmente.
- Classificação — Acréscimo em item existente / Supressão / Item novo (preço atualizado ou sujeito a reajuste)
+ Item Adiciona uma linha nova dentro do aditivo atual. Preencha o número do item seguindo a numeração correta — ele cai automaticamente na posição certa da Planilha.
+ Novo Aditivo Cria um novo bloco (2º Aditivo, 3º Aditivo...) para separar por termo aditivo contratual.
💾 Salvar Tudo Salva todos os itens de todos os aditivos de uma vez.
Busca automática (autocomplete)
Ao digitar no campo Nº Item, Código ou Descrição de uma linha nova, o sistema sugere itens já existentes na planilha original. Se encontrar uma correspondência exata, preenche sozinho o resto da linha (banco, unidade, valor unitário) — útil pra lançar acréscimo/supressão num item que já existe, sem digitar tudo de novo.
Itens novos de aditivo aparecem em amarelo na Planilha assim que criados, mesmo antes de preencher o número — mas o sistema só consegue posicioná-los no lugar certo da árvore depois que o número for digitado.
8 Aba Reajuste
Cálculo do reajuste contratual por índice
O reajuste é calculado assim: para cada medição afetada, aplica-se o percentual do índice sobre o valor daquela medição individualmente, e soma-se tudo. Não é proporcional a dias corridos.
+ Novo Reajuste Preencha: Índice (ex: 0,0671 = 6,71%), Descrição, Data de Início e Data de Pagamento.
Status do reajuste
| Badge | Significado |
| 🟠 DEVIDO | Sem data de pagamento definida ainda — valor calculado até hoje, ainda em aberto |
| 🕓 PREVISTO | Data de pagamento é futura — valor já calculado, mas ainda não pago |
| ✅ PAGO | Data de pagamento já passou — valor incorporado ao total pago |
O resumo de cada reajuste mostra uma tabela com cada medição afetada, valor da medição, índice e valor do reajuste — igual ao que aparece no documento oficial.
A medição em que o reajuste é pago não entra na soma — a partir dela, os preços unitários da planilha já devem vir reajustados.
Onde mais o reajuste é usado
- Na aba Medições, uma vez que o reajuste está com data de pagamento preenchida, o sistema oferece aplicar o preço já reajustado direto no lançamento de cada item (ou em lote, pra medição inteira).
- No rateio da Administração Local (se houver item de grupo 10 na obra), o sistema projeta automaticamente o efeito do reajuste sobre o saldo do contrato ainda não medido — sem precisar cadastrar nada a mais, é calculado sozinho a partir do índice e da data de início já preenchidos aqui.
9 Aba Contrato
Todos os dados administrativos da obra
Identificação
Objeto, nome da obra, contrato, BDI, contratada (nome, CNPJ, endereço), CNPJ e endereço do contratante, ordenador de despesas.
Representante(s) Legal(is)
Pode cadastrar mais de um representante — clique em + Representante quantas vezes precisar. Cada um tem nome, cargo, RG e CPF próprios. No TAM, todos aparecem juntos na identificação da contratada, e cada um ganha sua própria linha de assinatura no final do documento.
Datas e Valores
Valor total, desconto de licitação, vigência, execução (início/fim) e Término Original — preencha só se houve prorrogação por aditivo; o sistema calcula os dias automaticamente e gera o texto de prorrogação no TAM.
Garantia
Seguradora, apólice, valor e vigência do seguro-garantia.
Comissão de Fiscalização
Portaria de designação e os membros (nome, posto, função, número de ordem).
📋 Gerenciar Medições
Botão que abre um modal para cadastrar cada medição: nome, período (início e fim), data da medição e valor previsto. O realizado é calculado automaticamente pelo sistema.
Uma obra nova criada por upload de planilha já vem com a 1ª medição pronta automaticamente. As demais (2ª, 3ª...) você cria aqui, uma de cada vez, conforme a obra for avançando.
Empenhos
Lista de notas de empenho com número e valor.
Sempre clique em 💾 Salvar depois de editar qualquer campo desta aba — as alterações não são salvas automaticamente.
10 Aba Documentações
Arquivos e projetos da obra organizados por categoria
+ Nova Categoria Digite o nome (ex: "Documentos do Edital", "Segurança", "Projetos") e escolha se quer organizar em subpastas.
Se marcar "Organizar em subpastas", você digita os nomes livremente — ou usa o modelo pronto 📐 Projetos Técnicos, que preenche automaticamente: Arquitetura, Estruturas, Hidráulica, Elétrica, Mecânica, Incêndio, Topografia, Outros.
Cada categoria ou subpasta tem botão + Arquivo para upload. Tipos aceitos: PDF, DWG, DXF, Word, Excel, PowerPoint, imagens, ZIP/RAR, SKP, RVT — até 50MB por arquivo.
Pode criar quantas categorias e subpastas quiser, a qualquer momento — não precisa definir tudo de uma vez ao criar a obra.
11 Diário de Obra
Linha do tempo de anotações e eventos da obra
Uma linha do tempo vertical com tudo que acontece na obra — anotações que você escreve manualmente, misturadas automaticamente com eventos que o sistema já sabe (medição gerada, reajuste liquidado).
Categorias disponíveis
| Categoria | Uso |
| 📋 LDO — Livro Diário de Obra | Formulário próprio: dia da obra, condição climática, nº de colaboradores, serviços executados, comunicação COMFIS e comunicação da contratada |
| ⚠️ Ocorrência/Problema | Atraso, defeito, imprevisto |
| 👷 Segurança do Trabalho | Acidente, quase-acidente, EPI |
| 🌧️ Condição Climática | Chuva parando a obra, etc |
| 📐 Decisão Técnica | Mudança de projeto, especificação |
| 📸 Registro Fotográfico | Fotos com legenda |
| 🔍 Visita/Vistoria | Quem veio, o que observou |
| 💬 Comunicação | Ofício, e-mail importante, reunião |
| ✅ Marco Importante | Data que merece destaque |
+ Nova Anotação Abre o formulário. Ao escolher LDO, o sistema já sugere sozinho o "Dia X/Y" da obra, calculado a partir das datas de execução cadastradas no Contrato — você pode ajustar manualmente se precisar.
Cada anotação pode ter fotos anexadas e ser vinculada a uma medição específica. Clique numa foto pra ver ela ampliada (não abre o modal de edição por engano).
Eventos automáticos
Toda vez que uma medição é gerada ou um reajuste é liquidado, uma entrada aparece sozinha na timeline, marcada com a etiqueta "automático" — não pode ser editada nem excluída, é só um reflexo do que já existe no sistema.
Filtros e exportação
- Filtro por categoria (incluindo "só eventos automáticos")
- Busca por texto no título ou descrição
- Opção de ocultar os eventos automáticos, se quiser ver só suas anotações
- 🖨 Exportar PDF — gera a timeline (respeitando os filtros ativos) pronta pra imprimir ou juntar no processo
12 Gerar o TAM
Termo de Aceitação de Medição — documento oficial
Na aba Medições, selecione a medição e clique em 📄 Gerar TAM. O sistema monta automaticamente:
- Brasão da República e identificação do contratante e contratada (usando os dados da aba Contrato) — se houver mais de um representante cadastrado, todos aparecem na identificação e cada um ganha sua própria linha de assinatura
- Vigência, execução e ordem de serviço
- Garantia financeira
- Cronograma físico-financeiro com todas as medições, já somando a parcela de Administração Local (se houver item de grupo 10 na obra)
- Seção de aditivo (aparece automaticamente se houver aditivo lançado)
- Tabela de liquidação de reajuste (aparece se houver reajuste sendo pago naquela medição)
- Comissão de fiscalização e conclusão
- Gráficos de Previsto x Realizado e Execução Acumulada
🖨️ Imprimir / PDF Abre a visualização de impressão do navegador — use "Salvar como PDF".
⬇ Baixar .doc Baixa um arquivo Word editável, com os gráficos já convertidos para imagem (compatível com o Word de verdade).
Valores importantes no TAM aparecem por extenso automaticamente, ex: "R$ 88.893,82 (oitenta e oito mil, oitocentos e noventa e três reais e oitenta e dois centavos)".
13 Fluxo Completo de uma Obra
Do início ao fim, passo a passo
1. Baixar modelo
→
2. Empresa preenche
→
3. Criar obra
→
4. Completar Contrato
5. Cadastrar medições
→
6. Lançar valores mensais
→
7. Gerar TAM
8. Lançar aditivos (se houver)
→
9. Lançar reajuste (se houver)
→
10. LDO diário + Repetir 5-7 até o fim
- Antes da obra começar: baixe o modelo de planilha e envie para a empresa vencedora da licitação preencher com o orçamento aprovado.
- Criação: faça upload da planilha preenchida em "+ Nova Obra" — já vem com a 1ª medição pronta.
- Complete a aba Contrato: representante(s), garantia, comissão de fiscalização, empenhos, e vá criando as demais medições em "Gerenciar Medições" conforme a obra avança.
- A cada mês: vá na aba Medições, lance a quantidade executada de cada item, e gere o TAM daquela medição para assinatura da comissão.
- Se houver termo aditivo: lance na aba Aditivos os acréscimos, supressões e itens novos, referenciando o número do aditivo correspondente.
- Se houver reajuste contratual: cadastre na aba Reajuste com a data de início e o índice; defina a data de pagamento quando for liquidado — daí em diante, aplique o preço reajustado direto na aba Medições.
- Diário de Obra: lance o LDO diariamente (ou com a frequência que fizer sentido) e registre ocorrências relevantes conforme forem acontecendo.
- Documentos: vá anexando projetos, ARTs, relatórios de segurança e demais documentos na aba Documentações conforme forem chegando.
- No fim da obra: gere o TAM da última medição, confira que o percentual acumulado bate 100%, e o processo está pronto para encerramento.
14 Cálculos do Sistema
Como cada número do SSFOB é calculado, com fórmula e exemplo
Esta seção existe para dar transparência: todo valor financeiro do sistema pode ser conferido manualmente com as fórmulas abaixo. Os nomes entre código são os campos internos, caso precise localizar algo no suporte técnico.
14.1 — Valor unitário com BDI
Todo item da planilha tem um valor base e um valor "oficial" (o que entra nos cálculos), que já embute o BDI do contrato.
Dados usados: valor_unit (valor unitário base, sem BDI) e bdi (percentual do contrato, ex: 22,23%)
Valor Unit. c/ BDI = Valor Unit. Base × (1 + BDI%)
Exemplo: item com valor base R$ 100,00 e BDI de 22,23% → 100 × 1,2223 = R$ 122,23/unidade.
14.2 — Total sem BDI e BDI (R$) da Planilha
No rodapé da aba Planilha, o total geral (já com BDI) é decomposto de volta em base + BDI.
Dados usados: soma de subtotal_orig de todos os itens-folha (com unidade preenchida) e bdi do contrato
Total Geral = Σ subtotal_orig (itens-folha)
Total sem BDI = Total Geral ÷ (1 + BDI%)
BDI (R$) = Total Geral − Total sem BDI
Exemplo: Total Geral de R$ 228.983,30 com BDI 22,23% → Total sem BDI = 228.983,30 ÷ 1,2223 ≈ R$ 187.331,58; BDI (R$) ≈ R$ 41.651,72.
14.3 — Valor de um item numa medição
Ao lançar a quantidade executada de um item numa medição, o sistema grava dois valores: o valor "normal" (com BDI) e — se houver reajuste ativo aplicado — o valor reajustado. Sempre que os dois existem, o reajustado prevalece.
Dados usados: qtd (quantidade lançada), valor_unit_bdi (valor unitário já com BDI), preco_adit (subtotal de itens de aditivo, se houver)
Vlr. c/ BDI (preco_bdi) = Qtd × Valor Unit. c/ BDI
Vlr. Reajustado (preco_reaj) = Qtd × Valor Unit. c/ BDI × (1 + Índice de Reajuste Ativo)
Valor Efetivo do item = Vlr. Reajustado, se houver — senão Vlr. c/ BDI
Valor Total do item na medição = Valor Efetivo + preco_adit
Exemplo: 10 unidades a R$ 122,23 (já c/ BDI) → R$ 1.222,30. Se essa medição já tiver 6,71% de reajuste ativo: 1.222,30 × 1,0671 ≈ R$ 1.304,32 — esse é o valor que entra no "Realizado".
O Vlr. c/ BDI nunca é apagado quando o reajuste é aplicado — ele fica guardado como referência do valor original, e é só o Vlr. Reajustado que passa a valer no lugar dele.
14.4 — Realizado de uma medição (aba Medições / gráficos)
O "Realizado" de uma medição é a soma do Valor Total (14.3) de todos os itens da planilha naquela medição.
Realizado da Medição = Σ (Valor Efetivo do item + preco_adit), para todos os itens
14.5 — Índice de reajuste ativo numa medição
Um reajuste só "conta" numa medição se já tiver data de pagamento preenchida e essa data for igual ou anterior à data da medição. Se houver mais de um reajuste liquidado até lá, os índices se somam.
Dados usados: todos os registros da aba Reajuste com data_pagamento preenchida e data_pagamento ≤ data da medição
Índice Ativo = Σ índice de cada reajuste liquidado até a data da medição
Exemplo: se a obra tem um reajuste de 6,71% liquidado em 28/07/2026, toda medição com data ≥ 28/07/2026 usa esse índice; medições anteriores usam 0% (valor original, sem reajuste).
14.6 — Valor total do reajuste (a pagar/pago)
Quando um reajuste é cadastrado (aba Reajuste), o sistema calcula quanto ele vale aplicando o índice sobre as medições que ficaram "no meio do caminho": da data de início do reajuste até a véspera da data de pagamento (a própria medição de pagamento já é lançada com o valor reajustado direto na Planilha, então não entra nessa soma para não contar duas vezes).
Dados usados: data_inicio e data_pagamento do reajuste, índice, e o Vlr. c/ BDI (sem reajuste) de cada medição afetada
Para cada medição M com data_inicio ≤ data(M) < data_pagamento:
Valor do Reajuste em M = (Σ Vlr. c/ BDI dos itens marcados p/ reajuste em M) × índice
Valor Total do Reajuste = Σ Valor do Reajuste em M (todas as medições afetadas)
Exemplo real do sistema: reajuste de 6,71% com início em 28/02/2026, liquidado em medição posterior → somando o valor de cada medição afetada × 6,71%, o total fechou em R$ 49.695,35, batendo com o TAM oficial.
Esse é diferente do reajuste projetado sobre o saldo (14.7) — este aqui (14.6) é o valor retroativo que efetivamente é pago de uma vez; o projetado é só uma referência para atualizar a base de rateio da Administração Local.
14.7 — Administração Local (Grupo 10)
A Adm. Local é rateada proporcionalmente ao quanto já foi executado do contrato (sem contar o próprio grupo 10), medição a medição — automaticamente, sem lançamento manual.
Valor atual da Adm. Local (soma de todos os itens que começam com "10."):
Vlr. Adm. Local Atual = Σ subtotal_orig (itens grupo 10)
+ Σ subtotal_aditivo (itens grupo 10)
+ Reajuste projetado sobre o grupo 10
Reajuste projetado (usado só para atualizar a base de rateio, não é pago à parte):
Para cada reajuste cadastrado:
Reajuste Projetado = max(0, Valor Original − Valor já medido antes da data_inicio) × índice
Rateio por medição — caso simples (sem aditivo/reajuste alterando os totais, ou medição anterior à liquidação do primeiro reajuste):
Adm. Local da Medição = Vlr. Adm. Local Original × (Realizado da Medição, sem grupo 10 ÷ Total Original do contrato, sem grupo 10)
Exemplo: Adm. Local original de R$ 27.885,67, contrato original (sem grupo 10) de R$ 201.097,63. Numa medição em que foi executado R$ 10.100,67 (sem grupo 10): 27.885,67 × (10.100,67 ÷ 201.097,63) ≈ R$ 1.400,63.
Rateio por medição — após aditivo ou reajuste liquidado (rebase do saldo, mesma lógica da planilha oficial): o histórico já pago antes da liquidação não muda; só o saldo restante do contrato e da Adm. Local passam a ser recalculados pelos valores atualizados.
Saldo do Contrato (sem grupo 10) = Total Atual (sem grupo 10) − Σ Realizado das medições anteriores
Saldo da Adm. Local = Vlr. Adm. Local Atual − Σ Adm. Local já rateada nas medições anteriores
Adm. Local da Medição = Saldo da Adm. Local × (Realizado da Medição, sem grupo 10 ÷ Saldo do Contrato, sem grupo 10)
14.8 — Realizado Acumulado, Empenhos e Saldo Restante (aba Resumo)
Total c/ Aditivos = Contrato Original + Σ subtotal_aditivo (todos os itens)
Realizado Acumulado = Σ (Realizado da Medição + Reajuste da Medição + Adm. Local da Medição), para todas as medições
Saldo Restante = Total c/ Aditivos − Realizado Acumulado
% Realizado = Realizado Acumulado ÷ Total c/ Aditivos
% Empenhado = Σ valor dos Empenhos ÷ Total c/ Aditivos
A coluna Acumulado da tabela "Histórico de Medições" usa a mesma fórmula do Realizado Acumulado acima — soma progressiva, medição a medição, incluindo Adm. Local — por isso ela deve sempre bater com o card do topo.
14.9 — % Mês, % Acumulado e Desvio (Histórico de Medições)
% Mês = (Realizado da Medição + Reajuste da Medição) ÷ Total c/ Aditivos
% Acumulado = Acumulado até a Medição ÷ Total c/ Aditivos
Desvio = Realizado da Medição − Previsto da Medição
O Desvio aparece em verde quando ≥ 0 (adiantado ou em dia) e em vermelho quando negativo (atrasado em relação ao Cronograma Físico-Financeiro).
14.10 — % de execução de cada item (aba Planilha)
Previsto do item = subtotal_orig + subtotal_aditivo
Realizado do item = Σ Valor Total do item, em todas as medições
% Execução do item = Realizado do item ÷ Previsto do item
Os selos coloridos (badges) seguem a mesma escala em toda a tela: < 25% 25–50% 50–90% ≥ 90%.
14.11 — Valores por extenso (TAM)
No TAM, valores em reais são escritos por extenso automaticamente, separando a parte inteira (reais) da parte decimal (centavos) e convertendo cada uma para texto em português.
Reais = parte inteira do valor
Centavos = arredondamento((valor − Reais) × 100)
Texto = "R$ valor (Reais por extenso) real(is)" + [" e " + Centavos por extenso + " centavo(s)", se Centavos > 0]
Exemplo: R$ 88.893,82 → "R$ 88.893,82 (oitenta e oito mil, oitocentos e noventa e três reais e oitenta e dois centavos)".
15 Gestão de Usuários
Só para administradores
Na página inicial, administradores veem o botão 👥 Usuários.
- + Novo Usuário — cria com senha padrão, o sistema pede troca no primeiro acesso
- ✏ Editar — altera nome, usuário e se é administrador
- 🔑 Reset — volta a senha para o padrão
- 🗑 — exclui o usuário (não é possível excluir a si mesmo)
16 Desfazer Ações
Botão ↩ Desfazer no topo da tela
Cobre os salvamentos das abas Planilha, Medições, Contrato, Aditivos e Reajuste — guarda até 3 ações anteriores.
Ações com pop-up de confirmação (excluir item, excluir categoria, excluir reajuste) já pedem "tem certeza?" antes — essas não entram no desfazer, pois já são deliberadas.
17 Dúvidas Frequentes
Errei um item na planilha, como corrijo?
Clique no item na aba Planilha (modo completo) e edite qualquer campo.
Como sei se uma medição está em atraso?
Na aba Resumo, a coluna Desvio do histórico fica vermelha quando o realizado está abaixo do previsto.
O que acontece se eu excluir uma categoria de documentos?
Todos os arquivos e subpastas dentro dela são excluídos junto — o sistema pede confirmação antes.
Posso ter mais de um aditivo na mesma obra?
Sim — use "+ Novo Aditivo" para criar quantos blocos precisar (1º, 2º, 3º...).
O sistema calcula a Administração Local sozinho?
Sim, totalmente automático, proporcional ao percentual executado da obra em cada medição.