> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maska.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Stock dashboard

> See live on-hand quantities, stock value, and low-stock alerts per location.

The stock dashboard is your live picture of inventory — how much of each item is
on hand, what it's worth, and what's running low — broken out per
[location](/procurement/glossary). Every receipt, transfer, adjustment, and stock
take updates it, so the numbers you see are the current
[stock balance](/procurement/glossary), not a nightly snapshot.

<Note>
  What you see depends on who you are. **Owners and managers** get a network-wide
  console view across every warehouse, kitchen, and outlet. **Outlet staff** see
  only their own outlet's stock. The sections below call out which is which.
</Note>

## How stock is valued

Quantities are stored in each item's base [unit (UOM)](/procurement/glossary). The
value of what's on hand is `quantity × average cost`, where the average cost is
maintained by [weighted moving average (WMA)](/procurement/glossary) — every
receipt blends the price you just paid into the running average. So "stock value"
always reflects what your inventory actually cost you, not a list price.

An item is flagged **low** when its on-hand quantity falls to or below the
[par level / reorder point](/procurement/glossary) set for it at that location.
Items with no par set are never flagged low.

## The console view (owner / manager)

Managers and owners land on a dashboard home that rolls the whole network into a
few headline numbers, then drill into the full inventory screen for detail.

### Dashboard headlines

The owner home surfaces, at a glance:

<CardGroup cols={2}>
  <Card title="Stock value">
    Total value of on-hand stock across all locations, with a count of how many
    locations it spans.
  </Card>

  <Card title="Low stock">
    How many items are below their threshold network-wide — a one-tap route into
    the low-stock list.
  </Card>

  <Card title="Active POs">
    Open purchase orders, and how many are in transit toward a location.
  </Card>

  <Card title="Procurement spend">
    Month-to-date spend with a trend versus last month and a six-month bar trend.
  </Card>
</CardGroup>

The **manager** home reframes the same data as a "Needs your action" list —
pending requests, **Low stock alerts** across all outlets, active POs awaiting
outlet confirmation, and GRN variances to review.

### The inventory screen

Opening the inventory screen gives managers and owners two toggles:

<Steps>
  <Step title="Warehouse · master">
    The full item catalog at the warehouse, as a table: each item's tier
    (raw / semi / finished), category, average price, on-hand quantity, par, a
    level bar, and value. A KPI band on top shows warehouse inventory value, total
    SKUs, value held at outlets, and how many items are below half-par. You can
    filter by tier, by category, or to just the low items, and search by name.
  </Step>

  <Step title="Outlets">
    A card per outlet (and central kitchen), each showing that location's stock
    value, item count, and an **at-par** percentage — plus a **LOW** badge when
    items there have dropped below half their par. Tap a card to open that
    location's full stock-in-hand table.
  </Step>
</Steps>

Managers can also switch the warehouse table between **Active**, **Archived**, and
**All** to see archived items, and act on a row directly — edit the item, view its
movement, or archive it.

<Note>
  The inventory screen is also where you reach a **stock take**. The on-hand
  figures it shows are the recorded balance; a stock take is how you reconcile
  that against a physical count. See the
  [glossary](/procurement/glossary) for stock take and variance.
</Note>

### A single outlet's stock (console)

Opening an outlet card shows every item stocked there as a read-only table —
on-hand vs par with level bars, a value column, and a status pill that reads
**OK**, **WATCH**, or **LOW** depending on how far on-hand has dropped against par.
Three KPIs head the page: stock value, the at-par percentage, and how many items
are below half-par. You can search, filter to just the low items, and copy an
item's SKU. Counting itself happens in the stock take, not here.

## Per-item drill-down

From any inventory list, opening an item shows its full stock story:

* **Total stock** across locations, the par, and the last price paid.
* **Stock by location** — a row per location with on-hand, a level bar, and that
  location's par, so you can see where the stock actually sits.
* **Sourcing** — the vendors that supply the item, with the preferred/default one
  marked.
* **Recent movement** — the [stock ledger](/procurement/glossary) for this item:
  GRNs received, transfers in and out, consumption, opening balances, and
  adjustments, each with a signed quantity and when it happened.
* **Change history** — the field-level [audit log](/procurement/glossary) (old
  value → new value, who, when). This section is **owner/manager-only**; other
  personas see the item read-only without it.

## The staff (outlet) view

Outlet staff see a stock screen scoped to their own outlet — never another
outlet's, and never the warehouse master. It opens with two stat tiles:

* **On-hand value** — the value of stock currently in their outlet.
* **Below par** — how many items have dropped below their par, out of the total.

Below that is a searchable, category-filterable list of every item in the outlet,
each row showing on-hand, par, a low pill, and a stock-level bar. Tapping a row
opens the same per-item detail (minus the owner-only change history). The staff
home also pulls these numbers forward — when items are running low it offers a
**Quick order** shortcut prefilled with the short items.

<Warning>
  When a **weekly stock take** (blind count) is open for an outlet, that outlet's
  on-hand figures and low-stock flags are **hidden** for staff — masked on the
  stock list and stat tiles — so the recorded numbers can't be back-solved while
  the physical count is in progress. The figures reappear once the count is
  submitted. Owners and managers are not masked.
</Warning>

## Low-stock alerts

The dedicated low-stock screen lists items at or below their reorder threshold,
split into **Out of stock** (nothing on hand) and **Running low**, with a search
box. The action button adapts to who you are: managers and owners get **Raise PO**
(straight into a new purchase order), while staff get **Order** (into a purchase
request). This list is scoped to the master warehouse, matching the console's
"running low" headline.

<Note>
  Low-stock counts and the stock dashboard always agree because both read the same
  live balances. If a number looks off, confirming a pending
  [GRN](/procurement/confirm-grn) or posting a stock-take adjustment will bring it
  current.
</Note>
