Admin & master data
Reagents, dictionaries, recipes, users, and system mode. Lab users do not see Edit Data or Add (they get New Inventory Item only).
Reagents / suppliers / storage / projects ──► book-in & item actions Users + groups + lab memberships ──► active lab / stock view scope System mode (normal / degraded / read_only / downtime) ──► write guard + banner
Reagents
- Add → Reagent — Main reagent details include name, manufacturer, supplier, catalogue #, defaults, min stock, tracking/UOM, validation, iPassport and home lab/shared settings. The separate COSHH section follows.
- Edit Data → Edit Reagent — do not hand-edit stock counters.
- De/Activate Reagents stays on this menu (separate from the dictionary pages).
- Change default supplier / storage / minimum via the dedicated Edit Data tools.
Dictionaries
Add → or Edit Data → Manufacturer, Supplier, Project, Process, Experiment, Internal consumer, External consumer, Storage location. Add opens the new-entry form. Edit Data opens the list. Record the manufacturer (maker) separately from the supplier (ordering source).

Catalogue changes, storage moves and audit history
Existing barcodes retain their booked description, manufacturer, units and handling settings; catalogue edits apply to future bookings. Current COSHH safety updates also apply to existing stock and are audited. See Reagent documentation.
Edit Data → Move multiple items between storage locations reviews opened and unopened lab-owned stock before extra confirmations. Finished and shared stock are excluded. See Storage.
Inventory → Audit trail provides system-wide filters, pagination, affected-record links and previous/resulting states. See Validation & traceability.
Worksheets
Add → Worksheet template designs a sheet for one study: headings, boxes to type or write by hand, and reagents whose lots are chosen later. Edit Data → Worksheets changes that design. Saved sheets are not rewritten.
Add → Worksheet, or Inventory → Worksheets, saves one filled copy. Open lots are listed first with barcode, lot, storage, and expiry. Blank boxes can be written on the printout. The saved sheet keeps the study, the operator, the date, and the lots used.
Each screen lists current entries. Use Edit or Activate / Deactivate on a row, or Add on that same page. Deactivate rather than delete when history exists.
Recipes and solutions
- Edit Data → Recipes (admins) or Inventory → Recipes (lab users). Add → Recipe asks for the date made, a witness (another user), each ingredient barcode, the volume used, and the total volume of that unit.
- Create a solution from a recipe — date made, witness (another user), component barcodes, volume used and the total volume of each unit → new inventory item (lot number defaults to the barcode).
Continuity and maintenance
| Action | Where |
|---|---|
| System mode (normal / degraded / read_only / downtime) | Edit Data → System Mode / Continuity |
| Banner text shown to all users | Same form |
| Prime empty DB | /stock/prime/ then change the default admin password |
| Rebuild volume counters | /stock/vol_migrate/ from this server, or with X-Cron-Token, after controlled imports only |
Users and roles
Edit Data → Edit users (superusers only) opens Django admin at /stock/admin/auth/user/ for accounts, groups, staff flags, and active status. Laboratory memberships (Laboratories in the same admin) still control active lab and stock view.
- Saving a user or using Reset password creates missing ForceReset / login-security rows if they do not exist yet.
- Admin Reset password emails the temporary password even if Emailed is already ticked.
- The user must change that password before they can use the rest of the app.
Reports → Role review export is the spreadsheet of roles for periodic review. Do not export or screenshot live user lists into uncontrolled documents — they contain names and email addresses.