Skip to Content

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

  1. Data Toko — Admin menentukan status toko, kode, dan namanya.
  2. 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.
  3. Tinjauan — Seluruh isian ditinjau ulang sebelum disimpan.
  4. Validasi — Isian diperiksa sebelum toko tersimpan. Toko yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada bagian yang bersangkutan.
  5. Toko Tersimpan — Toko langsung bisa dipakai untuk transaksi, sesuai statusnya.
  6. Ubah Data Toko — Data toko dan daftar alamatnya bisa diperbarui kapan saja, termasuk memindahkan peran alamat ke alamat lain.

5.2 Status Lifecycle

StatusKeteranganSelanjutnya
Aktif
is_active: true
Toko beroperasi dan bisa dipakai untuk transaksi baruTidak Aktif, atau dihapus
Tidak Aktif
is_active: false
Toko tidak beroperasi, data transaksinya hanya bisa dilihatAktif, atau dihapus

6. Document Structure

6.1 General

FieldTipeWajibDefaultAturan
StatusEnumYaBelum dipilihAktif atau Tidak Aktif
KodeTeksYa—Tepat 3 karakter (BR-01)
Nama TokoTeksYa—Maksimal 20 karakter (BR-02)

6.2 Address

FieldTipeWajibDefaultAturan
NamaTeksYa—Label alamat, maksimal 20 karakter
Nomor TeleponTeksYa—Maksimal 15 karakter
Alamat LengkapTeksYa—Maksimal 255 karakter
Alamat UtamaBoolean—Melekat pada alamat pertamaDitetapkan sistem; tepat satu per toko (BR-04, BR-05)
Alamat PenagihanBoolean—Melekat pada alamat pertamaDitetapkan sistem; tepat satu per toko (BR-04, BR-05)
Alamat PengirimanBoolean—Melekat pada alamat pertamaDitetapkan 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

KolomSortableContoh NilaiKomponen
KodeYaCBIText
Nama TokoYaToko CianjurText
Alamat—Alamat Utama, Penagihan, PengirimanAccordion, hanya alamat berperan yang ditampilkan
Status—AktifBadge
Aksi—Lihat · Ubah · HapusAction 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

FieldKontrolSumber PilihanPerilaku
StatusSingle SelectAktif atau Tidak Aktif—
KodeText Input—Tepat 3 karakter
Nama TokoText Input—Maksimal 20 karakter

Alamat

FieldKontrolSumber PilihanPerilaku
NamaText Input——
Nomor TeleponText Input——
Alamat LengkapTextarea——
Peran AlamatAction Menu (“Jadikan sebagai”)Utama, Penagihan, PengirimanHanya 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.

IDKriteria penerimaan
AC-01.1Wizard terdiri dari Data Toko → Alamat → Tinjauan; pengguna tidak bisa lanjut bila field wajib di langkah itu belum valid.
AC-01.2Status wajib dipilih; kode harus tepat 3 karakter; nama wajib, maksimal 20 karakter.
AC-01.3Minimal satu alamat wajib ditambahkan sebelum lanjut ke Tinjauan.
AC-01.4Alamat pertama otomatis bertanda Utama, Penagihan, dan Pengiriman.
AC-01.5Tombol hapus alamat disembunyikan bila hanya tersisa satu alamat.
AC-01.6Setelah berhasil, toast sukses tampil dan pengguna diarahkan ke daftar toko.
AC-01.7Pesan error tampil di langkah Tinjauan dan pada field terkait.
AC-01.8Kode 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.

IDKriteria penerimaan
AC-02.1Alamat terdiri dari nama (maks 20), telepon (maks 15), dan alamat lengkap (maks 255); semuanya wajib.
AC-02.2Menu “Jadikan sebagai” hanya menampilkan peran yang belum dimiliki alamat tersebut.
AC-02.3Menetapkan peran ke satu alamat mencabut peran yang sama dari alamat lain.
AC-02.4Di mode ubah, setiap aksi alamat langsung tersimpan, dengan spinner pada alamat yang sedang diperbarui.
AC-02.5Tombol tambah, ubah, dan hapus alamat mengikuti izin create, update, dan delete.
AC-02.6Setiap alamat menampilkan badge perannya (Utama / Penagihan / Pengiriman).
AC-02.7Menghapus alamat terakhir di mode ubah — tidak dicegah saat pengisian, berbeda dengan wizard buat; harus ditolak saat disimpan agar BR-03 terjaga.
AC-02.8Menghapus alamat yang memegang peran utama, penagihan, atau pengiriman — tidak dicegah saat pengisian. Perlu dikonfirmasi: apakah ditolak atau perannya dipindahkan (BR-04).
AC-02.9Toko 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.

IDKriteria penerimaan
AC-03.1Tombol Ubah Data hanya tampil untuk pengguna dengan izin update.
AC-03.2Validasi sama dengan pembuatan (AC-01.2); tombol simpan aktif hanya jika ada perubahan.
AC-03.3Tab yang sedang dibuka dipertahankan di URL (section-tab).
AC-03.4Toko 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.

IDKriteria penerimaan
AC-04.1Kolom: kode, nama toko, alamat (daftar alamat berperan, dapat diperluas), dan status.
AC-04.2Pencarian kata kunci, paginasi, urutan default nama A–Z.
AC-04.3Aksi baris: Lihat, Ubah, Hapus sesuai izin; hapus massal dari baris terpilih.
AC-04.4Pengguna 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.

IDKriteria penerimaan
AC-05.1Hapus satuan dan massal memerlukan konfirmasi dan izin delete.
AC-05.2Bila penghapusan ditolak, pesan error tampil sebagai toast.
AC-05.3Menghapus 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.

IDKriteria penerimaan
AC-06.1Log tersedia untuk semua toko (di daftar) dan per toko (di detail), dengan filter event, pelaku, dan rentang tanggal.

9. User Scenarios

RoleScenario
OwnerMembuka cabang baru; mendaftarkan toko dengan alamat kantor sekaligus alamat terima barang
AdminMenambah alamat gudang baru dan menjadikannya alamat pengiriman
OwnerMenonaktifkan cabang yang tutup agar tidak dipakai untuk PO baru
AdminMencari toko berdasarkan nama untuk memeriksa alamat penagihannya

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat List Tokosettings:store:list:any—
Lihat Log Aktivitassettings:store:list:any—
Lihat Detail Tokosettings:store:view:storeHanya toko yang ditugaskan
Buat Tokosettings:store:create:any—
Ubah Toko
(Data Umum)
settings:store:update:any—
Hapus Tokosettings:store:delete:any—
Tambah Alamatsettings:store:create:any—
Ubah Alamatsettings:store:update:any—
Hapus Alamatsettings:store:delete:any—
Tetapkan Peran Alamatsettings:store:update:any—

10.2 Action by Status

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