← Catalogue
World Models · legacy example

Employment & Membership

This meta-model describes the bilateral relations between persons and organizations: employment in its many forms, membership in associations and communities, the roles held within these relations, and their agreed terms and lifecycle. It is its own model because the relation is jointly owned by two parties and must stand independently of both the person model and the organization model it connects.

AI YAMLAGENTS.mdSource
IDworld.o3-employment-and-membership
Version history0.2.0-legacy
CategoryReference example
IndustryCross-industry
Domainorganizations
Tagsemployment, membership
Data structure

Bundles and layers

Bundle

relation

The fact of the person-organization bond

Layers

employmentRelation`: paid work relations of any kind · `membershipRelation`: belonging to associations, communities and clubs

Bundle

terms

What was agreed within the bond

Layers

roleAssignment`: roles held, with occupation references · `conditions`: term dates, capacity, place of work, notice

Bundle

lifecycle

How the bond begins, pauses and ends

Layers

commencement`: start and probation · `interruption`: leave and suspension · `separation`: end of relation and its cause

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): the person party of every relation.
  • REFERENCE `world.organization` (O1): the organization party of every relation.
  • REFERENCE `world.organizationalUnit` (O2): role assignments occupy established positions.
  • COMPOSE `world.laborMarket` (O6): a confirmed placement there composes the initial employment record here.
  • REFERENCE `world.stewardship` (S1) and `world.accessGrant` (S2): joint ownership and access grants over the bilateral record.
  • MIX-IN `world.auditTrail` (S4): audit facets on all lifecycle events.
  • imports: esco (REFERENCE): occupation and skill codes used in role references.
  • imports: hr-open (ALIGN): HR data interchange shapes for relations and roles.

Canon, patches & standards

  • REFERENCE `world.person` (H1): the person party of every relation.
  • REFERENCE `world.organization` (O1): the organization party of every relation.
  • REFERENCE `world.organizationalUnit` (O2): role assignments occupy established positions.
  • COMPOSE `world.laborMarket` (O6): a confirmed placement there composes the initial employment record here.
  • REFERENCE `world.stewardship` (S1) and `world.accessGrant` (S2): joint ownership and access grants over the bilateral record.
  • MIX-IN `world.auditTrail` (S4): audit facets on all lifecycle events.
  • imports: esco (REFERENCE): occupation and skill codes used in role references.
  • imports: hr-open (ALIGN): HR data interchange shapes for relations and roles.

Artifact formats & serial data

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

Policies & accepted processes

  • `bilateralRecordMirror`: both parties hold and see the identical relation record; joint facts change only by mutual events.
  • `engagementVerification`: third party confirmation of existence, role and dates with minimal disclosure, on the person's consent.
  • `workforceStatistics`: aggregate anonymized reporting of relations for statistics consumers.

Read / add / edit / delete

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

Ownership, roles & access

Each relation is a bilateral record jointly owned by the person and the organization; each side grants access to its own view and joint facts change only by mutual events, per the S1/S2 models of this catalogue.

Existing assembly

Objects, relationships, events and projections

Objects

  • `employment`: a relation of work between a person and an organization; key attributes: kind, start date, end date, status.
  • `membership`: a relation of belonging; key attributes: membership class, admission date, standing.
  • `roleAssignment`: a role held within a relation; key attributes: role reference (occupation code or internal role), position link, validity.
  • `engagementTerm`: the agreed terms; key attributes: term dates, renewal rule, notice period.
  • `workCapacity`: the time commitment; key attributes: full-time fraction, schedule pattern, validity.
  • `interruptionRecord`: a leave or suspension; key attributes: kind, start, end, effect on standing.
  • `separationRecord`: the end of a relation; key attributes: date, initiating side, cause category.

Relationships

  • `employment` -> engages -> `world.person` (n:1): the person side of the relation (H1).
  • `employment` -> with -> `world.organization` (n:1): the organization side of the relation (O1).
  • `membership` -> admits -> `world.person` (n:1): the member, joined to an organization kept in O1.
  • `roleAssignment` -> heldWithin -> `employment` (n:1): the relation in which the role is exercised; membership roles bind the same way.
  • `roleAssignment` -> occupies -> `establishedPosition` (n:1): the post in `world.organizationalUnit` (O2) the role fills.
  • `employment` -> resultedFrom -> `placement` (n:1): the labor market placement in `world.laborMarket` (O6) that produced it.
  • `separationRecord` -> closes -> `employment` (1:1): the terminal record of a relation.

Events

  • `employmentCommenced`: a work relation began.
  • `membershipAdmitted`: a person was admitted to membership.
  • `roleAssigned`: a role was taken up or relinquished within a relation.
  • `termsAmended`: agreed terms or capacity changed.
  • `interruptionStarted`: a leave or suspension began.
  • `interruptionEnded`: the relation resumed.
  • `engagementSeparated`: an employment or membership ended.

Projections

  • `careerHistory`: the person's chronological view of own relations and roles; omits organization-internal notes.
  • `workforceRoster`: the organization's view of current staff and members with roles; omits the person's history at other organizations.
  • `verificationCertificate`: existence, role and dates only; omits terms, capacity and cause of separation.