feat: postgres history-first 계약과 적재 경로 추가
- PostgreSQL history contract와 schema/validator를 추가했습니다. - .NET history store, snapshot reader, repository, migration을 연결했습니다. - history-first 운영 모델 문서와 daily signal tracking 문구를 정리했습니다.
This commit is contained in:
@@ -11,7 +11,7 @@
|
||||
### 1️⃣ 신호 발생 시 (거래 진입 시점)
|
||||
|
||||
```python
|
||||
# Python 또는 GAS 콘솔에서 실행
|
||||
# Python 또는 DB 마이그레이션 도구에서 실행
|
||||
signal = {
|
||||
"date": "2026-06-25",
|
||||
"ticker": "000660", # SK하이닉스 등
|
||||
@@ -25,14 +25,13 @@ signal = {
|
||||
"notes": "MA20 돌파 + 스마트머니 매수"
|
||||
}
|
||||
|
||||
# GAS: addSignal_(signal)
|
||||
# 또는 스프레드시트에 직접 입력
|
||||
# 운영 표준: PostgreSQL의 signal/factor history 테이블에 적재
|
||||
```
|
||||
|
||||
**✅ 체크리스트:**
|
||||
- [ ] signal_id 자동 생성됨 (YYYYMMDD_HHMM 형식)
|
||||
- [ ] validation_status = "UNVALIDATED"
|
||||
- [ ] 스프레드시트 행 추가됨
|
||||
- [ ] PostgreSQL 이력 행 추가됨
|
||||
|
||||
---
|
||||
|
||||
@@ -47,7 +46,7 @@ signal = {
|
||||
**해야 할 일:**
|
||||
1. T+5일의 종가 조회
|
||||
2. `updatePriceT5_(signalId, priceT5)` 실행
|
||||
3. 또는 스프레드시트 "price_t5" 열에 직접 입력
|
||||
3. 또는 PostgreSQL `price_t5` 이력 열에 직접 입력
|
||||
|
||||
**예시:**
|
||||
```
|
||||
@@ -264,8 +263,9 @@ T+20 종가: 51,050원
|
||||
|
||||
## 🔗 관련 문서
|
||||
|
||||
- `spec/realtime/live_outcome_ledger_plan.yaml` — 마스터 계획
|
||||
- `src/google_apps_script/live_outcome_ledger.gs` — GAS 코드
|
||||
- `spec/realtime/live_outcome_ledger_plan.yaml` — 마스터 계획(역사적)
|
||||
- `src/google_apps_script/live_outcome_ledger.gs` — 역사적 GAS 원장 어댑터
|
||||
- `spec/02_data_contract.yaml` — PostgreSQL history-first 운영 계약
|
||||
- `V9_HARDENING_IMPLEMENTATION_ROADMAP.md` — 전체 로드맵
|
||||
|
||||
---
|
||||
|
||||
@@ -0,0 +1,32 @@
|
||||
# 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 의사결정/원장 갱신
|
||||
|
||||
Reference in New Issue
Block a user