Files
QuantEngineByItz/docs/POSTGRESQL_HISTORY_FIRST_OPERATING_MODEL.md
kjh2064 8f13bb4a48 feat: postgres history-first 계약과 적재 경로 추가
- PostgreSQL history contract와 schema/validator를 추가했습니다.
- .NET history store, snapshot reader, repository, migration을 연결했습니다.
- history-first 운영 모델 문서와 daily signal tracking 문구를 정리했습니다.
2026-06-26 14:17:04 +09:00

33 lines
1.0 KiB
Markdown

# PostgreSQL History-First Operating Model
## 목적
운영 이력, 원천 팩터, 파생 팩터, 최종 판단, 시장-엔진 괴리를 PostgreSQL에 영구 이력으로 적재한다.
## 원칙
- PostgreSQL이 canonical operating history store다.
- Excel workbook과 Google Apps Script는 운영 소스가 아니다.
- 모든 파생 결과는 versioned snapshot과 provenance를 가져야 한다.
- 시장 raw와 엔진 결과의 괴리는 별도 gap history로 남긴다.
## 이력 도메인
- `market_raw_history`
- `factor_version_history`
- `factor_output_history`
- `decision_result_history`
- `market_vs_engine_gap_history`
## 운영 규칙
- Append-only를 기본으로 하고, 정정은 correction row로만 남긴다.
- 최종 팩터와 최종 판단은 항상 `source_version`을 포함한다.
- DB snapshot이 존재하면 리포트와 생성기는 이를 1차 진실원천으로 사용한다.
## 폐기 대상
- 운영 경로의 Excel 시트 의존
- 운영 경로의 GAS 의사결정/원장 갱신