BoaObra Manual de uso

Tudo o que o BoaObra faz,
explicado tela por tela.

Este manual documenta cada módulo do BoaObra como ele existe hoje: o que cada tela mostra, o que cada campo espera, o que cada botão faz ao ser clicado. Onde uma função ainda não está pronta, isso está marcado como para você nunca procurar um botão que ainda não existe.

18 módulos documentados Web + app mobile pt-BR

Começando

Conta e acesso

Antes de chegar a qualquer obra, todo mundo passa por aqui: criar conta, entrar e recuperar o acesso quando esquece a senha.

Cadastro /register

Cria a conta que vai ser dona de todas as obras cadastradas por ela (ou às quais for convidada).

Campo Tipo Obrigatório Observações
Nome Texto Sim
Sobrenome Texto Sim
Seu melhor e-mail E-mail Sim Pré-preenchido se você chegou por um link de convite
Crie uma senha Senha Sim Mínimo 8 caracteres, com pelo menos uma letra e um número
Repetir senha Senha Sim Precisa ser idêntica ao campo anterior

Botão Criar: ao concluir, você entra direto na conta e é levado ao assistente de criação da primeira obra.

Entrar /login

Campo Tipo Obrigatório
E-mail E-mail Sim
Senha Senha Sim

O checkbox Lembre-se de mim e o link Esqueci a senha ficam logo abaixo dos campos. Após entrar, você cai no painel de obras — ou na obra que já estava vendo, se chegou por um link direto.

Recuperar senha /forgot-password

Fluxo em três telas, sempre nessa ordem:

  • Informe o e-mail cadastrado — enviamos um código de 6 dígitos.
  • Digite o código recebido (6 caixas, uma por dígito — dá para colar o código inteiro de uma vez). Pode pedir reenvio depois de 60 segundos.
  • Defina a nova senha — mesma regra do cadastro (8+ caracteres, letra e número), com confirmação.

Ao final, você volta para a tela de entrar com a mensagem "Senha redefinida com sucesso."

Verificação de e-mail

Ao se cadastrar ou trocar de e-mail, um link de confirmação chega na caixa de entrada. Clicar nele abre uma tela de confirmação simples — não exige preencher nada, só confirma e te leva de volta para o login.

Seu perfil

/profile

Acessível pelo avatar no canto superior direito de qualquer tela. Dividido em abas — hoje, duas delas funcionam de verdade.

Informações pessoais

Foto de perfil. Clique em Atualiza imagem do perfil para trocar a foto. Aceita apenas JPG/JPEG/PNG, com largura mínima de 1200px — arquivos menores ou em outro formato são recusados com um aviso explicando o motivo.

Campo Tipo Editável Observações
Nome / Sobrenome Texto Sim
E-mail Texto Não Só leitura aqui; para trocar, use a aba Segurança. Se ainda não verificado, aparece um botão Verificar
Data de nascimento Data Sim Opcional
Sexo Seleção Sim Masculino / Feminino / Outro — opcional
Cargo Texto Não Só leitura, definido pelo sistema

Os botões Cancelar / Salvar alterações só ficam ativos depois que você altera algum campo.

Segurança

Alterar senha: Senha atual, Nova senha e Confirmar nova senha (todos obrigatórios).

Alterar e-mail: Senha atual, Novo e-mail e Confirmar novo e-mail (todos obrigatórios). Depois de solicitar a troca, o e-mail antigo continua ativo até você clicar no link de confirmação enviado ao novo endereço.

Em breve

As abas Notificações e Preferências ainda não têm nenhuma opção configurável.

Painel de obras

/dashboard

A tela que você vê depois de entrar. Cada obra aparece como um cartão; é o ponto de partida para tudo.

O que cada cartão de obra mostra

  • Ícone do tipo de obra e nome.
  • Selo de situação: Em ordem Atenção Em atraso
  • Dias restantes (ou em atraso) com barra de progresso do prazo.
  • Percentual do orçamento já utilizado.

Ações disponíveis em cada cartão

Ação O que faz
Abrir obra Leva para a Visão Geral daquela obra
Ver valores da obra Expande orçamento total, viabilidade, composição de custos e fases do orçamento sem sair do painel
Ver impedimentos Expande a lista de impedimentos registrados (título, severidade, se já resolvido)
Ver localização Abre um mapa com o endereço da obra

O botão de destaque Novo projeto no topo inicia o assistente de criação de obra.

Criar uma nova obra

/new-project/project-setup

Um assistente em etapas. Logo na primeira tela você escolhe um de dois caminhos — isso muda quais etapas aparecem depois. Seu progresso fica salvo automaticamente a cada tela, então fechar o navegador no meio não perde nada.

Construção guiada

4 etapas — fases de orçamento padrão já vêm prontas.

Criar do zero

5 etapas — você define orçamento e cronograma na mão.

Etapa 1 — Dados iniciais

Campo Tipo Obrigatório
Nome da obra Texto Sim
Localização Busca por CEP, endereço ou mapa Sim
Modo de criação Construção guiada / Criar do zero Sim

Etapa 2 — Tipo da obra

Escolha um entre seis modelos: Casa térrea, Sobrado, Prédio Residencial, Prédio Comercial, Galpão, Reforma.

Etapa 3 — Terreno

Campo Tipo Obrigatório Opções
Área do terreno Número (m²) Sim
Área de construção Número (m²) Sim
Estado físico do solo Seleção Sim Arenoso, Orgânico, Saturado, Argiloso, Não sei
Relevo do terreno Seleção Sim Plano, Aclive, Declive, Irregular, Não sei

Etapa 4a — Prazo só na construção guiada

Campo Tipo Obrigatório
Base de valores SINAPI / CBIC / FGV / SICRO / TCPO Sim
Início da obra Data Sim
Data de conclusão Data Sim

Neste modo, as fases de orçamento já vêm com percentuais padrão: Fundação 15%, Estrutura 28%, Elétrica 12%, Hidráulica 10%, Acabamento 35%.

Etapa 4b — Orçamento só no criar do zero

Campo Tipo Obrigatório
Orçamento total da obra Moeda (R$) Sim
Fases do orçamento Lista com slider de % por fase Ao menos 1

Adicione fases com Adicionar fase e ajuste cada percentual pelo slider — o valor em reais recalcula sozinho.

Etapa 5 — Cronograma só no criar do zero

Para cada fase herdada do orçamento, adicione tarefas com nome, data e (opcionalmente) valor. Datas de início/entrega da obra ficam no topo da tela.

Etapa final — Resumo

Ao chegar aqui, o sistema calcula automaticamente uma sugestão de orçamento e viabilidade (Totalmente viável Com restrições Inviável), com a composição de gastos por fase. Nada aqui é editável diretamente — é a conferência final antes de clicar em Finalizar criação, que cria a obra de verdade e te leva para o painel.

Dica

O botão Pular, disponível em qualquer etapa, abandona o assistente e vai direto para o painel — dá para criar a obra mais tarde.

Dentro da obra

Visão geral da obra

A primeira tela ao abrir qualquer obra. Reúne um resumo do orçamento por fase, custo planejado x real, status geral, riscos de atraso e compras pendentes.

O que a tela mostra

  • Fases do orçamento — clique em uma fase para ver seu valor e status em destaque.
  • Custo Planejado vs Real e Orçamento da fase — comparativos visuais.
  • Status Geral da Obra — dias restantes/atraso e a situação (Em ordem / Atenção / Em atraso).
  • Risco de Atraso — lista de riscos ativos, cada um com botão Resolver.
  • Compras Pendentes — lista com botão de ação (Aprovar / Comprar / Analisar conforme o item).
Em breve

O progresso físico (%) e o custo real no gráfico "Planejado vs Real" ainda aparecem como "Em breve" — esses números dependem de dados que o sistema ainda não calcula automaticamente.

Botão Registrar

Abre um formulário com três abas para deixar um registro rápido na obra:

Aba Campos
Nota Título (obrigatório) + Descrição (opcional)
Risco de atraso Fase (obrigatório) + Dias em risco, número (obrigatório)
Compra pendente Item (obrigatório) + Valor + Ação sugerida (Aprovar/Comprar/Analisar)

Tudo o que é registrado aqui — mais as ações de aprovar/resolver — fica listado no botão Histórico, no topo da tela.

Orçamento

/inventory

O núcleo de precificação do BoaObra. Um insumo (material, mão de obra, equipamento…) compõe um serviço através de uma composição; serviços viram itens do orçamento de uma obra específica. Insumos e serviços são compartilhados entre todas as suas obras — cadastre uma vez, use em quantas obras precisar. Acessível pelo item Materiais da navegação lateral, com quatro abas: Solicitações, Catálogo, Insumos, Serviços.

Cadastro de Insumos /inventory/resources

Lista todos os insumos cadastrados, com nome, categoria, unidade, preço e situação.

Campo Tipo Obrigatório Observações
Descrição Texto Sim Nome do insumo
Código auxiliar Texto Não Código próprio para conciliar com o fornecedor
Unidade de medida Texto Sim Ex.: Saco 50kg, m², Un
Marca Texto Não
Conta financeira Texto Não Para relatórios financeiros
Fornecedor preferencial Texto Não
Tempo de entrega (dias) Número Não Alimenta um alerta na Análise Preditiva quando uma compra pendente já ultrapassou esse prazo
Categoria do insumo 6 opções Sim Material, Mão de obra, Equipamento, Combustível, Ferramenta, Outros
Observações Texto longo Não Aba própria dentro da tela

Abas da tela de edição (só liberadas depois de salvar pela 1ª vez): Preço (mostra o preço atual e permite lançar um novo — recalcula o custo de todos os serviços que usam este insumo), Onde é utilizado (serviços que usam o insumo e obras que já orçaram esses serviços) e Unidade de compra (cadastre uma unidade diferente da orçada, com fator de conversão — ex.: orça em Kg, compra em "Saco 50kg" → fator 50).

Ações de gestão do insumo

Ação O que faz
Histórico de preços Tabela com todo reajuste já feito neste insumo (data, preço, origem)
Ativar / Desativar Insumos inativos somem das novas composições e orçamentos, mas nada some do que já existe. Bloqueado se o insumo estiver em uso em alguma composição
Substituir insumo Troca este insumo por outro em todas as composições que o usam de uma vez, com fator de conversão se as unidades forem diferentes
Duplicar insumo Cria uma cópia com os mesmos dados, para editar a partir dela
Excluir insumo Só é possível se o insumo não estiver em uso em nenhuma composição

Na lista de insumos, Reajustar preços aplica um percentual (positivo ou negativo) a todos os insumos de uma categoria de uma só vez. Exportar baixa a lista completa em Excel.

Cadastro de Serviços /inventory/services

Campo Tipo Obrigatório Observações
Nome Texto Sim
Tipo de preço Seleção Sim Composição (calculado dos insumos), Fixo (você digita o custo), Sem composição
Unidade Texto Sim
Grupo Texto Não Livre, para organizar (ex.: Alvenaria, Acabamento)
Custo unitário fixo Moeda Se tipo = Fixo

Cada linha da lista tem: Ver composição (só para tipo Composição), Ver obras que usam, Ativar/Desativar (bloqueado se em uso num orçamento), Editar e Excluir. O botão Exportar baixa a lista em Excel.

Banco de Composições /inventory/catalog/[serviço]

Aberto ao clicar em "Ver composição" a partir de um serviço. Lista os insumos que compõem aquele serviço, com coeficiente, unidade e subtotal.

Ação O que faz
Adicionar insumo Formulário com uma ou várias linhas (insumo + coeficiente) — dá para adicionar vários de uma vez em "Adicionar outra linha"
Editar coeficiente Direto na tabela, campo numérico por linha + botão Salvar
Remover insumo Tira o insumo desta composição
Duplicar composição Copia todos os insumos de outro serviço para este, sem duplicar os que já existem aqui

O custo do serviço (Total, Material, Mão de obra, Equipamento) é recalculado automaticamente a cada mudança na composição.

Planilha Orçamentária /inventory/catalog

É aqui que o orçamento da obra de fato se monta: cada linha é um serviço com uma quantidade.

Campo (novo item) Tipo Obrigatório
Serviço Seleção Sim
Fase Seleção Não
Quantidade Número Sim
Observação Texto Não

O cartão de resumo no topo mostra quantos itens usam composição/preço fixo/sem composição, a distribuição de custo por categoria e os serviços mais usados no orçamento.

Suprimentos

/inventory · Solicitações

Aba Solicitações, dentro de Materiais. Controla o que precisa ser comprado, o que já chegou e o impacto disso no orçamento.

Impacto dos materiais no orçamento

Cartão com o total de solicitações, aprovadas, pendentes e negadas, mais uma barra mostrando quanto do valor em materiais está em caixa para compra, já utilizado, ou parado (comprado mas ainda não usado).

Produtos com descontos

Sugestões automáticas de fornecedores com desconto para os materiais mais solicitados. O botão Repor a partir de ofertas já cria solicitações a partir das 3 melhores ofertas encontradas.

Aviso

Ofertas são sugestões geradas por IA — preços e links são estimados, não cotações garantidas.

Nova solicitação

Campo Tipo Obrigatório Observações
Produto Texto Sim Digitar o nome já sugere a categoria automaticamente
Fase Seleção Não
Categoria Seleção Não Cimento, Tinta, Aço, Madeira, Agregado
Quantidade Número Sim
Unidade Texto Não Padrão "un" se vazio
Mínimo ideal Número Não Quantidade destacada em vermelho na lista se ficar abaixo disso
Preço unitário Moeda Não

Ações na lista de solicitações

  • Recorrência de compra — Sem recorrência / Semanal / Mensal.
  • Aumentar / diminuir quantidade — ajuste rápido.
  • Registrar recebimento — marca como recebido.
  • Histórico — todos os eventos daquela solicitação.
  • Excluir.

O botão Procurar abre uma busca por fornecedores com ofertas de IA para qualquer material, mesmo sem uma solicitação criada ainda. Exportar baixa a lista completa em Excel.

Planejamento

Duas telas complementares: Fases, para acompanhar o progresso, e Cronograma, para ver tudo num calendário.

Fases /phases

Uma coluna por fase, mostrando progresso (%), tarefas concluídas de um total, data final, membros da equipe atribuídos e um contador de comentários.

Campo (adicionar nova fase) Tipo Obrigatório
Nome da fase Texto Sim
Percentual do orçamento Número (1–100) Não

Clicar no ícone de comentários de uma fase abre um painel para discutir e anotar algo específico daquela etapa — cada comentário mostra autor, data e texto.

Em breve

Criar e atribuir tarefas individuais (com responsável e pré-requisitos entre elas) ainda não tem tela própria — hoje o status de cada fase é calculado automaticamente a partir das datas do cronograma.

Cronograma /schedule

Um calendário mensal: dias com alguma tarefa ou marco ficam destacados. Selecione um dia para ver a lista de eventos daquela data, com filtro por fase.

Medição

/measurements

Controla quanto de cada serviço orçado já foi executado e libera o pagamento correspondente, com retenção e glosa.

Nova medição

Campo Tipo Obrigatório
Fase Seleção Sim
Período início / fim Datas Sim
Serviços a medir Lista de checkboxes Ao menos 1

Dentro de uma medição: cada linha traz o quanto já foi medido antes (acumulado anterior), o saldo restante do contrato e dois campos editáveis — quantidade medida e glosa (valor não reconhecido) — enquanto a medição estiver aberta.

Status e ações disponíveis

Status atual Ação Campo pedido
Aberta / Apurada Liberar medição Justificativa (obrigatória se exceder o limite contratado)
Liberada Aprovar Nenhum — gera automaticamente o lançamento financeiro (contas a pagar)
Liberada Devolver Motivo da devolução (obrigatório)
Aprovada / Devolvida Estado final Somente leitura

Diário de obra (RDO)

/rdo

Um registro por dia, com clima, efetivo em obra e ocorrências.

Campo Tipo Obrigatório
Data Data Sim
Clima Texto Não
Efetivo em obra Número Não
Ocorrências Texto longo Não

A tabela "Registros anteriores" abaixo do formulário mostra o histórico completo de dias já registrados.

Financeiro

/financial

Para onde o dinheiro da obra está indo, com visão geral, por etapa e ao longo do tempo.

  • Custo geral da obra — orçamento total, total gasto e restante numa barra segmentada.
  • Gasto por Etapa — navegue entre fases com as setas; botão Ajustar limite redefine o teto de gasto daquela fase.
  • Maiores gastos com materiais — top itens por valor, com link direto para a solicitação de compra.
  • Gastos ao Longo do Tempo — gráfico filtrável por categoria (Mão de obra / Materiais / Equipamentos) e período (7/30/90 dias).

Ajustar limite da fase: campo único Novo limite (R$), obrigatório, mostrando o valor atual como referência.

Histórico financeiro: lista de até 50 eventos recentes — compras, mão de obra, notas — cada um com tipo, data, valor (quando aplicável) e a fase relacionada.

Exportar relatório: dois formatos disponíveis — Excel (.xlsx) e PDF (.pdf), sempre respeitando os filtros de fase/categoria/período ativos na tela.

Investidores e patrocinadores

/investors-and-sponsors

Cadastro de quem acompanha ou financia a obra, com controle de quais módulos cada um pode ver.

Adicionar parceiro

Campo Tipo Obrigatório Observações
Logo Imagem Não JPEG/PNG/WebP, máx. 2 MB
Nome Texto Sim
Categoria Seleção Sim Investidor, Financiamento, Patrocinador
Status Seleção Sim Aprovado, Vigente

Se a categoria for Investidor ou Financiamento: campos Participação (%) e Valor investido (R$), ambos obrigatórios. Se for Patrocinador: campos Benefício (obrigatório) e Duração do contrato (opcional).

Acessos aos módulos

Marque quais telas o parceiro pode ver, entre: Visão geral da obra, Relatórios, Financeiro, Progresso da obra, Documentos, Materiais, Fases da obra, Análise preditiva. O botão Gerenciar acessos, na lista, edita só essas permissões sem abrir o formulário inteiro.

Documentos

/documents

"Arquivos e Projetos" no menu — organizados em quatro categorias fixas, cada uma com suas próprias pastas: Documentos Legais, Projetos Técnicos, Documentos da Obra e Fotos da Obra.

Enviar um documento

Campo Tipo Obrigatório Observações
Arquivo Upload Sim PDF, JPG, PNG, WebP, DWG, DOC/DOCX — até 50 MB
Nome Texto Não Pré-preenchido com o nome do arquivo
Pasta Seleção Não Só aparece se já existir alguma pasta na categoria
Validade Data Não Define quando o documento passa de "Em dia" para "Vencido"

Ações por documento

  • Visualizar — abre o arquivo na própria tela (imagens e PDF têm pré-visualização; os demais formatos vão direto para download).
  • Baixar.
  • Editar — nome e validade.
  • Compartilhar — por e-mail de qualquer pessoa ou buscando um usuário já cadastrado; cada compartilhamento pode ser revogado individualmente.
  • Excluir.

O status Em dia Vencido aparece na coluna Status de cada documento com validade definida.

Equipe

/team

Quem trabalha na obra, presença diária, custo de mão de obra e produtividade por fase.

Convidar membro

Campo Tipo Obrigatório Opções
E-mail E-mail Sim
Papel Seleção Sim Membro da obra, Gestor da obra

O convidado recebe um e-mail com link para criar conta ou entrar direto na obra.

Registrar presença

Marque cada trabalhador como Presente ou Ausente no dia de hoje (não é possível registrar para outra data por aqui). Pelo menos um membro precisa ser marcado.

Nova equipe

Campo Nome da equipe (obrigatório) + seleção opcional de membros já ativos na obra, para agrupá-los e acompanhar presença/retenção coletivamente.

Outros painéis da tela

  • Presença da equipe — métricas do período (presentes, ausentes, equipes, dias trabalhados).
  • Trabalhadores — tabela com status de cada um (Presente / Ausente / Não registrado).
  • Custo de mão de obra — comparativo mês atual x mês anterior, navegável por fase.
  • Produtividade por fase — proporção de tarefas concluídas por fase.

Análise preditiva

/predictive-analysis

Como a obra deve terminar, com base no que já aconteceu até agora.

  • Custo Final Estimado — valor projetado, delta contra o orçamento inicial, e uma barra mostrando base/risco/margem. O botão Ajustar orçamento abre a edição de valores por fase sem sair da tela.
  • Previsão de Entrega — atraso projetado numa linha do tempo com a data-alvo e a data prevista.
  • Diagnóstico inteligente — lista de causas identificadas (etapa, causa, um botão "Resolver" que leva direto para a tela responsável por corrigir aquilo).
  • Evolução Real x Planejado — gráfico filtrável por métrica (Orçamento/Custo) e período (30/60 dias).

O botão Atualizar análise recalcula tudo com os dados mais recentes; Gerar relatório exporta em Excel.

Configurações da obra

/settings

Dados cadastrais, prazo, orçamento, etapas e permissões da obra. Só quem é dono ou gestor pode editar; os demais veem tudo em modo leitura.

  • Informações Gerais — nome, endereço completo (com autopreenchimento por CEP), tipo da obra e o engenheiro responsável — este último só pode ser definido uma vez.
  • Prazo e Cronograma — data de início/conclusão da obra, e reagendamento da data de tarefas já existentes (não cria tarefas novas aqui).
  • Orçamento — orçamento total e o percentual de cada etapa por slider; a soma precisa ficar próxima de 100%.
  • Etapas da Obra — renomeia etapas e ajusta o limite de gasto (R$) de cada uma, individualmente.
  • Permissões e Acessos — tabela de membros com papel (Gestor/Membro, editável direto na linha) e botão para remover acesso.
Em breve

Alertas e Automação, Documentos obrigatórios e Segurança ainda não têm nenhuma opção configurável — são placeholders reservados para versões futuras.

Referência

App mobile

Um companheiro de campo, não uma versão completa do sistema. Pensado para o trabalhador que está na obra todo dia, com uma rotina simples: check-in por localização → checklist de EPI → painel do dia.

  • Check-in por localização — confirma presença via GPS dentro de um raio da obra.
  • Checklist de EPI — segurança obrigatória antes de começar o dia.
  • Painel — calendário da semana, fases, equipe presente no dia, clima.
  • Tarefas da fase — lista simples para marcar como concluídas.
  • Perfil — dados básicos e sair da conta.
Ainda não disponível no mobile

Documentos e Análise preditiva aparecem como abas reservadas ("em breve"). Suprimentos, Financeiro, Medição e RDO não têm tela no aplicativo — use a versão web para esses módulos.

Glossário de status

Os mesmos rótulos de status aparecem em várias telas — aqui está o significado de cada um, reunido num só lugar.

Situação geral da obra

Em ordemAtençãoEm atraso

Viabilidade do projeto

Totalmente viávelCom restriçõesInviável

Status de medição

AbertaApuradaLiberadaAprovadaDevolvida

Status de documento

Em diaVencido

Categorias de insumo

MaterialMão de obraEquipamentoCombustívelFerramentaOutros

Tipo de preço de serviço

ComposiçãoFixoSem composição

Nenhum resultado

Não encontramos nada para . Tente outra palavra-chave, tema ou nome de tela.