FDE를 위해 문서가 바뀐 뒤 색인이 따라갔는지 판단해주는 CLI입니다.

{"type":"object","properties":{"chunk_no":{"type":"string"},"verdict":{"type":"string","enum":["fresh","stale_by_time","fingerprint_mismatch","source_doc_removed","doc_inactive","fingerprint_missing","source_unmapped","duplicate_doc"]},"doc_updated_at":{"type":["string","null"]},"indexed_at":{"type":["string","null"]},"evidence":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"agg":{"type":["string","null"]},"value":{},"quote":{"type":["string","null"]}},"required":["field","value"]}},"next_action":{"type":"string"}},"required":["chunk_no","verdict","doc_updated_at","indexed_at","evidence","next_action"]}

[
  {
    "chunk_no": "CH-001",
    "verdict": "fresh",
    "doc_updated_at": "2026-08-18T10:00",
    "indexed_at": "2026-08-18T12:00",
    "evidence": [
      {
        "field": "updated_at",
        "value": "2026-08-18T10:00"
      },
      {
        "field": "indexed_at",
        "value": "2026-08-18T12:00"
      },
      {
        "field": "body_fingerprint",
        "value": "fp-a1"
      },
      {
        "field": "indexed_fingerprint",
        "value": "fp-a1"
      }
    ],
    "next_action": "색인이 원본을 따라갑니다. 그대로 둡니다."
  },
  {
    "chunk_no": "CH-003",
    "verdict": "fresh",
    "doc_updated_at": "2026-08-15T14:00",
    "indexed_at": "2026-08-16T09:00",
    "evidence": [
      {
        "field": "updated_at",
        "value": "2026-08-15T14:00"
      },
      {
        "field": "indexed_at",
        "value": "2026-08-16T09:00"
      },
      {
        "field": "indexed_fingerprint",
        "value": "fp-c3"
      }
    ],
    "next_action": "색인이 원본을 따라갑니다. 그대로 둡니다."
  },
  {
    "chunk_no": "CH-002",
    "verdict": "stale_by_time",
    "doc_updated_at": "2026-07-02T09:00",
    "indexed_at": "2026-06-30T09:00",
    "evidence": [
      {
        "field": "updated_at",
        "value": "2026-07-02T09:00"
      },
      {
        "field": "indexed_at",
        "value": "2026-06-30T09:00"
      },
      {
        "field": "cited_count",
        "value": 340
      }
    ],
    "next_action": "문서가 색인 뒤에 바뀌었고 인용도 많습니다. 재색인 목록 맨 위에 둡니다."
  },
  {
    "chunk_no": "CH-005",
    "verdict": "fingerprint_mismatch",
    "doc_updated_at": "2026-08-19T08:00",
    "indexed_at": "2026-08-12T09:00",
    "evidence": [
      {
        "field": "body_fingerprint",
        "value": "fp-e5"
      },
      {
        "field": "indexed_fingerprint",
        "value": "fp-e4"
      }
    ],
    "next_action": "본문 지문이 다릅니다. 내용이 바뀐 것이므로 다시 색인합니다."
  },
  {
    "chunk_no": "CH-012",
    "verdict": "source_doc_removed",
    "doc_updated_at": null,
    "indexed_at": "2026-05-20T09:00",
    "evidence": [
      {
        "field": "doc_no",
        "value": "DC-999"
      },
      {
        "field": "cited_count",
        "value": 5
      }
    ],
    "next_action": "원본 문서가 목록에 없습니다. 색인에서 내려 옛 내용이 답에 섞이지 않게 합니다."
  },
  {
    "chunk_no": "CH-006",
    "verdict": "doc_inactive",
    "doc_updated_at": "2026-05-01T10:00",
    "indexed_at": "2026-05-02T09:00",
    "evidence": [
      {
        "field": "is_active",
        "value": false
      },
      {
        "field": "doc_title",
        "value": "폐지된 쿠폰 정책"
      }
    ],
    "next_action": "폐지된 문서가 색인에 남아 있습니다. 색인에서 내립니다."
  },
  {
    "chunk_no": "CH-007",
    "verdict": "fingerprint_missing",
    "doc_updated_at": "2026-04-20T09:00",
    "indexed_at": "2026-04-21T09:00",
    "evidence": [
      {
        "field": "body_fingerprint",
        "value": null
      },
      {
        "field": "indexed_fingerprint",
        "value": "fp-x9"
      }
    ],
    "next_action": "원본 지문이 비어 있어 내용 대조를 못 했습니다. 최신으로 세지 않고 지문을 다시 계산합니다."
  },
  {
    "chunk_no": "CH-002",
    "verdict": "duplicate_doc",
    "doc_updated_at": "2026-07-02T09:00",
    "indexed_at": "2026-06-30T09:00",
    "evidence": [
      {
        "field": "doc_no",
        "agg": "count",
        "value": 2
      }
    ],
    "next_action": "같은 문서 번호가 목록에 두 번 있습니다. 앞 건으로만 판정하고 뒤 건을 목록에서 뺍니다."
  }
]

[자동 검증 · 1주차] 1. verdict가 enum 여덟 값 안에 있는지 확인합니다. 2. chunk_no·verdict·doc_updated_at·indexed_at·evidence·next_action이 모두 있는지 확인합니다. 3. cited_count가 0 이상인지 확인합니다. 4. body_fingerprint가 null이면 verdict가 fingerprint_missing인지 확인합니다. 5. evidence의 field가 두 입력 표의 컬럼에 실재하는지 확인합니다. 6. evidence의 quote가 그 행 source_raw의 일부인지 확인합니다. 7. next_action이 존댓말로 끝나는지 확인합니다. [판정 규칙] 1. 원천 표기은 대소문자와 띄어쓰기, 구분자를 없애 소문자로 모은 뒤 connected_sources의 source_id와 맞춥니다. 맞는 것이 없으면 미매핑으로 남기고 그 행은 나머지 판정에서 뺍니다. 2. 같은 행 번호가 두 번 들어오면 앞 건만 남기고 뒤 건은 적재 단계에서 사유와 함께 뺍니다. [수동 검증] 1. 지문만 바뀐 문서가 실제로 내용이 바뀐 것인지 서식만 손본 것인지 담당자가 열어 확인합니다. 2. DC-002·DC-003처럼 원천 표기가 흔들렸지만 사전으로 맞춰진 문서는 미매핑 사유를 달지 않는 것이 맞는지 확인합니다. [평가 러너 · 2주차] 1. 인용 횟수를 붙여 재색인 순서를 매겼을 때 자주 쓰이는 뒤처진 청크가 위로 오는지 셉니다. 2. 목록과 정답을 작성자가 만든 합성 기준이라 이 수치는 성능 측정이 아니라 데모 조건 동작입니다.