Skip to main content

Recipes and Recipe ID

A Gnaww Job Specification is the complete canonical demand and run model. It can contain a physical Recipe plus run-specific requirements such as quantity, turnaround, destination and use requirements.

A Recipe is the exact canonical physical manufacturing definition inside that Job Specification.

A Recipe ID is the deterministic permanent identity of an eligible exact Recipe.

Gnaww Job Specification
├── Recipe
│   └── Recipe ID
├── quantity
├── turnaround
├── destination
└── other run constraints

Identity rules​

Quantity normally does not change physical Recipe identity. Two runs of 500 and 5,000 copies can reference the same Recipe ID while having different SpecMatch outcomes, production routes or later commercial state.

Gnaww does not mint a permanent Recipe ID for unresolved or tolerant identity-defining physical demand. Clarification remains explicit until a safe exact identity exists.

Developer operations​

Use:

  • POST /v1/recipes to resolve an already-canonical eligible Gnaww Job Specification to immutable Recipe identity;
  • GET /v1/recipes/{recipe_id} to read the safe physical Recipe resource;
  • POST /v1/recipes/{recipe_id}/matches to run SpecMatch using that Recipe plus supplied run context.

Recipe ID is not a customer identifier, order number, producer selection, price or availability state.

Last updated on