WON HUB SP Collector V0.2.0

목적
- SP의 공식 API 키를 요구하지 않습니다.
- 사용자가 정상 로그인한 Chrome SP 페이지의 DOM과 해당 페이지가 실제로 수신하는 JSON 구조를 관찰합니다.
- 고객 데이터는 로컬에서 변경 여부를 비교한 뒤 신규·변경 건만 WON HUB로 전송합니다.
- 비밀번호, 쿠키, Authorization 값, KYC 원본 이미지/문서는 HUB로 전송하지 않습니다.

설치
1. ZIP을 고정된 폴더에 압축 해제합니다.
2. Chrome 주소창에 chrome://extensions 입력
3. 개발자 모드 ON
4. '압축해제된 확장 프로그램을 로드합니다'에서 해당 폴더 선택
5. SP에 평소처럼 로그인합니다.
6. 확장프로그램을 열고 '현재 탭을 SP로 등록'을 누릅니다.
7. WON HUB > 정산 > 고객 현황에서 1회용 연결 코드를 발급합니다.
8. 확장프로그램에 코드를 입력하고 HUB 연결을 누릅니다.

V0.2.0 자동 동작
- 등록된 SP 도메인의 열려 있는 모든 탭을 자동 감지합니다.
- DOM은 변화가 있을 때와 180초 안전 주기로만 분석해 브라우저 부담을 줄였습니다.
- Fetch/XHR JSON 중 고객 ID/이메일 + 레퍼럴 구조가 확실한 데이터만 정규화합니다.
- 로컬 IndexedDB에서 고객별 해시를 비교하고 변경된 행만 100건 단위로 HUB에 전송합니다.
- 네트워크 오류 시 로컬 전송 대기열에 보존하고 자동 재시도합니다.
- 동일 출처 GET 고객 목록에서 페이지 번호/총 페이지를 확실히 확인한 경우에만 낮은 속도로 최대 120페이지 범위에서 나머지 페이지를 저속 자동 탐색합니다.
- POST/PUT/DELETE 요청은 자동 재실행하지 않습니다.

상태 시각의 의미
- 마지막 SP 감지: 등록한 SP 탭이 살아 있는지 확인한 시각
- 마지막 구조 분석: DOM/네트워크 구조를 분석한 시각
- 고객 원본 인식: 정규화 가능한 고객 행을 본 시각
- 마지막 데이터 변화: 이전에 저장한 고객 해시와 달라진 행을 발견한 시각
- 마지막 HUB 반영: 신규·변경 고객이 HUB DB에 실제 저장된 시각
- 데이터가 바뀌지 않았다면 SP 감지는 계속 갱신되어도 마지막 HUB 반영 시각은 유지되는 것이 정상입니다.

중요한 제한
- V0.2.0은 실제 SP 전용 필드명이 아직 확정되지 않은 범용 자동 탐색 버전입니다.
- 화면 밖 데이터는 동일 출처 GET 페이지네이션을 확실히 감지한 목록부터 자동 순회합니다.
- POST 기반 목록, 별도 고객 상세 API, 거래/잔액 전용 화면은 실제 진단 JSON을 확인한 뒤 SP 전용 Adapter에서 완전 자동화해야 합니다.
- '최근 진단 JSON 복사' 결과를 GPT 작업방에 전달하면 실제 SP 전용 Adapter를 고정할 수 있습니다.
