Objective, Pipeline & SOP

Pelawat anon
  → GET www.10camp.com (SPA boot, no login)
  → initApp(anon): baca VIEW cost-free — public_products + public_stock
  → render storefront + activity tiles + category pills
       Penapis wajib: is_published · bukan discontinued · bukan event-SKU (OUTDOOREXPO)
  → browse / cari / product detail
  → Corong keluar:
       (a) Butang marketplace → Shopee / TikTok (app_settings.links)
       (b) WhatsApp → wa.me (app_settings.shop.whatsapp)
       (c) Pertanyaan web → public-checkout → quotations_log 'Web Invoice' → admin sahkan
       (d) VIP loyalty → loyalty-otp (OTP email) → papar mata / pembelian

• Nak produk keluar di landing: set Published + bukan discontinued + bukan event-SKU. Tak nampak → semak 3 syarat ni dulu.
• Landing = Preview parity: ubah grid landing mesti sama pada Preview Mode (DOM/CSS sama). Guna ID selector.
• Kontak & sosial: SEMUA dari app_settings — jangan hardcode nombor/handle.
• Jangan dedah: kos, margin, supplier/vendor, bin lokasi, notes dalaman, PII pelanggan ke laluan anon.
• Deploy: push → tunggu Netlify → verify app.js?v= → kill & buka semula app.

Login staf (email/password kali pertama → PIN peranti sama; __detectUserByPin)
  → initApp(staff): baca BASE table penuh (products_master, inventory_batches,
     inventory_transactions, suppliers, PO, reservations) + app_settings
  → operasi ikut modul → Supabase (RLS) + Netlify service-role functions (gated _auth)
  → Marketplace: harga POS = harga kedai (base terendah); Shopee/TikTok LEBIH tinggi (cover fee)
  → Deploy: git push → Netlify

• Roles: mgmt · sales · inventory · Bos via isBoss(u) (Managing Director) — bukan role lama superior (retired).
• Approval (HR claim / cuti / memo): gate isBoss(u) — konsisten render butang & handler.
• Roadmap rule (keras): tiap perubahan update ROADMAP_DATA (index.html), commit sama.
• Data integrity: semua tulisan duit/stok — semak {error} + idempoten; jangan guna Date.now() sebagai PK.
• Jangan padam sejarah produk: buang produk = padam baris katalog SAHAJA; jualan/returns kekal.
• Brand-lock + no-emoji untuk SEMUA skrin (3 warna + Poppins + logo rasmi).

Login staf → Cashier
  → Buka Shift (float masuk laci; cash_drawer_log)
  → Cari / Scan barcode / Katalog (browse ikut Koleksi/Brand/Kategori) → troli
  → Attach pelanggan: Walk-in / VIP (loyalty) / B2B (harga rundingan ikut min_qty)
  → Diskaun (manual/global) + Loyalty redeem
  → Checkout:
       1. deduct_stock_fifo (RPC atomik, idempoten via p_ref = client_txn_id:sku)
       2. insert sales_history (client_txn_id = kunci idempotensi)
       3. kira mata + total_spent (RM10 = 1 mata)
       4. resit (email/print) + rekod laci + komisen
       5. push stok ke TikTok/Shopee (fire-and-forget)
  → Return/Refund · Void · Tahan Jualan · Split · Tutup Kira (Z-report) · Offline queue+sync

• Mula shift: Buka Shift → float. Tutup shift: Tutup Kira → kira tunai sebenar vs dijangka → simpan Z-report.
• Refund / Return: barang elok balik jual → tick "Pulang ke stok" · barang rosak / write-off → UNTICK (stok TAK ditambah balik).
• Refund penuh → status Refunded + loyalti dipulih; separa → loyalti dipulih berkadar.
• B2B: harga tier ikut qty (min_qty) — yang dicaj mesti sama dengan yang dipapar.
• Offline caveat: stok/resit ikut masa sync; elak jual offline masa stok kritikal.
• Mobile: Capacitor shell. Kill & buka semula app untuk muat versi baru.

• Pricing: coupon management · gift-card (semak semula — store-credit dulu di-drop) · flash-sale + countdown.
• CRM/Storefront: product reviews + ratings (rich-result) · social-proof widgets · wishlist / recently-viewed / faceted-nav · personalization.
• Ops: vendor scorecard · AP matching · order-routing/split · b2b company accounts + net terms.
• Growth: referral loops · cross-sell/upsell engine · push (price-drop/back-in-stock) · seasonal campaign playbook · attribution dashboard.