Files
govoplan-services/docs/SERVICES_DOMAIN.md
T

2.5 KiB

Services Domain

Ownership

Services owns stable service identities, stable keys, and immutable definition revisions. Portal owns public presentation and entry. Cases owns concrete case lifecycles. Forms, Workflow, Mandates, Organizations, and Policy retain their own definitions and are linked by exact versioned references.

Publication And Availability

Publication and runtime availability are separate. Published definitions may still be unavailable when a required module, capability, policy, mandate, connector, maintenance state, or audience condition is not satisfied. The provider reports what it can establish; consumers explain unknown requirements instead of silently treating them as available.

Draft and retired definitions are excluded from the general provider catalogue. Administration APIs retain their complete revision history.

Catalogue and unversioned detail reads follow the platform temporal-data context. Valid time answers when a definition applied; the independent recorded cutoff reconstructs what was known then. Exact service references remain exact, and current availability and authorization are revalidated for new launches.

Revision And Recovery

Writes are replay-safe and use optimistic concurrency against the current revision. Definitions are append-only; only the prior row's supersession marker changes. The stable key cannot change across revisions or collide with another current service in the tenant.

Database restore is the recovery unit. Consumers retain the exact service reference and revision used for a case or publication, so restore and audit do not depend on whatever definition happens to be current later.

Data-subject request ownership

Services publishes privacy.dsar.services for the personal attribution on definition revisions. It accepts exact-tenant account, identity, and membership selectors; optional service or revision references only narrow and corroborate the actor match. Results contain bounded definition identity, revision, publication, and temporal facts. Definition payloads, search text, and unrelated author activity are excluded. Append-only attribution remains institutional evidence, so the provider publishes retain-only, non-executable actions.

Services stores no resident interaction or launch execution. Portal resolves and presents definitions without persisting an interaction. Cases, Forms Runtime, or Workflow Engine owns the concrete launch effect selected by the binding and supplies its corresponding data-subject request coverage.