FCOnline_Image_Searcher Files

========================================================================
FC Online Player Image Searcher v2.2 - README
========================================================================

[KOREAN / 한국어]

1. 프로그램 정보
   - 프로그램명: FC 온라인 선수 이미지 검색기
   - 버전: v2.2
   - 개발자: 펨코 서유리
   - 기반 기술: Python 3.11, PyQt6
   - 제공 기능: FC 온라인 선수 고유 이미지(Action Shot) 및 미니 페이스온 검색/다운로드

2. v2.2 업데이트 내역 (Change Log)
   기능 확장, UI 디자인 개선, 그리고 핵심 로직 최적화가 이루어진 대규모 업데이트입니다.

   A. 검색 범위 대폭 확장
      - [기본 헤드샷] 검색 추가: 기존에 불가능했던 '미니 페이스온(헤드샷)'을 검색합니다. (/players/ 경로)
      - [특수 시즌] 검색 추가: 파일명 뒤에 _24 ~ _30이 붙는 특수 액션샷을 지원합니다.
      - 결과창에 [기본], [24시즌] 등으로 시즌 정보를 명확히 구분하여 표시합니다.

   B. 로딩 및 정렬 시스템 전면 개편
      - 로딩 UI 변경: 텍스트 방식에서 직관적인 '원형 스피너(Spinner)'와 진행률(%) 표시로 변경했습니다.
      - 정렬 로직 고도화: 검색 중 뒤죽박죽 섞이던 문제를 해결했습니다. 이제 [기본] -> [특수] -> [일반 시즌] 순서로 완벽하게 정렬됩니다.
      - 깜빡임 제거: 검색이 100% 완료된 후 정렬된 결과를 한 번에 보여주어 눈의 피로를 줄였습니다.

   C. UI/UX 디자인 리뉴얼
      - 랭킹 패널: 배경과 분리된 깔끔한 라운드 박스 디자인을 적용하고, 여백을 조정하여 답답함을 해소했습니다.
      - 다크모드 최적화: '바로가기' 버튼 등 세부 요소까지 다크모드 색상이 완벽하게 적용됩니다.
      - 선수 카드: 일반 상태일 때 불필요한 배경색을 제거(투명 처리)하여 깔끔함을 더했습니다.
      - 그리드 레이아웃: 창 크기 조절 시 카드가 빈 공간 없이 꽉 차게 배열되도록 계산식을 수정했습니다.

   D. 버그 수정 및 안정성 강화
      - 시즌 랭킹 오류 수정: 시즌 검색 시 이미지가 아닌 텍스트가 랭킹에 뜨던 문제를 해결했습니다. (서버 전송 데이터 수정)
      - 버튼 비활성화 해결: 검색 완료 후에도 '전체 저장' 버튼이 눌리지 않던 오류를 수정했습니다.
      - 다운로드 오류 해결: 헤드샷 검색 시 서버 차단(HEAD 요청)을 우회하여 다운로드 성공률을 높였습니다.

3. 주요 기능 및 사용 방법

   [선수 검색 탭]
   - 사용법: 선수 이름(예: 손흥민) 또는 고유 ID(spid)를 입력하고 검색합니다.
   - 기능: 기본 헤드샷부터 특수 시즌, 일반 시즌까지 모든 이미지를 한 번에 찾아줍니다.

   [시즌 검색 탭]
   - 사용법: 3자리 시즌 코드(예: 101, 230)를 입력하여 검색합니다.
   - 기능: 데이터 센터에 없는 미확인 시즌도 코드로 탐색할 수 있습니다.

   [즐겨찾기 탭]
   - 기능: 자주 찾는 선수를 등록하여 이미지를 모아볼 수 있습니다.
   - 추가/해제: 검색된 이미지 위에서 마우스 우클릭 후 '즐겨찾기 추가/해제' 선택.

   [이미지 저장]
   - 개별 저장: 이미지 우클릭 -> '이미지 저장' 선택.
   - 일괄 저장: 상단 메뉴의 '전체 저장' 버튼 클릭 (검색 결과가 있을 때만 활성화).

4. 파일 저장 위치 및 데이터 관리
   이 프로그램은 실행 속도 향상을 위해 아래 경로에 데이터를 캐시(임시 저장)합니다.
   * 경로: C:\Users\[사용자명]\AppData\Roaming\FCOnlineImageSearcher
   * 포함 파일:
     - player_history.json / season_history.json: 검색 기록
     - favorites.json: 즐겨찾기 목록
     - season_icons 폴더: 시즌 로고 이미지 파일

5. 저작권 및 면책 조항 (Disclaimer)
   - 본 프로그램은 NEXON Korea Corporation이 제공하는 공식 프로그램이 아닙니다.
   - 개인이 NEXON Open API를 활용하여 제작한 팬 메이드 툴입니다.
   - "EA SPORTS FC ONLINE"과 관련된 모든 이미지 및 데이터의 저작권은 넥슨 및 EA에 있습니다.
   - 본 프로그램을 통해 얻은 이미지는 개인적인 용도로만 사용해야 하며, 상업적 이용에 대한 책임은 사용자에게 있습니다.

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

[ENGLISH / English]

1. Program Information
   - Name: FC Online Player Image Searcher
   - Version: v2.2
   - Developer: Pemco Seoyuri
   - Tech Stack: Python 3.11, PyQt6
   - Function: Search and download action shot/headshot images from FC Online.

2. v2.2 Update Highlights
   Major update featuring expanded search scope, UI redesign, and core logic optimization.

   A. Expanded Search Scope
      - Basic Headshots: Now supports searching for minifaces (via /players/ path).
      - Special Seasons: Supports special action shots with suffixes like _24 to _30.
      - Display: Clearly distinguishes between [Default], [Season 24], and standard seasons.

   B. Overhauled Loading & Sorting System
      - New UI: Replaced text loading with a stylish 'Circular Spinner' showing real-time percentage.
      - Perfect Sorting: Results are now strictly sorted: [Headshot] -> [Special] -> [Standard Seasons].
      - No Flickering: Results are displayed all at once after the search completes to prevent visual clutter.

   C. UI/UX Design Renewal
      - Ranking Panel: Applied a rounded box design with improved margins for a cleaner look.
      - Dark Mode: Optimized colors for shortcut buttons and other elements.
      - Player Cards: Removed background color for non-favorited cards (transparent).
      - Grid Layout: Improved calculation logic to ensure cards fill the screen efficiently.

   D. Bug Fixes & Stability
      - Fixed Season Ranking: Resolved an issue where text appeared instead of season icons (fixed server data transmission).
      - Save Button Fix: Resolved an issue where the 'Save All' button remained disabled.
      - Download Fix: Improved headshot download success rate by bypassing HEAD request blocks.

3. How to Use

   [Player Search]
   - Enter a player's name or ID to find all images including headshots.

   [Season Search]
   - Enter a 3-digit season code to browse all players in that season.

   [Favorites]
   - Right-click an image to add/remove it from your favorites list.

   [Saving Images]
   - Individual: Right-click -> 'Save Image'.
   - Batch: Click 'Save All' button at the top.

4. Data Location
   This program stores cache data in:
   * Path: C:\Users\[Username]\AppData\Roaming\FCOnlineImageSearcher

5. Disclaimer
   - This is an unofficial, fan-made tool and is not endorsed by NEXON Korea Corporation.
   - All intellectual property rights related to FC Online belong to NEXON and EA.
   - Extracted images are for personal use only.

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