title: “Cart & Checkout” description: “Keranjang belanja multi-seller, checkout, payment gateway, POS mirror, voucher & diskon, dan order splitting di SNISHOP ERP.”

Cart & Checkout

Ringkasan Eksekutif

Cart.jsx (837 baris) merupakan pusat sistem keranjang belanja dan checkout SNISHOP ERP yang mendukung arsitektur multi-seller — item dari seller berbeda di-group secara otomatis dan diproses sebagai order terpisah. Sistem ini menangani 4 metode pembayaran utama, membuat POS mirror records, broadcast ke order queue via BroadcastChannel, dan menghitung commission secara server-side untuk menjamin integritas data finansial. Checkout flow dirancang untuk menangani kompleksitas marketplace: ketika customer checkout item dari beberapa seller sekaligus, sistem otomatis split menjadi beberapa order (ProductOrder untuk item official, MarketplaceOrder untuk third-party sellers) dengan perhitungan commission yang akurat dan audit trail yang lengkap. Sistem ini juga mengimplementasikan security policy yang ketat: browser-side code tidak pernah menggunakan asServiceRole, tidak pernah memanggil Company.list(), dan commission rate selalu di-fetch via server function.

Kapabilitas Utama

Kapabilitas	Deskripsi
Multi-Seller Cart	Keranjang mendukung item dari multiple seller dengan grouping otomatis berdasarkan `seller_id`
Order Splitting	Checkout otomatis split ke `ProductOrder` (official) dan `MarketplaceOrder` (third-party)
4 Metode Pembayaran	Saldo (wallet), Manual Transfer (offline), Mayar (gateway), SNISHOP Pay (gateway)
POS Mirror	Setiap order online di-mirror ke `CompanyPOSTransaction` untuk sinkronisasi POS
Real-Time Sync	BroadcastChannel API untuk sinkronisasi real-time antar tab browser
Voucher & Diskon	Support voucher code, reseller discount berdasarkan tier membership, dan tip
Quota-Based Products	Dukungan produk berbasis kuota dengan tracking penggunaan
Commission Engine	Perhitungan commission marketplace via server function untuk keamanan
Company Context	Filtering item keranjang berdasarkan konteks company (multi-tenant)
Order History	Unified order history dari `ProductOrder` dan `MarketplaceOrder` via MyOrders

Arsitektur Komponen

Diagram Alur Data End-to-End

Entity & Model

MarketplaceCart

Field	Tipe	Deskripsi
`id`	UUID	Primary key
`user_id`	UUID	Buyer
`company_id`	UUID	Buyer company context
`product_id`	UUID	Product reference
`product_name`	String	Nama produk (snapshot)
`product_price`	Number	Harga saat add to cart
`quantity`	Number	Jumlah
`metadata`	JSON	Berisi `seller_id`, `product_type`
`created_at`	Timestamp	Waktu add to cart

ProductOrder (Official Items)

Field	Tipe	Deskripsi
`id`	UUID	Primary key
`product_name`	String	Nama produk
`customer_id`	UUID	Buyer
`status`	Enum	`pending`, `processing`, `completed`, `cancelled`
`subtotal`	Number	Subtotal
`discount_amount`	Number	Diskon
`total_amount`	Number	Total bayar
`payment_method`	Enum	Metode pembayaran
`payment_status`	Enum	`unpaid`, `paid`, `refunded`
`order_data`	JSON	Detail items
`company_id`	UUID	Multi-tenant scoping
`created_at`	Timestamp	Waktu order

MarketplaceOrder (Third-Party Items)

Field	Tipe	Deskripsi
`id`	UUID	Primary key
`order_number`	String	Nomor order unik
`buyer_id`	UUID	Buyer
`seller_company_id`	UUID	Seller company
`items`	Array	Daftar item yang dipesan
`total_amount`	Number	Total amount
`commission_amount`	Number	Komisi platform
`company_amount`	Number	Amount untuk seller (total - commission)
`status`	Enum	`pending`, `processing`, `delivered`, `cancelled`
`payment_method`	Enum	Metode pembayaran
`payment_status`	Enum	`unpaid`, `paid`, `refunded`
`shipping_info`	JSON	Alamat pengiriman
`notes`	Text	Catatan order
`company_id`	UUID	Buyer company context
`created_at`	Timestamp	Waktu order

CompanyPOSTransaction (POS Mirror)

Field	Tipe	Deskripsi
`id`	UUID	Primary key
`transaction_number`	String	Nomor transaksi POS
`order_id`	UUID	Reference ke order asal
`total_amount`	Number	Total amount
`payment_method`	Enum	Metode pembayaran
`company_id`	UUID	Multi-tenant scoping
`created_at`	Timestamp	Waktu transaksi

Fitur Utama

1. Multi-Seller Checkout

Checkout flow menangani item dari multiple sellers dalam satu transaksi:

2. Order Splitting Logic

Condition	Order Type	Deskripsi
`seller_id == 'official'`	`ProductOrder`	Item dari SNISHOP official
`seller_id != 'official'`	`MarketplaceOrder`	Item dari third-party seller

Financial Breakdown (MarketplaceOrder):

Field	Formula	Deskripsi
`total_amount`	`SUM(item.price * quantity)`	Total amount
`commission_amount`	`total_amount * (commission_rate / 100)`	Komisi platform
`company_amount`	`total_amount - commission_amount`	Amount untuk seller

3. Payment Methods

Method	Type	Flow
Saldo	Wallet	Direct deduction dari user balance
Manual Transfer	Offline	Status = pending, menunggu konfirmasi
Mayar	Gateway	Redirect ke payment gateway
SNISHOP Pay	Gateway	Route via static IP bridge server

Payment Routing:

4. Company Context Filtering

Cart items di-filter berdasarkan company context menggunakan filterCartItemsForContext():

Mode	Behavior
Personal mode	Hanya tampilkan item dengan seller = ‘official’
Company mode	Hanya tampilkan item dari company tersebut

Security: Mencegah cross-company cart leakage dalam multi-tenant environment.

5. POS Mirror & Broadcast

Setiap order yang dibuat di-cart juga di-mirror ke POS system: BroadcastChannel API: Komunikasi real-time antar browser tabs — POS di tab lain bisa langsung receive update tanpa perlu polling.

6. Commission Calculation

Commission rate selalu di-fetch dari server function untuk security: Security Policy: Browser-side code tidak pernah menghitung commission secara lokal — selalu via server function untuk mencegah manipulation.

7. Voucher & Diskon System

Sistem checkout mendukung beberapa mekanisme diskon yang dapat dikombinasikan:

Mekanisme	Sumber	Deskripsi
Voucher Code	`ProductVoucher`	Kode voucher yang diinput customer saat checkout
Reseller Discount	`ShopSettings.reseller_discounts`	Diskon otomatis berdasarkan tier membership
Tip Amount	Customer input	Tip opsional dari customer
Balance Deduction	`used_balance`	Penggunaan saldo wallet untuk pembayaran
Commission Discount	`used_commission`	Komisi reseller yang digunakan sebagai potongan

Flow Voucher Application: Reseller Discount Tiers (dari ShopSettings.reseller_discounts):

Tier	Discount	Deskripsi
`free`	0%	Tidak ada diskon
`pro`	5%	Diskon tingkat pemula
`business`	10%	Diskon tingkat bisnis
`advanced`	15%	Diskon tingkat lanjutan
`enterprise`	20%	Diskon tingkat enterprise (maksimal)

Pricing Calculation Formula:

subtotal         = product_price * quantity
reseller_disc    = subtotal * reseller_discount_rate
voucher_disc     = MIN(subtotal * voucher_pct, max_discount)   -- atau fixed_amount
tip              = customer_input (optional)
final_price      = subtotal - reseller_disc - voucher_disc + tip - used_balance - used_commission

8. Cart Management

Action	Deskripsi
Update quantity	Increment/decrement item quantity
Remove item	Hapus item dari cart
Select all/none	Toggle semua item untuk checkout
Clear cart	Hapus semua item
Save for later	Cart persist di database (bukan localStorage)

9. Order Status Tracking

Status	Label (ID)	Deskripsi
`pending`	Menunggu Pembayaran	Order dibuat, belum bayar
`processing`	Sedang Diproses	Pembayaran diterima, sedang diproses
`completed`	Selesai	Order selesai/dikirim
`cancelled`	Dibatalkan	Order dibatalkan

10. Quota-Based Products

Sistem mendukung produk berbasis kuota yang memungkinkan satu order digunakan berulang kali hingga kuota habis:

Field	Deskripsi
`is_quota_based`	Flag apakah produk menggunakan sistem kuota
`quota_total`	Total kuota yang dibeli
`quota_used`	Kuota yang sudah digunakan
`quota_remaining`	Sisa kuota (`quota_total - quota_used`)
`parent_order_id`	Referensi ke order induk (untuk sub-order)

Use Case: Produk digital seperti jasa desain yang bisa direvisi beberapa kali — customer beli 1 order dengan kuota 5 revisi.

Security Policies

Browser-Side Restrictions

Cart mengimplementasikan 3 security policy yang di-enforce via test files:

Policy	File	Rule
No `asServiceRole`	`cartBrowserPrivilegePolicy.test.js`	Browser code tidak boleh bypass RLS
No `Company.list()`	`cartBrowserPrivilegePolicy.test.js`	Browser code tidak boleh enumerate tenants
Commission via server	`Cart.commissionScopePolicy.test.js`	Commission rate hanya dari server function

Rationale: Mencegah privilege escalation dan data leakage dalam multi-tenant environment.

Kebijakan Keamanan RLS (Row-Level Security)

CompanyPOSTransaction memiliki RLS paling ketat di antara semua entity cart/order:

Kondisi akses (CREATE, READ, UPDATE, DELETE):
  OR:
    1. data.company_id == user.data.active_company_id  DAN  company_id bukan null/kosong
    2. created_by_id == user.id
    3. user.role == 'admin'

Implikasi:

Staff POS hanya bisa mengakses transaksi dalam company yang sedang aktif
User bisa mengakses transaksi yang mereka buat sendiri
Admin memiliki akses penuh tanpa batasan company
Mencegah cross-tenant data leakage dalam environment multi-company

Cart (MarketplaceCart) menggunakan RLS sederhana tanpa kondisi eksplisit — akses dikontrol melalui filterCartItemsForContext() di browser-side untuk filtering berdasarkan company context. Commission Rate tidak pernah diekspos ke browser — selalu di-fetch via server function getMarketplaceCommissionRate() untuk mencegah manipulasi nilai komisi dari client-side.

MyOrders (Order History)

MyOrders.jsx (345 baris) menampilkan unified order history dari 2 sumber:

Source	Entity	Tag
Digital products	`ProductOrder`	`source: 'digital'`
Marketplace	`MarketplaceOrder`	`source: 'marketplace'`

Fitur:

Fitur	Deskripsi
10-second polling	Silent auto-refresh untuk update status
Order detail modal	Items, order_data, admin notes, result files
Status tracking	pending → processing → completed
File download	Download result files untuk order digital

Flow MyOrders Polling:

Cara Akses

Dari sidebar, klik menu Shop > Cart. URL publik: /checkout

Flow Penggunaan

Customer

Browse produk dari Shop atau Marketplace
Klik “Add to Cart” untuk menambahkan produk
Buka halaman Cart (/checkout)
Review item di keranjang
Update quantity atau hapus item jika perlu
Select items yang ingin di-checkout
Klik “Checkout”
Pilih metode pembayaran (Saldo / Manual / Mayar / SNISHOP Pay)
Isi alamat pengiriman (jika fisik)
Selesaikan pembayaran
Lihat order status di halaman MyOrders (/pesanan-saya)

Admin

Monitor order masuk dari MarketplaceOrdersTab
Untuk Manual Transfer: konfirmasi pembayaran dan update status
Process order: update status dari pending → processing → completed
Upload result files untuk order digital yang selesai
Track commission yang masuk dari marketplace orders

Integrasi Cross-Module

Tips

Test multi-seller checkout dengan item dari official dan third-party seller — pastikan order splitting bekerja dengan benar
Monitor BroadcastChannel sync — POS di tab lain harus receive update real-time
Untuk Manual Transfer, set ekspektasi ke customer bahwa order baru diproses setelah pembayaran dikonfirmasi admin
Commission rate di-fetch via server function untuk security — jangan pernah hardcode atau calculate di browser
Gunakan company context filtering untuk mencegah cross-company cart leakage
MyOrders polling (10 detik) memastikan customer lihat update status tanpa perlu refresh manual
Voucher memiliki usage_limit dan valid_until — pastikan validasi kedua field ini sebelum apply diskon
Reseller discount tier dihitung otomatis berdasarkan membership level customer — tidak perlu input manual
Untuk produk berbasis kuota, monitor quota_remaining agar tidak terjadi over-usage

Referensi Entity Schema (base44)

Bagian ini mendokumentasikan schema entity secara lengkap berdasarkan definisi JSONC di base44/entities/.

Diagram Relasi Entity (erDiagram)

Tabel Schema Detail Entity

MarketplaceCart — Keranjang Belanja Marketplace

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`user_id`	UUID	Ya	—	ID user pemilik keranjang
`company_id`	UUID	Ya	—	ID company (konteks multi-tenant)
`product_id`	UUID	Ya	—	ID produk yang dimasukkan ke keranjang
`product_name`	String	Tidak	—	Nama produk (snapshot saat add to cart)
`product_price`	Number	Tidak	—	Harga produk saat add to cart
`product_image`	String	Tidak	—	URL gambar produk
`description`	String	Tidak	—	Catatan/instruksi khusus dari pembeli (maks 1000 karakter)
`quantity`	Number	Ya	`1`	Jumlah item dalam keranjang
`subtotal`	Number	Tidak	—	Subtotal (price x quantity)
`created_at`	Timestamp	Otomatis	now()	Waktu item ditambahkan ke keranjang

DigitalProduct — Produk Digital (Official)

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`name`	String	Ya	—	Nama produk digital
`description`	String	Ya	—	Deskripsi produk
`category`	Enum	Ya	—	Kategori produk: `zoom`, `design`, `video_editing`, `plagiarism_check`, `other`
`price`	Number	Ya	—	Harga produk dasar
`images`	Array[String]	Tidak	—	Array URL gambar produk (rasio 1:1)
`is_active`	Boolean	Tidak	`true`	Status aktif produk
`stock_available`	Boolean	Tidak	`true`	Ketersediaan stok
`order_form_fields`	Array[Object]	Tidak	—	Form fields yang harus diisi customer saat order
`variants`	Array[Object]	Tidak	—	Varian produk dengan harga berbeda
`delivery_time`	String	Tidak	—	Estimasi waktu pengerjaan
`features`	Array[String]	Tidak	—	Fitur-fitur produk
`commission_rate`	Number	Tidak	`0`	Persentase komisi untuk admin (0-1)

Struktur order_form_fields[]:

Sub-Field	Tipe	Deskripsi
`field_id`	String	ID unik field
`field_type`	Enum	`text`, `number`, `email`, `file`, `textarea`, `date`, `time`, `select`, `radio`, `checkbox`
`field_label`	String	Label field yang ditampilkan
`field_placeholder`	String	Placeholder text
`is_required`	Boolean	Apakah field wajib diisi (default: `false`)
`is_enabled`	Boolean	Apakah field aktif (default: `true`)
`options`	Array[Object]	Opsi untuk type `select`/`radio`/`checkbox`

Struktur variants[]:

Sub-Field	Tipe	Deskripsi
`name`	String	Nama varian
`price`	Number	Harga varian ini
`description`	String	Deskripsi varian
`is_active`	Boolean	Status aktif varian (default: `true`)

ProductOrder — Pesanan Produk Digital (Official)

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`product_id`	UUID	Ya	—	ID produk digital yang dipesan
`product_name`	String	Ya	—	Nama produk
`product_category`	String	Tidak	—	Kategori produk
`product_price`	Number	Ya	—	Harga satuan produk
`product_commission_rate`	Number	Tidak	`0`	Commission rate saat order dibuat (snapshot)
`selected_variant`	Object	Tidak	—	Varian yang dipilih (jika ada)
`customer_id`	UUID	Ya	—	ID customer/pembeli
`customer_email`	String	Ya	—	Email customer
`customer_name`	String	Tidak	—	Nama customer
`order_data`	Object	Tidak	—	Data tambahan order (instruksi khusus, dll)
`description`	String	Tidak	—	Catatan/instruksi khusus dari pelanggan (maks 1000 karakter)
`used_balance`	Number	Tidak	`0`	Saldo wallet yang digunakan untuk bayar
`used_commission`	Number	Tidak	`0`	Komisi reseller yang digunakan sebagai diskon
`reseller_discount`	Number	Tidak	`0`	Persentase diskon reseller (0-1)
`reseller_discount_amount`	Number	Tidak	`0`	Nominal diskon reseller
`voucher_code`	String	Tidak	—	Kode voucher yang digunakan
`voucher_code_used`	String	Tidak	—	Kode voucher yang terekam
`voucher_discount_amount`	Number	Tidak	`0`	Nominal potongan dari voucher
`tip_amount`	Number	Tidak	`0`	Tip dari customer
`subtotal`	Number	Tidak	—	Harga sebelum diskon
`final_price`	Number	Tidak	—	Harga final setelah semua potongan
`status`	Enum	Tidak	`pending`	Status pesanan
`admin_notes`	String	Tidak	—	Catatan admin untuk order ini
`result_files`	Array[String]	Tidak	—	Daftar URL file hasil (untuk produk digital)
`completed_at`	DateTime	Tidak	—	Waktu order selesai
`processed_by_admin`	String	Tidak	—	Email admin yang memproses
`assigned_to_admin`	String	Tidak	—	Email admin yang mengambil order
`assigned_at`	DateTime	Tidak	—	Waktu order diambil admin
`admin_commission_amount`	Number	Tidak	`0`	Komisi admin dari order ini
`admin_commission_paid`	Boolean	Tidak	`false`	Status pembayaran komisi admin
`quota_total`	Number	Tidak	`0`	Total kuota (untuk produk berbasis kuota)
`quota_used`	Number	Tidak	`0`	Kuota yang sudah digunakan
`quota_remaining`	Number	Tidak	`0`	Sisa kuota
`is_quota_based`	Boolean	Tidak	`false`	Apakah produk berbasis kuota
`parent_order_id`	UUID	Tidak	—	Referensi ke order induk (untuk sub-order)

MarketplaceOrder — Pesanan Marketplace (Third-Party Seller)

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`order_number`	String	Tidak	—	Nomor order unik (auto-generated)
`customer_id`	UUID	Ya	—	ID user yang membeli
`customer_email`	String	Tidak	—	Email customer
`customer_name`	String	Tidak	—	Nama customer
`company_id`	UUID	Ya	—	ID company yang menjual
`company_name`	String	Tidak	—	Nama company penjual
`items`	Array[Object]	Ya	—	Daftar produk yang dibeli
`total_amount`	Number	Ya	—	Total pembayaran
`commission_rate`	Number	Tidak	—	Persentase komisi marketplace (0-100)
`commission_amount`	Number	Tidak	—	Jumlah komisi dalam rupiah
`company_amount`	Number	Tidak	—	Jumlah yang diterima company setelah komisi
`status`	Enum	Tidak	`pending`	Status pesanan
`payment_status`	Enum	Tidak	`paid`	Status pembayaran
`shipping_address`	Object	Tidak	—	Alamat pengiriman (name, phone, address, city, province, postal_code)
`notes`	String	Tidak	—	Catatan customer untuk order
`tracking_number`	String	Tidak	—	Nomor resi pengiriman
`processed_at`	DateTime	Tidak	—	Waktu order mulai diproses
`shipped_at`	DateTime	Tidak	—	Waktu order dikirim
`delivered_at`	DateTime	Tidak	—	Waktu order diterima

Struktur items[] (MarketplaceOrder):

Sub-Field	Tipe	Deskripsi
`product_id`	UUID	ID produk
`product_name`	String	Nama produk
`quantity`	Number	Jumlah yang dipesan
`price`	Number	Harga satuan saat order
`subtotal`	Number	Subtotal per item (price x quantity)

Struktur shipping_address (MarketplaceOrder):

Sub-Field	Tipe	Deskripsi
`name`	String	Nama penerima
`phone`	String	Nomor telepon penerima
`address`	String	Alamat lengkap
`city`	String	Kota
`province`	String	Provinsi
`postal_code`	String	Kode pos

MarketplaceCommissionSettings — Pengaturan Komisi Marketplace

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`commission_rate`	Number	Ya	`10`	Persentase komisi marketplace (0-100)
`description`	String	Tidak	—	Penjelasan kebijakan komisi dan ketentuan penarikan saldo (maks 1000 karakter)
`min_withdrawal`	Number	Tidak	`100000`	Minimum penarikan saldo (dalam rupiah)
`withdrawal_fee`	Number	Tidak	`5000`	Biaya admin penarikan (dalam rupiah)
`is_active`	Boolean	Tidak	`true`	Apakah pengaturan komisi aktif

CompanyPOSTransaction — Transaksi POS (Mirror & Direct)

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`company_id`	UUID	Ya	—	ID perusahaan
`location_id`	UUID	Tidak	—	ID lokasi gudang/toko
`location_name`	String	Tidak	—	Nama lokasi
`transaction_number`	String	Ya	—	Nomor transaksi unik
`invoice_number`	String	Tidak	—	Nomor invoice
`transaction_date`	DateTime	Tidak	—	Tanggal/waktu transaksi
`items`	Array[Object]	Ya	—	Item yang dibeli
`subtotal`	Number	Tidak	—	Subtotal sebelum diskon dan pajak
`discount_amount`	Number	Tidak	`0`	Nominal diskon
`discount_percentage`	Number	Tidak	`0`	Persentase diskon
`tax_amount`	Number	Tidak	`0`	PPN atas transaksi (inclusive/exclusive)
`total`	Number	Ya	—	Total akhir
`total_amount`	Number	Tidak	—	Total akhir (alias untuk `total`)
`payment_method`	Enum	Tidak	—	Metode pembayaran
`payment_amount`	Number	Tidak	—	Jumlah uang yang dibayar
`payments`	Array[Object]	Tidak	—	Detail pembayaran multi-tender (split payment)
`payment_status`	Enum	Tidak	`pending`	Status pembayaran
`paid_amount`	Number	Tidak	`0`	Nominal pembayaran aktual yang telah diverifikasi
`remaining_amount`	Number	Tidak	`0`	Sisa kekurangan tagihan
`excess_amount`	Number	Tidak	`0`	Kelebihan nominal transfer
`change_amount`	Number	Tidak	`0`	Kembalian
`payment_reference`	String	Tidak	—	No. referensi bukti transfer/QRIS
`payment_verified_by`	String	Tidak	—	Nama pengguna yang memverifikasi pembayaran
`payment_verified_at`	DateTime	Tidak	—	Waktu verifikasi pembayaran
`customer_id`	UUID	Tidak	—	ID member jika ada
`customer_name`	String	Tidak	—	Nama customer
`customer_phone`	String	Tidak	—	Nomor telepon customer
`customer_address`	String	Tidak	—	Alamat customer
`points_earned`	Number	Tidak	`0`	Poin loyalty yang didapat
`points_used`	Number	Tidak	`0`	Poin loyalty yang dipakai
`cashier_id`	UUID	Tidak	—	ID karyawan kasir
`cashier_name`	String	Tidak	—	Nama kasir
`assigned_to_id`	UUID	Tidak	—	ID staff yang ditugaskan
`assigned_to_name`	String	Tidak	—	Nama staff yang ditugaskan
`notes`	String	Tidak	—	Catatan transaksi
`source`	Enum	Tidak	`pos`	Sumber transaksi
`order_status`	Enum	Tidak	`pending`	Status order
`status`	Enum	Tidak	`completed`	Status transaksi
`tracking_number`	String	Tidak	—	Nomor resi pengiriman
`shipping_address`	String	Tidak	—	Alamat pengiriman
`sales_channel`	Enum	Tidak	`offline_pos`	Kanal penjualan ternormalisasi
`metadata`	Object	Tidak	—	Data tambahan (info order online, dll)
`verified_at`	DateTime	Tidak	—	Waktu verifikasi transaksi
`verified_by`	String	Tidak	—	User yang memverifikasi
`processed_at`	DateTime	Tidak	—	Waktu diproses
`shipped_at`	DateTime	Tidak	—	Waktu dikirim
`delivered_at`	DateTime	Tidak	—	Waktu diterima
`cancelled_at`	DateTime	Tidak	—	Waktu dibatalkan

Struktur items[] (CompanyPOSTransaction):

Sub-Field	Tipe	Default	Deskripsi
`product_id`	String	—	ID produk
`product_name`	String	—	Nama produk
`sku`	String	—	SKU produk
`quantity`	Number	—	Jumlah
`price`	Number	—	Harga satuan
`discount`	Number	`0`	Diskon per item
`subtotal`	Number	—	Subtotal per item
`unit`	String	—	Satuan (pcs, kg, dll)
`unit_cost`	Number	—	Harga modal per unit
`total_cost`	Number	—	Total modal (unit_cost x quantity)
`note`	String	—	Catatan per-baris dari kasir

Struktur payments[] (Split Payment):

Sub-Field	Tipe	Default	Deskripsi
`method`	String	—	Metode pembayaran tender ini
`amount`	Number	—	Nominal pembayaran tender ini
`change_amount`	Number	`0`	Kembalian untuk tender ini
`account_id`	String	—	ID akun (untuk transfer)
`reference`	String	—	Nomor referensi
`verified_by`	String	—	User yang verifikasi tender ini
`verified_at`	DateTime	—	Waktu verifikasi

CompanyPOSProduct — Produk POS & Inventory

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`company_id`	UUID	Ya	—	ID perusahaan
`name`	String	Ya	—	Nama produk
`sku`	String	Tidak	—	SKU/Barcode produk
`category`	String	Tidak	—	Kategori produk
`category_key`	String	Tidak	—	Kategori canonical (kecil, besar, pouch, bundle, snack)
`category_name`	String	Tidak	—	Label kategori canonical
`variant_key`	String	Tidak	—	Varian canonical (original, extra_spicy, bundle)
`variant_name`	String	Tidak	—	Label varian canonical
`variant_label`	String	Tidak	—	Gabungan kategori dan varian untuk POS/inventory/manufacturing
`size_grams`	Number	Tidak	—	Ukuran canonical produk dalam gram
`base_product_key`	String	Tidak	—	Kunci produk utama sebelum kategori/varian
`description`	String	Tidak	—	Deskripsi produk
`price`	Number	Ya	—	Harga jual
`cost`	Number	Tidak	—	Harga modal/beli
`stock`	Number	Tidak	`0`	Stok saat ini
`min_stock`	Number	Tidak	`5`	Minimum stok untuk alert
`image_url`	String	Tidak	—	URL gambar utama produk
`gallery`	Array[String]	Tidak	—	Galeri foto produk (maks 20 foto)
`variants`	Array[Object]	Tidak	—	Varian produk (ukuran, warna, dll)
`is_active`	Boolean	Tidak	`true`	Status keaktifan produk
`deactivated_at`	DateTime	Tidak	—	Waktu SKU dinonaktifkan (tanpa hapus histori)
`deactivated_by`	String	Tidak	—	Akun yang menonaktifkan SKU (audit)
`tax_rate`	Number	Tidak	`0`	Persentase pajak (0-100)
`supplier`	String	Tidak	—	Nama supplier
`unit`	String	Tidak	`pcs`	Satuan produk
`variant`	String	Tidak	—	Varian produk (Pedas, Manis, Gurih, dll)
`barcode`	String	Tidak	—	Barcode/QR Code produk (EAN-13)
`product_type`	Enum	Tidak	`finished_good`	Tipe produk fisik atau paket virtual
`packaging_type`	Enum	Tidak	—	Jenis kemasan produk
`net_weight_grams`	Number	Tidak	—	Berat bersih isi produk dalam gram
`gross_weight_grams`	Number	Tidak	—	Berat kotor termasuk kemasan dalam gram
`storage_condition`	Enum	Tidak	`room_temperature`	Kondisi penyimpanan
`is_bundle`	Boolean	Tidak	`false`	Menandakan paket bundle virtual
`bundle_components`	Array[Object]	Tidak	—	Komponen SKU penyusun paket bundle
`channel_pricing`	Object	Tidak	—	Harga khusus per saluran penjualan
`is_locked`	Boolean	Tidak	`false`	Data terkunci karena sudah ada transaksi
`locked_at`	DateTime	Tidak	—	Waktu penguncian data
`locked_by`	String	Tidak	—	Email user yang mengunci data
`lock_reason`	String	Tidak	—	Alasan penguncian
`sold_count`	Number	Tidak	`0`	Total jumlah produk terjual

Struktur channel_pricing:

Kanal	Tipe	Deskripsi
`offline_pos`	Number	Harga untuk POS offline
`marketplace`	Number	Harga untuk marketplace
`website`	Number	Harga untuk website
`whatsapp`	Number	Harga untuk order WhatsApp
`reseller`	Number	Harga untuk reseller
`b2b`	Number	Harga untuk B2B
`grab`	Number	Harga untuk Grab
`social_media`	Number	Harga untuk media sosial

ShopSettings — Pengaturan Toko

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`setting_key`	String	Ya	—	Kunci pengaturan unik
`description`	String	Tidak	—	Penjelasan konfigurasi toko (maks 1000 karakter)
`banner_image_url`	String	Tidak	—	URL banner toko
`banner_title`	String	Tidak	—	Judul banner
`banner_subtitle`	String	Tidak	—	Subtitle banner
`featured_categories`	Array[String]	Tidak	—	Kategori yang ditampilkan di halaman utama
`promo_banner`	Object	Tidak	—	Konfigurasi banner promo
`reseller_discounts`	Object	Tidak	—	Diskon per tier membership

Struktur promo_banner:

Sub-Field	Tipe	Deskripsi
`active`	Boolean	Status aktif banner promo
`title`	String	Judul banner promo
`description`	String	Deskripsi promo
`discount_percentage`	Number	Persentase diskon promo
`valid_until`	DateTime	Berlaku hingga tanggal

Struktur reseller_discounts:

Tier	Default	Deskripsi
`free`	`0` (0%)	Tier gratis — tidak ada diskon
`pro`	`0.05` (5%)	Tier pro — diskon 5%
`business`	`0.10` (10%)	Tier bisnis — diskon 10%
`advanced`	`0.15` (15%)	Tier lanjutan — diskon 15%
`enterprise`	`0.20` (20%)	Tier enterprise — diskon 20%

ProductVoucher — Voucher Produk (Checkout)

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`code`	String	Ya	—	Kode voucher unik
`name`	String	Ya	—	Nama voucher
`description`	String	Tidak	—	Penjelasan detail voucher (maks 1000 karakter)
`discount_type`	Enum	Ya	—	Jenis potongan: `percentage` atau `fixed_amount`
`discount_value`	Number	Ya	—	Nilai discount (% atau Rp)
`min_purchase`	Number	Tidak	`0`	Minimum pembelian
`max_discount`	Number	Tidak	—	Maksimum potongan (untuk percentage)
`usage_limit`	Number	Tidak	—	Batas penggunaan (null = unlimited)
`usage_count`	Number	Tidak	`0`	Jumlah sudah dipakai
`valid_from`	DateTime	Ya	—	Tanggal mulai aktif
`valid_until`	DateTime	Ya	—	Tanggal berakhir
`applicable_products`	Array[String]	Tidak	—	ID produk yang berlaku (kosong = semua)
`applicable_categories`	Array[String]	Tidak	—	Kategori yang berlaku
`is_active`	Boolean	Tidak	`true`	Status aktif voucher

Voucher — Voucher Subscription/Plan

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`code`	String	Ya	—	Kode voucher unik
`name`	String	Ya	—	Nama voucher
`description`	String	Tidak	—	Penjelasan detail voucher (maks 1000 karakter)
`discount_type`	Enum	Ya	—	Jenis potongan: `percentage` atau `fixed_amount`
`discount_value`	Number	Ya	—	Nilai potongan (persentase 0-100 atau jumlah dalam rupiah)
`min_purchase`	Number	Tidak	`0`	Minimum pembelian
`max_discount`	Number	Tidak	—	Maksimum potongan (untuk jenis persentase)
`usage_limit`	Number	Tidak	—	Batas penggunaan (null = unlimited)
`usage_count`	Number	Tidak	`0`	Jumlah voucher sudah digunakan
`valid_from`	DateTime	Ya	—	Tanggal mulai aktif
`valid_until`	DateTime	Ya	—	Tanggal berakhir
`applicable_plans`	Array[Enum]	Tidak	—	Paket yang bisa menggunakan: `pro`, `business`, `advanced`, `enterprise`
`is_active`	Boolean	Tidak	`true`	Status aktif voucher
`created_by`	String	Tidak	—	Admin yang membuat voucher

VoucherUsage — Log Penggunaan Voucher

Field	Tipe	Wajib	Default	Deskripsi
`id`	UUID	Ya	auto	Primary key
`voucher_id`	UUID	Ya	—	ID voucher yang digunakan
`voucher_code`	String	Ya	—	Kode voucher
`user_id`	UUID	Ya	—	ID user yang menggunakan
`user_email`	String	Ya	—	Email user
`plan`	Enum	Ya	—	Paket yang dibeli: `pro`, `business`, `advanced`, `enterprise`
`original_price`	Number	Ya	—	Harga asli sebelum discount
`discount_amount`	Number	Ya	—	Jumlah potongan yang diberikan
`final_price`	Number	Ya	—	Harga final setelah discount
`description`	String	Tidak	—	Catatan tambahan (maks 1000 karakter)
`billing_period`	Enum	Tidak	—	Periode pembayaran: `monthly`, `yearly`

Diagram State — Siklus Hidup Order

State: ProductOrder (Produk Digital Official)

State: MarketplaceOrder (Pesanan Marketplace Third-Party)

State: CompanyPOSTransaction (Transaksi POS & Mirror)

State: ProductVoucher (Siklus Hidup Voucher)

Diagram Sequence — Flow Pembayaran & Verifikasi

Flow Add to Cart

Flow Checkout Multi-Seller dengan Split Payment

Flow Verifikasi Pembayaran Manual Transfer

Flow Commission Calculation & Payout

Flow Pricing Calculation (Checkout)

Tabel Enum — Nilai yang Diizinkan

Enum: ProductOrder.status

Nilai	Label (ID)	Deskripsi
`pending`	Menunggu Pembayaran	Order baru dibuat, belum ada pembayaran
`processing`	Sedang Diproses	Pembayaran diterima, admin sedang mengerjakan
`completed`	Selesai	Order selesai, result file tersedia
`cancelled`	Dibatalkan	Order dibatalkan oleh customer atau admin

Enum: MarketplaceOrder.status

Nilai	Label (ID)	Deskripsi
`pending`	Menunggu Pembayaran	Order baru dibuat dari checkout multi-seller
`processing`	Sedang Diproses	Pembayaran terverifikasi, seller mempersiapkan
`shipped`	Dikirim	Seller sudah mengirim + input nomor resi
`delivered`	Diterima	Customer konfirmasi barang diterima
`cancelled`	Dibatalkan	Order dibatalkan sebelum selesai

Enum: MarketplaceOrder.payment_status

Nilai	Label (ID)	Deskripsi
`pending`	Menunggu Pembayaran	Pembayaran belum diterima
`paid`	Dibayar	Pembayaran berhasil diverifikasi
`refunded`	Dikembalikan	Dana dikembalikan ke customer

Enum: CompanyPOSTransaction.payment_method

Nilai	Label (ID)	Deskripsi
`cash`	Tunai	Pembayaran tunai langsung di POS
`card`	Kartu	Kartu kredit/debit
`transfer`	Transfer Bank	Transfer bank manual
`ewallet`	E-Wallet	GoPay, OVO, DANA, dll
`qris`	QRIS	Scan QRIS
`saldo`	Saldo	Saldo wallet SNISHOP
`mayar`	Mayar	Payment gateway Mayar
`debt`	Hutang	Transaksi hutang/piutang
`manual_transfer`	Transfer Manual	Transfer manual dengan verifikasi admin
`midtrans`	Midtrans	Payment gateway Midtrans
`tripay`	Tripay	Payment gateway Tripay
`stripe`	Stripe	Payment gateway Stripe
`paypal`	PayPal	Payment gateway PayPal

Enum: CompanyPOSTransaction.payment_status

Nilai	Label (ID)	Deskripsi
`pending`	Menunggu	Pembayaran belum diproses
`pending_verification`	Menunggu Verifikasi	Bukti transfer diupload, menunggu admin
`partially_paid`	Dibayar Sebagian	Pembayaran belum lengkap (split payment)
`paid`	Dibayar	Pembayaran lunas dan terverifikasi
`failed`	Gagal	Pembayaran gagal
`refunded`	Dikembalikan	Dana dikembalikan
`rejected`	Ditolak	Bukti transfer ditolak admin

Enum: CompanyPOSTransaction.source

Nilai	Label (ID)	Deskripsi
`pos`	POS Offline	Transaksi langsung di kasir
`online_catalog`	Katalog Online	Order dari katalog online
`website`	Website	Order dari website
`marketplace`	Marketplace	Order dari marketplace (Tokopedia, Shopee, dll)
`landing_page`	Landing Page	Order dari landing page
`whatsapp`	WhatsApp	Order via WhatsApp
`reseller`	Reseller	Order dari reseller
`b2b`	B2B	Order bisnis ke bisnis
`grab`	Grab	Order via GrabFood/GrabMart
`social_media`	Media Sosial	Order dari media sosial

Enum: CompanyPOSTransaction.sales_channel

Nilai	Label (ID)	Deskripsi
`offline_pos`	POS Offline	Kanal POS offline (default)
`offline`	Offline Lainnya	Kanal offline non-POS
`website`	Website	Kanal website
`online_catalog`	Katalog Online	Kanal katalog online
`marketplace`	Marketplace	Kanal marketplace
`landing_page`	Landing Page	Kanal landing page
`whatsapp`	WhatsApp	Kanal WhatsApp
`reseller`	Reseller	Kanal reseller
`b2b`	B2B	Kanal B2B
`grab`	Grab	Kanal Grab
`social_media`	Media Sosial	Kanal media sosial

Enum: CompanyPOSTransaction.order_status

Nilai	Label (ID)	Deskripsi
`pending`	Menunggu	Order baru masuk
`processing`	Diproses	Order sedang diproses
`shipped`	Dikirim	Order dalam pengiriman
`delivered`	Diterima	Order diterima customer
`completed`	Selesai	Order selesai
`cancelled`	Dibatalkan	Order dibatalkan
`rejected`	Ditolak	Order ditolak

Enum: CompanyPOSTransaction.status

Nilai	Label (ID)	Deskripsi
`pending`	Menunggu	Transaksi menunggu
`processing`	Diproses	Transaksi sedang diproses
`shipped`	Dikirim	Barang dikirim
`delivered`	Diterima	Barang diterima
`completed`	Selesai	Transaksi selesai
`failed`	Gagal	Transaksi gagal
`refunded`	Dikembalikan	Transaksi di-refund
`cancelled`	Dibatalkan	Transaksi dibatalkan

Enum: CompanyPOSProduct.product_type

Nilai	Label (ID)	Deskripsi
`finished_good`	Barang Jadi	Produk siap jual (default)
`raw_material`	Bahan Baku	Material untuk produksi
`semi_finished`	Setengah Jadi	Produk dalam proses produksi
`packaging_material`	Bahan Kemasan	Material kemasan (jar, pouch, toples, dll)
`bundle`	Paket Bundle	Paket virtual gabungan beberapa SKU

Enum: CompanyPOSProduct.packaging_type

Nilai	Label (ID)	Deskripsi
`jar_glass`	Toples Kaca	Kemasan toples kaca
`pouch_zipper`	Pouch Zipper	Kemasan pouch dengan zipper
`pouch_sealed`	Pouch Sealed	Kemasan pouch sealed/press
`toples_plastic`	Toples Plastik	Kemasan toples plastik
`bottle_plastic`	Botol Plastik	Kemasan botol plastik
`bulk`	Curah	Kemasan curah/bulk
`other`	Lainnya	Jenis kemasan lainnya

Enum: CompanyPOSProduct.storage_condition

Nilai	Label (ID)	Deskripsi
`room_temperature`	Suhu Ruang	Penyimpanan suhu ruang (default)
`chilled`	Dingin	Penyimpanan di suhu dingin/chiller
`frozen`	Beku	Penyimpanan di freezer

Enum: DigitalProduct.category

Nilai	Label (ID)	Deskripsi
`zoom`	Zoom Meeting	Jasa Zoom meeting (webinar, rapat, dll)
`design`	Desain Grafis	Jasa desain grafis (logo, banner, dll)
`video_editing`	Edit Video	Jasa editing video
`plagiarism_check`	Cek Plagiarisme	Jasa pemeriksaan plagiarisme
`other`	Lainnya	Produk digital lainnya

Enum: Voucher.discount_type / ProductVoucher.discount_type

Nilai	Label (ID)	Deskripsi
`percentage`	Persentase	Potongan berdasarkan persentase (0-100%)
`fixed_amount`	Nominal Tetap	Potongan berdasarkan nominal tetap (dalam rupiah)

Enum: VoucherUsage.plan

Nilai	Label (ID)	Deskripsi
`pro`	Pro	Paket Pro
`business`	Business	Paket Business
`advanced`	Advanced	Paket Advanced
`enterprise`	Enterprise	Paket Enterprise

Enum: VoucherUsage.billing_period

Nilai	Label (ID)	Deskripsi
`monthly`	Bulanan	Periode pembayaran bulanan
`yearly`	Tahunan	Periode pembayaran tahunan

Tabel RBAC — Hak Akses per Role

Entity	Operasi	Admin	Staff/POS	Customer	Deskripsi Akses
MarketplaceCart	Create	Ya	Ya	Ya (milik sendiri)	Semua user bisa menambah item ke cart
MarketplaceCart	Read	Ya (semua)	Ya (milik sendiri)	Ya (milik sendiri)	Admin bisa lihat semua cart; user hanya cart sendiri
MarketplaceCart	Update	Ya	Ya (milik sendiri)	Ya (milik sendiri)	Update quantity, hapus item
MarketplaceCart	Delete	Ya	Ya (milik sendiri)	Ya (milik sendiri)	Hapus item dari cart
ProductOrder	Create	Ya	Ya	Ya (checkout sendiri)	Order dibuat saat checkout
ProductOrder	Read	Ya (semua)	Ya (assigned)	Ya (milik sendiri)	Admin lihat semua; customer hanya order sendiri
ProductOrder	Update	Ya (status, admin_notes, result_files)	Ya (assigned_at, status)	Tidak	Admin kelola status & upload file; customer tidak bisa update
ProductOrder	Delete	Ya	Tidak	Tidak	Hanya admin yang bisa hapus order
MarketplaceOrder	Create	Ya	Ya	Ya (checkout sendiri)	Order dibuat saat checkout multi-seller
MarketplaceOrder	Read	Ya (semua)	Ya (company scope)	Ya (milik sendiri)	Admin lihat semua; seller lihat order di company-nya
MarketplaceOrder	Update	Ya (semua field)	Ya (status, tracking)	Tidak	Admin kelola penuh; seller update status & resi
MarketplaceOrder	Delete	Ya	Tidak	Tidak	Hanya admin yang bisa hapus
MarketplaceCommissionSettings	Create	Ya	Tidak	Tidak	Hanya admin yang bisa buat pengaturan komisi
MarketplaceCommissionSettings	Read	Ya	Ya (read-only)	Tidak	Admin dan staff bisa lihat; customer tidak punya akses
MarketplaceCommissionSettings	Update	Ya	Tidak	Tidak	Hanya admin yang bisa ubah rate komisi
MarketplaceCommissionSettings	Delete	Ya	Tidak	Tidak	Hanya admin yang bisa hapus
CompanyPOSTransaction	Create	Ya	Ya (company scope)	Tidak	Admin dan staff POS bisa buat transaksi
CompanyPOSTransaction	Read	Ya (semua)	Ya (company scope)	Tidak	Admin lihat semua; staff hanya dalam company-nya
CompanyPOSTransaction	Update	Ya (semua field)	Ya (company scope, terbatas)	Tidak	Admin kelola penuh; staff update terbatas
CompanyPOSTransaction	Delete	Ya	Tidak	Tidak	Hanya admin yang bisa hapus transaksi
CompanyPOSProduct	Create	Ya	Ya (company scope)	Tidak	Admin dan staff bisa tambah produk
CompanyPOSProduct	Read	Ya (semua)	Ya (company scope)	Ya (produk aktif saja)	Admin/staff lihat semua; customer hanya produk aktif
CompanyPOSProduct	Update	Ya (semua field)	Ya (company scope)	Tidak	Admin kelola penuh; staff update terbatas
CompanyPOSProduct	Delete	Ya (soft delete)	Tidak	Tidak	Hanya admin; produk dinonaktifkan bukan dihapus
ShopSettings	Create	Ya	Tidak	Tidak	Hanya admin yang bisa buat pengaturan toko
ShopSettings	Read	Ya	Ya	Ya (public settings)	Semua role bisa baca; customer hanya setting publik
ShopSettings	Update	Ya	Tidak	Tidak	Hanya admin yang bisa ubah pengaturan toko
ShopSettings	Delete	Ya	Tidak	Tidak	Hanya admin yang bisa hapus
ProductVoucher	Create	Ya	Tidak	Tidak	Hanya admin yang bisa buat voucher produk
ProductVoucher	Read	Ya	Ya	Ya (saat checkout)	Admin/staff lihat semua; customer pakai saat checkout
ProductVoucher	Update	Ya	Tidak	Tidak	Hanya admin yang bisa ubah voucher
ProductVoucher	Delete	Ya	Tidak	Tidak	Hanya admin yang bisa hapus voucher
Voucher	Create	Ya	Tidak	Tidak	Hanya admin yang bisa buat voucher subscription
Voucher	Read	Ya	Ya	Tidak	Admin dan staff bisa lihat voucher
Voucher	Update	Ya	Tidak	Tidak	Hanya admin yang bisa ubah voucher
Voucher	Delete	Ya	Tidak	Tidak	Hanya admin yang bisa hapus voucher
VoucherUsage	Create	Otomatis (saat apply voucher)	—	Otomatis	Tercatat otomatis saat customer menggunakan voucher
VoucherUsage	Read	Ya (semua)	Tidak	Ya (milik sendiri)	Admin lihat semua log; customer hanya log sendiri
DigitalProduct	Create	Ya	Tidak	Tidak	Hanya admin yang bisa buat produk digital
DigitalProduct	Read	Ya (semua)	Ya	Ya (produk aktif)	Admin/staff lihat semua; customer hanya produk aktif
DigitalProduct	Update	Ya	Tidak	Tidak	Hanya admin yang bisa ubah produk digital
DigitalProduct	Delete	Ya (soft delete)	Tidak	Tidak	Hanya admin; produk dinonaktifkan bukan dihapus

Matriks Hubungan Entity

Entity A	Relasi	Entity B	Kardinalitas	Keterangan
MarketplaceCart	product_id →	CompanyPOSProduct	Many-to-One	Banyak cart item bisa merujuk ke satu produk
MarketplaceCart	user_id →	User	Many-to-One	Banyak cart item milik satu user
ProductOrder	product_id →	DigitalProduct	Many-to-One	Banyak order untuk satu produk digital
ProductOrder	parent_order_id →	ProductOrder	Self-referencing	Sub-order merujuk ke order induk
ProductOrder	voucher_code →	ProductVoucher	Many-to-One	Banyak order bisa pakai voucher yang sama
MarketplaceOrder	company_id →	Company	Many-to-One	Banyak order dari satu seller company
MarketplaceOrder	items[] →	CompanyPOSProduct	Many-to-Many	Order marketplace berisi banyak produk
MarketplaceOrder	commission_rate ←	MarketplaceCommissionSettings	Many-to-One	Rate komisi dari settings aktif
CompanyPOSTransaction	items[] →	CompanyPOSProduct	Many-to-Many	Transaksi POS berisi banyak produk
CompanyPOSTransaction	mirror ←	MarketplaceOrder	One-to-One	Mirror transaksi dari order online
CompanyPOSTransaction	mirror ←	ProductOrder	One-to-One	Mirror transaksi dari order official
VoucherUsage	voucher_id →	Voucher	Many-to-One	Banyak penggunaan untuk satu voucher
VoucherUsage	voucher_id →	ProductVoucher	Many-to-One	Banyak penggunaan untuk satu product voucher
ShopSettings	reseller_discounts →	ProductOrder	One-to-Many	Settings diskon berlaku untuk banyak order

Penanganan Error & Edge Cases

Skenario	Penanganan	Deskripsi
Saldo tidak cukup	Error message	Tampilkan “Saldo tidak mencukupi” dan arahkan ke top-up
Voucher expired	Reject voucher	Voucher ditolak, customer harus input kode lain
Voucher usage_limit habis	Reject voucher	Voucher sudah mencapai batas penggunaan
Produk nonaktif saat checkout	Remove from cart	Item dihapus otomatis, notifikasi ke customer
Stok habis (POS Product)	Disable add to cart	Tombol “Add to Cart” dinonaktifkan saat stock = 0
Commission settings tidak aktif	Fallback rate = 0	Jika tidak ada settings aktif, commission = 0
BroadcastChannel tidak tersedia	Fallback ke polling	Jika browser tidak support BroadcastChannel
Payment gateway timeout	Retry / cancel	Order tetap pending, customer bisa retry pembayaran
Cross-company cart leak	Filter by context	`filterCartItemsForContext()` mencegah kebocoran data
Duplicate order (double-click)	Idempotency check	Cegah pembuatan order duplikat
Quota habis (quota-based)	Block usage	Tidak bisa gunakan order jika `quota_remaining = 0`

​title: “Cart & Checkout” description: “Keranjang belanja multi-seller, checkout, payment gateway, POS mirror, voucher & diskon, dan order splitting di SNISHOP ERP.”

​Cart & Checkout

​Ringkasan Eksekutif

​Kapabilitas Utama

​Arsitektur Komponen

​Diagram Alur Data End-to-End

​Entity & Model

​MarketplaceCart

​ProductOrder (Official Items)

​MarketplaceOrder (Third-Party Items)

​CompanyPOSTransaction (POS Mirror)

​Fitur Utama

​1. Multi-Seller Checkout

​2. Order Splitting Logic

​3. Payment Methods

​4. Company Context Filtering

​5. POS Mirror & Broadcast

​6. Commission Calculation

​7. Voucher & Diskon System

​8. Cart Management

​9. Order Status Tracking

​10. Quota-Based Products

​Security Policies

​Browser-Side Restrictions

​Kebijakan Keamanan RLS (Row-Level Security)

​MyOrders (Order History)

​Cara Akses

​Flow Penggunaan

​Customer

​Admin

​Integrasi Cross-Module

​Tips

​Referensi Entity Schema (base44)

​Diagram Relasi Entity (erDiagram)

​Tabel Schema Detail Entity

​MarketplaceCart — Keranjang Belanja Marketplace

​DigitalProduct — Produk Digital (Official)

​ProductOrder — Pesanan Produk Digital (Official)

​MarketplaceOrder — Pesanan Marketplace (Third-Party Seller)

​MarketplaceCommissionSettings — Pengaturan Komisi Marketplace

​CompanyPOSTransaction — Transaksi POS (Mirror & Direct)

​CompanyPOSProduct — Produk POS & Inventory

​ShopSettings — Pengaturan Toko

​ProductVoucher — Voucher Produk (Checkout)

​Voucher — Voucher Subscription/Plan

​VoucherUsage — Log Penggunaan Voucher

​Diagram State — Siklus Hidup Order

​State: ProductOrder (Produk Digital Official)

​State: MarketplaceOrder (Pesanan Marketplace Third-Party)

​State: CompanyPOSTransaction (Transaksi POS & Mirror)

​State: ProductVoucher (Siklus Hidup Voucher)

​Diagram Sequence — Flow Pembayaran & Verifikasi

​Flow Add to Cart

​Flow Checkout Multi-Seller dengan Split Payment

​Flow Verifikasi Pembayaran Manual Transfer

​Flow Commission Calculation & Payout

​Flow Pricing Calculation (Checkout)

​Tabel Enum — Nilai yang Diizinkan

​Enum: ProductOrder.status

​Enum: MarketplaceOrder.status

​Enum: MarketplaceOrder.payment_status

​Enum: CompanyPOSTransaction.payment_method

​Enum: CompanyPOSTransaction.payment_status

​Enum: CompanyPOSTransaction.source

​Enum: CompanyPOSTransaction.sales_channel

​Enum: CompanyPOSTransaction.order_status

​Enum: CompanyPOSTransaction.status

​Enum: CompanyPOSProduct.product_type

​Enum: CompanyPOSProduct.packaging_type

​Enum: CompanyPOSProduct.storage_condition

​Enum: DigitalProduct.category

​Enum: Voucher.discount_type / ProductVoucher.discount_type

​Enum: VoucherUsage.plan

​Enum: VoucherUsage.billing_period

​Tabel RBAC — Hak Akses per Role

​Matriks Hubungan Entity

​Penanganan Error & Edge Cases