Inventaris Produk
- Code: INV-PIN
- Module: Inventory
- Type: Master Data
1. Overview
Inventaris Produk adalah data stok dan harga sebuah produk pada satu toko: satu baris untuk kemasan dasarnya, dan baris turunan untuk tiap konversi kemasan lain (misalnya karton dibanding pcs), masing-masing dengan harga jualnya sendiri. Data ini menjadi entitas Inventaris Produk Toko yang dirujuk Purchase Order, Goods Receipt, dan Bill sebagai sumber kemasan, satuan ukuran, dan harga.
Hasil yang diharapkan: stok dan harga tiap produk di tiap toko terlihat di satu daftar yang bisa dicari dan disaring, dan seluruh modul pembelian selalu memakai angka yang sama sebagai acuan.
2. Problem
Tanpa satu tempat yang menyatukan stok dan harga per toko, staf harus membuka laporan yang berbeda-beda untuk memastikan harga pokok yang berlaku saat ini dan berapa stok yang tersisa. Akibatnya:
- Stok sebuah produk di sebuah toko tidak terlihat tanpa membuka laporan lain, sehingga staf purchasing sulit menilai apakah perlu memesan ulang.
- Harga pokok dan harga jual yang berlaku saat ini tidak mudah dipastikan, terutama saat produk punya lebih dari satu kemasan.
- Keuntungan tiap produk harus dihitung manual dari harga jual dan harga pokok yang terpisah.
3. Goals & Non-goals
3.1 Goals
- Stok, harga pokok, dan harga jual tiap produk di tiap toko terlihat di satu daftar, bisa dicari lewat nama atau barcode dan disaring per toko.
- Keuntungan tiap kemasan produk terlihat langsung, tanpa dihitung manual.
- Setiap perubahan pada data ini tercatat di log aktivitas.
3.2 Non-goals
- Penyesuaian stok manual, transfer stok antar toko, dan stock opname; belum tersedia di modul ini.
- Penentuan lokasi atau gudang penyimpanan, titik pemesanan ulang (reorder point), dan stok pengaman (safety stock); belum ada konsepnya.
- Membuat, mengubah, atau menghapus baris Inventaris Produk langsung dari sini; baris ini terbentuk dan diubah lewat pengaturan kemasan pada Produk.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Inventaris Produk di seluruh aplikasi, pada semua layar dan aksi yang melibatkannya, siapa pun yang melakukannya. Aturan ini menjadi sumber kebenaran tunggal: bila bagian lain di PRD ini tampak berbeda, aturan di sinilah yang berlaku.
- BR-01 Satu baris Inventaris Produk mewakili satu kombinasi produk, kemasan dasar (kuantitas konversi 1), dan toko.
- BR-02 Baris Inventaris Produk terbentuk otomatis saat kemasan sebuah Produk diatur untuk suatu toko; tidak dibuat langsung dari modul ini.
- BR-03 Kuantitas awal, harga pokok, dan harga jual kemasan dasar diisi dan diubah lewat pengaturan kemasan Produk, bukan dari daftar Inventaris Produk.
- BR-04 Stok bertambah otomatis sebesar kuantitas diterima pada saat Goods Receipt diajukan. Perlu dikonfirmasi: mekanisme pengurangan stok, misalnya saat penjualan, belum tercakup di modul ini.
- BR-05 Tiap konversi kemasan dari produk yang sama pada toko yang sama punya harga jualnya sendiri. Harga pokoknya diturunkan dari harga pokok kemasan dasar dikalikan kuantitas konversi kemasan tersebut.
- BR-06 Setiap perubahan data tercatat beserta pelaku dan waktunya.
5. Flow
5.1 Main Flowchart
- Kemasan Produk Diatur per Toko — Saat kemasan sebuah Produk diatur untuk suatu toko, kuantitas awal, harga pokok, dan harga jualnya diisi lewat pengaturan kemasan Produk (BR-02, BR-03).
- Baris Terbentuk — Baris Inventaris Produk terbentuk untuk kemasan dasar beserta tiap konversi kemasan lain produk tersebut di toko itu.
- Stok Bertambah — Setiap kali Goods Receipt yang menerima produk ini diajukan, stok bertambah sebesar kuantitas diterima (BR-04).
- 3a. Harga & Kuantitas Awal Diperbarui — Perubahan pada pengaturan kemasan Produk memperbarui harga pokok, harga jual, dan kuantitas awal baris ini (BR-03).
Fitur ini tidak memiliki status sendiri, sehingga tidak ada Status Lifecycle.
6. Document Structure
Bagian ini mendefinisikan isi tiap baris Inventaris Produk: field apa saja yang dimilikinya, tipenya, dan aturan nilainya. Ketentuan di sini berlaku di mana pun data ini dibentuk atau diubah, terlepas dari bagaimana field itu ditampilkan.
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Toko | Ref. Toko | Ya | — | Ditetapkan sistem saat baris terbentuk (BR-02) |
| Produk | Ref. Produk | Ya | — | Ditetapkan sistem saat baris terbentuk (BR-02) |
| Kemasan (Dasar) | Ref. Kemasan Produk | Ya | — | Kemasan dengan kuantitas konversi 1 (BR-01) |
| Kuantitas Awal | Desimal | Ya | — | Diisi lewat pengaturan kemasan Produk (BR-03) |
| Stok | Desimal | — | Kuantitas Awal | Bertambah otomatis saat GR diajukan (BR-04) |
| Harga Pokok | Mata Uang | Ya | — | Milik kemasan dasar, diisi lewat pengaturan kemasan Produk (BR-03) |
| Harga Jual | Mata Uang | Ya | — | Milik kemasan dasar, diisi lewat pengaturan kemasan Produk (BR-03) |
6.2 Konversi Kemasan
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Kemasan | Ref. Kemasan Produk | Ya | — | Kemasan dengan kuantitas konversi lebih dari 1 |
| Satuan Ukuran | Teks | — | — | Mengikuti kemasan |
| Kuantitas Konversi | Desimal | — | — | Mengikuti kemasan |
| Harga Jual | Mata Uang | Ya | — | Dimiliki sendiri oleh tiap kemasan (BR-05) |
| Harga Pokok | Mata Uang | — | — | Dihitung: Harga Pokok kemasan dasar × Kuantitas Konversi (BR-05) |
7. UI Structure
Bagian ini mendefinisikan cara Inventaris Produk ditampilkan: kolom pada daftar dan filter. Log Aktivitas tersedia sebagai drawer dari halaman daftar dan memuat perubahan seluruh baris Inventaris Produk (BR-06). Bagian ini hanya mengatur tampilan; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Datatable
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Expand Toggle | — | — | Expand Toggle |
| No | — | 1 | Number |
| Kode | — | SKU-0012 | Text |
| Barcode | — | 8991002123456 | Text |
| Nama Produk | Ya | Minyak Goreng 2L | Text |
| Grup | — | Sembako | Text |
| Kategori | — | Minyak & Bumbu | Text, Accordion bila lebih dari satu |
| Stok | Ya | 24 | Number |
| Satuan | — | Karton | Text |
| Harga Pokok | Ya | Rp 250.000 | Currency |
| Harga Jual | Ya | Rp 275.000 | Currency |
| Keuntungan | — | Rp 25.000 (10,0%) | Text |
| Status | — | Aktif | Badge |
Tidak ada kolom Pilih maupun Aksi — baris tidak bisa dipilih massal dan tidak punya aksi ubah atau hapus (BR-02, BR-03).
Expanded Row
Daftar konversi kemasan lain produk tersebut pada toko yang sama.
| Kolom | Contoh Nilai | Komponen |
|---|---|---|
| Barcode | 8991002123457 | Text |
| Kuantitas (Konversi) | 12 | Number |
| Satuan Ukuran | Pcs | Text |
| Harga Jual | Rp 25.000 | Currency |
| Keuntungan | Rp 4.167 (20,0%) | Text |
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Toko | Multi Select | Toko yang ditugaskan ke pengguna | Toko aktif |
| Barcode | Text Input | — | Kosong |
| Status | Single Select | Aktif, Nonaktif | Kosong |
8. User Stories
US-01 - Melihat stok dan harga per toko
Sebagai staf purchasing, saya ingin melihat stok, harga pokok, dan harga jual tiap produk di toko saya, agar tahu kondisi stok sebelum memesan ulang.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Default menampilkan Inventaris Produk toko aktif; filter lanjutan: toko, barcode, dan status; pencarian dengan kata kunci. |
| AC-01.2 | Kolom: kode, barcode, nama produk, grup, kategori, stok, satuan, harga pokok, harga jual, keuntungan, dan status. |
| AC-01.3 | Keuntungan dihitung sebagai harga jual dikurangi harga pokok, ditampilkan beserta persentasenya. |
US-02 - Melihat konversi kemasan
Sebagai staf purchasing, saya ingin melihat kemasan lain dari sebuah produk beserta harganya masing-masing, agar tahu harga jual tiap satuan yang dijual.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Baris bisa diperluas untuk menampilkan daftar konversi kemasan lain: barcode, kuantitas konversi, satuan ukuran, harga jual, dan keuntungannya (BR-05). |
US-03 - Menelusuri riwayat perubahan
Sebagai owner, saya ingin melihat log aktivitas Inventaris Produk, agar tahu siapa mengubah apa dan kapan.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Log aktivitas tersedia untuk seluruh baris Inventaris Produk dari halaman daftar (BR-06). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Owner | Memantau keuntungan seluruh produk aktif di satu toko sebelum menentukan promo |
| Staf Purchasing | Mengecek stok sebuah produk lewat pencarian barcode sebelum menyetujui pesanan pembelian baru |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Inventaris Produk | inventory:product-inventory:list:any | Perlu dikonfirmasi: saat ini hanya tersedia scope :any; belum ada scope :store untuk toko yang ditugaskan. |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
Master data
- Produk — kemasan, satuan ukuran, dan barcode; sumber pembentukan baris ini (BR-02, BR-03).
- Toko — toko tempat Inventaris Produk berlaku.
Efek ke modul lain
- Purchase Order, Goods Receipt, dan Bill merujuk data ini sebagai Inventaris Produk Toko untuk kemasan, satuan ukuran, dan harga.
- Stok bertambah saat Goods Receipt diajukan (BR-04).