문서함의 요약본이 원본의 어느 판에서 나왔는지 판단하는 관리자 페이지입니다.

• 묶음 기준: verdict
• 한 행: 사유 라벨 · result_id + 한 줄 요약(근거 수치 포함)
• 근거 표는 행을 펼쳤을 때 보입니다 (`field` / `value` / `agg` 열)

화면·코드·면접에서 이 단어를 그대로 씁니다. 키는 출력 스키마의 enum 과 같습니다.

• 자가채점 — 계보 판정 일치 · 정답 45건 기준 수치는 본인이 러너를 돌려 나온 값을 넣습니다. 예측 화면에는 비워 둡니다 — 출처를 댈 수 없는 숫자를 화면에 두지 않기 위해서입니다.
• 출력 스키마 검증 항목을 통과 여부와 함께 상시 노출
• 검증 노트 — 자동 / 수동 / 정직 경계선

• 목록 두 장을 올리기 전에는 샘플 데이터 보기로 화면을 확인합니다.
• 파일 이름에 판 표기가 하나도 없거나 올린 사람 칸이 비어도 목록은 살아 있고, 그 결과물이 왜 그 사유로 갔는지 계보의 판 순서를 펼쳐 보여줍니다.

{"type":"object","properties":{"result_id":{"type":["string","null"],"description":"판정 대상 결과물 번호입니다. 결과물이 없는 새 판을 알리는 카드에서는 null 입니다."},"doc_id":{"type":"string","description":"그 결과물이 가리키는 원본 번호이고, 결과물이 없는 새 판 카드에서는 계보에서 가장 늦게 올라온 원본 번호입니다."},"lineage_key":{"type":["string","null"],"description":"filename 에서 확장자와 판 표기를 떼고 공백과 구분 기호를 지운 뒤 소문자로 맞춘 계보 이름입니다. 떼는 판 표기는 판을 뜻하는 낱말(최종·진짜최종·사본이 그 예입니다), 이름 끝 괄호 안 숫자, 영문자 v 뒤에 숫자가 이어진 토막, 여덟 자리로 이어진 날짜 숫자 네 가지입니다. 네 자리 숫자는 이름의 일부로 두어 떼지 않습니다."},"lineage_version_count":{"type":["integer","null"],"description":"lineage_key 가 같은 documents 행의 수, 곧 그 계보에 쌓인 판의 수입니다."},"source_uploaded_at":{"type":["string","null"],"description":"결과물이 가리키는 원본의 uploaded_at 입니다."},"latest_doc_id":{"type":["string","null"],"description":"그 계보에서 uploaded_at 이 가장 늦은 원본의 doc_id 입니다."},"latest_uploaded_at":{"type":["string","null"],"description":"그 계보에서 가장 늦은 uploaded_at 입니다."},"verdict":{"type":"string","enum":["from_latest_source","from_outdated_source","source_deleted","latest_source_unprocessed","duplicate_results"]},"evidence":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"value":{"type":["string","number","boolean","null"]},"agg":{"type":"string","enum":["count","sum","avg","min","max"]}},"required":["field","value"]}},"summary":{"type":"string"}},"required":["result_id","doc_id","lineage_key","lineage_version_count","source_uploaded_at","latest_doc_id","latest_uploaded_at","verdict","evidence","summary"]}

[
  {
    "result_id": "SUM-4412",
    "doc_id": "DOC-9915",
    "lineage_key": "주간회의0817",
    "lineage_version_count": 3,
    "source_uploaded_at": "2026-08-19T14:40:00",
    "latest_doc_id": "DOC-9915",
    "latest_uploaded_at": "2026-08-19T14:40:00",
    "verdict": "from_latest_source",
    "evidence": [
      {
        "field": "result_id",
        "value": "SUM-4412"
      },
      {
        "field": "source_doc_id",
        "value": "DOC-9915"
      },
      {
        "field": "filename",
        "value": "주간회의_0817_진짜최종(2).docx"
      },
      {
        "field": "uploaded_at",
        "value": "2026-08-19T14:40:00"
      },
      {
        "field": "doc_id",
        "value": 3,
        "agg": "count"
      }
    ],
    "summary": "주간회의_0817 계보에는 원본이 세 판 있고 이 요약본은 그중 가장 늦게 올라온 진짜최종(2) 판에서 나왔습니다."
  },
  {
    "result_id": "SUM-4372",
    "doc_id": "DOC-9878",
    "lineage_key": "온보딩가이드",
    "lineage_version_count": 3,
    "source_uploaded_at": "2026-08-11T09:45:00",
    "latest_doc_id": "DOC-9878",
    "latest_uploaded_at": "2026-08-11T09:45:00",
    "verdict": "from_latest_source",
    "evidence": [
      {
        "field": "result_id",
        "value": "SUM-4372"
      },
      {
        "field": "source_doc_id",
        "value": "DOC-9878"
      },
      {
        "field": "filename",
        "value": "온보딩 가이드 v2 사본.docx"
      },
      {
        "field": "uploaded_at",
        "value": "2026-08-11T09:45:00"
      },
      {
        "field": "doc_id",
        "value": 3,
        "agg": "count"
      }
    ],
    "summary": "온보딩 가이드는 v1·v2·v2 사본이 한 계보로 묶이고, 이름만 보면 곁가지 같은 사본 판이 실제로는 가장 늦게 올라온 원본이라 이 요약본은 최신판에서 나온 것입니다."
  },
  {
    "result_id": "SUM-4389",
    "doc_id": "DOC-9880",
    "lineage_key": "계약검토초안",
    "lineage_version_count": 2,
    "source_uploaded_at": "2026-08-12T10:00:00",
    "latest_doc_id": "DOC-9893",
    "latest_uploaded_at": "2026-08-16T16:22:00",
    "verdict": "from_outdated_source",
    "evidence": [
      {
        "field": "result_id",
        "value": "SUM-4389"
      },
      {
        "field": "source_doc_id",
        "value": "DOC-9880"
      },
      {
        "field": "uploaded_at",
        "value": "2026-08-12T10:00:00"
      },
      {
        "field": "doc_id",
        "value": "DOC-9893"
      },
      {
        "field": "uploaded_at",
        "value": "2026-08-16T16:22:00"
      }
    ],
    "summary": "계약검토_초안 은 파일 이름 끝 날짜만 다른 두 판이 한 계보이고, 이 요약본이 나온 8월 12일 판 뒤에 8월 16일 판이 다시 올라왔습니다."
  },
  {
    "result_id": "SUM-4421",
    "doc_id": "DOC-9918",
    "lineage_key": "주간회의0824",
    "lineage_version_count": 2,
    "source_uploaded_at": "2026-08-24T09:30:00",
    "latest_doc_id": "DOC-9921",
    "latest_uploaded_at": "2026-08-25T10:15:00",
    "verdict": "from_outdated_source",
    "evidence": [
      {
        "field": "result_id",
        "value": "SUM-4421"
      },
      {
        "field": "source_doc_id",
        "value": "DOC-9918"
      },
      {
        "field": "filename",
        "value": "주간회의_0824.docx"
      },
      {
        "field": "uploaded_at",
        "value": "2026-08-24T09:30:00"
      },
      {
        "field": "doc_id",
        "value": "DOC-9921"
      },
      {
        "field": "uploaded_at",
        "value": "2026-08-25T10:15:00"
      }
    ],
    "summary": "주간회의_0824 는 이름 끝 네 자리가 회의 날짜라 주간회의_0817 과 다른 계보로 서고, 이 요약본은 그 계보의 첫 판에서 나와 다음 날 올라온 최종 판을 담지 못했습니다."
  },
  {
    "result_id": "TRN-4370",
    "doc_id": "DOC-9702",
    "lineage_key": null,
    "lineage_version_count": null,
    "source_uploaded_at": null,
    "latest_doc_id": null,
    "latest_uploaded_at": null,
    "verdict": "source_deleted",
    "evidence": [
      {
        "field": "result_id",
        "value": "TRN-4370"
      },
      {
        "field": "source_doc_id",
        "value": "DOC-9702"
      },
      {
        "field": "kind",
        "value": "번역본"
      },
      {
        "field": "target_lang",
        "value": "en"
      },
      {
        "field": "doc_id",
        "value": 0,
        "agg": "count"
      }
    ],
    "summary": "이 번역본이 가리키는 원본 DOC-9702 이 문서함에 남아 있지 않아 계보를 세울 수 없고 번역본만 문서함에 떠 있습니다."
  },
  {
    "result_id": null,
    "doc_id": "DOC-9921",
    "lineage_key": "주간회의0824",
    "lineage_version_count": 2,
    "source_uploaded_at": null,
    "latest_doc_id": "DOC-9921",
    "latest_uploaded_at": "2026-08-25T10:15:00",
    "verdict": "latest_source_unprocessed",
    "evidence": [
      {
        "field": "doc_id",
        "value": "DOC-9921"
      },
      {
        "field": "filename",
        "value": "주간회의_0824_최종.docx"
      },
      {
        "field": "uploaded_at",
        "value": "2026-08-25T10:15:00"
      },
      {
        "field": "doc_id",
        "value": 2,
        "agg": "count"
      },
      {
        "field": "result_id",
        "value": 0,
        "agg": "count"
      }
    ],
    "summary": "주간회의_0824 계보에서 가장 늦게 올라온 최종 판에는 요약본도 번역본도 없어 담당자가 보는 것은 아직 첫 판 요약뿐입니다."
  },
  {
    "result_id": "SUM-4396",
    "doc_id": "DOC-9887",
    "lineage_key": "제품기획서",
    "lineage_version_count": 1,
    "source_uploaded_at": "2026-08-14T13:05:00",
    "latest_doc_id": "DOC-9887",
    "latest_uploaded_at": "2026-08-14T13:05:00",
    "verdict": "duplicate_results",
    "evidence": [
      {
        "field": "result_id",
        "value": "SUM-4396"
      },
      {
        "field": "source_doc_id",
        "value": "DOC-9887"
      },
      {
        "field": "kind",
        "value": "요약본"
      },
      {
        "field": "created_at",
        "value": "2026-08-15T09:10:00"
      },
      {
        "field": "result_id",
        "value": 3,
        "agg": "count"
      }
    ],
    "summary": "제품기획서 원본 하나에 요약본이 세 건 만들어져 있어 담당자가 어느 것을 회의에 들고 갈지 골라야 합니다."
  }
]

[자동 검증 · 매 실행] 1. verdict 가 from_latest_source·from_outdated_source·source_deleted·latest_source_unprocessed·duplicate_results 다섯 값 안에 있는지 봅니다. 2. result_id·doc_id·lineage_key·lineage_version_count·source_uploaded_at·latest_doc_id·latest_uploaded_at·verdict·evidence·summary 가 모든 카드에 있는지 봅니다. 3. lineage_key 를 filename 에서 다시 계산해 값이 같은지 봅니다. 확장자를 뗀 뒤 판 표기를 패턴으로 지웁니다. 지우는 대상은 판을 뜻하는 낱말(최종·진짜최종·사본이 그 예입니다), 이름 끝 괄호 안 숫자, 영문자 v 뒤에 숫자가 이어진 토막(v1·v2·v10 이 모두 여기 걸립니다), 여덟 자리로 이어진 날짜 숫자 네 가지입니다. 괄호 안에 든 것은 예시이고 판정은 패턴이 정합니다. 네 자리 숫자는 회의 날짜처럼 이름의 일부라 지우지 않습니다. 남은 글자에서 공백과 구분 기호를 없애고 소문자로 맞춥니다. 4. lineage_version_count 를 lineage_key 가 같은 documents 행 수로, latest_uploaded_at 을 그 행들의 가장 늦은 uploaded_at 으로 다시 계산해 값이 같은지 봅니다. 5. 한 결과물이 여러 사유에 걸리면 source_deleted·duplicate_results·from_outdated_source 순으로 먼저 걸리는 값 하나만 답니다. 앞에서 걸린 결과물은 뒤 사유로 가지 않으므로, 옛 판에서 요약본이 두 번 만들어진 계보는 duplicate_results 로 가면서 from_outdated_source 집계에서 빠지고 화면 머리말의 옛 판 건수가 실제보다 적게 나옵니다. 그 계보의 가장 늦은 판에 결과물이 없으면 latest_source_unprocessed 카드가 따로 서서 사실이 화면에 남지만, 가장 늦은 판에 결과물이 있으면 옛 판이라는 사실은 중복 생성 무리 안에서만 보입니다. generated_docs.source_doc_id 와 같은 값이 documents.doc_id 에 한 행도 없으면 verdict 는 source_deleted 인지 봅니다. 6. source_doc_id 와 kind 가 같은 generated_docs 행이 둘 이상이면 그 행들의 verdict 는 duplicate_results 인지 봅니다. 7. source_uploaded_at 보다 늦은 uploaded_at 을 가진 원본이 같은 lineage_key 에 있으면 verdict 는 from_outdated_source 이고, 없으면 from_latest_source 인지 봅니다. 8. 계보에서 uploaded_at 이 가장 늦은 원본의 doc_id 를 source_doc_id 로 삼은 결과물이 한 건도 없으면 그 계보에 verdict 가 latest_source_unprocessed 인 카드가 한 장 서는지 봅니다. 다만 그 카드의 result_id 는 가리킬 결과물이 없어 null 입니다. 9. generated_docs.created_at 이 그 결과물이 가리키는 원본의 uploaded_at 보다 이른 행은 결과물이 원본보다 먼저 만들어졌다는 뜻이라 시각이 뒤집힌 데이터 오류로 보고 판정에서 뺍니다. 사유를 달지 않고 카드도 만들지 않으며, 몇 건을 뺐는지만 화면 아래 안내 줄에 건수로 남겨 담당자가 원본 시각을 확인하게 둡니다. 가리키는 원본이 문서함에 없는 결과물은 견줄 uploaded_at 이 없어 이 비교를 건너뛰고 source_deleted 로 갑니다. 10. evidence 의 field 가 documents·generated_docs 의 컬럼에 실재하는지 봅니다. 11. agg 가 없는 evidence 의 value 가 그 컬럼에 수록된 행의 원문 값과 같은지 봅니다. 여러 행에서 센 수치는 agg 에 count 를 적습니다. 12. summary 가 존댓말 한 문장으로 끝나는지 봅니다. [평가 러너 · 2주차] 문서 담당자 2명이 손으로 묶은 계보와 도구가 묶은 계보의 일치도(Cohen's κ: 우연히 맞은 몫을 뺀 일치 정도, 0~1)를 잽니다. [수동 검증 · 사람이 봅니다] 1. 판 표기처럼 보이는 낱말이 실제로는 문서 이름인 경우(사본 관리대장 같은 이름)를 표본 20건 눈으로 확인합니다. 2. 옛 판 요약본을 지울지 새 판으로 다시 만들지는 문서 담당자가 정합니다.