개념 - locator 계약

정의

locator 계약은 timebooks에서 검색 결과, 정렬 에지, review task가 모두 VideoSegment, DocumentSpan, ReviewTaskLocatorSnapshot 같은 공통 위치 객체 규약으로 서로를 가리키도록 만드는 계약 개념입니다.

왜 중요한가

위치 정합 탐색이 실제로 동작하려면 결과 화면, 저장 계층, 검수 큐가 모두 같은 위치 표현을 써야 합니다. locator 계약이 없으면 검색은 문장 조각을 돌려주고 review task는 별도 ref를 쓰며, deep-link 이동은 또 다른 좌표 체계를 쓰는 식으로 어긋납니다. 이 계약은 검색, 검수, 저장을 하나의 정합 구조로 묶는 공통 언어입니다.

이 저장소 맥락에서의 해석

이 개념은 영상-문서 위치 정렬과 위치 정합 기반 탐색을 구현 표면으로 연결하는 규약 층입니다. 정렬이 대응 관계를 만든다면, locator 계약은 그 대응 관계를 검색 응답과 review task, 승인된 evidence까지 일관되게 전달하는 방법을 설명합니다.

관련 문서

• 도메인 - Timebooks
• 소스 - Timebooks Readme
• 개념 - 영상-문서 위치 정렬
• 개념 - 위치 정합 기반 탐색
• 엔티티 - Alignment Edge Store
• 엔티티 - ReviewTask Locator Snapshot
• 엔티티 - Review Task
• 합성 - Timebooks 학습 제어 루프

메모

• 핵심은 위치 정보를 텍스트 부가 필드가 아니라 공통 계약 객체로 다루는 데 있습니다.
• 이후에는 locator kind, label, summary field 규칙으로 더 세분화할 수 있습니다.