Skip to content

BoothKernel v1.2.0 ​

v1.1 made BoothKernel usable; v1.2 makes it keep proper accounts. This release rewrites the ledger: every item and every yuan has a source and a destination. Bundle deals, refunds, gifts and scrap, closing stocktakes and consignment payouts are all built on the new ledger.

Read before upgrading: old events and orders are not migrated

Your Product library comes over automatically, but v1.1's events, orders and stock won't appear in v1.2. They're kept intact in a backup file, and the first time you log in to the Admin console after upgrading you can export them to Excel in one click. Don't upgrade in the middle of an event. See Upgrading from v1.1 to v1.2.

Highlights ​

📒 New ledger: goods and money are both double-entry ​

Stock used to be just a number: minus one on a sale, plus one on a cancel, and when it went wrong there was no way to find out why. Now every order, payment, refund, gift and stocktake is a balanced debit/credit entry: which location goods moved from and to, which channel money came through and which circle it belongs to, nothing left out.

  • When taking payment you pick a Payment channel (WeChat / Alipay / Cash / custom), and at closing you reconcile by channel
  • "Complete order" is still only a record; it doesn't mean the system confirmed the payment arrived. That hasn't changed

🎁 Bundles & discounts ​

  • Set up bundles per event: "any 3 postcards for 20" (duplicates allowed) or "new book + standee together for 50" (one of each)
  • The customer's cart automatically finds the cheapest combination and shows "Applied: XX bundle −¥10"
  • At checkout the vendor can remove bundles one by one and directly change the Amount received (round down or add a surcharge); the difference is recorded as a manual discount and doesn't affect consignment circles' share
  • While setting up a bundle, a live preview shows the most / least a customer could get, so you don't configure it wrong
  • Replaces v1.1's "negative-price product as a discount" trick

See Bundles & Discounts.

🧾 Closing & settlement ​

  • New closing wizard in the Vendor view: clear orders → stocktake → take back → settle; quitting halfway keeps your progress
  • Settlement sheet: where each circle's goods went, the net amount, and how much I owe whom, all in one table; exports to an Excel file with four sheets
  • Consignment payouts: products belong to a circle, and goods you sell for others are settled separately automatically
  • Refunds (line by line, partial refunds, different refund channel), gift / scrap records, advances, settlement adjustments, payment recount
  • After settling the books are frozen; only advances, settlement adjustments and payment recount can still be added at home

See Closing & Settlement.

▦ Barcode scanning ​

  • On the Customer order page, scan barcodes continuously with the camera to add items; works with commercial barcodes (JAN / ISBN) and code labels you stick on yourself
  • Supports USB / Bluetooth barcode scanners, plug and play
  • The product form can scan to fill the barcode field
  • Fully offline, no network services involved

See Barcode Scanning.

🧭 Redesigned Admin console and Vendor view ​

  • Event workbench: open an event and there's a status bar at the top, "Preparing → In progress → Settled", with tabs grouped into Pre-event / On-site / Closing
  • Pre-event prep: "Pick from Product library" to list items in bulk; "Import from previous event" to bring over products, prices and bundles in one go
  • The sidebar is now Events / Product library / Circles / Settings / Tutorial; the old "Dashboard" and "About" pages are merged into Settings
  • The Vendor view now has four tabs, Quick Sale / Orders / Inventory / Closing, shown as a bottom tab bar on phones; switching tabs doesn't interrupt new-order alerts
  • Quick Sale lets vendors build a one or multiple item cart from the same catalog and bundle deals as the customer view, then complete the order after confirming payment. Payment QR codes can be opened with one tap; retrying an uncertain request does not create a second sale
  • Go to ordering in the Vendor view and Back to Vendor view on the order page: one tap to switch when taking orders on a tablet
  • Vendors can view this event's settlement sheet directly
  • The order list shows refunded amounts and refunded quantities per line
  • Unified components and colours across the app; the tablet order page and the phone Vendor view have both been re-laid out

Fixes & improvements ​

  • Fixed the app crashing on launch on Windows without the VC++ runtime: the installer now bundles it, and if the AI model fails to load only photo recognition is disabled, not the whole app
  • On Android, the AI recognition "Auto" mode now runs on CPU (in testing, NNAPI was actually slower for these models; you can still pick it manually in settings)
  • Fixed no alert sound for the first new order when opening the booth with no pending orders
  • Fixed Excel export failing from a LAN browser
  • Fixed a batch of photo recognition issues: incremental indexing losing images, a failed rebuild still showing "Done", no index built after importing a product pack, and tall album photos being stretched
  • When recognition is unavailable, the "Photo recognition" entry on the order page is greyed out instead of erroring after you tap it
  • Fixed the camera light staying on after closing the camera (camera not released)
  • Hardened .boothpack import: entries that would write outside the data directory are rejected
  • The Admin console keeps reminding you to change the factory default passwords (admin123 / vendor123)
  • All UI text is now Chinese (some input placeholders used to be the English "Please Input")
  • The database is snapshotted automatically before every upgrade, and restored automatically if the upgrade fails

Upgrade notes ​

  • Windows: v1.1.1 users can update in one click under Settings → About & updates (「设置 → 关于与更新」); v1.1.0 users need to download the installer manually
  • Android: download the new APK and install over the old one. Don't uninstall first (uninstalling wipes your data)
  • After the first launch, read Upgrading from v1.1 to v1.2 to export old data and check circle ownership
  • LAN access still uses port 5141 (HTTPS); certificates and QR codes work the same as before