Owner: Setup booth dan operasional harian sampai laporan.

Outlet adalah lokasi fisik (nama, alamat, kota, provinsi, status active atau inactive). Photobox adalah booth di dalam outlet (nama, slug unik per business, outlet induk, status online, offline, atau maintenance). Satu outlet bisa menampung banyak booth.

Limit plan di enforce server side. Membuat outlet atau booth melebihi max_outlets atau max_photoboxes ditolak. Semua query di scope business id: non member mendapat 404 anti existence leak.

Klik baris outlet untuk analytics: revenue (sum final amount), sessions count, customers distinct, average transaction, dan most popular package (group by package terbanyak).

Pairing memakai kode aktivasi sekali pakai kedaluwarsa sekitar 5 menit. Device kirim kode ke POST /api/v1/public/devices/activate, server verifikasi lalu terbitkan device token persisten (disimpan hash di server, token di localStorage device). Token diverifikasi bersama photobox id dan business id di tiap request.

Device status read only berisi resolusi kamera, status printer, dan last heartbeat. Tombol Ulangi Setup melakukan revoke lalu pairing ulang. Revoke membuat device langsung terkunci.

Timer mulai saat webhook paid. Semua endpoint sesi mengecek expiry dan mengembalikan SESSION_EXPIRED bila lewat. Countdown kiosk hanya UX, server adalah enforcer.

Timeout sebelum bayar: reset ke Welcome, checkout expired, tidak reuse. Timeout setelah bayar: auto finalize memakai foto terakhir, tetap print dan QR result. Timeout post paid dengan 0 foto: result menampilkan sesi berakhir, penanganan manual owner.

Template adalah frame yang menampung foto customer. Dua tipe: template legacy (layout kosong, overlay full canvas, backward compatible) dan template slot (layout canvas plus slots array, foto masuk pas per slot).

Customer hanya melihat template yang di assign ke paket yang ia beli dan slot count sama dengan photo count. Satu engine composeFrame dipakai di builder preview, editor kiosk, print renderer, dan result online.

Desain di Canva, Figma, atau Photoshop, ekspor PNG atau SVG transparan. Upload divalidasi tipe dan ukuran di server sebagai trust boundary.

Builder canvas: tambah slot (drag kotak), atur shape, posisi, ukuran, rotasi, fit, lalu Preview dengan foto contoh. Slot tidak bisa digeser atau resize keluar batas canvas (clamp saat drag).

Urutan render: clear canvas ke resolusi canvas, untuk tiap slot urut z naik clip ke shape lalu drawImage foto dengan fit cover atau contain plus transform zoom atau pan customer, lalu drawImage frame PNG penuh, lalu sticker dan text di atas.

Edit package lalu multi select template. Filter otomatis hanya menampilkan template dengan slot count sama. Simpan menghapus relasi lama lalu insert bulk yang baru.

Voucher memberi diskon di checkout sebelum paid. Diskon tercatat di checkout session, payments, dan transactions. Kode unik per business huruf besar plus angka.

Frontend hanya display. Backend validasi ulang semuanya dan menghitung final amount sebagai source of truth: final sama dengan harga paket plus pricing yang berlaku minus diskon voucher valid.

Dua tipe: percentage (1 sampai 100 persen, capped by max discount) dan fixed (nominal IDR flat, capped by gross). Bisa dibatasi periode, usage limit total, per customer, minimum transaksi, maximum diskon, dan paket atau outlet tertentu.

Customer input kode ke POST apply voucher. Server cek: voucher ada, business cocok, is active true, tanggal berlaku, usage limit total, usage per customer, min transaction, package eligibility, outlet eligibility.

Voucher 100 persen membuat payment paid sintetik tanpa gateway. Voucher parsial kembali ke method picker untuk melunasi sisa. Saat webhook paid, ada TOCTOU re-check kuota: bila over limit, log warning tanpa rollback karena payment sudah settled, lalu insert voucher usages.

Buka baris voucher untuk total usage (count voucher usages), total diskon (sum discount amount), revenue generated (sum final amount transaksi yang memakai voucher), serta active dan expired count.

Dashboard adalah server component yang membaca transactions paid milik business Anda. Semua query di scope business id, tidak ada data lintas tenant.

Uang selalu integer Rupiah. Gross adalah total sebelum diskon (sum final amount? tepatnya gross), discount adalah total voucher terpakai dan tidak dihitung sebagai revenue, net adalah gross minus discount. Average transaction adalah net dibagi count paid, dibulatkan integer.

Halaman Dashboard menampilkan revenue today, revenue month, gross, net, total sessions, paid transactions, total customers, average transaction, active photoboxes (status online), dan active outlets (status active).

Halaman Analytics menyediakan breakdown per hari, outlet, package, photobox, dan metode pembayaran. Semua agregasi dari transactions, sehingga POS otomatis masuk laporan begitu insert ke transactions.

Halaman Customers menampilkan nama, phone, email, total spending (sum final amount per customer), session history, transaction history, dan booking history. Search mendukung nama, phone, email. Klik baris untuk detail tab transaksi, sesi, booking.

Role business: owner akses penuh, manager hampir semua kecuali staff write dan billing, staff read only operasional. Permission dicek server side dengan fungsi can. Sembunyikan menu hanya UX, bukan pengaman.

POS adalah add on ber entitlement per booth dengan flag photoboxes pos enabled. Pembayaran POS offline only: cash, bank transfer, atau other. Tanpa integrasi payments, Pakasir, webhook, atau creditBalance.

Invite mencari user by email, buat user active bila belum ada, lalu insert business members. Update dan revoke memakai composite business id plus user id. Role owner tidak bisa diubah atau di revoke orang lain.

POS dijual sebagai baris add ons code pos unit feature. Harga dibaca server dari add ons dan bisa diubah admin via UI tanpa deploy. Owner beli via subscription invoice QRIS, lalu apply intent upsert subscription add ons.

Gate di tiga lapis: layout POS redirect bila tidak berhak, tiap server action dan API throw POS NOT SUBSCRIBED, dan halaman aktivasi owner. Sidebar hanya render menu POS bila entitlement aktif dan role punya permission.

Katalog pos products per tenant: nama, SKU nullable unik per business, kategori text (keychain, gantungan, additional print, merchandise, lainnya), harga integer di atas nol, cost opsional untuk margin, stock nullable (null sama dengan tidak di track), image url eksternal.

Order: client hanya kirim product id plus qty. Server fetch ulang produk by id dan business id, hitung subtotal dan total, simpan snapshot di pos order items agar perubahan harga tidak mengubah riwayat. Stock decrement memakai guarded UPDATE stock sama dengan stock minus qty where stock di atas sama dengan qty.

Transactions adalah source of truth financial reporting. Payments adalah detail settlement. Setiap payment paid otomatis membuat transaction paid. POS otomatis masuk laporan karena insert ke transactions yang sama.

Transaksi manual (cash, bank transfer, other) dan offline dicatat untuk reporting tetapi tidak mengisi saldo. Saldo hanya dari QRIS via creditBalance. Kebijakan ini konsisten sejak migration 0016.

Tabel transactions berisi transaction number, tanggal paid at, customer (nama atau strip), package, outlet, photobox, payment method (qris, cash, bank transfer, other, offline), gross, discount, final, dan status badge. Status enum: pending, paid, failed, cancelled, refunded.

Finance menghitung: Net Revenue sama dengan sum final amount paid. Expenses sama dengan sum expenses amount. Estimated Profit sama dengan Net minus Expenses. Profit Margin sama dengan Profit dibagi Net kali 100.

Reports via REST download: GET /api/v1/business/[businessId]/reports dengan type, from, to, format csv atau xlsx. CSV mengikuti RFC4180 dengan formula injection guard. XLSX via ExcelJS. Response attachment untuk download browser.

Retention days 1 sampai 3 di Settings. Cron retention menghapus media hasil setelah cutoff, baris transactions dan sessions dipertahankan. Checkout settings: qris expiry minutes 1 sampai 60 default 3, offline enabled boolean default false (opt in server gated, payment method offline non withdrawable).