Indoapril

Indoapril adalah aplikasi kasir sederhana berbasis Python Tkinter. Project ini dibuat sebagai bagian dari kumpulan aplikasi kasir bisnis kecil yang menerapkan GUI, pembayaran, diskon, searching, sorting, validasi input, struk pembayaran, dan riwayat transaksi.

Deskripsi Repository

Aplikasi kasir minimarket dengan keranjang belanja multi-produk, diskon toko, struk panjang, searching, sorting, dan riwayat transaksi.

Pembeda Utama

Indoapril fokus pada keranjang multi-produk sehingga satu transaksi dapat berisi banyak barang sekaligus.

Fitur Utama

• Window utama Tkinter dengan header, body, footer, dan tema warna.
• Form input kasir menggunakan Label, Entry, Button, Frame, dan Combobox.
• Tabel data menggunakan Treeview.
• Perhitungan subtotal, diskon, total bayar, uang bayar, dan kembalian.
• Validasi stok produk saat barang ditambahkan ke keranjang.
• Stok produk berkurang saat masuk keranjang dan kembali jika item dihapus.
• Validasi input kosong dan angka.
• Messagebox untuk notifikasi, error, struk pembayaran, dan konfirmasi keluar.
• Menu bar: File, Tema, Algoritma, dan Bantuan.
• Linear Search untuk mencari data produk.
• Binary Search untuk mencari produk berdasarkan nama lengkap.
• Bubble Sort untuk mengurutkan data.
• Cover PNG di folder assets.

Teknologi yang Digunakan

• Python
• Tkinter
• Pillow
• Visual Studio Code
• VS Code Extension: Python
• VS Code Extension: Python Debugger
• VS Code Extension: Code Runner

Apa Itu Tkinter?

Tkinter adalah library bawaan Python untuk membuat aplikasi desktop berbasis GUI. Karena biasanya sudah termasuk dalam instalasi Python standar, Tkinter tidak perlu ditulis di requirements.txt.

Apa Itu Pillow?

Pillow adalah library Python untuk membuka, mengolah, dan menampilkan gambar. Di project ini, Pillow digunakan untuk memuat file assets/cover.png dan menyesuaikan ukurannya agar tampil rapi di aplikasi Tkinter.

Yang Harus Dipasang

Pastikan sudah memasang Python 3, pip, Pillow, Visual Studio Code, dan extension VS Code yang direkomendasikan.

Cara Install Dependency

pip install -r requirements.txt

Jika pip tidak terbaca, gunakan:

python -m pip install Pillow

Cara Menjalankan

python "Indoapril.py"

Jika menggunakan Windows dan perintah python tidak berjalan, coba:

py "Indoapril.py"

Cara Menjalankan di VS Code

1. Buka folder project di VS Code.
2. Install extension yang direkomendasikan jika muncul notifikasi.
3. Buka file Indoapril.py.
4. Klik tombol Run Python, atau klik kanan lalu pilih Run Code.

Project ini memiliki file .vscode/settings.json agar Code Runner menjalankan Python di terminal. Ini membantu aplikasi Tkinter terbuka lebih stabil.

Struktur Folder

Indoapril/
|-- assets/
|   `-- cover.png
|-- .vscode/
|   |-- extensions.json
|   `-- settings.json
|-- Indoapril.py
|-- requirements.txt
|-- .gitignore
`-- README.md

Troubleshooting

Jika muncul error ModuleNotFoundError: No module named 'PIL', install Pillow terlebih dahulu:

pip install Pillow

Jika gambar tidak muncul, pastikan file assets/cover.png ada.

Status Project

Project ini dibuat untuk pembelajaran. Data produk dan transaksi masih disimpan di memori program, sehingga riwayat transaksi akan hilang saat aplikasi ditutup.