Produk
- Code: INV-PRD
- Module: Inventory
- Type: Master Data
1. Overview
Produk adalah katalog barang yang diperjualbelikan tenant: identitasnya (nama, grup, kategori, gambar) beserta daftar kemasan yang dipakai untuk membeli dan menjualnya. Satu produk selalu punya kemasan dasar sebagai satuan terkecilnya, dan boleh punya kemasan lain sebagai konversi dari kemasan dasar itu — misalnya karton berisi 12 pcs. Untuk tiap kemasan, harga pokok, harga jual, dan kuantitas awal ditetapkan per toko, dan dari situlah Inventaris Produk tiap toko terbentuk.
Hasil yang diharapkan: seluruh barang tercatat satu kali dengan kemasan dan barcode yang jelas, sehingga pembelian, penerimaan, dan penjualan memakai acuan produk yang sama di semua toko.
2. Problem
Tanpa katalog produk yang terpusat, tiap toko mencatat barang dengan nama dan satuan versinya sendiri, dan satuan beli sering berbeda dengan satuan jual. Akibatnya:
- Barang yang sama tercatat berkali-kali dengan nama berbeda, sehingga stok dan pembelian tidak bisa dijumlahkan.
- Pembelian per karton dan penjualan per pcs tidak bisa dihubungkan, sehingga stok tidak pernah cocok.
- Barcode tidak tercatat di sistem, sehingga pencarian barang saat transaksi lambat dan rawan salah pilih.
- Harga pokok dan harga jual tiap toko tidak punya tempat yang pasti, sehingga margin tidak bisa dipantau.
3. Goals & Non-goals
3.1 Goals
- Setiap barang punya satu catatan induk yang dipakai seluruh toko dan seluruh modul.
- Satuan beli dan satuan jual terhubung lewat konversi kemasan, sehingga stok tetap konsisten apa pun satuan transaksinya.
- Barang bisa ditemukan cepat lewat nama atau barcode saat transaksi berlangsung.
- Harga pokok, harga jual, dan stok awal tiap kemasan ditetapkan per toko sejak produk dibuat.
- Produk yang tidak dijual lagi bisa dikunci dari transaksi baru tanpa menghapus riwayatnya.
3.2 Non-goals
- Varian produk seperti ukuran dan warna; tiap varian dicatat sebagai produk tersendiri.
- Produk rakitan atau paket bundling yang terdiri dari beberapa produk lain.
- Pencatatan nomor batch, tanggal kedaluwarsa, dan nomor seri.
- Penyesuaian stok dari fitur ini; stok bertambah lewat Goods Receipt dan dilihat di Inventaris Produk.
- Harga jual bertingkat seperti harga grosir, harga promo, dan harga per pelanggan.
- Impor massal produk dari berkas.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk 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 Kode produk (SKU) ditetapkan sistem saat produk disimpan dan tidak bisa diubah.
- BR-02 Setiap produk wajib punya satu grup produk dan sedikitnya satu kategori produk.
- BR-03 Setiap produk wajib punya sedikitnya satu thumbnail. Thumbnail pertama menjadi gambar utama yang dipakai di daftar dan pencarian produk.
- BR-04 Setiap produk wajib punya sedikitnya satu kemasan. Kemasan pertama adalah kemasan dasar dengan kuantitas konversi 1, dan kuantitas itu tidak bisa diubah.
- BR-05 Kemasan selain kemasan dasar wajib punya kuantitas konversi minimal 2, yang menyatakan berapa satuan dasar yang dikandungnya.
- BR-06 Setiap kemasan wajib punya sedikitnya satu barcode. Perlu dikonfirmasi: apakah barcode wajib unik antar kemasan dan antar produk.
- BR-07 Setiap kemasan punya kuantitas awal, harga pokok, dan harga jual untuk setiap toko. Kuantitas awal minimal 0, sedangkan harga pokok dan harga jual harus lebih besar dari 0.
- BR-08 Menyimpan kemasan beserta nilainya per toko membentuk atau memperbarui baris Inventaris Produk toko tersebut.
- BR-09 Kemasan hanya bisa ditambah, diubah, dan dihapus satu per satu lewat daftar kemasan, dan tersimpan seketika — terpisah dari penyimpanan data umum produk.
- BR-10 Produk yang tidak aktif tetap tampil pada pencarian produk di modul transaksi, tetapi tidak bisa dipilih. Data transaksi lamanya tetap bisa dilihat.
- BR-11 Setiap perubahan data produk dan kemasannya tercatat beserta pelaku dan waktunya.
5. Flow
5.1 Main Flowchart
- Data Umum — Staf menentukan status produk, thumbnail, nama, grup, kategori, dan deskripsi.
- Kemasan — Produk dilengkapi sedikitnya satu kemasan. Kemasan pertama adalah kemasan dasar berkuantitas 1; kemasan berikutnya adalah konversi dengan kuantitas minimal 2. Tiap kemasan diisi satuan ukuran, barcode, serta kuantitas awal, harga pokok, dan harga jual untuk setiap toko.
- Tinjauan — Seluruh isian ditinjau ulang sebelum disimpan.
- Validasi — Isian diperiksa sebelum produk tersimpan. Produk yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada langkah yang bersangkutan.
- Produk Tersimpan — Kode produk terbit dan produk langsung bisa dipakai di modul transaksi sesuai statusnya.
- 5a. Ubah Data Umum — Status, thumbnail, nama, grup, kategori, dan deskripsi bisa diperbarui sekaligus.
- 5b. Tambah/Ubah/Hapus Kemasan — Daftar kemasan dikelola per kemasan dan tersimpan seketika (BR-09).
- Inventaris Produk — Nilai tiap kemasan per toko membentuk baris Inventaris Produk. Rinciannya dijelaskan di PRD Product Inventory.
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
Aktifis_active: true | Produk bisa dipilih pada transaksi baru | Tidak Aktif, atau dihapus |
Tidak Aktifis_active: false | Produk tampil tetapi tidak bisa dipilih pada transaksi baru | Aktif, atau dihapus |
6. Document Structure
Bagian ini mendefinisikan isi data Produk itu sendiri: field apa saja yang dimilikinya, tipenya, mana yang wajib, nilai awalnya, dan aturan nilainya. Ketentuan di sini berlaku di mana pun produk dibuat atau diubah dan ditegakkan saat penyimpanan, terlepas dari bagaimana field itu ditampilkan.
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Kode | Teks | — | Dibuat saat disimpan | Ditetapkan sistem, tidak bisa diubah (BR-01) |
| Status | Enum | Ya | Belum dipilih | Aktif atau Tidak Aktif |
| Thumbnail | Berkas, banyak | Ya | — | Berupa gambar; urutan unggah menentukan gambar utama (BR-03) |
| Nama Produk | Teks | Ya | — | — |
| Grup | Ref. Grup Produk | Ya | — | Tepat satu grup (BR-02) |
| Kategori | Ref. Kategori Produk, banyak | Ya | — | Minimal satu kategori (BR-02) |
| Deskripsi | Teks | Tidak | — | — |
6.2 Package
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Kuantitas Konversi | Angka | Ya | 1 untuk kemasan dasar, 2 untuk kemasan berikutnya | Kemasan dasar terkunci di 1; kemasan lain minimal 2 (BR-04, BR-05) |
| Satuan Ukuran | Ref. Satuan Ukuran | Ya | — | Dipilih dari master Satuan Ukuran |
| Barcode | Teks, banyak | Ya | — | Minimal satu barcode per kemasan (BR-06) |
6.3 Package Inventory
Nilai berikut diisi untuk setiap toko pada tiap kemasan, dan menjadi isi awal Inventaris Produk toko tersebut (BR-08).
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Toko | Ref. Toko | — | Seluruh toko tenant | Ditetapkan sistem; satu baris per toko |
| Kuantitas Awal | Desimal | Ya | 0 | Minimal 0 (BR-07) |
| Harga Pokok | Mata Uang | Ya | 0 | Lebih besar dari 0 (BR-07) |
| Harga Jual | Mata Uang | Ya | 0 | Lebih besar dari 0 (BR-07) |
7. UI Structure
Bagian ini mendefinisikan cara Produk ditampilkan dan dioperasikan: kolom pada daftar, filter, dan kontrol form beserta sumber pilihannya. Log Aktivitas tersedia sebagai drawer dari halaman daftar (seluruh produk) dan dari halaman detail (per produk). Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Datatable
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Pilih | — | — | Checkbox, Expand Toggle |
| No | — | 1 | Number |
| Kode | Ya | SKU-0012 | Link |
| Nama Produk | Ya | Minyak Goreng 2L | Thumbnail, Text |
| Grup | — | Sembako | Text |
| Kategori | — | Minyak & Bumbu | Text, Accordion bila lebih dari satu |
| Status | — | Aktif | Badge |
| Aksi | — | Lihat · Ubah · Hapus | Action Menu |
Expanded Row
Daftar kemasan produk beserta nilainya per toko.
| Kolom | Contoh Nilai | Komponen |
|---|---|---|
| Kemasan | Kemasan 1 | Text |
| Kuantitas Konversi | 12 | Number |
| Satuan Ukuran | Karton (KRT) | Text |
| Barcode | 8991002123456 | Text |
| Toko | [CBI] Toko Cianjur | Text |
| Stok | 24 | Number |
| Harga Pokok | Rp 250.000 | Currency |
| Harga Jual | Rp 275.000 | Currency |
| Keuntungan | Rp 25.000 (10,0%) | Text |
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Status | Single Select | Aktif, Tidak Aktif | Kosong |
7.3 Form & Details
Buat — Wizard tiga langkah: Umum, Kemasan, lalu Tinjauan. Tombol Selanjutnya memvalidasi langkah yang sedang aktif sebelum berpindah, dan langkah Tinjauan menampilkan ringkasan seluruh isian. Aksi: Sebelumnya, Selanjutnya, Simpan.
Ubah — Dua tab, Umum dan Kemasan. Tab Umum disimpan sekaligus; kemasan di tab Kemasan ditambah, diubah, dan dihapus satu per satu lewat dialog dan langsung tersimpan (BR-09).
Detail — Dua tab, Umum dan Kemasan, yang hanya bisa dibaca. Aksi: Ubah Data dan Log Aktivitas.
Umum
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Status | Single Select | Aktif atau Tidak Aktif | Pilihan yang sedang terpilih bisa dibatalkan, dan status menjadi kosong |
| Thumbnail | File Uploader, banyak | — | Hanya menerima berkas gambar; urutan unggah menentukan gambar utama |
| Nama Produk | Text Input | — | — |
| Grup | Single Select | Master Grup Produk, bisa dicari | — |
| Kategori | Multi Select | Master Kategori Produk, bisa dicari | — |
| Deskripsi | Textarea | — | — |
Kemasan — Daftar
| Kolom | Contoh Nilai | Komponen |
|---|---|---|
| Kemasan | Kemasan 1 | Text |
| Kuantitas Konversi | 12 | Number |
| Satuan Ukuran | Karton (KRT) | Text |
| Barcode | 8991002123456 | Text |
| Aksi | Ubah · Hapus | Action Menu |
Kemasan — Form
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Kuantitas Konversi | Number Input | — | Nonaktif dan bernilai 1 pada kemasan dasar; minimal 2 pada kemasan lain |
| Satuan Ukuran | Single Select | Master Satuan Ukuran, bisa dicari, ditampilkan sebagai nama beserta simbolnya | — |
| Barcode | Text Input dalam dialog tambah, ditampilkan sebagai daftar | — | Barcode ditambahkan satu per satu dan bisa dihapus per barcode |
Kemasan — Harga per Toko
Satu baris per toko, tampil di dalam form kemasan.
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Toko | Read-only | Seluruh toko tenant | — |
| Kuantitas Awal | Number Input | — | — |
| Harga Pokok | Currency Input | — | Diubah → Keuntungan dihitung ulang |
| Harga Jual | Currency Input | — | Diubah → Keuntungan dihitung ulang |
| Keuntungan | Read-only | — | Harga Jual dikurangi Harga Pokok, ditampilkan beserta persentasenya terhadap harga pokok |
8. User Stories
US-01 - Membuat produk
Sebagai staf inventory, saya ingin mendaftarkan produk beserta kemasan dan harganya per toko, agar produk bisa langsung dipakai bertransaksi.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Saat pengguna dengan izin create membuka Tambah Baru, wizard Umum → Kemasan → Tinjauan tampil dengan seluruh field kosong. |
| AC-01.2 | Status, thumbnail, nama produk, grup, dan kategori wajib diisi; deskripsi opsional (BR-02, BR-03). |
| AC-01.3 | Saat Selanjutnya diklik dan field wajib di langkah itu belum valid, pengguna tidak bisa pindah langkah dan error tampil di field terkait. |
| AC-01.4 | Langkah Kemasan menolak lanjut bila belum ada satu pun kemasan (BR-04). |
| AC-01.5 | Kemasan pertama terbuka dengan kuantitas 1 dan field kuantitas nonaktif; kemasan berikutnya terbuka dengan kuantitas 2 dan minimal 2 (BR-04, BR-05). |
| AC-01.6 | Form kemasan menampilkan seluruh toko tenant, masing-masing dengan kuantitas awal, harga pokok, dan harga jual, serta keuntungan yang dihitung otomatis (BR-07). |
| AC-01.7 | Kemasan tanpa barcode tidak bisa disimpan (BR-06). |
| AC-01.8 | Saat Simpan berhasil, kode produk terbit, toast sukses tampil, dan pengguna diarahkan ke daftar produk (BR-01). |
| AC-01.9 | Saat penyimpanan ditolak, pesan error tampil di langkah Tinjauan dan pada field terkait. |
| AC-01.10 | Saat pengguna meninggalkan wizard dengan isian yang belum disimpan, muncul konfirmasi perubahan belum disimpan. |
| AC-01.11 | Tenant belum punya toko sama sekali — tabel harga per toko tidak menampilkan baris apa pun. Perlu dikonfirmasi: apakah produk boleh disimpan tanpa nilai harga per toko. |
US-02 - Mengelola kemasan produk
Sebagai staf inventory, saya ingin menambah, mengubah, dan menghapus kemasan produk, agar satuan beli dan satuan jual selalu sesuai kenyataan.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Tab Kemasan menampilkan tiap kemasan beserta kuantitas konversi, satuan ukuran, barcode, dan nilai per toko. |
| AC-02.2 | Tambah, ubah, dan hapus kemasan tersedia di mode ubah sesuai izin, dan setiap aksi langsung tersimpan (BR-09). |
| AC-02.3 | Saat kemasan dasar diubah, field kuantitas tetap nonaktif di angka 1 (BR-04). |
| AC-02.4 | Tombol simpan pada dialog kemasan nonaktif sampai ada perubahan isian. |
| AC-02.5 | Menghapus kemasan dasar — tidak dicegah di layar. Perlu dikonfirmasi: penghapusan harus ditolak selama produk masih punya kemasan konversi, agar BR-04 terjaga. |
| AC-02.6 | Mengubah harga pokok atau harga jual sebuah kemasan memperbarui Inventaris Produk toko terkait (BR-08). |
US-03 - Mengubah data produk
Sebagai staf inventory, saya ingin mengubah data umum produk, agar katalog tetap akurat.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Tombol Ubah Data hanya tampil untuk pengguna dengan izin update. |
| AC-03.2 | Validasi tab Umum sama dengan langkah Umum saat pembuatan (AC-01.2). |
| AC-03.3 | Tab yang sedang dibuka dipertahankan di URL saat berpindah antara detail dan ubah. |
| AC-03.4 | Mengubah data umum tidak mengubah daftar kemasan (BR-09). |
US-04 - Daftar dan pencarian produk
Sebagai owner, saya ingin melihat dan menyaring produk, agar cepat menemukan barang tertentu beserta harganya.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Kolom: kode, nama produk beserta gambar utama, grup, kategori, dan status. |
| AC-04.2 | Pencarian kata kunci, filter status, paginasi, dan urutan default nama A–Z. Kolom yang bisa diurutkan: kode dan nama produk. |
| AC-04.3 | Kategori lebih dari satu ditampilkan sebagai jumlah kategori yang bisa dibuka untuk melihat daftarnya. |
| AC-04.4 | Baris bisa diperluas untuk melihat kemasan beserta stok dan harga tiap toko tanpa membuka detail. |
| AC-04.5 | Aksi baris: Lihat, Ubah, Hapus sesuai izin. |
US-05 - Menghapus produk
Sebagai staf inventory, saya ingin menghapus produk yang salah dibuat, agar katalog tetap bersih.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Hapus satuan dan hapus massal memerlukan konfirmasi dan izin delete. |
| AC-05.2 | Bila penghapusan ditolak, pesan error tampil sebagai toast. |
| AC-05.3 | Menghapus produk yang sudah dipakai di transaksi — Perlu dikonfirmasi: apakah ditolak, atau produk cukup dinonaktifkan (BR-10). |
US-06 - Riwayat aktivitas
Sebagai owner, saya ingin melihat log aktivitas produk, agar perubahan data dan harga bisa ditelusuri.
| ID | Kriteria penerimaan |
|---|---|
| AC-06.1 | Log aktivitas tersedia untuk seluruh produk (di daftar) dan per produk (di detail) (BR-11). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Staf Inventory | Mendaftarkan produk baru dari supplier: mengisi data umum, menambah kemasan pcs sebagai kemasan dasar dan karton isi 12 sebagai konversi, lalu menetapkan harga pokok dan harga jual tiap toko |
| Staf Inventory | Supplier mengganti isi karton dari 12 menjadi 24; mengubah kemasan konversi produk tersebut lalu memeriksa hasilnya di Inventaris Produk |
| Staf Purchasing | Mencari produk lewat barcode saat menyusun Pesanan Pembelian, dan memilih kemasan karton sebagai satuan pesanan |
| Owner | Menonaktifkan produk yang tidak dijual lagi agar tidak muncul di transaksi baru, tanpa menghapus riwayat pembeliannya |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Produk | inventory:product:list:any | — |
| Lihat Log Aktivitas | inventory:product:list:any | — |
| Lihat Detail Produk | inventory:product:view:any | — |
| Buat Produk | inventory:product:create:any | — |
| Ubah Produk (Data Umum) | inventory:product:update:any | — |
| Hapus Produk | inventory:product:delete:any | — |
| Tambah Kemasan | inventory:product:create:any | Dari halaman ubah produk |
| Ubah Kemasan | inventory:product:update:any | Dari halaman ubah produk |
| Hapus Kemasan | inventory:product:delete:any | Dari halaman ubah produk |
10.2 Action by Status
| Action | Aktif | Tidak Aktif |
|---|---|---|
| Lihat Detail Produk | ✓ | ✓ |
| Ubah Produk (Data Umum) | ✓ | ✓ |
| Kelola Kemasan | ✓ | ✓ |
| Hapus Produk | ✓ | ✓ |
| Dipilih pada Transaksi Baru | ✓ | — |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Product Inventory — baris stok dan harga per toko yang terbentuk dari kemasan produk (BR-08).
- Purchase Order dan Goods Receipt — memilih produk beserta kemasannya lewat pencarian nama atau barcode (BR-10).
Master data
- Product Groups — grup produk.
- Product Categories — kategori produk.
- Measurement Units — satuan ukuran tiap kemasan.
- Toko — daftar toko tempat harga dan kuantitas awal tiap kemasan ditetapkan.
Efek ke modul lain
- Menyimpan kemasan membentuk atau memperbarui baris Inventaris Produk pada tiap toko (BR-08).
- Produk beserta kemasannya menjadi pilihan di Purchase Order, Goods Receipt, dan Bill.
- Setiap perubahan tercatat di log aktivitas (BR-11).