다음 세션 인계

마지막 작업: 검색·아이템 목록 경량화·시뮬레이터 효과 참고 패널·misc 분류를 추가했다. 2026-08-27에 두 위키도 다시 받았지만 원본은 이전 스냅샷과 완전히 같아 아직 시즌을 반영하지 않았다.

지금 상태

• 작업 브랜치: feat/search-simulator-data
• 사이트 1,437페이지 · 테스트 43개 · 데이터셋 64종 63,424항목
• 이미지 1,343개 (아이템 903 · 스킬 257 · 렐릭 126 · 클래스 22 · 글리프 23 · 보스 12)
• 클라이언트 스냅샷: 번역 CSV 19,334키 · 자원 47,370개(2026-08-25 설치본)
• Pagefind 색인 1,428페이지 · /items HTML 370,226B → 10,610B

바로 이어서 할 일

1. 두 위키 시즌 반영 재확인

현재 생성 데이터는 새 클라이언트와 2026-08-27에 확인한 두 위키 원본을 합친 상태다. wiki.gg Cargo 10종·본문 1,153개와 Fandom 본문 1,574개가 이전 원본과 바이트 단위로 같았다. 나중에 시즌이 반영되면 API 수집기 세 개를 다시 돌린다. 아이템 스탯은 wiki.gg가 정본이므로 반영 전까지 낡은 값일 수 있다.

2. 게임에서 재야 하는 값

docs/verification-checklist.md 순서대로. 1순위는 클래스 기본 생명력·마나 — 새 캐릭터 스탯 창만 보면 되고, 채우면 시뮬레이터가 절대 수치를 낸다. 값은 src/data/measured.json 에 넣으면 바로 반영되고 tests/data.test.ts 가 추출값과 어긋나는지 검사한다.

3. 배포

미설정. 배포 전에 public/img/ 를 어떻게 할지 정해야 한다 — 게임 에셋이라 프라이빗에서 보는 것과 공개 배포는 다르다. docs/whats-left.md 참고.

이번에 끝낸 것

• Pagefind 검색과 한국어 용어 별칭. res_* 원시 자원 색인은 검색에서 제외했다.
• 아이콘 재수집. wiki.gg 원본이 없는 36개를 제외하면 수집 가능한 범위는 끝났다.
• /items 필터 데이터를 별도 JSON으로 분리해 초기 HTML을 약 97% 줄였다.
• 선택한 빌드의 오그먼트·서브탤런트와 글리프·에테르 설명을 참고 패널로 표시했다. 근거 없는 수치 계산은 하지 않는다.
• 모든 misc_* 잔여 키에 안정적인 접두사 그룹을 붙였다.

알아두면 걸리지 않는 것들

• 미리보기는 docker compose up preview 로 띄운다. 맨 nginx 로 띄우면 absolute_redirect 가 Location 에서 포트를 빼먹어 하위 페이지가 전부 안 열린다. docker/nginx.conf 에 absolute_redirect off 가 들어 있다.
• node 는 로컬에 없다. 전부 Docker 로 돌린다(docker compose 또는 docker run node:22-alpine).
• src/data/ 는 생성물. 손으로 고칠 파일은 rules.json 과 measured.json 둘뿐이다.
• 출처 우선순위: 속성 계수·규칙 수치는 게임 클라이언트 → 없으면 wiki.gg Mechanics. 아이템 스탯은 wiki.gg. 설명 문장·한국어 명칭은 게임 파일. 나머지는 Fandom.
• 게임 파일·바이너리 추출물(data/raw/gamefiles, data/raw/binary)은 .gitignore 다. 스크립트만 커밋하고 각자 자기 사본에서 뽑는다.

데이터 다시 만들기

python3 scripts/gamefiles_extract.py      # 게임 번역 CSV
python3 scripts/gamefiles_resources.py    # 데이터 파일 자원 이름
python3 scripts/wikigg_fetch.py           # wiki.gg Cargo
python3 scripts/wikigg_pages_fetch.py     # wiki.gg 본문
python3 scripts/fandom_fetch.py           # Fandom 본문
python3 scripts/build_data.py             # → src/data/*.json
python3 scripts/check_translations.py     # 번역 품질 검사