📚 Guia de Uso — SGO

🌟 Introdução

O SGO é o sistema central de gestão financeira e operacional da ART Incorporadora. Ele organiza todas as obras, controla despesas, receitas, investidores e gera relatórios gerenciais.

🆂 Status dos Lançamentos

Cada lançamento possui um status que define onde ele aparece nos relatórios:

📈 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 x receitas por obra em barras
• Alertas de investidores: vencimentos próximos nos próximos 15 dias
• Obras ativas: cards com indicador colorido e progresso 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), Cor identificadora
3. Salve — a obra aparece imediatamente no menu lateral

Abas dentro de cada obra

💳 Lançamentos (Despesas)

Criar um lançamento

1. Dentro da obra, clique em + Lançamento (canto superior direito)
2. Preencha: Data, Descrição, Fornecedor, Categoria, Valor
3. Opcional: Chave Pix do fornecedor (para facilitar o pagamento depois)
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 ou ajuste: valor, fornecedor, descrição, categoria, investidor
3. Selecione o status: Pago (padrão) ou Aguardando Pagamento
4. Opcional: Anexe o comprovante (PDF ou imagem)
5. Se for pago pelo cartão de um sócio, marque a opção Parcelado no cartão (ver seção abaixo)
6. Clique em Confirmar Pagamento

Filtros da tabela de lançamentos

Use os campos acima da tabela para filtrar por: ID, Data, Valor mínimo/máximo e Status. Os totais filtrados são exibidos automaticamente.

Comprovantes

Clique no botão 📎 na linha do lançamento para ver todos os comprovantes anexados. Você pode abrir cada arquivo diretamente no navegador.

♻️ Despesas Recorrentes

Despesas que ocorrem todo mês (aluguel de equipamento, FGTS, mensalidade de serviço) podem ser cadastradas uma única vez e o sistema as gera automaticamente todo mês.

Como funciona

1. Acesse a aba Recorrentes dentro da obra
2. Clique em + Nova Recorrente
3. Preencha: Descrição, Fornecedor, Categoria, Valor, Chave Pix e Dia de vencimento (1 a 28)
4. Salve — todo mês, no dia configurado, o sistema cria automaticamente um lançamento com status Aguardando Pagamento

Geração manual

Se precisar gerar o lançamento do mês atual sem esperar o cron, 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 temporariamente uma recorrente sem excluí-la. Recorrentes inativas não geram lançamentos automaticamente.

💴 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 para evitar duplicidade nos totais.

Como registrar

1. Clique em 💳 Pagar no lançamento
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 o status 💴 Parcelado e as parcelas são criadas automaticamente

Gerenciar parcelas

1. Na tabela de lançamentos, clique em 💴 Parcelas na linha com status Parcelado
2. O modal mostra cada parcela com data de vencimento, valor e status
3. Clique em Pagar para registrar o reembolso de uma parcela
4. Quando todas as parcelas forem pagas, o lançamento vai automaticamente para Pago

Cancelar parcelamento

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

💰 Recebimentos

Registre toda entrada de dinheiro da obra: vendas de unidades, aportes de investidores, reembolsos, etc.

1. Na aba Recebimentos da obra, clique em + Recebimento
2. Preencha: Data, Valor, Conta de destino, Referência (ex: “Sinal de venda — Apto 201”), Corretor e Cliente
3. Salve — o valor é somado ao fluxo de caixa e ao DRE da obra

👤 Investidores

Cadastro de investidor

1. No menu lateral, clique em Investidores → + Investidor
2. Preencha nome, CPF, telefone e dados báncos (Pix)

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

Tipos de remuneração

📊 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 ou PDF.

💾 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.

Backup automático no MEGA

1. Configure as credenciais da conta MEGA (e-mail e senha)
2. Ative o backup automático e configure horário e dias da semana
3. O sistema enviará o backup automaticamente para o MEGA no horário configurado

Restaurar backup

1. Clique em Restaurar Backup
2. Selecione o arquivo ZIP gerado pelo SGO
3. Confirme a restauração

👥 Usuários e Permissões

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

Responsável financeiro

O usuário marcado como Responsável financeiro recebe as notificações do Bot WhatsApp (pagamentos confirmados, despesas recorrentes geradas, alertas de resgates). Configure o número de WhatsApp nas configurações do usuário.

📱 Bot WhatsApp

O Bot envia notificações automaticamente para os grupos e números configurados.

Conectar o Bot

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

Notificações enviadas automaticamente

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