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
Edit Data dropdown with manufacturer and bulk storage moves
Edit Data: recipes and reagent tools, then dictionaries, then supplier approvals/catalogue, system mode, and (superusers) Edit users.

Reagents

  1. 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.
  2. Edit Data → Edit Reagent — do not hand-edit stock counters.
  3. De/Activate Reagents stays on this menu (separate from the dictionary pages).
  4. Change default supplier / storage / minimum via the dedicated Edit Data tools.
Main reagent details with manufacturer and supplier
Main reagent details come first; COSHH classifications and references are grouped below.
Add menu with separate manufacturer and supplier entries
Add includes Inventory Item, Reagent, Recipe, Manufacturer, Supplier and the other master-data and worksheet forms.

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).

Manufacturer dictionary with add, edit and deactivate actions
Maintain manufacturers using the same dictionary pattern as suppliers.

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.

Suppliers dictionary
Supplier dictionary. The same layout is used for projects, processes, experiments, consumers, and storage locations.
Storage locations dictionary
Storage location dictionary. Deactivating hides the location from new bookings.

Recipes and solutions

  1. 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.
  2. 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).
List of Recipes
List of Recipes: name, number of components, shelf life (months), Active. Click a name to open the recipe.

Continuity and maintenance

ActionWhere
System mode (normal / degraded / read_only / downtime)Edit Data → System Mode / Continuity
Banner text shown to all usersSame 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
System mode and business continuity controls
Read-only and downtime modes block write workflows but keep continuity exports available. A non-normal mode also shows a System: … item on the toolbar.

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.

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.

Assign at least one laboratory membership to accounts that will book in or use stock. An admin with Active Lab: None can maintain master data but cannot open, use, finish, or adjust lots.