title: “Order Management” description: “Manajemen order multi-channel terpusat — OrderManagement.jsx (614 baris), ProductOrder + MarketplaceOrder, batch processing, WhatsApp notification, dan timeline tracking.”

Order Management

Order Management (OrderManagement.jsx — 614 baris) adalah halaman terpusat untuk mengelola semua pesanan yang masuk dari berbagai channel penjualan. Halaman ini menggabungkan data dari dua entitas order — ProductOrder (pesanan internal dari website/WhatsApp) dan MarketplaceOrder (pesanan dari Shopee, Tokopedia, dll) — ke dalam satu tampilan tabel yang bisa di-filter, di-search, dan di-batch update. Dengan Order Management, kamu bisa melacak status setiap pesanan dari awal masuk hingga selesai dikirim ke pelanggan, tanpa perlu berpindah platform. Setiap perubahan status bisa memicu notifikasi WhatsApp otomatis ke pelanggan.

Arsitektur Komponen

Dual-Entity Order Model

Aspek	ProductOrder	MarketplaceOrder
Sumber	Website `/toko`, WhatsApp, manual input	Shopee, Tokopedia, Lazada
Payment	Upload bukti bayar manual	Auto-confirmed by marketplace
Fulfillment	Admin proses sendiri	Admin proses + input tracking
Status	6 states (lihat di bawah)	4 states (menunggu → dikirim → selesai)
Fields	20+ fields	15+ fields
Notification	WhatsApp auto-send	Marketplace API sync
Cancellation	Admin atau customer	Marketplace-dependent

Alur Order Multi-Channel

Fitur Utama

Fitur	Deskripsi	Implementasi
Unified View	Semua order dari seluruh channel dalam satu tabel	Merge ProductOrder + MarketplaceOrder
Multi-Filter	Filter berdasarkan status, channel, tanggal, outlet	Client-side filtering
Status Update	Update status pesanan secara langsung	Server function `updateOrderStatus`
Detail Lengkap	Item, alamat, info pelanggan, catatan khusus	Modal detail dengan tabs
Timeline Tracking	Tracking pesanan dengan timeline visual	Status history array
Search	Pencarian berdasarkan invoice, nama, atau ID	Debounced text search
Batch Update	Centang beberapa order → ubah status bersamaan	Multi-select + bulk API call
WhatsApp Notification	Notifikasi otomatis ke pelanggan saat status berubah	WhatsApp gateway integration
Metrics Cards	Total order, revenue, completion rate, avg processing time	Real-time aggregation

Status Order & Timeline

Status	Ikon	Deskripsi	Notifikasi	Aksi
Menunggu Pembayaran	⏳	Order dibuat, belum dibayar	Reminder ke customer	Konfirmasi bayar, Batalkan
Diverifikasi	✅	Pembayaran sudah diverifikasi	Konfirmasi ke customer	Mulai proses
Diproses	📦	Sedang dikemas/disiapkan	Update status	Input tracking, Kirim
Dikirim	🚚	Barang dalam pengiriman	Tracking number	Tandai selesai
Selesai	✔️	Pesanan diterima customer	Request review	—
Dibatalkan	❌	Order dibatalkan	Konfirmasi pembatalan	—

Cara Akses

Metode	Detail
URL	`/companypos` (tab Order Management)
Sidebar	Menu POS → Order Management

Flow Penggunaan

Filter & Pencarian

Filter	Opsi	Deskripsi
Status	Menunggu Pembayaran, Diverifikasi, Diproses, Dikirim, Selesai, Dibatalkan	Filter per status
Channel	Offline, Marketplace, Website, WhatsApp, Reseller, B2B, Grab, Social Media	Filter per sumber
Tanggal	Hari ini, Kemarin, 7 hari terakhir, 30 hari terakhir, Custom range	Date range picker
Outlet	Semua outlet, atau pilih outlet spesifik	Filter per lokasi
Customer	Cari berdasarkan nama atau nomor telepon	Text search

Order dari Website

Order dari WhatsApp

Langkah	Aksi	Status	Notifikasi
1	Customer chat WhatsApp	—	—
2	CS input order manual ke sistem	Menunggu Pembayaran	Auto-reply: “Order diterima”
3	Customer kirim bukti bayar	Diverifikasi	—
4	Admin verifikasi pembayaran	Diproses	WhatsApp: “Pembayaran dikonfirmasi”
5	Admin proses & input tracking	Dikirim	WhatsApp: “Pesanan dikirim + resi”
6	Customer konfirmasi terima	Selesai	WhatsApp: “Terima kasih!”

Batch Processing

Metrik Order

Metrik	Deskripsi	Sumber
Total Order	Jumlah total order dalam periode	`COUNT(*)`
Total Revenue	Total pendapatan dari semua order	`SUM(total_amount)`
Average Order Value	Rata-rata nilai per order	`AVG(total_amount)`
Completion Rate	Persentase order yang selesai	`completed / total × 100`
Avg Processing Time	Rata-rata waktu dari order masuk hingga kirim	`AVG(shipped_at - created_at)`
Pending Count	Jumlah order yang belum diproses	`WHERE status IN ('menunggu', 'diverifikasi')`

Tips

Cek halaman ini secara berkala sepanjang hari agar tidak ada pesanan yang terlewat atau terlambat diproses
Manfaatkan filter channel untuk menganalisis dari mana sebagian besar pesanan berasal dan fokus pada channel paling produktif
Gunakan batch update saat volume tinggi — centang semua order yang sudah dikemas lalu ubah status ke “Dikirim” sekaligus
Perhatikan timeline setiap order untuk mengidentifikasi bottleneck dalam pemrosesan
Set reminder untuk order yang sudah terlalu lama di status tertentu (> 24 jam di “Diproses” perlu investigasi)
Monitor completion rate — jika di bawah 90%, ada masalah di pipeline fulfillment

Entity Schema — Order Management

Berikut adalah dokumentasi schema entitas yang mendasari fitur Order Management pada POS QUINNOFSPICY.

Entity Relationship Diagram

Tabel Schema — CompanyPOSTransaction

Entitas utama untuk setiap transaksi POS (kasir), mencakup pesanan offline maupun online yang diproses melalui sistem POS.

Field	Tipe	Required	Default	Deskripsi
`company_id`	`string`	✅	—	ID perusahaan (multi-tenant)
`location_id`	`string`	—	—	ID lokasi gudang/toko
`location_name`	`string`	—	—	Nama lokasi transaksi
`transaction_number`	`string`	✅	—	Nomor transaksi unik (auto-generated)
`invoice_number`	`string`	—	—	Nomor invoice untuk cetak
`transaction_date`	`date-time`	—	—	Tanggal dan waktu transaksi
`items`	`array<Item>`	✅	—	Daftar produk yang dibeli
`subtotal`	`number`	—	—	Subtotal sebelum diskon & pajak
`discount_amount`	`number`	—	`0`	Nominal diskon
`discount_percentage`	`number`	—	`0`	Persentase diskon (0–100)
`tax_amount`	`number`	—	`0`	PPN (inclusive atau exclusive)
`total`	`number`	✅	—	Total akhir transaksi
`total_amount`	`number`	—	—	Total akhir (alias untuk `total`)
`payment_method`	`enum`	—	—	Metode pembayaran (lihat Enum)
`payment_amount`	`number`	—	—	Jumlah uang yang dibayar
`payments`	`array<Payment>`	—	—	Detail split payment (multi-tender)
`payment_status`	`enum`	—	`pending`	Status pembayaran
`paid_amount`	`number`	—	`0`	Nominal pembayaran terverifikasi
`remaining_amount`	`number`	—	`0`	Sisa kekurangan tagihan
`excess_amount`	`number`	—	`0`	Kelebihan nominal transfer
`change_amount`	`number`	—	`0`	Kembalian
`payment_reference`	`string`	—	—	No. referensi bukti transfer/QRIS
`payment_verified_by`	`string`	—	—	Nama verifier pembayaran
`payment_verified_at`	`date-time`	—	—	Waktu verifikasi pembayaran
`customer_id`	`string`	—	—	ID member/pelanggan (jika ada)
`customer_name`	`string`	—	—	Nama pelanggan
`customer_phone`	`string`	—	—	Nomor telepon pelanggan
`customer_address`	`string`	—	—	Alamat pelanggan
`points_earned`	`number`	—	`0`	Poin loyalitas yang didapat
`points_used`	`number`	—	`0`	Poin loyalitas yang dipakai
`cashier_id`	`string`	—	—	ID kasir yang memproses
`cashier_name`	`string`	—	—	Nama kasir
`assigned_to_id`	`string`	—	—	ID staf yang ditugaskan
`assigned_to_name`	`string`	—	—	Nama staf yang ditugaskan
`notes`	`string`	—	—	Catatan transaksi
`source`	`enum`	—	`pos`	Sumber transaksi asli
`order_status`	`enum`	—	`pending`	Status pemrosesan order
`status`	`enum`	—	`completed`	Status transaksi (lifecycle penuh)
`tracking_number`	`string`	—	—	Nomor resi pengiriman
`shipping_address`	`string`	—	—	Alamat pengiriman
`sales_channel`	`enum`	—	`offline_pos`	Kanal penjualan ternormalisasi
`metadata`	`object`	—	—	Data tambahan (info online order, dll)
`verified_at`	`date-time`	—	—	Waktu order diverifikasi
`verified_by`	`string`	—	—	Akun yang memverifikasi
`processed_at`	`date-time`	—	—	Waktu order mulai diproses
`shipped_at`	`date-time`	—	—	Waktu order dikirim
`delivered_at`	`date-time`	—	—	Waktu order diterima
`cancelled_at`	`date-time`	—	—	Waktu order dibatalkan

Tabel Schema — QuinnOrder

Entitas order dari Quinn Storefront (website publik), terhubung ke CompanyPOSTransaction melalui pos_transaction_id untuk integrasi ERP dan laporan keuangan.

Field	Tipe	Required	Default	Deskripsi
`company_id`	`string`	—	—	ID perusahaan (auto-linked dari storefront)
`checkout_request_id`	`string`	—	—	Idempotency key dari checkout publik
`pos_transaction_id`	`string`	—	—	ID `CompanyPOSTransaction` terkait (mirror ERP)
`order_number`	`string`	—	—	Nomor pesanan unik untuk pelanggan
`customer_name`	`string`	✅	—	Nama lengkap pelanggan
`customer_phone`	`string`	✅	—	Nomor WhatsApp pelanggan
`customer_email`	`string`	—	—	Email pelanggan
`shipping_address`	`string`	✅	—	Alamat lengkap pengiriman
`city`	`string`	—	—	Kota tujuan pengiriman
`notes`	`string`	—	—	Catatan tambahan dari pelanggan
`items`	`array<QuinnItem>`	✅	—	Daftar produk yang dipesan
`subtotal`	`number`	—	`0`	Total harga produk sebelum ongkir
`shipping_cost`	`number`	—	`0`	Biaya pengiriman
`total`	`number`	✅	`0`	Total akhir yang harus dibayar
`payment_method`	`enum`	—	`whatsapp`	Metode pembayaran pilihan pelanggan
`status`	`enum`	—	`pending`	Status pesanan (lifecycle utama)
`customer_id`	`string`	—	—	ID Customer di CRM
`auth_user_id`	`string`	—	—	ID akun auth pemilik pesanan
`sales_channel`	`string`	—	`website`	Kanal penjualan
`shipping_address_snapshot`	`object`	—	—	Snapshot alamat pengiriman saat order dibuat
`payment_proof_url`	`string`	—	—	URL gambar bukti transfer
`payment_proof_uploaded_at`	`string`	—	—	Waktu upload bukti pembayaran
`payment_status`	`enum`	—	`unpaid`	Status pembayaran terverifikasi
`fulfillment_status`	`enum`	—	`unprocessed`	Status pemenuhan barang fisik
`reservation_status`	`enum`	—	`active`	Status reservasi stok inventori
`paid_amount`	`number`	—	`0`	Nominal pembayaran terverifikasi sah
`remaining_amount`	`number`	—	`0`	Sisa tagihan belum dibayar
`excess_amount`	`number`	—	`0`	Kelebihan transfer untuk review kredit/refund
`rejection_reason`	`string`	—	—	Alasan penolakan bukti pembayaran
`payment_proofs`	`array<PaymentProof>`	—	—	Histori semua bukti transfer yang diunggah
`status_history`	`array<StatusEntry>`	—	—	Histori riwayat perubahan status

Sub-Schema — `items[]` (CompanyPOSTransaction)

Setiap elemen dalam array items pada CompanyPOSTransaction merepresentasikan satu baris produk yang dibeli.

Field	Tipe	Deskripsi
`product_id`	`string`	ID produk di `CompanyPOSProduct`
`product_name`	`string`	Nama produk (snapshot saat transaksi)
`sku`	`string`	SKU/barcode produk
`quantity`	`number`	Jumlah yang dibeli
`price`	`number`	Harga satuan saat transaksi
`discount`	`number`	Diskon per-baris (default: 0)
`subtotal`	`number`	Subtotal baris (qty × price − discount)
`unit`	`string`	Satuan produk (pcs, gram, dll)
`unit_cost`	`number`	HPP per satuan (untuk kalkulasi laba)
`total_cost`	`number`	Total HPP (unit_cost × quantity)
`note`	`string`	Catatan per-baris dari kasir (opsional)

Sub-Schema — `items[]` (QuinnOrder)

Setiap elemen dalam array items pada QuinnOrder merepresentasikan satu produk yang dipesan melalui storefront.

Field	Tipe	Deskripsi
`sku`	`string`	SKU produk
`name`	`string`	Nama produk
`size`	`string`	Ukuran/variant yang dipilih
`price`	`number`	Harga satuan
`quantity`	`number`	Jumlah yang dipesan
`subtotal`	`number`	Subtotal baris (price × quantity)

Sub-Schema — `payments[]` (Split Payment)

Field	Tipe	Deskripsi
`method`	`string`	Metode pembayaran (cash, card, transfer, dll)
`amount`	`number`	Nominal yang dibayar via metode ini
`change_amount`	`number`	Kembalian untuk metode ini (default: 0)
`account_id`	`string`	ID akun kas/bank tujuan
`reference`	`string`	Nomor referensi transfer
`verified_by`	`string`	Akun yang memverifikasi
`verified_at`	`date-time`	Waktu verifikasi

Sub-Schema — `payment_proofs[]` (QuinnOrder)

Field	Tipe	Deskripsi
`id`	`string`	ID unik bukti transfer
`proof_url`	`string`	URL gambar bukti transfer
`claimed_amount`	`number`	Nominal yang diklaim pelanggan
`transfer_date`	`string`	Tanggal transfer
`destination_bank`	`string`	Bank tujuan transfer
`notes`	`string`	Catatan tambahan
`uploaded_at`	`string`	Waktu upload
`status`	`enum`	Status verifikasi (`pending`, `accepted`, `rejected`)
`verified_at`	`string`	Waktu verifikasi
`verified_by`	`string`	Akun verifier
`bank_reference`	`string`	Referensi bank
`rejection_reason`	`string`	Alasan penolakan (jika `rejected`)

Sub-Schema — `status_history[]` (QuinnOrder)

Field	Tipe	Deskripsi
`status`	`string`	Status baru yang dimasuki
`timestamp`	`string`	Waktu perubahan status
`actor`	`string`	Akun yang mengubah status
`notes`	`string`	Catatan perubahan (opsional)

State Machine — Order Status Lifecycle

CompanyPOSTransaction — `order_status`

QuinnOrder — `status`

QuinnOrder — `fulfillment_status`

QuinnOrder — `payment_status`

QuinnOrder — `reservation_status`

Sequence Diagrams

1. Pembuatan Order dari POS (Kasir)

2. Pembuatan Order dari Quinn Storefront

3. Kitchen Display — Order Masuk Dapur

4. Modifikasi Order (Update Status & Verifikasi Pembayaran)

Enum Tables

`order_status` (CompanyPOSTransaction)

Status pemrosesan order pada CompanyPOSTransaction. Mengontrol alur kerja dari order masuk hingga selesai.

Nilai	Deskripsi	Transisi Selanjutnya
`pending`	Order baru dibuat, belum diproses	`processing`, `cancelled`
`processing`	Sedang disiapkan/dikemas	`shipped`, `cancelled`, `rejected`
`shipped`	Barang diserahkan ke kurir	`delivered`
`delivered`	Barang diterima pelanggan	`completed`
`completed`	Order selesai (final)	—
`cancelled`	Order dibatalkan (final)	—
`rejected`	Order ditolak (mis. pembayaran gagal) (final)	—

`status` (CompanyPOSTransaction)

Status transaksi penuh (termasuk refund) pada CompanyPOSTransaction.

Nilai	Deskripsi
`pending`	Transaksi menunggu konfirmasi
`processing`	Transaksi sedang diproses
`shipped`	Barang sedang dikirim
`delivered`	Barang sudah diterima
`completed`	Transaksi selesai (final)
`failed`	Transaksi gagal
`refunded`	Dana dikembalikan ke pelanggan
`cancelled`	Transaksi dibatalkan

`status` (QuinnOrder)

Status pesanan pada QuinnOrder (lifecycle utama dari checkout hingga selesai).

Nilai	Deskripsi	Transisi Selanjutnya
`pending`	Order baru masuk dari storefront	`confirmed`, `cancelled`
`confirmed`	Pembayaran diverifikasi	`processing`, `cancelled`
`processing`	Sedang disiapkan	`shipped`
`shipped`	Dalam pengiriman	`completed`
`completed`	Selesai (final)	—
`cancelled`	Dibatalkan (final)	—

`payment_method` (CompanyPOSTransaction)

Nilai	Deskripsi
`cash`	Tunai (kasir)
`card`	Kartu debit/kredit
`transfer`	Transfer bank manual
`ewallet`	E-wallet (GoPay, OVO, Dana, dll)
`qris`	QRIS (scan QR pembayaran)
`saldo`	Saldo member/loyalty
`mayar`	Mayar payment gateway
`debt`	Hutang/piutang (tempo)
`manual_transfer`	Transfer manual (verifikasi manual)
`midtrans`	Midtrans payment gateway
`tripay`	Tripay payment gateway
`stripe`	Stripe payment gateway
`paypal`	PayPal

`payment_method` (QuinnOrder)

Nilai	Deskripsi
`transfer_bank`	Transfer bank (upload bukti)
`cod`	Bayar di tempat (Cash on Delivery)
`whatsapp`	Konfirmasi & bayar via WhatsApp

`payment_status` (CompanyPOSTransaction)

Nilai	Deskripsi
`pending`	Menunggu pembayaran
`pending_verification`	Bukti upload, menunggu verifikasi
`partially_paid`	Baru dibayar sebagian
`paid`	Lunas
`failed`	Pembayaran gagal
`refunded`	Dana dikembalikan
`rejected`	Bukti pembayaran ditolak

`payment_status` (QuinnOrder)

Nilai	Deskripsi
`unpaid`	Belum ada pembayaran
`pending_verification`	Bukti transfer diunggah, menunggu verifikasi
`partially_paid`	Pembayaran sebagian terverifikasi
`paid`	Pembayaran lunas terverifikasi
`rejected`	Bukti transfer ditolak
`refunded`	Dana dikembalikan

`fulfillment_status` (QuinnOrder)

Nilai	Deskripsi
`unprocessed`	Belum diproses
`processing`	Sedang disiapkan
`ready`	Siap dikirim/diambil
`shipped`	Dalam pengiriman
`delivered`	Diterima pelanggan
`returned`	Barang diretur

`reservation_status` (QuinnOrder)

Nilai	Deskripsi
`active`	Stok sedang direservasi untuk order ini
`consumed`	Stok sudah terpakai (order diproses)
`released`	Stok dikembalikan (order dibatalkan)
`expired`	Stok dilepas otomatis karena timeout

`source` (CompanyPOSTransaction)

Nilai	Deskripsi
`pos`	Transaksi kasir langsung
`online_catalog`	Katalog online
`website`	Website perusahaan
`marketplace`	Marketplace (Shopee, Tokopedia, dll)
`landing_page`	Landing page kampanye
`whatsapp`	Order via WhatsApp
`reseller`	Order dari reseller
`b2b`	Order B2B (business-to-business)
`grab`	Order via GrabFood
`social_media`	Order dari media sosial

`sales_channel` (CompanyPOSTransaction & QuinnOrder)

Kanal penjualan ternormalisasi. Field source pada CompanyPOSTransaction dipertahankan untuk kompatibilitas legacy.

Nilai	Deskripsi
`offline_pos`	POS offline (kasir langsung) — default POS
`offline`	Offline (legacy, setara `offline_pos`)
`website`	Website perusahaan
`online_catalog`	Katalog online
`marketplace`	Marketplace eksternal
`landing_page`	Landing page kampanye
`whatsapp`	WhatsApp
`reseller`	Reseller
`b2b`	B2B
`grab`	GrabFood
`social_media`	Media sosial

RBAC — Hak Akses Order Management

Berikut adalah matriks hak akses berdasarkan peran (role) terhadap operasi pada entitas CompanyPOSTransaction dan QuinnOrder.

Operasi	Role	Kondisi	Deskripsi
Create	`admin`	—	Admin dapat membuat transaksi/order tanpa batasan
Create	`member`	`data.company_id == user.active_company_id`	Member hanya bisa membuat order dalam perusahaan aktifnya
Create	`member`	`created_by_id == user.id`	Member bisa membuat order atas namanya sendiri
Read	`admin`	—	Admin dapat membaca semua transaksi/order
Read	`member`	`data.company_id == user.active_company_id`	Member hanya bisa membaca order dalam perusahaan aktifnya
Read	`member`	`created_by_id == user.id`	Member bisa membaca order yang dibuatnya sendiri
Update	`admin`	—	Admin dapat mengubah semua transaksi/order
Update	`member`	`data.company_id == user.active_company_id`	Member hanya bisa mengubah order dalam perusahaan aktifnya
Update	`member`	`created_by_id == user.id`	Member bisa mengubah order yang dibuatnya sendiri
Delete	`admin`	—	Admin dapat menghapus semua transaksi/order
Delete	`member`	`data.company_id == user.active_company_id`	Member hanya bisa menghapus order dalam perusahaan aktifnya
Delete	`member`	`created_by_id == user.id`	Member bisa menghapus order yang dibuatnya sendiri

Catatan RBAC: Semua aturan RLS (Row-Level Security) menggunakan pola $or dengan tiga kondisi: (1) kecocokan company_id dengan active_company_id user, (2) kecocokan created_by_id dengan user.id, atau (3) role admin. Ini memastikan isolasi data multi-tenant yang ketat sambil tetap mengizinkan admin akses penuh.

Penting: Field company_id divalidasi agar tidak boleh null atau string kosong ("") pada semua operasi CRUD. Ini mencegah data orphan yang tidak terikat ke perusahaan manapun.

​title: “Order Management” description: “Manajemen order multi-channel terpusat — OrderManagement.jsx (614 baris), ProductOrder + MarketplaceOrder, batch processing, WhatsApp notification, dan timeline tracking.”

​Order Management

​Arsitektur Komponen

​Dual-Entity Order Model

​Alur Order Multi-Channel

​Fitur Utama

​Status Order & Timeline

​Cara Akses

​Flow Penggunaan

​Filter & Pencarian

​Order dari Website

​Order dari WhatsApp

​Batch Processing

​Metrik Order

​Tips

​Entity Schema — Order Management

​Entity Relationship Diagram

​Tabel Schema — CompanyPOSTransaction

​Tabel Schema — QuinnOrder

​Sub-Schema — items[] (CompanyPOSTransaction)

​Sub-Schema — items[] (QuinnOrder)

​Sub-Schema — payments[] (Split Payment)

​Sub-Schema — payment_proofs[] (QuinnOrder)

​Sub-Schema — status_history[] (QuinnOrder)

​State Machine — Order Status Lifecycle

​CompanyPOSTransaction — order_status

​QuinnOrder — status

​QuinnOrder — fulfillment_status

​QuinnOrder — payment_status

​QuinnOrder — reservation_status

​Sequence Diagrams

​1. Pembuatan Order dari POS (Kasir)

​2. Pembuatan Order dari Quinn Storefront

​3. Kitchen Display — Order Masuk Dapur

​4. Modifikasi Order (Update Status & Verifikasi Pembayaran)

​Enum Tables

​order_status (CompanyPOSTransaction)

​status (CompanyPOSTransaction)

​status (QuinnOrder)

​payment_method (CompanyPOSTransaction)

​payment_method (QuinnOrder)

​payment_status (CompanyPOSTransaction)

​payment_status (QuinnOrder)

​fulfillment_status (QuinnOrder)

​reservation_status (QuinnOrder)

​source (CompanyPOSTransaction)

​sales_channel (CompanyPOSTransaction & QuinnOrder)

​RBAC — Hak Akses Order Management

title: “Order Management” description: “Manajemen order multi-channel terpusat — OrderManagement.jsx (614 baris), ProductOrder + MarketplaceOrder, batch processing, WhatsApp notification, dan timeline tracking.”

Order Management

Arsitektur Komponen

Dual-Entity Order Model

Alur Order Multi-Channel

Fitur Utama

Status Order & Timeline

Cara Akses

Flow Penggunaan

Filter & Pencarian

Order dari Website

Order dari WhatsApp

Batch Processing

Metrik Order

Tips

Entity Schema — Order Management

Entity Relationship Diagram

Tabel Schema — CompanyPOSTransaction

Tabel Schema — QuinnOrder

Sub-Schema — `items[]` (CompanyPOSTransaction)

Sub-Schema — `items[]` (QuinnOrder)

Sub-Schema — `payments[]` (Split Payment)

Sub-Schema — `payment_proofs[]` (QuinnOrder)

Sub-Schema — `status_history[]` (QuinnOrder)

State Machine — Order Status Lifecycle

CompanyPOSTransaction — `order_status`

QuinnOrder — `status`

QuinnOrder — `fulfillment_status`

QuinnOrder — `payment_status`

QuinnOrder — `reservation_status`

Sequence Diagrams

1. Pembuatan Order dari POS (Kasir)

2. Pembuatan Order dari Quinn Storefront

3. Kitchen Display — Order Masuk Dapur

4. Modifikasi Order (Update Status & Verifikasi Pembayaran)

Enum Tables

`order_status` (CompanyPOSTransaction)

`status` (CompanyPOSTransaction)

`status` (QuinnOrder)

`payment_method` (CompanyPOSTransaction)

`payment_method` (QuinnOrder)

`payment_status` (CompanyPOSTransaction)

`payment_status` (QuinnOrder)

`fulfillment_status` (QuinnOrder)

`reservation_status` (QuinnOrder)

`source` (CompanyPOSTransaction)

`sales_channel` (CompanyPOSTransaction & QuinnOrder)

RBAC — Hak Akses Order Management