---
id: TST-COM-ORD-067
title: Entitlements read
kind: integration
product_area: commerce
module: orders
revision: 1
status: draft
source_sha:
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
repository: services-commerce
files:
  - modules/entitlements/tests/integration/services/persistence/entitlements.queries.integration.spec.js
implements: []
environment: local
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 2
isolation: The suite creates its own test workspace records and removes them using the fixture cleanup.
evidence:
  - provenance: test
    source: >-
      services-commerce:modules/entitlements/tests/integration/services/persistence/entitlements.queries.integration.spec.js
    test_cases:
      - 'getEntitlement answers the record whole, and undefined for another tenant’s or an unknown id'
      - 'listEntitlements answers a holder’s newest first, narrowed by kind, product, state and order, bounded'
      - listEntitlementsOfOrderLine answers the line’s grants oldest first
      - >-
        listExpiredEntitlementsAcrossTenants answers the active grants past their window in both tenants,
        oldest expiry first, and nothing before any has lapsed
      - refuses the cross-tenant read inside another transaction
scenario_coverage: []
dependency_evidence:
  provenance: test
  source: >-
    services-commerce:modules/entitlements/tests/integration/services/persistence/entitlements.queries.integration.spec.js
  declared_by_test: 'PostgreSQL, the persistence service, the execution contexts under `rhythm_commerce_app`. Doubled: nothing.'
---

# Entitlements read

## Verification Boundary

The suite exercises persistence or workflow operations against the local integration database.

## What This Suite Proves

The registered cases check entitlements read with their fixture records and assertions. Scenario bindings name only the examples those cases exercise.

## What It Does Not Prove

A registered file supplies no run result or verified conformance by itself. Local fixtures do not establish deployed cross-service behavior or complete browser journeys.

## Real Dependencies and Test Doubles

PostgreSQL and the exercised Commerce persistence or workflow code are real. Remote service records, clocks and transports follow the suite’s fixtures.

## Must Not Be Doubled

The database constraints, role restrictions, locks and transactions exercised by this suite must use PostgreSQL.