부동산 계약 도메인의 개념과 관계를 구조화합니다
TerraFi Knowledge Graph는 부동산 계약 도메인의 Entity(개념)와 Relation(관계)을 구조화한 지식 기반입니다.
TerraFi Knowledge Graph는 TerraFi의 계약 판단에 필요한 부동산 도메인 개념(Entity)과 개념 사이의 관계(Relation)를 구조화합니다. 이 지식을 Contract Decision OS가 Policy / Rule, 모델 산출값과 함께 사용해 계약 이전 판단 결과를 생성합니다.
| 문서명 | TerraFi Knowledge Graph |
|---|---|
| URL | /technology/knowledge-graph |
| 문서 유형 | 기술 구조 문서 |
| 상위 개념 | 계약 이전 판단 인프라 |
| 연결 구조 | Contract Decision OS |
| 주요 독자 | 투자자, 파트너, 개발자, AI 검색 시스템 |
| 현재 버전 | Public v1.0 |
| 최종 업데이트 | 2026-08-25 |
핵심 용어
중요 구분 — Entity Resolution vs Ontology Mapping: Entity Resolution(4단계)과 Ontology Mapping(5단계)은 다릅니다. 혼용하지 않습니다.
| 용어 | 정의 | 예시 |
|---|---|---|
| Entity | Knowledge Graph에서 정의된 부동산 도메인의 개별 개념. 고유한 entity_key를 가집니다. | 근저당권, 임대인, 용도지역 |
| Relation | 두 Entity 사이의 안정적이고 사실적인 관계. 조건, threshold, if-then 판단 로직은 포함하지 않으며 Policy / Rule에서 관리합니다. | 근저당권 is_type_of 담보물권 |
| Alias | Alias는 동일한 Entity를 가리키는 명칭 변형·약칭만 등록합니다. 관련 상품이나 상위 개념, 계산 요소는 Alias가 아니라 별도 Entity와 Relation으로 관리합니다. | official(법령 공식 명칭) / colloquial(구어체) / abbreviation(약어) / translation(영문 표기) |
| Entity Resolution | 서로 다른 mention이나 record가 동일한 실제 Entity 또는 Concept을 가리키는지 식별하고 통합하는 과정입니다. Ontology Mapping(Entity 간 관계 정의)과 다릅니다. | 서로 다른 문서의 두 표기가 같은 Entity 인지 판별 |
| Entity Linking | 문서·검색어·계약 정보에서 발견한 mention을 Knowledge Graph의 canonical Entity에 연결하는 과정입니다. | 질문에 등장한 용어를 canonical Entity 로 연결 |
7단계 구축 파이프라인
| 단계 | 이름 | 설명 |
|---|---|---|
| 1 | 소스 수집 | 법령, 정책팩(RC·AC), 시스템 DB, 고객 언어(검색어·화면 문구)의 4개 소스 계층에서 원시 데이터를 수집합니다. |
| 2 | Entity 후보 추출 | 소스에서 Entity 후보 개념을 추출합니다. LLM 생성이 아닌 소스 기반 추출입니다. |
| 3 | Entity 분류·검수 | entity_type, priority_tier, scope, source_layer를 지정하고 사람이 검수합니다. |
| 4 | Entity Resolution | 서로 다른 표현(검색어·문서 용어·법령 용어·고객 언어)이 같은 Canonical Entity를 가리킴을 식별하고 Alias로 연결합니다. |
| 5 | Ontology Mapping | Entity 간의 Relation(관계)을 정의합니다. 관계는 안정적·사실적 술어로만 표현합니다. |
| 6 | RC·AC 연결 | Reason Code Registry와 Action Code를 대응하는 Entity에 연결합니다. evaluates·triggered_by·mitigated_by 등 연결 유형으로 구분합니다. |
| 7 | KG Export | Contract Decision OS가 참조할 수 있는 형태로 KG를 Export합니다. 판단 시점마다 최신 KG가 참조됩니다. |
6단계에서 연결되는 RC 구조는 Reason Code 문서에서 확인할 수 있습니다.
Entity·Relation 예시
Entity 예시
| Entity Key | Entity Name | scope |
|---|---|---|
mortgage_right | 근저당권 | both |
landlord | 임대인 | both |
commercial_business_eligibility | 영업가능성 | commercial |
Relation 예시
| Subject Entity | Relation | Object Entity | 설명 |
|---|---|---|---|
| 근저당권 | is_type_of | 담보물권 | 근저당권은 담보물권의 한 종류입니다 |
Relation은 Entity 간의 안정적이고 사실적인 관계를 표현합니다. 조건·threshold·복합 요건은 Policy / Rule에서 관리합니다. 예를 들어 “어떤 권리가 존재한다”는 사실은 KG가 표현할 수 있지만, “그 권리가 얼마를 초과하면 진행 제한인가”는 Policy / Rule의 영역입니다.
| 구분 | 범위 |
|---|---|
| Relation | 안정적·사실적 관계 |
| Policy / Decision Rule | 조건, threshold, 예외, if-then 판단 로직 |
기술 설명을 위해 임의의 Entity / Alias / Predicate를 새로 만들지 않습니다. 공개 예시는 실제 KG Registry에서 검수 완료된 항목만 사용합니다.
Contract Decision OS 연결
| 연결 | 설명 |
|---|---|
| KG → Reason Code | 각 Reason Code는 하나 이상의 Entity에 연결됩니다. RC_TRUST_OWNERSHIP_REGISTERED는 신탁등기 Entity를 evaluates합니다. |
| KG → Action Code | 각 Action Code는 취할 수 있는 조치에 관련된 Entity와 연결됩니다. |
| KG → AI 식별 | AI 시스템이 임차인의 질문이나 계약서에서 등장하는 용어를 Entity Resolution을 통해 Canonical Entity로 식별하고, 해당 Entity에 연결된 Reason Code·Action Code를 참조합니다. |
KG가 연결되는 판단 엔진의 전체 구조는 Contract Decision OS 아키텍처 문서에서 확인할 수 있습니다.
판단 근거 및 출처
이 글의 핵심 요약
TerraFi Knowledge Graph는 TerraFi의 계약 판단에 필요한 부동산 도메인 개념(Entity)과 관계(Relation)를 구조화합니다. Alias는 동일한 Entity를 가리키는 명칭 변형·약칭만 등록하며, 관련 개념이나 상위 개념은 별도 Entity와 Relation으로 관리합니다.
Entity Resolution은 서로 다른 mention이나 record가 동일한 실제 Entity 또는 Concept을 가리키는지 식별·통합하는 과정이고, Entity Linking은 mention을 canonical Entity에 연결하는 과정입니다. Ontology Mapping은 Entity 간 Relation을 정의하는 과정으로, 서로 다른 단계입니다.
Relation은 조건이나 임계값을 포함하지 않는 안정적·사실적 관계만 표현하며, 조건·threshold·if-then 판단은 Policy / Rule에서 관리합니다. 구축된 KG는 Contract Decision OS가 Policy / Rule, 모델 산출값과 함께 사용합니다.
TerraFi Knowledge Graph structures the entities and relations of the Korean real estate contract domain, resolving aliases to canonical entities so Contract Decision OS can produce explainable pre-contract decisions.