---
id: TST-PFM-NOT-091
title: preferences
kind: integration
product_area: platform
module: notifications
revision: 1
status: draft
source_sha:
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
repository: services-platform
files:
  - >-
    modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js
implements:
  - ATS-PFM-NOT-015-01
  - ATS-PFM-NOT-015-02
environment: local
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 5
isolation: >-
  Suite-owned records in the prepared integration workspaces; seeded workspace
  identities remain shared fixtures.
assertion_bindings:
  - scenario: ATS-PFM-NOT-015-01
    suite: TST-PFM-NOT-091
    assertions:
      - >-
        services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js#refuses
        to turn the console off
      - >-
        services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js#refuses
        to turn e-mail off for a mandatory definition
      - >-
        services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js#refuses
        to leave a channel-configurable definition with every channel off
      - >-
        services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js#accepts
        a channel-configurable definition with one channel on, the negative
        control of that refusal
      - >-
        services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js#refuses
        a daily digest for a definition that is not digestible
      - >-
        services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js#refuses
        a category that does not exist
      - >-
        services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js#refuses
        a definition scope with no registered definition
  - scenario: ATS-PFM-NOT-015-02
    suite: TST-PFM-NOT-091
    assertions:
      - >-
        services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js#refuses
        a stale version with a 409 and leaves the choice as it was
      - >-
        services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js#refuses
        to overwrite a choice without naming the version
evidence:
  - >-
    services-platform:modules/notifications/tests/integration/services/persistence/preferences.integration.spec.js
  - The file and referenced assertion titles exist at the pinned commit.
dependency_evidence:
  - >-
    Real: PostgreSQL, the persistence service, the policy. Doubled: nothing.
    Never doubled: the database or the service.
---

# preferences

## Verification Boundary

This suite exercises the local services and prepared PostgreSQL database. API lifecycle cases use signed test contexts through the real route handler; they do not invoke the deployed gateway.

## What This Suite Proves

Its cases exercise validate choices against required delivery; reject missing and stale optimistic versions.

The registered scenario bindings identify the assertions this executable file contributes. They retain individual test references so that a composite scenario does not become a claim of complete execution by one file.

## What It Does Not Prove

Local outcomes do not prove deployed queues, external provider acceptance, production credentials or complete browser behavior. No fresh execution or conformance result is claimed.

## Real Dependencies and Test Doubles

The notification fixtures use real PostgreSQL and module logic. Queue publication, visibility changes, nudges and installed channel adapters are recorded at their seams when the suite needs them. Signed API contexts replace the authorizer key in API suites.

## Must Not Be Doubled

Database constraints, workspace policy, state guards and the service operation under test must remain real. Recording a provider or queue call must not replace the submission, claim or outcome logic being checked.
