# CHECKLABS POS update — 11 November 2026

## Changes
1. Stock take expected quantities now use the total stock across every store belonging to the active business branch, matching the branch-wide stock figure shown in Products and POS. Reconciliation consolidates any legacy department-store balances into Main Stock before applying the variance.
2. Products multi-edit now includes an editable branch stock quantity for stock-controlled products. Saving sets the branch's total quantity to the entered figure, consolidates legacy store balances, and records stock movements through the stock service.
3. Branch context checks remain enforced on every operational request. The middleware now also rejects submitted branch identifiers (including source/destination/target and branch arrays) that are not assigned to the signed-in user. Branch administration routes remain exempt for authorised administrators; branch switching continues to validate membership.
4. Added a branch-scoped product lookup endpoint with instant suggestions from the first typed character. Product list and restaurant POS search now show suggestions without pressing Enter. Stock take has live in-table filtering and suggestions. Existing purchase, stock transfer and stock adjustment selectors already filter on each keystroke and retain that behaviour.

## Important behaviour
- Stock multi-edit is an exact branch-wide quantity, not an increment.
- Non-stock-controlled restaurant menu products remain N/A in the stock editor.
- Branch stock is consolidated into the active branch's Main Stock location when setting a quantity or reconciling a stock take.
- Product lookup only returns active products assigned to the active branch.

## Validation
- PHP syntax checks passed for modified controllers, middleware and routes.
- ZIP integrity check passed.
- Laravel Blade compilation could not be run in this environment because the PHP runtime does not have the mbstring extension (`mb_split` unavailable).
- Live database/browser testing has not been performed. Back up the database before installation and verify one product's stock in Products, Stock Take and POS.
