# Korean Stocks 동기화

`korean-stocks.json`은 수동 편집 파일이 아니라 자동 생성 파일입니다.
직접 수정하지 말고 동기화 스크립트로 갱신하세요.

## 실행 명령

```bash
npm run sync:stocks
```

- KIS 최신 KOSPI/KOSDAQ 마스터 파일을 내려받아
  `features/trade/data/korean-stocks.json`을 다시 생성합니다.

```bash
npm run sync:stocks:check
```

- 현재 파일이 최신인지 검사합니다.
- 갱신이 필요하면 종료 코드 `1`로 끝납니다.

```bash
npm run sync:stocks -- --dry-run
```

- 원격 파일 파싱/검증만 하고 저장은 하지 않습니다.

## 권장 운영 방법

1. 하루 1회(또는 배포 전) `npm run sync:stocks` 실행
2. `npm run lint`, `npm run build`로 기본 검증
3. 갱신된 `features/trade/data/korean-stocks.json` 커밋

## 참고

- 데이터 출처:
  - `https://new.real.download.dws.co.kr/common/master/kospi_code.mst.zip`
  - `https://new.real.download.dws.co.kr/common/master/kosdaq_code.mst.zip`
- 비정상 데이터 저장을 막기 위해 최소 건수 검증(안전장치)을 넣었습니다.
- 임시 파일 저장 후 교체(원자적 저장) 방식이라 중간 손상 위험을 줄입니다.
- 공식 문서:
 - `https://apiportal.koreainvestment.com/apiservice-category`