Documentação Técnica e Manual do Usuário

Visão Geral da Plataforma

O Sistema de Crédito Verde é uma solução híbrida (Desktop + Web) para gestão completa de ativos financeiros ambientais.

Guia de Instalação (Windows)

  1. Baixe o pacote portátil na página inicial.
  2. Extraia o arquivo ZIP para uma pasta de sua preferência.
  3. Execute o arquivo CreditorVerde.bat.
    • Nota: Não é necessário instalar Python ou bibliotecas manualmente. O pacote já inclui tudo.

Ferramentas Financeiras

1. Calculadora de Conversão

Ferramenta para simular a transformação de Créditos Verdes em ativos para compensação tributária.

Parâmetros:

  • Valor Nominal: Valor de face do ativo.
  • Taxa de Juros: Rendimento anual esperado (padrão: 12% a.a.).
  • Deságio: Percentual de desconto para liquidez imediata (padrão: 30%).

Resultados Gerados:

  • Valor Atualizado: Valor corrigido monetariamente.
  • Valor Líquido (Precatório): Valor final disponível para compensação.
  • Economia Tributária: Ganho financeiro obtido na operação.

2. Geração de Planilhas (Excel)

O sistema exporta automaticamente planilhas compatíveis com os padrões da Receita Federal e PGFN.

Conteúdo do Arquivo (.xlsx):

  • Aba Simulação: Resumo executivo dos valores.
  • Aba Fluxo Projetado: Tabela ano a ano da evolução do ativo.

Arquitetura do Sistema

┌─────────────────────────────────────────────────┐
│          Camada de Apresentação (UI)            │
│  PyQt6 (Desktop) / React (Web)                  │
└──────────────────┬──────────────────────────────┘
                   │
┌──────────────────▼──────────────────────────────┐
│        Camada de Lógica de Negócio              │
│  - Extração de Dados (PDF/OCR)                 │
│  - Validação Regulatória (Circular 3.743/15)   │
│  - Matemática Financeira (Juros/Correção)      │
└──────────────────┬──────────────────────────────┘
                   │
┌──────────────────▼──────────────────────────────┐
│        Camada de Persistência                   │
│  SQLite (Desktop) / LocalStorage (Web)          │
└─────────────────────────────────────────────────┘

Módulos Principais

src/core/validator.py

Validação de dados de ativos.

  • validar_cpf(cpf): Valida dígitos verificadores
  • validar_cnpj(cnpj): Valida dígitos verificadores
  • validar_ativo(dados): Validação completa conforme Circular 3.743/15

src/core/extractor.py

Extração de dados de PDFs.

  • Status, Código do IF, Tipo de Regime
  • Datas (Registro, Emissão, Vencimento)
  • Credor/Detentor/Emitente

Segurança

  • Processamento Local: Seus dados nunca saem do seu dispositivo (na versão Desktop).
  • Criptografia: Conexões seguras (HTTPS) na versão Web.
  • Validação de Entrada: Proteção contra injeção de dados maliciosos.