Kategori Produk
- Code: INV-PCT
- Module: Inventory
- Type: Master Data
1. Overview
Kategori Produk adalah label yang menerangkan sifat atau peruntukan sebuah produk — misalnya Minuman Dingin, Produk Promo, atau Kebutuhan Harian. Berbeda dengan Grup Produk yang dipilih tepat satu per produk, satu produk boleh memiliki lebih dari satu kategori, sehingga katalog bisa dibaca dari beberapa sudut sekaligus.
Hasil yang diharapkan: produk bisa ditelusuri lewat label yang sesuai kebutuhan sehari-hari toko, tanpa memaksa katalog masuk ke satu pembagian tunggal.
2. Problem
Pengelompokan tunggal lewat grup tidak cukup untuk kebutuhan operasional harian, karena satu barang sering perlu dilihat dari beberapa sudut sekaligus. Akibatnya:
- Produk yang punya lebih dari satu sifat terpaksa dipaksakan masuk ke satu kelompok saja.
- Staf membuat penandaan sendiri di luar sistem, sehingga tidak bisa dipakai bersama.
- Daftar produk sulit dipersempit sesuai kebutuhan tertentu, misalnya saat menyiapkan promo.
3. Goals & Non-goals
3.1 Goals
- Satu produk bisa diberi lebih dari satu label sesuai sifat dan peruntukannya.
- Daftar kategori dikelola tenant sendiri dan dipakai seragam di seluruh toko.
- Kategori yang tidak dipakai lagi bisa dinonaktifkan tanpa mengubah produk yang terlanjur memakainya.
3.2 Non-goals
- Hierarki kategori bertingkat.
- Aturan otomatis yang memberi kategori berdasarkan nama atau grup produk.
- Pengaturan harga, diskon, atau pajak per kategori.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Kategori 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 kategori produk wajib memiliki nama kategori. Perlu dikonfirmasi: apakah nama wajib unik dan berapa panjang maksimalnya.
- BR-02 Satu produk boleh memiliki lebih dari satu kategori, dan wajib memiliki sedikitnya satu.
- BR-03 Kategori yang tidak aktif tidak dipakai untuk produk baru. Perlu dikonfirmasi: saat ini pilihan kategori pada form produk belum menyaring status aktif.
- BR-04 Setiap perubahan data kategori produk tercatat beserta pelaku dan waktunya.
5. Flow
5.1 Main Flowchart
- Isi Data Kategori — Staf menentukan status dan nama kategori lewat dialog tambah.
- Validasi — Isian diperiksa sebelum kategori tersimpan. Kategori yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada field yang bersangkutan.
- Kategori Tersimpan — Kategori langsung tersedia sebagai pilihan saat produk dibuat atau diubah.
- 3a. Ubah Data Kategori — Status dan nama kategori bisa diperbarui kapan saja lewat dialog ubah.
- Dipakai di Produk — Produk memilih satu atau lebih kategori. Rinciannya dijelaskan di PRD Products.
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
Aktifis_active: true | Kategori dipakai untuk melabeli produk | Tidak Aktif, atau dihapus |
Tidak Aktifis_active: false | Kategori tidak dipakai lagi untuk produk baru | Aktif, atau dihapus |
6. Document Structure
Bagian ini mendefinisikan isi data Kategori Produk itu sendiri: field apa saja yang dimilikinya, tipenya, mana yang wajib, nilai awalnya, dan aturan nilainya. Ketentuan di sini berlaku di mana pun kategori 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 |
| Nama Kategori | Teks | Ya | — | (BR-01) |
7. UI Structure
Bagian ini mendefinisikan cara Kategori Produk ditampilkan dan dioperasikan: kolom pada daftar dan kontrol form beserta perilakunya. Log Aktivitas tersedia sebagai drawer dari halaman daftar (seluruh kategori) dan dari dialog detail (per kategori). 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 |
| Nama Kategori | Ya | Minuman Dingin | Text |
| Status | — | Aktif | Badge |
| Aksi | — | Lihat · Ubah · Hapus | Action Menu |
7.2 Form & Details
Buat — Dialog berisi status dan nama kategori. Aksi: Simpan, yang aktif hanya setelah ada isian berubah.
Ubah — Dialog yang sama dengan isian terisi data kategori terpilih. Aksi: Perbarui.
Detail — Dialog hanya baca berisi status dan nama kategori, dengan menu aksi berisi Log Aktivitas dan Ubah.
Data Kategori
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Status | Single Select | Aktif atau Tidak Aktif | Pilihan yang sedang terpilih bisa dibatalkan, dan status menjadi kosong |
| Nama Kategori | Text Input | — | — |
8. User Stories
US-01 - Menambah kategori produk
Sebagai staf inventory, saya ingin menambahkan kategori produk, agar produk bisa dilabeli sesuai kebutuhan toko.
| 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 dan nama kategori 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. |
US-02 - Mengubah kategori produk
Sebagai staf inventory, saya ingin mengubah kategori 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 | Kategori yang dinonaktifkan tidak mengubah produk yang sudah memakainya (BR-03). |
US-03 - Daftar kategori produk
Sebagai owner, saya ingin melihat seluruh kategori produk, agar pelabelan katalog tetap terkendali.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Kolom: nama kategori dan status; urutan default nama A–Z dengan paginasi. |
| AC-03.2 | Kolom yang bisa diurutkan: nama kategori. Pencarian memakai kata kunci. |
| AC-03.3 | Aksi baris: Lihat, Ubah, Hapus sesuai izin. |
US-04 - Menghapus kategori produk
Sebagai staf inventory, saya ingin menghapus kategori 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 kategori terakhir milik sebuah produk — Perlu dikonfirmasi: apakah ditolak, karena tiap produk wajib punya sedikitnya satu kategori (BR-02). |
US-05 - Riwayat aktivitas
Sebagai owner, saya ingin melihat log aktivitas kategori produk, agar perubahan bisa ditelusuri.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Log aktivitas tersedia untuk seluruh kategori (di daftar) dan per kategori (dari dialog detail) (BR-04). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Staf Inventory | Menyiapkan label katalog awal seperti Kebutuhan Harian dan Minuman Dingin sebelum produk pertama didaftarkan |
| Staf Inventory | Menambah kategori Produk Promo menjelang program diskon, lalu melabelinya ke sejumlah produk |
| Owner | Menonaktifkan kategori musiman setelah programnya berakhir agar tidak dipilih untuk produk baru |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Kategori Produk | inventory:product-category:list:any | — |
| Lihat Log Aktivitas | inventory:product-category:list:any | — |
| Lihat Detail Kategori Produk | inventory:product-category:view:any | — |
| Buat Kategori Produk | inventory:product-category:create:any | — |
| Ubah Kategori Produk | inventory:product-category:update:any | — |
| Hapus Kategori Produk | inventory:product-category:delete:any | — |
10.2 Action by Status
| Action | Aktif | Tidak Aktif |
|---|---|---|
| Lihat Detail Kategori Produk | ✓ | ✓ |
| Ubah Kategori Produk | ✓ | ✓ |
| Hapus Kategori Produk | ✓ | ✓ |
| Dipilih pada Produk Baru | ✓ | — |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Products — produk memilih satu atau lebih kategori (BR-02).
Efek ke modul lain
- Kategori tampil sebagai kolom pada daftar Produk dan daftar Inventaris Produk.
- Setiap perubahan tercatat di log aktivitas (BR-04).