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
- 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.
- Profil — Status, nama lengkap, jenis kelamin, email, dan nomor telepon diisi.
- Toko Penugasan — Karyawan ditugaskan ke satu atau lebih toko, yang menentukan di mana ia bisa dipilih sebagai penanggung jawab transaksi.
- Tinjauan — Seluruh isian ditinjau ulang sebelum disimpan.
- Validasi — Isian diperiksa sebelum karyawan tersimpan. Data yang melanggar aturan tidak bisa disimpan, dan kesalahannya ditunjukkan pada bagian yang bersangkutan.
- Karyawan Tersimpan — Kode karyawan terbentuk otomatis, dan karyawan langsung bisa dipilih di transaksi toko yang ditugaskan.
- Ubah Data Karyawan — Profil dan toko penugasan bisa diperbarui kapan saja, kecuali kode karyawan yang tetap.
5.2 Status Lifecycle
| Status | Keterangan | Selanjutnya |
|---|---|---|
Aktifis_active: true | Karyawan masih bekerja dan bisa dipilih di transaksi | Tidak Aktif, atau dihapus |
Tidak Aktifis_active: false | Karyawan tidak lagi bekerja dan tidak bisa dipilih untuk transaksi baru | Aktif, atau dihapus |
6. Document Structure
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Kode | Teks | — | Dibuat saat disimpan | Ditetapkan sistem, tidak bisa diubah (BR-01) |
| Status | Enum | Ya | Belum dipilih | Aktif atau Tidak Aktif |
| Nama Lengkap | Teks | Ya | Mengikuti entitas, bila dibuat dari entitas | Tersimpan pada entitas, bukan pada data karyawan |
| Jenis Kelamin | Enum | Ya | — | Laki-laki atau Perempuan |
| Teks | Ya | Mengikuti entitas, bila dibuat dari entitas | Format email valid | |
| Nomor Telepon | Teks | Ya | — | — |
| Toko | Ref. Toko, banyak | Ya, 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
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Kode | Ya | EMP-0042 | Text |
| Nama Lengkap | Ya | Budi Santoso | Text |
| Jenis Kelamin | — | Laki-laki | Badge |
| Toko | — | Toko Cianjur, Toko Bandung | Accordion bila lebih dari satu |
| Sebagai Pengguna | — | budi@toko.com | Link ke detail Pengguna, atau kosong |
| Sebagai Pemasok | — | SUP-0012 | Link ke detail Supplier, atau kosong |
| Status | — | Aktif | Badge |
| Aksi | — | Lihat · Ubah · Hapus | Action Menu |
7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Status | Single Select | Aktif atau Tidak Aktif | Kosong |
| Jenis Kelamin | Single Select | Laki-laki atau Perempuan | Kosong |
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
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Status | Single Select | Aktif atau Tidak Aktif | — |
| Nama Lengkap | Text Input | — | Terisi dari entitas bila dibuat dari entitas |
| Jenis Kelamin | Single Select | Laki-laki atau Perempuan | — |
| Text Input | — | Terisi dari entitas bila dibuat dari entitas | |
| Nomor Telepon | Text Input | — | — |
Toko
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Toko | Multi Select (kartu) | Master Toko | Diklik 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Membuka Tambah Karyawan menampilkan dialog pilihan sumber; memilih “Buat dari Awal” membuka wizard Profil → Toko → Tinjauan. |
| AC-01.2 | Status, nama lengkap, jenis kelamin, email (format valid), dan telepon wajib diisi. |
| AC-01.3 | Minimal satu toko wajib dipilih. |
| AC-01.4 | Setelah berhasil, toast sukses tampil dan pengguna diarahkan ke daftar karyawan. |
| AC-01.5 | Pesan 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Tabel entitas hanya menampilkan entitas yang belum punya data karyawan. |
| AC-02.2 | Setelah entitas dipilih dan klik Selanjutnya, nama lengkap dan email terisi dari entitas. |
| AC-02.3 | Data dikirim dengan party_id entitas terpilih; tidak ada entitas baru yang dibuat. |
| AC-02.4 | Karyawan dibuat dari entitas lalu nama atau email diubah di wizard — Perlu dikonfirmasi: apakah data entitas ikut diperbarui. |
| AC-02.5 | Email karyawan sama dengan email entitas lain — Perlu dikonfirmasi: apakah ditolak sebagai duplikat; error tampil pada field email. |
| AC-02.6 | Tidak 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Tombol Ubah Data hanya tampil untuk pengguna dengan izin update. |
| AC-03.2 | Kode karyawan tampil tetapi tidak bisa diubah. |
| AC-03.3 | Validasi sama dengan pembuatan (AC-01.2); tombol simpan aktif hanya jika ada perubahan. |
| AC-03.4 | Karyawan 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Tab Toko di mode lihat hanya menampilkan toko penugasan; di mode ubah menampilkan semua toko dengan checkbox. |
| AC-04.2 | Minimal satu toko harus tetap terpilih. |
| AC-04.3 | Daftar toko penugasan diganti seluruhnya dengan pilihan baru saat disimpan. |
| AC-04.4 | Karyawan 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.5 | Toko 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-05.1 | Kolom: kode, nama lengkap, jenis kelamin, toko, sebagai pengguna (email, tautan ke detail pengguna), sebagai pemasok (kode, tautan ke detail pemasok), dan status. |
| AC-05.2 | Pencarian kata kunci; filter lanjutan jenis kelamin dan status; paginasi; urutan default nama A–Z. |
| AC-05.3 | Aksi baris: Lihat, Ubah, Hapus sesuai izin; hapus massal dari baris terpilih. |
US-06 - Menghapus karyawan
Sebagai owner, saya ingin menghapus karyawan yang salah dibuat.
| ID | Kriteria penerimaan |
|---|---|
| AC-06.1 | Hapus satuan dan massal memerlukan konfirmasi dan izin delete. |
| AC-06.2 | Bila penghapusan ditolak, pesan error tampil sebagai toast. |
| AC-06.3 | Menghapus 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.
| ID | Kriteria penerimaan |
|---|---|
| AC-07.1 | Log tersedia untuk semua karyawan (di daftar) dan per karyawan (di detail), dengan filter event, pelaku, dan rentang tanggal. |
9. User Scenarios
| Role | Scenario |
|---|---|
| Owner | Mendaftarkan kasir baru dan menugaskannya ke dua cabang |
| Admin | Menjadikan pengguna yang sudah ada sebagai karyawan tanpa mengetik ulang nama dan email |
| Kepala Toko | Memindahkan karyawan dari cabang A ke cabang B |
| Owner | Menonaktifkan karyawan yang sudah keluar |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Karyawan | settings:employee:list:any | — |
| Lihat Log Aktivitas | settings:employee:list:any | — |
| Lihat Detail Karyawan | settings:employee:view:any | — |
| Buat Karyawan | settings:employee:create:any | — |
| Ubah Karyawan (Profil) | settings:employee:update:any | — |
| Ubah Karyawan (Penugasan Toko) | settings:employee:update:any | — |
| Hapus Karyawan | settings: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).