Storage & open-vial stability

Locations, suitability warnings, and post-open stability (separate from expiry).

Storage location + profile
    └── matches reagent requirement? ──yes──► OK
                              └── no ──► warning on item page

Open item ──► open-vial rule (N days) ──► daily /stock/open_vial_emails/

Locations and requirements (admin)

  1. Add → Storage location opens a new location. Edit Data → Storage location lists, edits, or activates/deactivates locations. Deactivating hides a location from new bookings; existing stock is unchanged. A shelf or door sits under a fridge, freezer, or ULT.
  2. Inventory → Storage map draws each unit with named shelves and a door, marks the reagents stored there, and prints a list of what is where. A lot can stay on the unit until someone moves it onto a shelf.
  3. Maintain temperature/humidity on the location profile where that data is used.
  4. Per-reagent state requirements: Any / Unopened / Opened / Dissolved / Reconstituted. Notes also sit on Add → Reagent as Storage requirement notes.
  5. Change the catalogue default with Edit Data → Change Default Storage Location.
Storage locations dictionary with Edit and Deactivate
Edit Data → Storage location. Same pattern as Supplier, Project, Process, Experiment, and consumers: Edit, Activate/Deactivate, and Add on one page.
Edit Data dropdown listing dictionaries and bulk storage moves
Edit Data menu: storage is grouped with the other dictionaries, below reagent defaults.

Move an item on the Storage map

  1. Inventory → Storage map → select a unit. Click a reagent name to open its record. Drag its label, or expand Show items and drag a barcode, onto a shelf, door or Not on a shelf yet.
  2. If the label contains several items, choose one barcode. The move form identifies the item, source and destination. Select a reason, enter an explanation and click Record move. Cancel leaves the location unchanged. Clicking a barcode opens the same form without dragging.
  3. Not on a shelf yet means the lot is stored on the fridge/freezer unit itself. Move onto a shelf or back to the unit as needed. Recheck storage suitability afterwards.
Storage map shelves and items not yet assigned to a shelf
Unit stock and shelf stock are separate drop targets.
Barcode move confirmation with source, destination, reason and notes
Every confirmed move records the reason, explanation, actor and previous/new locations.

Move multiple items (admin)

Edit Data → Move multiple items between storage locations: select the owning lab, source and destination, then Review items. Opened and unopened items for lab-owned reagents are eligible; finished items and shared reagents are excluded. Older rows without a lot owner may be included when their reagent belongs to the selected lab.

Untick items that should stay, acknowledge any suitability warnings, tick the confirmation and type MOVE. Only Confirm move selected items changes locations. A storage move does not transfer ownership between labs. Old/new locations remain in the audit trail.

Bulk move review with opened and unopened lots and extra confirmations
Review the eligible barcodes before confirming; no locations change during review.

At the bench

  1. The item page shows Location. A suitability warning appears if the location profile does not match the reagent requirement.
  2. Change location with the item Actions → Adjust (one change type at a time: volume, expiry, or storage; reason required).
  3. Open Item starts the open-vial countdown when a rule exists. Confirm storage and attribution; they seed the usage trail.
  4. Warning → use before the limit; breach → Finish / Discard with a reason (for example open-vial exceeded).
Item page showing storage location Post Lab Room Temp Hood
Location is part of the lot summary. Storage requirement notes on the reagent panel explain what the location should satisfy.

Dashboard and digest

The dashboard (application name) has cards for Open-Vial Warnings and Open-Vial Breaches (count against open vials). Click Open on a card to jump to the matching list.

Dashboard including open-vial warning and breach cards
Open-vial cards sit with low stock, expiry, not validated, and pending transfers.

Operations: schedule /stock/open_vial_emails/ once per day from this server, or with X-Cron-Token (idempotent). See Reports & alerts.