MOINEX é uma aplicação de gestão financeira pessoal que permite aos utilizadores registar, visualizar e acompanhar as suas transações financeiras. A aplicação possibilita a categorização de receitas e despesas, o cálculo de balanços mensais e a exibição de gráficos, proporcionando uma visão clara da saúde financeira de forma intuitiva.

Mais Capturas de Tela

Clique para ver mais imagens da aplicação

Carteiras

Cartão de Crédito

Gestão de Transações

Metas

Investimentos

Funcionalidades Principais

• Gestão de Múltiplas Carteiras: Controle contas correntes, poupanças, investimentos e muito mais.
• Registo de Transações: Adicione receitas e despesas com categorização detalhada.
• Metas de Poupança: Crie objetivos financeiros e acompanhe o seu progresso.
• Relatórios e Gráficos: Visualize a sua saúde financeira com gráficos intuitivos de balanço, despesas por categoria, etc.
• Privacidade: Todos os seus dados são armazenados localmente no seu computador.
• Software Livre: Código aberto e transparente.

Tecnologias Utilizadas

• Linguagem: Kotlin 2.1.0
• Backend: Spring Boot 3.5, Spring Data JPA
• Interface Gráfica: JavaFX 21
• Base de Dados: SQLite com Flyway para migrações
• Build: Gradle com Kotlin DSL
• Testes: Kotest

Compatibilidade

O Moinex está disponível para Linux e Windows.

Instalação

Windows

1. Acesse a página de releases
2. Baixe o arquivo Moinex-X.X.X.exe da última versão
3. Execute o instalador e siga o assistente de instalação
4. Pronto! Encontre o Moinex no Menu Iniciar

Localização dos dados:

• Aplicação: %USERPROFILE%\.moinex\
• Base de dados: %USERPROFILE%\.moinex\data\moinex.db
• Logos de ações: %USERPROFILE%\.moinex\logos\
• Logs: %LOCALAPPDATA%\moinex\state

Linux

Pré-requisitos

Certifique-se de ter instalado:

• Git
• Java 21 ou superior
• Gradle (ou use o wrapper incluído ./gradlew)
• Python 3 com pip (para scripts de APIs financeiras)

Instalação via Script

1. Clone o repositório:

git clone https://github.com/luk3rr/MOINEX.git
cd MOINEX

2. Execute o script de instalação:

sh scripts/install.sh

3. Escolha a versão:
   • main - versão de desenvolvimento (pode conter recursos experimentais)
   • Versões estáveis (tags) - recomendadas para uso diário

Instalação Manual

1. Clone e compile:

git clone https://github.com/luk3rr/MOINEX.git
cd MOINEX
./gradlew build

2. Execute a aplicação:

./gradlew bootRun

Localização dos dados:

• Aplicação: $HOME/.moinex/
• Base de dados: $HOME/.moinex/data/moinex.db
• Logos de ações: $HOME/.moinex/logos/
• Logs: $HOME/.local/state/moinex

Desinstalação

Windows

1. Abra Configurações do Windows
2. Vá em Aplicativos → Aplicativos instalados
3. Procure por Moinex
4. Clique em Desinstalar
5. Siga o assistente de desinstalação

Warning

A desinstalação remove a aplicação, mas seus dados em %USERPROFILE%\.moinex\ são preservados. Para remover completamente, delete manualmente esta pasta após desinstalar.

Linux

Execute o script de desinstalação:

sh scripts/uninstall.sh

Warning

Este comando irá apagar permanentemente a sua base de dados com todas as suas transações. Faça um backup do diretório $HOME/.moinex/data/ se desejar restaurar os seus dados no futuro.

Licença

Este projeto está licenciado sob a licença AGPL-3.0. Veja o arquivo LICENSE para mais detalhes.