Class: SportsItem

name: SportsItem
annotations:
  label_en:
    tag: label_en
    value: Sports
  label_de:
    tag: label_de
    value: Sport
description: "Sports and fitness equipment. COICOP 09.4 (sport and recreational equipment).\
  \ Note: bicycles are placed here by domain convention; COICOP assigns them to Division\
  \ 07 (Transport). The domain decision reflects how social organisations actually\
  \ sort and store these items.\nDual-track assessment (defined in SportsCategory,\
  \ categories/sports.yaml):\n  protective_gear subcategory → SportsProtectiveAssessmentEnum\n\
  \    Wear grade is insufficient for safety-critical items — structural\n    damage\
  \ may not be visually apparent after impact (e.g. a cracked\n    helmet inner shell\
  \ invisible under an intact outer shell).\n  all other subcategories → condition_grade\
  \ (wear grade)"
from_schema: https://inkind-at.github.io/inkind-knowledge-repo
see_also:
- http://www.productontology.org/id/Sporting_goods
is_a: DonationItem
mixins:
- SportsCategory
class_uri: pto:Sporting_goods
rules:
- preconditions:
    slot_conditions:
      lifecycle_state:
        name: lifecycle_state
        equals_string: sorted
  postconditions:
    slot_conditions:
      subcategory:
        name: subcategory
        required: true
  description: subcategory required at sorted state. SportsCategory rules then enforce
    whether assessment_result or condition_grade is required based on the subcategory
    value (protective_gear vs. other).
  title: lc-sorted-sports-subcategory-required

name: SportsItem
annotations:
  label_en:
    tag: label_en
    value: Sports
  label_de:
    tag: label_de
    value: Sport
description: "Sports and fitness equipment. COICOP 09.4 (sport and recreational equipment).\
  \ Note: bicycles are placed here by domain convention; COICOP assigns them to Division\
  \ 07 (Transport). The domain decision reflects how social organisations actually\
  \ sort and store these items.\nDual-track assessment (defined in SportsCategory,\
  \ categories/sports.yaml):\n  protective_gear subcategory → SportsProtectiveAssessmentEnum\n\
  \    Wear grade is insufficient for safety-critical items — structural\n    damage\
  \ may not be visually apparent after impact (e.g. a cracked\n    helmet inner shell\
  \ invisible under an intact outer shell).\n  all other subcategories → condition_grade\
  \ (wear grade)"
from_schema: https://inkind-at.github.io/inkind-knowledge-repo
see_also:
- http://www.productontology.org/id/Sporting_goods
is_a: DonationItem
mixins:
- SportsCategory
attributes:
  subcategory:
    name: subcategory
    annotations:
      label_en:
        tag: label_en
        value: Subcategory
      label_de:
        tag: label_de
        value: Unterkategorie
    description: Subcategory within the item type. Overridden via slot_usage in each
      concrete DonationItem subclass to a category-specific enum.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: subcategory
    owner: SportsItem
    domain_of:
    - ClothingCategory
    - AccessoriesCategory
    - FootwearCategory
    - FurnitureCategory
    - BeddingTextilesCategory
    - HouseholdCategory
    - ElectronicsCategory
    - ToysCategory
    - SportsCategory
    - BooksCategory
    - StationeryCategory
    - PersonalCareCategory
    - MobilityAidsCategory
    - BabyInfantCategory
    - AnyValue
    range: SportsSubcategoryEnum
    required: true
  assessment_result:
    name: assessment_result
    annotations:
      label_en:
        tag: label_en
        value: Assessment Result
      label_de:
        tag: label_de
        value: Bewertungsergebnis
    description: Structured safety assessment for protective_gear subcategory only.
      Required when subcategory = protective_gear; absent otherwise.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - schema:OfferItemCondition
    rank: 1000
    alias: assessment_result
    owner: SportsItem
    domain_of:
    - FurnitureCategory
    - BeddingTextilesCategory
    - ElectronicsCategory
    - SportsCategory
    - MobilityAidsCategory
    - BabyInfantCategory
    range: SportsProtectiveAssessmentEnum
    required: false
  condition_grade:
    name: condition_grade
    annotations:
      label_en:
        tag: label_en
        value: Wear Grade
      label_de:
        tag: label_de
        value: Abnutzungsgrad
    description: Wear grade for general sports equipment (non-protective-gear). Required
      when subcategory ≠ protective_gear.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - schema:OfferItemCondition
    - schema:LikeNewCondition
    - schema:DamagedCondition
    - schema:itemCondition
    rank: 1000
    alias: condition_grade
    owner: SportsItem
    domain_of:
    - ClothingCategory
    - AccessoriesCategory
    - FootwearCategory
    - HouseholdCategory
    - ToysCategory
    - SportsCategory
    - BooksCategory
    - StationeryCategory
    - BabyInfantCategory
    - OtherItem
    range: UsedConditionGradeEnum
    required: false
  sport_type:
    name: sport_type
    description: Sport or activity type (free text, e.g. "football", "cycling").
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: sport_type
    owner: SportsItem
    domain_of:
    - SportsCategory
    range: string
  demographic:
    name: demographic
    annotations:
      label_en:
        tag: label_en
        value: Demographic
      label_de:
        tag: label_de
        value: Demografie
    description: Age/gender demographic (from DemographicEnum in clothing.yaml). Optional
      — detailed completeness tier for sports equipment.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - cpi:designatedFor
    - schema:WearableSizeGroupBaby
    - schema:WearableSizeGroupChildrens
    - schema:WearableSizeGroupAdult
    rank: 1000
    alias: demographic
    owner: SportsItem
    domain_of:
    - ClothingCategory
    - AccessoriesCategory
    - FootwearCategory
    - SportsCategory
    - AnyValue
    range: DemographicEnum
    required: false
  is_set_complete:
    name: is_set_complete
    annotations:
      label_en:
        tag: label_en
        value: Set Complete
      label_de:
        tag: label_de
        value: Set vollständig
    description: Whether all components of the set are present. Optional — standard
      completeness tier.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: is_set_complete
    owner: SportsItem
    domain_of:
    - BeddingTextilesCategory
    - HouseholdCategory
    - ToysCategory
    - SportsCategory
    - StationeryCategory
    range: boolean
  id:
    name: id
    description: A unique identifier for the entity.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    slot_uri: schema:identifier
    identifier: true
    alias: id
    owner: SportsItem
    domain_of:
    - NamedThing
    - SocialOrganisation
    - Actor
    - StorageLocation
    - DonationSource
    - DonationCollection
    - DonationItem
    - DemandSignal
    - Campaign
    - ProvenanceRecord
    range: uriorcurie
    required: true
  usage:
    name: usage
    annotations:
      label_en:
        tag: label_en
        value: Provenance
      label_de:
        tag: label_de
        value: Provenance
    description: Provenance condition — was the item ever used before donation? Orthogonal
      to condition_grade and assessment_result. Maps to schema:NewCondition / schema:UsedCondition.
      usage = new does NOT imply no defects — manufacturing defects are possible and
      assessment must always be performed regardless of usage.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - schema:OfferItemCondition
    - schema:NewCondition
    - schema:UsedCondition
    rank: 1000
    slot_uri: schema:itemCondition
    alias: usage
    owner: SportsItem
    domain_of:
    - DonationItem
    range: ItemUsageEnum
    required: true
  category:
    name: category
    annotations:
      label_en:
        tag: label_en
        value: Item Type
      label_de:
        tag: label_de
        value: Artikeltyp
    description: Type-defining slot on DonationItem. Value is the class URI of the
      concrete subclass (e.g. inkind_knowledge_repo:ClothingItem). linkml-validate,
      gen-json-schema, and gen-pydantic all use this slot to dispatch to the correct
      subclass schema and valid slot set. For other entities (DemandSignal, StorageLocation)
      the range is overridden via slot_usage to CategoryEnum.
    notes:
    - Due to a limitation in LinkML, the designates_type annotation was removed because
      the range is an Enum and not a string.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    slot_uri: schema:additionalType
    designates_type: true
    alias: category
    owner: SportsItem
    domain_of:
    - DonationItem
    - DemandSignal
    range: string
    required: true
  lifecycle_state:
    name: lifecycle_state
    description: Current lifecycle state of the entity. Concrete enum range applied
      via slot_usage. Transitions enforced by Django model clean().
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: lifecycle_state
    owner: SportsItem
    domain_of:
    - DonationSource
    - DonationCollection
    - DonationItem
    - DemandSignal
    - Campaign
    range: ItemLifecycleStateEnum
    required: true
  attribute_completeness:
    name: attribute_completeness
    description: 'Data quality tier set by the fragment engine on sorting completion.
      Not derived from field presence. Not a lifecycle gate. Used by the match engine
      to filter candidates by data quality tier. See AttributeCompletenessEnum for
      the relationship to lifecycle_state. Set by: fragment_engine. Read by: match_engine.'
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: attribute_completeness
    owner: SportsItem
    domain_of:
    - DonationItem
    range: AttributeCompletenessEnum
    required: false
  source_collection:
    name: source_collection
    description: FK — the DonationCollection (arrival type) this item was registered
      from. Null for items not arriving as part of a collection.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: source_collection
    owner: SportsItem
    domain_of:
    - DonationItem
    range: DonationCollection
    required: false
  donation_source:
    name: donation_source
    description: Reference to the DonationSource — privacy boundary between item records
      and donor identity. Concrete range applied via slot_usage.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    slot_uri: inkind_knowledge_repo:donation_source
    alias: donation_source
    owner: SportsItem
    domain_of:
    - DonationCollection
    - DonationItem
    range: DonationSource
    required: false
  storage_unit:
    name: storage_unit
    description: FK — set when lifecycle_state transitions to stored. Null until the
      item reaches stored state.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: storage_unit
    owner: SportsItem
    domain_of:
    - DonationItem
    range: StorageLocation
    required: false
  sorting_notes:
    name: sorting_notes
    annotations:
      label_en:
        tag: label_en
        value: Notes
      label_de:
        tag: label_de
        value: Notizen
    description: Free-text notes recorded by the sorter during sorting. Required by
      UC warn rules to capture explicit sorter confirmation (e.g. incomplete pair,
      body-contact item, inconclusive assessment).
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: sorting_notes
    owner: SportsItem
    domain_of:
    - DonationItem
    range: string
  created_at:
    name: created_at
    description: Timestamp when the entity was created.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: created_at
    owner: SportsItem
    domain_of:
    - DonationSource
    - DonationCollection
    - DonationItem
    range: datetime
    required: true
  updated_at:
    name: updated_at
    description: Timestamp when the entity record was last modified.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: updated_at
    owner: SportsItem
    domain_of:
    - DonationItem
    range: datetime
    required: true
  material:
    name: material
    annotations:
      label_en:
        tag: label_en
        value: Material
      label_de:
        tag: label_de
        value: Material
    description: Primary material composition. Range overridden per class.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: material
    owner: SportsItem
    domain_of:
    - ClothingCategory
    - AccessoriesCategory
    - FootwearCategory
    - FurnitureCategory
    - BeddingTextilesCategory
    - HouseholdCategory
    - ToysCategory
    - CategoryMixin
    range: string
class_uri: pto:Sporting_goods
rules:
- preconditions:
    slot_conditions:
      lifecycle_state:
        name: lifecycle_state
        equals_string: sorted
  postconditions:
    slot_conditions:
      subcategory:
        name: subcategory
        required: true
  description: subcategory required at sorted state. SportsCategory rules then enforce
    whether assessment_result or condition_grade is required based on the subcategory
    value (protective_gear vs. other).
  title: lc-sorted-sports-subcategory-required