FCOnline_Image_Searcher Files

========================================================================
             FC 온라인 선수 이미지 검색기 (FCOnline Image Searcher)
                                  v3.1.1
========================================================================

[ 프로그램 소개 ]
이 프로그램은 FC 온라인의 데이터 센터와 이미지 서버를 기반으로 선수들의 
미니 페이스온(헤드샷, 액션샷)을 손쉽게 검색하고 수집할 수 있는 도구입니다.
방대한 데이터 속에서 원하는 시즌, 팀 컬러, 선수를 빠르게 찾아보세요.

------------------------------------------------------------------------
[ v3.1.1 업데이트 내역 ] - 2025.12.10

1. 치명적 오류 수정 (Critical Hotfix)
   - 프로그램 최초 실행 시(AppData 폴더가 없는 상태) 'spid.json' 경로 에러([Errno 2])로 인해 프로그램이 강제 종료되던 문제를 해결했습니다.
   - 필수 폴더 생성 시점을 로딩 이전으로 앞당겨, 설치 직후에도 안정적으로 구동됩니다.

2. 검색 기능 안정화
   - [검색 중지] 버튼 클릭 시 프로그램이 멈추거나(Freezing) 응답 없음 상태가 되던 현상을 완벽하게 해결했습니다.
   - 검색을 중단하더라도, 중단 시점까지 발견된 이미지는 사라지지 않고 결과 화면에 정상적으로 표시되도록 개선했습니다.

3. UI/UX 및 편의성 개선
   - 초기 로딩이 완료된 후 프로그램이 작업 표시줄에서만 깜빡이고 화면 맨 앞으로 나오지 않던 문제를 수정했습니다. (자동 포커스 적용)
   - '선수 이름/ID' 검색 탭에서 자동완성 기능이 작동하지 않던 버그를 수정했습니다.
   - 다크모드 On/Off 전환 시 랭킹 패널의 글자 색상이 즉시 변경되지 않고 애니메이션 후 바뀌던 시각적 어색함을 수정했습니다.
   - 랭킹 아이템(선수) 클릭 시, 검색어가 잘못된 입력창에 들어가던 오류를 수정했습니다.

------------------------------------------------------------------------
[ 주요 기능 ]

1. 통합 검색 시스템
   - 선수 이름, 시즌 코드, 팀 컬러를 하나의 프로그램에서 모두 검색 가능.
   - '통합 검색창'을 통해 타이핑과 동시에 자동완성 및 필터링 지원.

2. 스마트 팀 컬러 검색
   - 'teams.json' 데이터를 기반으로 해당 팀에 소속된 모든 선수를 한 번에 검색.
   - 교집합 필터 지원: '레알 마드리드'와 '첼시'를 동시에 체크하면 두 팀을 모두 거친 선수만 필터링 가능.
   - 데이터 수집기(Crawler)를 통해 최신 팀 컬러 데이터를 자동으로 확충 가능.

3. 실시간 인기 랭킹 (Live Ranking)
   - 다른 사용자들이 많이 찾는 선수, 시즌, 팀 컬러 순위를 실시간으로 확인 가능.
   - 등락폭(▲/▼/NEW) 표시 기능 탑재.

4. 초고속 다운로드 & 최적화
   - 'spid.json' 데이터를 활용한 스마트 필터링으로 없는 데이터는 건너뛰고 실존하는 이미지만 빠르게 다운로드.
   - 멀티스레딩 및 커넥션 풀링 기술 적용으로 대량의 이미지도 끊김 없이 검색.

5. 사용자 편의 기능
   - 다크 모드 / 라이트 모드 지원.
   - 검색 결과 이미지 우클릭으로 '저장' 및 '즐겨찾기' 가능.
   - 드래그 앤 드롭으로 이미지 간편 저장 지원.

------------------------------------------------------------------------
[ 설치 및 실행 방법 ]

1. 압축을 푼 폴더 내의 'FCOnline_Image_Searcher_v3.1.1.exe'를 실행합니다.
2. 프로그램이 실행되면 자동으로 서버와 통신하여 최신 데이터를 받아옵니다.
   (초기 구동 시 서버 연결 상태에 따라 약 10~30초 정도 소요될 수 있습니다.)
3. 준비가 완료되면 메인 화면이 나타납니다.

* 'icon.png' 파일이 실행 파일과 같은 폴더에 있거나 내장되어 있어야 로딩 아이콘이 정상적으로 표시됩니다.

------------------------------------------------------------------------
[ 주의 사항 ]
- 이 프로그램은 넥슨(NEXON)의 공식 프로그램이 아니며, Open API 및 공개된 이미지 리소스를 활용합니다.
- 과도한 반복 요청은 서버 차단의 원인이 될 수 있으니 주의해 주세요.
- 'teams.json' 파일은 사용자가 직접 크롤링하여 데이터를 추가할 수 있습니다.

========================================================================