선하증권 추출본에서 표기가 갈린 바이어 이름을 규칙이 후보 묶음으로 모아 두면, 해외영업 담당자가 묶음마다 합칠지 떼어 놓을지 화면에서 하나씩 확정해야 거래량이 회사 단위로 다시 합산되고 연락할 바이어 목록 내보내기가 열리는 웹 화면입니다.

{"type":"object","properties":{"export_id":{"type":"string"},"source_file":{"type":"string"},"confirmed_at":{"type":"string"},"buyers":{"type":"array","items":{"type":"object","properties":{"buyer_id":{"type":"string"},"canonical_name":{"type":"string"},"merged_record_ids":{"type":"array","items":{"type":"string"},"minimum":1},"shipment_count":{"type":"integer"},"total_weight_kg":{"type":"number"},"last_arrival_month":{"type":"string"},"rank":{"type":"integer"},"confirmed_by":{"type":"string"},"evidence_quotes":{"type":"array","items":{"type":"string"},"minimum":1}},"required":["buyer_id","canonical_name","merged_record_ids","shipment_count","total_weight_kg","last_arrival_month","rank","confirmed_by","evidence_quotes"]},"minimum":1},"unresolved_group_count":{"const":0},"split_decisions":{"type":"array","items":{"type":"object","properties":{"group_id":{"type":"string"},"kept_apart_record_ids":{"type":"array","items":{"type":"string"}},"reason":{"type":"string"}},"required":["group_id","kept_apart_record_ids","reason"]}},"excluded_buyer_ids":{"type":"array","items":{"type":"string"}},"hedge":{"type":"string"}},"required":["export_id","source_file","confirmed_at","buyers","unresolved_group_count","split_decisions","excluded_buyer_ids","hedge"]}

[
  {
    "export_id": "EXP-2026-06-01",
    "source_file": "waybeez_bol_2026H1.csv",
    "confirmed_at": "2026-06-14",
    "buyers": [
      {
        "buyer_id": "by_abc",
        "canonical_name": "ABC COSMETICS INC",
        "merged_record_ids": [
          "BOL0001",
          "BOL0002",
          "BOL0003"
        ],
        "shipment_count": 3,
        "total_weight_kg": 2530.5,
        "last_arrival_month": "2026-05",
        "rank": 1,
        "confirmed_by": "sales_kim",
        "evidence_quotes": [
          "ABC COSMETICS INC",
          "ABC COSMETICS, INC.",
          "ABC COSM INC"
        ]
      },
      {
        "buyer_id": "by_abclabs",
        "canonical_name": "ABC COSMETIC LABS LLC",
        "merged_record_ids": [
          "BOL0004"
        ],
        "shipment_count": 1,
        "total_weight_kg": 2200,
        "last_arrival_month": "2026-02",
        "rank": 2,
        "confirmed_by": "sales_kim",
        "evidence_quotes": [
          "ABC COSMETIC LABS LLC"
        ]
      },
      {
        "buyer_id": "by_miami",
        "canonical_name": "MIAMI SKIN TRADING CO",
        "merged_record_ids": [
          "BOL0010",
          "BOL0011"
        ],
        "shipment_count": 2,
        "total_weight_kg": 1890,
        "last_arrival_month": "2026-06",
        "rank": 3,
        "confirmed_by": "sales_kim",
        "evidence_quotes": [
          "MIAMI SKIN TRADING",
          "MIAMI SKIN TRADING CO"
        ]
      }
    ],
    "unresolved_group_count": 0,
    "split_decisions": [
      {
        "group_id": "G_ABC",
        "kept_apart_record_ids": [
          "BOL0004"
        ],
        "reason": "상호는 비슷하지만 주소와 입항지가 달라 떼어 놓았습니다"
      }
    ],
    "excluded_buyer_ids": [
      "by_sunset"
    ],
    "hedge": "이 목록은 작성자가 만든 더미 추출본을 담당자 페르소나가 확정한 합성 결과이며, 실제 선하증권 데이터의 표기 분포와는 다를 수 있습니다."
  },
  {
    "export_id": "EXP-2026-06-02",
    "source_file": "waybeez_bol_west_2026Q2.csv",
    "confirmed_at": "2026-06-20",
    "buyers": [
      {
        "buyer_id": "by_glow",
        "canonical_name": "GLOW HOUSE DISTRIBUTION LLC",
        "merged_record_ids": [
          "BOL0005",
          "BOL0006"
        ],
        "shipment_count": 2,
        "total_weight_kg": 1450,
        "last_arrival_month": "2026-03",
        "rank": 1,
        "confirmed_by": "sales_park",
        "evidence_quotes": [
          "GLOW HOUSE DISTRIBUTION",
          "GLOWHOUSE DISTRIBUTION LLC"
        ]
      },
      {
        "buyer_id": "by_pacific",
        "canonical_name": "PACIFIC BEAUTY SUPPLY CORP",
        "merged_record_ids": [
          "BOL0007",
          "BOL0008"
        ],
        "shipment_count": 2,
        "total_weight_kg": 1360,
        "last_arrival_month": "2026-05",
        "rank": 2,
        "confirmed_by": "sales_park",
        "evidence_quotes": [
          "PACIFIC BEAUTY SUPPLY CORP",
          "PACIFIC BEUATY SUPPLY CORP"
        ]
      }
    ],
    "unresolved_group_count": 0,
    "split_decisions": [
      {
        "group_id": "G_PLACEHOLDER",
        "kept_apart_record_ids": [
          "BOL0009"
        ],
        "reason": "수하인 상호가 플레이스홀더라 어느 회사에도 붙이지 않았습니다"
      }
    ],
    "excluded_buyer_ids": [],
    "hedge": "총 물량 합계는 weight_kg 가 비어 있던 행을 0 으로 두고 계산한 값이라 실제 물량과 차이가 있으며, 합성 더미 기준의 숫자입니다."
  }
]

[자동 검증 · 스크립트가 전수 수행] 1. 출력이 Zod 스키마를 통과하는지 확인합니다(형식이 깨진 목록이 밖으로 나가는 것을 차단). 2. unresolved_group_count 가 0 인지 확인하고, 화면의 미결 개수와 서버가 다시 센 미결 개수가 같은지 대조합니다. 3. 모든 merged_record_ids 가 bol_records 에 실재하고 회사끼리 겹치지 않는지 확인합니다. 한 행이 두 회사에 동시에 묶이면 거절합니다. 4. shipment_count 가 merged_record_ids 개수와 같고, total_weight_kg 가 그 행들의 weight_kg 합과 같으며(null 은 0 으로 처리), last_arrival_month 가 그중 최댓값인지 확인합니다. 같은 확정 조합에는 항상 같은 값이 나오므로 집계를 그대로 재현합니다. 5. rank 가 total_weight_kg 내림차순과 일치하고 1부터 빈틈없이 증가하는지 확인합니다. 6. 모든 evidence_quotes 가 묶인 원본 행 consignee_raw 의 실제 값인지 확인합니다(지어낸 상호 차단). 7. split_decisions 의 kept_apart_record_ids 가 규칙이 같은 묶음으로 올렸던 행인지 대조합니다. 애초에 같은 묶음이 아니었던 행이 떼기 기록에 있으면 거절합니다. 8. excluded_buyer_ids 가 buyer_directory 에서 status 가 do_not_contact 이거나 merged_away 인 회사만 담고 있는지 확인합니다. 9. 미결 묶음이 남은 상태의 내보내기 요청을 서버가 거절하고, 화면의 잠금 상태와 서버 판정이 같은지 확인합니다. [수동 검증 · 사람이 표본 확인] 1. 담당자가 떼어 놓은 묶음의 사유가 주소와 입항지 근거와 어긋나지 않는지 목록 30건을 표본 검토합니다. 2. 보류로 남긴 계열사 묶음이 실제로 사람 확인이 필요한 경우인지 확인합니다.