Skip to Content

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

  1. Isi Data Kategori — Staf menentukan status dan nama kategori lewat dialog tambah.
  2. Validasi — Isian diperiksa sebelum kategori tersimpan. Kategori yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada field yang bersangkutan.
  3. 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.
  4. Dipakai di Produk — Produk memilih satu atau lebih kategori. Rinciannya dijelaskan di PRD Products.

5.2 Status Lifecycle

StatusKeteranganSelanjutnya
Aktif
is_active: true
Kategori dipakai untuk melabeli produkTidak Aktif, atau dihapus
Tidak Aktif
is_active: false
Kategori tidak dipakai lagi untuk produk baruAktif, 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

FieldTipeWajibDefaultAturan
StatusEnumYaBelum dipilihAktif atau Tidak Aktif
Nama KategoriTeksYa—(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

KolomSortableContoh NilaiKomponen
Pilih——Checkbox
No—1Number
Nama KategoriYaMinuman DinginText
Status—AktifBadge
Aksi—Lihat · Ubah · HapusAction 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

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

8. User Stories

US-01 - Menambah kategori produk

Sebagai staf inventory, saya ingin menambahkan kategori produk, agar produk bisa dilabeli sesuai kebutuhan toko.

IDKriteria penerimaan
AC-01.1Tombol Tambah Baru hanya tampil untuk pengguna dengan izin create, dan membuka dialog dengan isian kosong.
AC-01.2Status dan nama kategori 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.

US-02 - Mengubah kategori produk

Sebagai staf inventory, saya ingin mengubah kategori 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.3Kategori 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.

IDKriteria penerimaan
AC-03.1Kolom: nama kategori dan status; urutan default nama A–Z dengan paginasi.
AC-03.2Kolom yang bisa diurutkan: nama kategori. Pencarian memakai kata kunci.
AC-03.3Aksi 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.

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 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.

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

9. User Scenarios

RoleScenario
Staf InventoryMenyiapkan label katalog awal seperti Kebutuhan Harian dan Minuman Dingin sebelum produk pertama didaftarkan
Staf InventoryMenambah kategori Produk Promo menjelang program diskon, lalu melabelinya ke sejumlah produk
OwnerMenonaktifkan kategori musiman setelah programnya berakhir agar tidak dipilih untuk produk baru

10. Permissions & Actions

10.1 Permission by Action

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

10.2 Action by Status

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