Data Staf

Kelola data karyawan per cabang — jabatan, atasan langsung, kontak, dan kaitkan ke akun login Maparel bila diperlukan.

Data Staf

Menu Daftar Staff (/staff/list) menampilkan tabel karyawan dengan filter pencarian dan jabatan. Klik baris atau tombol edit untuk membuka sidebar form di kanan.

Hak akses: staff.list.view · kelola: staff.list.manage

Baca juga: Overview Staf & Karyawan · Jabatan · Manajemen Pengguna

---

Staf vs User — dua entitas, satu orang

Maparel membedakan:

Entitas	Fungsi	Di mana diatur
Staf	Data HR — nama, jabatan, cabang, atasan, kontak	Staf/Karyawan → Data Staf
User	Akun login — email, password, role, cabang akses	Manajemen Pengguna

Satu orang dapat punya keduanya: record staf di HR dan akun user untuk login. Field Akun login (user) di form staf menghubungkan keduanya. Staf tanpa user tetap valid (mis. karyawan lapangan tanpa akses sistem).

Produksi: Staf dengan user terhubung diperlukan agar identitas muncul di API /api/me dan fitur antrian produksi (tombol Ambil work order).

Kasir (POS): akun kasir wajib terhubung ke record staf aktif agar bisa buka atau gabung shift. Tanpa staf, transaksi POS ditolak.

---

Prasyarat

1. Cabang sudah terdaftar — pilih cabang aktif di header
2. Jabatan sudah disusun di pohon organisasi
3. User sudah dibuat jika akan menghubungkan akun login
4. Hak akses staff.list.view atau staff.list.manage

---

1. Daftar staf

Buka Staf/Karyawan → Daftar Staff.

Screenshot diperlukan

Daftar Staff

Menu: Staf/Karyawan → Daftar Staff (/staff/list)

Simpan sebagai: /images/staf/staf-list.png

Yang di-capture: Halaman penuh: filter cari + dropdown Semua Jabatan + tombol Cari, tombol Tambah, tabel dengan kolom Kode, Nama, Cabang, Jabatan, Atasan, Akun login, Telepon, Email, Bergabung, Aktif.

Kolom	Keterangan
Kode	Kode internal staf
Nama	Nama lengkap karyawan
Cabang	Cabang penempatan
Jabatan	Posisi dari master jabatan
Atasan	Staf atasan langsung (reports to)
Akun login	User Maparel terhubung — nama + email
Telepon / Email	Kontak
Bergabung	Tanggal bergabung
Aktif	Status keaktifan
Aksi	Edit / Hapus (jika `staff.list.manage`)

Filter:

• Cari — nama, kode, atau telepon (Enter atau tombol Cari)
• Semua Jabatan — dropdown filter per jabatan
• Cabang — kolom cabang per baris; saat menambah staf baru, default cabang mengikuti cabang aktif di header aplikasi

Klik baris untuk membuka editor sidebar.

---

2. Tambah staf

Klik + Tambah → sidebar Tambah Staff terbuka.

Screenshot diperlukan

Form Tambah Staff

Menu: Staf/Karyawan → Daftar Staff — sidebar kanan

Simpan sebagai: /images/staf/staf-form-tambah.png

Yang di-capture: Sidebar form tambah: Cabang, Jabatan, Atasan langsung, Akun login, Kode, Nama, Telepon, Email, Alamat, Tanggal bergabung, Catatan, Aktif, tombol Batal/Simpan.

Field form:

Field	Wajib	Keterangan
Cabang	Ya	Penempatan karyawan
Jabatan	Disarankan	Posisi di organisasi — memicu saran atasan dari jabatan induk
Atasan langsung	Tidak	Staf lain di cabang yang sama; otomatis disarankan saat jabatan dipilih
Akun login (user)	Tidak	Hubung ke pengguna aplikasi — lihat bagian di bawah
Kode	Tidak	Kode staf internal
Nama	Ya	Nama lengkap
Telepon	Tidak	Nomor kontak
Email	Tidak	Email karyawan (bisa berbeda dari email user login)
Alamat	Tidak	Alamat domisili/kantor
Tanggal bergabung	Tidak	Tanggal mulai bekerja
Catatan	Tidak	Catatan HR
Aktif	Tidak	Default aktif — nonaktifkan untuk resign

---

3. Edit staf

Klik baris atau ikon Edit pada staf yang ada.

Screenshot diperlukan

Form Edit Staff

Menu: Staf/Karyawan → Daftar Staff — sidebar edit

Simpan sebagai: /images/staf/staf-form-edit.png

Yang di-capture: Sidebar edit dengan judul Edit · [nama staf], field terisi (jabatan, atasan, cabang), tombol Simpan.

Perubahan jabatan dapat memicu saran atasan baru dari hierarki jabatan. Daftar atasan hanya menampilkan staf di cabang yang sama (kecuali staf yang sedang diedit).

---

4. Hubungkan ke akun login

Field Akun login (user) memilih dari daftar pengguna yang sudah ada di Manajemen Pengguna.

Screenshot diperlukan

Field Akun Login (User)

Menu: Form staf — field Akun login

Simpan sebagai: /images/staf/staf-link-user.png

Yang di-capture: Close-up dropdown Akun login (user) dengan daftar nama + email, placeholder Pilih pengguna aplikasi, teks bantuan di bawah field.

Situasi	Tindakan
Karyawan perlu login Maparel	Buat user dulu di Manajemen Pengguna, lalu pilih di field Akun login
User sudah ada, belum ada record staf	Tambah staf baru dan hubungkan ke user tersebut
Satu user untuk satu staf	Sistem menolak jika user sudah terhubung ke staf lain
Karyawan tanpa akses sistem	Biarkan Akun login kosong

Pastikan role pada user sesuai kebijakan — role template di Jabatan hanya acuan, bukan pengganti assign role.

---

5. Nonaktifkan staf resign

Untuk karyawan yang resign, jangan hapus jika masih ada referensi histori:

1. Buka edit staf
2. Hapus centang Aktif
3. Simpan

Opsional: nonaktifkan atau cabut akses User terkait di Manajemen Pengguna agar tidak bisa login.

Hapus permanen hanya jika staf benar-benar entri salah dan belum dipakai transaksi — konfirmasi dialog akan muncul.

---

Ringkasan operasi

Aksi	Cara	Hak akses
Lihat daftar	Buka /staff/list	staff.list.view
Tambah / edit / hapus	Sidebar form	staff.list.manage
Filter	Cari + dropdown jabatan	staff.list.view
Link user	Field Akun login di form	staff.list.manage

Terkait: atur hak akses login di Manajemen Pengguna dan Role.