KokuTax é uma aplicação web que simula o cálculo de impostos para trabalhadores, com base no salário mensal e nas principais deduções aplicáveis.
O projeto foi desenvolvido com foco em aprendizado prático de backend com Flask, integração com frontend e aplicação de lógica de programação em um cenário real.
🚀 Funcionalidades
- Inserção de salário mensal
- Cálculo automático de:
- Salário anual
- Dedução salarial (Employment Income Deduction)
- Previdência
- Seguro de saúde
- Dedução básica
- Renda tributável
- Imposto nacional
- Imposto residencial
- Seguro desemprego
🧠 Como funciona
O sistema segue o seguinte fluxo:
- O usuário insere o salário mensal no formulário
- O formulário envia os dados para o backend (Flask)
- O Python realiza todos os cálculos
- Os resultados são retornados para o HTML
- A página é renderizada novamente com os valores atualizados
⚙️ Tecnologias utilizadas
- Python 3
- Flask
- HTML5
- CSS3
- JavaScript
- Clone o repositório:
git clone https://github.com/bodedogo/Kokutax
- Entre na pasta:
cd Kokutax
- Instale o Flask (se necessário):
pip install flask
- Execute o projeto:
python app.py
- Acesse no navegador:
📌 Observações
- Os cálculos são baseados em regras simplificadas e estimativas
- O projeto ainda está em desenvolvimento
- Algumas partes do sistema ainda serão refinadas
🎯 Objetivo do projeto
- Praticar desenvolvimento backend com Flask
- Entender integração entre frontend e backend
- Trabalhar com formulários e requisições HTTP
- Aplicar lógica de programação em cálculos reais
🔮 Melhorias futuras
- Melhor validação de dados
- Interface mais dinâmica
- Possível sistema de usuários
- Deploy online
Este projeto é apenas para fins educacionais e não deve ser utilizado como ferramenta oficial de cálculo de impostos.