화면

어두운 테마(theme.MODE 로 밝은 테마도 고를 수 있다). 닉네임을 검색하면 왼쪽 메뉴 + 대시보드로 넘어가고, 메뉴(경기·흐름·경기력·선수·팀컬러·랭커) 에서 상세 화면으로 들어간다. 한 메뉴 안의 구획은 제목 옆 탭으로 나뉜다(위 표의 [ ] — 2.1.1). 메뉴마다 마지막에 본 탭을 기억한다. 시즌·표시 범위·새 경기 확인은 위쪽 바에 고정이라 어느 화면에서든 같다.

스크린샷은 실데이터로 찍되 닉네임은 메모리에서만 익명화했다(내 구단주 · 상대1…). 랭커 카드(순위·구단가치)는 공개 랭킹에서 계정을 역추적할 수 있어 비웠다. 찍기 전 화면 글자 전부를 실제 닉네임 6,561개와 대조해 0건을 확인했다.

대시보드 — 지표 4개 · 랭커 카드 · 승률 흐름 · 나 vs 상대 레이더 · 승부처 · 15분 득실 · 흐름 분석 · 시간대 · 자주 만난 상대

받아서 쓰기 (exe)

파이썬 없이 쓰는 방법이다. 바뀐 점은 CHANGELOG.md.

1. 릴리스 페이지에서 FifaMatchTracker-Setup-<버전>.exe 를 받아 실행한다. 관리자 권한은 필요 없다(사용자 폴더 %LOCALAPPDATA%\Programs\피파전적관리 에 깔린다). 시작 메뉴에 생기고, 바탕화면 아이콘은 설치할 때 고른다. 지우는 건 윈도우 "설정 → 앱"에서.
   • 설치 없이 쓰려면 FifaMatchTracker-<버전>-portable.zip 을 폴더째 풀고 피파전적관리.exe 실행 (_internal 이 옆에 있어야 켜진다).
2. "Windows의 PC 보호" 파란 창이 뜨면 추가 정보 → 실행. 서명 인증서가 없는 프로그램이라 처음 한 번 뜬다(설치 파일도 같다).
3. 처음 켜면 이용 안내 창이 뜬다 — 읽고 동의해야 시작된다. 넥슨 홈페이지 데이터(랭킹·구단가치· 팀컬러·시즌 구분·선수 능력치)를 읽을지도 여기서 고른다(기본 꺼짐, 이용 안내 참고). 이어서 API 키 입력 창이 뜬다. NEXON Open API 에 로그인 → 애플리케이션을 서비스 단계로 등록 → 발급된 키를 붙여넣는다(무료). 개발 단계 키는 하루 1,000건이라, 처음 검색할 때 받는 약 한 달 치(많으면 3천 경기 넘게)를 끝내지 못한다 — 그러면 앱이 멈추고 키를 바꾸라고 안내한다.
4. 구단주 닉네임을 검색한다.

• 데이터(키·전적 DB·캐시·오류 기록)는 %LOCALAPPDATA%\피파전적관리\ 에 쌓인다. 새 버전으로 바꿔도 그대로 남고, 지우려면 이 폴더를 지운다.
• 오류가 나면 %LOCALAPPDATA%\피파전적관리\logs\crash.log 를 보내 주면 된다.
• 넥슨 홈페이지 데이터 읽기는 창 아래 [정보 · 이용 안내] 에서 켜고 끈다(다음 조회부터 반영).
• 랭킹 수집(1.1.1, 기본 꺼짐)도 같은 창에서 켠다 — 앱이 켜져 있는 동안 하루 한 번, 정각 뒤 5~50분 사이에 랭킹 1만 명을 읽어 rank.db 에 쌓는다(원본 14일 · 집계는 계속). 홈페이지 데이터를 끄면 같이 꺼지고, 넥슨이 요청을 계속 막으면 스스로 꺼진다. 하루 안의 기록이 있으면 팀컬러도 거기서 읽어 넥슨 요청이 0이다. 넥슨 데이터 기준 시각(쪽마다 붙는 "※ … 기준")이 지난 수집과 같으면(점검 등) 1쪽만 보고 다음 시각에 다시 — [정보] 에 "멈춰 있습니다"로 보인다. 2.3.1 부터 상위 20 표시 연속·시즌 최고점·첫 챔피언스 판수(2.12.1 부터 시즌 FC 범위 · 2.12.2 부터 챔피언스 이상 판수 범위도 — 안내 13 동의 뒤)를 재려고 다른 구단주의 프로필 번호(닉네임 없이)를 그 시즌 동안 두고, 시즌이 끝나면 숫자만 남긴다. 수집을 끄면 바로 지운다. 검색한 구단주의 ELO·순위는 수집과 상관없이 검색할 때마다 기록한다. [정보 › 저장 공간] 의 랭킹 수집 기록 [지우기] 로 둘 다 지운다 (2.13.1 에서 [정보] 아래 버튼을 옮김).
• 구단주 분포 받기(2.10.1 예정, 기본 꺼짐 · 이용 안내 10) — 랭킹 수집 아래 체크. 켜면 14일에 한 번 랭킹 1~3,000위 구단주 150명의 최근 감독모드 1,000판을 내 API 키로 받아(한 바퀴 약 15만 요청 — 서비스 단계 키 필요) 이름 없는 구단주별 요약만 fifa.db 에 둔다. 창을 닫아도(트레이) 10분마다 차례를 보고 이어 받으며, 검색과 엮이지 않고 따로 돈다. 끄면 받던 바퀴를 버리고 받아 둔 분포는 남긴다 · 랭킹 수집·홈페이지 데이터를 끄거나 랭킹 수집 기록을 지우면 분포까지 지운다. 켠 뒤 시작한 바퀴가 5,000건 안에 호출 한도(429)를 받으면 개발 키로 보고, 바퀴가 3번 이어서 못 끝나면, 키를 바꾸면 스스로 꺼진다 (.env FIFA_OWNER_DIST=켠 시각 · FIFA_OWNER_DIST_OFF=꺼진 사유). 다 받은 분포가 있고 켜져 있으면 흐름 분석 맨 위 결정력·태클 성공 칩과 "마무리" 문장이 같은 경기 상대 대신 1~3,000위 구단주 분포 속 내 위치(내 감독모드 최근 1,000판 · 하위/상위 10% 이고 구간 안쪽 끝도 중앙을 안 넘을 때만 — 경향)로 판정한다. 칩에 마우스를 올리면 인원·내 판수·분포 기준일. 감독모드 1,000판이 안 되거나 다른 매치 종류를 보면 예전 판정 그대로. 유효슛 비율 칩은 늘 같은 경기 상대 대비.
• 트레이 상주(1.1.1) — 랭킹 수집이 켜져 있거나 자동 실행을 켜 두면 창을 닫아도(X) 작업 표시줄 오른쪽 트레이에 남는다. 완전히 끄려면 트레이 아이콘 오른쪽 클릭 → [종료]. 둘 다 꺼져 있으면 X 가 그대로 끈다. 숨긴 지 30분이 지나면 경기 기록을 메모리에서 내려놓고, 다시 열 때 저장된 기록을 다시 읽는다. 앱은 한 번만 뜬다 — 이미 떠 있는데 또 켜면 떠 있던 창이 앞으로 온다.
• 자동 실행(기본 꺼짐) — [정보] 에서 켜면 윈도우를 켤 때 창 없이 트레이로 시작한다(--tray, 시작 프로그램 등록). 설치판·포터블 exe 에서만 켤 수 있다. ⚠ 1.0.x 로 되돌리기 전에 끄세요 — 옛 버전은 --tray 를 몰라 부팅마다 창이 뜬다. 설치판을 제거하면 등록도 지운다.
• 트레이에 있는 동안 윈도우 알림은 띄우지 않는다 — 새 버전·수집 상태는 창을 열면 보이고, 숨긴 중 오류는 창을 열 때 안내한다.
• 저장 공간(2.13.1) — [정보 › 저장 공간] 에서 종류별 크기를 보고 지운다: 랭킹 수집 기록(수집이 꺼진다) · 카드 정보 · 그림 캐시 · 경기 상세 캐시(아직 기록에 못 넣은 경기 수를 확인창에) · 구단주 분포·랭커 픽 · 내 기록 전부(두 번 확인 — 경기 기록·검색 칩·팀컬러· ELO·거래·예측·캐시·rank.db 까지. 넥슨은 약 한 달치만 다시 주므로 그보다 옛 경기는 영영 사라진다). 지우는 동안 그 저장소에 쓰는 작업은 멈춘 뒤 새로 뜨지 않고, 창을 닫아도 이어서 지운다. 내 기록 전부는 남길 행(하루 요청 계수·시즌표·팀컬러 효과표·키 지문)만 새 파일로 옮겨 fifa.db 를 바꿔 끼운다 — 파일이 바로 줄고 옛 바이트가 안 남는다. 다른 실행본이 파일을 잡고 있으면 아무것도 안 지우고 "다시" 를 알린다. API 키(.env)·crash.log·창 설정은 지우지 않는다.
• 업데이트: 켤 때 GitHub 에서 새 버전을 한 번 확인해, 창 오른쪽 아래 카드에 결과를 띄운다 — 새 버전이면 [업데이트], 최신이면 "최신 버전입니다"(첫 검색 화면에서만 — 메인 화면은 가리지 않는다. 둘 다 닫을 때까지 남고, 확인을 못 했으면 안 뜬다). 창 왼쪽 아래(메인 화면은 사이드바 맨 아래)에는 버전과 상태가 늘 보인다 — "v1.0.2 · 최신 버전입니다" · "새 버전 vX [업데이트]" · 확인을 못 했으면 "업데이트 확인 못 함"(최신이라고 하지 않는다). 설치 파일로 깐 경우 [업데이트] 를 누르면 내려받아 체크섬을 확인하고, 앱이 닫혔다가 새 버전으로 다시 켜진다(전적 기록은 그대로). 포터블(zip)은 받기 페이지가 열린다. 확인을 끄려면 .env 에 FIFA_UPDATE_CHECK=0.

빌드·배포

python tools/release.py     # 빌드 → zip · 설치 파일 → 개인정보 검사 → 공개 명령 출력

1. config.APP_VERSION 을 올리고 CHANGELOG.md 에 그 버전 절을 쓴 뒤 커밋한다(안 하면 멈춘다).
2. tools/release.py 가 dist\ 에 FifaMatchTracker-Setup-vX.Y.Z.exe · FifaMatchTracker-vX.Y.Z-portable.zip · SHA256SUMS.txt 를 만들고, 배포물 안(exe 안의 압축된 코드까지)에서 이 PC 의 홈 폴더 경로 · 프로젝트 경로 · API 키 · git 이메일을 찾는다. 반드시 있어야 할 대조 문자열이 안 잡히면 "0건"을 믿지 않고 멈춘다. 더 찾을 말은 RELEASE_SCAN_EXTRA="a,b".
3. 마지막에 출력되는 gh release create … 를 확인하고 직접 친다 — 공개는 스크립트가 하지 않는다.

설치 파일은 Inno Setup 6(무료)이 필요하다 — 스크립트는 installer/피파전적관리.iss. 앱의 새 버전 알림은 릴리스 태그(vX.Y.Z)를 읽는다.

시작하기 (소스)

git clone https://github.com/yim2412/fifa-match-tracker.git
cd fifa-match-tracker

# 1) 패키지 설치
pip install -r requirements.txt

# 2) API 키 — 앱을 처음 켜면 입력 창이 뜬다(아래 4번). 터미널 점검(3번)을 먼저
#    하려면 .env.example 을 복사해 .env 로 만들고 키를 넣는다
copy .env.example .env
notepad .env

# 3) API 연결 점검 (GUI 전에 먼저, 선택)
python check_api.py 내닉네임

# 4) 앱 실행
python app_main.py

# 5) 파싱·집계 회귀 테스트 (네트워크 없이, 실제 응답 픽스처로)
python tests/test_parsing.py
python tests/test_ui_smoke.py   # 화면 배선(offscreen)
python tests/test_rankcollect.py   # 랭킹 수집기
python tests/test_tray.py   # 트레이 상주·자동 실행·한 번만 실행
python tests/test_ownerdist.py   # 구단주 분포 받기·판정(가짜 API)
python tests/test_ownerdist_sched.py   # 구단주 분포 예약·토글·동의·지우기(가짜 로더)
python tests/test_release.py   # 배포 검사 로직
python tests/test_rules.py   # 규칙 검사(인코딩·색·콤보박스·대화상자 크기·모달·신호·SQL 실행 계획)
python tests/test_review_kit.py   # 계획 검토 준비 도구

파일 구조

기본 매치 종류는 감독모드(52) 다 — 이 앱은 감독모드 전적을 본다.

누적 저장 (fifa.db)

API는 과거를 무한히 주지 않는다. 한 번에 받는 개수 상한이 100이고, offset으로 그보다 과거까지 받을 수 있지만 끝이 있다.

2026-09-05 실측 (GB쭈우 · 감독모드 · get_match_ids)
  offset=0     100개       offset=500   100개
  offset=100   100개       offset=3000   24개   ← 여기서 끝. 총 3,024경기

같은 시점 fifa.db에는 7,859경기가 있다(2026-06-17~). API가 닿는 가장 오래된 경기는 대략 2026-08-04(DB 기준 최신에서 3,024번째)이라, 한 달 남짓 지난 경기는 API에서 사라진다.

⚠️ 여기 오래 틀린 값이 적혀 있었다. "API는 최근 100경기까지만 준다 · 하루만 걸러도 영영 못 가져온다" — 100은 한 번에 받는 개수 상한이지 전체 상한이 아니다. 이 판단은 2026-07-18(d872ef5)에 이미 정정됐는데 문서에는 반영되지 않았고, 오히려 07-24 README 정비 때 다시 적혔다. 2026-09-05에 실측으로 고쳤다. 누적 저장이 필요하다는 결론 자체는 그대로다 — 이유의 규모가 틀렸을 뿐이다.

그래서 조회할 때마다 fifa.db에 쌓고, 화면은 API가 아니라 DB를 그린다. 검색하는 순간이 곧 수집이라, 자주 보는 계정일수록 데이터가 길어진다.

• 저장 기준은 ouid — 구단주명은 바뀌어도 ouid는 안 바뀐다

• 경기 원본은 한 번만 — 한 경기에 두 명이 나오므로 matches / match_players로 분리. 상대를 검색하면 이미 받아 둔 경기가 재활용된다

• 이미 있는 경기는 API를 다시 부르지 않는다 (store.existing_ids)

• 등록 계정 — 조회하면 자동 등록. 목록에서 고르면 바로 조회. 등록 해제해도 경기 기록은 남는다

• 검색 속도 — 저장된 기록 읽기(1만 경기 약 2초, 대부분 JSON 해석)는 넥슨 조회와 동시에 한다. 켤 때 마지막으로 검색한 계정의 기록을 뒤에서 미리 읽어 두므로 그 계정은 더 빠르다(화면은 검색창 그대로). 2026-10-04 실측(1만 832경기): 검색 → 첫 화면 5.3초 → 마지막 계정 약 1.3초 · 다른 계정 약 3초. 처음 보는 계정은 경기 상세를 동시 24개로 받는다(3,130경기 119초 → 38초, 서비스 키). 429 를 받으면 그 검색은 2개로 내린다(app_main.DETAIL_WORKERS · DETAIL_WORKERS_THROTTLED) ⚠️ DB 를 열 때 통계를 갱신한다(PRAGMA optimize) — 통계가 생기면 SQLite 가 계획을 바꾸므로, 경기 기록 본문을 읽는 쿼리는 (종류, 날짜) 인덱스를 직접 지정한다(안 그러면 본문을 통째로 정렬했다)

• 거래 기록(1.4.1) — trades(구매·판매 한 줄씩, ouid 열 없음 — API 키 주인의 거래라서) · trade_state(키 지문 · 받기 진행 · 내 계정) · card_prices(카드 강화 단계별 시세, 하루 캐시). 2026-10-06 실측: 첫 수집 163요청 · 19초 · 구매 4,430 + 판매 11,473건 · DB +3.8MB. 거래 API 는 2022-01-27 부터 주고, 반영은 며칠 늦을 수 있다(그날 마지막 거래 09-30)

• 카드 정보(2.1.1) — card_info(카드 하나에 급여·1강 OVR · 30일) · api_budget(그날 쓰임별 홈페이지 요청 수 — 축구장 칩 60 · 가계부 시세 80. 재시작해도 남는다). 강화별 OVR 은 1강 값 + config.GRADE_OVR_BONUS(시뮬레이터 실측 — check_api 가 다시 대조)

• 선수 색인(2.1.1) — match_squads(카드 · 날짜 · 경기 · 구단주 · 자리 · 강화 — 선발만, 정수 키 WITHOUT ROWID) + 번호 표 squad_owner·squad_match. 새 경기는 저장과 같은 커밋에서, 옛 경기는 켠 뒤 30초(트레이 시작이면 2분)부터 낮은 우선순위로 1,000경기씩 채운다(검색이 돌면 양보). 2026-10-06 실DB 사본(2.1만 경기): 14.7MB · CPU 4.5초 · 가장 많이 쓰인 카드 조회 4.4ms

• 랭커 픽(2.1.1) — ranker_squads(랭커마다 ouid·최근 경기·받은 시각·실패) · ranker_matches(랭커 픽으로 들어온 경기 표시 — 14일 정리·지우기의 범위. 검색한 계정이 나온 경기는 지우지 않는다). 모든 연결이 secure_delete — 지운 다른 구단주 닉네임이 파일 빈칸에 남지 않게(VACUUM 은 안 한다)

한계: API가 이미 버린 과거는 못 되살린다. 처음 조회 시점에 API가 주는 만큼 (실측 3,024경기 · 약 한 달)이 시작점이고, 그보다 이전은 없다. 조회 간격이 그보다 길어지면 그 사이가 뚫린다.

감독모드 랭킹 (ranker.py)

순위·구단가치·랭킹점수(ELO)는 오픈API(JSON)에 없다. 넥슨 공식 데이터센터 웹페이지에는 있어서 거기서 긁어온다.

https://fconline.nexon.com/datacenter/rank_inner?rt=manager&strCharacterName=<닉네임>

• JSON API 가 아니라 HTML 스크래핑이다. 넥슨이 페이지 구조(class 이름)를 바꾸면 깨진다. 그래서 URL·class·정규식을 전부 ranker.py 한 곳에만 둔다 — 깨지면 실제 응답과 대조해 거기만 고친다.
• 여기 전적은 감독모드 통산(오픈API 의 최근 3천 경기보다 많다)이라 랭커 카드는 이 값을 우선 쓴다. 단 요약 숫자일 뿐 경기별 상세는 아니다.
• 랭킹은 상위 1만 위까지만. 밖이면 순위·구단가치·점수를 "랭킹 밖"으로 두고 전적은 앱이 받은 경기로 집계한다.
• 상대 팀컬러 — 팀컬러 메뉴·포지션별 최다 상대는 위쪽 시즌 콤보 범위로 센다(표시 구간 100경기면 팀컬러마다 1~2경기라 승률이 안 된다). 새로 찾을 상대가 500명보다 많으면 상대마다 검색하는 대신 랭킹 목록 1만 위(20명 × 500쪽)를 통째로 읽는다(ranker.fetch_rank_page · RankListLoader). 찾을 수 있는 범위(1만 위 안)는 같고 요청은 500번으로 고정이다. 적으면 그 상대만 검색한다.
  • 2026-10-02 실측(동시 8): 목록 500쪽 48.8초로 누적 상대 6,375명이 한 번에 정리됐다(찾음 3,504 · 1만 위 밖 2,871). 같은 수를 상대마다 검색하면 1건 0.106초라 약 11분.
  • 결과는 DB 에 7일 캐시(store.TEAM_COLOR_TTL_DAYS) — 그 사이엔 그날 새로 만난 상대만 검색하고, 만료되면 다시 목록을 읽는다(약 50초).
  • 한 쪽이라도 못 읽으면 못 찾은 상대를 '랭킹 밖'으로 저장하지 않는다(다음 조회 때 다시).
  • 팀컬러는 경기 당시가 아니라 상대가 지금 쓰는 것이다 — 지난 시즌일수록 실제와 다를 수 있다.
  • 이름이 같은 팀컬러(2.2.1) — 강화 팀컬러와 클럽 팀컬러가 같은 이름인 11쌍(config.TEAMCOLOR_DUP_NAMES — 2026-10-06 목록 801개 실측)은 랭킹 행의 팀컬러 엠블럼으로 가른다. 엠블럼은 fifa.db team_colors.emblem (읽은 시각\t종류/파일 — 옛 버전이 이름만 바꾼 줄을 시각으로 가려낸다) · rank.db 옆 표 snapshot_emblems (옛 버전이 그대로 수집할 수 있게 snapshot_rows 는 안 건드린다). 엠블럼 없이 읽은 옛 줄은 "(구분 전)"으로 흐리게. 넥슨이 새 쌍을 만들면 python check_api.py <닉네임> 의 팀컬러 목록 줄이 [FAIL] 이다.
• 팀컬러 효과(2.2.1 · teamcolor.py) — 효과 창을 열 때만 데이터센터 목록(1.2MB · 7일 저장)·그 팀컬러 상세(단계)· 적용 선수 JSON(한 번 최대 100명 · OVR 상한으로 이어 받는다)을 읽는다. 상세·선수 주소는 넥슨 사이트의 스크립트가 보내는 X-Requested-With 헤더가 있어야 열린다(없으면 오류 페이지로 넘긴다). 받은 선수의 급여·시세는 카드 캐시에도 넣는다 — 그 JSON 의 OVR 은 선수 페이지 1강 OVR 과 달라(2026-10-06 실측 122 vs 125) 쓰지 않는다.

시즌 말 순위 예측 (predict.py)

"지금 흐름이 이어지면 시즌이 끝날 때 몇 위쯤일까"를 확률로 낸다. 랭킹 수집이 켜져 있어야 한다.

• 재료: 수집 원본(14일)에서 하루 간격(20~28시간)·같은 시즌인 이웃 스냅숏 쌍마다 구단주별 (시작 ELO, 하루 변화, 그날 경기 수). 승·무·패가 시즌 누적이라 이웃 차가 그 사이 경기 수다(2026-10-05 실측: 스냅숏 2,601 vs 저장 경기 2,602).
• 경로마다 날마다 내 최근 14일 하루 경기 수 하나를 뽑고, 지금 ELO ±50 · 같은 경기 수 칸(4분위) · 같은 "직전 사흘 변화" 3분위의 실제 하루 변화를 하나 더한다. 같은 구단주의 이어진 사흘이 충분하면 사흘째 붙인다(연승·연패 연속성). 점수가 높을수록 하루 변화가 작아지는 되돌림이 표본에 그대로 들어 있어 한 방향으로 폭주하지 않는다.
• 끝 ELO 를 지난 시즌 최종 컷(시즌 길이가 비슷할수록 크게 뽑음 · 순위마다 지금 컷보다 낮지 않게)에 대어 순위를 낸다.
• 시즌 종료일은 넥슨이 미리 안 알려 줘서 최근 12시즌 길이로 추정한다. 개발자가 알게 되면 tools/season_notice.py 로 릴리스 본문에 <!-- season-end: … start: … --> 한 줄을 넣는다 — 앱은 업데이트 확인 응답에서 읽는다(새 버전 불필요).
• 조건이 안 맞으면 숫자 대신 이유(수집 꺼짐 · 모으는 중 N일 · 1만 위 밖 · 점수대 기록 적음 · 경기 적음 · 지난 시즌 컷 없음 · 마감 처리 중). 아직 실제와 맞춰 본 적이 없어 늘 "검증 전"을 붙인다 — 시즌이 끝나면 tools/check_predictions.py.
• 계산 시간(1만 명 × 14 스냅숏 가짜 표본): 걸음 표본 0.40.6초(원본이 같으면 캐시) · 2,000경로 × 2060일 224~284ms. 작업 스레드.

시즌별 보기 (seasons.py)

오픈API 는 경기에 시즌을 달아주지 않는다(matchDate 만 준다). 대신 데이터센터 랭킹 페이지가 시즌 목록을 기간과 함께 갖고 있어서, 그 기간표로 경기를 나눈다.

• 넥슨 오픈API 시각(matchDate 등)은 UTC 다 — matchtime.py 가 KST 로 바꿔 읽는다(2026-10-25 실측 · 그전엔 모든 경기 시각이 9시간 일렀다). 시즌표 날짜는 KST 그대로 경기의 KST 시각과 견준다.

https://fconline.nexon.com/datacenter/rank?rt=manager
→ ChangeSeason(89) "시즌 3 (2026-05-28~2026-07-30)"

• rt 에 따라 시즌 번호가 다르다(공식경기 91 = 감독모드 89, 기간은 같다). 이 앱은 감독모드만 다루므로 항상 rt=manager 로 받는다.
• 앞 시즌 종료일 == 다음 시즌 시작일이라, 종료일은 포함하지 않는 경계로 보고 [시작, 종료) 로 자른다. 안 그러면 경계일 경기가 두 시즌에 겹친다.
• 진행 중인 시즌은 목록에 안 올라온다. 마지막 종료일 이후 경기는 "진행 중"으로 따로 묶어 보여준다.
• 시즌표는 DB(seasons 테이블)에 캐시하고 하루에 한 번만 다시 긁는다. 조회에 실패해도 지난 캐시를 그대로 쓰고, 캐시조차 없으면 시즌 기능만 빠진 채 판수 기준 화면은 평소대로 돈다.
• 한계: API 가 과거 경기를 안 주므로 앱을 쓰기 시작한 뒤 쌓인 경기만 시즌에 잡힌다. 지난 시즌은 비어 있거나 실제보다 적게 나온다.

API 메모

• 호스트: https://open.api.nexon.com
• 인증: 요청 헤더 x-nxopen-api-key
• 키 발급: NEXON Open API 로그인 → 마이페이지

사용 중인 엔드포인트 (nexon_api.py 상단 상수):

메타데이터(매치 종류·선수·시즌·등급)는 인증 없이 https://open.api.nexon.com/static/fconline/meta/{name}.json.

공식 문서가 자바스크립트로 렌더링돼 경로를 자동 대조하지 못했다. check_api.py가 FAIL이면 공식 문서와 대조해 nexon_api.py 상단 상수만 고치면 된다.

응답에서 역산해 알아낸 것 (공식 문서에 없음)

실제 응답 100경기로 확인한 내용. 상수는 stats.py 상단에 있다.

매치 상세는 경기별 실제 스쿼드를 준다(현재 스쿼드를 돌려주는 게 아니다). 볼타 66경기에서 서로 다른 스쿼드 조합 10개가 나오는 것으로 확인.

앞으로

앞으로 할 일(버전별 상세 계획)은 docs/ROADMAP.md 한 곳에 있다. 아래는 이미 끝난 것들이다.

• 선수별 통계 — stats.aggregate_players
• 상대 전술별 승률 — stats.formation_stats
• 공격력·수비력·기대득점률·선방력 — API 미제공이라 계산식을 정해 옮겼다(PlayerStat). 실제 100경기로 검증했다. 선방력은 defending 합계가 아니라 경기당 평균×100이다 — 100경기 표본에서 우연히 합계처럼 보였을 뿐, 경기 수가 다르면 값이 완전히 달라진다
• 상대 구단주별 상성 분석 — models.opponent_stats, "상대 전적" 탭
• 기간별 승률 추이 차트 — models.win_rate_trend(월별), "승률 추이" 탭
• 조회 결과 로컬 DB(SQLite) 누적 — store.py
• 선수 이미지 (넥슨 CDN) — images.py. 오픈API가 아니라 비공식 CDN 직링크 (fco.dn.nexoncdn.co.kr)라 넥슨이 바꾸면 깨질 수 있다
• exe 빌드 (PyInstaller)
• 선수 카드 상세(능력치·특성·시세·클럽경력) — playerinfo.py, 상대 스쿼드·선수 지표 표·포지션별 최다 상대 표에서 선수 클릭(더블클릭)
• 선수 카드 능력치 시뮬레이터 — 강화단계(1~13강, 기본 1강)·적응도(+1/+5, 기본 +1 — 홈페이지 첫 화면과 동일 기준)·팀컬러(소속/강화/관계 3종)를 바꿔가며 실제 능력치 확인. 로컬 근사 계산이 아니라 PC 데이터센터(fconline.nexon.com)가 실제로 쓰는 /datacenter/PlayerAbility 엔드포인트를 그대로 호출해서 넥슨 서버가 계산한 값을 받는다(playerinfo.fetch_player_ability) — 팀컬러 종류(600여개)별 보너스 조합표를 넥슨이 공개하지 않아 근사가 불가능하므로, 정확성을 위해 매 조작마다 재조회하는 방식을 택함. 팀컬러 드롭다운은 응답 HTML에 같이 오는 그 선수 전용 선택지로 채운다(전체 목록 페이지 불필요). 레벨 UI는 없음 — 소속 팀컬러는 항상 그 팀컬러의 최대 레벨(대부분 4)로 자동 조회하고, 강화 팀컬러는 항목 자체에 레벨이 있으며("Lv.2 금빛 물결"), 관계 팀컬러는 레벨이 없다. 능력치 값 색상도 데이터센터와 같은 10점 구간 기준(playerinfo.stat_color). "포지션별 오버롤" 탭 — 데이터센터 축구장 그림의 16개 포지션 값(1강·적응도 +1 기준)
• 구단주 비교 탭에 각 계정의 최근 경기 스쿼드 표시 — stats.own_squad
• 등급(디비전) 추이 그래프 — 승률 그래프 탭 아래, 매 경기 당시 division을 계단 그래프로(저장된 데이터만 사용, 추가 조회 없음)
• 기간별 추이 탭 — 누적 전체를 1일/2일/1주/1개월 단위로 묶은 전적 표 (models.period_stats) + 현재/최장 연승·연패(models.longest_streaks)
• 팀컬러 랭킹 표에 팀컬러별 평균/최저/최고 팀가치 — 팀컬러를 긁을 때 같은 페이지에 있는 구단가치를 같이 저장(추가 요청 없음). 캐시 TTL은 팀컬러·팀가치 모두 7일. 넥슨 웹 점검 중 응답은 "랭킹 밖"으로 오인해 캐시하지 않도록 감지
• 승부처 분석 탭 — 이미 저장된 shootDetail만으로 계산(추가 조회 없음). 선제골 승률(stats.clutch_summary: 내가 선제골/선제 실점 시 승률, 역전승·역전패), 정규시간 15분 6구간+연장의 득실 분포(stats.goal_minute_buckets), 시각대별 승률(stats.time_of_day_rates: 심야/오전/오후/저녁밤 4구간)
• 선수별 결정력 랭킹 — shootDetail을 슈터(spId)·도움(assistSpId)별로 모아 선수별 슛·유효슛·골·전환율·xG·어시스트(stats.finishing_ranking). "선수별 결정력" 탭, 골−xG에 색(+초록/−빨강), 선수 더블클릭 시 선수 카드. 표시 구간 기준
• 기대득점(xG) — stats.shot_xg. 넥슨이 정답값을 안 줘서 추정치(비공식). 2.9.1 부터 격자 표: 골라인 거리 5m × 중앙 폭 5m × 슛 종류 칸마다 실제 득점 비율(표본이 적은 칸은 상위 칸 쪽으로 당김 · 페널티킥은 상수). 감독모드 약 2만 6천 경기의 슛에서 개발자 계정 슛을 빼고 세웠다 — 표는 xg_grid.py(생성물 · python tools/fit_xg.py --write), 읽기는 xgmodel.predict. 옛 로지스틱(거리·각도 + 헤더 ×0.7)보다 검증 슛 로그손실 11% 낮고 보정 오차 6.9 → 0.8%p(ROADMAP 43 측정 2·2d). 보정을 잰 등급은 챔피언스챌린지3(division 9001300) — 그 밖이면 결정력 문장에 "확인 못 함"을 붙인다. 슛 맵 요약·결정력 표에 표시
• 슛 맵 — shootDetail의 x/y 좌표를 공격 진영 하프 피치 위에 점으로 (stats.shot_map, widgets.ShotMapWidget). 골=초록·유효슛=노랑·빗나감=회색, 골대맞음은 흰 테두리. "슛 맵" 탭에서 내 슛/상대 슛(실점 위치) 토글, 골·유효슛· 빗나감 종류별 표시 on/off 체크박스, 표시 구간 기준. 요약(슛·골·유효슛률·전환율)은 필터와 무관하게 전체 기준으로 표시. 상대 슛은 좌표가 상대 공격 기준이라 y(좌우)를 뒤집어 내 시점으로 통일
• 슛 유형·거리별 득점률 — 슛 맵 탭 오른쪽 패널(stats.shot_type_breakdown · stats.shot_distance_breakdown · widgets.RatioBarRow). 이미 만든 ShotMap만 쓰는 순수 계산이라 추가 조회·파싱이 없다. 분모가 골이 아니라 슛 — "전체 골 중 헤딩이 10%"(result_breakdown.goal_types)와 "헤딩 슛의 20%가 들어간다"는 다른 지표다. 거리는 박스 안(inPenalty) / 박스 밖 ~25m / 25m 이상, 박스 안 여부는 좌표 환산 대신 넥슨이 직접 주는 inPenalty를 그대로 쓴다. 슛 5개 미만인 칸은 비율을 숨긴다(MIN_BUCKET_SHOTS) — 1/2=50%는 정보가 아니다. 위쪽 내 슛/상대 슛 토글이 그대로 걸려서 상대 슛으로 두면 "어떤 유형·거리에 실점하는가"가 된다
• 성적 진단 탭 — 저장된 데이터만으로(추가 조회 없음) 상대 등급(division)별 승률· 평균 득실(stats.division_stats)과 내 점유율 구간별(열세<40·균형40~60·우세>60) 승률(stats.possession_stats). 누적 전체 기준. 1.2.1 규율·불운(stats.discipline_stats) — 몰수는 결과 문자열이 아니라 양쪽 matchEndType 으로 가른다(stats.end_kind — 몰수 경기의 matchResult 는 그냥 "승"·"패"라, 그전엔 "경기 결과"의 몰수 줄이 늘 0 이었다)
• 연승·연패 직후 승률(1.2.1) — stats.after_streak_rates. 흐림 기준은 흐름 분석 문장과 같은 analysis.streak_min_n(전체의 2%, 최소 8). 실DB 3계정에서 차이가 최대 5.9%p 라 문장은 거의 안 나온다
• 역대 최고 등급(1.2.1) — user/maxdivision 을 메인 검색마다 1건(재시도 없음 · 상세 받기가 끝난 뒤), 랭커 카드 머리 아래 한 줄. 신호(max_division_ready)는 늘 finished_ok 뒤에 보낸다
• 선수 조합(케미) 탭 — 함께 선발로 나온 선수쌍별 승률(stats.pair_synergy). 1.2.1 에서 삭제(메뉴 정리)
• 흐름 분석 탭 — 집계를 문장으로 서술(analysis.narrate). 최근 흐름은 최근 20경기, 이기는/지는 패턴은 누적 전체 기준으로 나눠 잰다(패턴을 20경기로 말하면 조건부로 쪼갤 때 표본이 6~8경기로 줄어 노이즈를 패턴으로 읽는다). 두 층을 대조해 "선제골 승률은 76%인데 최근엔 선제골 자체가 안 나온다" 같은 문장을 만든다. 규칙별 최소 표본에 못 미치면 문장을 내지 않는다

개발 노트

만들면서 무엇이 어떻게 깨졌고 어떻게 알아냈는지를 docs/notes/ 에 두 편으로 적었다. 계산이 어려운 앱이 아니라서, 틀린 것도 계산이 아닌 쪽에서 나왔다.

고르고 남은 후보 40건과 왜 안 골랐는지는 CANDIDATES.md. 다섯 프로젝트의 공개 색인은 https://yim2412.github.io 에 있다.

이용 안내

앱 첫 실행 창과 [정보] 창에 같은 글이 있다(notice.py 한 곳). 요약:

• 비공식 개인 프로젝트다. 넥슨·EA 와 무관하며 그들이 보증하거나 지원하지 않는다. EA SPORTS FC 온라인과 관련 데이터의 권리는 NEXON / EA 에 있다.
• 무료, 있는 그대로. 화면의 수치(공식에 없는 값을 역산한 지표 포함)는 틀릴 수 있고, 써서 생긴 손해는 책임지지 않는다.
• API 키는 본인이 발급받아 넣는다 — 키 관리와 넥슨 오픈API 이용약관 준수는 키를 발급받은 본인 몫. 조회 결과를 다른 곳에 올리거나 남에게 넘길 때도 그 약관을 따른다.
• 넥슨 홈페이지 데이터는 기본 꺼짐. 홈페이지를 자동으로 읽는 방식이라 넥슨이 공식으로 허락한 경로가 아니다. 켜는 것은 사용자의 선택과 책임이다.
• 랭킹 수집도 기본 꺼짐. 켜면 하루 한 번 랭킹 1만 명(다른 구단주 닉네임·프로필 번호 포함)을 이 PC 에만 14일 두고 집계는 계속 둔다. 사람을 이어 봐야 하는 값(상위 20 연속·시즌 최고점·첫 챔스·시즌 FC·챔스 이상 판수)은 닉네임 없이 프로필 번호로 그 시즌 동안만 두고 수집을 끄면 지운다. 검색한 구단주의 ELO 기록도 이 PC 에 남는다. 밖으로 보내는 기능은 없다. 프로그램을 제거해도 기록은 남는다 — 지우려면 제거 전에 [정보 › 저장 공간] 의 내 기록 전부(경기 기록까지) 또는 랭킹 수집 기록.
• 개인정보: 만든 사람은 아무것도 수집하지 않는다(개발자 서버·사용 통계 없음). 연결처는 넥슨 오픈API · 넥슨 이미지 서버 · 넥슨 홈페이지(켰을 때만) · GitHub(업데이트 확인)뿐이다. 키·전적·오류 기록은 %LOCALAPPDATA%\피파전적관리 에만 있다. 오류 기록(crash.log)에는 PC 폴더 경로(사용자 이름)가 들어갈 수 있으니 보내기 전에 열어 확인한다.

라이선스

소스 코드는 MIT. 배포하는 실행 파일은 PyQt6(GPL v3) 를 포함하므로 실행 파일 전체는 GPL v3 조건으로 배포된다 — 소스는 이 저장소에 있다. 포함된 오픈소스 목록은 notice.THIRD_PARTY, 라이선스 전문은 배포물의 _internal\licenses\(빌드 때 설치된 패키지에서 모으고, tools/release.py 가 빠진 게 없는지 확인한다).