86 lines
2.7 KiB
Markdown
86 lines
2.7 KiB
Markdown
# Core/Satellite Collector v4
|
|
|
|
은퇴자산용 코어/위성 후보 데이터 수집기입니다.
|
|
|
|
## v4 기본 정책
|
|
|
|
- 파라미터 없이 실행
|
|
- 1차 유니버스: KOSPI 160개 + KOSDAQ 40개
|
|
- 최종 후보: 100개
|
|
- 최종 후보 내 KOSDAQ: 최대 20개
|
|
- 1차 탐색 총량은 v3와 동일한 200개로 유지하여 호출 수 증가를 막습니다.
|
|
|
|
## 설치
|
|
|
|
```powershell
|
|
npm install
|
|
node core_satellite_collector.js
|
|
```
|
|
|
|
OpenDART 공시까지 확인하려면:
|
|
|
|
```powershell
|
|
$env:DART_API_KEY="발급받은키"
|
|
node core_satellite_collector.js
|
|
```
|
|
|
|
## 운영 표준
|
|
|
|
릴리즈와 패키징의 기준 진입점은 아래를 사용합니다.
|
|
|
|
```powershell
|
|
npm run ops:release
|
|
```
|
|
|
|
릴리즈 DAG의 엄격 판정이 필요하면 아래를 사용합니다.
|
|
|
|
```powershell
|
|
npm run full-gate
|
|
```
|
|
|
|
패키지 생성은 아래를 사용합니다.
|
|
|
|
```powershell
|
|
npm run prepare-upload-zip
|
|
```
|
|
|
|
`ops:release`는 릴리즈 DAG 전체를 실행하고, 일부 `warn_only` 검증은 `PASS_WITH_WARNINGS`로 기록합니다.
|
|
`full-gate`와 `validate-engine-strict`는 엄격 모드로 동일한 릴리즈 DAG를 재검증합니다.
|
|
|
|
추가 스크립트:
|
|
|
|
- `npm run ops:package`
|
|
- `npm run ops:validate`
|
|
- `npm run ops:build`
|
|
- `npm run render-report-json`
|
|
- `npm run validate-proposal-reference`
|
|
- `npm run validate-gas-call-arity`
|
|
|
|
## GAS 반영 체크리스트
|
|
|
|
`proposal_reference_json`을 실제 하네스 출력으로 승격하려면 아래 순서를 따릅니다.
|
|
|
|
1. Apps Script에 최신 [gas_harness_rows.gs](/C:/Temp/data_feed/gas_harness_rows.gs:73) 반영
|
|
2. Apps Script에서 `runHarnessRefresh_()` 실행
|
|
3. Google Sheets `harness_context` 시트에 아래 키 생성 확인
|
|
- `proposal_reference_json`
|
|
- `proposal_reference_lock`
|
|
4. 로컬에서 `npm run ops:prepare` 실행
|
|
5. `npm run ops:release` 실행
|
|
6. `npm run full-gate` 실행
|
|
7. 최종 운영 전환 시 `npm run prepare-upload-zip`로 패키지 생성 여부를 확인
|
|
|
|
## 운영 리포트 계약
|
|
|
|
운영 리포트는 사람이 읽는 `Temp/operational_report.md`와 기계 검증용 `Temp/operational_report.json`을 함께 생성합니다.
|
|
|
|
- `operational_report.json`이 canonical 계약입니다.
|
|
- `operational_report.md`는 표시용 렌더입니다.
|
|
- JSON 스키마는 `schemas/operational_report.schema.json`을 사용합니다.
|
|
- 계약 드리프트 검사는 `npm run validate-operational-report-contract`로 수행합니다.
|
|
- 전체 게이트에는 `render-report-json -> validate-report-json -> validate-report-quality -> validate-report-sync` 순서가 포함됩니다.
|
|
|
|
전환 기준:
|
|
- `validate-proposal-reference` 결과와 `ops:release` 결과를 함께 봅니다.
|
|
- `prepare-upload-zip`가 `PASS_WITH_WARNINGS`를 출력하면 warn_only 검증 이슈가 남아 있는 상태입니다.
|