# Stock Management - User Guide

This guide is the authoritative detailed source for user-facing behavior and
explains how to use the Inventory Scanner in everyday language.

![Inventory Scanner quick guide](quick-guide.svg)

For a direct image view in this browser, open **Quick Guide** from the Settings window.

**View Settings** lets you show or hide Scanner columns and choose **Auto**,
**Compact**, **Spacious**, or **Comfortable** density for desktop rows and
mobile cards. Auto uses the automatic screen/content sizing behavior. Barcode
visibility follows the density suggestion until you explicitly set its
checkbox; saved local column and density choices are retained.

The normalized Scanner history records stock movements. **Person in Charge**
identifies the recorded actor, and **Warehouse / Location** and **Time**
describe where and when the movement was recorded. There is no separate
**Modified By** field. Posted movements are immutable; record a new movement
with a reason to correct one. The Scanner table displays the Item Description
from the Admin Item catalog; descriptions are not copied into inventory
records. The scanner requires three matching barcode reads of the same type
within 1.8 seconds before accepting a scan. The default repeat Scan Delay is
1.5 seconds; existing delay preferences are kept. Scanner history rows do not
have legacy row-level Edit or Delete actions. The row-number column is compact
by default. All data tables use a shared pager with a default of 10 rows (or
cards) and choices of 10, 25, 50, or 100; existing saved custom sizes are
retained. Scanner and Report columns can be resized by dragging header
separators or focusing a separator and using the left/right arrow keys. Report
totals and per-person subtotals are hidden when the current filters show no
matching records. The Settings window links to this guide and a visual Quick
Guide.

**Who can see which records.** An administrator account sees every record. Any other account only sees the records it owns, on the scanner table, the totals, the exports, the report and the inventory management page. The report and the charts follow the signed-in account as well: signing in as **User 1** shows and charts only **User 1**'s records, and the person filter cannot widen that. Scanner history is read-only for every account.

The Inventory Management Manual Entry tab shows an **Inventory Summary** card
with the matching record count, total quantity, and per-person action totals.
Its totals follow the visible rows and the summary is hidden when no rows match.
The mobile layout reduces gaps while preserving touch-sized controls; the table
can be scrolled horizontally.

On any app page, scrolling the page reveals the floating **Back to Top**
control on desktop and mobile. Settings has its own control when its content
scrolls: the content panel on desktop and the Settings shell on mobile. Select
the arrow to return that scroll area to its top, or drag the pill to reposition
it. The **Show Back to Top** checkbox in **Settings > System**, directly below
Language, is available at every viewport size and controls both page and
Settings controls; it is on by default. The enabled preference and position
are remembered in this browser, and all controls share the saved position.
Turning the feature off does not reset that position. With a keyboard, focus
the arrow button and use the arrow keys to reposition it, **Enter** to return
the active scroll area to its top, and **Home** to restore its default
position; the options menu offers **Reset Position** and **Close**. Close
turns off **Show Back to Top** immediately while keeping the saved position;
turn it back on in **Settings > System**. The control respects device safe
areas and reduced-motion settings.

**Looking at one person's records.** When you are signed in as an administrator, **Person in Charge** filters are available on Report and Inventory Management Manual Entry, using the same account-aware dropdown. On Scanner, add a **Person in Charge** condition under **Display Options** to narrow movement history. Scanner movements are attributed to the signed-in account; filtering does not change who records a movement. Non-admin accounts and Guests cannot use Person filters to view another person's records.

**Dates in tables.** All displayed dates use zero-padded **DD/MM/YYYY**; the
date portion of a datetime follows the same format and its time-of-day remains
visible. Scans with matching barcode, type, Item, Outlet, action, and person
aggregate only within the same Asia/Kuala_Lumpur server calendar date,
regardless of time-of-day. A scan on a later date creates a separate record,
keeping each day's quantity under its own date in Report. Offline scans use
the server receipt time of their queued batch; scans captured on multiple
offline dates may therefore be regrouped onto the sync date when imported.
The Scanner table automatically shows records whose latest scan date is today.
The Report and Inventory Management pages have
a **Date Range** picker, initially set from the first day of this month through
today. To choose a custom range, select the start date and then the end date;
the calendar stays open between those clicks and applies the inclusive range
after the second. Clicking outside, closing the picker, or pressing Escape
before the second date cancels the pending choice and restores this
month-to-date. Use the month and year dropdowns in the calendar heading to
navigate directly; the year list shows the current year and four previous
years. **This month** and **Reset** both restore the month-to-date range.
Non-admin accounts remain limited to their own Report records. The record
timestamp column is labeled **Last Scan**; the displayed date appears above
the time.

## Before you start

- Open the app in a modern web browser.
- Account registration and sign-in use a unique username and password; email addresses and Google sign-in are not used.
- Register and Change Password display advisory password-strength guidance as a new password is entered; the checklist does not change the app's existing password requirements. In Register, hover over, focus, or tap the information icon beside Username to view the accepted username format.
- The person button in the top left shows your session state. It carries a green check badge when you are signed in, and nothing when you are not. Select it to open the account panel.
- You must sign in or explicitly continue as Guest to use the app. Before then, the Scanner page stays dimmed and inactive; only the Account icon and sign-in panel are available. Opening Report, Inventory Management, or Admin Configuration directly returns to Scanner.
- Signed-in accounts (not Guest) receive an inactivity warning after 30 minutes without pointer, keyboard, touch, or scroll activity. Select **Continue** to stay signed in; otherwise the app signs you out when the two-minute countdown ends. **Log out** signs out immediately.
- Active pages check for account and configuration changes while open and when you return to a tab. Updated access is applied without reloading the page; if access to the current page is removed, you are returned to Scanner.
- The app needs camera permission to scan barcodes. If asked, choose **Allow**.
- Camera access requires browser permission and may require the app to be opened in a secure browsing context.
- Keep an internet connection available so the barcode scanner can load.

**Change or recover your password.** If you know your current password, open the account panel and select **Change Password** above **Sign Out**. Enter your current password, then enter and confirm a different password. The new-password field shows an advisory strength checklist; it does not replace the app's existing password requirements. If you forget your password, select **Forgot Password?**, enter your username, and submit a request. The app will show a generic confirmation; an administrator can see the request in the Users tab of Admin Configuration and set a permanent password for your account. The administrator must share it with you through a private channel. Sign in with that password. Password changes keep the current session and revoke other sessions. Guest accounts do not have passwords to change.

## Administrator settings

Administrators can open **Settings → Admin Configuration** from the Scanner,
Report, or Inventory Management page. The account name is shown beside the
account icon on wide screens; on mobile, select the account icon to open the
account panel and sign out.

- **Users:** create User or Admin accounts, deactivate or reactivate accounts,
  and promote an account to Admin or demote it to User. A **Requested** marker
  appears when a user submits Forgot Password; **Set Password** is enabled only
  while that request is pending. Select it to enter and confirm a permanent
  password for that account. Accounts without a pending request show no reset
  status; Guest device rows have no password controls and display a dash in
  Password Reset. **Last Active** shows the most recent successful sign-in,
  not later actions during that session; it remains after sign-out and shows
  **Never** when no sign-in is retained. Deactivation blocks sign-in, revokes existing sessions, and
  blocks access to Scanner, Report, and Inventory Management regardless of
  role-level Page Access settings; reactivation restores only the pages allowed
  for that role.
  Administrators cannot change their own role or deactivate themselves, and at
  least one active administrator must remain. Guest devices can be deactivated
  or reactivated individually. Inactive User and Guest accounts are both
  excluded from Person filters by default. Enable **Include Inactive User and
  Guest Accounts in Person Filters** to include them with an `[Inactive]` label.
  **Export Users (.xlsx)** opens the shared Export dialog to download the
  current Username, Role, and Status; it never includes passwords or
  account/device IDs. To add accounts in bulk,
  download the `.xlsx` template and fill Username and Initial Password. Role
  is optional and defaults to User; add a Role column with `Admin` or `User`
  when needed. Select **Import Users (.xlsx)** to preview the rows. Passwords
  are not displayed; valid rows can be imported while invalid or duplicate
  rows are reported individually. Import up to 500 accounts per spreadsheet.
  Guest devices cannot be imported because they are tied to individual
  devices.
- **Items and Outlets:** activate/deactivate existing values or add values.
  Inactive values remain in historical records but are omitted from
  autocomplete suggestions. An Outlet can be deleted only when no inventory
  record uses it. If it is in use, the app blocks deletion and recommends
  deactivating it instead. In the Outlets tab, **Export Outlets (.xlsx)**
  downloads Outlet names and status; **Download Import Template (.xlsx)**
  provides an Outlet Name column. **Import Outlets (.xlsx)** previews up to
  500 rows and creates valid new Outlets as active. Existing names and
  case-insensitive duplicates are reported and skipped; import does not change
  existing Outlet status. After the save succeeds, select **Finish** to close
  the preview; it does not undo imported Outlets. Cancel remains available
  before submission and after a failed save. During a save, the actions are
  disabled because the server may complete the import even if the browser
  stops waiting. Use the Outlet search field to filter the current catalog by
  name. Select an active **Default Scanner Outlet** to fill the
  Scanner Outlet field only when it is blank; a value already entered or
  selected on Scanner is preserved. Deactivating or deleting the selected
  Outlet clears the default. An Item can have zero or one Barcode. Supported
  barcode types display a barcode image above their text value; **Show Barcode
  Images** is checked by default and can be unchecked to leave text only.
  **Show Barcode Type** is unchecked by default and can be enabled to show the
  type beneath the Barcode value. Both display preferences are saved in the
  current browser. Select an assigned Barcode cell to open the generator and
  edit the value or type; use **Remove Barcode** there to remove only the
  association, without changing inventory records. Close the generator with
  its X button. An Item without an assigned Barcode keeps its **Generate
  Barcode** button. **Free Text** stores an existing barcode value without
  trying to render an image or match inventory. The Items table fits its
  content on wide screens with extra width for Item Description; on mobile it
  can scroll horizontally and its columns remain resizable. Item spreadsheets
  use one row per Item. A blank Barcode keeps the existing assignment; a
  supplied value replaces it. Exports include barcode text and embedded images
  for renderable types. For imports, attach an image in the
  **Barcode Image** column; the app decodes it and checks that any supplied
  Barcode and Barcode Type agree. Undecodable images or conflicting values
  mark only their row as invalid, so other valid rows can still be imported.
  After the Item save succeeds, select **Finish** to close the preview without
  undoing imported Items. Cancel remains available before submission and after
  a failed save; import actions are disabled while the save is pending.
- **Actions:** add an action and choose whether it increases stock, decreases
  stock, or leaves stock unchanged. The standard Stock In, Stock Out, and
  Stock Take actions remain enabled. The effect is used in grouped report
  quantities.
- **Document Numbers:** set a required Draft Reference format, assigned when a
  scanner draft is first saved and kept on the record after posting. Unused
  references are not reused. Set a unique prefix, format, sequence width, and
  reset policy for Stock In, Stock Out, Stock Transfer, Stock Take, Stock
  Inspection, Write-off, and optionally for each custom Action. Custom Action
  numbering can be enabled or disabled independently; new Actions start
  disabled, while existing Actions retain their current setting. Disabling
  numbering affects future records only; issued numbers and the sequence are
  retained if it is enabled again. Choose a sequence-only, yearly,
  year-month, date, or custom format; yearly and monthly resets require the
  corresponding date information in the format. Sample Output shows the
  configured format. Sequences are shared across warehouses. Saving settings
  affects future documents only; numbers already issued remain unchanged.
  Custom Actions get a profile when created. This configures their numbering
  format but does not add a new stock-posting workflow or a Jobs register.
- **Barcode Types:** enable or disable supported built-in formats for Manual
  Entry and import type choices. At least one format remains enabled; disabling
  a format does not change the scanner decoder's built-in capabilities.
- **Page Access:** configure User and Guest access to Scanner, Report, and
  Inventory Management, then choose which primary actions each role can use
  on those pages. Restricted buttons are dimmed and disabled; Settings
  shortcuts to inaccessible pages are hidden. Denying a page clears and
  disables all its element permissions; restoring page access leaves them
  unchecked until explicitly enabled. Administrators always retain access. By
  default, Users can access all three pages and Guests can access Scanner and
  Report, but not Inventory Management. Direct links to restricted pages
  return to Scanner. When Scanner access is off, Scanner remains a landing
  page but scanning and record edits are disabled. Inventory changes are also
  rejected unless the account has Scanner or Inventory Management access.
  Inventory Management element permissions are grouped by tab. Turning off
  Manual Entry clears and disables Add Row, Edit Records, Save Records, Undo,
  and Clear Records; turning it back on leaves those actions unchecked.
  Turning off Review Batch similarly clears and disables Import Selected.

Account and page-access changes take effect on the next sign-in or page load.
In the local demo, these settings and demo accounts are saved only in this
browser's local storage; they do not affect the live system. Open the Scanner
page first and sign in with the demo administrator account, then open
**Settings → Admin Configuration**. Registered demo accounts, configuration,
and inventory stay local to this browser.

The local demo Admin Configuration Users table can be filtered from the
Username, Role, and Status column headers. Select a header's filter button to
open its filter; click the header outside the button to sort that column.
Search remains above the table. Columns can be resized by dragging a column
boundary, and widths are saved in this browser. Password Reset and Actions fit
their contents by default, leaving more room for Username. On mobile, the
username is hidden beside the account icon, while the signed-in check remains
attached to the icon.

To test with sample accounts, Guest devices, and linked inventory records, open
`admin-config.html?TestDataAction=generateAccounts` in the local demo while
signed in as an administrator. Remove only the generated scenario fixtures
with `admin-config.html?TestDataAction=removeAccounts`. Existing accounts and
unrelated inventory are preserved. These actions are unavailable in the live
build.

For administrator accounts, Admin Configuration is shown in Settings on each
page. Scanner appears on Report and Inventory Management, View Report appears on
Inventory Management, and Inventory Management appears on Scanner and Report.
These shortcuts follow Admin-configured page access and cannot be used to
bypass it. All pages share the same Settings window behavior, locale selector,
keyboard handling, and Help links. The **Scanner** shortcut uses the same
barcode-frame icon as **Start Scan**. Scanner-only scan delay and data-table
controls are not shown on Admin Configuration.

Your records and settings are saved in this browser on this device, and signed-in accounts share the same inventory across devices. Clearing inventory does not remove the saved records of other people. Data is not automatically copied to another device or browser. Export your records regularly if you need a separate backup.

## Add items by scanning

1. In **Person in Charge**, choose a previously saved name. To add someone, choose **Add a person...**, enter their name, and select **Use this name**. The new name is saved for future visits on this browser. To remove an unused saved profile, choose it and select the **X** beside the list, then confirm. The X is hidden while adding a name and disabled if any records use the selected profile. A person must be selected before scanning can start.
2. Optionally enter an **Outlet**. The in-app suggestion menu stays beside the field and lists values from the shared inventory, including values entered by other users. Choose a suggestion with a tap/click or the keyboard, or type a new value; leave it blank if it does not apply.
   Item Names are assigned automatically when the scanned Barcode and type match an active Admin Item, or when exactly one saved inventory Item matches that Barcode and type. If the Item is unmatched, an Admin can turn on **Edit**, enter an Item Name and a nonblank Item Description in the table, and commit either field with Enter or by leaving the field. The new Item is added to the shared Admin catalog. Existing catalog Items and descriptions are read-only; non-Admins cannot add unmatched Items to the catalog. Item suggestions are available in Scanner table editing and the Manual Entry table, including the row editor on small screens.
3. Choose an **Action**:
   - **Stock Take** - count or check the items you have.
   - **Stock In** - record items being added.
   - **Stock Out** - record items being taken out.
4. Open **Settings** with the gear button in the top-right corner to change **Scan Delay**. It starts at 1.5 seconds. You can set it to 1 second or more in half-second steps. This delay starts after a successful scan and does not slow down the first scan; a different barcode can be scanned immediately.
5. Select **Start Scan** and point the camera at a barcode. Starting the camera
   does not create a Draft; the first accepted item scan creates the Draft
   together with its first line.
6. Fit the whole barcode inside the on-screen guide. A successful scan is confirmed with a message and, if your device supports them, a sound and vibration.
7. Select **Cancel Scan** when you are finished.

The barcode has to be inside the guide to be read. The camera must decode the same barcode in the same format three times within 1.8 seconds before the app accepts it; reads that do not match are ignored. This confirmation typically adds a short delay after the first clear decode. The scanner supports EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, Code 93,
Codabar, ITF, GS1 DataBar, QR Code, Data Matrix, PDF417, and Aztec, including
Code 39 extended characters. It rejects certain invalid numeric codes.
Recognition depends on camera quality, focus, lighting, and barcode condition.

### While scanning

- **Auto-Stop**: Turn this on before scanning if you want the camera to stop after the first successful scan. Leave it off to keep scanning. The Scan Delay prevents the same barcode from being counted again immediately, but does not block a different barcode. Rescanning the same barcode takes at least the selected delay plus confirmation time.
- **Torch**: If your camera supports a light, use this control to turn it on or off.
- **Zoom**: If your camera supports zoom, use the slider to bring the barcode closer.

Torch and zoom controls only appear when the active camera reports that it supports them. The preview is also slightly magnified automatically.

### How scan counts are grouped

Scans with the same barcode, barcode type, Item, Outlet, person, and action are grouped into one row. Each matching repeat scan adds one to that row's quantity. If the type, Item, Outlet, person, or action is different, the scan creates a separate row. Each row keeps the type and time from its first entry.

Person in Charge, Outlet, and Action are read from the fields when each scan is accepted. If the scanned Barcode and type match an active Item in the Admin catalog, that catalog Item is assigned; Outlet does not affect the match and is saved separately. If no active catalog match exists, a unique saved record with the same Barcode and type can supply its Item. Ambiguous saved-record matches are not guessed. If there is no match, an Admin can assign the Item and add its catalog description in Scanner Edit mode.

### Edit an open Draft

When today's Draft has lines, select **Edit**, then open a line's **View Details**
to edit it. Change its quantity, condition, lot or serial details, or optional
reason/reference, then select **Save**. Saving updates the Draft and closes
that line's editor while leaving Edit mode on. **Add Row** and **Undo** are
available only while Edit mode is on; Undo reverses the most recent saved Draft
change. To change an Item, remove its Draft line and add the correct Item.
Action, source, and destination belong to the Draft, not individual lines.
These changes do not affect stock until you post the Draft. Posted movement
history remains read-only; record a new movement to correct a posted movement.

## Read and find your records

Each row shows:

- **Barcode** - the scanned code.
- **Type** - the kind of barcode the scanner read.
- **Item** - the matched or subsequently assigned catalog Item Name.
- **Outlet** - the optional outlet entered before scanning.
- **Quantity** - how many times that barcode was scanned.
- **Action** - Stock Take, Stock In, or Stock Out.
- **Person** - who was in charge.
- **Last Scan** - when the row was first created.
- **Delete** - removes that row.

The **Inventory Summary** below the table shows the number of matching record
rows, quantities for Stock In, Stock Out, and Stock Take, and **Total Activity**
as the sum of those action quantities. All roles see a **Breakdown By Items**
with per-action quantities and totals, grouped by Item Name and Barcode across
Outlets. Different barcodes remain separate entries. Administrators also see
a **Staff Breakdown** with each person's action quantities and total, sorted
from highest activity to lowest; users and guests do not see staff names or
that card. Summary cards share a row on desktop and stack on mobile. Totals
follow the current record scope; Scanner Display Options filters, text search,
and pagination do not change the summary.

- **Display Options**: The Search row allocates 70% to Search and 30% to the Display Options button. Select the button to open the shared inline panel below the full row on desktop and mobile. On mobile, the four tabs appear in a two-column grid; the selected tab is marked by a dark-blue underline and text on the shared light background. All tabs remain visible without horizontal scrolling. **Basic Filters** and **Advanced Filters** retain their field, condition, and AND/OR behavior. Scanner's Warehouse / Location, Action, Person, and Time filters are managed here; create two **Time** conditions (on or after the start date and on or before the end date) for a date range. In **Group & Sort**, add ordered grouping levels and up to ten sorting rules, choose ascending or descending order, and move or remove rules. Scanner and Report add nested headings to table rows and mobile cards without aggregating, removing, or otherwise changing original records. Group levels sort first, followed by remaining sort rules. Report uses its current Person, Date Range, and applied Display Options filters, including Advanced Action conditions, as the grouping scope. It keeps its standard record columns and totals; grouping fields only add headings and organize rows. Active filter, grouping, and sort choices appear as removable chips. Select **Apply** to apply draft filters and Display Options together. **Clear** removes active filters, grouping, and sorting. Quantity refers to each movement record, not a calculated stock balance. **Time** filters the displayed movement timestamp. Report's Action conditions are managed in Report Advanced Filters. Filters narrow the displayed records and exports.
- **Basic Filters**: Field choices use the same names and order as the Scanner table columns. **Type** appears only while the global Barcode Type setting is enabled.
- **Filter suggestions**: Basic Filter text fields and Advanced Filter text values suggest matching values from records available to the page and your account. In Advanced Filters, suggestions change with the selected field, including Action. Choose a suggestion or keep typing any free-form value; suggestions only fill the input and do not apply the filter. Quantity and Time retain numeric and date inputs without autocomplete.
- **Saved Views**: Save Basic and Advanced conditions, AND/OR group logic, ordered sort rules, and custom grouping levels. Scanner filters, including Action, are saved as normal filter conditions. Saved View pickers stay collapsed until opened and show **Favorites**, **Saved on This Device**, and **Online Saved Views** sections in one dropdown. The list prefers to open below its trigger when there is room for a useful portion; longer lists scroll internally, and it opens above only when the space below is too short. It overlays without expanding its surrounding panel; an empty list shows an informational message instead of a placeholder row. Scrolling the page closes an open picker; scrolling inside the list does not. Click or tap outside, press Escape, or select a view to close it. In the filter panel, select a row and choose **Load View** from its menu to apply it; in Build Report, selecting a row applies it as the report source. Use the star to favorite a view, drag its handle to reorder it, or open its three-dot menu for the available Load View, Update View, Share View, Delete, and Move Up/Move Down actions. While dragging, the row lifts and neighboring rows animate into place; keyboard reordering remains available. Delete uses the app's standard warning confirmation dialog; the view's creator can delete their own online view, while administrators can delete any user's or System view. Favorite and ordering preferences are saved in this browser for the current account; saved view definitions retain their existing browser-local or online storage and sharing behavior. Sharing sends settings only, never inventory records. In the Favorite Saved Views & Reports widget, compatible Scanner/Management views apply their filters, grouping, and sorting to the page you are using. Normalized and Warehouse Report Saved Views open through the Report flow instead, including from Scanner or Manual Entry. Manual Entry shows display-only group headings and keeps each editable source row intact. If any rule is unsupported on that page, the app explains why and leaves the current view unchanged. Favorited Reports open the same centered Report Builder modal on Scanner and Manual Entry as on Report, with Focus Report inside and no surrounding Report page. Complete templates enter Focus Report; incomplete templates remain in the builder. Report Action conditions are saved as part of the view. Search text and the Scanner's current-day record scope are not included.
- **Favorites widget access**: Report templates in the **Reports** section appear only when the current account has Report page access. Removing that access hides the section without deleting its favorites; restoring access makes them visible again.
- **Favorites sections**: Saved Views and Reports sections with more than five favorites start collapsed; sections with five or fewer start expanded. Use the section heading to toggle its items. The chosen expanded state remains in effect when the widget refreshes.
- **Search**: Type a word or number to find matching records. Search checks the barcode, type, Item Name, catalog Item Description, Warehouse / Location, quantity, action, person, and movement time. Use the **X** button to clear the search.
- **Sort**: On desktop, use the leading sort buttons in the Barcode, Type, Item Name, Item Description, Warehouse / Location, Action, Quantity, Person in Charge, and Time headers. For multi-column sorting, open **Display Options** > **Group & Sort** and set rule priority and direction. Item Description sorting follows the catalog description displayed in the table.
- **View Settings**: Open **Settings** with the gear button in the top-right corner to show or hide data columns and choose **Auto**, **Compact**, **Spacious**, or **Comfortable** density. On mobile, the Settings header and close control stay visible while the compact settings body scrolls within the device's dynamic viewport and safe areas; scroll through the body to reach every setting and the end of the View Settings list. Auto uses the automatic screen/content sizing behavior. Density changes desktop row and mobile card spacing and text sizing; Compact and Comfortable suggest a collapsed Barcode field, while Spacious suggests showing it. The Barcode checkbox overrides that suggestion. On desktop, row number (`#`) and Item Name are core columns that are always shown and are not listed as choices. Optional columns are listed in table order: Item Description, Action, Quantity, Barcode, Type, Warehouse / Location, Person in Charge, and Time. Item Description, Action, and Quantity are checked by default. Checked optional columns appear in the main table; unchecked optional columns appear as labeled rows inside the bordered View Details panel and are not duplicated in the table. The Settings checkbox is hidden on desktop; on mobile, use **Expand all details** in Settings. Each expanded-card detail row can also be shown or hidden independently, without changing desktop choices. Existing saved desktop choices and manually resized widths are retained. Fresh mobile layouts show Barcode, Warehouse / Location, Person in Charge, and Time; Item, Item Description, Type, Quantity, and Action detail rows start hidden. The compact card header continues to show Item Name, Item Description, Action, and Quantity. Mobile column visibility is saved in this browser.
- **Pagination**: Use the shared pager below each table to choose 10, 25, 50, or 100 rows per page. New and unset preferences default to 10; existing saved custom page sizes are preserved. Scanner, Report, Inventory Management tables, and Admin lists/import previews use the same pager, including on mobile where Scanner and Report show cards. **Fit to Screen** remains in Settings as a separate automatic-sizing preference; Scanner and Report hide that control on mobile while retaining the saved preference. Search, filters, and sorting apply before pagination; summaries and totals continue to include every matching record.
- **Small screens**: Scanner uses cards instead of the wide data table. The Scanner page tightens outer padding and gaps above Search and the cards to give the data more room, while preserving usable touch targets. Search uses 70% of its row and the **Display Options** button uses 30%; the button opens one inline panel below the full row. Its filter, Group & Sort, and Saved Views tabs remain available; long content scrolls inside the panel and Apply/Clear actions stay visible. Active filter, grouping, and sort chips remain visible outside it. Column visibility remains in the Settings window. Card details can be expanded or collapsed, and the displayed movement history is read-only. To correct a posted movement, record a new movement with a reason.
- **On a computer**: A wide screen uses the room it has. The Scanner form's Outlet and Action fields align in full-width rows; the vertical gaps above Search, pagination, and the table are compact so more of the table fits in the viewport. The scan buttons sit side by side, and the camera sits in one centred column. Report filters fill their row, with Build Report above Search; spacing remains compact so the data view has more room. Custom charts are generated inside Build Report. Inventory Management keeps the phone shape with the tabs at the top. The phone layout is unchanged.
- **On the report page**: Columns automatically fit their content, matching Scanner. Drag column edges to resize them manually; those Report widths remain saved separately from Scanner.

## Correcting posted movements

Scanner movement history is read-only. Posted movements cannot be edited or
deleted from the history table, and the legacy row-edit, Undo, and Clear
controls do not apply to normalized movement records. To correct a mistake,
record a new movement with a reason so the ledger retains the original entry
and its correction history.

## Export or share your records

Select **View Report** in the page navigation to open a read-only report in the current tab. It includes Person and Date Range controls, search, sortable columns, pagination, totals, and charts. Action filtering is available through **Display Options** advanced filters and Saved Views; the Report does not inherit the Scanner or Inventory Management standalone Action selection. On wide screens, Person and Date Range share the row evenly; on mobile, the controls stack and start collapsed behind **+ Show Filters**. Choose dates from the calendar, use Today/Yesterday/Last week/Last month/Last quarter shortcuts, or Reset to restore this month's range. Choose a start and end date; both endpoints are included. With no scoped records, the Person/Date controls are hidden; Search and the Display Options button remain visible but dimmed and disabled. They remain enabled when selected criteria return no matches. For an administrator the Person filter is a dropdown of everybody who has records. The report refreshes when saved records change in another tab or when you return to it. The Report page shares your sign-in with the Scanner and Inventory Management pages, so moving between them never asks you to sign in again. If the session has ended, the Report page asks you to sign in without losing the page, and the Report loads as soon as you do.

The Report table uses the Scanner data-column order and default hidden columns, retains sortable headers, and displays an Inventory Summary with total records, total quantity, and nonzero Stock In, Stock Out, and Stock Take totals. Administrators also see Staff Breakdown; users and guests do not see staff names or anonymous activity. All roles see **Breakdown By Items**, with per-action quantities and totals grouped by Item Name + Barcode across Outlets; different barcodes remain separate. The item breakdown follows scoped Report records and is unaffected by text Search or pagination. Report grouping is configured in **Display Options** > **Group & Sort**. Each ordered grouping level adds a nested heading while preserving every original record and the standard Report columns. Grouping and sorting use the Report's current Person, Date Range, advanced filters, and applied Display Options settings. Grouping does not create movement aggregates or Stock Take snapshots. A fresh Report hides Barcode, Type, Outlet, Person, Last Scan, and Modified By by default, just like Scanner; saved Report column choices remain unchanged. The View Details heading includes a compact plus/minus square icon to expand or collapse all details, synchronized with the Settings preference. On desktop, each row's **View Details** button expands fields omitted from the table; its button stays within its table cell. On mobile, Report uses Scanner-style cards and the existing Settings checkbox or each card's **View Details** button to show supplementary fields. Different barcodes, actions, and quantities remain separate records.

The Report's **Report type, scope & columns** section is separate from Display Options and contains report type, warehouse/location, item search, date range, movement scope, and visible-column controls.

The Report Settings **Show Columns** list reflects columns available in the active report. A field hidden through either Report column preferences or Settings appears in that row's **View Details** panel; changing its visibility moves it between the table and details. The View Details column and Full/Compact controls are omitted when there are no hidden fields.

Search uses 70% of its row and **Display Options** uses 30%; its button opens the same shared panel used by Scanner below the full row. Its **Group & Sort** tab adds ordered grouping levels and up to ten priority-based sort rules; grouping levels remain first in their configured hierarchy, followed by remaining sort rules. Grouping adds headings only and keeps every row and column; it does not aggregate Stock In/Out or attach Stock Take snapshots. Basic and advanced conditions support AND/OR joins and groups, Apply/Clear, and removable active-filter chips. Report-local Saved Views and Online Saved Views retain Report filter, grouping, and sort settings, with Action represented as a normal condition when selected. Sharing a device Saved View transfers it online rather than keeping a second device copy; if it is favorited, its favorite status and Favorites order transfer with it. **Remove Share** transfers the favorite back to the restored device view. The creator or an administrator can **Delete** a user-created Online view permanently, or choose **Remove Share** to move it back to this device; other users cannot remove it. Remove Share keeps the picker open and focus follows the transferred view. If a different device view has the same name, rename or remove it before restoring the shared view. System Saved Views retain their existing admin-only Delete action. The Build Report source picker uses the same favorite/reorder list as the Report filter panel, while selecting a source applies its settings to the builder. Report rules are stored separately from Scanner rules and apply alongside Person, Date Range, and Search. Duplicate per-column filter menus are removed. Item Description and Modified By are searchable and sortable. Report **Settings** retain Fit to Screen, the responsive View Settings grid, reset control, and Density choices as Scanner; the shared pager controls page size. Columns automatically fit their content without a separate Fit to Content checkbox.

The Report search icon switches between Smart Search and text search. In Smart mode, a query runs only when you press **Enter**; editing the input does not change the active results. Smart Search uses a bounded local English phrase parser to search text, filter supported fields and actions, group by fields, and sort by fields over the currently loaded Report rows. A non-applying preview shows the interpreted filters, grouping, sorting, and resolved date range before Enter applies them. Mixed conditions use standard precedence: AND conditions are evaluated before OR (for example, `A and B or C` means `(A and B) or C`). Try `show stock-outs of bolts over five, newest first`, `show items with quantity over 5`, `show stock outs at branch North`, `group by outlet`, or `sort by newest`. Sort priorities can be joined with a comma, `then by`, or `and`; for example, `sort by quantity and newest first`. The preview shows the interpreted sort order before it is applied. Use quotes when a literal search phrase contains an action term, such as `find "Stock In Supplies"`. Numeric filters accept digits and common English number words. When a typed prefix has one clear completion, a subtle inline suggestion appears; press **Tab** or **Right Arrow** to accept it. Suggestions draw on the active Report's fields, available templates, and loaded row values; typing never changes the Report type, date, location, or active results. Warehouse terms such as outlet/branch/store and SKU/item code are recognized. For movement reports with separate source and destination fields, location qualifiers follow the action when it clearly identifies one; otherwise, specify `from` or `to`. Relative date phrases include `last 7 days` (today and the previous six days), `last week` (the previous Monday–Sunday), `this week` (Monday through today), and `this month` (the first of the month through today), using Kuala Lumpur dates. The preview does not apply the range; pressing Enter updates the Report date controls and reloads the Report. Smart Search conditions appear as removable chips alongside Display Options filters, grouping, and sorting, remain separate from manually configured conditions, and can be saved with a Report view. Search parsing is local and no AI model is used; saving or sharing a view sends its parsed conditions as part of that view definition.

Smart Search can also open existing destinations when the request is explicit: for example, `open settings`, `go to inventory management`, `open report builder`, or `open stock inspection report`. When you type `open report`, a localized inline hint lists available system, account-saved, and shared report templates; adding part of a template name narrows the hint and can provide a ghost-text completion. Use `open report <template name>` or `open report template <template name>` to open a matching template in the existing focus-only report flow. Suggestions use names currently available in the Report template list, and duplicate names are not guessed. `open report` by itself remains ambiguous and will not open a template; say `go to Report page` to navigate instead. Page navigation respects the signed-in user's existing access. Search-applied confirmations, errors, and ambiguity prompts appear as toast messages. Unsupported or ambiguous requests do not run. Smart Search only applies relative dates to Report types that support a date scope. Other date, warehouse, and location controls remain unchanged unless the query explicitly contains a supported relative date range. The **X** button clears the active Smart Search, and text search remains available from the same input with its existing live-filter behavior.

To create a custom chart, select **Build Report**, then use **Chart Options**
to choose a chart type and value. Generated charts follow the visible sorted
and filtered report rows. Chart options include bar, grouped bar, and pie
charts; select **No Chart** to omit a chart.

Use **Build Report** to create a separate report from normalized datasets.
Choose a dataset and an accessible warehouse or location where applicable, then
select columns, calculations, filters, and an optional chart. The **Load
Preset** picker provides normalized system reports and saved report templates.
Saved presets contain settings, not generated output or inventory records.

Add, remove, and reorder columns using the fields and calculations supported
by the selected source. Each column can use a custom heading. Standard
Inventory options include an as-of date, movement lookback, and stock
thresholds; Warehouse scope and date controls depend on the selected dataset.
Set report parameters, then optionally filter generated rows.

The builder ignores the Report page's current Person, Date Range, Search, and
Display Options settings. A Saved View applies its source-specific filters,
grouping, and sort order: grouping fields lead generated Report Columns and
generated rows follow the saved sorting. Views without grouping use the
default columns. Selecting a template applies its explicit column layout while
retaining its supported scope and sorting. Aggregate-only Stock Records
accounts receive totals without underlying records or private Person, Barcode,
or Editor fields; their available dimensions and calculations are limited.
Warehouse output is scoped to accessible normalized data. Select
**Generate Report** to open the result in focus
mode and hide builder settings; **Report Builder** restores them. On wide
desktop screens, generated results appear beside the builder when not focused;
the builder controls use English Title Case. Before focus mode, mobile keeps
the result below the controls. Sort by a column heading and
filter individual columns;
multiple column filters combine with AND. Filters update the generated chart to
match the visible rows; sorting changes the table order without changing chart
values. Use **Clear Filters** to remove all generated table filters and restore
the rows; the button is enabled only while a filter is active. The summary
retains the full report totals, while Excel and Print use
the visible sorted/filtered rows. **Export** opens the shared export dialog;
choose **Download**, or **Share or Save to Cloud** when the browser supports
sharing `.xlsx` files. In browsers that do not, download the file and share it
from your device. In **Chart Options**, changing **Chart**
immediately redraws an already generated report's chart without rebuilding its
table; **No Chart** removes only the chart. Choose **Chart Value** in Chart
Options to redraw with record count or a numeric report calculation. Bar charts
place negative values on the negative side of zero; a pie chart displays an
explanation instead of turning negative values into positive slices.
Unavailable calculations remain missing instead of being plotted as zero.
Closing the builder clears the generated report; reopening starts a fresh
report. **Save** stores settings privately on this device. It changes to
**Saved** with a checkmark only after storage succeeds; editing the template
name or settings resets the button. To share or remove a template, use its
three-dot row menu in the template picker. The
picker matches Saved Views: favorite templates with the star, rearrange them
with the drag handle or Move Up/Move Down, and find favorites in their own
section. These preferences are saved per user in this browser. Sharing
publishes settings only; recipients generate results from their own permitted
records. A creator cannot share another template with the same name again.
Online Saved Views appear in the Saved Views tab. The template picker separates
device-local, System Warehouse, and Online Shared Report Templates. Legacy
System definitions are hidden from the picker and retained in storage; the
available System Warehouse templates use normalized report definitions.
Existing device-local and user-shared templates remain available. Shared
entries contain settings only, never inventory records or generated report
output. Creators or admins can remove online shared entries.
After sharing a local template, the picker stays open and focuses the new
Online Shared template. On mobile, Report pagination calls its page-size
choice **Cards per page**; on desktop it remains **Rows per page**.

For each Report Builder column, you can enter an optional custom heading. It
changes only the generated builder report and its Excel export; the `.xlsx`
export includes the current search, filters, and sort order. Standard Report
table headings are unchanged. Saved templates retain custom headings. On wide
desktop screens, generated output appears beside the builder; on narrower
screens, it remains below the controls. The column list scrolls internally
when it exceeds the available space. Navigate **Columns** and **Inventory**
with the tabs above the settings panel; **Chart Options** remains below the
active panel and contains both Chart Type and Chart Value. The Save button is
before Generate Report and changes to Saved after successful storage. The
three-dot row menu acts on its template; removing
a local template asks for confirmation and removes only that template from
this device and account.

Export buttons are available when the main table has records.

- **Export to Excel** creates an `.xlsx` file with a **Records** sheet. If there are manual edits, it also includes an **Edit Log** sheet.
- **Export to CSV** creates a records file. If there are manual edits, it creates a second file for the edit log.
- Scanner exports include the data columns currently displayed, in table order, and only the rows on the current page. Fields shown under View Details are added in Scanner column order when not already displayed; expanding the panel is not required. Active person/account scope, filters, search, and sort order are respected; Operation, row number, and View Details controls are omitted. Barcode Type follows the Admin display setting. Excel embeds rendered barcode images when **Show Barcode Images** is enabled; CSV keeps barcode values as text. The edit log shows what field changed, its old and new values, who made the change, and when.

After choosing an export format:

- Select **Download** to save the file or files to your device.
- Select **Share or save to cloud** to open your device's sharing menu, if your browser supports sharing files. Choose an available app or destination there. The app does not upload directly to a cloud service.
- Select **Cancel** to close the export window without downloading or sharing.

The same export window is used by the four download buttons on the Excel Import tab of the inventory management page, so a template or a copy of the inventory is saved or shared in the same way. Admin Configuration data exports and import-template downloads use the shared window with **Download** only; sharing is hidden. Generated barcode images continue to download directly.

File sharing depends on your device and browser. If sharing is not available, download the files and attach them manually. Some browsers share only a fixed list of file types, and an Excel file may not be supported; in that case, download it and share it from your device's file manager. CSV files may be shareable even when Excel files are not. For the best results, open the app directly in a browser rather than inside another app.

**CSV tip:** Spreadsheet apps may remove leading zeroes from barcodes or show long barcodes in scientific notation. When importing a CSV into a spreadsheet, set the Barcode column to **Text**.

## Work without a connection (offline stock take)

The app can be used at a site with no internet access.

- Open the app once while you have a connection so it can store the app shell and the last inventory on your device. After that the scanner opens even when you are offline.
- A yellow banner at the top shows when you are offline, how many changes are waiting, and how many stock-take batches still need review.
- While offline you can scan, edit, and delete records. The changes are kept on your device and are not sent to the shared inventory.
- Select **Continue as guest** in the account panel if you have no account on this device. Guest access works with or without a connection. Registration and password reset always need a connection. Each device keeps its own guest records, so the work of one guest device is never mixed with another's.
- A guest can sign in or create an account later with **Sign in or create an account** in the account panel. The work captured as guest on that device is handed over to the account, including any stock-take batch the device uploaded earlier. Only a guest is offered this option.
- If you sign in with a real account later, the work captured as guest is tagged to that account before it is sent.
- Records captured before the guest account was split per device are taken over by the first guest device that opens them, so that older guest work stops being shared.

When the connection comes back, the queued changes are sent as one **stock-take batch**. The shared inventory does not change until someone reviews and imports the batch, so nobody's live numbers are overwritten by a surprise sync.

## Inventory Management

Select the gear button, then **Inventory Management** in the first row, to open the management page. Its three tabs—**Manual Entry**, **Excel Import**, and **Review Batch**—are evenly sized across the available width on desktop and mobile.

**Manual Entry**

- Shows the records in the shared inventory in a table that matches the scanner table.
- The table is read-only at first. Select **Edit** to turn editing on, and **Done Editing** to turn it off again. While editing is on, the fields become editable and a delete button appears in the first column.
- Leaving the Manual Entry tab turns editing off. If you have unsaved changes, a confirmation asks you to continue first, and the changes are only undone after you accept it.
- Changing Show, Action, Source, Date Range, Search, or a favorite Saved View while changes are unsaved asks what to do first. Cancel keeps the current filter and edits. **Discard & Change** discards the edits and applies the requested filter; to keep the edits, cancel, select **Save Records**, then change the filter.
- The **Last Scan** column stays read-only in every mode, because it records when the item was captured.
- Select **Add Row** to add an item, enter its Item, Outlet, Quantity, and Action, then select **Save Records**. Barcode and Type are read-only in Manual Entry; they cannot be typed or pasted into the table. Click either cell to open the generator with the row's current Item and Type. In the mobile row editor, click either read-only field to open the generator. A unique saved Item match automatically fills its Barcode and Type; if the Item has several distinct barcode/type matches, choose one from **Saved Barcode Matches**. Every row saved with a Barcode must have a Type.
- The generator previews a Code 128, QR Code, Code 39 Extended, Code 93 Extended, Data Matrix, PDF417, or Aztec barcode from the Item value. As you type, Item suggestions come from inventory visible to your signed-in account. Saved types the generator cannot preview can still be applied with **Use Barcode**. With no saved match, the **Encoded Value** is the exact Item text; duplicate Item names may produce the same barcode. Choose whether to include readable text, select a Small, Medium, or Large image size, and download a GIF, JPG, PNG, or SVG copy if needed. The image format menu is alphabetical and initially selects the format with the smallest actual file for the barcode and current settings; a format you choose manually stays selected while the dialog is open. UPC-A, EAN-8, and EAN-13 use separate numeric **Barcode Data** inputs without the check digit. The check digit and full barcode are calculated as you type; UPC-A takes 11 data digits, EAN-8 takes 7, and EAN-13 takes 12. ITF uses a separate numeric **Barcode Data** input with an even number of digits and no checksum. Non-numeric characters are removed from these numeric inputs as you type. Use an assigned retail identifier where applicable; the generator calculates the check digit but does not assign product codes. The Item name stays separate and is saved in the Item column. Select **Use Barcode** to apply the generated or matched Barcode, Type, and Item to the row. Select **Cancel** to close the generator without changing the row.
- The Show, Action, Source, Date Range, and Search filters determine which rows are displayed. Use the date-range calendar or its Today, Yesterday, Last week, Last month, and Last quarter shortcuts; both selected endpoint dates are included. **Save Records** saves only changed records on the current page, and its success message counts those changes. If you move to another page with unsaved edits, choose **Stay Here**, **Discard & Continue**, or **Save & Continue**. A failed save keeps you on the current page.
- The delete button in the first column removes that row from the table. Select **Save Records** to apply your changes. A message at the bottom of the screen confirms the save, and editing ends so the table is read-only again. Duplicate checking uses the exact barcode, Type, Item, Outlet, Action, and Person values. It checks rows matching the active Show, Action, Source, Date, and Search filters, so duplicates outside those filtered results do not block a save.
- **Undo** and **Clear** appear above Search only while Edit mode is on. **Undo** reverses the most recent Manual Entry change—an edit, added row, deletion, or Clear—and can step back through up to 50 actions. This history is for the current editing session and is cleared after saving or reloading. **Clear** asks for confirmation and removes only rows on the current page that match the active filters. These changes remain unsaved until you select **Save Records**.
- The **Type** column is read-only; click it or the Barcode field to open the generator. The **Person in Charge** column is plain text, the same as on the scanner page, so the person of a record never changes by accident while a line is edited.
- The **Source** column shows how each line was first created: **Scan** (read with the camera), **Manual** (typed in) or **Import** (from a file). It is never changed by a later edit, and it survives an offline stock take that is imported later. Lines made before this was kept are shown as **Scan**, because scanning was the only way to add a record back then. Hide the column with **Show Columns** in the settings if you do not need it.
- The **Source** filter beside Action narrows the table to **Scan**, **Manual**, or **Import** records. Choose **All Sources** to show every source. The **Date Range** picker filters records inclusively between its selected endpoints; use the calendar or quick presets, and select **Reset** to show every date. On a wide screen, Show, Action, Source, and Date Range share the row evenly above Add Row. On a phone, the carrot-orange (**#e67e22**) **+ Show Filters** button reveals the filter group above Search; select **- Hide Filters** to collapse it again. The group starts collapsed on page load. When there are no records available, filters and the toggle are hidden; if a filter or search has no matches, the controls remain available so you can change them.
- The table columns can be adjusted like the scanner table: open the settings (gear) and use **Show Columns** to hide or show a column, and drag the right edge of a column heading to resize it. The **Fit to Content** box works here as well, so the columns follow the content they hold. On a narrow screen the table hides the columns that do not fit, and a column you chose yourself is kept. The column layout is remembered in this browser.
- The **Show** dropdown beside the page title narrows the table to one person. It is offered to an administrator only, and it lists everybody who has records. It changes what is shown; saving only writes changed rows on the current page.
- Search the table with the search box above it, the same one the scanner page uses. It looks at the barcode, type, item, outlet, person, time, and source. Select the **X** button to clear the search without changing the active person, Action, or Source filters. With nothing to show, the table says so.
- The **Previous** and **Next** buttons sit above the table, so you can change page without scrolling to the bottom of a long list.
- **Add Row** focuses the read-only **Type** field; click it or the Barcode field to open the generator for the new row.
- Saving refuses a quantity that is not a whole number of 1 or more, and a line that is listed twice, and tells you which line is the problem.
- The settings window shows a table selector and independent **Rows**, **Fit to
Screen**, **Density**, and **Show Columns** preferences for the active tab.
Manual Entry, Import Preview, Batch List, and Batch Changes keep separate row
counts, density, and column choices. Import Preview and both Review Batch
tables are paginated; a spreadsheet preview is no longer capped at 50 rows.
Batch List and Batch Changes have separate column groups, and the required
Review and selection controls remain available. **View Report** opens the
report page. Changes are saved in this browser.

**Excel Import**

- Select **Download Blank Template (CSV)** or **Download Blank Template (Excel)**, or download **Current Stock** in either format. All four use the shared save/share dialog. The blank template columns are Action, Item Code, Warehouse Code, Location Code, Quantity (Base Unit), Stock Condition, Lot Code, Serial Numbers, and Reason. The Excel template includes dropdowns for supported actions and conditions, and suggestions for available warehouses, locations, and active Item Codes. Item Codes can also be entered manually.
- Upload a CSV, XLS, or XLSX file up to 5 MB with 1–100 non-empty data rows. The importer suggests column mappings; review or change them before importing. The selected file name and a paginated preview are shown, and the file control stays locked until **Cancel** clears the import.
- Rows are checked against active Items and accessible warehouses, locations, and lots. Serial-number rules are enforced for serial-tracked Items. Invalid rows are highlighted; edit a mapped cell in the preview to correct it, then wait for the row to be revalidated. The preview uses the shared import workflow component for editing and commit handling.
- Choose **Stock In**, **Stock Out**, or **Stock Take**. Stock In and Stock Out rows post as immutable ledger movements. Stock Take rows are grouped into a Count Session for one location per spreadsheet; duplicate Stock Take dimensions must be combined into one row.
- Import adds the source file name and spreadsheet row to each movement's reason. Posting uses retry-safe keys, so a partially completed import can be retried without duplicating posted movements. Current Stock exports report an error rather than silently truncating results above 5,000 rows.
- Select **Import Rows** to review the confirmation and post valid rows. Select **Cancel** to clear the preview; posted movements remain in the ledger. If you select another tab while a file is loaded, the app asks before clearing the preview.

**Review Batch**

- Lists the stock-take batches that are waiting, with the date, the person who captured them, the number of changes, and the status. Use the **Show** list to switch between batches waiting for review, imported batches, discarded batches, and all batches.
- Select **Review** on a batch to see every change. New rows are green, changed rows are amber, removed rows are red, and conflicts are highlighted.
- Select **Details** on a row to compare each field with the shared inventory and choose **Use my version**, **Merge field by field**, or **Keep the shared version**. With a field-by-field merge, choose **Mine** or **Shared** for each field.
- The starting choice is the safe one: a row that duplicates an existing item is skipped, and a field that changed on both sides keeps the shared value.
- Clear the **Use** checkbox to leave a change out of the import.
- Select **Import Selected** to apply the reviewed changes, or **Discard Batch** to leave the shared inventory untouched. Both buttons stay dimmed until a batch is open.
- The changes are paged, and **Select all on this page** takes every change in the batch at once.
- A record that was created offline is given its own id when it is imported. If a row shows as **Already removed**, the shared inventory does not have that record yet: import the earlier batch first.
- If you select another tab while a batch is open, the app asks first and closes the batch when you continue.

## Settings and saved data

Select the gear button in the top-right corner to open the shared Settings
window. On wide screens, page shortcuts appear in a left sidebar and the
settings cards appear beside them; on smaller screens they stack. The **Page**
sidebar shows shortcuts allowed on the current page and for the signed-in
account; Admin Configuration is only shown to administrators. **System**
contains the browser's saved language choice and the **Date format** and
**Time format** selectors. The date/time preference is saved on this device and
changes presentation only; server timestamps always display in Kuala Lumpur
time (MYT), and stored or retrieved values are unchanged. The format preview
uses the current server time only while Settings is open. Scanner also has
**Scan Delay**.
The **Help** disclosure stays below the settings cards. Expand it to show links
to the Quick Guide, README, and this User Guide; the links stay together on one
row.
Scanner, Report, and Inventory Management have **Data Table** controls for
Fit to Screen, Density, and the columns available on that page or table. Page
size is selected in each table's shared pager; Scanner and Report pagers count
mobile cards as rows. On mobile, the Scanner and Report Fit to Screen control
is hidden while its saved automatic/manual preference remains in effect. The
desktop-only Row Number option is not offered for mobile cards. Density appears
before **Show Columns**. Report results use expandable cards instead of the wide
table on small screens; sorting, grouping, filters, and details remain available.
Review Batch in Inventory Management
offers a table selector for Batch List and Batch Changes; Manual Entry and
Import Preview do not show a redundant one-option selector.

The Scanner's optional columns include catalog-derived Item Description,
Action, Quantity, Barcode, Type, Warehouse / Location, Person in Charge, and
Time. Type starts hidden in a fresh or reset layout. On a
narrow screen the table hides columns that do not fit, and the reset button
next to **Show Columns** returns the choice to the app. **Fit to Content** is
hidden in Settings; existing saved sizing preferences and automatic fitting
behavior remain in effect. **Fit to Screen** lets the page size follow the
screen as well. Page-size, density, and column preferences are saved in this
browser.

The person name, selected action, scan delay, records, and edit log are saved automatically in the browser. Signed-in accounts share the same inventory across devices; signing out clears the offline queue and the cached copy from this device.

## If something is not working

- **The camera will not start:** Allow camera access in the browser, close other apps that may be using the camera, and open the app in a secure browsing context supported by your browser.
- **The barcode will not scan:** Put the whole barcode inside the on-screen guide, improve the lighting, hold the camera steady, and make sure the barcode is not damaged. Try the torch or zoom if those controls are available.
- **There is no torch or zoom control:** The current camera or browser does not report support for that feature.
- **Scanning or Excel export will not load:** Check your internet connection and reload the page. The scanner works offline once the app has been opened online at least once; the camera library is only cached after that first load.
- **Saved records are missing:** Check that you are using the same browser and device as before, and that you have not signed out, which clears the offline copy from the device.
