The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.
| # | Surface | Action | Capability | Expected | Provenance |
|---|---|---|---|---|---|
| 1 | /console/{tenantId}/configuration/orders/promotions/new | Prepare Books and Apparel benefit parts and a minimum purchase | CAP-COM-CAT-014 | The draft presents the configured parts and summary | test react-console:e2e/mock/promotions.mock.spec.ts#a new promotion is created for a category, shown on its view, and an edit to 15% comes back to the view |
| 2 | /console/{tenantId}/configuration/orders/promotions/{id}/codes/new | Create restricted single-use and organization-limited shared codes | CAP-COM-CAT-015 | The saved code pages present their dates and capacity choices | test react-console:e2e/mock/promotions.mock.spec.ts#a code is added in the code editor with a limit and a note, and lands on its page |
| 3 | /console/{tenantId}/configuration/orders/promotions/{id}/codes | Request a generated batch and export its completed codes | CAP-COM-CAT-015 | Issuance history identifies the batch and provides its downloadable export | test react-console:e2e/mock/promotions.mock.spec.ts#Generate Many starts a job that the Issuances tab lists |
| 4 | /console/{tenantId}/configuration/orders/promotions/{id} | Assess a member’s sample cart through Try It | CAP-COM-CAT-018 | The response shows sample discounts and pre-tax, pre-shipping totals | test services-commerce:modules/promotions/tests/e2e/promotion-previews.e2e.spec.js#is, line for line and total for total, what the real checkout preview answers |
| 5 | activatePromotion | Have an authorized administrator activate the campaign | CAP-COM-CAT-014 | Active state and the transition appear in promotion history | test services-commerce:modules/promotions/tests/e2e/promotions-security.e2e.spec.js#activates a draft and resumes a paused promotion |
| Path | From step | Condition | Path taken | Outcome | Provenance |
|---|---|---|---|---|---|
| alternate | 5 | The manager requests launch without the separate grant | Launch remains absent from permitted console actions and fails backend access | An authorized activator is required to leave preparation state | test services-commerce:modules/promotions/tests/e2e/promotions-security.e2e.spec.js#cannot activate a draft, 403 permission_missing |
| failure | 5 | No usable claim exists for the coded offer | Activation fails validation saying a code is needed | Activation leaves preparation state unchanged | test services-commerce:modules/promotions/tests/e2e/promotions.e2e.spec.js#refuses to activate a coded promotion with no active code, 409 no_active_code |
| failure | 2 | Entry duplicates an occupied claim after normalization | The code fails validation as taken | The invalid operation persists no change | test services-commerce:modules/promotions/tests/e2e/promotion-codes.e2e.spec.js#refuses “EARLY25” beside “early 25”, 409 code_taken |
| Id | Statement | Provenance |
|---|---|---|
01 | Promotion history retains each lifecycle action and supplied reason. | test services-commerce:modules/promotions/tests/e2e/promotions.e2e.spec.js#records every transition on the history, newest first, with the reason given |
02 | Management authority does not include launch authority. | test services-commerce:modules/promotions/tests/e2e/promotions-security.e2e.spec.js#cannot activate a draft, 403 permission_missing |
03 | A saved console edit returns to the updated promotion view. | test react-console:e2e/mock/promotions.mock.spec.ts#a new promotion is created for a category, shown on its view, and an edit to 15% comes back to the view |
04 | Repeated issuance requests reuse their existing batch. | test services-commerce:modules/promotions/tests/e2e/promotion-code-issuances.e2e.spec.js#answers the same batch for a repeat under the same key and makes no second batch |
05 | All Codes provides cross-promotion code discovery. | test react-console:e2e/mock/promotions.mock.spec.ts#All Codes lists the codes of every promotion and narrows them by search |
06 | Sample assessment leaves sale records and usage unchanged. | test services-commerce:modules/promotions/tests/e2e/promotion-previews.e2e.spec.js#consumes no use of any promotion |
End-to-end policy: required: It crosses the promotion, code and issuance screens and depends on the console offering each action exclusively to the right role.