Docling VideoPipeline의 picture.source: 단일 원소도 list로 보존하기
변환 완료와 재사용 가능한 문서 완성은 다르므로 영상·문서 팀이 재독해 계약을 함께 확인해야 한다.
Docling VideoPipeline의 picture.source: 단일 원소도 list로 보존하기
문서에 연결된 source가 하나라고 해서 컨테이너까지 단일 객체로 바꾸어도 되는 것은 아니다. 그림과 텍스트가 다른 처리 경로를 쓰면 텍스트의 성공이 그림의 저장·재적재를 보증하지 않는다. 외부 스키마가 요구하는 목록 형태를 item 종류별로 확인해야 한다. [1, 2, 3]
공개 원문이 보여 준 범위
Docling VideoPipeline이 picture.source의 list 필드에 단일 TrackSource를 대입해 내보내기 경고와 다시 읽기 ValidationError를 유발한다는 보고다. 텍스트 경로는 append를 써서 같은 문제가 없다고 구별한다. [1]
입력과 출력에서 확인할 관계
그림과 텍스트의 source 형태를 나눈 manifest를 만들고 저장한 JSON을 스키마로 다시 읽은 뒤 후속 분석에 넘긴다. item_kind, item_id, source_container_kind, reload_status를 연결하면 텍스트 경로의 성공으로 그림 경로까지 승인하는 일을 피한다. 컨테이너 형태는 실제 source 개수와 별도로 기록한다. [1, 3]
승인 기준과 실패 사례
설명용 그림에서 source가 하나뿐이어도 외부 계약은 그 원소를 담은 list를 요구한다. list는 승인한 형태이고 단일 object는 반례다. 논리적인 source 개수가 같다고 외부 표현을 서로 바꿔 쓸 수 있는 것은 아니다. 이 확인은 그림 내용이나 전사의 정확도가 아니라 저장과 재적재 사이의 구조 보존에 한정된다. [1, 3]
Truthound를 연결하는 검사 경계
Truthound Core 3.3.2의 InSetValidator는 문서에서 추출한 source_container_kind가 해당 item 종류의 허용 형태인지 검사할 수 있다. JSON을 읽어 item별 형태를 추출하는 adapter와 Docling의 스키마 재검증은 별도 단계다. 그림 내용이나 전사 정확도를 확인하는 기능으로 확대하지 않는다. [1, 2, 3]
다른 선택이 필요한 조건
컨테이너 검사로 영상 내용·전사 정확도·실제 촬영 시각이 검증되지는 않는다. 문서 모델의 assignment 검증과 공식 재독해 시험을 변환 경계에 추가한다. 새로운 문서 스키마가 단일 object도 허용한다면 version별 계약으로 다시 판단해야 한다. [1, 3]
적용 조건
item_kind, item_id, source_container_kind, reload_status 표를 원시 입력과 승인 기준에서 각각 준비하고 행 식별자를 유지한다.
대안
문서 모델의 assignment 검증과 공식 재독해 시험을 변환 경계에 추가한다.
한계
컨테이너 검사로 영상 내용·전사 정확도·실제 촬영 시각이 검증되지는 않는다.
근거
- 사건 확인일
- 대상 확인일
- 수정일
