Barcode scanner — manual testing

How to exercise the v4 barcode flow locally: device configuration, editor assignment, and cart scanning. EAN/UPC values are stored in barcode, not in the quick-search code field.

Prerequisites

1. A place with at least one product.
2. A connected TPV service (RASPPI) with a CODESCAN row (Place → Devices → service → add barcode scanner).
3. POS front open on the cart tab or a product/shortcut editor.

Without a configured CODESCAN, barcode UI and cart HID listening stay hidden (service?.codescans.length === 0).

HID simulator (host)

Location: tools/barcode-hid-simulator/

cd tools/barcode-hid-simulator
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python simulate_barcode.py

Stdin workflow (recommended on macOS):

1. Run the script in Terminal.
2. Type a digit 0–9 and Enter.
3. During the countdown, focus Chrome on the POS (editor or cart).
4. The script injects the mapped barcode + Enter at keyboard speed.

Default mappings in barcodes.json are real EAN-13 barcodes for common soft drinks (refrescos), suitable for discovery (barcode/discover) and manual cart/editor tests:

Key	EAN-13	Typical product
0	5449000000996	Coca-Cola Original Taste 33 cl
1	5449000004840	Fanta Naranja
2	5449000000729	Sprite slim 25 cl
3	5449000205520	Sprite
4	5449000054227	Coca-Cola 500 ml
5	5449000120960	Fanta Zero Sugar
6	5449000104885	Sprite Zero lima-limón
7	8712561730034	Pepsi Cola 330 ml
8	9002490100071	Red Bull Energy Drink 250 ml
9	5449000120984	Fanta Orange Zero 2 L

Copy those values into PRODUCT.barcode or PRESELECT.barcode in the editor — not into code.

macOS: grant Accessibility to the Python binary printed at startup if injection does nothing.

Scenarios

Assign barcode in editor

1. Open product or shortcut edit (with scanner configured).
2. Tap Assign barcode → listening overlay.
3. Run simulator digit 1 → value 5449000004840 (Fanta Naranja) should appear with preview.
4. Accept the editor → sync persists barcode.

Cart — single match

1. Assign 5449000004840 to a purchasable product.
2. Open cart select tab.
3. Scan/simulate the same barcode → product added to ticket.

Cart — multiple matches

1. Assign the same barcode to two products or shortcuts.
2. Scan once → product match modal opens (barcode prefilled).
3. Pick one row → added to ticket.

Cart — manual code search

1. Enable Product codes in place settings (optionProductCodes).
2. At catalog root, tap the By number thumb (PRDNO).
3. Enter a product code prefix on the numpad → same modal in code mode (doPrdCode).

Field reference

Field	Table	Used for
barcode	PRODUCT, PRESELECT	HID scanner, editor assignment, doBarCode
code	PRODUCT, PRESELECT	Manual keypad search when optionProductCodes

Unit tests

• upp-data: barcode.spec.ts, productcode.spec.ts
• upp-base: barcode.spec.ts
• upp-wdgt: upp-barcode-display.spec.ts
• feature/ticket: upp-cart-select.spec.ts; feature/place: upp-product-match-modal.spec.ts

Run in nx-dev:

npx nx test upp-data --testPathPattern='barcode|productcode'
npx nx test upp-base --testPathPattern=barcode
npx nx test upp-wdgt --testPathPattern=upp-barcode
npx nx test feature-place --testPathPattern='tab-select|product-match|codescan'