Skip to main content

Recipe List

The recipe list is the central management view for all recipes in OpSee. It provides a DataGrid with search, filtering, status management, versioning, and CRUD operations.

Recipe list view

Dashboard summary​

At the top of the page, four KPI cards give you an at-a-glance summary:

CardDescription
TotalTotal number of recipes in the system
ActiveRecipes with the active flag enabled
DraftActive recipes currently in Draft status
ApprovedActive recipes that are approved for production

Grid columns​

The recipe list DataGrid displays the following columns:

ColumnDescriptionCompact ViewFull View
CodeRecipe identifier (monospace)VisibleVisible
VersionVersion number badge (e.g. v1, v2)VisibleVisible
NameRecipe display nameVisibleVisible
DescriptionOptional description textHiddenVisible
ProductOutput material/product nameVisibleVisible
StatusLifecycle status chip (Draft/Review/Approved/Obsolete)VisibleVisible
ProcedureLinked batch procedure nameHiddenVisible
CreatedCreation timestampHiddenVisible
ActiveActive/Inactive chipVisibleVisible
ActionsEdit, delete, status change, new version buttonsVisibleVisible
tip

Toggle between compact and full column views using the column visibility icon in the filter bar. You can also use the DataGrid's built-in "Manage Columns" panel to show/hide individual columns.

Searching and Filtering​

The filter bar provides these controls:

ControlBehavior
SearchFilters by recipe name, code, or product name (case-insensitive)
StatusDropdown to filter by status: All, Draft, Review, Approved, Obsolete
Show InactiveToggle to include recipes with active = false
Column ToggleSwitch between compact and full column visibility
Clear FiltersReset all filters, search text, and column widths to defaults

Status management​

Each recipe follows a controlled lifecycle. You can change a recipe's status directly from the list:

  1. Click the status chip in the Status column
  2. A context menu shows the available transitions for the current status
  3. Click the desired transition

Status transitions​

Current StatusAvailable Actions
DraftSubmit for Review
ReviewApprove, Return to Draft
ApprovedMark Obsolete
Obsolete(no transitions)
info

When a recipe is approved, the approving user's name is recorded automatically. This information is stored for traceability and is visible in the audit trail.

Editing restrictions​

Only recipes in Draft status can be edited or deleted. This includes:

  • Modifying the recipe name, code, description, or any field
  • Adding, editing, or removing formula items
  • Adding, editing, or removing phase parameters
  • Adding, editing, or removing equipment requirements

If you need to change an approved or obsolete recipe, create a new version instead.

Creating a New Version​

Versioning allows you to iterate on recipes while preserving the history of previous versions.

  1. Click the version action button (copy icon) on any recipe in the list
  2. A confirmation dialog appears showing the recipe name and current version
  3. Click Confirm to create the new version

What happens when you create a new version:

  • A new recipe record is created with the same code but an incremented version number
  • All child records are copied from the source recipe:
    • Formula items (bill of materials)
    • Phase parameters (setpoint overrides)
    • Equipment requirements
  • The new version starts in Draft status, regardless of the source version's status
  • The new version is marked as active = true
tip

You can view all versions of a recipe that share the same code. Use the search field to filter by code and see the complete version history side by side.

Creating a Recipe​

  1. Click the Add Recipe button above the DataGrid
  2. Fill in the form fields on the General tab (see Getting Started for field descriptions)
  3. Click Create
  4. The recipe is created with version v1 in Draft status

Editing a Recipe​

  1. Click the edit button (blue pencil icon) on a Draft recipe row
  2. The edit dialog opens with tabs:
    • General -- recipe metadata (name, code, product, procedure, batch size, etc.)
    • Formula -- bill of materials (details)
    • Parameters -- phase setpoint overrides (details)
    • Equipment -- equipment requirements (details)
  3. Make your changes and click Update
info

The Formula, Parameters, and Equipment tabs are only shown when editing an existing recipe (not during creation). Create the recipe first, then edit it to add sub-resources.

Deleting a Recipe​

  1. Click the delete button (red trash icon) on a Draft recipe row
  2. Confirm the deletion in the dialog

Only Draft recipes can be deleted. Approved recipes must first be marked as obsolete -- but they cannot be deleted, only archived for traceability.

Prerequisites​

Next steps​