Traceability

Trace material flow forward and reverse through the supply chain, and generate recall scope reports

admin

Traceability

The Lot Traceability page lets you search any lot in your supply chain and trace the full lineage of materials — forward from an ingredient to finished deliveries, or reverse from a delivery back to the originating inputs. It also generates recall scope reports. It lives at Traceability in the main navigation.

Lot types

Sporeline assigns a lot ID to each material entity in your supply chain:

Lot Type	Represents
Ingredient	Raw input material (substrate, supplements)
Spawn	Grain or sawdust spawn used for inoculation
Substrate Batch	A prepared substrate batch before bagging
Block	An individual mushroom block
Harvest	A recorded harvest event
Delivery	An outbound delivery to a customer

Running a trace

Enter a Lot ID in the search field and select a Trace Direction, then click Search (or press Enter).

Trace Forward

Shows the downstream chain starting from the searched lot — all blocks produced from that ingredient, all harvests from those blocks, all deliveries containing those harvests, and so on. Results are displayed as a collapsible tree.

Trace Reverse

Shows the upstream chain starting from the searched lot — which batches a block came from, which substrate batch that batch used, which ingredients went into that substrate, and so on. Results are displayed as a collapsible tree.

Navigating the tree

Each node in the trace tree shows the lot type badge, lot ID, and supplier (if applicable). Nodes with linked items show a count badge. Click any node that has children or parents to expand or collapse that branch. The top three levels are expanded by default.

Recall Scope report

Select Recall Scope as the trace direction and enter a lot ID. This generates a full downstream impact report suitable for regulatory recall documentation.

The report shows:

Section	Contents
Summary KPIs	Counts of affected blocks, harvests, deliveries, and customers
Affected Blocks	Block IDs, associated batch IDs, and current stage
Affected Harvests	Harvest IDs, associated block IDs, and recorded weight
Affected Deliveries	Delivery IDs, customer IDs, delivery date, and status
Affected Customers	Customer name, contact name, email, and phone number

If no downstream entities are found, the report shows an empty state indicating no recall scope.

Exporting the recall report

Click Export JSON in the recall report header to download a .json file containing the full recall scope, including a timestamp, source lot details, summary counts, and all four affected-entity tables. The filename is formatted as recall-report-{lot_id}-{timestamp}.json.

Tips

Use Trace Reverse first to understand what inputs went into a lot before generating a recall scope. This helps you confirm you have the right source lot before running the impact analysis.
Lot IDs are found on block detail pages, harvest records, and delivery records throughout the app.
The recall export JSON is designed to be attached to regulatory filings or shared with food safety auditors.