← Catalogue
World Models · legacy example

Document & Record

This meta-model describes documents as governed records: information objects with a stable identity that outlives any single file, carried through versions and renditions, made trustworthy by signatures and custody trails, and disposed of under retention rules. It is its own model because recordkeeping semantics (versioning, authenticity, retention, holds) recur across every domain that produces paperwork, from contracts to certificates, and deserve one shared vocabulary rather than per-domain reinvention.

AI YAMLAGENTS.mdSource
IDworld.n1-document-and-record
Version history0.2.0-legacy
CategoryReference example
IndustryCross-industry
Domainknowledge-information
Tagsdocument, record
Data structure

Bundles and layers

Bundle

identityAndContent

What the document is and what it says

Layers

identity`: stable document identity, class, issuer · `content`: body, formats, renditions · `versioning`: immutable version states and supersession

Bundle

authenticity

Why the record can be trusted

Layers

signatureAndSeal`: signatures, seals, attestations on versions · `custodyAndProvenance`: chain of custody and origin

Bundle

recordkeeping

How long the record lives and under what marking

Layers

retentionAndDisposition`: schedules, triggers, disposition · `classificationAndHolds`: confidentiality marking and legal holds

Findings

Catalogue-native findings must describe the information grouped by each layer. This legacy version does not declare them separately.

Questions & artifacts

Questions, artifact requirements and serial naming rules are required by Vercy vNext; they remain unassigned in this reference version.

Service layers

How this specification operates

Dimension & namespace

  • REFERENCE `world.person` (H1): authors, signers and custodial officers are persons governed elsewhere.
  • REFERENCE `world.organization` (O1): issuing organizations and custodians.
  • REFERENCE `world.identifierNaming` (N8): document numbers and register identifiers are drawn from registered schemes.
  • REFERENCE `world.timeCalendar` (N11): retention triggers and periods anchor to calendar and working-day rules.
  • COMPOSE `world.messageCommunication` (N7): message attachments resolve to governed documents held here.
  • imports: dublin-core (MIX-IN): descriptive metadata facet applied to every document.
  • imports: iso-15489 (ALIGN): records management lifecycle vocabulary.
  • imports: premis (ALIGN): preservation event semantics for long-term custody.

Canon, patches & standards

  • REFERENCE `world.person` (H1): authors, signers and custodial officers are persons governed elsewhere.
  • REFERENCE `world.organization` (O1): issuing organizations and custodians.
  • REFERENCE `world.identifierNaming` (N8): document numbers and register identifiers are drawn from registered schemes.
  • REFERENCE `world.timeCalendar` (N11): retention triggers and periods anchor to calendar and working-day rules.
  • COMPOSE `world.messageCommunication` (N7): message attachments resolve to governed documents held here.
  • imports: dublin-core (MIX-IN): descriptive metadata facet applied to every document.
  • imports: iso-15489 (ALIGN): records management lifecycle vocabulary.
  • imports: premis (ALIGN): preservation event semantics for long-term custody.

Artifact formats & serial data

Format-independent core. Concrete artifact formats and naming prefixes are not declared in this legacy version.

Policies & accepted processes

  • `recordAccessContract`: terms under which a requester may read a record or its metadata.
  • `certifiedCopyContract`: issuance of certified copies or extracts with authenticity guarantees.
  • `retentionComplianceContract`: obligations between owner and custodian covering schedules, holds and disposition evidence.

Read / add / edit / delete

CRUD procedures and interface bindings are not declared in this legacy version.

Ownership, roles & access

The neutral owner archetype is the author or issuing organization; a registrar or custodian may maintain the register on the owner's behalf without acquiring ownership. Access to record content and metadata is always granted by the owner through the catalogue's ownership and access models (S1/S2), with use recorded for audit via S4.

Existing assembly

Objects, relationships, events and projections

Objects

  • `document`: a governed information object with identity independent of any single file; key attributes: documentId, title, documentClass, status, issuerRef.
  • `documentVersion`: an immutable state of a document's content at a point in time; key attributes: versionNumber, contentHash, createdAt, changeNote.
  • `rendition`: a format-specific realization of a version; key attributes: mediaType, byteSize, checksum, storageRef.
  • `signature`: a signature, seal or attestation applied to a version; key attributes: signerRef, method, signedAt, validityStatus.
  • `retentionRule`: an assigned retention schedule; key attributes: retentionClass, triggerEvent, retentionPeriod, dispositionAction.
  • `legalHold`: a suspension of disposition pending proceedings; key attributes: holdReason, placedBy, placedAt, releasedAt.
  • `registerEntry`: the listing of a document in a custodial register; key attributes: registerRef, entryNumber, registeredAt.

Relationships

  • `document` -> hasVersion -> `documentVersion` (1:N): the version chain of the record.
  • `documentVersion` -> renderedAs -> `rendition` (1:N): one content state, many formats.
  • `signature` -> signs -> `documentVersion` (N:1): authenticity attaches to a specific version.
  • `document` -> governedBy -> `retentionRule` (N:1): the schedule that decides the record's fate.
  • `legalHold` -> suspends -> `retentionRule` (N:N): holds override disposition until released.
  • `document` -> supersedes -> `document` (N:1): a new record replacing an older one.
  • `registerEntry` -> registers -> `document` (1:1): the custodial register anchors the record.

Events

  • `documentCreated`: a new governed document came into existence.
  • `versionIssued`: a new immutable content state was fixed.
  • `documentSigned`: a signature or seal was applied to a version.
  • `documentRegistered`: the document was entered into a custodial register.
  • `holdPlaced`: disposition was suspended by a legal hold.
  • `holdReleased`: a legal hold was lifted.
  • `documentDisposed`: the disposition action of the retention rule was executed.

Projections

  • `registerListing`: existence-level metadata (identity, class, dates); omits content and signer details.
  • `evidentiaryView`: full version chain with signatures and custody trail for legal use; omits unrelated register context.
  • `dispositionWorklist`: records due for disposition with applicable rules and holds; omits content bodies.