glam/schemas/20251121/linkml/modules/classes/PersonConnection.yaml
2026-01-19 00:09:28 +01:00

193 lines
6.3 KiB
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
- ../metadata
- ./SpecificityAnnotation
- ./TemplateSpecificityScore # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)
- ./TemplateSpecificityType
- ./TemplateSpecificityTypes
- ../enums/HeritageTypeEnum
- ../enums/NameTypeEnum
- ../enums/ConnectionDegreeEnum
- ../slots/connection_id
- ../slots/connection_name
- ../slots/name_type
- ../slots/connection_degree
# REMOVED 2026-01-18: ../slots/connection_headline - migrated to has_or_had_description + Description (Rule 53)
- ../slots/has_or_had_description
- ./Description
- ../slots/connection_location
- ../slots/connection_organization
- ../slots/connection_heritage_relevant
- ../slots/connection_heritage_type
- ../slots/connection_linkedin_url
- ../slots/mutual_connections_text
- ../slots/specificity_annotation
- ../slots/has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
default_range: string
classes:
PersonConnection:
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 headline, 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:
- connection_degree
- has_or_had_description # was: connection_headline - migrated per Rule 53 (2026-01-18)
- connection_heritage_relevant
- connection_heritage_type
- connection_id
- connection_linkedin_url
- connection_location
- connection_name
- connection_organization
- mutual_connections_text
- name_type
- specificity_annotation
- has_or_had_score # was: template_specificity - migrated per Rule 53 (2026-01-17)
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
description: 'Connection #42 from Giovanna Fossati''s network'
- value: rijksmuseum_staff_0001_jan_van_berg
description: Staff member from Rijksmuseum
connection_name:
range: string
required: true
examples:
- value: Maddalena Ghiotto
description: Full name visible
- value: Amy B.
description: Abbreviated last name
- value: LinkedIn Member
description: Anonymous/privacy-protected
name_type:
range: NameTypeEnum
required: true
examples:
- value: full
description: Complete name visible
- value: abbreviated
description: Partial name (privacy setting)
connection_degree:
range: ConnectionDegreeEnum
required: true
examples:
- value: 2nd
description: Second-degree connection
has_or_had_description: # was: connection_headline - migrated per Rule 53/56 (2026-01-18)
description: |
MIGRATED from connection_headline per slot_fixes.yaml (Rule 53/56, 2026-01-18).
Professional headline/tagline for this LinkedIn connection.
Uses Description class for structured representation.
range: Description
inlined: true
examples:
- value:
description_text: "Archiving nerd in the digital era."
description: Personal tagline style headline
- value:
description_text: "Senior Curator at Rijksmuseum"
description: Role-based headline
- value:
description_text: "PhD candidate Critical audiovisual heritage"
description: Academic position headline
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
description: Works in museum, archive, library, etc.
- value: false
description: No apparent heritage sector connection
connection_heritage_type:
range: HeritageTypeEnum
examples:
- value: A
description: Archive sector
- value: M
description: Museum sector
- value: D
description: Digital heritage
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
- connection_degree is relative to VIEWER, not target profile
see_also:
- https://schema.org/Person
- https://schema.org/knows