Rhythm 2.0 Specifications

Appearance

ATS-COM-CAT-009Retrieve purchased digital files: Capability Test Specification

Markdown

ATS-COM-CAT-009

Retrieve purchased digital files: Capability Test Specification

Markdown
  • DocumentProposed
  • Product intentProposed

Planning

Proves capability
CAP-COM-CAT-009

Design

Executed by
TST-COM-CAT-012

KindAcceptance test setProduct areaCommerceModuleCatalog and Selling ConfigurationRevision2

Read atservices-commerce c8b66a98react-console baf6dae3

Retrieve purchased digital files: Capability Test Specification ​

Coverage ​

RuleProof Scenario or Gap
BR-CAP-COM-CAT-009-01ATS-COM-CAT-009-01
BR-CAP-COM-CAT-009-02ATS-COM-CAT-009-02, ATS-COM-CAT-009-04
BR-CAP-COM-CAT-009-04ATS-COM-CAT-009-03
BR-CAP-COM-CAT-009-05ATS-COM-CAT-009-01, ATS-COM-CAT-009-04

The interaction boundary remains a recorded coverage gap until a complete scenario establishes the handoff. Download access follows the listing’s retained file.

Coverage describes specified proof. A binding names the existing assertions that contribute to it; proposed designs remain unexecuted.

Coverage

  • Rule gap: FND-COM-CAT-063
  • Transition gap: FND-COM-CAT-063
  • Validation gap: FND-COM-CAT-063
  • Permission covered
  • Edge gap: FND-COM-CAT-063
  • Failure gap: FND-COM-CAT-063
  • Boundary gap: FND-COM-CAT-063
  • Concurrency gap: FND-COM-CAT-063
  • Invariant covered
  • Interaction covered

Test Scenarios

4 scenarios proving CAP-COM-CAT-009; 3 bound to an existing test.

01 Member downloads reject foreign, expired and unknown grantspermissionapinegativetest
Proves
BR-CAP-COM-CAT-009-01 BR-CAP-COM-CAT-009-05
Preconditions
Two contacts and an expired grant exist
Steps
Use another contact’s grant, the expired grant and an unknown grant
Expected
Access or expiry refusals apply, and the unknown grant is not found
Data
Entitlement grants
Bound to
Source
services-commerce:modules/catalog/tests/e2e/downloads.e2e.spec.js#refuses an expired grant 409 and another member’s grant 403
02 Download retries preserve finite capacityinvariantapitest
Proves
BR-CAP-COM-CAT-009-02
Preconditions
A finite grant and distinct request keys are available
Steps
Consume the allowed uses, repeat a key and request another new use
Expected
Retries retain the prior remaining count and a new request after exhaustion fails
Data
Entitlement grants
Bound to
Source
services-commerce:modules/catalog/tests/e2e/downloads.e2e.spec.js#gives the grant’s owner a signed link and consumes one use per Idempotency-Key (a retry costs nothing), until the grant is exhausted (409)
03 Console support preserves download capacitypermissionapitest
Proves
BR-CAP-COM-CAT-009-04
Preconditions
A member has a limited grant
Steps
Request its file as console support
Expected
A signed link returns without consuming member usage
Data
Entitlement grants
Bound to
Source
services-commerce:modules/catalog/tests/e2e/downloads.e2e.spec.js#gives a console user the link without consuming a use
04 Download access follows the listing’s retained fileinteractionapiproposed
Proves
BR-CAP-COM-CAT-006-04 BR-CAP-COM-CAT-009-02 BR-CAP-COM-CAT-009-05
Preconditions
A buyer owns a finite download grant for digitally delivered merchandise with one retained private file.
Steps
Download the file, replace the listing’s file, then request the old file, the retained replacement and a repeated request key.
Expected
The detached file is not found, the replacement is available under the same grant and a repeated key does not consume another use.
Data
Run-owned workspace, prepared file fixtures and independent fault injection at the handoff.
Source
services-commerce:modules/catalog/services/downloads/downloads.ts:downloadFile,rhythm-v2-docs:specs/commerce/catalog/design/workflows/WF-COM-CAT-008-download-an-entitled-file.md#WF-COM-CAT-008

The Markdown files under specs/ in rhythmsoftware/rhythm-v2-docs are the canonical source of truth. This reader is a generated, read-only projection of them.

Rhythm Software