> ## Documentation Index
> Fetch the complete documentation index at: https://docs.starfort.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 산출물 규칙과 한도

> Starfort 배치 비식별화 작업의 verdict별 tgt 출력, 지원 포맷, 검사 한도, 처리 순서, S3 상 보존 기간을 정리합니다 (Starfort v1.4 문서)

## 판정별 산출물 규칙

작업이 확정되면 판정에 따라 `tgt` 위치에 저장되는 것이 달라집니다:

| 판정         | 의미                      | `tgt` 위치에 저장되는 것                                        |
| ---------- | ----------------------- | ------------------------------------------------------- |
| **PASS**   | 탐지된 항목 없음(또는 통과 정책에 해당) | 원본 사본 — `options.on_pass: "skip"`으로 저장 생략 가능            |
| **MASK**   | 마스킹 대상 항목 탐지            | **원본과 동일한 형식으로 재구성된 마스킹 파일**(예: `.docx`는 마스킹된 `.docx`로) |
| **BLOCK**  | 차단 정책에 해당               | 저장되지 않음 — 차단 사유는 [작업 조회](/ko/v1.4/api/batch/jobs)로 제공   |
| (`FAILED`) | 검사 미완수                  | 저장되지 않음 — 부분 산출물 금지                                     |

PASS를 원본 사본 저장(기본)으로 두면, 후속 파이프라인이 판정과 무관하게 `tgt`만 보고 이어질 수 있습니다.

<Note>
  **안전 원칙(fail-closed)** — 마스킹 파일을 안전하게 재구성할 수 없는 경우 해당 파일은 BLOCK으로 처리됩니다. 처리에 실패한 작업은 아무것도 저장하지 않으며, `tgt` 기록은 원자적으로 확정됩니다(처리 도중의 미완성 파일이 나타나지 않음). 즉 \*\*`tgt` 위치에 도착한 파일은 언제나 "검사를 통과했거나 완전히 마스킹된 파일"\*\*입니다.
</Note>

## 지원 파일 형식

| 구분       | 내용                                                                                                                    |
| -------- | --------------------------------------------------------------------------------------------------------------------- |
| 문서       | `.pdf` `.docx` `.xlsx` `.pptx` `.txt` `.md` `.csv` `.tsv` `.html` `.json` `.rtf` `.odt` `.ods` `.odp` `.epub` `.hwpx` |
| 이미지      | `.png` `.jpg` `.gif` `.bmp` `.tiff` `.webp` `.avif` `.heic` — 탐지 영역을 픽셀 단위로 가리는 방식으로 마스킹                              |
| 압축       | `.zip` — 내부 파일 각각을 검사 · 마스킹한 뒤 다시 zip으로 재구성                                                                           |
| 문서 내 이미지 | 문서에 포함된 이미지도 함께 검사 · 마스킹                                                                                              |

* 실제 허용 형식은 **프로젝트 설정**에 따라 결정됩니다(위 표는 지원 가능한 전체 범위). 설정 밖의 형식은 프로젝트의 [미지원 파일 처리 정책](/ko/v1.4/api/multimodal)에 따라 거부되거나 검사에서 제외됩니다.
* 파일 확장자와 실제 내용(파일 시그니처)이 다른 **위장 파일은 거부됩니다**.

## 한도

**파일 크기 · 텍스트 길이 한도**는 프로젝트 설정값을 따르며, 강제는 **Guardian 단일 지점**입니다 — 최상위 파일뿐 아니라 파일에서 추출된 텍스트, 아카이브 내부까지 같은 한도로 검사됩니다. 한도를 초과하면 작업이 `FILE_TOO_LARGE` / `TEXT_TOO_LONG`으로 실패 확정됩니다([배치 오류](/ko/v1.4/api/batch/errors) 참고).

버킷 참조 입력이라 요청 본문에 파일이 없으므로, 인라인 API에 적용되는 입력 수신 상한의 대상이 아닙니다 — 크기 통제는 검사 한도 하나로 일원화됩니다.

## 처리 순서

배치 작업은 **접수 순서대로** 처리됩니다(선입선출). 별도의 우선순위 계층은 없으며, 동시 실행 규모 · 대기열 상한은 운영 값입니다.

## 데이터 보존

* **콘텐츠 무보존** — 원본과 산출물 본문은 처리 중에만 다루며 작업 기록에 남기지 않습니다. 작업 기록은 경로 · 판정 · 탐지 결과 · 오류의 **메타데이터만** 담습니다.
* **작업 기록은 단기** — 작업 조회 API의 백엔드인 작업 기록은 운영 조회 · `src` 검색 복구용 단기 기록으로, 보존 · 정리 주기는 운영 정책을 따릅니다.
* **장기 이력은 Opticon** — 배치 처리도 [Opticon 트레이스](/ko/v1.4/admin/monitoring-opticon)로 기록되며, 접수 정보(`job_id` · `src_s3_url` · `tgt_s3_url` · `process_type`)와 판정 · 오류가 함께 담깁니다. 지난 작업을 확인해야 할 때의 확인 표면은 Opticon입니다.