Skip to Content

Karyawan

  • Code: SET-EMP
  • Module: Settings
  • Type: Master Data

1. Overview

Karyawan adalah data orang yang bekerja di tenant dan ditugaskan ke satu atau lebih toko. Karyawan terhubung ke sebuah entitas; bila entitas yang sama juga punya akun pengguna, karyawan itu bisa login dan bertindak sebagai dirinya, misalnya sebagai PIC Pesanan Pembelian. Karyawan bisa dibuat dari awal, dengan entitas baru dibuat otomatis, atau dari entitas yang sudah ada, misalnya dari pengguna yang belum tercatat sebagai karyawan.

Hasil yang diharapkan: tenant tahu siapa bekerja di toko mana, dan data karyawan bisa dipakai sebagai penanggung jawab di transaksi.

2. Problem

Tanpa data karyawan yang terstruktur, penentuan penanggung jawab transaksi dan pengelolaan penugasan toko dilakukan secara ad hoc. Akibatnya:

  • Transaksi seperti PO butuh penanggung jawab yang jelas dan terbatas pada karyawan toko terkait.
  • Karyawan sering berpindah atau merangkap di beberapa cabang.
  • Karyawan yang sudah keluar tidak boleh dipilih lagi, tetapi riwayatnya harus tetap ada.

3. Goals & Non-goals

3.1 Goals

  • Transaksi toko hanya bisa dibebankan ke karyawan yang memang ditugaskan di toko tersebut.
  • Karyawan yang merangkap di beberapa cabang cukup dicatat satu kali, bukan didaftarkan ulang per toko.
  • Satu orang tetap satu identitas, meski juga punya akun pengguna atau tercatat sebagai pemasok.
  • Karyawan yang sudah keluar bisa dihentikan dari penugasan baru tanpa menghapus jejaknya di transaksi lama.

3.2 Non-goals

  • Jabatan, gaji, jadwal kerja, dan absensi.
  • Pengaturan hak akses karyawan; hak akses diatur lewat Pengguna dan Peran.
  • Riwayat mutasi antar toko di luar catatan log aktivitas.

4. Business Rules

Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Karyawan 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 karyawan dibuat otomatis dan tidak bisa diubah.
  • BR-02 Status, nama lengkap, jenis kelamin, email, dan nomor telepon wajib diisi.
  • BR-03 Setiap karyawan wajib ditugaskan ke sedikitnya satu toko.
  • BR-04 Satu entitas hanya boleh punya satu data karyawan. Pembuatan dari entitas hanya bisa memakai entitas yang belum tercatat sebagai karyawan.
  • BR-05 Karyawan hanya bisa dipilih sebagai penanggung jawab transaksi pada toko tempat ia ditugaskan.
  • BR-06 Setiap perubahan data karyawan tercatat beserta pelaku dan waktunya.

5. Flow

5.1 Main Flowchart

  1. Pilih Sumber — Karyawan bisa dibuat dari awal, atau dari entitas yang sudah ada agar satu orang tidak tercatat dua kali.
    • 0a. Pilih Entitas — Entitas yang belum tercatat sebagai karyawan dipilih lebih dulu, lalu nama dan emailnya terisi otomatis.
  2. Profil — Status, nama lengkap, jenis kelamin, email, dan nomor telepon diisi.
  3. Toko Penugasan — Karyawan ditugaskan ke satu atau lebih toko, yang menentukan di mana ia bisa dipilih sebagai penanggung jawab transaksi.
  4. Tinjauan — Seluruh isian ditinjau ulang sebelum disimpan.
  5. Validasi — Isian diperiksa sebelum karyawan tersimpan. Data yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada bagian yang bersangkutan.
  6. Karyawan Tersimpan — Kode karyawan terbentuk otomatis, dan karyawan langsung bisa dipilih di transaksi toko yang ditugaskan.
  7. Ubah Data Karyawan — Profil dan toko penugasan bisa diperbarui kapan saja, kecuali kode karyawan yang tetap.

5.2 Status Lifecycle

StatusKeteranganSelanjutnya
Aktif
is_active: true
Karyawan masih bekerja dan bisa dipilih di transaksiTidak Aktif, atau dihapus
Tidak Aktif
is_active: false
Karyawan tidak lagi bekerja dan tidak bisa dipilih untuk transaksi baruAktif, atau dihapus

6. Document Structure

6.1 General

FieldTipeWajibDefaultAturan
KodeTeks—Dibuat saat disimpanDitetapkan sistem, tidak bisa diubah (BR-01)
StatusEnumYaBelum dipilihAktif atau Tidak Aktif
Nama LengkapTeksYaMengikuti entitas, bila dibuat dari entitasTersimpan pada entitas, bukan pada data karyawan
Jenis KelaminEnumYa—Laki-laki atau Perempuan
EmailTeksYaMengikuti entitas, bila dibuat dari entitasFormat email valid
Nomor TeleponTeksYa——
TokoRef. Toko, banyakYa, minimal 1—Dipilih dari master Toko (BR-03)

7. UI Structure

Bagian ini mendefinisikan cara Karyawan ditampilkan dan dioperasikan: kolom pada daftar, filter, 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
KodeYaEMP-0042Text
Nama LengkapYaBudi SantosoText
Jenis Kelamin—Laki-lakiBadge
Toko—Toko Cianjur, Toko BandungAccordion bila lebih dari satu
Sebagai Pengguna—budi@toko.comLink ke detail Pengguna, atau kosong
Sebagai Pemasok—SUP-0012Link ke detail Supplier, atau kosong
Status—AktifBadge
Aksi—Lihat · Ubah · HapusAction Menu

7.2 Advance Filter

FieldKontrolSumber PilihanDefault
StatusSingle SelectAktif atau Tidak AktifKosong
Jenis KelaminSingle SelectLaki-laki atau PerempuanKosong

7.3 Form & Details

Buat — Dialog Pilih Sumber (Dari Awal atau Dari Entitas) tampil lebih dulu. Memilih Dari Entitas menambah langkah Pilih Entitas, yang mengisi Nama Lengkap dan Email otomatis. Wizard tiga langkah: Profil, Toko, lalu Tinjauan. Aksi: Selanjutnya, Simpan.

Ubah — Dua tab, Profil dan Toko, masing-masing disimpan terpisah.

Detail — Nama lengkap, kode, dan badge status di bagian atas, diikuti tab Profil dan Toko yang hanya bisa dibaca. Aksi: Ubah Data, Hapus, dan Log Aktivitas.

Profil

FieldKontrolSumber PilihanPerilaku
StatusSingle SelectAktif atau Tidak Aktif—
Nama LengkapText Input—Terisi dari entitas bila dibuat dari entitas
Jenis KelaminSingle SelectLaki-laki atau Perempuan—
EmailText Input—Terisi dari entitas bila dibuat dari entitas
Nomor TeleponText Input——

Toko

FieldKontrolSumber PilihanPerilaku
TokoMulti Select (kartu)Master TokoDiklik untuk memilih; minimal satu toko terpilih

8. User Stories

US-01 - Membuat karyawan dari awal

Sebagai owner, saya ingin mendaftarkan karyawan baru, agar bisa ditugaskan ke toko.

IDKriteria penerimaan
AC-01.1Membuka Tambah Karyawan menampilkan dialog pilihan sumber; memilih “Buat dari Awal” membuka wizard Profil → Toko → Tinjauan.
AC-01.2Status, nama lengkap, jenis kelamin, email (format valid), dan telepon wajib diisi.
AC-01.3Minimal satu toko wajib dipilih.
AC-01.4Setelah berhasil, toast sukses tampil dan pengguna diarahkan ke daftar karyawan.
AC-01.5Pesan error tampil di langkah Tinjauan dan pada field terkait.

US-02 - Membuat karyawan dari entitas

Sebagai admin, saya ingin membuat karyawan dari entitas yang sudah ada, agar tidak terjadi duplikasi identitas.

IDKriteria penerimaan
AC-02.1Tabel entitas hanya menampilkan entitas yang belum punya data karyawan.
AC-02.2Setelah entitas dipilih dan klik Selanjutnya, nama lengkap dan email terisi dari entitas.
AC-02.3Data dikirim dengan party_id entitas terpilih; tidak ada entitas baru yang dibuat.
AC-02.4Karyawan dibuat dari entitas lalu nama atau email diubah di wizard — Perlu dikonfirmasi: apakah data entitas ikut diperbarui.
AC-02.5Email karyawan sama dengan email entitas lain — Perlu dikonfirmasi: apakah ditolak sebagai duplikat; error tampil pada field email.
AC-02.6Tidak ada entitas tanpa karyawan saat memilih “Dari Entitas” — tabel kosong; pengguna bisa kembali memilih “Dari Awal”.

US-03 - Mengubah profil karyawan

Sebagai admin, saya ingin memperbarui profil dan status karyawan, agar data tetap akurat.

IDKriteria penerimaan
AC-03.1Tombol Ubah Data hanya tampil untuk pengguna dengan izin update.
AC-03.2Kode karyawan tampil tetapi tidak bisa diubah.
AC-03.3Validasi sama dengan pembuatan (AC-01.2); tombol simpan aktif hanya jika ada perubahan.
AC-03.4Karyawan dinonaktifkan — tetap tampil di pilihan dengan penanda status; Perlu dikonfirmasi: perilakunya terhadap transaksi yang sedang berjalan.

US-04 - Mengubah penugasan toko

Sebagai kepala toko, saya ingin mengubah toko penugasan karyawan, agar sesuai tempat kerjanya.

IDKriteria penerimaan
AC-04.1Tab Toko di mode lihat hanya menampilkan toko penugasan; di mode ubah menampilkan semua toko dengan checkbox.
AC-04.2Minimal satu toko harus tetap terpilih.
AC-04.3Daftar toko penugasan diganti seluruhnya dengan pilihan baru saat disimpan.
AC-04.4Karyawan dicabut dari toko tempat ia menjadi PIC PO — PO yang sudah ada tetap menyimpan PIC tersebut; ia tidak lagi muncul di pilihan PIC toko itu.
AC-04.5Toko ditampilkan tanpa alamat pada pilihan toko — alamat toko belum tersedia pada data pilihan; placeholder ”-” ditampilkan.

US-05 - Daftar dan filter karyawan

Sebagai owner, saya ingin melihat dan menyaring karyawan, agar mudah menemukan karyawan tertentu.

IDKriteria penerimaan
AC-05.1Kolom: kode, nama lengkap, jenis kelamin, toko, sebagai pengguna (email, tautan ke detail pengguna), sebagai pemasok (kode, tautan ke detail pemasok), dan status.
AC-05.2Pencarian kata kunci; filter lanjutan jenis kelamin dan status; paginasi; urutan default nama A–Z.
AC-05.3Aksi baris: Lihat, Ubah, Hapus sesuai izin; hapus massal dari baris terpilih.

US-06 - Menghapus karyawan

Sebagai owner, saya ingin menghapus karyawan yang salah dibuat.

IDKriteria penerimaan
AC-06.1Hapus satuan dan massal memerlukan konfirmasi dan izin delete.
AC-06.2Bila penghapusan ditolak, pesan error tampil sebagai toast.
AC-06.3Menghapus karyawan yang menjadi PIC transaksi — Perlu dikonfirmasi: apakah diizinkan; bila ditolak, pesan error tampil sebagai toast.

US-07 - Riwayat aktivitas

Sebagai auditor, saya ingin melihat log aktivitas karyawan.

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

9. User Scenarios

RoleScenario
OwnerMendaftarkan kasir baru dan menugaskannya ke dua cabang
AdminMenjadikan pengguna yang sudah ada sebagai karyawan tanpa mengetik ulang nama dan email
Kepala TokoMemindahkan karyawan dari cabang A ke cabang B
OwnerMenonaktifkan karyawan yang sudah keluar

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat List Karyawansettings:employee:list:any—
Lihat Log Aktivitassettings:employee:list:any—
Lihat Detail Karyawansettings:employee:view:any—
Buat Karyawansettings:employee:create:any—
Ubah Karyawan
(Profil)
settings:employee:update:any—
Ubah Karyawan
(Penugasan Toko)
settings:employee:update:any—
Hapus Karyawansettings:employee:delete:any—

11. Notifications

Fitur ini tidak memicu notifikasi.

12. Dependencies

PRD terkait

  • Entities — identitas karyawan dan sinkronisasi dengan pengguna/pemasok.
  • Stores — toko penugasan.
  • Users — karyawan yang juga pengguna bisa login dan bertindak sebagai PIC.
  • Purchase Order — penanggung jawab dipilih dari karyawan toko.
  • Activity Logs — sumber log aktivitas.

Efek ke modul lain

  • Pilihan penanggung jawab di transaksi diambil dari karyawan toko (/api/stores/:id/employees/cursor).
Terakhir diperbarui