Score explanation fields

Score explanation is a response and storage shape, not a separate public v1 endpoint.

Where this appears

Search and Enrich responses include vegan_score. The deeper score explanation schema is the canonical structure used for deterministic VeganScore explanation records. It is documented here so customers can understand the field model without treating it as an API route.

Canonical explanation shape

Field	Type	Notes
schemaVersion	"1.0.0"	Schema contract version.
restaurantId	string	Restaurant document ID.
chainBrand	string \| null	Chain brand when available.
scoringVersion	"v3.0-deterministic"	Scoring model version.
overall	number	Overall VeganScore from 0 to 100.
summary	string	Short explanation summary.
dimensions[]	array	Exactly D1-D6, always present in order.
explanationConfidence	low \| medium \| high	Deterministic confidence bucket.
generatedAt	string	ISO timestamp for generation time.

Dimension IDs

Field	Type	Notes
D1	veganCoverage	Coverage of vegan menu signals.
D2	veganQuality	Quality and depth of vegan options.
D3	ingredientClarity	Ingredient and menu clarity.
D4	crossContamination	Shared equipment and preparation signals.
D5	staffKnowledge	Signals about staff understanding.
D6	restaurantQuality	General restaurant quality context.