---
id: TST-PFM-OPS-073
title: Jobs queries
kind: integration
product_area: platform
module: operations
revision: 1
status: draft
source_sha:
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
repository: services-platform
files:
  - modules/jobs/tests/integration/services/persistence/jobs.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: 5
estimate_basis: Scheduling estimate only; no duration is measured during this documentation pass.
isolation: >-
  The prepared local test database and suite-owned identifiers; existing hooks control rollback or
  cleanup.
evidence:
  - >-
    services-platform:modules/jobs/tests/integration/services/persistence/jobs.queries.integration.spec.js
    at ad3f6a6582843008ed0f5a17b131878d15829af1: existing suite body, setup, assertions and cleanup.
binding_note: This existing engineering suite is registered without claiming a complete specification scenario.
assertion_sources:
  - >-
    services-platform:modules/jobs/tests/integration/services/persistence/jobs.queries.integration.spec.js#answers
    each job under an id of the job id grammar
  - >-
    services-platform:modules/jobs/tests/integration/services/persistence/jobs.queries.integration.spec.js#maps
    every instant of a summary as an ISO 8601 UTC timestamp with milliseconds
  - >-
    services-platform:modules/jobs/tests/integration/services/persistence/jobs.queries.integration.spec.js#answers
    the whole summary of a job that carries every field: a retry that ran, failed a step and settled
  - >-
    services-platform:modules/jobs/tests/integration/services/persistence/jobs.queries.integration.spec.js#answers
    the whole summary of a job that was never started, every optional field null
  - >-
    services-platform:modules/jobs/tests/integration/services/persistence/jobs.queries.integration.spec.js#answers
    the whole summary of a job of a tenant whose step is still running
  - >-
    services-platform:modules/jobs/tests/integration/services/persistence/jobs.queries.integration.spec.js#answers
    the whole summary of a cancelled job, which settled without ever starting a step
  - >-
    services-platform:modules/jobs/tests/integration/services/persistence/jobs.queries.integration.spec.js#answers
    the whole summary of a succeeded job of another customer, complete at a hundred
  - >-
    services-platform:modules/jobs/tests/integration/services/persistence/jobs.queries.integration.spec.js#carries
    no field on a summary beyond the common contract: never the execution handle or the row version
---

# Jobs queries

## Verification Boundary

This suite exercises background work through production operations against the local database. Its implementation is present at the pinned source revision, and this register records no execution result.

## What This Suite Proves

The checks exercise jobs queries within the file’s declared setup and assertion boundary. The structured assertion anchors distinguish these checks from the surrounding feature flows. No complete specification scenario is attributed to this suite yet.

## What It Does Not Prove

Local execution does not establish deployed infrastructure, live commercial-provider configuration or authorization-cache completion. Registration and an implemented suite do not establish a passing result.

## Real Dependencies and Test Doubles

The prepared PostgreSQL database and production operations under test are real. Execution startup or probing uses a test channel where the suite declares one.

## Must Not Be Doubled

The persistence operations, database constraints and reads under assertion remain real.