Custom Record

What It Models

A custom record is one entry in an organization’s register. It combines typed property values with a derived number and name, optional publication, attachments, links and retained revisions.

Identity and Attributes

Creation fixes record identity before attachments are prepared. The object’s definitions determine validation and naming; archival retains content, while deletion removes record data and preserves history.

Relationships

The parent controls ordinary write availability, properties govern values, and Associations owns the links that influence deletion.

Invariants

Record saves apply current rules and concurrency checks. Supported mutations commit audit, history and events together, and deletion follows relationship safeguards within one transaction.

How It Is Stored and Shared

Custom Objects owns the shared record and value store. Queries reads it through granted interfaces; endpoint functions let CRM apply transactional deletion and merge effects. The event queue handles delivery after commit.

Open Design Questions

Platform’s asset cleanup is absent, leaving abandoned or detached copies. Per-owner limits and HTML processing are separate unresolved planning issues.

Relationships

To	Cardinality	Ownership	Crosses a service
`DOM-PFM-MTD-004`	many-to-one	The record stores its parent identity and follows that object's lifecycle and naming configuration.	no
`DOM-PFM-MTD-002`	many-to-many	Metadata owns definitions; the record owns each keyed property value.	no
`DOM-PFM-MTD-006`	one-to-many	Associations owns links naming the record; deletion applies link policy, and reference values can target native or custom records.	yes

Invariants

Invariant	Enforced at	Provenance
`INV-DOM-PFM-MTD-005-01` Ordinary mutations require an active parent object; records under draft or archived definitions remain readable by identity and reject direct writes.	service	test services-platform:modules/custom-objects/tests/e2e/custom-object-records.e2e.spec.js#refuses every write of it with 409 and changes nothing
`INV-DOM-PFM-MTD-005-02` The write validates live properties and rejects unknown, archived or invalid inputs at the property key without echoing values.	service	test services-platform:modules/custom-objects/tests/integration/services/persistence/custom-object-records.integration.spec.js#names the object’s label in that refus
`INV-DOM-PFM-MTD-005-03` Unique properties permit one holding record per normalized value, trimming and case-folding text.	service, database	test services-platform:modules/custom-objects/tests/integration/services/persistence/custom-object-records.integration.spec.js#refuses a hull number another boat hol
`INV-DOM-PFM-MTD-005-04` References resolve in the workspace to their declared target type, and custom targets must be unarchived.	service	test services-platform:modules/custom-objects/tests/integration/services/persistence/custom-object-records.integration.spec.js#refuses a manufacturer that is a boat
`INV-DOM-PFM-MTD-005-05` Published records carry a publication timestamp, and nonpublishable objects reject publication actions.	service, database	test services-platform:modules/custom-objects/tests/integration/services/persistence/custom-object-records.integration.spec.js#refuses publication on an object that
`INV-DOM-PFM-MTD-005-06` Changed attachment values require asset preparation; direct unprepared references cannot be persisted.	service	test services-platform:modules/custom-objects/tests/integration/services/persistence/custom-object-records.integration.spec.js#names a create’s missing upload at pro
`INV-DOM-PFM-MTD-005-07` Version checks prevent stale record mutations, and applicable locks block writes.	service	test react-console:acceptance/custom-objects/playwright/journeys/PLAT-M5-S06.spec.ts#PLAT-M5-S06: two registrars edit one boat; the second is told and nothing is los
`INV-DOM-PFM-MTD-005-08` In-force restricting links refuse deletion; custom-record cascades are bounded to depth ten and roll back together on refusal.	service, database	test services-platform:modules/custom-objects/tests/integration/services/persistence/custom-object-records.integration.spec.js#refuses to delete a record an open res
`INV-DOM-PFM-MTD-005-09` Business changes require attributed commit-time history, while unchanged business values create no revision.	database	documented services-platform:docs/record-history.md#Rules every writer meets
`INV-DOM-PFM-MTD-005-10` Events are appended with supported committed changes; refused writes, rollback and changes outside event content produce none.	service, database	test services-platform:modules/custom-objects/tests/integration/services/persistence/custom-object-records.events.integration.spec.js#publishes nothing when the tran
`INV-DOM-PFM-MTD-005-11` Mutations and single-record views record audits in their transaction without business values.	service	test services-platform:modules/custom-objects/tests/e2e/custom-object-records.e2e.spec.js#audits the read of a record as a view
`INV-DOM-PFM-MTD-005-12` Caller external identities are unique within their object.	service, database	test services-platform:modules/custom-objects/tests/integration/services/persistence/custom-object-records.integration.spec.js#refuses a create under an external id

Planning

Design

Custom Record ​

What It Models ​

Identity and Attributes ​

Relationships ​

Invariants ​

How It Is Stored and Shared ​

Open Design Questions ​

Relationships

Invariants

Custom Record

What It Models

Identity and Attributes

Relationships

Invariants

How It Is Stored and Shared

Open Design Questions