Toko
- Code: SET-STR
- Module: Settings
- Type: Master Data
1. Overview
Toko adalah unit operasional tenant: cabang, outlet, atau gudang. Setiap toko punya satu atau lebih alamat, dan di antaranya admin menetapkan satu alamat utama, satu alamat penagihan, dan satu alamat pengiriman. Toko menjadi konteks kerja di seluruh aplikasi: pengguna bekerja dalam toko aktif yang dipilihnya, transaksi seperti Pesanan Pembelian dibuat untuk toko itu, dan karyawan ditugaskan ke satu atau lebih toko.
Hasil yang diharapkan: struktur cabang tenant tercatat rapi, alamat yang benar dipakai otomatis di dokumen transaksi, dan toko yang sudah tidak beroperasi bisa dinonaktifkan tanpa menghapus riwayatnya.
2. Problem
Tanpa data toko yang terstruktur, transaksi dan alamat lintas cabang sulit dipisahkan dan mudah tertukar. Akibatnya:
- Bisnis dengan banyak cabang perlu memisahkan data dan transaksi per cabang.
- Alamat kantor, alamat tagihan, dan alamat terima barang sering berbeda; salah alamat membuat barang dikirim ke tempat yang salah.
- Cabang yang tutup tidak boleh lagi dipakai untuk transaksi baru, tetapi riwayatnya harus tetap bisa dilihat.
3. Goals & Non-goals
3.1 Goals
- Data dan transaksi tiap cabang terpisah rapi, sehingga aktivitas satu toko tidak tercampur dengan toko lain.
- Alamat yang benar dipakai otomatis di dokumen transaksi, tanpa perlu diisi ulang setiap kali.
- Cabang yang berhenti beroperasi bisa dikunci dari transaksi baru tanpa menghapus riwayatnya.
3.2 Non-goals
- Jam operasional, koordinat peta, dan zona waktu per toko.
- Hierarki toko seperti pengelompokan regional atau area.
- Pengaturan harga dan pajak khusus per toko; keduanya diatur di modul terkait.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Toko 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 Kode toko terdiri dari tepat 3 karakter.
- BR-02 Nama toko wajib diisi, maksimal 20 karakter.
- BR-03 Setiap toko wajib memiliki sedikitnya satu alamat sejak dibuat.
- BR-04 Peran alamat utama, penagihan, dan pengiriman masing-masing dipegang tepat satu alamat per toko. Menetapkan peran itu ke alamat lain otomatis memindahkannya dari alamat sebelumnya.
- BR-05 Alamat pertama yang dibuat otomatis memegang ketiga peran sekaligus.
- BR-06 Toko yang tidak aktif tidak bisa dipakai untuk membuat maupun mengubah transaksi. Data transaksi lamanya tetap bisa dilihat.
- BR-07 Alamat pengiriman toko menjadi alamat pengiriman awal pada Pesanan Pembelian.
- BR-08 Setiap perubahan data toko dan alamatnya tercatat beserta pelaku dan waktunya.
5. Flow
5.1 Main Flowchart
- Data Toko — Admin menentukan status toko, kode, dan namanya.
- Alamat — Toko dilengkapi sedikitnya satu alamat. Alamat pertama otomatis menjadi alamat utama, penagihan, dan pengiriman sekaligus; alamat berikutnya belum memegang peran apa pun sampai ditetapkan.
- Tinjauan — Seluruh isian ditinjau ulang sebelum disimpan.
- Validasi — Isian diperiksa sebelum toko tersimpan. Toko yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada bagian yang bersangkutan.
- Toko Tersimpan — Toko langsung bisa dipakai untuk transaksi, sesuai statusnya.
- Ubah Data Toko — Data toko dan daftar alamatnya bisa diperbarui kapan saja, termasuk memindahkan peran alamat ke alamat lain.
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
Aktifis_active: true | Toko beroperasi dan bisa dipakai untuk transaksi baru | Tidak Aktif, atau dihapus |
Tidak Aktifis_active: false | Toko tidak beroperasi, data transaksinya hanya bisa dilihat | Aktif, atau dihapus |
6. Document Structure
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Status | Enum | Ya | Belum dipilih | Aktif atau Tidak Aktif |
| Kode | Teks | Ya | — | Tepat 3 karakter (BR-01) |
| Nama Toko | Teks | Ya | — | Maksimal 20 karakter (BR-02) |
6.2 Address
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nama | Teks | Ya | — | Label alamat, maksimal 20 karakter |
| Nomor Telepon | Teks | Ya | — | Maksimal 15 karakter |
| Alamat Lengkap | Teks | Ya | — | Maksimal 255 karakter |
| Alamat Utama | Boolean | — | Melekat pada alamat pertama | Ditetapkan sistem; tepat satu per toko (BR-04, BR-05) |
| Alamat Penagihan | Boolean | — | Melekat pada alamat pertama | Ditetapkan sistem; tepat satu per toko (BR-04, BR-05) |
| Alamat Pengiriman | Boolean | — | Melekat pada alamat pertama | Ditetapkan sistem; tepat satu per toko, dipakai sebagai alamat kirim awal pada PO (BR-04, BR-07) |
7. UI Structure
Bagian ini mendefinisikan cara Toko ditampilkan dan dioperasikan: kolom pada daftar dan kontrol form beserta sumber pilihannya. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Datatable
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Kode | Ya | CBI | Text |
| Nama Toko | Ya | Toko Cianjur | Text |
| Alamat | — | Alamat Utama, Penagihan, Pengiriman | Accordion, hanya alamat berperan yang ditampilkan |
| Status | — | Aktif | Badge |
| Aksi | — | Lihat · Ubah · Hapus | Action Menu |
7.2 Form & Details
Buat — Wizard tiga langkah: Data Toko, Alamat, lalu Tinjauan. Tombol Selanjutnya memvalidasi langkah yang sedang aktif sebelum berpindah. Aksi: Selanjutnya, Simpan.
Ubah — Dua tab, Data Toko dan Alamat. Alamat dikelola langsung per baris (tambah, ubah, hapus, tetapkan peran), masing-masing tersimpan seketika.
Detail — Nama toko, kode, dan badge status di bagian atas, diikuti tab Data Toko dan Alamat yang hanya bisa dibaca. Aksi: Ubah Data, Hapus, dan Log Aktivitas.
Data Toko
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Status | Single Select | Aktif atau Tidak Aktif | — |
| Kode | Text Input | — | Tepat 3 karakter |
| Nama Toko | Text Input | — | Maksimal 20 karakter |
Alamat
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Nama | Text Input | — | — |
| Nomor Telepon | Text Input | — | — |
| Alamat Lengkap | Textarea | — | — |
| Peran Alamat | Action Menu (“Jadikan sebagai”) | Utama, Penagihan, Pengiriman | Hanya menampilkan peran yang belum dimiliki alamat itu; menetapkan peran mencabutnya dari alamat lain |
8. User Stories
US-01 - Membuat toko
Sebagai owner, saya ingin mendaftarkan toko beserta alamatnya, agar toko bisa dipakai untuk transaksi.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Wizard terdiri dari Data Toko → Alamat → Tinjauan; pengguna tidak bisa lanjut bila field wajib di langkah itu belum valid. |
| AC-01.2 | Status wajib dipilih; kode harus tepat 3 karakter; nama wajib, maksimal 20 karakter. |
| AC-01.3 | Minimal satu alamat wajib ditambahkan sebelum lanjut ke Tinjauan. |
| AC-01.4 | Alamat pertama otomatis bertanda Utama, Penagihan, dan Pengiriman. |
| AC-01.5 | Tombol hapus alamat disembunyikan bila hanya tersisa satu alamat. |
| AC-01.6 | Setelah berhasil, toast sukses tampil dan pengguna diarahkan ke daftar toko. |
| AC-01.7 | Pesan error tampil di langkah Tinjauan dan pada field terkait. |
| AC-01.8 | Kode toko duplikat — ditolak saat disimpan; error tampil pada field kode. |
US-02 - Mengelola alamat toko
Sebagai admin, saya ingin menambah, mengubah, menghapus, dan menetapkan peran alamat, agar dokumen memakai alamat yang benar.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Alamat terdiri dari nama (maks 20), telepon (maks 15), dan alamat lengkap (maks 255); semuanya wajib. |
| AC-02.2 | Menu “Jadikan sebagai” hanya menampilkan peran yang belum dimiliki alamat tersebut. |
| AC-02.3 | Menetapkan peran ke satu alamat mencabut peran yang sama dari alamat lain. |
| AC-02.4 | Di mode ubah, setiap aksi alamat langsung tersimpan, dengan spinner pada alamat yang sedang diperbarui. |
| AC-02.5 | Tombol tambah, ubah, dan hapus alamat mengikuti izin create, update, dan delete. |
| AC-02.6 | Setiap alamat menampilkan badge perannya (Utama / Penagihan / Pengiriman). |
| AC-02.7 | Menghapus alamat terakhir di mode ubah — tidak dicegah saat pengisian, berbeda dengan wizard buat; harus ditolak saat disimpan agar BR-03 terjaga. |
| AC-02.8 | Menghapus alamat yang memegang peran utama, penagihan, atau pengiriman — tidak dicegah saat pengisian. Perlu dikonfirmasi: apakah ditolak atau perannya dipindahkan (BR-04). |
| AC-02.9 | Toko punya alamat tanpa peran — alamat tetap tersimpan tetapi tidak tampil di kolom Alamat pada daftar (hanya alamat berperan yang ditampilkan). |
US-03 - Mengubah data toko
Sebagai owner, saya ingin mengubah status, kode, atau nama toko, agar data tetap akurat.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Tombol Ubah Data hanya tampil untuk pengguna dengan izin update. |
| AC-03.2 | Validasi sama dengan pembuatan (AC-01.2); tombol simpan aktif hanya jika ada perubahan. |
| AC-03.3 | Tab yang sedang dibuka dipertahankan di URL (section-tab). |
| AC-03.4 | Toko dinonaktifkan saat pengguna sedang memakainya sebagai toko aktif — halaman transaksi menjadi read-only setelah data toko dimuat ulang. |
US-04 - Daftar toko
Sebagai owner, saya ingin melihat semua toko, agar mudah memeriksa dan mengelolanya.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Kolom: kode, nama toko, alamat (daftar alamat berperan, dapat diperluas), dan status. |
| AC-04.2 | Pencarian kata kunci, paginasi, urutan default nama A–Z. |
| AC-04.3 | Aksi baris: Lihat, Ubah, Hapus sesuai izin; hapus massal dari baris terpilih. |
| AC-04.4 | Pengguna tidak ditugaskan ke toko mana pun — modul transaksi menampilkan halaman toko belum ditetapkan. |
US-05 - Menghapus toko
Sebagai owner, saya ingin menghapus toko yang salah dibuat, agar daftar bersih.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Hapus satuan dan massal memerlukan konfirmasi dan izin delete. |
| AC-05.2 | Bila penghapusan ditolak, pesan error tampil sebagai toast. |
| AC-05.3 | Menghapus toko yang sudah punya karyawan atau transaksi — Perlu dikonfirmasi: apakah diizinkan; bila ditolak, pesan error tampil sebagai toast. |
US-06 - Riwayat aktivitas
Sebagai owner, saya ingin melihat log aktivitas toko, agar perubahan bisa ditelusuri.
| ID | Kriteria penerimaan |
|---|---|
| AC-06.1 | Log tersedia untuk semua toko (di daftar) dan per toko (di detail), dengan filter event, pelaku, dan rentang tanggal. |
9. User Scenarios
| Role | Scenario |
|---|---|
| Owner | Membuka cabang baru; mendaftarkan toko dengan alamat kantor sekaligus alamat terima barang |
| Admin | Menambah alamat gudang baru dan menjadikannya alamat pengiriman |
| Owner | Menonaktifkan cabang yang tutup agar tidak dipakai untuk PO baru |
| Admin | Mencari toko berdasarkan nama untuk memeriksa alamat penagihannya |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Toko | settings:store:list:any | — |
| Lihat Log Aktivitas | settings:store:list:any | — |
| Lihat Detail Toko | settings:store:view:store | Hanya toko yang ditugaskan |
| Buat Toko | settings:store:create:any | — |
| Ubah Toko (Data Umum) | settings:store:update:any | — |
| Hapus Toko | settings:store:delete:any | — |
| Tambah Alamat | settings:store:create:any | — |
| Ubah Alamat | settings:store:update:any | — |
| Hapus Alamat | settings:store:delete:any | — |
| Tetapkan Peran Alamat | settings:store:update:any | — |
10.2 Action by Status
| Action | Aktif | Tidak Aktif |
|---|---|---|
| Lihat Detail Toko | ✓ | ✓ |
| Ubah Toko (Data Umum) | ✓ | ✓ |
| Hapus Toko | ✓ | ✓ |
| Ubah Alamat | ✓ | ✓ |
| Dipilih sebagai Toko Aktif | ✓ | ✓ |
| Buat Transaksi (PO, GR, Bill) | ✓ | — |
| Ubah Transaksi (PO, GR, Bill) | ✓ | — |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Employees — karyawan ditugaskan ke toko.
- Purchase Order, Goods Receipt, Bill — transaksi dibuat per toko dan memakai alamat toko.
- Activity Logs — sumber log aktivitas.
Efek ke modul lain
- Pemilih toko di layout menentukan toko aktif (disimpan di cookie) untuk seluruh modul transaksi.
- Status tidak aktif mengunci aksi ubah di semua modul transaksi (BR-06).