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
- Isi Data Satuan — Staf menentukan status, simbol, dan nama satuan lewat dialog tambah.
- Validasi — Isian diperiksa sebelum satuan tersimpan. Satuan yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada field yang bersangkutan.
- 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.
- 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
| Status | Keterangan | Selanjutnya |
|---|---|---|
Aktifis_active: true | Satuan dipakai untuk kemasan produk | Tidak Aktif, atau dihapus |
Tidak Aktifis_active: false | Satuan tidak dipakai lagi untuk kemasan baru | Aktif, 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
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Status | Enum | Ya | Belum dipilih | Aktif atau Tidak Aktif |
| Simbol | Teks | Ya | — | Maksimal 5 karakter (BR-01) |
| Nama Satuan Ukuran | Teks | Ya | — | 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
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Pilih | — | — | Checkbox |
| No | — | 1 | Number |
| Simbol | Ya | KRT | Text |
| Nama Satuan Ukuran | Ya | Karton | Text |
| Status | — | Aktif | Badge |
| Aksi | — | Lihat · Ubah · Hapus | Action 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
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Status | Single Select | Aktif atau Tidak Aktif | Pilihan yang sedang terpilih bisa dibatalkan, dan status menjadi kosong |
| Simbol | Text Input | — | Maksimal 5 karakter |
| Nama Satuan Ukuran | Text 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.
| 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, simbol, dan nama satuan wajib diisi; simbol maksimal 5 karakter dan nama maksimal 20 karakter (BR-01, BR-02). |
| 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 | Simbol 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.
| 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 | Mengubah 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Kolom: simbol, nama satuan ukuran, dan status; urutan default nama A–Z dengan paginasi. |
| AC-03.2 | Kolom yang bisa diurutkan: simbol dan nama satuan ukuran. Pencarian memakai kata kunci. |
| AC-03.3 | Aksi 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.
| 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 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Log aktivitas tersedia untuk seluruh satuan (di daftar) dan per satuan (dari dialog detail) (BR-05). |
9. User Scenarios
| Role | Scenario |
|---|---|
| Staf Inventory | Menyiapkan satuan dasar tenant — pcs, karton, dus — sebelum kemasan produk pertama dibuat |
| Staf Inventory | Menambah satuan baru saat supplier mulai mengirim barang dalam kemasan yang belum pernah dipakai |
| Owner | Menonaktifkan satuan yang tidak dipakai lagi agar tidak dipilih untuk kemasan baru |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Satuan Ukuran | inventory:measurement-unit:list:any | — |
| Lihat Log Aktivitas | inventory:measurement-unit:list:any | — |
| Lihat Detail Satuan Ukuran | inventory:measurement-unit:view:any | — |
| Buat Satuan Ukuran | inventory:measurement-unit:create:any | — |
| Ubah Satuan Ukuran | inventory:measurement-unit:update:any | — |
| Hapus Satuan Ukuran | inventory:measurement-unit:delete:any | — |
10.2 Action by Status
| Action | Aktif | Tidak 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).