방법론

이 페이지는 BISPath가 BIS 가이드와 메타 장비 통계를 만드는 방법을 정직하게 설명합니다. 이 글의 목적은 어떤 데이터든 그대로 신뢰하기 전에 표본 방식과 한계를 먼저 이해할 수 있게 하는 것입니다.

1. 데이터 출처

BISPath는 두 곳에서 데이터를 가져옵니다. 게임 메타데이터(아이템 정보, 직업·특성 정의, 스탯 키, 아이템 세트 효과)는 Blizzard Entertainment의 공식 API를 통해 가져옵니다. 사용하는 namespace는 동적 데이터를 위한 profile-{region}, 정적 데이터를 위한 static-{region}이며, 캐릭터 동기화는 OAuth 로그인 토큰으로 본인 계정의 캐릭터에 한해 수행됩니다. 상위 플레이어 장비 통계는 WarcraftLogs의 GraphQL API를 통해 가져옵니다.

2. 표본 추출 방식

메타 장비 데이터는 현재 시즌의 레이드 보스 전체와 대표 쐐기던전 인카운터에 대해 WarcraftLogs 랭킹 첫 페이지를 호출해서 수집됩니다. WarcraftLogs는 페이지당 100개의 랭킹 항목을 반환하며, 같은 캐릭터가 여러 보스에서 등장하면 캐릭터 이름·서버·리전 조합을 키로 중복을 제거한 뒤 가장 높은 랭킹 항목 하나만 남깁니다. 그렇게 만들어진 dedup된 표본에서 각 캐릭터가 실제로 착용했던 장비, 인챈트, 보석 정보를 추출해 슬롯별로 분포를 집계합니다. 스탯 우선순위 분포는 별도 분석기가 동일한 표본의 서브셋에서 계산합니다. 현재 구현은 쐐기던전 표본이 단일 인카운터 기준이라는 점을 명확히 밝혀 둡니다 — 확장은 로드맵에 있습니다.

3. 수집 주기

데이터 수집은 GitHub Actions의 cron 워크플로로 매일 한국 시간 00:03(UTC 15:03 전날)에 자동 실행됩니다. 한 번의 실행에서 레이드 데이터, 쐐기던전 데이터, 그리고 스탯 우선순위 분포가 모두 갱신되며, 각 스펙별로 새 표본 크기와 마지막 수집 시간이 저장됩니다. 시간이 갈수록 새 로그가 더 많이 쌓이면서 표본이 안정화되지만, 패치 직후에는 표본이 작을 수 있으니 주의가 필요합니다.

4. 편집 워크플로우

BIS 가이드의 해설 부분은 자동 생성이 아니라 사람이 작성합니다. 작성 절차는 (1) 자동화된 팩트 시트로 BIS 아이템 목록, 장신구 티어, 스탯 분포, 수집 표본 크기를 추출하고, (2) 편집자가 그 시트와 본인의 게임 지식을 결합해 각 스펙의 장비 철학, 스탯 우선순위 이유, 예외 상황, FAQ를 작성하고, (3) 검토 후 lastReviewed 날짜와 함께 커밋합니다. 편집자가 작성하지 않은 스펙은 데이터 표만 보여주고 검색 엔진 색인에서 제외됩니다.

5. 알려진 한계

이 방식의 한계는 명확합니다. 첫째, WarcraftLogs 랭킹 상위 표본은 이미 장비가 충분히 갖춰진 상위 플레이어에 편향되어 있으므로, 초보자나 중급자의 최적 선택과는 다를 수 있습니다. 둘째, 특정 보스나 컨텐츠 타입(레이드 vs 쐐기)에서 강한 장비가 다른 곳에서는 약할 수 있고, 표본에는 그 차이가 잘 드러나지 않습니다. 셋째, 새 패치나 핫픽스 직후에는 충분한 새 로그가 쌓이기 전까지 표본이 옛 메타를 반영합니다. 넷째, 수집은 한국 리전을 기본으로 하며, 글로벌 평균이 아닙니다.

6. 변경과 정정

방법론이나 수집 코드가 바뀌면 이 페이지를 먼저 갱신합니다. 사실 오류가 발견되면 가능한 빠르게 정정하고, 각 데이터 레코드의 마지막 갱신 시각(updatedAt)을 통해 최신 상태를 확인할 수 있습니다. 데이터 오류 신고나 방법론 개선 제안은 bispath.gg@gmail.com으로 받습니다.