schema / card_version / case_key(스키마 / 카드 버전 / 사례 키) | schema(카드 형식), card_version(카드 버전), case_key(사례 고유 키) | 카드가 어떤 형식으로 저장됐는지, 어떤 버전의 규칙을 따르는지, 어떤 사례를 가리키는지 흔들리지 않게 고정하는 것입니다. |
identity(기본 정보) | product_name(제품명), brand(브랜드), designers(디자이너), studio(스튜디오), source_url(출처 URL), source_type(출처 유형), collected_at(수집일) | 이 사례가 무엇이고 누가 만들었으며 어디서 온 자료인지 먼저 식별하는 것입니다. |
source_documents(출처 문서) | url(문서 URL), source_type(출처 유형), speaker_role(발화 주체), raw_text_ref(원문 텍스트 참조), raw_html_ref(원문 HTML 참조), fetched_at(수집 시각), reliability(출처 신뢰도) | 원문으로 되돌아갈 수 있는 경로를 남기는 것입니다. |
raw_refs(원본 참조) | raw_text_refs(원문 텍스트 참조), raw_html_refs(원문 HTML 참조), ocr_refs(OCR 참조), scrape_result_ref(스크래핑 결과 참조) | 카드가 요약본으로 바뀐 뒤에도 원본 자료를 다시 확인할 수 있게 하는 것입니다. |
source_context(출처 맥락) | primary_voice(주 발화 주체), summary(원문 맥락 요약), raw_text_policy(원문 저장 정책) | 이 자료가 디자이너의 설명인지, 브랜드의 주장인지, 평가자의 해석인지 구분하는 것입니다. |
source_passages(원문 문맥) | passage_text(충분한 원문 문맥), passage_summary(문맥 요약), speaker_role(발화 주체), source_location(출처 위치), supports(연결되는 판단 필드) | 짧은 인용 조각이 아니라 판단이 기대는 문맥을 보존하는 것입니다. |
assets(자산) | image_dir_ref(이미지 폴더 참조), image_count(이미지 수), images(image_ref(이미지 참조), role(역할), local_ref(로컬 경로), source_url(원본 URL), relevance(관련도), observation_targets(관찰 대상)) | 이미지와 원본 자산을 판단 필드와 분리해 관리하는 것입니다. |
basis(근거) | basis_text(근거 문장), basis_type(근거 유형), source_location(출처 위치), supports(연결되는 판단 필드) | 모든 판단에 왜 그렇게 기록했는지 설명할 수 있는 근거를 붙이는 것입니다. |
knowledge(8가지 카테고리) | 8가지 카테고리의 세부 판단 필드입니다. 각 필드는 value/values(값), grounding_label(근거 라벨), grade(Gold/Silver/Bronze), basis_text(근거 문장)를 가집니다. | 디자인 사례를 비교 가능한 판단 단위로 쪼개는 것입니다. |
design_logic(설계 이유) | perspective_source(관점 출처), perceived_problem(문제), design_intent(의도), solution_approach(해결 방식), key_design_choices(주요 디자인 선택), user_experience(사용자 경험), reusable_principle(재사용 원칙) | 결과물의 형태만 저장하지 않고 왜 그런 설계가 나왔는지 연결하는 것입니다. |
summary(요약) | one_line(한 줄 요약), why_it_matters(기록 가치/의의) | 앞의 원문, 근거, 판단을 사람이 빠르게 이해할 수 있는 문장으로 압축하는 것입니다. |
rag_hints(RAG 힌트) | index_targets(색인 대상), do_not_index(색인 제외), primary_queries(대표 질의) | 저장된 카드를 검색 가능한 지식 단위로 바꾸는 기준을 남기는 것입니다. |
display(표시 자산) | hero_asset_ref(대표 이미지 참조), thumbnail_refs(썸네일 참조), preferred_caption(화면 표시 캡션) | 사람이 사례를 훑어볼 때 필요한 대표 이미지를 제공하되, 디자인 판단의 근거와는 분리하는 것입니다. |