glam/schemas/20251121/linkml/modules/classes/CommissionRate.yaml
kempersc fc405445c6 Refactor and update schema definitions
- Removed obsolete slots: `has_or_had_custodian_observation`, `provider`, and `specificity_annotation`.
- Updated `has_or_had_score` slot to use `SpecificityScore` class and modified its description and examples.
- Added new slots: `end_seconds`, `end_time`, `has_archive_path`, `has_or_had_custodian_name`, `protocol_name`, and `protocol_version`.
- Introduced a script `check_annotation_types.py` to validate the presence and structure of `custodian_types` in YAML files.
- Added a script `update_specificity.py` to automate updates related to `SpecificityAnnotation` to `SpecificityScore`.
2026-02-01 19:55:38 +01:00

54 lines
2 KiB
YAML

id: https://nde.nl/ontology/hc/class/CommissionRate
name: commission_rate_class
title: Commission Rate Class
prefixes:
linkml: https://w3id.org/linkml/
hc: https://nde.nl/ontology/hc/
schema: http://schema.org/
imports:
- linkml:types
- ../metadata
- ../slots/has_or_had_percentage
default_prefix: hc
classes:
CommissionRate:
class_uri: hc:CommissionRate
description: "Structured representation of a commission rate.\n\n**PURPOSE**:\n\
\nModels commission percentages with context (market type,\nrate type) replacing\
\ simple string representation.\n\n**DESIGN RATIONALE**:\n\nCreated per slot_fixes.yaml\
\ migration from `commission_rate` string\nto structured representation with\
\ Percentage class.\n\n**ART MARKET STANDARDS**:\n\n- **Primary market**: 40-50%\
\ standard (gallery takes half)\n- **Secondary market**: 10-20% (resale commission)\n\
- **Auction**: 10-25% buyer's premium + seller's commission\n\n**EXAMPLE**:\n\
\n```yaml\ntakes_or_took_comission:\n rate_type: \"primary_market\"\n has_or_had_percentage:\n\
\ percentage_value: 50\n percentage_display: \"50%\"\n```\n"
close_mappings:
- schema:PriceSpecification
slots:
- has_or_had_percentage
slot_usage:
has_or_had_percentage:
range: Percentage
inlined: true
required: true
examples:
- value: null
examples:
- value:
has_or_had_percentage: null
- value:
has_or_had_percentage: null
- value:
has_or_had_percentage: null
comments:
- Created 2026-01-22 from commission_rate migration (Rule 53)
- Provides structured commission representation
- Supports art market commission conventions
see_also:
- https://schema.org/PriceSpecification
annotations:
custodian_types: '["G", "C"]'
custodian_types_rationale: Primarily for galleries (G) and commercial organizations
(C).
specificity_score: '0.80'
specificity_rationale: Specific to commercial sales commission context.