Download Latest Version Smart_Financeiro_Windows.zip (8.0 MB) Google Add to Preferred Sources
Home / internal / web
Name Modified Size InfoDownloads / Week
Parent folder
templates 2026-10-14
0
web.go 2026-10-14 173 Bytes
0
Totals: 2 Items   173 Bytes 0

🚀 Smart — Sistema Financeiro Inteligente

Plataforma completa de alta performance para Gestão Financeira, Fluxo de Caixa, Conciliação Bancária, Relatórios Gerenciais e Automação de Planilhas Excel.

📌 Sumário

  1. Visão Geral
  2. Diferenciais e Proposta de Valor
  3. Arquitetura e Tecnologias
  4. Como Executar o Sistema
  5. Opção 1: Executável Go Standalone (Recomendado)
  6. Opção 2: Compilando a partir do Código Go
  7. Opção 3: Servidor Web PHP / Apache (Legado/Compatibilidade)
  8. Estrutura do Projeto
  9. Manual de Operação dos Módulos
  10. 6.1 Acesso e Níveis de Permissão
  11. 6.2 Fluxo de Caixa Operacional
  12. 6.3 Filtros Avançados e Cálculo de Saldo Anterior
  13. 6.4 Cadastros Básicos (Admin)
  14. 6.5 Dashboard Gerencial
  15. 6.6 Relatórios Financeiros Padronizados em Excel
  16. 6.7 Relatório Genérico / Injeção em Modelos Excel
  17. 6.8 Suporte Multi-idioma (i18n)
  18. Backups, Restauração, Reparo e Base Demo
  19. Integração e Migração de Dados
  20. Configurações e Parâmetros de Linha de Comando

🌟 Visão Geral

O Smart é uma solução robusta e moderna desenvolvida para proporcionar controle total sobre movimentações bancárias e de caixa. O sistema combina velocidade operacional no dia a dia com rigor contábil e auditoria profunda, eliminando a dependência de planilhas manuais descentralizadas e sistemas legados lentos.

A plataforma opera com dados em tempo real, permitindo rastrear entradas, saídas, transferências, saldos conciliados, previsão de fluxo futuro (contas a pagar/receber) e relatórios executivos como DRE e Curva ABC.

💡 Diferenciais e Proposta de Valor

  • ⚡ Alta Produtividade Operacional:
  • Baixa e Estorno com 1 Clique: Alterne instantaneamente entre títulos abertos e liquidados diretamente na tabela.
  • Cópia Inteligente: Duplique lançamentos recorrentes preservando histórico, categorias e caixas em segundos.
  • Atalhos Rápidos de Filtro: Filtre com 1 clique por Hoje, Semana Atual, Mês Atual ou Cadastrados Hoje.
  • 🎯 Conciliação Bancária com Centavo de Precisão:
  • Consolidação exata de Saldo Anterior considerando todas as transações até às 23:59:59 do dia anterior ao período inicial consultado.
  • Múltiplas contas correntes, caixas físicos, carteiras e aplicações financeiras.
  • 📑 Engine de Injeção em Planilhas Excel Existentes:
  • Motor exclusivo que injeta valores calculados em células específicas (B12, F5, etc.) de arquivos .xlsx corporativos já formatados (com logotipos, fórmulas e identidade visual).
  • 🛡️ Segurança e Auditoria Completa:
  • Exclusão Lógica com Rastreabilidade: Nada é apagado do banco sem registro. Gravação de usuário responsável, data e hora da exclusão.
  • Restauração Rápida: Recupere lançamentos excluídos acidentalmente com um clique.
  • Visão Segregada: Administradores auditam todas as exclusões do sistema; operadores visualizam apenas as suas.
  • 🌐 Nativo, Leve e Multiplataforma:
  • Servidor embutido em Go de alta performance (sem dependência obrigatória de Apache ou serviços pesados).
  • Abertura automática em modo Janela de Aplicativo PWA/Desktop no navegador padrão (Chrome, Edge, Brave, etc.).
  • Banco de dados SQLite 3 com suporte a modo WAL (Write-Ahead Logging) para alta concorrência.

🛠️ Arquitetura e Tecnologias

Camada Tecnologias
Backend Principal Go 1.26+ (Servidor HTTP nativo, roteamento modular, renderização de templates)
Banco de Dados SQLite 3 via driver Pure Go (modernc.org/sqlite - sem necessidade de CGO)
Geração de Planilhas Excelize v2 (github.com/xuri/excelize/v2) para geração e leitura ultrarrápida de arquivos .xlsx
Segurança & Sessão golang.org/x/crypto/bcrypt para hash seguro de senhas e sessões persistentes
Frontend HTML5 Semântico, CSS3 Moderno, JavaScript Vanilla, Chart.js para dashboards gráficos e FontAwesome 6
Internacionalização (i18n) Suporte multilíngue em tempo de execução (Português, English, Español)
Ambiente Legado/Alternativo Compatibilidade opcional com PHP 8.x + Composer (PhpSpreadsheet) via Apache

🚀 Como Executar o Sistema

Opção 1: Executável Go Standalone (Recomendado)

Você pode iniciar o sistema imediatamente executando o binário compilado:

# Executar a aplicação
./smart-app

O aplicativo iniciará o servidor local na porta 8080 e abrirá automaticamente a janela do sistema no navegador.

Para rodar em segundo plano ou customizar parâmetros:

# Executar em porta customizada sem abrir navegador automaticamente
./smart-app -port 9000 -no-browser

Opção 2: Compilando a partir do Código Go

Certifique-se de ter o Go 1.26+ instalado no ambiente:

  1. Baixar dependências: bash go mod download

  2. Executar em modo desenvolvimento: bash go run main.go

  3. Gerar binário de produção: ```bash # Linux / macOS go build -ldflags="-s -w" -o smart-app main.go

# Windows GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o smart-app.exe main.go ```

Opção 3: Servidor Web PHP / Apache (Legado/Compatibilidade)

O sistema mantém retrocompatibilidade com execução via servidor Apache 2 e PHP 8.x:

  1. Requisitos:
  2. PHP 8.0+ com as extensões pdo_sqlite, sqlite3, gd, zip, xml, mbstring.

  3. Apache 2 com módulo rewrite ativo.

  4. Permissões do SQLite: bash sudo chown -R $USER:www-data . sudo chmod -R 775 .

  5. Configuração rápida do VirtualHost: Execute o script utilitário incluído no repositório: bash sudo ./php/atualizar_apache.sh

📂 Estrutura do Projeto

smart-go/
├── main.go                      # Ponto de entrada do servidor Go e launcher desktop
├── go.mod / go.sum              # Definição e lock de dependências do Go
├── smart-app                    # Binário executável compilado do sistema
├── smart.sqlite                 # Arquivo de banco de dados SQLite de produção
├── smart (default).sqlite       # Template de banco de dados zerado/padrão
├── internal/                    # Módulos internos do backend Go
│   ├── db/                      # Inicialização, migrações e conexão SQLite
│   ├── models/                  # Structs de dados (Fluxo, Contas, Usuários, etc.)
│   ├── repository/              # Camada de acesso a dados e consultas SQL
│   ├── server/                  # Handlers HTTP, rotas, relatórios e controle de sessão
│   ├── i18n/                    # Mecanismo de tradução dinâmica
│   └── web/                     # Templates e assets web embutidos
├── lang/                        # Dicionários de idiomas (pt.php, en.php, es.php)
├── backups/                     # Diretório de cópias de segurança automáticas (.sqlite / .zip)
├── saida/                       # Diretório de planilhas Excel geradas para download
├── style/                       # Folhas de estilo CSS da aplicação
├── php/                         # Arquivos e utilitários do ambiente PHP/Apache legado
│   ├── includes/                # Funções e bibliotecas de apoio PHP
│   ├── vendor/                  # Dependências Composer (PhpSpreadsheet)
│   ├── index.php / login.php    # Scripts PHP originais
│   └── atualizar_apache.sh      # Script de configuração do VirtualHost Apache
├── exportar.py / exportar_windows.py # Scripts de migração de bases legadas Access (.mdb)
└── smart.desktop                # Atalho para integração no menu de aplicativos Linux

📖 Manual de Operação dos Módulos

6.1 Acesso e Níveis de Permissão

  • URL Padrão: http://localhost:8080/ (ou http://smart/ no Apache).
  • Credenciais Iniciais Padrão (Ambiente Novo / Demo):
  • Administrador: Usuário admin | Senha admin123
  • Operador: Usuário operador | Senha user123
  • Perfis de Acesso:
  • 👑 Administrador: Acesso irrestrito a todos os caixas, auditoria global de exclusões, relatórios executivos, cadastros e gestão de usuários.
  • 👤 Operador (Comum): Acesso a lançamentos, consultas, baixas e relatórios operacionais. Caixas marcados como restritos da diretoria ficam ocultos.

6.2 Fluxo de Caixa Operacional

A grade principal centraliza o trabalho diário de movimentação:

  1. Novo Lançamento (+):
  2. Caixa / Conta: Selecione a conta de movimentação.
  3. Data de Movimento: Data do efetivo desembolso ou recebimento financeiro.
  4. Data de Ocorrência: Data de competência ou vencimento do título.
  5. Plano de Contas: Classificação orçamentária com mnemônico para busca rápida.
  6. Documento & Histórico: Detalhamento da nota fiscal, fatura, recibo ou contrato.
  7. Entrada / Saída: Valor monetário do crédito ou débito.
  8. Situação: Baixado (liquidado) ou Aberto (pendente).
  9. Cópia Rápida de Registros: Selecione um lançamento e clique em Copiar para duplicar a estrutura do registro instantaneamente.
  10. Baixa e Estorno Direto na Tabela: Clique sobre o badge de situação na coluna correspondente para alternar o status sem abrir telas modais.
  11. Exclusão Lógica e Auditoria: Registros excluídos permanecem salvos com auditoria do autor e data/hora. Podem ser consultados e restaurados a qualquer momento.

6.3 Filtros Avançados e Cálculo de Saldo Anterior

  • Busca Textual com "Não Contém": Permite filtrar descrições ou excluir palavras-chave específicas.
  • Multiseleção: Filtre múltiplos caixas e categorias simultaneamente.
  • 4 Tipos de Períodos Temporais:
  • Data de Movimento (pagamento/recebimento);
  • Data de Ocorrência (vencimento/competência);
  • Data de Cadastro (inclusão no banco);
  • Data de Atualização (última modificação).
  • Saldo Anterior Rigoroso: Ao ativar a opção de Saldo Anterior com uma data inicial, o sistema processa todas as entradas e saídas ocorridas até as 23:59:59 do dia anterior, exibindo o saldo acumulado e somando-o aos totais consolidados da consulta.

6.4 Cadastros Básicos (Admin)

  • Plano de Contas:
  • Classificação em Receitas e Despesas.
  • Mnemônico: Código alfanumérico curto para digitação ágil (ex: VEND, ALUG, FOLH).
  • Identificação Visual: Cores temáticas para cada categoria facilitando a leitura na grade.
  • Caixas e Bancos:
  • Cadastro de contas correntes, poupanças, aplicações e numerários em caixa.
  • Flag de Caixa Restrito (acessível exclusivamente por administradores).
  • Usuários:
  • Criação de novos operadores, definição de perfis e bloqueio/desativação de contas sem perda do histórico de lançamentos.

6.5 Dashboard Gerencial

Acessível no menu superior, exibe a saúde financeira da empresa em tempo real:

  • Cards de Indicadores: Total de Entradas, Total de Saídas e Saldo Líquido do período filtrado.
  • Top 10 Despesas: Gráfico detalhando onde estão os maiores custos operacionais.
  • Top 10 Receitas: Principais fontes geradoras de faturamento.
  • Evolução Diária: Confronto gráfico diário de entradas vs saídas no mês.

6.6 Relatórios Financeiros Padronizados em Excel

Emissão com um clique em arquivos formatados .xlsx:

Relatório Descrição
Sintético Visão agregada por Plano de Contas com subtotais de receitas e despesas.
Analítico Listagem discriminada de cada lançamento agrupada por categoria orçamentária.
Listagem Financeira Espelho detalhado dos lançamentos respeitando exatamente os filtros aplicados em tela.
Fluxo Futuro Contas a pagar e a receber ordenadas por data de vencimento/ocorrência.
DRE Financeiro Demonstrativo de Resultado mensal confrontando receitas e despesas operacionais.
Curva ABC Análise de Pareto ordenando gastos e receitas por relevância financeira percentual.

6.7 Relatório Genérico / Injeção em Modelos Excel

O módulo de Relatório Genérico permite automatizar o preenchimento de planilhas customizadas já utilizadas pela empresa:

  1. Configuração da Programação: Faça upload ou aponte uma planilha base (ex: programacao.xlsx).
  2. Mapeamento de Células: Defina quais células da planilha receberão as somatórias:
  3. Aba / Pasta de Trabalho: ex: Resumo, Financeiro.
  4. Célula Alvo: ex: D15, H8.
  5. Filtros do Valor: Plano de Contas, Caixa de movimentação e campo (valorentrada ou valorsaida).
  6. Execução: Ao processar, o sistema gera uma nova planilha na pasta saida/ com todos os valores preenchidos e fórmulas originais preservadas.

6.8 Suporte Multi-idioma (i18n)

O sistema conta com tradução completa e alternância de idioma em tempo de execução:

  • 🇧🇷 Português (Brasil)
  • 🇺🇸 English (US)
  • 🇪🇸 Español

💾 Backups, Restauração, Reparo e Base Demo

Backup e Restauração

  • O sistema inclui módulo completo para download de cópia de segurança em arquivo .sqlite ou compactado em .zip.
  • Permite restaurar bases anteriores com verificação de integridade e criação prévia de ponto de restauração.

Base de Demonstração e Limpeza

Para inicializar ambientes de homologação ou zerar dados para produção:

  • Gerar Demonstração (Demo): Popula a base com 5 contas realistas, 17 categorias de planos de contas e ~50 lançamentos distribuídos entre passado, presente e futuro para testes operacionais. bash php gerar_demo.php # ou via interface em Cadastros > Limpeza / Base Demo
  • Zerar Base para Produção: Remove movimentações preservando a estrutura padrão e o usuário administrador. bash php limpar_base.php --limpar --confirmar

🔄 Integração e Migração de Dados

Para migrar bases legadas a partir do Microsoft Access (gestor.mdb):

  • Windows (exportar_windows.py): Utiliza o driver oficial ODBC (pyodbc) e migra automaticamente as tabelas contas, planodecontas e fluxo: ```bash pip install pyodbc # Migra todas as tabelas (contas, planodecontas e fluxo): python exportar_windows.py

# Ou migra uma tabela específica: python exportar_windows.py contas python exportar_windows.py planodecontas python exportar_windows.py fluxo ```

  • Script Unificado (importar.py): Compatível com Windows (PowerShell/pyodbc) e Linux, com suporte a MDB e CSV individual: bash python3 importar.py
  • Linux (exportar.py): Utiliza mdb-export (mdbtools) para extrair e migrar contas, planodecontas e fluxo: bash python3 exportar.py
  • Interface Web: Na tela inicial, utilize o modal de importação (ícone de nuvem/importar) e escolha a tabela de destino (Todas as tabelas, Fluxo, Contas ou Plano de Contas).

⚙️ Configurações e Parâmetros de Linha de Comando

Ao iniciar o binário Go (./smart-app ou go run main.go), os seguintes parâmetros estão disponíveis:

Parâmetro / Flag Variável de Ambiente Padrão Descrição
-port <número> PORT 8080 Porta TCP do servidor web HTTP
-db <caminho> SMART_DB smart.sqlite Caminho do arquivo de banco de dados SQLite
-kiosk SMART_KIOSK false Inicia em modo quiosque cobrindo a barra de tarefas (padrão abre maximizado com barra de tarefas visível)
-no-browser - false Impede a abertura automática da janela do navegador ao iniciar

📄 Licença e Direitos

Desenvolvido para gestão financeira corporativa ágil, segura e estratégica. Todos os direitos reservados.

Source: README.md, updated 2026-10-14