📚 Guia de Uso — SGO

🌟 Introdução

O SGO é o sistema central de gestão da ART Incorporadora. Ele organiza todas as obras, controla despesas e receitas, gerencia investidores, unidades à venda e gera relatórios gerenciais completos. O acesso é pelo navegador e funciona em computador, tablet e celular.

Navegação básica

O menu lateral esquerdo organiza todas as áreas do sistema. As obras ativas aparecem no topo; obras com status Concluída ficam numa seção colapsável Concluídas (N) no final da lista. Clique no nome de qualquer obra para abri-la.

🆂 Status dos Lançamentos

Todo lançamento possui um status que define onde ele aparece nos relatórios e no dashboard:

📈 Dashboard

A tela inicial apresenta um resumo consolidado de todas as obras:

• Métricas no topo: total de despesas, receitas, saldo e contas a pagar
• Gráfico de obras: compara despesas × receitas por obra em barras
• Alertas de investidores: vencimentos próximos nos próximos 15 dias
• Progresso por obra: cards com indicador de avance financeiro

🏗 Obras

Criar uma nova obra

1. Clique em + Nova Obra no menu lateral (visível para admin e operador)
2. Preencha: Nome, Status (Em andamento / Concluída / Pausada) e Orçamento (opcional)
3. Salve — a obra aparece imediatamente no menu lateral

Abas dentro de cada obra

Obras concluídas

Obras com status Concluída são automaticamente movidas para a seção Concluídas (N) no final do menu lateral, que fica colapsada por padrão. Clique nela para expandir e acessar as obras concluídas.

Editar ou excluir uma obra

Acesse Configurações → Obras. Cada obra tem botões para editar (nome, status, orçamento) e excluir. A exclusão é permanente e requer confirmação dupla.

🏠 Unidades de Obra

Cada obra pode ter unidades cadastradas (apartamentos, lotes, casas). O sistema acompanha o status de venda de cada unidade.

Cadastrar unidade

1. Dentro da obra, acesse a aba Unidades
2. Clique em + Nova Unidade
3. Preencha: Unidade (ex: “Apto 101”), Complemento (ex: “Bloco A”), Área, Valor de Venda e Status
4. Salve — a unidade aparece na tabela

Status das unidades

Como reservar uma unidade

1. No formulário da unidade, selecione o status Reservada
2. Um modal abrirá pedindo os dados da reserva: Nome do comprador (obrigatório), Telefone do comprador, Nome do corretor e Telefone do corretor
3. Confirme a reserva — a unidade fica marcada com o badge laranja Reservada

💰 Recebimentos

Registre toda entrada de dinheiro da obra: sinais, entradas, parcelas, quitações, aportes de investidores, reembolsos etc.

Criar um recebimento

1. Na aba Recebimentos da obra, clique em + Recebimento
2. Selecione a Unidade a que o pagamento se refere (opcional, mas recomendado)
3. Ao selecionar a unidade, os campos Corretor e Cliente são preenchidos automaticamente
4. Escolha o Tipo do recebimento
5. Preencha: Data, Valor, Conta de destino e Referência
6. Salve — o valor é somado ao fluxo de caixa e ao DRE da obra

Tipos de recebimento

👉 Deduções

Deduções são abatimentos da receita bruta da obra: comissões de correto, impostos, taxas de cartório etc. Elas afetam o cálculo da Receita Líquida no DRE.

Cadastrar uma dedução

1. Dentro da obra, acesse a aba Deduções
2. Clique em + Nova Dedução
3. Preencha: Descrição e Valor
4. Salve. Depois, clique em ✏ editar para adicionar Recebedor, Data de Pagamento e Comprovante

💳 Lançamentos (Despesas)

Criar um lançamento

1. Dentro da obra, na aba Custos, clique em + Lançamento
2. Preencha: Data, Descrição, Fornecedor, Categoria e Valor
3. Opcional: Chave Pix do fornecedor (aparece no modal de pagamento para facilitar)
4. Salve — o lançamento aparece na tabela com status Aguardando Pagamento

Realizar um pagamento

1. Na linha do lançamento, clique em 💳 Pagar
2. Confira os dados: valor, fornecedor, descrição, categoria e investidor
3. Selecione o novo status: Pago (padrão), Aguardando Pagamento ou Pendente
4. Opcional: anexe o Comprovante (PDF ou imagem)
5. Se o pagamento foi feito no cartão de um sócio, marque 💴 Pago com cartão (parcelado) — veja a seção “Parcelado no Cartão”
6. Clique em Confirmar Pagamento

Filtros da aba Custos

Use os campos acima da tabela para filtrar por:

• ID — número do lançamento
• Data início / Data fim
• Valor mínimo / máximo
• Status — Pago, Aguardando Pagamento, Pendente, Parcelado, Agendado
• Categoria — filtra pelas categorias já utilizadas na obra
• Investidor — filtra lançamentos vinculados a um investidor específico

Os totais filtrados são exibidos automaticamente abaixo dos filtros. Clique em Limpar para remover todos os filtros de uma vez.

Comprovantes

Clique no botão 📎 na linha do lançamento para ver todos os comprovantes anexados. Cada arquivo pode ser aberto diretamente no navegador.

Editar um lançamento

Clique no botão ✏ (lápis) na linha do lançamento para abrir o formulário de edição com todos os campos pré-preenchidos.

Badges de repartimento

Lançamentos que foram divididos entre obras exibem badges na coluna Descrição:

• ⚖ Repartido — este é o lançamento original que teve parte transferida para outra obra. Passe o mouse para ver para qual obra foi repartido.
• ⚖ Cópia — este lançamento foi gerado pelo repartimento de outro. Passe o mouse para ver a origem.

♻️ Despesas Recorrentes e Futuras

Cadastre despesas que ocorrem periodicamente ou em uma data futura específica. O sistema gera os lançamentos automaticamente sem nenhuma ação sua.

Tipo Recorrente — despesa mensal

Use para despesas que se repetem todo mês: aluguel de equipamento, FGTS, mensalidade de software etc.

1. Na aba Recorrentes da obra, clique em + Nova Recorrente
2. Em Tipo, selecione Recorrente
3. Preencha: Descrição, Fornecedor, Categoria, Valor e Dia de vencimento (1 a 28)
4. Opcional: Quantidade de meses (deixe em branco para tempo indeterminado), Forma de Pagamento (PIX ou Boleto) e Comprovante padrão
5. Salve — todo mês no dia configurado um lançamento é criado automaticamente com status Agendado

Tipo Futura — despesa de data única

Use para uma despesa que vai acontecer uma única vez em uma data futura já conhecida.

1. Clique em + Nova Recorrente
2. Em Tipo, selecione Futura
3. Preencha os dados e selecione a Data de vencimento exata
4. Salve — quando a data chegar, o lançamento é gerado e a recorrente se desativa automaticamente

Como os agendados funcionam

Quando o sistema gera um lançamento de uma recorrente ou futura, ele cria com status 📅 Agendado. No dia do vencimento, o status muda automaticamente para Aguardando Pagamento e o responsável financeiro recebe uma notificação no WhatsApp.

Ver os agendamentos de uma recorrente

Na tabela de recorrentes, clique no botão 📅 N (onde N é a quantidade) em qualquer linha para expandir a lista de lançamentos já agendados. Cada agendado pode ser cancelado individualmente clicando em ✕.

Geração manual

Se precisar gerar o lançamento do mês atual sem esperar o cron automático, clique no botão ♻ Gerar na linha da recorrente. Se o lançamento já existir para o mês, o sistema avisa e não duplica.

Ativar / Inativar

Use o toggle Ativa / Inativa para suspender uma recorrente sem excluí-la. Recorrentes inativas não geram lançamentos automaticamente.

Duplicar uma recorrente

Clique no botão 📋 Duplicar para abrir o formulário pré-preenchido com os dados da recorrente selecionada. Útil para criar variações de uma mesma despesa.

💴 Parcelado no Cartão do Sócio

Quando um sócio paga um fornecedor com o cartão de crédito pessoal e divide o reembolso ao longo de vários meses, use esta funcionalidade. O custo total é contabilizado normalmente no DRE; as parcelas representam apenas o calendário de reembolso ao sócio.

Como registrar um parcelamento

1. No lançamento, clique em 💳 Pagar
2. Marque a caixa 💴 Pago com cartão de crédito (parcelado)
3. Preencha: Número de parcelas, Sócio responsável e Data da 1ª parcela
4. Confirme — o lançamento vai para 💴 Parcelado e as parcelas são criadas automaticamente

Registrar o reembolso de uma parcela

1. Na tabela, clique em 💴 Parcelas no lançamento com status Parcelado
2. O modal mostra cada parcela com data de vencimento, valor e status
3. Clique em Pagar na parcela do mês que foi reembolsada
4. Quando todas as parcelas forem pagas, o lançamento muda automaticamente para Pago

Cancelar parcelamento

No modal de parcelas, clique em Cancelar parcelamento para reverter o lançamento para Aguardando Pagamento. Todas as parcelas são removidas.

✎ Mover e Repartir Lançamentos

Duas operações exclusivas para administradores que permitem reorganizar lançamentos entre obras.

Mover lançamento para outra obra

Use quando um lançamento foi criado na obra errada e precisa ser transferido integralmente.

1. Na linha do lançamento, clique no botão ✄ (tesoura)
2. Um modal aparece com um resumo do lançamento e um select de obras
3. Selecione a obra de destino e confirme
4. O lançamento desaparece da obra atual e aparece na obra de destino com um novo número de ID

Repartir lançamento entre duas obras

Use quando uma despesa deve ser dividida entre duas obras (ex: uma compra de material que serve para dois empreendimentos).

1. Na linha do lançamento, clique no botão ⚖ (balança)
2. Selecione a obra de destino
3. Escolha o modo: R$ Valor (informe o valor a transferir) ou % Percentual (informe a porcentagem)
4. Um preview em tempo real mostra quanto fica em cada obra
5. Confirme — o lançamento original tem seu valor reduzido e um novo lançamento (cópia) é criado na obra destino

📈 Vendas

Acesse pelo menu lateral em Vendas. Esta página consolida todas as unidades vendidas em todas as obras com métricas de desempenho comercial.

O que você encontra

• Tabela de vendas: obra, unidade (complemento + nome), cliente, corretor, data do contrato, valor da venda, total recebido e saldo a receber
• Total Recebido (badge roxo): soma de todos os recebimentos já registrados para aquela unidade, com o percentual do VGV já recebido
• Saldo a Receber: valor da venda menos o total já recebido

Filtros disponíveis

Use os filtros no topo para refinar por Obra, Status da unidade, Corretor e Período (data do contrato).

👤 Investidores

Cadastrar um investidor

1. No menu lateral, clique em Investidores → + Investidor
2. Preencha: nome, CPF (com validação automática), telefone e dados de Pix
3. Para o endereço: informe o CEP e clique fora do campo — logradouro, bairro e cidade são preenchidos automaticamente via ViaCEP

Vincular investidor a uma obra

1. Dentro da obra, acesse a aba Investidores
2. Clique em + Adicionar Investidor
3. Selecione o investidor e configure: Valor aportado, Data do aporte, Data de resgate, Tipo de remuneração
4. Opcional: anexe o Contrato e o Comprovante de aporte

Tipos de remuneração

Registrar pagamento de resgate

1. Na aba Investidores da obra, clique em ✏ no investidor
2. Preencha a Data de pagamento do resgate e anexe o Comprovante de resgate
3. Salve — o histórico fica registrado na linha do investidor

Resumo geral de investidores

Na página Geral → Investidores, você vê uma tabela consolidada com todos os aportes de todos os investidores em todas as obras, com contagem regressiva do prazo de resgate colorida: 🔴 vermelho (vencido), 🟠 laranja (vence em até 30 dias), 🟢 verde (prazo confortável).

📊 Relatórios

Acesse pelo menu Relatórios. Use os filtros de Obra e Período no topo para refinar os dados. Todos os relatórios podem ser exportados para Excel clicando em 📥 Exportar Excel.

🔎 Histórico (Audit Log)

O Audit Log registra toda ação realizada no sistema: criação, edição e exclusão de qualquer registro, além de logins e tentativas de acesso. É a ferramenta para investigar quem fez o quê e quando.

Como acessar

Clique em Audit Log no menu lateral (visível apenas para administradores), ou acesse por Configurações → Log → aba Audit Log.

Filtros disponíveis

• Entidade: tipo de registro afetado (lançamento, obra, investidor, usuário etc.)
• Ação: tipo de operação (criar, editar, excluir, login, login_falhou)
• Usuário: quem realizou a ação
• Período: data inicial e data final
• Busca livre: pesquisa no campo descrição

O que cada registro mostra

📱 Bot WhatsApp — Configuração

O Bot WhatsApp tem duas funções principais: criar despesas diretamente de mensagens enviadas nos grupos das obras, e enviar notificações automáticas para os responsáveis.

Conectar o Bot

1. Acesse Configurações → WhatsApp Bot
2. Aguarde o QR Code aparecer (pode levar alguns segundos)
3. No celular: abra o WhatsApp → Menu (3 pontos) → Aparelhos conectados → Conectar aparelho
4. Escaneie o QR Code — o status muda para Conectado ✅

Configurar o grupo de cada obra

1. Dentro da obra, acesse a aba WhatsApp
2. No campo Nome do grupo no WhatsApp, informe o nome exato (ou parte do nome) do grupo da obra no WhatsApp
3. Clique em 🔍 Verificar no WhatsApp para confirmar se o bot encontrou o grupo
4. Se encontrado, aparece ✅ nome do grupo (encontrado); se não, ❌ não encontrado
5. Clique em Salvar

Configurar o parser de mensagens

Em Configurações → WhatsApp, escolha como o bot interpreta as mensagens:

Para usar o modo Gemini, informe sua Chave de API do Google Gemini no campo indicado.

Como criar uma despesa pelo WhatsApp

1. No grupo da obra no WhatsApp, envie uma mensagem com o valor e descrição da despesa. Exemplos: “Pago R$ 450,00 para o pedreiro” ou “Material de construção R$1.200”
2. O bot detecta a mensagem e responde com um resumo da despesa para confirmação (valor, categoria, fornecedor, chave Pix se encontrada)
3. Responda ✅ (ou apenas "sim") para confirmar — o lançamento é criado automaticamente no SGO
4. Responda ❌ (ou "não") para cancelar
5. Opcional: envie uma foto da nota fiscal junto com a mensagem — ela será salva como comprovante do lançamento

🔔 Notificações Automáticas

Além da criação de despesas, o bot envia os seguintes avisos automaticamente:

Testar o envio de mensagem

Em Configurações → WhatsApp, use o formulário de Mensagem de teste para enviar uma mensagem avulsa a qualquer número (com DDI, ex: 5562912345678).

👥 Usuários e Permissões

Gerenciado em Configurações → Usuários (somente administradores).

Responsável financeiro

Marque o usuário como Responsável financeiro e informe o Número de WhatsApp (com DDD, sem o nono dígito extra se o número for antigo). Esse usuário receberá todas as notificações automáticas do bot.

Trocar a própria senha

Acesse Configurações → Conta e use o formulário Alterar Senha. Informe a senha atual e a nova senha duas vezes.

🔐 Autenticação em 2 Fatores (2FA)

Uma camada extra de segurança que exige um código enviado por WhatsApp além da senha normal. Recomendado para administradores.

Ativar o 2FA

1. Acesse Configurações → Usuários e edite o usuário desejado (ou peça ao admin)
2. Marque a opção 🔐 Ativar autenticação em 2 fatores via WhatsApp
3. Certifique-se de que o campo WhatsApp do usuário está preenchido corretamente
4. Salve

Como fazer login com 2FA ativo

1. Na tela de login, informe e-mail e senha normalmente e clique em Entrar
2. Uma tela de verificação 🔐 aparecerá pedindo o código de 6 dígitos
3. Verifique o WhatsApp — o bot enviará o código em até 1 minuto
4. Digite o código e clique em Verificar
5. Se não recebeu, clique em Reenviar código; se quiser cancelar, clique em Voltar

⏰ Agendamentos (Crons)

Configure os horários em que o sistema executa as tarefas automáticas. Acesse em Configurações → Agendamentos (somente administradores).

Alterar os horários

1. Em Configurações → Agendamentos, ajuste a Hora e o Minuto de cada cron
2. Clique em Salvar horários — a mudança entra em vigor imediatamente, sem precisar reiniciar o sistema

🏠 Empresa e Logo

Personalize o sistema com o logotipo e os dados da sua empresa.

Carregar o logotipo

1. Acesse Configurações → Conta
2. Na seção Logo do Sistema, clique em Escolher arquivo e selecione uma imagem (JPG, PNG — máx. 5 MB)
3. Um preview (130 × 65 px) é exibido antes de salvar
4. Clique em Salvar — o logo aparece no topo da barra lateral e na tela de login

💾 Backup e Restauração

Acesse em Configurações → Backup (somente administradores).

Download manual

Clique em 💾 Download do Backup para baixar um arquivo ZIP contendo todos os dados do banco e os comprovantes enviados. Guarde este arquivo em local seguro.

Backup automático no MEGA

1. Informe as credenciais da conta MEGA (e-mail e senha)
2. Ative o backup automático e configure o horário e os dias da semana
3. O sistema enviará o backup automaticamente para o MEGA no horário configurado
4. O backup anterior no MEGA é substituído pelo novo (apenas o mais recente é mantido)

Restaurar backup

1. Clique em Restaurar Backup
2. Selecione o arquivo ZIP gerado pelo SGO
3. Confirme a restauração — o sistema reinicia automaticamente após o processo

🔄 Atualização do Sistema

Verifique e instale novas versões do SGO diretamente pelo sistema, sem contato técnico.

Como atualizar

1. Acesse Configurações → 🔄 Atualização (somente administradores)
2. O sistema exibe a versão atual instalada e a versão disponível no servidor
3. Se houver nova versão, o botão 🔄 Atualizar aparecerá
4. Clique em Atualizar e acompanhe o progresso em tempo real no log da tela
5. Após concluir com sucesso, a página recarrega automaticamente em 5 segundos com a nova versão

SGO — Sistema Gerenciador de Obras · ART Incorporadora · Versão 1.2 · 2026