v3 카드 템플릿

# 디자인 저장소 v3 카드 템플릿
# 생성 결과에서는 빈 판단 필드를 제거하고 missing_fields에만 기록합니다.
# 설명이 필요한 필드는 statement, 분류·키워드·CMF처럼 값 자체가 중요한 필드는 value/values를 씁니다.
# Gold/Silver/Bronze는 카드 전체 총점이 아니라 각 필드의 근거 등급입니다.

schema: piix.design_knowledge.card
card_version: "3.0"
card_id: ""

identity:
  product_name: ""
  brand: ""
  designers: []
  studio: ""
  source_url: ""
  source_type: ""
  collected_at: ""

summary:
  one_line:
    statement: ""
    tags: []
    grounding: original_text
    confidence: Gold
    basis:
      - quote: ""
        source_ref: ""
        locator: ""
  why_it_matters:
    statement: ""
    tags: []
    grounding: original_plus_inference
    confidence: Silver
    basis:
      - reasoning: ""
        source_ref: ""
        locator: ""

knowledge:
  product_category:
    main_category: null
    product_type: null
    sub_category: null
    adjacent_domain: null

  user:
    user_group: null
    persona: null
    skill_level: null
    needs: null
    things_to_avoid: null

  use_context:
    place: null
    situation: null
    moment: null
    frequency: null
    surrounding_environment: null

  problem:
    problem_definition: null
    pain_points: null
    tension: null
    opportunity_area: null
    limits_of_existing_solution: null

  experience_value:
    core_value: null
    emotional_tone: null
    user_effect: null
    before_after: null
    brand_experience: null

  form_strategy:
    shape_keywords: null
    structure: null
    volume_language: null
    detail_strategy: null
    visual_hierarchy: null
    product_typology: null

  cmf:
    color:
      main_color: null
      accent_color: null
      tone: null
      contrast: null
    material:
      main_material: null
      secondary_material: null
      structural_material: null
      surface_material: null
      transparent_material: null
      flexible_material: null
    finish:
      surface_finish: null
      gloss: null
      texture: null
      touch: null
      processing_feel: null

  technology_production:
    core_technology: null
    internal_components: null
    structure_type: null
    interface: null
    production_method: null
    manufacturing_hint: null
    constraints: null
    safety_durability: null

design_logic:
  perceived_problem: null
  intent: null
  solution: null
  key_design_choices: null
  user_experience: null
  reusable_principle: null

quality_summary:
  field_count: 0
  confidence_distribution:
    Gold: 0
    Silver: 0
    Bronze: 0
    No data: 0
  grounding_distribution:
    original_text: 0
    original_plus_inference: 0
    image_observation: 0
    image_plus_inference: 0
    inference: 0
  missing_field_count: 0
  review_status: needs_review

raw_refs:
  source_card_file: ""
  raw_text_file: ""
  raw_html_file: ""
  images_dir: ""
  ocr_file: ""
  scrape_log: ""
  run_log: ""
  index_file: ""

missing_fields: []

# statement field 예시: 문제, 의도, 해결 방식처럼 설명이 필요한 필드에 사용합니다.
# user:
# problem:
#   problem_definition:
#     statement: "자기표현을 위해 헤어 스타일링을 일상적으로 시도하고 싶지만, 기존 스타일링은 도구 숙련도 의존이 커서 캐주얼하게 접근하기 어렵다."
#     tags:
#       - 도구 숙련도 부담
#       - 쉬운 시작
#     grounding: original_plus_inference
#     confidence: Silver
#     basis:
#       - quote: "traditional styling still relies heavily on tool expertise"
#         source_ref: "raw/behance/newbe/source.txt"
#         locator: "description paragraph 1"
#
# structured scalar field 예시: 제품 유형처럼 단일 값이 중요한 필드에 사용합니다.
# product_category:
#   product_type:
#     value: "개인용 헤어 스타일링 스테이션"
#     tags:
#       - 헤어 스타일링
#       - 퍼스널 케어
#     grounding: original_text
#     confidence: Gold
#     basis:
#       - quote: "a personal hair styling station"
#         source_ref: "raw/behance/newbe/source.txt"
#         locator: "description paragraph 1"
#
# structured list field 예시: 키워드, CMF, 사용자군처럼 여러 값이 중요한 필드에 사용합니다.
# experience_value:
#   core_value:
#     values:
#       - 자기표현
#       - 개인화
#       - 쉬운 시작
#     grounding: original_plus_inference
#     confidence: Silver
#     basis:
#       - reasoning: "원문 설명과 사용 맥락을 바탕으로 경험 가치를 판단했습니다."