[T09] Stock Activity

Tenant-scope list of all operational_batch rows + per-batch drill-down. The destination for every Round A routerLink="['/inventory/stock-activity', batchId]" dead-end:

For a full-mode STOCK_TAKE batch the drill-down renders five report categories: Expected - Found (member + scanned), Expected - Missing (member + NOT scanned + flipped to ISSUED via STOCK_TAKE_MISSED, keeping or restoring its last holder), Returned (scanned, not a member, not unfit — the register had the number out, and the scan puts it back in stock with the holder cleared), Unfit (scanned while UNFIT_FOR_SERVICE — the number was physically in front of the operator, and is to be pulled off the shelf for disposal rather than reissued; the tab is hidden when the take scanned none), Unmatched (NOT_FOUND; likewise hidden at zero). A STOCK_TAKE that is not full-mode has no expected set, so it renders a single Scanned list instead.

Actor: tenant admin, stock operator, finance / audit reviewer.
Frequency: ad-hoc during incident review; weekly during event seasons.
Precondition: user has TENANT_ADMIN permission; sidebar tenant scope active (see C01 § sidebar).
Entry point: the Activity tab of the Numbers & Tags section (C01), at numbers/activity and numbers/activity/:batchId. Deep links from T02, T03 and T04 also lead here. The earlier stock-activity routes redirect.

T09 renders inside C01’s shell — sidebar (tenant scope) + topbar are C01’s. T09 owns the main content area.

Both original follow-ups have landed: GET /api/operational-batches/{id}/state-log and GET /api/operational-batches/{id}/members are exposed, so the detail body no longer needs its "endpoint pending" fallback.

The Unfit category needs no new endpoint either — a STOCK_TAKE_SCAN row records the state the number was in when it was scanned, so oldState = UNFIT_FOR_SERVICE identifies it.

2026-09-23 — category names, header totals, and a fifth tab. The original labels described the code’s bucketing predicate rather than what the operator sees. A take that put 438 boards over the reader reported "In-stock 337", and "Outsider" named boards that are plainly ours — the register simply had them out. The categories are now Expected - Found, Expected - Missing and Returned.

The scanned total was not on the screen at all: it is the sum of two tabs. The header card now carries Expected, Scanned and Missing, and "Attached rows" becomes Log entries, with an info affordance on each, since that figure counts state-change rows rather than numbers and therefore reconciles with neither total.

Unfit is split out of Returned because it drives a different action: those numbers are on the shelf but must be pulled for disposal rather than reissued, and an operator working from the Returned list would put them straight back into circulation. It is scoped to this take — a number is listed only if it was scanned — so the tab is a pull list for the boxes in front of the operator, not a view of the unfit register. Most takes will scan none, so the tab is hidden when its count is zero, as Unmatched is: both report an exception, and an exception tab reading zero is noise on every ordinary take. The three counting tabs stay visible at zero, because a zero on those is itself an answer — nothing missing, or nothing returned.

A STOCK_TAKE that is not full-mode has no snapshot, so every scan would fall under Returned and Expected - Found would always be empty. Those batches render a single Scanned list.

Raised by the Afrimat board stock take, where the four original labels could not be reconciled with the number of boards actually scanned.