판정별 산출물 규칙
작업이 확정되면 판정에 따라tgt 위치에 저장되는 것이 달라집니다:
PASS를 원본 사본 저장(기본)으로 두면, 후속 파이프라인이 판정과 무관하게
tgt만 보고 이어질 수 있습니다.
안전 원칙(fail-closed) — 마스킹 파일을 안전하게 재구성할 수 없는 경우 해당 파일은 BLOCK으로 처리됩니다. 처리에 실패한 작업은 아무것도 저장하지 않으며,
tgt 기록은 원자적으로 확정됩니다(처리 도중의 미완성 파일이 나타나지 않음). 즉 **tgt 위치에 도착한 파일은 언제나 “검사를 통과했거나 완전히 마스킹된 파일”**입니다.지원 파일 형식
- 실제 허용 형식은 프로젝트 설정에 따라 결정됩니다(위 표는 지원 가능한 전체 범위). 설정 밖의 형식은 프로젝트의 미지원 파일 처리 정책에 따라 거부되거나 검사에서 제외됩니다.
- 파일 확장자와 실제 내용(파일 시그니처)이 다른 위장 파일은 거부됩니다.
한도
파일 크기 · 텍스트 길이 한도는 프로젝트 설정값을 따르며, 강제는 Guardian 단일 지점입니다 — 최상위 파일뿐 아니라 파일에서 추출된 텍스트, 아카이브 내부까지 같은 한도로 검사됩니다. 한도를 초과하면 작업이FILE_TOO_LARGE / TEXT_TOO_LONG으로 실패 확정됩니다(배치 오류 참고).
버킷 참조 입력이라 요청 본문에 파일이 없으므로, 인라인 API에 적용되는 입력 수신 상한의 대상이 아닙니다 — 크기 통제는 검사 한도 하나로 일원화됩니다.
처리 순서
배치 작업은 접수 순서대로 처리됩니다(선입선출). 별도의 우선순위 계층은 없으며, 동시 실행 규모 · 대기열 상한은 운영 값입니다.데이터 보존
- 콘텐츠 무보존 — 원본과 산출물 본문은 처리 중에만 다루며 작업 기록에 남기지 않습니다. 작업 기록은 경로 · 판정 · 탐지 결과 · 오류의 메타데이터만 담습니다.
- 작업 기록은 단기 — 작업 조회 API의 백엔드인 작업 기록은 운영 조회 ·
src검색 복구용 단기 기록으로, 보존 · 정리 주기는 운영 정책을 따릅니다. - 장기 이력은 Opticon — 배치 처리도 Opticon 트레이스로 기록되며, 접수 정보(
job_id·src_s3_url·tgt_s3_url·process_type)와 판정 · 오류가 함께 담깁니다. 지난 작업을 확인해야 할 때의 확인 표면은 Opticon입니다.