glam/schemas/20251121/linkml/modules/classes/PersonConnection.yaml

id: https://nde.nl/ontology/hc/class/PersonConnection
name: person_connection_class
title: Person Connection Class
version: 1.0.0
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  foaf: http://xmlns.com/foaf/0.1/
  dct: http://purl.org/dc/terms/
imports:
  - linkml:types
  - ../enums/HeritageTypeEnum
  - ../enums/NameTypeEnum
  - ../metadata
  - ../slots/20260202_matang/new/connection_heritage_relevant
  - ../slots/20260202_matang/new/connection_heritage_type
  - ../slots/20260202_matang/new/connection_id
  - ../slots/20260202_matang/new/connection_linkedin_url
  - ../slots/20260202_matang/new/connection_location
  - ../slots/20260202_matang/new/connection_name
  - ../slots/20260202_matang/new/connection_organization
  - ../slots/20260202_matang/has_degree
  - ../slots/20260202_matang/has_description
  - ../slots/20260202_matang/has_score
  - ../slots/20260202_matang/new/mutual_connections_text
  - ../slots/20260202_matang/new/name_type
# default_range: string
classes:
  PersonConnection:
    is_a: SocialNetworkMember
    class_uri: schema:Person
    description: 'A single connection entry from a person''s LinkedIn network.


      Represents one person in another person''s connection list, including

      their relationship degree, professional has_title, and heritage sector

      classification.


      **Relationship to ConnectionNetwork**:

      - ConnectionNetwork contains an array of PersonConnection entries

      - Each PersonConnection represents one network connection

      - connection_id links back to the target profile


      **Connection Degrees**:

      - 1st: Direct connection (mutual connection)

      - 2nd: Connected through one mutual connection

      - 3rd+: Connected through two or more people


      **Name Types** (per AGENTS.md Rule 17):

      - full: Complete first and last name visible

      - abbreviated: Contains single initial (e.g., "Amy B.", "S. Buse")

      - anonymous: Privacy-hidden profile ("LinkedIn Member")

      '
    exact_mappings:
    - schema:Person
    close_mappings:
    - foaf:Person
    related_mappings:
    - schema:knows
    slots:
    - has_degree
    - has_description
    - connection_heritage_relevant
    - connection_heritage_type
    - connection_id
    - connection_linkedin_url
    - connection_location
    - connection_name
    - connection_organization
    - mutual_connections_text
    - name_type
    - has_score
    slot_usage:
      connection_id:
#         range: string
        required: true
        pattern: ^[a-z0-9-]+_conn_[0-9]{4}_[a-z0-9_]+$
        examples:
        - value: giovannafossati_conn_0042_amy_b
        - value: rijksmuseum_staff_0001_jan_van_berg
      connection_name:
#         range: string
        required: true
        examples:
        - value: Maddalena Ghiotto
        - value: Amy B.
        - value: LinkedIn Member
      name_type:
        range: NameTypeEnum
        required: true
        examples:
        - value: full
        - value: abbreviated
      has_degree:
        range: ConnectionDegree
        required: true
        inlined: true
        examples:
        - value:
            has_type: SecondDegreeConnection
        - value:
            has_type: FirstDegreeConnection
      has_description:
#         range: string
        inlined: false # Fixed invalid inline for primitive type
        examples:
        - value:
            description_text: Archiving nerd in the digital era.
        - value:
            description_text: Senior Curator at Rijksmuseum
        - value:
            description_text: PhD candidate Critical audiovisual heritage
      connection_location:
#         range: string
        examples:
        - value: Utrecht, Utrecht, Netherlands
        - value: Netherlands
        - value: Amsterdam, North Holland, Netherlands
      connection_organization:
#         range: string
        examples:
        - value: Vrije Universiteit Amsterdam
        - value: Digital Infrastructure department of the KNAW Humanities Cluster
      connection_heritage_relevant:
        range: boolean
        required: true
        examples:
        - value: true
        - value: false
      connection_heritage_type:
        range: HeritageTypeEnum
        examples:
        - value: A
        - value: M
        - value: D
      connection_linkedin_url:
        range: uri
        pattern: ^https://www\.linkedin\.com/in/[a-z0-9-]+/?$
        examples:
        - value: https://www.linkedin.com/in/maddalena-ghiotto-12345
      mutual_connections_text:
#         range: string
        examples:
        - value: Thomas van Maaren, Bob Coret, and 4 other mutual connections
        - value: 12 mutual connections
    comments:
    - Inlined in ConnectionNetwork.connections[] as multivalued list
    - connection_id enables deduplication across multiple connection lists
    - name_type classification per AGENTS.md Rule 17
    - has_degree (was connection_degree) is relative to VIEWER, not target profile
    see_also:
    - https://schema.org/Person
    - https://schema.org/knows
    annotations:
      specificity_score: 0.1
      specificity_rationale: Generic utility class/slot created during migration
      custodian_types: "['*']"