Proyek: Aplikasi Inventaris

Setelah membangun REST API untuk tugas, kita beralih ke proyek yang fokus pada pelacakan stok: Aplikasi Inventaris. Aplikasi ini mencatat barang dengan SKU unik, harga, dan jumlah stok. Setiap pergerakan barang dicatat sebagai transaksi masuk atau keluar, lengkap dengan stok sebelum dan sesudah. Database SQLite menyimpan data persisten dan mendukung pencarian berdasarkan nama. Proyek ini melatih keterampilan penting dalam pengembangan aplikasi bisnis: pemodelan entitas dengan SKU, transaksi yang mengubah state, dan laporan agregat. Setiap Bagian menghasilkan program yang dapat dijalankan dan diuji, sehingga invariant seperti “stok tidak negatif” dapat diverifikasi pada setiap iterasi.

Tujuan Proyek #

Aplikasi inventaris yang akan kita bangun mendukung operasi berikut:

• Mendaftarkan Barang dengan SKU, nama, satuan, harga, dan stok awal.
• Mencatat transaksi masuk (stok bertambah) dan keluar (stok berkurang).
• Memvalidasi stok tidak negatif sebelum transaksi keluar.
• Mencari barang berdasarkan SKU atau nama (pencarian LIKE).
• Menampilkan laporan stok: total nilai, stok rendah, dan riwayat transaksi.

Setiap operasi mempertahankan konsistensi: stok tidak boleh negatif, transaksi dicatat dengan stok sebelum dan sesudah, serta SKU unik. Ketika satu langkah gagal, seluruh transaksi dibatalkan agar data tetap koheren.

Perilaku yang Diharapkan #

Contoh sesi pemakaian menampilkan alur transaksi:

java -jar inventaris.jar tambah --sku SKU-001 --nama "Buku Kotlin" --stok 10
java -jar inventaris.jar masuk --sku SKU-001 --jumlah 5
java -jar inventaris.jar cari --nama "Buku"

Output yang Dihasilkan:

[SKU-001] Buku Kotlin stok=10
[M0001] +5 SKU-001: 10 -> 15
[SKU-001] Buku Kotlin stok=15

Transaksi masuk menghasilkan ID dengan prefix M, transaksi keluar dengan prefix K. Format ID memudahkan pelacakan jenis transaksi tanpa membaca detail. Riwayat transaksi tersimpan lengkap dengan stok sebelum dan sesudah untuk keperluan audit.

Teknologi dan Stack #

Proyek ini menggunakan peranti berikut:

Proyek ini memperluas penggunaan SQLite dari proyek REST API Manajemen Tugas dengan menambahkan index, pencarian LIKE, dan laporan agregat. Pola yang dipelajari akan relevan untuk proyek backend lain yang melibatkan transaksi keuangan atau logistik.

Prasyarat #

Pembaca diharapkan telah menyelesaikan chapter berikut:

• Section Object-Oriented Programming: data class, enum class, dan copy(),
• Section Error Handling: Result<T> dan require(),
• Section Strings: Regex untuk validasi SKU,
• Proyek REST API Manajemen Tugas: JDBC, koneksi SQLite, dan eksekusi SQL dari Kotlin.

Tanpa prasyarat tersebut, sebaiknya pelajari dahulu section atau proyek terkait sebelum melanjutkan.

Arsitektur #

Dua entitas inti inventaris adalah Barang dan TransaksiStok. TransaksiStok mencatat stok sebelum dan sesudah, sehingga riwayat transaksi dapat merekonstruksi perubahan stok. Pola ini disebut event sourcing ringan dan berguna untuk audit. Layanan InventarisService menjaga invariant “stok tidak negatif” dan “SKU unik” sebelum menyentuh database.

Lapisan InventarisService memisahkan keputusan bisnis dari penyimpanan. Database hanya menjalankan perintah SQL dari repository, sementara invariant diperiksa di layer layanan. Pemisahan ini membuat pengujian invariant tidak membutuhkan database nyata; cukup dengan repository tiruan di memori.

Struktur Bagian #

Proyek ini dikerjakan dalam empat bagian berurutan:

Mulailah dari Bagian 1 dan ikuti urutannya karena setiap Bagian dibangun di atas Bagian sebelumnya. Setelah Bagian 4 selesai, kita siap melangkah ke proyek Aplikasi Android Pencatat Keuangan yang membawa kita ke platform mobile dengan Jetpack Compose.

Referensi Lanjutan #

• Kotlin documentation home — halaman utama dokumentasi Kotlin sebagai rujukan fitur yang dipakai di proyek inventaris
• Get started with Kotlin — panduan memulai proyek Kotlin sebagai fondasi tiap bagian proyek inventaris