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
- Isi Data Grup — Staf menentukan status, kode, dan nama grup lewat dialog tambah.
- Validasi — Isian diperiksa sebelum grup tersimpan. Grup yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada field yang bersangkutan.
- 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.
- Dipakai di Produk — Produk memilih satu grup sebagai pengelompokan utamanya. Rinciannya dijelaskan di PRD Products.
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
Aktifis_active: true | Grup dipakai untuk mengelompokkan produk | Tidak Aktif, atau dihapus |
Tidak Aktifis_active: false | Grup tidak dipakai lagi untuk produk baru | Aktif, 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
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Status | Enum | Ya | Belum dipilih | Aktif atau Tidak Aktif |
| Kode | Teks | Ya | — | (BR-01) |
| Nama Grup | Teks | Ya | — | (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
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Pilih | — | — | Checkbox |
| No | — | 1 | Number |
| Kode | Ya | SMB | Text |
| Nama Grup | Ya | Sembako | Text |
| Status | — | Aktif | Badge |
| Aksi | — | Lihat · Ubah · Hapus | Action 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
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Status | Single Select | Aktif atau Tidak Aktif | Pilihan yang sedang terpilih bisa dibatalkan, dan status menjadi kosong |
| Kode | Text Input | — | — |
| Nama Grup | Text 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Tombol Tambah Baru hanya tampil untuk pengguna dengan izin create, dan membuka dialog dengan isian kosong. |
| AC-01.2 | Status, kode, dan nama grup wajib diisi; error tampil pada field yang belum valid (BR-01). |
| AC-01.3 | Tombol simpan nonaktif selama belum ada isian yang berubah. |
| AC-01.4 | Setelah berhasil, toast sukses tampil, dialog tertutup, dan daftar diperbarui. |
| AC-01.5 | Kode 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Aksi Ubah tersedia dari daftar dan dari dialog detail, hanya untuk pengguna dengan izin update. |
| AC-02.2 | Validasi sama dengan penambahan (AC-01.2). |
| AC-02.3 | Grup 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Kolom: kode, nama grup, dan status; urutan default nama A–Z dengan paginasi. |
| AC-03.2 | Kolom yang bisa diurutkan: kode dan nama grup. Pencarian memakai kata kunci. |
| AC-03.3 | Aksi 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Hapus satuan dan hapus massal memerlukan konfirmasi dan izin delete. |
| AC-04.2 | Bila penghapusan ditolak, pesan error tampil sebagai toast. |
| AC-04.3 | Menghapus 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Log aktivitas tersedia untuk seluruh grup (di daftar) dan per grup (dari dialog detail) (BR-04). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Staf Inventory | Menyiapkan katalog awal tenant dengan membuat grup Sembako, Minuman, dan Perlengkapan sebelum produk pertama didaftarkan |
| Staf Inventory | Menambah grup baru saat tenant mulai menjual lini dagangan yang belum pernah ada |
| Owner | Menonaktifkan grup yang tidak dipakai lagi agar tidak dipilih untuk produk baru |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Grup Produk | inventory:product-group:list:any | — |
| Lihat Log Aktivitas | inventory:product-group:list:any | — |
| Lihat Detail Grup Produk | inventory:product-group:view:any | — |
| Buat Grup Produk | inventory:product-group:create:any | — |
| Ubah Grup Produk | inventory:product-group:update:any | — |
| Hapus Grup Produk | inventory:product-group:delete:any | — |
10.2 Action by Status
| Action | Aktif | Tidak 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).