---
id: TST-PFM-OPS-017
title: Job family repository
kind: integration
product_area: platform
module: operations
revision: 1
status: draft
source_sha:
  macroservice-libraries: 54536a441935c6e09fdb7f96f0bec71c52ba4e03
repository: macroservice-libraries
files:
  - packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts
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:
  - >-
    macroservice-libraries:packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts
    at 54536a441935c6e09fdb7f96f0bec71c52ba4e03: existing suite body, setup, assertions and cleanup.
binding_note: This existing engineering suite is registered without claiming a complete specification scenario.
assertion_sources:
  - >-
    macroservice-libraries:packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts#creates
    every column the root contract declares, under the name the contract gives it
  - >-
    macroservice-libraries:packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts#creates
    every column the step and event contracts declare
  - >-
    macroservice-libraries:packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts#writes
    the root, its whole step catalog and its first event in one transaction
  - >-
    macroservice-libraries:packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts#maps
    the submission onto the family’s own columns through rootValues
  - >-
    macroservice-libraries:packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts#stamps
    the requesting actor as the root’s sys_created_by_id
  - >-
    macroservice-libraries:packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts#answers
    the job the submission identity already names, creating nothing new
  - >-
    macroservice-libraries:packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts#refuses
    a second root for one submission identity under the constraint name the engine reads from the
    registry
  - >-
    macroservice-libraries:packages/jobs/src/tests/integration/job-family-repository.integration.spec.ts#commits
    all three together
---

# Job family repository

## 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 job family repository 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.