Glossary

Term Meaning
Instance A tenant. Almost all data and requests are scoped by instanceId
Decision graph The rule document format used to express promotion eligibility
Rule engine The engine that compiles and executes decision-graph eligibility rules in memory
Action The effect a promotion applies (percent_off, BOGO, free_shipping, …) — 14 types
OfferType Numeric taxonomy (1–5) constraining which action types are allowed
DiscountType Numeric taxonomy (1–4); type 4 requires a formula action
Group A collection of promotions with a selection strategy and caps
Stacking Applying multiple discounts to one cart; controlled by mode/strategy/caps
Promotion list Reusable condition value-set (SKUs/customers/categories) referenced via listRefs
Wallet Per-customer store of targeted promotion grants
Promocode A code that maps to a promotion, with type-driven usage limits
Preview vs Evaluate Display (non-committing) vs Apply (commits code redemptions)
Proximity message Near-miss “add X more to qualify” hint for summed-up offers
Change stream MongoDB feed that syncs the in-memory orchestrator across processes
In-memory mode Local dev mode replacing external deps with stubs

Revision History
2026-08-05 | JP – Created the page and added the content.