Skip to Content

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

  1. Daftar Entitas — Seluruh entitas tampil beserta peran yang sudah dimilikinya sebagai pengguna, karyawan, atau pemasok. Peran yang belum terhubung ditandai agar bisa langsung ditindaklanjuti.
  2. Sinkronisasi Entitas — Admin memilih peran yang ingin dihubungkan ke entitas tersebut.
  3. Pilih Data Tujuan — Data pengguna, karyawan, atau pemasok yang sudah ada dicari lalu dipilih sebagai pasangan entitas itu.
  4. Validasi — Penghubungan diperiksa sebelum tersimpan, termasuk memastikan peran tersebut belum terpakai oleh entitas lain.
  5. Entitas Terhubung — Entitas dan data perannya kini menjadi satu identitas, dan datanya konsisten di semua peran.

6. Document Structure

6.1 General

FieldTipeWajibDefaultAturan
Nama LengkapTeks—Mengikuti data entitasDitetapkan saat pengguna, karyawan, atau pemasok dibuat (BR-02)
KategoriEnum—Mengikuti data entitasIndividu, Organisasi, atau Perusahaan
Jenis KelaminEnum—Mengikuti data entitasLaki-laki, Perempuan, atau kosong
EmailTeks—Mengikuti data entitasBisa kosong
Nomor TeleponTeks—Mengikuti data entitasBisa kosong, ditampilkan dengan awalan ”+”
Sebagai PenggunaRef. Pengguna——Paling banyak satu (BR-01)
Sebagai KaryawanRef. Karyawan——Paling banyak satu (BR-01)
Sebagai PemasokRef. 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

KolomSortableContoh NilaiKomponen
Nama LengkapYaBudi SantosoText
Kategori—IndividuBadge
Jenis Kelamin—Laki-lakiBadge
Sebagai Pengguna—budi@toko.com, atau HubungkanBadge, atau Badge “Hubungkan” bila belum terhubung
Sebagai Karyawan—EMP-0042, atau HubungkanBadge, atau Badge “Hubungkan” bila belum terhubung
Sebagai Pemasok—SUP-0012, atau HubungkanBadge, atau Badge “Hubungkan” bila belum terhubung
Aksi—Log AktivitasAction 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

FieldKontrol
Nama LengkapRead-only
KategoriRead-only
Jenis KelaminRead-only
EmailRead-only
Nomor TeleponRead-only
Status Sebagai Pengguna, Karyawan, PemasokRead-only

Target Data

PeranKolom Tabel Pencarian
PenggunaNama, Email, Peran, Status
KaryawanKode, Nama, Jenis Kelamin, Toko, Status
PemasokKode, 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.

IDKriteria penerimaan
AC-01.1Kolom: nama lengkap, kategori (individu / organisasi / perusahaan), jenis kelamin, sebagai pengguna, sebagai karyawan, sebagai pemasok.
AC-01.2Pencarian kata kunci, paginasi, urutan default nama A–Z; hanya kolom nama yang bisa diurutkan.
AC-01.3Peran yang terhubung tampil sebagai badge: email pengguna, kode karyawan, kode pemasok.
AC-01.4Entitas 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.

IDKriteria penerimaan
AC-02.1Badge Hubungkan hanya tampil pada peran yang belum terhubung dan untuk pengguna dengan izin sync.
AC-02.2Dialog menampilkan data sumber: nama, kategori, jenis kelamin, email, telepon (diawali ”+”), dan status ketiga peran.
AC-02.3Tabel 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.4Hanya satu target yang bisa dipilih; tombol Hubungkan nonaktif sampai target dipilih.
AC-02.5Setelah berhasil, toast sukses tampil, dialog tertutup, dan daftar dimuat ulang.
AC-02.6Target 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.7Nama atau email entitas berbeda dengan data target — sinkronisasi tetap bisa dilakukan. Perlu dikonfirmasi: data mana yang dipakai.
AC-02.8Salah 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.

IDKriteria penerimaan
AC-03.1Log tersedia untuk semua entitas (tombol di header) dan per entitas (aksi baris), dengan filter event, pelaku, dan rentang tanggal.

9. User Scenarios

RoleScenario
AdminMelihat karyawan mana saja yang belum punya akun login
AdminMenghubungkan entitas karyawan “Budi” dengan akun pengguna Budi yang dibuat terpisah
OwnerMemeriksa apakah sebuah pemasok juga terdaftar sebagai karyawan
AuditorMelihat log aktivitas untuk satu entitas tertentu

10. Permissions & Actions

10.1 Permission by Action

ActionPermissionKondisi
Lihat List Entitassettings:party:list:any—
Lihat Log Aktivitassettings:party:list:any—
Sinkronkan Entitassettings:party:sync:anyPeran 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.
Terakhir diperbarui