Files
QuantEngineByItz/docs/POSTGRESQL_HISTORY_FIRST_OPERATING_MODEL.md
T
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

1.0 KiB

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 의사결정/원장 갱신