Class: FoodItem

name: FoodItem
annotations:
  label_en:
    tag: label_en
    value: Food
  label_de:
    tag: label_de
    value: Essen
description: "Food donation item. COICOP Division 01 (food and non-alcoholic beverages).\
  \ Grounded in FoodOn (OBO Foundry food ontology):\n  http://purl.obolibrary.org/obo/foodon.owl\n\
  \nPhase 1 stub — fully declared to establish the schema; the sort_food process path\
  \ is activated when food-bank organisations are onboarded.\nAssessment: packaging_intact\
  \ + expiry_date (defined in FoodCategory). No condition_grade or assessment_result\
  \ — food safety is binary: packaging intact or not, expired or not. FoodCategory\
  \ does not extend CategoryMixin for this reason."
from_schema: https://inkind-at.github.io/inkind-knowledge-repo
see_also:
- foodon:00001006
- http://purl.obolibrary.org/obo/foodon.owl
is_a: DonationItem
mixins:
- FoodCategory
class_uri: foodon:00001006
rules:
- preconditions:
    slot_conditions:
      lifecycle_state:
        name: lifecycle_state
        equals_string: sorted
  postconditions:
    slot_conditions:
      storage_requirement:
        name: storage_requirement
        required: true
  description: storage_requirement required at sorted state.
  title: lc-sorted-food-storage-required

name: FoodItem
annotations:
  label_en:
    tag: label_en
    value: Food
  label_de:
    tag: label_de
    value: Essen
description: "Food donation item. COICOP Division 01 (food and non-alcoholic beverages).\
  \ Grounded in FoodOn (OBO Foundry food ontology):\n  http://purl.obolibrary.org/obo/foodon.owl\n\
  \nPhase 1 stub — fully declared to establish the schema; the sort_food process path\
  \ is activated when food-bank organisations are onboarded.\nAssessment: packaging_intact\
  \ + expiry_date (defined in FoodCategory). No condition_grade or assessment_result\
  \ — food safety is binary: packaging intact or not, expired or not. FoodCategory\
  \ does not extend CategoryMixin for this reason."
from_schema: https://inkind-at.github.io/inkind-knowledge-repo
see_also:
- foodon:00001006
- http://purl.obolibrary.org/obo/foodon.owl
is_a: DonationItem
mixins:
- FoodCategory
attributes:
  food_type:
    name: food_type
    description: Primary food type classification. Grounded in FoodOn food product
      taxonomy. Determines valid storage_requirement values via value map.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - foodon:00001017
    rank: 1000
    alias: food_type
    owner: FoodItem
    domain_of:
    - FoodCategory
    range: FoodTypeEnum
    required: true
  expiry_date:
    name: expiry_date
    annotations:
      uc_action:
        tag: uc_action
        value: block
      uc_suggest:
        tag: uc_suggest
        value: disposal
      uc_note:
        tag: uc_note
        value: Dynamic date comparison — runtime enforcement
    description: 'Expiry or best-before date as printed on the packaging. UC block:
      expiry_date < today (runtime check by Django model clean()).'
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - foodon:00001043
    rank: 1000
    alias: expiry_date
    owner: FoodItem
    domain_of:
    - PersonalCareCategory
    - BabyInfantCategory
    - FoodCategory
    range: date
  packaging_intact:
    name: packaging_intact
    description: 'Whether the item''s original packaging is intact and uncompromised.
      UC block: false + perishable food_type → must not redistribute. Primary safety
      signal for food items — analogous to is_sealed in PersonalCareCategory.'
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    see_also:
    - foodon:00001043
    rank: 1000
    alias: packaging_intact
    owner: FoodItem
    domain_of:
    - FoodCategory
    range: boolean
    required: true
  storage_requirement:
    name: storage_requirement
    description: Required storage condition. Valid values constrained by food_type
      via vm-storage-* rules. Set during sorting to enable correct storage slot assignment
      and demand signal matching.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: storage_requirement
    owner: FoodItem
    domain_of:
    - FoodCategory
    range: StorageRequirementEnum
    required: true
  quantity:
    name: quantity
    description: Quantity in natural units (items, cans, bags, kg, etc.). Optional
      — detailed completeness tier. Supports demand signal fulfilment tracking.
    from_schema: https://inkind-at.github.io/inkind-knowledge-repo
    rank: 1000
    alias: quantity
    owner: FoodItem
    domain_of:
    - FoodCategory
    range: integer
  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: FoodItem
    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: FoodItem
    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: FoodItem
    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: FoodItem
    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: FoodItem
    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: FoodItem
    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: FoodItem
    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: FoodItem
    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: FoodItem
    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: FoodItem
    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: FoodItem
    domain_of:
    - DonationItem
    range: datetime
    required: true
class_uri: foodon:00001006
rules:
- preconditions:
    slot_conditions:
      lifecycle_state:
        name: lifecycle_state
        equals_string: sorted
  postconditions:
    slot_conditions:
      storage_requirement:
        name: storage_requirement
        required: true
  description: storage_requirement required at sorted state.
  title: lc-sorted-food-storage-required