CANONICAL ENTITY GRAPH SPECIFICATION

The 10 Universal Primitives

Instead of creating separate database silos for CRM, HR, billing, and support, Modulogium organizes all enterprise data into 10 shared canonical primitives. Community modules inject capabilities directly onto these shared nodes.

Direct Answer · Canonical Entity Definition

A Universal Primitive in Modulogium is one of 10 atomic, immutable data models (Person, Organization, Relationship, Interaction, Project, Asset, Transaction, Document, Task, Event) that replaces proprietary software silos by providing a single, zero-sync relational graph for all business applications.

Interactive Mental Graph · Radial Orbital Topology

Hover to focus synaptic branches

THE MENTAL GRAPH

Workflows:

ENGINE EVENT HEARTBEATCDC WAL (0.3ms)

Primitive Relational Edge Matrix

Universal Relational Graph

The 10 Universal Primitives of Modulogium

Click any primitive to inspect relations & operating modules

Select Entity Primitive:

Person

Universal human identity and relational entity

CRMHRSupport

Represents any individual human interacting with or within the organization — employee, customer contact, vendor representative, contractor, investor, or lead — with unified identity and privacy boundaries.

Replaces Vendor Silos:

CRM Lead / ContactHR Employee / ContractorSupport Ticket RequesterBilling Payer / CardholderProject Team Member

Connected Graph Edges:

OrganizationMember / Employee / Officer

Affiliations via Relationship edges

InteractionParticipant

Omnichannel communications, meetings, and calls

TaskAssignee / Creator

Work assignments and accountability

TransactionPayer / Recipient

Direct financial settlements, payroll, or invoices

DocumentSignatory / Author

Legal contracts, reviews, and specifications

Core Canonical Properties:

id(UUID v7)

Chronologically sortable universal identifier

displayName(string)

Full legal or preferred display name

primaryEmail(string (email))

Canonical verified electronic address

phone(string (e.164))

Standardized telephone number

timezone(string (IANA))

Primary operational timezone

locale(string (BCP 47))

Preferred language & regional formatting

metadata(JSONB)

Arbitrary extension attributes declared by modules

Primitive Deep Dives & Schema Payloads

Person

Replaces Silos:

CRM Lead / ContactHR Employee / ContractorSupport Ticket RequesterBilling Payer / CardholderProject Team Member

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Person",
  "id": "019183ab-45cd-7e89-b012-3456789abcde",
  "displayName": "Elena Rostova",
  "primaryEmail": "elena.rostova@helios-dynamics.io",
  "phone": "+1-415-555-0199",
  "timezone": "America/Los_Angeles",
  "locale": "en-US",
  "extensions": {
    "crm": {
      "pipelineStage": "negotiation",
      "leadScore": 94
    },
    "hr": {
      "role": "VP of Quantum Architecture",
      "payrollTier": "E-7"
    },
    "support": {
      "vipPriority": true,
      "activeTickets": 0
    }
  }
}

Organization

Represents any legal entity, holding group, client business, supplier, regulatory agency, customer account, or internal operating division.

Replaces Silos:

CRM Account / CompanyProcurement Vendor RecordBilling Customer AccountPartner Portal Record

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Organization",
  "id": "019183b1-23ef-7890-a123-456789abcdef",
  "legalName": "Helios Dynamics GmbH",
  "domain": "helios-dynamics.io",
  "jurisdiction": "DE-BY",
  "taxIdentifier": "DE382910482",
  "status": "active",
  "extensions": {
    "crm": {
      "tier": "Enterprise",
      "arrUsd": 180000
    },
    "procurement": {
      "supplierScore": 98.4,
      "paymentTerms": "NET30"
    }
  }
}

Relationship

A first-class graph connection connecting Persons and Organizations with explicit roles, directional semantics, start/end validity periods, and custom weight attributes.

Replaces Silos:

CRM Contact-Account MappingsHR Org Chart / Manager HierarchiesSupplier Distribution NetworksBoard of Directors Rosters

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Relationship",
  "id": "019183b5-6789-7abc-def0-123456789abc",
  "sourceEntityId": "019183ab-45cd-7e89-b012-3456789abcde",
  "targetEntityId": "019183b1-23ef-7890-a123-456789abcdef",
  "roleType": "executive_sponsor",
  "validFrom": "2024-01-15T00:00:00Z",
  "validTo": null,
  "weight": 0.95
}

Interaction

Captures any structured or unstructured communication event — emails, phone calls, meetings, chat threads, support messages, site feedback, or sales demos — preserved in a unified timeline.

Replaces Silos:

CRM Activity LogSupport Ticket ThreadMarketing Email Click TrackingHR Interview Notes

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Interaction",
  "id": "019183b9-ab12-7cde-f012-3456789abcde",
  "channel": "meeting",
  "direction": "inbound",
  "occurredAt": "2026-08-28T14:30:00Z",
  "summary": "Q3 Architecture Review & Modulogium Engine Migration",
  "sentimentScore": 0.88,
  "participants": [
    "019183ab-45cd-7e89-b012-3456789abcde"
  ]
}

Project

Defines bounded programs of work — software releases, client engagements, marketing campaigns, factory retooling, or audit compliance — with milestones, budgets, and state machines.

Replaces Silos:

Jira / Linear Issue ProjectsAsana / Monday WorkspacesProfessional Services Delivery TrackersMarketing Campaign Containers

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Project",
  "id": "019183bd-ef34-7567-8901-23456789abcd",
  "title": "Core Schema Migration to Open-Source Foundry",
  "code": "MOD-FOUNDRY",
  "status": "active",
  "startDate": "2026-08-01",
  "targetDate": "2026-10-15",
  "budgetUsd": 75000
}

Asset

Tracks any inventory unit, physical machinery, vehicle, domain name, software license, AWS cluster, cryptographic key, patent, or facility space with location and depreciation lifecycle.

Replaces Silos:

Fixed Asset RegisterWarehouse Inventory SKU LedgerIT Asset Management (ITAM)Digital Asset Management (DAM)

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Asset",
  "id": "019183c1-2345-7678-9012-3456789abcde",
  "name": "High-Density Inference Node Alpha-04",
  "category": "hardware",
  "serialNumber": "SN-H100-NVL-89410",
  "acquisitionCost": 38500,
  "extensions": {
    "inventory": {
      "warehouseLocation": "Rack-04-Bay-B",
      "status": "deployed"
    }
  }
}

Transaction

Immutable atomic record of financial value transfer — invoices, credit notes, payroll disbursements, subscription billings, vendor payments, token grants, or escrow releases.

Replaces Silos:

Stripe / Quickbooks InvoicesVendor Accounts Payable (AP)Customer Accounts Receivable (AR)Payroll Disbursement Log

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Transaction",
  "id": "019183c5-6789-789a-bcde-f0123456789a",
  "amount": 14500,
  "currency": "USD",
  "transactionType": "invoice",
  "postedAt": "2026-08-15T00:00:00Z",
  "status": "settled",
  "extensions": {
    "billing": {
      "stripePaymentIntent": "pi_3MtwBwLkdIwHu7ix28a38Fz"
    }
  }
}

Document

Version-controlled, cryptographic proof-bearing artifact containing legal commitments, architectural specifications, employee handbooks, standard operating procedures, or NDAs.

Replaces Silos:

DocuSign / Ironclad Contract SiloGoogle Drive / Dropbox Folder ClutterConfluence Policy DocsLegal Repository

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Document",
  "id": "019183c9-ab12-7901-2345-6789abcdef01",
  "title": "Master Services Agreement - Helios & Modulogium",
  "mimeType": "application/pdf",
  "contentHash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "version": "2.1.0",
  "isSigned": true
}

Task

Granular units of work assigned to Persons, attached to Projects or Assets, with estimated effort, priority, dependencies, checklist steps, and state transitions.

Replaces Silos:

Jira TicketsGitHub IssuesTrello CardsTodoist / Asana Line Items

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Task",
  "id": "019183cd-ef34-7a12-3456-789abcdef012",
  "title": "Implement PostgreSQL Bi-Directional CDC Connector",
  "priority": "p1",
  "state": "in_progress",
  "dueAt": "2026-09-01T17:00:00Z",
  "estimatedHours": 16,
  "assigneeId": "019183ab-45cd-7e89-b012-3456789abcde"
}

Event

A scheduled or reactive temporal occurrence — calendar appointment, subscription expiration webhook, pipeline stage progression, product launch date, or shift rotation.

Replaces Silos:

Google / Outlook Calendar SiloWebhook Message BusesCron Job DispatchersShift Scheduling Software

{
  "@context": "https://modulogium.com/schema/v1",
  "@type": "Event",
  "id": "019183d1-2345-7b23-4567-89abcdef0123",
  "name": "Quarterly Board Presentation & Financial Close",
  "eventType": "calendar",
  "scheduledStart": "2026-09-15T15:00:00Z",
  "scheduledEnd": "2026-09-15T17:00:00Z",
  "payload": {
    "zoomLink": "https://zoom.us/j/918237192"
  }
}