Skip to content

DOM-PFM-DJE-005Data Run

Markdown

DOM-PFM-DJE-005

Data Run

Markdown
  • DocumentDraft
  • ImplementationObserved

Planning

Specified by
CON-PFM-DJE-005

Design

Owned by
SVC-PFM-DJE-data-jobs

KindDomain objectProduct areaPlatformModuleData Job EngineRevision1

Read atservices-platform ad3f6a65services-crm a8d1364fservices-membership 5994c270

Relationships

ToCardinalityOwnershipCrosses a serviceOn archive or delete
DOM-PFM-DJE-003many-to-many: runs can reuse uploads and each run can name severalPlatform retains upload objects independently of run reset.no
DOM-PFM-DJE-001one-to-many: each dataset attempt identifies its submitted jobThe destination service owns the job; the run copies its identity and progress counts.yes
DOM-PFM-DJE-004one-to-many: reconciliation can consult multiple producer mappingsEach destination owns the mappings read through its lookup operation.yes

Invariants

InvariantProtectsEnforced atProvenance
INV-DOM-PFM-DJE-005-01
Registration requires the manifest’s destination workspace to be in implementation status and loading state.
servicetest
INV-DOM-PFM-DJE-005-02
Registration writes nothing unless every dataset upload is completed and its stored size and available digest agree with the manifest.
serviceobserved
INV-DOM-PFM-DJE-005-03
Dataset ordering rejects unknown dependencies and cycles before persisting the run.
servicetest
services-platform:modules/data-jobs/tests/integration/services/runs/register-run.integration.spec.js#refuses a package whose datasets cannot be ordered, before any row of it is written
INV-DOM-PFM-DJE-005-04
Step rows link submitted states to a child job, and the driver permits at most two submissions with the second reserved for blocked work after dependencies finish.
database, serviceobserved
INV-DOM-PFM-DJE-005-05
The persistence transition table prevents a final run from returning to active execution.
serviceobserved
INV-DOM-PFM-DJE-005-06
Dataset calls use the requesting staff member’s authority and forward the current token without retaining it.
servicetest
services-platform:modules/data-jobs/tests/integration/services/runs/run-driver.integration.spec.js#forwards the staff caller’s own token with every call, and invents no identity of its own
INV-DOM-PFM-DJE-005-07
Failure and cancellation preserve committed records; the run performs no automatic compensation and workspace reset is the removal path.
servicedocumented
services-platform:modules/data-jobs/services/runs/run-driver.ts (module comment, "It stops on failure and keeps what it did")

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.