Skip to content

PureScan Terminal

Jump to bottom
0neShot edited this page Sep 9, 2026 · 1 revision

The PureScan Terminal

The PureScan Terminal is a distraction-free, 100% mouse-free warehouse kiosk interface designed specifically for touchscreens and handheld barcode scanners.

Accessible at:

https://<your-inventree-url>/plugin/smartparts/purescan/

Design Philosophy

Traditional web UIs require constant switching between a handheld scanner, a keyboard, and a mouse. PureScan eliminates this friction:

  • Zero-Click Execution: All operations—from stock lookups to inventory moves—are driven entirely by sequential barcode scans.
  • Industrial High-Contrast UI: Large typography and clear status colors visible from across a warehouse workbench.
  • Audio & Visual Feedback: Distinct audio tones and full-screen color flashes confirm successful scans or highlight errors without requiring the operator to inspect fine text.

📸 TODO (Screenshot): [PureScan Kiosk Terminal interface in full-screen operational mode.]

Finite State Machine Workflow

PureScan operates as a deterministic state machine:

stateDiagram-v2
    [*] --> IDLE
    IDLE --> AWAITING_ITEM: Scan Action Barcode (e.g. SYS:TRANSFER)
    IDLE --> PROCESSING: Direct Part Scan (auto-info lookup)
    AWAITING_ITEM --> AWAITING_PARAM: Scan Stock Item Barcode
    AWAITING_PARAM --> COMBO: Scan Quantity Barcode
    COMBO --> COMBO: Additional Quantity Scans (<3s)
    COMBO --> PROCESSING: Timer Expires (3s)
    AWAITING_PARAM --> PROCESSING: Scan Location Barcode
    PROCESSING --> SUCCESS: API Action Completed
    PROCESSING --> ERROR: Validation Failed / Network Error
    SUCCESS --> IDLE: Auto-Reset (4s)
    ERROR --> IDLE: Clear / Scan Cancel
Loading

Supported Action Commands

Operators trigger actions by scanning standardized command barcodes:

Command Barcode Action Description
SYS:TRANSFER / SYS:MOVE Stock Transfer Moves a physical stock item from its current bin to a new InvenTree location.
SYS:INFO / SYS:LOOKUP Part Lookup Displays rich component details, part photo, stock level, parameters, and location path.
SYS:ADD Stock In / Add Increases stock quantity for an existing stock item.
SYS:REMOVE Stock Out / Deplete Decreases stock quantity for production or consumption.
SYS:STOCKTAKE Inventory Audit Records a formal stocktake count with timestamps for auditing.

Note

Safety Guard on Depletion: PureScan prevents complete stock item deletion via rapid scanning. If an operator attempts to remove more units than are available, the terminal sounds an alert: "Cannot remove N units — only M available. Use manual correction for full depletion."

Advanced PureScan Features

1. Combo-Timer Quantity Accumulation

When receiving or pulling multi-pack components:

  1. Scan SYS:ADD or SYS:REMOVE.
  2. Scan the stock item.
  3. Rapidly scan quantity barcodes (e.g. scanning a +10 barcode three times accumulates +30).
  4. PureScan waits 3.0 seconds (COMBO_TIMEOUT_MS). Once scanning pauses, the accumulated total is executed in a single atomic database operation.

2. Action History & Undo Stack

Accidental scans happen in fast-paced warehouse environments. PureScan keeps a rolling local history stack of the last 20 operations:

  • Operators can scan an SYS:UNDO barcode or click the on-screen Undo button to reverse the previous transaction.
  • The system restores original stock quantities or returns items to their prior bin location.

Printable Command Sheet

A printable reference sheet containing all operational barcodes is built into the plugin:

https://<your-inventree-url>/plugin/smartparts/purescan/commands/

Print and mount this sheet at every scanning station or laminate it to the operator's workbench.

📸 TODO (Screenshot): [Printable PureScan Command Barcode Sheet preview.]

✍️ TODO (User Input): [Recommended scanner hardware mounting, stand height, and protective casing for your warehouse stations.]

Next Steps

Clone this wiki locally