Smart Counter — Release Notes v1.3.1
Release date: 12 June 2026
Version: 1.3.1 (Smart Counter polish — patch on the Ailaaj One 1.3 line)
Status: Live on dev / pending production ship
What this release is
A polish pass on the Smart Counter sale screen — no new modules. Existing till,
cart, checkout, and Counsellor-on-counter flows were tidied for clarity and consistency.
Docs were refreshed with updated screenshots.
| Area | Staff impact |
|---|
| Till open / close | Clearer till cards, opening balance pane, End Session reconciliation |
| Sale screen | Tidier cart, quick-add bar, focus mode, keyboard layer |
| Smart Counsellor | Collapsible panel, calmer OOS → substitute path |
| Returns & recent sales | Restyled to match counter chrome |
| Docs | Updated Smart Counter + Smart Counsellor guides and screenshots |
Improved — Till session
Till picker (Open your counter)
- Store + warehouse dropdowns at the top; till cards below with live status:
Open · your session, Free, In use (shows who / since when), or
Maintenance.
- Resume your own session in one click — no re-entering the opening float.
- Join session on Shared tills when a colleague already has it open.
- Each card shows the till balance (last closing float for free tills).
Opening balance
- Click a Free till → Opening cash balance pane opens.
- Amount pre-filled from that till’s last closing balance (Suggested Rs N from last
closing), with quick-amount chips and optional opening note.
- Opening float is per till, not a shared tenant number.
End Session (cash reconciliation)
- Clearer End Session dialog: reconciliation ledger, cash outflows (adjustments,
deposits), count-by-denomination or manual total.
- ± Rs 10 tolerance: variances under ten rupees are treated as balanced — no
over/short reason required. Larger gaps show overage/shortage with an honest variance
amount and mandatory reason.
- Smart Validate shortcut to reconcile missing till transactions before close.
After close / between shifts
- Ending a session returns staff to the till picker (not a dead-end screen).
- Till list cache refreshes on open/close so cards don’t stay stuck on
Open · your session after a close.
- Resume on a closed till falls through to opening balance instead of looping on the
picker.
Improved — Sale screen
Layout & chrome
- Session header: store · warehouse · till, cashier, Online/Paused, balance, Pause /
End Session, Show / Hide Counsellor, Focus (full-screen cart), Advanced menu
(change location, sync, offline queue, session stats).
- Focus mode hides app chrome for high-volume cashiering (F11 or Ctrl/Cmd+Shift+F).
Cart
- Quick-add bar for faster product search (name, code, ingredient) with less
full-screen re-render while typing.
- Trade-up ribbon under lines when a higher-margin equivalent is in stock.
- Out-of-stock lines: calmer amber styling, Counsellor-forward substitute prompt, and
Check other warehouses for peer-location stock.
- Batch / expiry popover on lines when batch tracking is enabled for the warehouse.
- Keyboard navigation across cart fields, quick-add, and command palette (⌘K).
Checkout & payment
- Restyled Checkout dialog: clearer payment split, cash received, and completion flow.
- Hold sale, coupon, cart discount, package product, and missed sale
dialogs aligned to the counter visual system.
Customer attach
- Inline customer search in the order summary row (search, select, or create without
leaving the cart).
Recent sales & returns
- Recent Sales tab restyled; Process Return flow updated to match POS patterns
and receipt reprint.
Smart Counsellor (on-counter)
- Collapsible Counsellor rail — expand for substitutes, trade-ups, cross-sell; collapse
for more cart width (preference remembered).
- Cross-sell tab for basket-aware suggestions (tenant sales history).
- Calmer OOS prompt — substitute count and equivalence pill (same molecule / diff
strength / same class) before opening the full rack.
Bug fixes
| Issue | Fix |
|---|
| Till showed Open · your session after End Session; clicking looped on picker | Invalidate till cache on open/close; verify live session before resume |
| End Session flagged exact count as over/short (floating-point) | ± Rs 10 balanced tolerance; show minor variance honestly |
| Check other warehouses showed same warehouse stock | Exclude stock using the open till’s warehouse, not a stale prop |
| Till picker Resume after close sent user in a circle | Stale session → opening balance flow |
| Session close left user on blank / wrong step | Unified useTillSession + useTillsWithSessions; POSWithSelection handoff |
Documentation
- Smart Counter guides updated with refreshed screenshots: till picker, opening balance,
end session, checkout, receipt, batch select, cross-sell, counsellor collapsed.
- Till close docs updated for ± Rs 10 reconciliation rule.
- Live capture scripts:
capture-live.mjs, session-capture.mjs, shared live-shared.mjs
(port 8081 default).
Permissions (unchanged)
| Permission | Access |
|---|
pos.view / pos.sales | Smart Counter + Smart Counsellor |
pos.manage | Tills, cash, payment config |
Commits in this batch (dev)
| Commit | Summary |
|---|
e1af201c | feat(pos): Smart Counter UI/UX revamp — till picker, cart, checkout, counsellor |
54ec294c | docs(academy): POS guides Diátaxis restructure |
8e17a7bb | Till remembers balance; open till flow after session close |
7cfab3ee | End-session tolerance, till picker cache, screenshot regen |
4492d2df | fix(pos): other-warehouse stock uses till session warehouse |
QA checklist (suggested)
Further reading