Smart Finance Tracker

Aplikasi manajemen keuangan pribadi yang komprehensif dengan fitur analitik canggih.

🚀 Fitur Utama

1. Modul Transaksi & Manajemen Akun

• Multi-Wallet System: Kelola banyak dompet (Cash, Bank, E-Wallet, Kartu Kredit)
• Pencatatan Transaksi: CRUD lengkap untuk income/expense dengan foto bukti
• Transfer Antar Akun: Pindahkan saldo antar dompet tanpa dianggap pengeluaran
• Recurring Transactions: Otomatis catat tagihan bulanan
• Manajemen Utang & Piutang: Tracking lengkap dengan jatuh tempo

2. Modul Smart Budgeting & Planning

• Budgeting per Kategori: Set batas maksimal pengeluaran per kategori
• Visual Progress Bar: Monitor persentase pemakaian budget
• Financial Goals: Target tabungan dengan perhitungan otomatis
• Kalender Keuangan: Tampilan kalender untuk tagihan dan gaji

3. Modul Laporan & Analitik

• Dashboard Interaktif: Grafik pie chart dan line chart
• Laporan Net Worth: Tracking kekayaan bersih
• Comparison: Bandingkan pengeluaran bulan ini vs bulan lalu
• Export Data: Download laporan PDF/Excel (coming soon)

4. Modul Keamanan & Privasi

• App Lock: PIN protection
• Privacy Mode: Sembunyikan nominal uang di tempat umum
• End-to-End Encryption: Enkripsi data sensitif
• Session Management: Auto-logout setelah tidak aktif

🛠️ Tech Stack

Backend

• Node.js + Express.js
• MySQL dengan Sequelize ORM
• Socket.io untuk real-time
• JWT + Bcrypt untuk autentikasi

Frontend

• React.js dengan Vite
• Tailwind CSS untuk styling
• React Context untuk state management
• Axios untuk HTTP client
• Recharts untuk visualisasi data

📦 Instalasi

Menggunakan Docker (Direkomendasikan)

Proyek ini mendukung Docker Compose untuk setup cepat:

docker-compose up --build

Ini akan menjalankan kontainer MySQL (port 3307), Backend (port 5000), dan Frontend (port 5173) secara otomatis.

Menggunakan Kubernetes

Jalankan di terminal folder proyek

kubectl apply -f k8s/secrets.yaml
kubectl apply -f k8s/mysql-deployment.yaml
kubectl apply -f k8s/backend-deployment.yaml
kubectl apply -f k8s/frontend-deployment.yaml
kubectl apply -f k8s/backend-hpa.yaml
kubectl apply -f k8s/backend-monitor.yaml

Jalankan di CMD dengan Run Administrator

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update
helm install monitoring prometheus-community/kube-prometheus-stack
kubectl port-forward deployment/monitoring-grafana 3000:3000
kubectl port-forward svc/monitoring-kube-prometheus-prometheus 9090:9090

Setup Manual

Prerequisites

• Node.js (v18+)
• MySQL (v8+)
• npm atau yarn

Backend Setup

1. Masuk ke folder backend:

cd backend

2. Install dependencies:

npm install

3. Buat file .env dari .env.example:

cp .env.example .env

4. Edit file .env dan isi konfigurasi database:

DB_HOST=localhost
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=smart_finance_tracker
DB_PORT=3306

JWT_SECRET=your-super-secret-jwt-key
JWT_EXPIRES_IN=7d

PORT=5000
NODE_ENV=development

ENCRYPTION_KEY=your-32-character-encryption-key-here
SESSION_TIMEOUT=30

5. Buat database:

npm run create-db

6. Jalankan server:

npm run dev

Server akan berjalan di http://localhost:5000

Frontend Setup

1. Masuk ke folder frontend:

cd frontend

2. Install dependencies:

npm install

3. Buat file .env (opsional):

VITE_API_URL=http://localhost:5000/api

4. Jalankan development server:

npm run dev

Frontend akan berjalan di http://localhost:5173

📁 Struktur Project

• backend/: Express API, Sequelize models.
• frontend/: React application, Vite config, Tailwind styling.
• k8s/: Konfigurasi deployment untuk Kubernetes.

🔐 API Endpoints

Authentication

• POST /api/auth/register - Register user baru
• POST /api/auth/login - Login
• POST /api/auth/app-lock/pin - Set PIN
• POST /api/auth/app-lock/verify - Verify PIN
• POST /api/auth/privacy-mode/toggle - Toggle privacy mode

Wallets

• GET /api/wallets - Get all wallets
• POST /api/wallets - Create wallet
• PUT /api/wallets/:id - Update wallet
• DELETE /api/wallets/:id - Delete wallet

Transactions

• GET /api/transactions - Get transactions
• POST /api/transactions - Create transaction
• PUT /api/transactions/:id - Update transaction
• DELETE /api/transactions/:id - Delete transaction

Budgets

• GET /api/budgets - Get budgets
• POST /api/budgets - Create budget
• PUT /api/budgets/:id - Update budget
• DELETE /api/budgets/:id - Delete budget

Goals

• GET /api/goals - Get goals
• POST /api/goals - Create goal
• PUT /api/goals/:id - Update goal
• POST /api/goals/:id/add - Add amount to goal

Debts

• GET /api/debts - Get debts
• POST /api/debts - Create debt
• PUT /api/debts/:id - Update debt
• GET /api/debts/upcoming - Get upcoming debts

Analytics

• GET /api/analytics/dashboard - Get dashboard data
• GET /api/analytics/cash-flow - Get cash flow data
• GET /api/analytics/category-report - Get category report

🎯 Penggunaan

1. Register/Login: Buat akun baru atau login
2. Buat Dompet: Tambah dompet pertama Anda
3. Catat Transaksi: Mulai mencatat income dan expense
4. Set Budget: Buat budget untuk kategori tertentu
5. Buat Goal: Tentukan target tabungan
6. Lihat Dashboard: Monitor keuangan Anda secara real-time

🔒 Keamanan

• Password di-hash menggunakan bcrypt
• JWT token untuk autentikasi
• End-to-end encryption untuk data sensitif
• Session timeout otomatis
• App lock dengan PIN

🚧 Development

Menjalankan dalam mode development:

# Backend
cd backend && npm run dev

# Frontend (terminal baru)
cd frontend && npm run dev

Build untuk production:

# Frontend
cd frontend && npm run build

📝 Catatan

• Pastikan MySQL sudah berjalan sebelum menjalankan backend
• Untuk production, ubah NODE_ENV=production dan gunakan database yang aman
• Generate ENCRYPTION_KEY yang kuat (32 karakter)
• Generate JWT_SECRET yang unik dan aman

🤝 Kontribusi

Silakan buat issue atau pull request untuk kontribusi.

📄 License

MIT License