DigitalEntity

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://schemas.meta-aiml.org/v3.0.0/ontology/digital_entity.json",
  "@type": [
    "Thing",
    "OntologySchema",
    "DigitalEntity"
  ],
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "DigitalEntity Ontology",
  "description": "Base ontological schema for software-based digital systems. CRITICAL: (1) No physical locality required; (2) Virtually scalable without geographic constraints; (3) Accessible via digital channels only; (4) Can combine with any archetype.",
  "type": "object",
  "properties": {
    "ontologicalMode": {
      "type": "string",
      "const": "DigitalEntity",
      "description": "System exists purely as software/digital abstraction. Opposite of PhysicalEntity: location-independent, globally accessible, scalable without physical constraints."
    },
    "ontologicalInvariants": {
      "type": "object",
      "description": "Structural guarantees ALWAYS true for DigitalEntity",
      "properties": {
        "locationIndependent": {
          "type": "string",
          "const": "yes",
          "description": "No physical location requirement. Can be accessed from anywhere."
        },
        "notConstrainedByPhysics": {
          "type": "string",
          "const": "yes",
          "description": "Not subject to physical space/time constraints. Multiple instances at different locations simultaneously possible."
        },
        "virtuallyScalable": {
          "type": "string",
          "const": "yes",
          "description": "Can scale capacity without building new physical infrastructure."
        },
        "accessibleDigitally": {
          "type": "string",
          "const": "mandatory",
          "description": "MUST be accessible via at least one digital channel (web, mobile, API)."
        },
        "noPhysicalLocationModule": {
          "type": "string",
          "const": "not_required",
          "description": "Location module is NOT a structural requirement for DigitalEntity (unlike PhysicalEntity)."
        }
      },
      "required": [
        "locationIndependent",
        "notConstrainedByPhysics",
        "virtuallyScalable",
        "accessibleDigitally",
        "noPhysicalLocationModule"
      ]
    },
    "structuralRequirements": {
      "type": "object",
      "description": "Hard structural requirements that MUST be satisfied",
      "properties": {
        "digitalChannels": {
          "type": "object",
          "description": "At least ONE digital access channel must be present",
          "properties": {
            "channels": {
              "type": "array",
              "description": "Available digital access methods",
              "items": {
                "type": "string",
                "enum": [
                  "web",
                  "mobile_app",
                  "desktop_app",
                  "api",
                  "voice_interface",
                  "chatbot",
                  "augmented_reality"
                ]
              },
              "minItems": 1,
              "uniqueItems": true
            }
          },
          "required": [
            "channels"
          ]
        },
        "dataOriginality": {
          "type": "string",
          "enum": [
            "created_by_platform",
            "user_generated",
            "third_party_syndicated",
            "hybrid"
          ],
          "description": "How data/content originates (important for semantic understanding)"
        },
        "scalabilityPattern": {
          "type": "string",
          "enum": [
            "stateless_replication",
            "sharded_partitioning",
            "caching_cdn",
            "distributed_compute"
          ],
          "description": "How system achieves virtual scalability"
        }
      },
      "required": [
        "digitalChannels"
      ]
    },
    "deliveryFormat": {
      "type": "array",
      "description": "Digital delivery formats (WebApp, MobileApp, API, etc.). Must have at least one.",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "uniqueItems": true,
      "examples": [
        "WebApp",
        "MobileApp",
        "DesktopApp",
        "API",
        "VoiceInterface",
        "ChatInterface"
      ]
    },
    "interfaceCapabilities": {
      "type": "object",
      "description": "Semantic annotations about access interfaces (informational, not operational)",
      "properties": {
        "primaryInterface": {
          "type": "string",
          "enum": [
            "web",
            "mobile",
            "api",
            "voice",
            "ar",
            "cli"
          ],
          "description": "Main interface through which users/systems interact"
        },
        "multiPlatformSupport": {
          "type": "string",
          "enum": [
            "ios",
            "android",
            "windows",
            "macos",
            "linux",
            "web",
            "cross_platform"
          ],
          "description": "Platforms/devices supported"
        },
        "accessibilityLevels": {
          "type": "array",
          "description": "How data is exposed based on authentication/role",
          "items": {
            "type": "string",
            "enum": [
              "public",
              "authenticated",
              "premium",
              "admin",
              "api_partner"
            ]
          }
        }
      }
    },
    "archetypeFlexibility": {
      "type": "object",
      "description": "DigitalEntity can combine with ANY interaction archetype",
      "properties": {
        "supportedArchetypes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "const": [
            "DirectService",
            "MediatedExchange",
            "NetworkGraph",
            "BroadcastPublisher",
            "ProtocolSystem"
          ],
          "description": "DigitalEntity is archetype-agnostic—purely about DELIVERY, not VALUE MODEL"
        }
      }
    },
    "ontologyNotes": {
      "type": "object",
      "description": "Philosophical notes for implementers",
      "properties": {
        "whyNotBehavioralFlags": {
          "type": "string",
          "const": "DigitalEntity describes NATURE (pure software), not BEHAVIOR (24/7 operation, uptime, backup). Operational characteristics belong in modules/capabilities.",
          "description": "Explains design principle"
        },
        "relationToPhysical": {
          "type": "string",
          "const": "PhysicalEntity tied to geography; DigitalEntity tied to code/algorithms. DigitalEntity+PhysicalEntity is hybrid, not one or the other.",
          "description": "Clarifies ontological boundary"
        },
        "v2Richness": {
          "type": "string",
          "const": "Preserved through: detailed scalability patterns, comprehensive channel enumeration, access level semantics, multi-platform descriptions.",
          "description": "Maintains information density"
        }
      }
    },
    "examples": {
      "type": "array",
      "description": "Concrete DigitalEntity examples",
      "items": {
        "type": "string"
      },
      "examples": [
        "SaaS platform (pure software, location-independent)",
        "Web email service (accessible globally, scalable)",
        "Social network (user-generated digital content)",
        "Streaming service (digital content distribution)",
        "Cloud storage (no physical storage facility)",
        "Cryptocurrency protocol (algorithmic, no physical presence)",
        "Online course platform (digital learning)",
        "Chat application (pure digital communication)"
      ]
    },
    "interactionArchetype": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "DirectService",
          "MediatedExchange",
          "NetworkGraph",
          "BroadcastPublisher",
          "ProtocolSystem"
        ]
      },
      "minItems": 1,
      "maxItems": 1
    }
  },
  "required": [
    "ontologicalMode",
    "deliveryFormat",
    "interactionArchetype"
  ],
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "phase_1",
    "status": "draft",
    "lastValidated": "2026-02-19",
    "validator": "META-AIML QA"
  },
  "$id": "https://schemas.meta-aiml.org/v3.0.0/ontology/digital_entity.json",
  "semanticAnnotations": {
    "classificationRationale": "DigitalEntity ontology schema aligned with META-AIML v3 structural completeness rules.",
    "disambiguationNotes": "Ontology and archetype constraints are encoded for machine-verifiable validation."
  },
  "governanceMetadata": {
    "schemaVersion": "3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-ON-DIG-001: ontologicalMode MUST equal DigitalEntity",
      "RULE-ON-DIG-002: interactionArchetype MUST be present",
      "RULE-ON-DIG-003: deliveryFormat MUST contain at least one digital channel"
    ]
  },
  "examples": [
    {
      "scenario": "DigitalEntity ontology reference usage #1",
      "note": "Demonstrates canonical structure and required constraints."
    },
    {
      "scenario": "DigitalEntity ontology reference usage #2",
      "note": "Demonstrates compliant alternative while preserving ontology/archetype semantics."
    }
  ]
}