title: “Company Membership — Konfigurasi Membership Perusahaan” description: “MembershipLevelManager.jsx (821 baris) — CRUD CustomerMembership entity, 5 skema loyalty (spending/stamp/points/visits/hybrid), auto-upgrade tier, multi-company isolation, dan integrasi real-time dengan POS.”

Company Membership — Konfigurasi Membership Perusahaan

Halaman Company Membership (MembershipLevelManager.jsx — 821 baris) mengelola konfigurasi membership level di tingkat perusahaan. Komponen ini merupakan interface untuk entitas CustomerMembership yang di-scope per company_id, memungkinkan setiap perusahaan memiliki program loyalty yang benar-benar independen dengan 5 skema loyalty, auto-upgrade tier, dan benefit kustom. Konfigurasi yang dibuat di halaman ini langsung berdampak ke seluruh transaksi POS — saat kasir memasukkan nomor member, sistem otomatis lookup tier dari CustomerMembership dan apply diskon + poin multiplier yang sesuai.

Arsitektur Komponen

Akses Halaman

Metode	Detail
URL	`/company-membership`
Sidebar	Menu CRM → Company Membership
CRM Tab	Tab “Loyalty” di halaman `/crm`

Entitas: CustomerMembership

Group	Field	Tipe	Keterangan
Identitas	`level_name`	String	Nama tier (contoh: “Gold”)
	`level_key`	String	Key unik (contoh: “gold”)
	`icon`	String	Emoji/icon tier (🥇, 🥈, 🥉)
	`color`	String	Warna hex badge (#FFD700)
Benefit	`discount_percentage`	Decimal	Diskon otomatis (0-100)
	`points_multiplier`	Decimal	Pengali poin (1.0, 1.5, 2.0)
Kriteria	`min_purchase`	Decimal	Minimum total belanja untuk upgrade
	`stamps_required`	Integer	Minimum stamp untuk upgrade
	`points_required`	Integer	Minimum poin untuk upgrade
	`visits_required`	Integer	Minimum kunjungan untuk upgrade
Skema	`scheme_type`	Enum	spending / stamp / points / visits / hybrid
Perks	`priority_support`	Boolean	Akses support prioritas
	`free_delivery`	Boolean	Gratis ongkir
	`birthday_bonus`	Boolean	Bonus poin saat ulang tahun
Custom	`benefits`	Array	Daftar benefit kustom (string[])
Status	`is_active`	Boolean	Aktif/nonaktif
	`order`	Integer	Urutan hierarki (1 = terendah)
Auto	`auto_upgrade`	Boolean	Auto-upgrade saat kriteria terpenuhi
Scope	`company_id`	UUID	Multi-tenant isolation

5 Skema Loyalty

Skema	Kriteria Utama	Gatekeeper	Contoh Use Case
spending	`total_spent ≥ min_purchase`	Rupiah threshold	Retail: Silver (1jt), Gold (5jt), Platinum (15jt)
stamp	`stamps ≥ stamps_required`	Stamp count	F&B: 10 stamp = free item
points	`total_points ≥ points_required`	Point balance	Universal: 1000 poin = Gold
visits	`visit_count ≥ visits_required`	Visit frequency	Layanan: 20 visits = VIP
hybrid	Any of the above	Flexible	Enterprise: kombinasi semua

Multi-Company Isolation

Setiap record CustomerMembership terikat pada company_id melalui Row-Level Security (RLS), sehingga perusahaan yang berbeda bisa memiliki program loyalty yang benar-benar independen.

Auto-Upgrade Flow

Integrasi dengan Modul Lain

Modul	Komponen	Integrasi
CRM	`MembershipLevelManager`	Tab “Loyalty” — CRUD tier
POS	`CompanyPOSCashier`	Apply `discount_percentage` saat checkout
POS	`usePOSCart`	Apply `points_multiplier` saat accumulate
Customer	`Customer` entity	Field `membership_level_id` link
Finance	GL Journal	Discount impact on revenue
AI	AI Agent	Filter customers by tier

Perbedaan dengan Customer Membership

Aspek	Company Membership	Customer Membership
Scope	Konfigurasi tier (admin)	Data membership pelanggan
Komponen	`MembershipLevelManager` — 821 baris	Customer-facing view
User	Admin/Owner	Pelanggan
Fungsi	Setup program loyalty	Lihat status membership sendiri
Entity	`CustomerMembership` (definition)	`Customer` (instance)
URL	`/company-membership`	`/customer-membership`
Akses	Admin only	Public (customer-scoped)

Tips

Mulai dari skema sederhana (spending) sebelum beralih ke hybrid — lebih mudah dipahami pelanggan
Set auto_upgrade = true untuk semua tier agar pelanggan otomatis naik tanpa intervensi manual
Review threshold secara berkala — jika terlalu banyak pelanggan di tier tertinggi, pertimbangkan menaikkan kriteria
Gunakan warna tier yang berbeda jelas agar kasir bisa langsung identifikasi tier pelanggan dari badge
Custom benefits bisa digunakan untuk benefit non-sistem seperti “free parking” atau “early access”

Entity Relationship Diagram

Tabel Schema — CustomerMembership

Entitas CustomerMembership mendefinisikan tier membership per perusahaan. Total 26 field.

#	Field	Tipe	Default	Required	Deskripsi
1	`company_id`	UUID	—	Ya	ID perusahaan (multi-tenant isolation)
2	`level_name`	String	—	Ya	Nama level (Silver, Gold, Platinum, dll)
3	`level_key`	String	—	Ya	Key unik untuk level (silver, gold, platinum)
4	`icon`	String	—	Tidak	Icon emoji untuk level (🥇, 🥈, 🥉)
5	`color`	String	—	Tidak	Warna hex badge (#FFD700)
6	`description`	String	—	Tidak	Penjelasan lengkap keuntungan dan syarat keanggotaan (max 1000 char)
7	`discount_percentage`	Number	`0`	Tidak	Diskon % untuk member level ini (0–100)
8	`points_multiplier`	Number	`1`	Tidak	Multiplier poin yang didapat (1 = normal, 2 = double)
9	`min_purchase`	Number	`0`	Tidak	Minimum pembelian untuk mendapat level ini
10	`benefits`	Array<String>	—	Tidak	List benefit yang didapat (string[])
11	`priority_support`	Boolean	`false`	Tidak	Akses priority support via WhatsApp
12	`free_delivery`	Boolean	`false`	Tidak	Gratis ongkir
13	`birthday_bonus`	Number	`0`	Tidak	Bonus poin di hari ulang tahun
14	`is_active`	Boolean	`true`	Tidak	Status aktif/nonaktif tier
15	`order`	Number	`0`	Tidak	Urutan level (semakin tinggi semakin premium)
16	`scheme_type`	Enum	`"points"`	Tidak	Skema loyalty: `points`, `stamp`, `spending`, `visits`, `hybrid`
17	`points_threshold`	Number	`10000`	Tidak	Ambang batas belanja per perolehan poin (misal Rp 10.000)
18	`points_per_threshold`	Number	`1`	Tidak	Jumlah poin yang diperoleh per threshold
19	`stamps_required`	Number	`10`	Tidak	Jumlah stamp yang dibutuhkan untuk reward atau naik level
20	`stamp_per_transaction`	Number	`1`	Tidak	Jumlah stamp yang diperoleh per transaksi eligible
21	`min_redemption_points`	Number	`0`	Tidak	Minimal poin untuk dapat melakukan penukaran reward
22	`reward_type`	Enum	`"none"`	Tidak	Jenis reward: `none`, `discount_percentage`, `discount_amount`, `free_product`
23	`reward_value`	Number	`0`	Tidak	Nilai reward (persen diskon atau nominal diskon)
24	`reward_product_id`	String	—	Tidak	ID produk reward gratis jika `reward_type = free_product`
25	`reward_product_name`	String	—	Tidak	Nama produk reward gratis
26	`expiry_days`	Number	—	Tidak	Masa kedaluwarsa poin dalam hari (opsional)

Tabel Schema — CustomerLoyaltyLedger

Entitas CustomerLoyaltyLedger mencatat setiap mutasi loyalty (earn, redeem, reversal, upgrade, adjustment). Total 24 field.

#	Field	Tipe	Default	Required	Deskripsi
1	`company_id`	UUID	—	Ya	ID perusahaan
2	`customer_id`	UUID	—	Ya	ID customer penerima / pemilik transaksi loyalty
3	`customer_name`	String	—	Tidak	Nama customer saat transaksi (denormalized)
4	`customer_phone`	String	—	Tidak	Nomor telepon / kontak customer (denormalized)
5	`transaction_id`	String	—	Tidak	ID transaksi POS atau referensi sale asal
6	`transaction_number`	String	—	Tidak	Nomor struk / receipt number transaksi
7	`idempotency_key`	String	—	Ya	Idempotency key untuk mencegah double crediting / posting
8	`event_type`	Enum	—	Ya	Tipe event mutasi: `earn`, `redeem`, `return_reversal`, `tier_upgrade`, `manual_adjustment`
9	`scheme_type`	Enum	`"points"`	Tidak	Skema loyalty: `points`, `stamp`, `spending`, `visits`, `hybrid`
10	`points_delta`	Number	`0`	Tidak	Perubahan poin (+ bertambah, − berkurang)
11	`points_before`	Number	`0`	Tidak	Saldo poin sebelum event
12	`points_after`	Number	`0`	Tidak	Saldo poin setelah event
13	`stamps_delta`	Number	`0`	Tidak	Perubahan stamp (+ bertambah, − berkurang)
14	`stamps_before`	Number	`0`	Tidak	Saldo stamp sebelum event
15	`stamps_after`	Number	`0`	Tidak	Saldo stamp setelah event
16	`eligible_amount`	Number	`0`	Tidak	Nilai transaksi yang sah / eligible untuk perolehan poin
17	`reason`	String	—	Tidak	Alasan atau keterangan mutasi loyalty
18	`deficit_points`	Number	`0`	Tidak	Defisit poin jika poin telah terpakai sebelum void/return
19	`requires_manual_review`	Boolean	`false`	Tidak	Flag jika transaksi reversal menghasilkan saldo negatif dan butuh review manual
20	`reward_details`	Object	—	Tidak	Detail reward jika event = `redeem` (reward_type, discount_amount, discount_percentage, product_id, product_name, cost_points, cost_stamps)
21	`performed_by`	String	—	Tidak	Email atau ID operator yang memproses
22	`actor_role`	String	—	Tidak	Role aktor (owner, admin, cashier)
23	`created_at`	DateTime	—	Tidak	Waktu event tercatat di server
24	`finance_record_id`	String	—	Tidak	ID FinancialRecord (biaya COGS reward) yang terhubung, diisi saat event redeem

State Machine — Membership Tier Progression

Sequence Diagram — Tier Upgrade

Sequence Diagram — Points Expiry

Sequence Diagram — Member Benefits Application

Enum Tables

`scheme_type` — Skema Loyalty

Nilai	Deskripsi	Kriteria Upgrade
`points`	Akumulasi poin dari setiap transaksi	`membership_points ≥ points_required`
`stamp`	Stamp per transaksi eligible	`stamps ≥ stamps_required`
`spending`	Total nominal belanja (rupiah)	`total_spent ≥ min_purchase`
`visits`	Frekuensi kunjungan / transaksi	`visit_count ≥ visits_required`
`hybrid`	Kombinasi fleksibel — salah satu kriteria terpenuhi	ANY of the above

`reward_type` — Jenis Reward

Nilai	Deskripsi	Field Terkait
`none`	Tidak ada reward yang dapat ditukar	—
`discount_percentage`	Tukar poin untuk diskon persentase	`reward_value` = persentase diskon
`discount_amount`	Tukar poin untuk diskon nominal (Rupiah)	`reward_value` = nominal diskon
`free_product`	Tukar poin untuk produk gratis	`reward_product_id`, `reward_product_name`

`event_type` — Tipe Event Loyalty Ledger

Nilai	Deskripsi	Impact pada Saldo
`earn`	Perolehan poin/stamp dari transaksi	`points_delta > 0` atau `stamps_delta > 0`
`redeem`	Penukaran reward	`points_delta < 0` atau `stamps_delta < 0`
`return_reversal`	Pembatalan/void → reversal poin	`points_delta < 0` (reversal)
`tier_upgrade`	Kenaikan tier (tidak mengubah saldo)	`points_delta = 0`
`manual_adjustment`	Penyesuaian manual oleh admin	Bisa positif atau negatif

`membership_tier` (POSMember) — Tier Legacy

Nilai	Deskripsi
`regular`	Tier default / belum naik
`silver`	Tier perak
`gold`	Tier emas
`platinum`	Tier tertinggi (legacy)

RBAC — Hak Akses Company Membership

Role	Create	Read	Update	Delete	Keterangan
Super Admin	✅	✅	✅	✅	Akses penuh semua perusahaan
Owner	✅	✅	✅	✅	Akses penuh dalam company_id sendiri
Admin	✅	✅	✅	✅	Kelola tier loyalty per perusahaan
Manager	❌	✅	❌	❌	Hanya lihat konfigurasi tier
Cashier	❌	✅	❌	❌	Lihat tier untuk apply diskon di POS
Customer	❌	✅ (own)	❌	❌	Lihat tier membership sendiri saja

Catatan RLS: Semua operasi pada CustomerMembership dan CustomerLoyaltyLedger di-filter oleh company_id = user.data.active_company_id melalui Row-Level Security, memastikan isolasi data antar perusahaan.

Mulai

Dashboard & Core

POS & Kasir

Inventori

Manufaktur

Keuangan

SDM & Kehadiran

CRM & Pelanggan

AI & Analitik

Analytics & Reporting

Produktivitas

Komunikasi

Marketing & B2B

Toko Online

Admin & Pengaturan

Company membership

title: “Company Membership — Konfigurasi Membership Perusahaan” description: “MembershipLevelManager.jsx (821 baris) — CRUD CustomerMembership entity, 5 skema loyalty (spending/stamp/points/visits/hybrid), auto-upgrade tier, multi-company isolation, dan integrasi real-time dengan POS.”

Company Membership — Konfigurasi Membership Perusahaan

Arsitektur Komponen

Akses Halaman

Entitas: CustomerMembership

5 Skema Loyalty

Multi-Company Isolation

Auto-Upgrade Flow

Integrasi dengan Modul Lain

Perbedaan dengan Customer Membership

Tips

Entity Relationship Diagram

Tabel Schema — CustomerMembership

Tabel Schema — CustomerLoyaltyLedger

State Machine — Membership Tier Progression

Sequence Diagram — Tier Upgrade

Sequence Diagram — Points Expiry

Sequence Diagram — Member Benefits Application

Enum Tables

`scheme_type` — Skema Loyalty

`reward_type` — Jenis Reward

`event_type` — Tipe Event Loyalty Ledger

`membership_tier` (POSMember) — Tier Legacy

RBAC — Hak Akses Company Membership

​Company Membership — Konfigurasi Membership Perusahaan

​Arsitektur Komponen

​Akses Halaman

​Entitas: CustomerMembership

​5 Skema Loyalty

​Multi-Company Isolation

​Auto-Upgrade Flow

​Integrasi dengan Modul Lain

​Perbedaan dengan Customer Membership

​Tips

​Entity Relationship Diagram

​Tabel Schema — CustomerMembership

​Tabel Schema — CustomerLoyaltyLedger

​State Machine — Membership Tier Progression

​Sequence Diagram — Tier Upgrade

​Sequence Diagram — Points Expiry

​Sequence Diagram — Member Benefits Application

​Enum Tables

​scheme_type — Skema Loyalty

​reward_type — Jenis Reward

​event_type — Tipe Event Loyalty Ledger

​membership_tier (POSMember) — Tier Legacy

​RBAC — Hak Akses Company Membership

Company Membership — Konfigurasi Membership Perusahaan

Arsitektur Komponen

Akses Halaman

Entitas: CustomerMembership

5 Skema Loyalty

Multi-Company Isolation

Auto-Upgrade Flow

Integrasi dengan Modul Lain

Perbedaan dengan Customer Membership

Tips

Entity Relationship Diagram

Tabel Schema — CustomerMembership

Tabel Schema — CustomerLoyaltyLedger

State Machine — Membership Tier Progression

Sequence Diagram — Tier Upgrade

Sequence Diagram — Points Expiry

Sequence Diagram — Member Benefits Application

Enum Tables

`scheme_type` — Skema Loyalty

`reward_type` — Jenis Reward

`event_type` — Tipe Event Loyalty Ledger

`membership_tier` (POSMember) — Tier Legacy

RBAC — Hak Akses Company Membership