Skip to Content

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

  1. Data Umum — Staf menentukan status produk, thumbnail, nama, grup, kategori, dan deskripsi.
  2. 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.
  3. Tinjauan — Seluruh isian ditinjau ulang sebelum disimpan.
  4. Validasi — Isian diperiksa sebelum produk tersimpan. Produk yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada langkah yang bersangkutan.
  5. 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).
  6. Inventaris Produk — Nilai tiap kemasan per toko membentuk baris Inventaris Produk. Rinciannya dijelaskan di PRD Product Inventory.

5.2 Status Lifecycle

StatusKeteranganSelanjutnya
Aktif
is_active: true
Produk bisa dipilih pada transaksi baruTidak Aktif, atau dihapus
Tidak Aktif
is_active: false
Produk tampil tetapi tidak bisa dipilih pada transaksi baruAktif, 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

FieldTipeWajibDefaultAturan
KodeTeks—Dibuat saat disimpanDitetapkan sistem, tidak bisa diubah (BR-01)
StatusEnumYaBelum dipilihAktif atau Tidak Aktif
ThumbnailBerkas, banyakYa—Berupa gambar; urutan unggah menentukan gambar utama (BR-03)
Nama ProdukTeksYa——
GrupRef. Grup ProdukYa—Tepat satu grup (BR-02)
KategoriRef. Kategori Produk, banyakYa—Minimal satu kategori (BR-02)
DeskripsiTeksTidak——

6.2 Package

FieldTipeWajibDefaultAturan
Kuantitas KonversiAngkaYa1 untuk kemasan dasar, 2 untuk kemasan berikutnyaKemasan dasar terkunci di 1; kemasan lain minimal 2 (BR-04, BR-05)
Satuan UkuranRef. Satuan UkuranYa—Dipilih dari master Satuan Ukuran
BarcodeTeks, banyakYa—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).

FieldTipeWajibDefaultAturan
TokoRef. Toko—Seluruh toko tenantDitetapkan sistem; satu baris per toko
Kuantitas AwalDesimalYa0Minimal 0 (BR-07)
Harga PokokMata UangYa0Lebih besar dari 0 (BR-07)
Harga JualMata UangYa0Lebih 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

KolomSortableContoh NilaiKomponen
Pilih——Checkbox, Expand Toggle
No—1Number
KodeYaSKU-0012Link
Nama ProdukYaMinyak Goreng 2LThumbnail, Text
Grup—SembakoText
Kategori—Minyak & BumbuText, Accordion bila lebih dari satu
Status—AktifBadge
Aksi—Lihat · Ubah · HapusAction Menu

Expanded Row

Daftar kemasan produk beserta nilainya per toko.

KolomContoh NilaiKomponen
KemasanKemasan 1Text
Kuantitas Konversi12Number
Satuan UkuranKarton (KRT)Text
Barcode8991002123456Text
Toko[CBI] Toko CianjurText
Stok24Number
Harga PokokRp 250.000Currency
Harga JualRp 275.000Currency
KeuntunganRp 25.000 (10,0%)Text

7.2 Advance Filter

FieldKontrolSumber PilihanDefault
StatusSingle SelectAktif, Tidak AktifKosong

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

FieldKontrolSumber PilihanPerilaku
StatusSingle SelectAktif atau Tidak AktifPilihan yang sedang terpilih bisa dibatalkan, dan status menjadi kosong
ThumbnailFile Uploader, banyak—Hanya menerima berkas gambar; urutan unggah menentukan gambar utama
Nama ProdukText Input——
GrupSingle SelectMaster Grup Produk, bisa dicari—
KategoriMulti SelectMaster Kategori Produk, bisa dicari—
DeskripsiTextarea——

Kemasan — Daftar

KolomContoh NilaiKomponen
KemasanKemasan 1Text
Kuantitas Konversi12Number
Satuan UkuranKarton (KRT)Text
Barcode8991002123456Text
AksiUbah · HapusAction Menu

Kemasan — Form

FieldKontrolSumber PilihanPerilaku
Kuantitas KonversiNumber Input—Nonaktif dan bernilai 1 pada kemasan dasar; minimal 2 pada kemasan lain
Satuan UkuranSingle SelectMaster Satuan Ukuran, bisa dicari, ditampilkan sebagai nama beserta simbolnya—
BarcodeText 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.

FieldKontrolSumber PilihanPerilaku
TokoRead-onlySeluruh toko tenant—
Kuantitas AwalNumber Input——
Harga PokokCurrency Input—Diubah → Keuntungan dihitung ulang
Harga JualCurrency Input—Diubah → Keuntungan dihitung ulang
KeuntunganRead-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.

IDKriteria penerimaan
AC-01.1Saat pengguna dengan izin create membuka Tambah Baru, wizard Umum → Kemasan → Tinjauan tampil dengan seluruh field kosong.
AC-01.2Status, thumbnail, nama produk, grup, dan kategori wajib diisi; deskripsi opsional (BR-02, BR-03).
AC-01.3Saat Selanjutnya diklik dan field wajib di langkah itu belum valid, pengguna tidak bisa pindah langkah dan error tampil di field terkait.
AC-01.4Langkah Kemasan menolak lanjut bila belum ada satu pun kemasan (BR-04).
AC-01.5Kemasan pertama terbuka dengan kuantitas 1 dan field kuantitas nonaktif; kemasan berikutnya terbuka dengan kuantitas 2 dan minimal 2 (BR-04, BR-05).
AC-01.6Form kemasan menampilkan seluruh toko tenant, masing-masing dengan kuantitas awal, harga pokok, dan harga jual, serta keuntungan yang dihitung otomatis (BR-07).
AC-01.7Kemasan tanpa barcode tidak bisa disimpan (BR-06).
AC-01.8Saat Simpan berhasil, kode produk terbit, toast sukses tampil, dan pengguna diarahkan ke daftar produk (BR-01).
AC-01.9Saat penyimpanan ditolak, pesan error tampil di langkah Tinjauan dan pada field terkait.
AC-01.10Saat pengguna meninggalkan wizard dengan isian yang belum disimpan, muncul konfirmasi perubahan belum disimpan.
AC-01.11Tenant 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.

IDKriteria penerimaan
AC-02.1Tab Kemasan menampilkan tiap kemasan beserta kuantitas konversi, satuan ukuran, barcode, dan nilai per toko.
AC-02.2Tambah, ubah, dan hapus kemasan tersedia di mode ubah sesuai izin, dan setiap aksi langsung tersimpan (BR-09).
AC-02.3Saat kemasan dasar diubah, field kuantitas tetap nonaktif di angka 1 (BR-04).
AC-02.4Tombol simpan pada dialog kemasan nonaktif sampai ada perubahan isian.
AC-02.5Menghapus kemasan dasar — tidak dicegah di layar. Perlu dikonfirmasi: penghapusan harus ditolak selama produk masih punya kemasan konversi, agar BR-04 terjaga.
AC-02.6Mengubah 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.

IDKriteria penerimaan
AC-03.1Tombol Ubah Data hanya tampil untuk pengguna dengan izin update.
AC-03.2Validasi tab Umum sama dengan langkah Umum saat pembuatan (AC-01.2).
AC-03.3Tab yang sedang dibuka dipertahankan di URL saat berpindah antara detail dan ubah.
AC-03.4Mengubah 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.

IDKriteria penerimaan
AC-04.1Kolom: kode, nama produk beserta gambar utama, grup, kategori, dan status.
AC-04.2Pencarian kata kunci, filter status, paginasi, dan urutan default nama A–Z. Kolom yang bisa diurutkan: kode dan nama produk.
AC-04.3Kategori lebih dari satu ditampilkan sebagai jumlah kategori yang bisa dibuka untuk melihat daftarnya.
AC-04.4Baris bisa diperluas untuk melihat kemasan beserta stok dan harga tiap toko tanpa membuka detail.
AC-04.5Aksi baris: Lihat, Ubah, Hapus sesuai izin.

US-05 - Menghapus produk

Sebagai staf inventory, saya ingin menghapus produk yang salah dibuat, agar katalog tetap bersih.

IDKriteria penerimaan
AC-05.1Hapus satuan dan hapus massal memerlukan konfirmasi dan izin delete.
AC-05.2Bila penghapusan ditolak, pesan error tampil sebagai toast.
AC-05.3Menghapus 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.

IDKriteria penerimaan
AC-06.1Log aktivitas tersedia untuk seluruh produk (di daftar) dan per produk (di detail) (BR-11).

9. User Scenarios

RoleScenario
Staf InventoryMendaftarkan 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 InventorySupplier mengganti isi karton dari 12 menjadi 24; mengubah kemasan konversi produk tersebut lalu memeriksa hasilnya di Inventaris Produk
Staf PurchasingMencari produk lewat barcode saat menyusun Pesanan Pembelian, dan memilih kemasan karton sebagai satuan pesanan
OwnerMenonaktifkan produk yang tidak dijual lagi agar tidak muncul di transaksi baru, tanpa menghapus riwayat pembeliannya

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat List Produkinventory:product:list:any—
Lihat Log Aktivitasinventory:product:list:any—
Lihat Detail Produkinventory:product:view:any—
Buat Produkinventory:product:create:any—
Ubah Produk
(Data Umum)
inventory:product:update:any—
Hapus Produkinventory:product:delete:any—
Tambah Kemasaninventory:product:create:anyDari halaman ubah produk
Ubah Kemasaninventory:product:update:anyDari halaman ubah produk
Hapus Kemasaninventory:product:delete:anyDari halaman ubah produk

10.2 Action by Status

ActionAktifTidak 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

Master data

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).
Terakhir diperbarui