Skip to Content

Satuan Ukuran

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

1. Overview

Satuan Ukuran adalah daftar satuan yang dipakai untuk menyatakan kemasan produk — pcs, karton, dus, kilogram, dan sejenisnya. Setiap kemasan produk memilih tepat satu satuan ukuran, sehingga satuan inilah yang tampil pada pesanan pembelian, penerimaan barang, tagihan, dan daftar stok. Tiap satuan punya simbol pendek untuk tampilan tabel dan nama lengkap untuk pemilihan.

Hasil yang diharapkan: satuan yang dipakai seluruh toko seragam, sehingga kuantitas pada dokumen transaksi selalu terbaca sama oleh siapa pun.

2. Problem

Tanpa daftar satuan yang dikelola terpusat, satuan ditulis bebas saat mengisi kemasan produk. Akibatnya:

  • Satuan yang sama ditulis berbeda-beda, sehingga dokumen transaksi terbaca tidak konsisten.
  • Kolom kuantitas pada tabel menjadi panjang dan sulit dibaca karena tidak ada simbol pendek yang disepakati.
  • Kekeliruan satuan baru ketahuan saat barang datang, ketika jumlah yang dikirim tidak sesuai harapan.

3. Goals & Non-goals

3.1 Goals

  • Satuan yang dipakai di seluruh kemasan produk berasal dari satu daftar yang sama.
  • Setiap satuan punya simbol pendek yang konsisten untuk tampilan tabel dan dokumen cetak.
  • Satuan yang tidak dipakai lagi bisa dinonaktifkan tanpa mengubah kemasan yang terlanjur memakainya.

3.2 Non-goals

  • Konversi antar satuan ukuran secara umum, misalnya kilogram ke gram; konversi hanya dicatat per kemasan produk lewat kuantitas konversi.
  • Penggolongan satuan berdasarkan dimensi seperti berat, panjang, atau volume.
  • Pembulatan dan jumlah angka desimal per satuan.

4. Business Rules

Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Satuan Ukuran 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 Simbol satuan wajib diisi, maksimal 5 karakter.
  • BR-02 Nama satuan ukuran wajib diisi, maksimal 20 karakter.
  • BR-03 Setiap kemasan produk memilih tepat satu satuan ukuran.
  • BR-04 Satuan yang tidak aktif tidak dipakai untuk kemasan baru. Perlu dikonfirmasi: saat ini pilihan satuan pada form kemasan produk belum menyaring status aktif.
  • BR-05 Setiap perubahan data satuan ukuran tercatat beserta pelaku dan waktunya.

5. Flow

5.1 Main Flowchart

  1. Isi Data Satuan — Staf menentukan status, simbol, dan nama satuan lewat dialog tambah.
  2. Validasi — Isian diperiksa sebelum satuan tersimpan. Satuan yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada field yang bersangkutan.
  3. Satuan Tersimpan — Satuan langsung tersedia sebagai pilihan saat kemasan produk dibuat atau diubah.
    • 3a. Ubah Data Satuan — Status, simbol, dan nama satuan bisa diperbarui kapan saja lewat dialog ubah.
  4. Dipakai di Kemasan Produk — Kemasan produk memilih satu satuan ukuran, yang kemudian tampil di seluruh dokumen transaksi. Rinciannya dijelaskan di PRD Products.

5.2 Status Lifecycle

StatusKeteranganSelanjutnya
Aktif
is_active: true
Satuan dipakai untuk kemasan produkTidak Aktif, atau dihapus
Tidak Aktif
is_active: false
Satuan tidak dipakai lagi untuk kemasan baruAktif, atau dihapus

6. Document Structure

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

6.1 General

FieldTipeWajibDefaultAturan
StatusEnumYaBelum dipilihAktif atau Tidak Aktif
SimbolTeksYa—Maksimal 5 karakter (BR-01)
Nama Satuan UkuranTeksYa—Maksimal 20 karakter (BR-02)

7. UI Structure

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

7.1 Datatable

KolomSortableContoh NilaiKomponen
Pilih——Checkbox
No—1Number
SimbolYaKRTText
Nama Satuan UkuranYaKartonText
Status—AktifBadge
Aksi—Lihat · Ubah · HapusAction Menu

7.2 Form & Details

Buat — Dialog berisi status, simbol, dan nama satuan ukuran. Aksi: Simpan, yang aktif hanya setelah ada isian berubah.

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

Detail — Dialog hanya baca berisi status, simbol, dan nama satuan ukuran, dengan menu aksi berisi Log Aktivitas dan Ubah.

Data Satuan Ukuran

FieldKontrolSumber PilihanPerilaku
StatusSingle SelectAktif atau Tidak AktifPilihan yang sedang terpilih bisa dibatalkan, dan status menjadi kosong
SimbolText Input—Maksimal 5 karakter
Nama Satuan UkuranText Input—Maksimal 20 karakter

8. User Stories

US-01 - Menambah satuan ukuran

Sebagai staf inventory, saya ingin menambahkan satuan ukuran, agar kemasan produk memakai satuan yang seragam.

IDKriteria penerimaan
AC-01.1Tombol Tambah Baru hanya tampil untuk pengguna dengan izin create, dan membuka dialog dengan isian kosong.
AC-01.2Status, simbol, dan nama satuan wajib diisi; simbol maksimal 5 karakter dan nama maksimal 20 karakter (BR-01, BR-02).
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.5Simbol duplikat — Perlu dikonfirmasi: apakah simbol wajib unik dan ditolak saat disimpan.

US-02 - Mengubah satuan ukuran

Sebagai staf inventory, saya ingin mengubah satuan ukuran, agar simbol dan namanya 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.3Mengubah simbol satuan ikut mengubah tampilan satuan pada kemasan produk yang memakainya (BR-03).

US-03 - Daftar satuan ukuran

Sebagai owner, saya ingin melihat seluruh satuan ukuran, agar bisa memastikan tidak ada satuan kembar.

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

US-04 - Menghapus satuan ukuran

Sebagai staf inventory, saya ingin menghapus satuan 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 satuan yang masih dipakai kemasan produk — Perlu dikonfirmasi: apakah ditolak, karena tiap kemasan wajib punya satuan (BR-03).

US-05 - Riwayat aktivitas

Sebagai owner, saya ingin melihat log aktivitas satuan ukuran, agar perubahan bisa ditelusuri.

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

9. User Scenarios

RoleScenario
Staf InventoryMenyiapkan satuan dasar tenant — pcs, karton, dus — sebelum kemasan produk pertama dibuat
Staf InventoryMenambah satuan baru saat supplier mulai mengirim barang dalam kemasan yang belum pernah dipakai
OwnerMenonaktifkan satuan yang tidak dipakai lagi agar tidak dipilih untuk kemasan baru

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat List Satuan Ukuraninventory:measurement-unit:list:any—
Lihat Log Aktivitasinventory:measurement-unit:list:any—
Lihat Detail Satuan Ukuraninventory:measurement-unit:view:any—
Buat Satuan Ukuraninventory:measurement-unit:create:any—
Ubah Satuan Ukuraninventory:measurement-unit:update:any—
Hapus Satuan Ukuraninventory:measurement-unit:delete:any—

10.2 Action by Status

ActionAktifTidak Aktif
Lihat Detail Satuan Ukuran✓✓
Ubah Satuan Ukuran✓✓
Hapus Satuan Ukuran✓✓
Dipilih pada Kemasan Baru✓—

11. Notifications

Fitur ini tidak memicu notifikasi.

12. Dependencies

PRD terkait

  • Products — tiap kemasan produk memilih satu satuan ukuran (BR-03).

Efek ke modul lain

  • Satuan ukuran tampil pada kolom satuan di Inventaris Produk, Purchase Order, Purchase Order Line, Goods Receipt, dan Bill, termasuk pada dokumen PDF-nya.
  • Setiap perubahan tercatat di log aktivitas (BR-05).
Terakhir diperbarui