Simulador completo de taxas de adquirência — MDR Padrão, MDR Flex e Antecipações — baseado em vendas no cartão.
Este projeto é a base para o futuro app LiquiCalc, uma calculadora simples e eficiente para vendedores e lojistas descobrirem quanto realmente vão receber após taxas e prazos.
Desenvolver uma ferramenta gratuita e acessível que auxilie qualquer pessoa a entender, simular e calcular os valores líquidos de vendas feitas no crédito/débito, considerando:
- Taxas de adquirência (MDR padrão e flexível)
- Antecipação de recebíveis
- Impacto dos prazos e bandeiras no valor final
- Comparação entre modalidades de recebimento
O foco é mostrar de forma clara e precisa quanto o cliente realmente recebe, em cada cenário de venda.
Escolha a versão que melhor se encaixa com o seu objetivo:
- Planilha Excel: Acesse
1_simulacoes/0_excel/e abra o arquivo.xlsxda versão desejada. - Script .bat (modo texto): Vá até
1_simulacoes/1_calculadora-bat/e execute o arquivo.bat. - Simulador Web: Abra o arquivo
index.htmlem1_simulacoes/2_simulador-web/no navegador.
Nenhuma instalação é necessária. Tudo funciona de forma local e offline.
📦 LiquiCalc
├── 📁 0_conceitos/ # Fundamentos técnicos e explicações de cálculo
│ ├── 📄 README.md
│ ├── 📄 0_mdr-padrao.md # Explicação da MDR padrão: conceito, fórmula e aplicação
│ ├── 📄 1_mdr-flex.md # Explicação da MDR flexível (fator 1 e fator 2)
│ └── 📄 2_antecipacao.md # Como funciona a antecipação de recebíveis e seu impacto nos valores
│
├── 📁 1_simulacoes/
│ ├── 📁 0_excel/
│ │ ├── 📄 README.md
│ │ ├── 📁 0_LiquiCalc.2.3v/ # Versão consolidada com todos os cálculos em um único arquivo
│ │ │ └── 📄 LiquiCalc.2.3.xlsx
│ │ ├── 📁 1_simulador_mdr-padrao2.0v/ # Simulador exclusivo para cálculo da MDR padrão
│ │ │ └── 📄 simulador_mdr-padrao.xlsx
│ │ ├── 📁 2_simulador_mdr-flex2.1v/ # Simulador exclusivo para cálculo da MDR flexível
│ │ │ └── 📄 simulador_mdr-flex.xlsx
│ │ └── 📁 3_simulador_antecipacao2.2v/ # Simulador para MDR padrão + antecipação de recebíveis
│ │ └── 📄 simulador_antecipacao.xlsx
│ │
│ ├── 📁 1_simulador-bat/
│ │ ├── 📄 README.md
│ │ ├── 📁 0_LiquiCalc.3.3v/ # Versão consolidada com todos os cálculos em um único script
│ │ │ └── 📄 LiquiCalc.3.3.bat
│ │ ├── 📁 1_simulador_mdr-padrao3.0v/ # Script exclusivo para cálculo da MDR padrão
│ │ │ └── 📄 simulador_mdr-padrao.bat
│ │ ├── 📁 2_simulador_mdr-flex3.1v/ # Script exclusivo para cálculo da MDR flexível
│ │ │ └── 📄 simulador_mdr-flex.bat
│ │ └── 📁 3_simulador_antecipacao3.2v/ # Script para MDR padrão + antecipação de recebíveis
│ │ └── 📄 simulador_antecipacao.bat
│ │
│ └── 📁 2_simulador-web/ # Simulações web interativas com HTML, CSS e JS
│ ├── 📄 README.md
│ ├── 📁 0_LiquiCalc.4.3v/ # Versão consolidada com todos os cálculos em uma única interface
│ │ ├── 📄 index.html
│ │ ├── 📄 style.css
│ │ └── 📄 script.js
│ ├── 📁 1_simulador_mdr-padrao4.0v/ # Simulador exclusivo para cálculo da MDR padrão
│ │ ├── 📄 index.html
│ │ ├── 📄 style.css
│ │ └── 📄 script.js
│ ├── 📁 2_simulador_mdr-flex4.1v/ # Simulador exclusivo para cálculo da MDR flexível
│ │ ├── 📄 index.html
│ │ ├── 📄 style.css
│ │ └── 📄 script.js
│ └── 📁 3_simulador_antecipacao4.2v/ # Simulador para MDR padrão + antecipação de recebíveis
│ ├── 📄 index.html
│ ├── 📄 style.css
│ └── 📄 script.js
│
├── 📁 2_testes/
│ ├── 📄 README.md # Visão geral dos testes: objetivo, escopo e regras de validação
│ ├── 📁 0_conceitos_teste/ # Testes conceituais para validar a lógica dos cálculos do LiquiCalc
│ │ ├── 📁 1_simulador_mdr-padrao1.0v/
│ │ │ └──📄 teste_conceito_mdr-padrao.md # Teste conceitual da MDR padrão
│ │ ├── 📁 2_simulador_mdr-flex1.1v/
│ │ │ └──📄 teste_conceito_mdr-flex.md # Teste conceitual da MDR flexível
│ │ └── 📁 3_simulador_antecipacao1.2v/
│ │ └──📄 teste_conceito_antecipacao.md # Teste conceitual da antecipação de recebíveis
│ │
│ ├── 📁 1_excel_teste/ # Simuladores em Excel para testes manuais e validação visual
│ │ ├── 📁 0_LiquiCalc.2.3v/
│ │ │ └── 📄 teste_calculo_liquicalc_2.3.md # Teste de cálculo da versão consolidada 1.3
│ │ ├── 📁 1_simulador_mdr-padrao2.0v/
│ │ │ ├── 📁 evidencias_de_calculo
│ │ │ └── 📄 teste_calculo_mdr-padrao_2.0.md # Teste de cálculo da MDR padrão versão 1.0
│ │ ├── 📁 2_simulador_mdr-flex2.1v/
│ │ │ ├── 📁 evidencias_de_calculo
│ │ │ └── 📄 teste_calculo_mdr-flex_2.1.md # Teste de cálculo da MDR flexível versão 1.1
│ │ └── 📁 3_simulador_antecipacao2.2v/
│ │ └── 📄 teste_calculo_antecipacao_2.2.md # Teste de cálculo da antecipação versão 1.2
│ │
│ ├── 📁 2_calculadora-bat_teste/ # Scripts em BAT para execução automatizada dos cálculos via terminal
│ │ ├── 📁 0_LiquiCalc.3.3v/
│ │ │ └── 📄 teste_calculo_liquicalc_3.3.md # Teste de cálculo da versão consolidada 2.3
│ │ ├── 📁 1_simulador_mdr-padrao3.0v/
│ │ │ └── 📄 teste_calculo_mdr-padrao_3.0.md # Teste de cálculo da MDR padrão versão 2.0
│ │ ├── 📁 2_simulador_mdr-flex3.1v/
│ │ │ └── 📄 teste_calculo_mdr-flex_3.1.md # Teste de cálculo da MDR flexível versão 2.1
│ │ └── 📁 3_simulador_antecipacao3.2v/
│ │ └── 📄 teste_calculo_antecipacao_3.2.md # Teste de cálculo da antecipação versão 2.2
│ │
│ └── 📁 3_calculadora-web_teste/ # Interfaces web interativas para simulação dos cálculos via navegador
│ ├── 📁 0_LiquiCalc.4.3v/
│ │ └── 📄 teste_calculo_liquicalc_4.3.md # Teste de cálculo da versão consolidada 3.3
│ ├── 📁 1_simulador_mdr-padrao4.0v/
│ │ └── 📄 teste_calculo_mdr-padrao_4.0.md # Teste de cálculo da MDR padrão versão 3.0
│ ├── 📁 2_simulador_mdr-flex4.1v/
│ │ └── 📄 teste_calculo_mdr-flex_4.1.md # Teste de cálculo da MDR flexível versão 3.1
│ └── 📁 3_simulador_antecipacao4.2v/
│ └── 📄 teste_calculo_antecipacao_4.2.md # Teste de cálculo da antecipação versão 3.2
│
├── 📁 3_docs/
│ ├── 📄 0_roadmap_estrutura.md # Estrutura técnica do projeto: diretórios, arquivos e estados de maturidade
│ ├── 📄 1_roadmap_releases.md # Cronograma de releases: etapas de desenvolvimento, versões e status de entrega
│ ├── 📄 2_roadmap_testes.md # Planejamento de testes: modalidades, simuladores, versões e rastreabilidade técnica
│ └── 📄 3_roadmap_inspiracoes.md # Referências técnicas e conceituais que inspiraram o desenvolvimento do LiquiCalc
│
├── 📄 LICENSE # Licença de uso do projeto (MIT License)
└── 📄 README.md # Apresentação geral: objetivo, uso, tecnologias e estrutura
| Release | Tópico | Descrição | Versão | Prazo Estimado | Status Atual |
|---|---|---|---|---|---|
| Rel.1 | Conceito e modelagem técnica | Conceito e Modelagem de Cálculo das Modalidades de Recebimento: estudo técnico dos fundamentos e fórmulas aplicáveis | 1.0.0 a 1.2.0 | 1 semana | Concluído |
| Rel.1.1 | Testes iniciais | Testes Iniciais de Validação dos Cálculos: simulações com exemplos reais para verificar a precisão matemática | 1.0.1 a 1.2.1 | 1 dia | Concluído |
| Rel.2 | Protótipos em Excel | Implementação dos Protótipos em Excel: tradução dos cálculos em planilhas individuais e versão consolidada | 2.0.0 a 2.3.0 | 2 semanas | Em andamento |
| Rel.2.1 | Validação dos protótipos | Testes Controlados Excel: validação dos resultados com dados reais e cálculos esperados | 2.0.1 a 2.3.1 | 1 dia | Em andamento |
| Rel.3 | Scripts executáveis | Conversão para Scripts BAT – Primeira Interface Executável: desenvolvimento de scripts .bat para simular cada modalidade de forma interativa |
3.0.0 a 3.3.0 | 1 semana | Pendente |
| Rel.3.1 | Testes dos scripts | Testes Controlados BAT: verificação da lógica dos menus e consistência em relação ao Excel | 3.0.1 a 3.3.1 | 1 dia | Pendente |
| Rel.4 | Interface Web interativa | Protótipo Web: construção da interface web em HTML/CSS/JS com cálculo dinâmico e simulações interativas | 4.0.0 a 4.3.0 | 2 semanas | Pendente |
| Rel.4.1 | Testes da interface Web | Testes Controlados Web: validação do comportamento da interface com os mesmos exemplos usados nas versões anteriores | 4.0.1 a 4.3.1 | 1 dia | Pendente |
| Rel.5 | Testes integrados | Testes Integrados e Regressivos: validação cruzada entre Excel, BAT e Web com cenários completos e de carga | 4.4.0 | 1 semana | Pendente |
| Rel.6 | Documentação de uso | Documentação de Usuário: criação de guias rápidos com instruções de uso, exemplos e resolução de erros comuns | 4.5.0 | 1 semana | Pendente |
| Rel.7 | Empacotamento e publicação | Empacotamento e Distribuição: geração dos pacotes finais (ZIP, instaladores) e publicação via GitHub Pages | 4.6.0 | 1 semana | Pendente |
| Rel.8 | Coleta de feedback | Coleta de Feedback (Beta): compartilhamento dos protótipos com usuários reais e coleta de sugestões e erros | 4.7.0 | 2 semanas | Pendente |
| Rel.9 | Release oficial | Versão 3.4.0 – Release Oficial da Interface Web Consolidada: refinamento da UX/UI, correções finais e lançamento público estável | 5.0.0 | 1 semana | Pendente |
| Rel.10 | Evoluções futuras | Evolução e Funcionalidades: planejamento e desenvolvimento de melhorias como PWA, suporte a idiomas, multi-moeda e dashboards | 6.0.0 (previsto) | Contínuo | Pendente |
| Status | Definição Técnica |
|---|---|
| Concluído | Teste finalizado, validado e pronto para uso técnico |
| Em andamento | Teste em desenvolvimento, revisão ou validação |
| Pendente | Teste previsto no escopo, ainda não iniciado ou sem conteúdo definido |
ExcelBatch Script (.bat)HTML/CSS/JavaScript/PythonMarkdownGitHub Pages
© 2025 • Projeto LiquiCalc
Distribuído sob os termos da MIT License.