💰 Cashflow Management

Modern Cashflow Management Application built with Python, CustomTkinter, SQLite, and Professional PDF Reporting.

Cashflow Management adalah aplikasi desktop modern untuk mengelola arus kas (cashflow) dengan tampilan UI neon/cyberpunk yang elegan.
Aplikasi ini memungkinkan pengguna untuk mencatat pemasukan dan pengeluaran, melihat statistik keuangan secara realtime, melakukan filter transaksi, serta menghasilkan laporan PDF profesional lengkap dengan grafik visualisasi data.

---

✨ Features

📊 Dashboard Keuangan

• Total Balance
• Total Inflow
• Total Outflow
• Statistik realtime
• Animasi angka otomatis

💸 Manajemen Transaksi

• Tambah transaksi
• Hapus transaksi
• Pemasukan & pengeluaran
• Kategori transaksi
• Preview transaksi realtime

🔍 Pencarian & Filter

• Search transaksi realtime
• Filter berdasarkan tipe transaksi
• Filter berdasarkan bulan
• Filter berdasarkan tahun

📄 Export PDF Profesional

Generate laporan keuangan profesional dengan:

• Ringkasan keuangan
• Analisis kategori
• Daftar transaksi
• Pie chart
• Bar chart
• Statistik pengeluaran

🎨 Modern UI

• Cyberpunk Neon Theme
• Dark Mode & Light Mode
• Responsive layout
• Toast notification
• Popup detail transaksi

🗄 Database Lokal

• Menggunakan SQLite3
• Penyimpanan otomatis
• Tidak membutuhkan internet/server

---

🖼 Application Preview

Dashboard

Aplikasi memiliki tampilan modern dengan:

• Sidebar navigasi
• Statistik keuangan realtime
• Riwayat transaksi interaktif
• Form input transaksi modern

PDF Report

Laporan PDF otomatis berisi:

• Ringkasan finansial
• Analisis pengeluaran
• Grafik visualisasi
• Daftar transaksi lengkap

---

🛠 Tech Stack

Technology	Description
Python	Main Programming Language
CustomTkinter	Modern GUI Framework
SQLite3	Local Database
Matplotlib	Data Visualization
FPDF2	PDF Report Generator
Pillow	Image Processing

---

📦 Requirements

Pastikan sudah menginstall:

• Python 3.10+
• pip

---

🚀 Installation

1. Clone Repository

git clone https://github.com/username/cashflow-management.git

---

2. Masuk ke Folder Project

cd cashflow-management

---

3. Buat Virtual Environment

Windows

python -m venv venv

Aktifkan virtual environment:

venv\Scripts\activate

---

Linux / macOS

python3 -m venv venv
source venv/bin/activate

---

4. Install Dependencies

pip install -r requirements.txt

---

📋 requirements.txt

customtkinter
matplotlib
fpdf2
pillow

---

▶️ Run Application

python Cashflow_Management.py

---

📁 Project Structure

Cashflow-Management/
│
├── Cashflow_Management.py
├── cashflow.db
├── requirements.txt
├── README.md
│
├── exports/
│   └── laporan_keuangan.pdf
│
└── assets/

---

🗃 Database Schema

transactions

Column	Type
id	INTEGER
name	TEXT
amount	REAL
category	TEXT
transaction_type	TEXT
date	TEXT
timestamp	DATETIME

---

📄 PDF Report Features

Laporan PDF otomatis mencakup:

I. Ringkasan Keuangan

• Total pemasukan
• Total pengeluaran
• Saldo bersih
• Rasio tabungan

II. Analisis Pengeluaran

• Persentase pengeluaran
• Status kategori
• Prioritas pengeluaran

III. Daftar Transaksi

• Tanggal transaksi
• Nama transaksi
• Kategori
• Jenis transaksi
• Nominal

IV. Visualisasi Data

• Pie Chart pengeluaran
• Grafik pemasukan vs pengeluaran

---

🎮 Shortcut

Shortcut	Function
CTRL + D	Menambahkan demo data

---

🌙 Theme Support

Aplikasi mendukung:

• Dark Mode
• Light Mode

Theme dapat diganti melalui tombol sidebar.

---

📊 Supported Categories

Pemasukan

• Salary
• Bonus
• Investment
• Other Income

Pengeluaran

• Food
• Transport
• Bills
• Entertainment
• Other Expense

---

🔐 Local Storage

Semua data disimpan secara lokal menggunakan SQLite.

cashflow.db

Tidak ada data pengguna yang dikirim ke server.

---

⚠️ Notes

• Gunakan virtual environment untuk menghindari konflik dependency
• Export PDF membutuhkan matplotlib & fpdf2
• Pastikan semua dependency terinstall dengan benar

---

🧠 Future Improvements

Planned features:

• Edit transaksi
• Export Excel
• Multi-user system
• Authentication
• Cloud synchronization
• Financial analytics
• Budget planning
• Currency conversion

---

🐞 Known Issues

• Rendering chart besar mungkin sedikit lambat
• Export PDF membutuhkan waktu lebih lama jika data sangat banyak

---

🤝 Contributing

Contribution dan pull request sangat diterima.

Steps

1. Fork repository
2. Create new branch

git checkout -b feature/new-feature

3. Commit changes

git commit -m "Add new feature"

4. Push branch

git push origin feature/new-feature

5. Create Pull Request

---

📜 License

MIT License

---

👨‍💻 Author

Developed with ❤️ using Python & CustomTkinter.

---

⭐ Support

Jika project ini membantu:

• ⭐ Star repository
• 🍴 Fork project
• 🐛 Report issues

---