개념 - 인입 완료 증거 게이트

정의

인입 완료 증거 게이트는 외부 asset/parser worker가 만든 signed video/PDF URL, raw segment/span artifact, runtime bundle, smoke report를 단순 산출물이 아니라 재검증 가능한 운영 증거로 묶는 timebooks 개념입니다. 최근 timebooks는 timebooks-run-worker-output-gate, timebooks-run-ingestion-smoke, artifact/smoke report verifier를 통해 API 제출 전 preflight와 제출 후 student/operations 확인을 한 흐름으로 고정합니다.

왜 중요한가

인입 파이프라인은 성공 응답만으로 완료를 판단하기 어렵습니다. signed URL이 실제 접근 가능한지, raw artifact가 course/video/document identity를 포함하는지, review task 승인 뒤 student traversal link가 비어 있지 않은지, viewer context JSON이 프론트가 소비할 계약을 만족하는지를 함께 확인해야 합니다. 이 게이트는 그런 조건을 수동 체크리스트가 아니라 파일로 남는 검증 증거로 바꿉니다.

이 저장소 맥락에서의 역할

timebooks 도메인에서 structured ingestion은 이제 asset URL 보존이나 pipeline run 제출에 머물지 않습니다. 실제 worker output directory를 기준으로 runtime bundle을 만들고, artifact report와 smoke report를 남기며, real signed URL gate가 local demo/dry-run을 완료 증거로 오인하지 못하게 막습니다. 따라서 이 개념은 자동 정렬과 운영 검수 사이에 놓인 "입력 신뢰도" 계층으로 읽어야 합니다.

관련 소스

• 소스 - Timebooks Readme
• 소스 - Timebooks Project Handoff
• 소스 - Timebooks Product Operations Status

관련 개념과 엔티티

• 개념 - 자동 정렬
• 개념 - 영상-문서 위치 정렬
• 개념 - 위치 정합 기반 탐색
• 개념 - 양방향 학습 탐색
• 엔티티 - Operations Portal
• 엔티티 - Review Task

열린 질문

• real signed URL worker 산출물이 반복 실행될 때, report 파일의 보존 기간과 재검증 책임은 어느 운영 계층이 가져야 하는가?
• student viewer context와 post-approval student link payload를 배포 gate에 얼마나 강하게 묶어야 프론트 변경과 ingestion 변경의 결합도가 과해지지 않을까?