The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.
| # | Surface | Action | Capability | Expected | Provenance |
|---|---|---|---|---|---|
| 1 | createPriceQuote | Add the guide to the member’s cart | CAP-COM-CAT-013 | The cart initially uses the eighty-dollar audience amount | documented services-commerce:docs/milestones/plans/COMM-M1-plan.md#D5. The order of the price calculation |
| 2 | checkout preview (orders module) | Enter the noncombinable quarter-off code | CAP-COM-CAT-016 | The seventy-five-dollar Standard-based alternative is selected and explained | test services-commerce:modules/promotions/tests/unit/pricing/alternatives.spec.js#2. combine = no, member: audience pricing $80.00 against $100.00 less 25 % = $75.00; the promotional price wins |
| 3 | order placement (orders module) | Complete placement | CAP-COM-CAT-017 | The applied code and promotion gain usage and the promotion’s terms lock | test services-commerce:modules/promotions/tests/integration/services/persistence/promotion-redemptions.integration.spec.js#counts one use on the code and one on the promotion |
| 4 | releasePromotionRedemption | Release the redemption under override authority with a reason | CAP-COM-CAT-017 | Usage is restored and the order retains the release event | test services-commerce:modules/promotions/tests/e2e/promotion-redemptions.e2e.spec.js#records order.promotion_released on the order, with the actor and the reason |
| Path | From step | Condition | Path taken | Outcome | Provenance |
|---|---|---|---|---|---|
| alternate | 2 | Student qualification supplies a sixty-dollar audience alternative | Audience selection wins without applying the claim | No use is consumed and the purchaser is told why | test services-commerce:modules/promotions/tests/unit/pricing/alternatives.spec.js#3. combine = no, student at $60.00: audience pricing wins, EARLY25 consumes no use, and the buyer is told why |
| alternate | 3 | Another code already retains the lines | The code is retained on the order as not applied | Placement retains the unused claim without decrementing capacity | documented |
| failure | 3 | The claim interval ends before placement | The placement fails validation | Nothing is persisted | test services-commerce:modules/promotions/tests/unit/pricing/validation.spec.js#expired: at or after the window closes |
| failure | 3 | The selling area does not permit say which lines qualify | The placement fails validation with a request to try again | Nothing is persisted | test services-commerce:modules/promotions/tests/unit/pricing/parts.spec.js#refuses a code promotion_check_unavailable when a part is listed unavailable, and discounts nothing |
| Id | Statement | Provenance |
|---|---|---|
01 | The selected result respects both lowest-price comparison and prohibited combinations. | test services-commerce:modules/promotions/tests/unit/pricing/alternatives.spec.js#never applies a promotion that does not combine to a line left on its audience price |
02 | An unapplied ineffective code does not consume capacity. | test services-commerce:modules/promotions/tests/unit/pricing/alternatives.spec.js#records as applied only the promotions that gave a discount; a code that gave nothing is rejected and not applied |
03 | Release restores usage once and remains recorded in both histories. | test services-commerce:modules/promotions/tests/e2e/promotion-redemptions.e2e.spec.js#refuses the second release, 409 already_released |
End-to-end policy: required: The journey crosses calculation, order placement and redemption records, making end-to-end financial proof necessary.