Entitas
- Code: SET-ENT
- Module: Settings
- Type: Master Data
1. Overview
Entitas (party) adalah identitas tunggal untuk orang atau organisasi di dalam tenant. Satu entitas bisa berperan sebagai pengguna, karyawan, dan/atau pemasok sekaligus, misalnya seorang staf yang juga login ke sistem cukup punya satu entitas yang terhubung ke data pengguna dan data karyawannya. Entitas tidak dibuat atau diubah langsung dari halaman ini; entitas terbentuk saat membuat pengguna, karyawan, atau pemasok, dan halaman ini dipakai untuk melihat semua entitas beserta perannya, serta menyinkronkan entitas dengan data yang sudah ada.
Hasil yang diharapkan: satu orang atau organisasi tidak tercatat sebagai beberapa identitas terpisah, sehingga data seperti nama dan kontak konsisten di semua peran.
2. Problem
Tanpa identitas tunggal yang menghubungkan peran seseorang, satu orang bisa tercatat berulang kali dengan data yang tidak konsisten. Akibatnya:
- Orang yang sama bisa terdaftar dua kali, misalnya sebagai pengguna dan sebagai karyawan, dengan nama atau email yang berbeda.
- Tanpa identitas tunggal, sulit mengetahui bahwa karyawan X adalah pengguna yang login dengan email Y.
- Data lama yang terlanjur terpisah perlu cara untuk disatukan.
3. Goals & Non-goals
3.1 Goals
- Satu orang atau organisasi cukup punya satu identitas, meski menjalankan beberapa peran sekaligus.
- Hubungan antara akun pengguna, data karyawan, dan data pemasok terlihat dalam satu tempat.
- Data lama yang terlanjur tercatat terpisah bisa dihubungkan tanpa dibuat ulang.
3.2 Non-goals
- Membuat, mengubah, atau menghapus entitas langsung dari halaman ini; entitas terbentuk dari fitur lain.
- Memutus kembali hubungan entitas dengan perannya.
- Penggabungan dua entitas secara otomatis berdasarkan kemiripan data.
4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk Entitas 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 Satu entitas hanya boleh terhubung ke satu akun pengguna, satu data karyawan, dan satu data pemasok.
- BR-02 Entitas terbentuk otomatis saat pengguna, karyawan, atau pemasok dibuat dari awal. Pembuatan dari entitas memakai entitas yang sudah ada, tanpa membentuk identitas baru.
- BR-03 Sinkronisasi hanya tersedia untuk peran yang belum terhubung pada entitas tersebut.
- BR-04 Setiap sinkronisasi dan perubahan entitas tercatat beserta pelaku dan waktunya.
5. Flow
5.1 Main Flowchart
- Daftar Entitas — Seluruh entitas tampil beserta peran yang sudah dimilikinya sebagai pengguna, karyawan, atau pemasok. Peran yang belum terhubung ditandai agar bisa langsung ditindaklanjuti.
- Sinkronisasi Entitas — Admin memilih peran yang ingin dihubungkan ke entitas tersebut.
- Pilih Data Tujuan — Data pengguna, karyawan, atau pemasok yang sudah ada dicari lalu dipilih sebagai pasangan entitas itu.
- Validasi — Penghubungan diperiksa sebelum tersimpan, termasuk memastikan peran tersebut belum terpakai oleh entitas lain.
- Entitas Terhubung — Entitas dan data perannya kini menjadi satu identitas, dan datanya konsisten di semua peran.
6. Document Structure
6.1 General
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Nama Lengkap | Teks | — | Mengikuti data entitas | Ditetapkan saat pengguna, karyawan, atau pemasok dibuat (BR-02) |
| Kategori | Enum | — | Mengikuti data entitas | Individu, Organisasi, atau Perusahaan |
| Jenis Kelamin | Enum | — | Mengikuti data entitas | Laki-laki, Perempuan, atau kosong |
| Teks | — | Mengikuti data entitas | Bisa kosong | |
| Nomor Telepon | Teks | — | Mengikuti data entitas | Bisa kosong, ditampilkan dengan awalan ”+” |
| Sebagai Pengguna | Ref. Pengguna | — | — | Paling banyak satu (BR-01) |
| Sebagai Karyawan | Ref. Karyawan | — | — | Paling banyak satu (BR-01) |
| Sebagai Pemasok | Ref. Supplier | — | — | Paling banyak satu (BR-01) |
7. UI Structure
Bagian ini mendefinisikan cara Entitas ditampilkan dan dioperasikan: kolom pada daftar dan susunan dialog sinkronisasi. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
7.1 Datatable
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Nama Lengkap | Ya | Budi Santoso | Text |
| Kategori | — | Individu | Badge |
| Jenis Kelamin | — | Laki-laki | Badge |
| Sebagai Pengguna | — | budi@toko.com, atau Hubungkan | Badge, atau Badge “Hubungkan” bila belum terhubung |
| Sebagai Karyawan | — | EMP-0042, atau Hubungkan | Badge, atau Badge “Hubungkan” bila belum terhubung |
| Sebagai Pemasok | — | SUP-0012, atau Hubungkan | Badge, atau Badge “Hubungkan” bila belum terhubung |
| Aksi | — | Log Aktivitas | Action Menu |
7.2 Sync Dialog
Dua panel: Source Data menampilkan data entitas asal (hanya baca), Target Data untuk mencari dan memilih satu data tujuan.
Source Data
| Field | Kontrol |
|---|---|
| Nama Lengkap | Read-only |
| Kategori | Read-only |
| Jenis Kelamin | Read-only |
| Read-only | |
| Nomor Telepon | Read-only |
| Status Sebagai Pengguna, Karyawan, Pemasok | Read-only |
Target Data
| Peran | Kolom Tabel Pencarian |
|---|---|
| Pengguna | Nama, Email, Peran, Status |
| Karyawan | Kode, Nama, Jenis Kelamin, Toko, Status |
| Pemasok | Kode, Nama, Jenis Kelamin, Alamat, Kontak, Status |
Satu baris dipilih sebagai target, lalu tombol Hubungkan menyimpan sinkronisasi.
8. User Stories
US-01 - Melihat daftar entitas
Sebagai admin, saya ingin melihat semua entitas beserta perannya, agar tahu siapa berperan sebagai apa.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | Kolom: nama lengkap, kategori (individu / organisasi / perusahaan), jenis kelamin, sebagai pengguna, sebagai karyawan, sebagai pemasok. |
| AC-01.2 | Pencarian kata kunci, paginasi, urutan default nama A–Z; hanya kolom nama yang bisa diurutkan. |
| AC-01.3 | Peran yang terhubung tampil sebagai badge: email pengguna, kode karyawan, kode pemasok. |
| AC-01.4 | Entitas tanpa email atau telepon — ditampilkan sebagai ”-” di dialog. |
US-02 - Menyinkronkan entitas
Sebagai admin, saya ingin menghubungkan entitas dengan pengguna, karyawan, atau pemasok yang sudah ada, agar satu orang tidak tercatat sebagai identitas terpisah.
| ID | Kriteria penerimaan |
|---|---|
| AC-02.1 | Badge Hubungkan hanya tampil pada peran yang belum terhubung dan untuk pengguna dengan izin sync. |
| AC-02.2 | Dialog menampilkan data sumber: nama, kategori, jenis kelamin, email, telepon (diawali ”+”), dan status ketiga peran. |
| AC-02.3 | Tabel target mengikuti peran: pengguna (nama, email, peran, status), karyawan (kode, nama, jenis kelamin, toko, status), pemasok (kode, nama, jenis kelamin, alamat, kontak, status). |
| AC-02.4 | Hanya satu target yang bisa dipilih; tombol Hubungkan nonaktif sampai target dipilih. |
| AC-02.5 | Setelah berhasil, toast sukses tampil, dialog tertutup, dan daftar dimuat ulang. |
| AC-02.6 | Target yang dipilih sudah terhubung ke entitas lain — target seperti ini tidak disaring saat pemilihan. Perlu dikonfirmasi: apakah ditolak atau dipindahkan ke entitas ini (BR-01). |
| AC-02.7 | Nama atau email entitas berbeda dengan data target — sinkronisasi tetap bisa dilakukan. Perlu dikonfirmasi: data mana yang dipakai. |
| AC-02.8 | Salah menghubungkan entitas — belum ada aksi putus hubungan dari UI. |
US-03 - Riwayat aktivitas entitas
Sebagai auditor, saya ingin melihat log aktivitas entitas, agar perubahan identitas bisa ditelusuri.
| ID | Kriteria penerimaan |
|---|---|
| AC-03.1 | Log tersedia untuk semua entitas (tombol di header) dan per entitas (aksi baris), dengan filter event, pelaku, dan rentang tanggal. |
9. User Scenarios
| Role | Scenario |
|---|---|
| Admin | Melihat karyawan mana saja yang belum punya akun login |
| Admin | Menghubungkan entitas karyawan “Budi” dengan akun pengguna Budi yang dibuat terpisah |
| Owner | Memeriksa apakah sebuah pemasok juga terdaftar sebagai karyawan |
| Auditor | Melihat log aktivitas untuk satu entitas tertentu |
10. Permissions & Actions
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| Lihat List Entitas | settings:party:list:any | — |
| Lihat Log Aktivitas | settings:party:list:any | — |
| Sinkronkan Entitas | settings:party:sync:any | Peran belum terhubung |
11. Notifications
Fitur ini tidak memicu notifikasi.
12. Dependencies
PRD terkait
- Users, Employees — dibuat dari awal atau dari entitas (filter
doesnt_have). - Suppliers (modul Purchasing) — pemasok juga merupakan entitas.
- Activity Logs — sumber log aktivitas.
Efek ke modul lain
- Kolom “Sebagai Karyawan/Pengguna/Pemasok” di daftar Pengguna dan Karyawan berasal dari relasi entitas.
- Karyawan yang terhubung ke pengguna yang sedang login dipakai untuk menentukan PIC di Pesanan Pembelian.