05. 구조 매칭 4 항목 — MDX 본문을 어떻게 분석하나
DECK 04 의 「구조 매칭」 4 항목이 코드에서 실제로 어떻게 동작하는지 상세 설명. 각 항목별 정의 + 매칭 방법 + 사용하는 키워드 사전.
1콘텐츠 성격 (content_affinity)정확도 약함
무엇인가 : MDX 콘텐츠가 어떤 종류의 정보를 담는가 (개념 정의 / 비교 / 정책·요구사항 / 단계 흐름 / 변화 / 역할 등 12 카테고리)
매칭 방법 : 사전 정의 12 카테고리의 키워드 사전을 가지고 MDX 본문에서 각 키워드 등장 횟수를 카운트 → 가장 많이 매칭된 카테고리 = primary. (2위·3위 = secondary)
| 카테고리 (영문 enum / 한글) | 매칭 키워드 |
|---|
concept_definition 개념 정의 | 정의, 이란, 분류, 구분 |
concept_comparison 개념 비교 | 비교, 대조, 차이, vs, VS, 상호관계 |
goal_axes 목표 축 | 목표, 궁극적, 비전, 목적, 지향 |
persona_benefit 대상별 효익 | 발주자, 설계자, 시공자, 기대효과, 혜택, 이익 |
process_steps 단계 흐름 | 단계, 순서, Step, 1단계, 2단계, 흐름 |
before_after_change 변화 / 전환 | AS-IS, TO-BE, 전환, 혁신, 변화, 이중 변환, 과정 (STRONG 패턴 필수) |
capability_requirements 역량 / 요건 | 필수, 요건, 필요, 역량, S/W, 도구 |
comparative_matrix 행렬형 비교 | 다면, 다축, 관점별, 여러 관점, 축 |
stakeholder_roles 이해관계자 역할 | 역할, 책임, 주도 |
policy_requirements 정책 / 요구사항 | 정책, 제도, 도입, 거버넌스, 전면 도입, 국외, 국내, 선진, 현황, 사례 |
tool_ecosystem 도구 생태계 | Revit, Navisworks, SketchUp, 소프트웨어, S/W 생태 |
interrelation 상호관계 | 상호관계, 순환, 조화, 교차, 수렴, 3원, 순환도, 관계도 |
예시 — MDX 01-2 (DX 와 BIM 의 구분)
본문에 「국내, 도입, 사례, 현황」 다수 등장 → policy_requirements (정책/요구사항) 1위로 잘못 잡힘. 한계 : 단순 카운트라 부정확 (사람이 보면 「행렬형 비교」가 맞음)
2시각 의도 (structure_intent)정확도 약함
무엇인가 : 콘텐츠를 어떤 방식으로 시각적으로 표현하려는지 (2 항목 비교 / 매트릭스 / 순환 / 단계 / 위계 / 강조 등 9 카테고리)
매칭 방법 : 사전 9 카테고리 키워드 매칭 (콘텐츠 성격과 동일 방식) + 일부 카테고리는 STRONG 구절 패턴 추가 검증 필수 (예: state_transition 은 「AS-IS / TO-BE」 같은 강한 구절 1개 이상)
| 카테고리 (영문 enum / 한글) | 매칭 키워드 |
|---|
binary_compare 2 항목 직접 비교 | 2개 비교, 2개 개념, 대조, 양분 |
state_transition 상태 전환 | AS-IS, TO-BE, 전환, 혁신, 이중 Transformation, 과정 (STRONG 필수) |
cycle_interrelation 순환 / 상호 관계 | 상호관계, 순환, 조화, 교차, 3원 |
multi_parallel 다항목 병렬 | 3개 병렬, 4개 병렬, 카드 3열, 3관점 |
hierarchy 위계 | 단일 키워드 매칭 금지 — STRONG 구절 패턴만 인정 |
sequence 순차 단계 | 단계, 순서, 흐름, step |
matrix_coverage 매트릭스 (모든 축 한눈에) | 다면, 관점별, 여러 관점, 축별 |
persona_mapping 주체별 매핑 | 주체별, 발주자/설계자/시공자, 역할별 |
singleton_emphasis 단일 강조 | 강조, 문제, 진단, 약점 |
예시 — MDX 01-2
제목·본문에 「상호관계」 단어가 있어 cycle_interrelation (순환/상호 관계) 1위로 잡힘. 한계 : 도메인 키워드 사전이라 일반 표현은 못 잡음
3편집 슬롯 (slot)표면적 검사만
무엇인가 : 프레임에서 텍스트 교체 가능한 영역 (예: 제목 / A 컬럼 라벨 / B 컬럼 라벨 / 행 데이터). MDX 콘텐츠가 이 슬롯들을 채울 수 있는가가 핵심.
매칭 방법 : MDX 본문에서 슬롯 후보를 자동 추출 → 후보의 라벨/본문 유무로 점수.
· 슬롯 후보 추출 우선순위 :
① subsections (`##` 헤딩) 있으면 → 각 헤딩이 슬롯. label = 헤딩 텍스트, body = 헤딩 아래 본문
② 표 있으면 → 각 컬럼이 슬롯. label = 컬럼 헤더, body = 첫 행 데이터
③ 불릿 (`*`, `-`) 있으면 → 각 불릿이 슬롯. label = 불릿 첫 단어, body = 불릿 나머지
· 점수 계산 (휴리스틱) :
① MDX 항목 수가 frame cardinality [min, max] 범위 안 → +0.5
② 모든 후보에 라벨이 비어있지 않음 → +0.3
③ 모든 후보에 본문이 비어있지 않음 → +0.2 / 최대 1.0
예시 — MDX 01-2 ↔ Frame 18
MDX 본문에 표 발견 → 컬럼 2개 추출 :
[1] label="DX", body="BIM << DX (Engineering + Management 통합)"
[2] label="BIM", body="Only 3D (형상 구현 중심)"
→ Frame 18 cardinality 2/2/2 범위 내 (+0.5) + 라벨 둘 다 있음 (+0.3) + 본문 둘 다 있음 (+0.2) = 1.00
한계 1 : 표 첫 행만 추출, 나머지 행 (S/W·프로세스·성과품) 무시
한계 2 : "BIM → col_a_label, DX → col_b_label" 같은 frame 슬롯과의 의미 매핑 없음 (후속 단계 텍스트 편집자 책임)
4항목 수 / 관계 (cardinality + relation_type)비교적 정확
무엇인가 : MDX 콘텐츠의 비교 단위 개수와 관계 유형. 관계 유형 = compare(비교) / parallel(병렬) / sequence(순서) 중 하나.
매칭 방법 : detect_mdx_layout_v2 함수가 MDX 본문에서 구조 패턴을 자동 감지 → MDX_LAYOUT_STRUCTURE 사전에서 해당 layout 의 family / relation_type / cardinality_ideal 가져옴.
· 표 형태 (`|`, `|---|`) 패턴 → table family
· `1.`, `2.`, `Step 1`, `→` 등 → sequence
· 카드 나열 / `*` 불릿 N개 → parallel + cardinality
예시 — MDX 01-2
본문이 4 행 표 (범위/SW/프로세스/성과품 × BIM/DX) → compare-rows layout 감지 → family=table, relation_type=compare, cardinality=2. 정확 (구조적 신호라 안정적)