Skip to Content

Grup Produk

  • Code: INV-PGR
  • Module: Inventory
  • Type: Master Data

1. Overview

Grup Produk adalah pengelompokan utama katalog barang berdasarkan jenis dagangannya — misalnya Sembako, Minuman, atau Peralatan Rumah Tangga. Setiap produk wajib memiliki tepat satu grup, sehingga grup menjadi pembagi paling kasar yang dipakai untuk membaca katalog, menyaring daftar, dan meringkas data penjualan maupun pembelian.

Hasil yang diharapkan: seluruh produk terbagi rapi dalam kelompok yang disepakati bersama, dan penambahan produk baru selalu jatuh pada kelompok yang sudah ada, bukan istilah baru yang dibuat masing-masing staf.

2. Problem

Tanpa daftar grup yang dikelola terpusat, pengelompokan produk mengandalkan kebiasaan tiap staf saat mengisi katalog. Akibatnya:

  • Kelompok yang sama ditulis dengan istilah berbeda, sehingga produk sejenis tidak berkumpul di satu tempat.
  • Daftar produk sulit disaring karena tidak ada pembagi yang konsisten.
  • Ringkasan per kelompok tidak bisa dipercaya, sehingga keputusan pengadaan hanya berdasar perkiraan.

3. Goals & Non-goals

3.1 Goals

  • Pengelompokan produk memakai istilah tunggal yang dipakai seluruh staf dan seluruh toko.
  • Grup baru bisa ditambahkan sendiri oleh tenant tanpa menunggu perubahan sistem.
  • Grup yang tidak dipakai lagi bisa dinonaktifkan tanpa mengubah produk yang terlanjur memakainya.

3.2 Non-goals

  • Hierarki grup bertingkat; pengelompokan yang lebih rinci dilakukan lewat Kategori Produk.
  • Pengaturan margin, pajak, atau kebijakan harga per grup.
  • Penggabungan dua grup menjadi satu beserta pemindahan produknya.

4. Business Rules

Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Grup 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 Setiap grup produk wajib memiliki kode dan nama grup. Perlu dikonfirmasi: apakah kode wajib unik dan berapa panjang maksimalnya.
  • BR-02 Setiap produk memiliki tepat satu grup produk.
  • BR-03 Grup yang tidak aktif tidak dipakai untuk produk baru. Perlu dikonfirmasi: saat ini pilihan grup pada form produk belum menyaring status aktif.
  • BR-04 Setiap perubahan data grup produk tercatat beserta pelaku dan waktunya.

5. Flow

5.1 Main Flowchart

  1. Isi Data Grup — Staf menentukan status, kode, dan nama grup lewat dialog tambah.
  2. Validasi — Isian diperiksa sebelum grup tersimpan. Grup yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada field yang bersangkutan.
  3. Grup Tersimpan — Grup langsung tersedia sebagai pilihan saat produk dibuat atau diubah.
    • 3a. Ubah Data Grup — Status, kode, dan nama grup bisa diperbarui kapan saja lewat dialog ubah.
  4. Dipakai di Produk — Produk memilih satu grup sebagai pengelompokan utamanya. Rinciannya dijelaskan di PRD Products.

5.2 Status Lifecycle

StatusKeteranganSelanjutnya
Aktif
is_active: true
Grup dipakai untuk mengelompokkan produkTidak Aktif, atau dihapus
Tidak Aktif
is_active: false
Grup tidak dipakai lagi untuk produk baruAktif, atau dihapus

6. Document Structure

Bagian ini mendefinisikan isi data Grup Produk itu sendiri: field apa saja yang dimilikinya, tipenya, mana yang wajib, nilai awalnya, dan aturan nilainya. Ketentuan di sini berlaku di mana pun grup dibuat atau diubah dan ditegakkan saat penyimpanan, terlepas dari bagaimana field itu ditampilkan.

6.1 General

FieldTipeWajibDefaultAturan
StatusEnumYaBelum dipilihAktif atau Tidak Aktif
KodeTeksYa—(BR-01)
Nama GrupTeksYa—(BR-01)

7. UI Structure

Bagian ini mendefinisikan cara Grup Produk ditampilkan dan dioperasikan: kolom pada daftar dan kontrol form beserta perilakunya. Log Aktivitas tersedia sebagai drawer dari halaman daftar (seluruh grup) dan dari dialog detail (per grup). Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.

7.1 Datatable

KolomSortableContoh NilaiKomponen
Pilih——Checkbox
No—1Number
KodeYaSMBText
Nama GrupYaSembakoText
Status—AktifBadge
Aksi—Lihat · Ubah · HapusAction Menu

7.2 Form & Details

Buat — Dialog berisi status, kode, dan nama grup. Aksi: Simpan, yang aktif hanya setelah ada isian berubah.

Ubah — Dialog yang sama dengan isian terisi data grup terpilih. Aksi: Perbarui.

Detail — Dialog hanya baca berisi status, kode, dan nama grup, dengan menu aksi berisi Log Aktivitas dan Ubah.

Data Grup

FieldKontrolSumber PilihanPerilaku
StatusSingle SelectAktif atau Tidak AktifPilihan yang sedang terpilih bisa dibatalkan, dan status menjadi kosong
KodeText Input——
Nama GrupText Input——

8. User Stories

US-01 - Menambah grup produk

Sebagai staf inventory, saya ingin menambahkan grup produk, agar produk baru bisa dikelompokkan dengan istilah yang disepakati.

IDKriteria penerimaan
AC-01.1Tombol Tambah Baru hanya tampil untuk pengguna dengan izin create, dan membuka dialog dengan isian kosong.
AC-01.2Status, kode, dan nama grup wajib diisi; error tampil pada field yang belum valid (BR-01).
AC-01.3Tombol simpan nonaktif selama belum ada isian yang berubah.
AC-01.4Setelah berhasil, toast sukses tampil, dialog tertutup, dan daftar diperbarui.
AC-01.5Kode grup duplikat — ditolak saat disimpan; pesan error tampil pada field kode (BR-01).

US-02 - Mengubah grup produk

Sebagai staf inventory, saya ingin mengubah grup produk, agar penamaan dan statusnya tetap sesuai.

IDKriteria penerimaan
AC-02.1Aksi Ubah tersedia dari daftar dan dari dialog detail, hanya untuk pengguna dengan izin update.
AC-02.2Validasi sama dengan penambahan (AC-01.2).
AC-02.3Grup yang dinonaktifkan tidak mengubah produk yang sudah memakainya (BR-03).

US-03 - Daftar grup produk

Sebagai owner, saya ingin melihat seluruh grup produk, agar bisa memastikan pengelompokan katalog tetap rapi.

IDKriteria penerimaan
AC-03.1Kolom: kode, nama grup, dan status; urutan default nama A–Z dengan paginasi.
AC-03.2Kolom yang bisa diurutkan: kode dan nama grup. Pencarian memakai kata kunci.
AC-03.3Aksi baris: Lihat, Ubah, Hapus sesuai izin.

US-04 - Menghapus grup produk

Sebagai staf inventory, saya ingin menghapus grup yang salah dibuat, agar daftar tetap bersih.

IDKriteria penerimaan
AC-04.1Hapus satuan dan hapus massal memerlukan konfirmasi dan izin delete.
AC-04.2Bila penghapusan ditolak, pesan error tampil sebagai toast.
AC-04.3Menghapus grup yang masih dipakai produk — Perlu dikonfirmasi: apakah ditolak, karena tiap produk wajib punya satu grup (BR-02).

US-05 - Riwayat aktivitas

Sebagai owner, saya ingin melihat log aktivitas grup produk, agar perubahan bisa ditelusuri.

IDKriteria penerimaan
AC-05.1Log aktivitas tersedia untuk seluruh grup (di daftar) dan per grup (dari dialog detail) (BR-04).

9. User Scenarios

RoleScenario
Staf InventoryMenyiapkan katalog awal tenant dengan membuat grup Sembako, Minuman, dan Perlengkapan sebelum produk pertama didaftarkan
Staf InventoryMenambah grup baru saat tenant mulai menjual lini dagangan yang belum pernah ada
OwnerMenonaktifkan grup yang tidak dipakai lagi agar tidak dipilih untuk produk baru

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat List Grup Produkinventory:product-group:list:any—
Lihat Log Aktivitasinventory:product-group:list:any—
Lihat Detail Grup Produkinventory:product-group:view:any—
Buat Grup Produkinventory:product-group:create:any—
Ubah Grup Produkinventory:product-group:update:any—
Hapus Grup Produkinventory:product-group:delete:any—

10.2 Action by Status

ActionAktifTidak Aktif
Lihat Detail Grup Produk✓✓
Ubah Grup Produk✓✓
Hapus Grup Produk✓✓
Dipilih pada Produk Baru✓—

11. Notifications

Fitur ini tidak memicu notifikasi.

12. Dependencies

PRD terkait

  • Products — produk memilih tepat satu grup (BR-02).

Efek ke modul lain

  • Grup tampil sebagai kolom dan penyaring pada daftar Produk serta daftar Inventaris Produk.
  • Setiap perubahan tercatat di log aktivitas (BR-04).
Terakhir diperbarui