kjh2064
27730704ae
Snapshot Admin Web Validation / validate-snapshot-admin-smoke (push) Has been cancelled
Snapshot Admin Web Validation / validate-snapshot-admin-full (push) Has been cancelled
Quant Engine CI/CD Pipeline / validate-core (pull_request) Has been cancelled
Quant Engine CI/CD Pipeline / validate-ui-and-storage (pull_request) Has been cancelled
WBS-9.3 - NULL Policy CI Gate / NULL Policy Validation (pull_request) Has been cancelled
1.7 KiB
1.7 KiB
Gitea Variables Setup
이 저장소는 KIS Open API와 Gitea workflow를 분리해서 사용한다.
현재 KIS 인증값은 Settings > Actions > Variables에 등록해서 사용한다.
Required Variables
Shared
GITHUB_TOKEN
KIS read-only validation
KIS_APP_KEY_TESTKIS_APP_SECRET_TEST
KIS real data collection
KIS_APP_KEYKIS_APP_SECRET
Token Cache Policy
- KIS access token은
Temp/kis_tokens.db에 저장한다. - 토큰은
TOKEN_REFRESH_SKEW_MINUTES=10기준으로만 재사용/갱신한다. - 토큰 캐시는 수집 DB와 분리한다.
- 토큰 캐시 상태는
python tools/inspect_kis_token_cache_v1.py --json로 점검한다. - 토큰 갱신 실패 시 appkey/appsecret 또는 API 가용성 문제로만 판단하고, 시크릿 값을 로그나 알림에 그대로 노출하지 않는다.
Workflow Mapping
.gitea/workflows/kis_data_collection.yml- mock validation:
KIS_APP_KEY_TEST,KIS_APP_SECRET_TEST - real collection:
KIS_APP_KEY,KIS_APP_SECRET
- mock validation:
.gitea/workflows/qualitative_sell_strategy.yml- mock validation:
KIS_APP_KEY_TEST,KIS_APP_SECRET_TEST - real collection:
KIS_APP_KEY,KIS_APP_SECRET
- mock validation:
.gitea/workflows/ci.yml- mock validation:
KIS_APP_KEY_TEST,KIS_APP_SECRET_TEST
- mock validation:
Runtime Rule
- mock 계정은 유효성 확인용이다.
- real 계정은 실제 데이터 수집용이다.
- 둘을 같은 단계에서 혼용하지 않는다.
- 토큰 발급은 1일 1회 원칙을 따르며, 만료 전에는 캐시를 재사용한다.
Verification
Run:
python tools/validate_gitea_secrets_contract_v1.py
The validator checks that the workflows reference the required variable names with the expected separation between mock and real usage.