Class: BeddingTextilesCategory

name: BeddingTextilesCategory
annotations:
  completeness_minimal:
    tag: completeness_minimal
    value: subcategory, assessment_result, usage
  completeness_standard:
    tag: completeness_standard
    value: subcategory, is_set_complete, assessment_result, is_winter_suitable, usage
  completeness_detailed:
    tag: completeness_detailed
    value: subcategory, material, is_set_complete, assessment_result, is_winter_suitable,
      usage
  material_winter_hint:
    tag: material_winter_hint
    value: Fragment compiler may pre-fill is_winter_suitable=true when material in
      [wool, fleece, down_feather] and is_winter_suitable=false when material in [linen,
      silk]. Sorter always overrides.
  coicop_division:
    tag: coicop_division
    value: '05.2'
  unhcr_nfi_category:
    tag: unhcr_nfi_category
    value: household_items
  winter_suitable_subcategories:
    tag: winter_suitable_subcategories
    value: blankets, duvets_quilts, pillows, mattresses, sleeping_bags, bedsheets
  winter_suppress_subcategories:
    tag: winter_suppress_subcategories
    value: towels, curtains_blinds, tablecloths_napkins
description: 'Mixin for bedding and textiles slots and UC rules. Applied to BeddingTextilesItem
  via mixins: [BeddingTextilesCategory]. Split from HouseholdItem per COICOP 05.2
  and UNHCR NFI standards. Uses BeddingAssessmentEnum — hygiene is the primary redistribution
  signal. is_winter_suitable added for thermal weight signal on blankets, duvets,
  and sleeping bags. SeasonEnum not declared — binary is sufficient for bedding. See
  schema description for full rationale.'
from_schema: https://inkind-at.github.io/inkind-knowledge-repo
see_also:
- http://www.productontology.org/id/Bedding
- https://emergency.unhcr.org/emergency-assistance/core-relief-items/kind-non-food-item-distribution
is_a: CategoryMixin
mixin: true
slots:
- subcategory
- material
- assessment_result
- is_set_complete
- is_winter_suitable
slot_usage:
  subcategory:
    name: subcategory
    range: BeddingTextilesSubcategoryEnum
    required: true
  assessment_result:
    name: assessment_result
    description: Hygiene and condition assessment. Required regardless of usage —
      new items may have packaging damage or factory soiling.
    range: BeddingAssessmentEnum
    required: true
  material:
    name: material
    description: Primary fibre or fabric composition. Optional — detailed completeness
      tier. Record the dominant fibre; use synthetic_blend when no single synthetic
      dominates. See BeddingMaterialEnum for full vocabulary and ontology grounding.
    range: BeddingMaterialEnum
    required: false
  is_winter_suitable:
    name: is_winter_suitable
    description: 'Whether this bedding item provides meaningful warmth for cold conditions.
      Required at standard completeness for blankets, duvets_quilts, and sleeping_bags.
      Not meaningful for towels, curtains, tablecloths. Suppressed by fragment compiler
      for those subcategories via the season_relevant_subcategories annotation.

      Critical for sleeping bags — a summer sleeping bag issued in a cold-weather
      emergency is dangerous. Thermal rating in tog or season number may be noted
      in sorting_notes as free text.'
    range: boolean
    required: false
rules:
- preconditions:
    slot_conditions:
      assessment_result:
        name: assessment_result
        equals_string: hygiene_concern
  postconditions:
    slot_conditions:
      lifecycle_state:
        name: lifecycle_state
        none_of:
        - equals_string: stored
        - equals_string: distributed
  description: 'Items with hygiene concerns must not be redistributed. Covers mattress
    staining, infestation signs, biological contamination, and packaging damage on
    new items. Applies regardless of usage. action: block, suggest: disposal.'
  title: uc-bedding-hygiene-concern-block
- preconditions:
    slot_conditions:
      assessment_result:
        name: assessment_result
        equals_string: used_not_confirmed_washed
  postconditions:
    slot_conditions:
      sorting_notes:
        name: sorting_notes
        required: true
  description: 'Used items where laundering is unconfirmed require sorter confirmation.
    action: warn — sorting_notes required.'
  title: uc-bedding-not-washed-warn
- preconditions:
    slot_conditions:
      assessment_result:
        name: assessment_result
        equals_string: clean_with_visible_staining
  postconditions:
    slot_conditions:
      sorting_notes:
        name: sorting_notes
        required: true
  description: 'Visibly stained items require sorter confirmation. action: warn —
    sorting_notes required.'
  title: uc-bedding-stained-warn
- preconditions:
    slot_conditions:
      subcategory:
        name: subcategory
        equals_string: sleeping_bags
  postconditions:
    slot_conditions:
      is_winter_suitable:
        name: is_winter_suitable
        required: true
  description: 'Sleeping bags require is_winter_suitable to be explicitly set. A summer
    sleeping bag issued in a cold-weather emergency is a genuine safety risk. Sorters
    must assess the thermal rating. action: warn — is_winter_suitable must be set
    at sorted state.'
  title: uc-bedding-sleeping-bag-winter-required

name: BeddingTextilesCategory
annotations:
  completeness_minimal:
    tag: completeness_minimal
    value: subcategory, assessment_result, usage
  completeness_standard:
    tag: completeness_standard
    value: subcategory, is_set_complete, assessment_result, is_winter_suitable, usage
  completeness_detailed:
    tag: completeness_detailed
    value: subcategory, material, is_set_complete, assessment_result, is_winter_suitable,
      usage
  material_winter_hint:
    tag: material_winter_hint
    value: Fragment compiler may pre-fill is_winter_suitable=true when material in
      [wool, fleece, down_feather] and is_winter_suitable=false when material in [linen,
      silk]. Sorter always overrides.
  coicop_division:
    tag: coicop_division
    value: '05.2'
  unhcr_nfi_category:
    tag: unhcr_nfi_category
    value: household_items
  winter_suitable_subcategories:
    tag: winter_suitable_subcategories
    value: blankets, duvets_quilts, pillows, mattresses, sleeping_bags, bedsheets
  winter_suppress_subcategories:
    tag: winter_suppress_subcategories
    value: towels, curtains_blinds, tablecloths_napkins
description: 'Mixin for bedding and textiles slots and UC rules. Applied to BeddingTextilesItem
  via mixins: [BeddingTextilesCategory]. Split from HouseholdItem per COICOP 05.2
  and UNHCR NFI standards. Uses BeddingAssessmentEnum — hygiene is the primary redistribution
  signal. is_winter_suitable added for thermal weight signal on blankets, duvets,
  and sleeping bags. SeasonEnum not declared — binary is sufficient for bedding. See
  schema description for full rationale.'
from_schema: https://inkind-at.github.io/inkind-knowledge-repo
see_also:
- http://www.productontology.org/id/Bedding
- https://emergency.unhcr.org/emergency-assistance/core-relief-items/kind-non-food-item-distribution
is_a: CategoryMixin
mixin: true
slot_usage:
  subcategory:
    name: subcategory
    range: BeddingTextilesSubcategoryEnum
    required: true
  assessment_result:
    name: assessment_result
    description: Hygiene and condition assessment. Required regardless of usage —
      new items may have packaging damage or factory soiling.
    range: BeddingAssessmentEnum
    required: true
  material:
    name: material
    description: Primary fibre or fabric composition. Optional — detailed completeness
      tier. Record the dominant fibre; use synthetic_blend when no single synthetic
      dominates. See BeddingMaterialEnum for full vocabulary and ontology grounding.
    range: BeddingMaterialEnum
    required: false
  is_winter_suitable:
    name: is_winter_suitable
    description: 'Whether this bedding item provides meaningful warmth for cold conditions.
      Required at standard completeness for blankets, duvets_quilts, and sleeping_bags.
      Not meaningful for towels, curtains, tablecloths. Suppressed by fragment compiler
      for those subcategories via the season_relevant_subcategories annotation.

      Critical for sleeping bags — a summer sleeping bag issued in a cold-weather
      emergency is dangerous. Thermal rating in tog or season number may be noted
      in sorting_notes as free text.'
    range: boolean
    required: false
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: BeddingTextilesCategory
    domain_of:
    - ClothingCategory
    - AccessoriesCategory
    - FootwearCategory
    - FurnitureCategory
    - BeddingTextilesCategory
    - HouseholdCategory
    - ElectronicsCategory
    - ToysCategory
    - SportsCategory
    - BooksCategory
    - StationeryCategory
    - PersonalCareCategory
    - MobilityAidsCategory
    - BabyInfantCategory
    - AnyValue
    range: BeddingTextilesSubcategoryEnum
    required: true
  material:
    name: material
    annotations:
      label_en:
        tag: label_en
        value: Material
      label_de:
        tag: label_de
        value: Material
    description: Primary fibre or fabric composition. Optional — detailed completeness
      tier. Record the dominant fibre; use synthetic_blend when no single synthetic
      dominates. See BeddingMaterialEnum for full vocabulary and ontology grounding.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: material
    owner: BeddingTextilesCategory
    domain_of:
    - ClothingCategory
    - AccessoriesCategory
    - FootwearCategory
    - FurnitureCategory
    - BeddingTextilesCategory
    - HouseholdCategory
    - ToysCategory
    - CategoryMixin
    range: BeddingMaterialEnum
    required: false
  assessment_result:
    name: assessment_result
    annotations:
      label_en:
        tag: label_en
        value: Assessment Result
      label_de:
        tag: label_de
        value: Bewertungsergebnis
    description: Hygiene and condition assessment. Required regardless of usage —
      new items may have packaging damage or factory soiling.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - schema:OfferItemCondition
    rank: 1000
    alias: assessment_result
    owner: BeddingTextilesCategory
    domain_of:
    - FurnitureCategory
    - BeddingTextilesCategory
    - ElectronicsCategory
    - SportsCategory
    - MobilityAidsCategory
    - BabyInfantCategory
    range: BeddingAssessmentEnum
    required: true
  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: BeddingTextilesCategory
    domain_of:
    - BeddingTextilesCategory
    - HouseholdCategory
    - ToysCategory
    - SportsCategory
    - StationeryCategory
    range: boolean
  is_winter_suitable:
    name: is_winter_suitable
    annotations:
      label_en:
        tag: label_en
        value: Winter Suitable
      label_de:
        tag: label_de
        value: Wintertauglich
    description: 'Whether this bedding item provides meaningful warmth for cold conditions.
      Required at standard completeness for blankets, duvets_quilts, and sleeping_bags.
      Not meaningful for towels, curtains, tablecloths. Suppressed by fragment compiler
      for those subcategories via the season_relevant_subcategories annotation.

      Critical for sleeping bags — a summer sleeping bag issued in a cold-weather
      emergency is dangerous. Thermal rating in tog or season number may be noted
      in sorting_notes as free text.'
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - schema:itemCondition
    rank: 1000
    alias: is_winter_suitable
    owner: BeddingTextilesCategory
    domain_of:
    - ClothingCategory
    - FootwearCategory
    - BeddingTextilesCategory
    - BabyInfantCategory
    range: boolean
    required: false
rules:
- preconditions:
    slot_conditions:
      assessment_result:
        name: assessment_result
        equals_string: hygiene_concern
  postconditions:
    slot_conditions:
      lifecycle_state:
        name: lifecycle_state
        none_of:
        - equals_string: stored
        - equals_string: distributed
  description: 'Items with hygiene concerns must not be redistributed. Covers mattress
    staining, infestation signs, biological contamination, and packaging damage on
    new items. Applies regardless of usage. action: block, suggest: disposal.'
  title: uc-bedding-hygiene-concern-block
- preconditions:
    slot_conditions:
      assessment_result:
        name: assessment_result
        equals_string: used_not_confirmed_washed
  postconditions:
    slot_conditions:
      sorting_notes:
        name: sorting_notes
        required: true
  description: 'Used items where laundering is unconfirmed require sorter confirmation.
    action: warn — sorting_notes required.'
  title: uc-bedding-not-washed-warn
- preconditions:
    slot_conditions:
      assessment_result:
        name: assessment_result
        equals_string: clean_with_visible_staining
  postconditions:
    slot_conditions:
      sorting_notes:
        name: sorting_notes
        required: true
  description: 'Visibly stained items require sorter confirmation. action: warn —
    sorting_notes required.'
  title: uc-bedding-stained-warn
- preconditions:
    slot_conditions:
      subcategory:
        name: subcategory
        equals_string: sleeping_bags
  postconditions:
    slot_conditions:
      is_winter_suitable:
        name: is_winter_suitable
        required: true
  description: 'Sleeping bags require is_winter_suitable to be explicitly set. A summer
    sleeping bag issued in a cold-weather emergency is a genuine safety risk. Sorters
    must assess the thermal rating. action: warn — is_winter_suitable must be set
    at sorted state.'
  title: uc-bedding-sleeping-bag-winter-required