Mini Project: Ringkasan Transaksi Penjualan
Tujuan Pembelajaran
- Membaca transaksi dari teks CSV di memori.
- Membersihkan dan memvalidasi setiap baris sebelum menghitungnya.
- Menggunakan fungsi, perulangan, dan dictionary untuk meringkas pendapatan per kategori.
Mini project ini menggabungkan konsep inti kursus: string, list dan dictionary, loop, fungsi, konversi angka, penanganan exception, serta modul standard library. Kita mengolah transaksi kecil yang tertanam sebagai teks CSV, merapikan nilai, memisahkan record valid dari yang tidak valid, lalu menghitung pendapatan keseluruhan dan per kategori.
Sebelum mengikuti kode, perhatikan pertanyaan yang akan dijawab: berapa transaksi yang dapat dipercaya untuk perhitungan, berapa yang perlu ditolak, dan berapa pendapatan per kategori? Kita tidak akan menganggap setiap baris valid. Aturan di awal proyek menjelaskan baris mana yang boleh ikut dihitung, sehingga hasil dapat diperiksa dan dijelaskan.
1. Tetapkan bentuk data dan aturan
Setiap record berisi nama produk, kategori, jumlah barang, dan harga satuan. Kolom jumlah serta harga masih berupa teks saat dibaca. Untuk contoh ini, sebuah baris valid jika produk dan kategori tidak kosong, jumlah dapat dikonversi menjadi bilangan bulat positif, dan harga satuan dapat dikonversi menjadi bilangan bulat nol atau lebih.
Runner berjalan di browser dan tidak membuka berkas lokal. Karena itu, data contoh disimpan dalam string dan dibaca dengan csv.DictReader serta StringIO:
import csv
from io import StringIO
csv_transaksi = """produk,kategori,jumlah,harga_satuan
Kopi,Minuman,2,18000
Roti,Makanan,3,7000
Teh,Minuman,4,5000
Cokelat,Makanan,1,12000
Susu,Minuman,dua,15000
,Minuman,1,5000
"""
Dua baris terakhir memang disediakan untuk menguji validasi: jumlah Susu bukan angka, sedangkan satu record tidak memiliki nama produk. Program harus menolak keduanya tanpa menghentikan pemrosesan record lainnya.
Di sini, record berarti satu baris transaksi. Setiap bagian bernama dalam baris, seperti produk atau kategori, disebut field atau kolom. Field wajib adalah bagian yang harus memiliki isi agar transaksi dapat diproses. Istilah ini akan muncul lagi saat kita membaca data tabel dan CSV.
Setiap baris setelah header memiliki empat nilai dengan urutan yang sama: produk, kategori, jumlah, lalu harga satuan. Sebagai contoh, baris Kopi,Minuman,2,18000 menyatakan dua unit Kopi dengan harga satuan 18.000. Baris Susu tetap memiliki nama dan kategori, tetapi jumlahnya tidak dapat diubah menjadi angka. Baris tanpa nama produk melanggar aturan field wajib. Keduanya membantu kita melihat bahwa alasan penolakan bisa berbeda.
2. Siapkan wadah ringkasan
Kita menyimpan semua hasil dalam dictionary. Tiga penghitung menyimpan jumlah baris valid, baris tidak valid, dan pendapatan keseluruhan. Dictionary di dalam per_kategori menyimpan subtotal tiap kategori.
3. Bersihkan, validasi, dan hitung
Fungsi menerima teks CSV dan mengembalikan ringkasan. Untuk tiap baris, program merapikan teks dengan strip(), memeriksa field wajib, mengonversi angka, lalu memeriksa aturan sebelum menghitung:
def ringkas_transaksi(teks_csv):
ringkasan = {
"baris_valid": 0,
"baris_tidak_valid": 0,
"pendapatan_total": 0,
"per_kategori": {},
}
for baris in csv.DictReader(StringIO(teks_csv)):
produk = baris["produk"].strip()
kategori = baris["kategori"].strip()
if produk == "" or kategori == "":
ringkasan["baris_tidak_valid"] += 1
continue
try:
jumlah = int(baris["jumlah"].strip())
harga_satuan = int(baris["harga_satuan"].strip())
except ValueError:
ringkasan["baris_tidak_valid"] += 1
continue
if jumlah <= 0 or harga_satuan < 0:
ringkasan["baris_tidak_valid"] += 1
continue
pendapatan = jumlah * harga_satuan
ringkasan["baris_valid"] += 1
ringkasan["pendapatan_total"] += pendapatan
ringkasan["per_kategori"][kategori] = (
ringkasan["per_kategori"].get(kategori, 0) + pendapatan
)
return ringkasan
Urutan ini penting: baris yang tidak valid dilewati sebelum ikut menambah pendapatan. Exception hanya menangani konversi angka; kondisi if menangani aturan kosong, jumlah, dan harga. Dengan memisahkan dua jenis pemeriksaan, kita dapat menjelaskan alasan sebuah record ditolak.
Untuk satu baris yang valid, program lebih dahulu memastikan nama produk dan kategori terisi. Setelah angka berhasil dikonversi, program memeriksa jumlah dan harga. Hanya setelah semua pemeriksaan lolos, pendapatan dihitung dan penghitung transaksi valid bertambah. Jika pemeriksaan gagal, continue melewati perhitungan untuk baris itu. Urutan ini menjaga agar nilai yang belum layak tidak masuk ke total.
4. Tampilkan dan tafsirkan hasil
Panggil fungsi dengan teks CSV, lalu tampilkan ringkasannya:
hasil = ringkas_transaksi(csv_transaksi)
print(f"Transaksi valid: {hasil['baris_valid']}")
print(f"Transaksi tidak valid: {hasil['baris_tidak_valid']}")
print(f"Pendapatan total: {hasil['pendapatan_total']}")
for kategori in sorted(hasil["per_kategori"]):
print(f"{kategori}: {hasil['per_kategori'][kategori]}")
Output:
Transaksi valid: 4
Transaksi tidak valid: 2
Pendapatan total: 89000
Makanan: 33000
Minuman: 56000
Periksa hasil dengan menghitung beberapa nilai secara manual. Kopi memberi 2 × 18000 = 36000, Teh memberi 4 × 5000 = 20000, dan keduanya menyumbang 56000 untuk Minuman. Roti dan Cokelat menyumbang 21000 + 12000 = 33000 untuk Makanan. Totalnya 89000. Baris Susu dan baris tanpa nama produk dihitung tidak valid, bukan pendapatan nol.
sorted() mengurutkan label kategori hanya untuk output yang konsisten. Urutan tersebut tidak mengubah nilai ringkasan. Dalam aplikasi nyata, aturan, mata uang, pembulatan, dan pelaporan kesalahan harus disesuaikan dengan kebutuhan pengguna.
Angka total dapat diperiksa dengan perhitungan manual pada beberapa baris. Kopi memberi 36.000 dan Teh memberi 20.000, sehingga Minuman berjumlah 56.000. Roti memberi 21.000 dan Cokelat memberi 12.000, sehingga Makanan berjumlah 33.000. Keduanya menghasilkan total 89.000. Pemeriksaan silang seperti ini membantu memastikan baris yang ditolak memang tidak ikut dijumlahkan.
Latihan Interaktif
Latihan 01
Tambahkan baris transaksi Kacang dalam kategori Camilan, jumlah 2, dan harga satuan 4000. Periksa total dan ringkasan yang berubah.
import csv
from io import StringIO
csv_transaksi = """produk,kategori,jumlah,harga_satuan
Kopi,Minuman,2,18000
Roti,Makanan,3,7000
Teh,Minuman,4,5000
Cokelat,Makanan,1,12000
Susu,Minuman,dua,15000
,Minuman,1,5000
"""
def ringkas_transaksi(teks_csv):
ringkasan = {
"baris_valid": 0,
"baris_tidak_valid": 0,
"pendapatan_total": 0,
"per_kategori": {},
}
for baris in csv.DictReader(StringIO(teks_csv)):
produk = baris["produk"].strip()
kategori = baris["kategori"].strip()
if produk == "" or kategori == "":
ringkasan["baris_tidak_valid"] += 1
continue
try:
jumlah = int(baris["jumlah"].strip())
harga_satuan = int(baris["harga_satuan"].strip())
except ValueError:
ringkasan["baris_tidak_valid"] += 1
continue
if jumlah <= 0 or harga_satuan < 0:
ringkasan["baris_tidak_valid"] += 1
continue
pendapatan = jumlah * harga_satuan
ringkasan["baris_valid"] += 1
ringkasan["pendapatan_total"] += pendapatan
ringkasan["per_kategori"][kategori] = (
ringkasan["per_kategori"].get(kategori, 0) + pendapatan
)
return ringkasan
hasil = ringkas_transaksi(csv_transaksi)
print(f"Transaksi valid: {hasil['baris_valid']}")
print(f"Transaksi tidak valid: {hasil['baris_tidak_valid']}")
print(f"Pendapatan total: {hasil['pendapatan_total']}")
for kategori in sorted(hasil["per_kategori"]):
print(f"{kategori}: {hasil['per_kategori'][kategori]}")
Keluaran program
Python belum dimuat. Pilih Jalankan Kode untuk memulai.
Keluaran
Pesan diagnostik
Kesalahan program
Pratinjau Pandas
Grafik
Lihat Petunjuk
Tambahkan baris data setelah Cokelat. Kolom jumlah dan harga pada CSV ditulis sebagai teks.
Lihat Pembahasan
Baris Kacang menambah satu transaksi valid dengan pendapatan 2 × 4000. Total dan pendapatan kategori Camilan bertambah 8000; dua baris tidak valid tetap ditolak.
Ringkasan
- CSV contoh dibaca dari teks di memori dengan csv.DictReader dan StringIO.
- Setiap baris dibersihkan dan divalidasi sebelum digunakan untuk perhitungan.
- Fungsi memisahkan alur pemrosesan dari cara hasil ditampilkan.
- Dictionary menyimpan pendapatan kumulatif per kategori; baris tidak valid tidak dihitung.
Bacaan lebih lanjut
Langkah berikutnya