🎯 Gooaling — Gerenciador de Metas Financeiras

O Gooaling é um aplicativo e API que ajuda você a planejar, acompanhar e alcançar suas metas financeiras com clareza e visualização inteligente.
Desenvolvido com Kotlin + Jetpack Compose no mobile e Node.js + MongoDB no backend.

---

🧭 Sumário

• 📦 Projeto
• 📱 Download do Aplicativo
• ✨ Funcionalidades
• 🧰 Tecnologias Utilizadas
• 🗂️ Estrutura da API
• 📲 Estrutura do Mobile
• ⚙️ Como Executar
• 👨‍💻 Autor
• 📜 Licença

---

📦 Projeto

O Gooaling centraliza suas metas financeiras pessoais e controle de contas em um só lugar.
Através de gráficos e relatórios inteligentes, o app mostra quanto você já conquistou, quanto ainda precisa e o ritmo ideal para alcançar seus objetivos.

📊 Visualize. Planeje. Alcance.

---

📱 Download do Aplicativo

🔗 Android (APK): Baixar aqui
🧭 Repositório: Gooaling no GitHub

---

✨ Funcionalidades

✅ Gerenciamento de Metas: defina o valor, prazo e acompanhe o progresso.
🏦 Contas e Transações: integre e categorize movimentações financeiras.

🧰 Tecnologias Utilizadas

Camada	Tecnologias
🖥️ Backend (API)	Node.js • Express • MongoDB • Mongoose • JWT • Swagger
📱 Mobile (App)	Kotlin • Jetpack Compose • Coroutines • Flow • ViewModel • DataStore • Navigation Compose
⚙️ Infraestrutura	Git • Docker • Postman • Kubernetes • Gitlab

---

🗂️ Estrutura da API

api/
├─ src/
│  ├─ config/
│  │  └─ database.ts           # conexão MongoDB
│  ├─ models/
│  ├─ controllers/
│  ├─ routes/
│  └─ app.ts
├─ package.json
└─ .env.example

📌 Padrão: Model → Controller → Route

---

📲 Estrutura do Mobile

mobile/
├─ api/    
│  ├─ data/
│  ├─ enums/
│  ├─ model/       
│  ├─ request/
│  ├─ response/
├─ datastore/
├─ ui/        
│  ├─ components/
│  ├─ screens/
│  ├─ theme/
│  ├─ utils/
├─ viewModel/

💡 Arquitetura: MVVM + Compose Navigation

---

⚙️ Como Executar

🖥️ API

# 1️⃣ Configurar variáveis de ambiente
cp api/.env.example api/.env

# 2️⃣ Instalar dependências
cd api && npm install

# 3️⃣ Executar em modo dev
npm run dev

# 4️⃣ Produção
npm run build && npm run dev

📱 Mobile

1. Abra o projeto mobile/ no Android Studio.
2. Configure o endpoint da API (ex: data/remote/ApiService).
3. Rode o app no emulador ou dispositivo físico.

---

👨‍💻 Autor

Vinicius Monteiro

---

📜 Licença

Este projeto está licenciado sob a MIT License — consulte o arquivo LICENSE para mais detalhes.

---

🎯 Gooaling — para quem quer alcançar metas, não só sonhá-las.