Pokemon Champions Assistant

포켓몬 챔피언스 실전용 정적 웹앱입니다. 파티 정리, 상대 엔트리 기록, 스피드 체크, 대미지 계산, 더블 플래너, 도감/검색을 한 화면에서 빠르게 다루는 데 초점을 맞췄습니다.

핵심 기능

싱글 배틀

• 내 파티 관리
• 상대 엔트리 기록
• 스피드 계산 / 추월컷 비교
• 간단 대미지 계산
• 상대 공개 기술 / 도구 / 특성 메모

더블 배틀

• 4칸 기준 행동 카드 정리
• 상대별 총 기대 대미지 요약
• 타깃 선택 / 광역기 감쇠 반영
• 속도 / 전장 상태 기반 플래너

도감 / 검색

• 포켓몬 검색
• 기술 검색
• 특성 검색
• 도구 검색
• 타입, 종족값, 설명, 상위 기술, 배울 수 있는 포켓몬 등 빠른 조회

샘플 / 보조 기능

• 단일 포켓몬 샘플 빌더
• 저장 / 불러오기
• 상태 JSON 내보내기 / 가져오기
• localStorage 기반 작업 상태 유지

기술 스택

• React 19
• TypeScript
• Vite
• Docker + nginx
• GitHub Pages

로컬 실행

npm ci
npm run dev

기본 개발 서버는 Vite 기본 포트를 사용합니다.

프로덕션 빌드

npm run build
npm run preview

Docker 실행

docker compose up --build -d

• 기본 포트: 3002
• 로컬 확인: http://127.0.0.1:3002

배포

이 프로젝트는 main 브랜치에 push하면 GitHub Pages로 자동 배포됩니다.

• Workflow: .github/workflows/deploy-pages.yml
• Base path: /Pokemon-Champions-Assistant/
• 배포 URL: https://w8385.dev/Pokemon-Champions-Assistant/

처음 한 번만 GitHub 저장소에서 아래 설정이 필요합니다.

1. Settings → Pages 이동
2. Source를 GitHub Actions로 설정

주요 npm 스크립트

npm run dev
npm run build
npm run preview
npm run typecheck
npm run build:champions-whitelist
npm run build:champions-learned-whitelist
npm run build:champions-move-meta
npm run build:champions-usage-top-moves
npm run build:champions-item-whitelist
npm run sync:item-sprites
npm run check:type-effectiveness
npm run check:damage-parity
npm run check:ability-damage
npm run check:ui-consistency

기술 메타 생성은 기본적으로 오프라인입니다. npm run build:champions-move-meta -- --offline --check는 산출물과 리포트의 바이트 일치를 확인하고 파일을 변경하지 않습니다. src/dexGameMoveIndex.json의 고정 ID/기본 타입 510개가 정규 기술의 기준이며, src/championsMoveMetaLegacyEvidence.json의 원본 731행은 그 밖의 역사적 필드와 source 밖 222개 원문 행을 보존합니다. src/championsLearnedMoveMeta.json은 재생성되는 732행(정규 510 + 역사적 이름 222)입니다. reports/championsMoveMetaLegacyReport.json은 이전 PokeAPI 이름 매칭 기록입니다. 과거 PokeAPI cache는 새 생성 시 네트워크 요청이나 기술 수록 판단에 쓰이지 않습니다. 미확인 분류/위력/명중/PP/우선도는 null이며, source에 없다고 현재 게임에서 불가함을 뜻하지 않습니다. 이 기준은 2026-09-09 고정 스냅샷이고 현재 게임·규정 동등성은 확인되지 않았습니다.

데이터 소스 / 운영 원칙

기본 데이터와 검증 소스는 다음 기준으로 운영합니다.

• 구조화 기본축: PokeAPI
• 사람이 읽는 검증/보강: PokemonDB, Serebii
• 경쟁 샘플 / 채용 기술 참고: Smogon Dex, Pikalytics

기술 풀 검색 기준

앱의 가용 기술 검색은 현재 아래 파일들을 중심으로 동작합니다.

• src/championsMovePools.json
• src/championsMovePoolSources.json
• reports/championsMoveWhitelistCoverage.json

화이트리스트 생성/갱신:

npm run build:champions-whitelist

프로젝트 구조

src/         앱 UI / 계산 로직 / 정적 데이터
public/      정적 에셋
scripts/     데이터 생성 / 검증 스크립트
reports/     검증 리포트 산출물
dist/        빌드 결과물

운영 메모

• 정적 산출물은 dist/에 생성됩니다.
• nginx SPA fallback 설정이 포함되어 있습니다.
• 상태는 브라우저 localStorage에 저장됩니다.
• 다른 기기로 상태를 옮길 때는 앱 상단의 내보내기 기능을 사용하면 됩니다.
• 일부 검증 리포트/로그 파일은 배포 커밋 대상에서 제외하고 별도로 관리합니다.