docs: formalize issue 61 proofline specification
This commit is contained in:
Hermes Agent
@@ -0,0 +1,49 @@
|
||||
# GitHub issue #61 comment evidence
|
||||
|
||||
- Source: https://github.com/fourblocks2020/trex-core/issues/61#issuecomment-5337469578
|
||||
- Author: `genichin`
|
||||
- Created At: `2026-08-19T04:17:48Z`
|
||||
- Evidence Role: repository-local snapshot of a non-canonical implementation comment
|
||||
- Canonical Authority: GitHub source comment; this snapshot does not create ProofLine lifecycle status
|
||||
|
||||
---
|
||||
|
||||
## 구현 완료
|
||||
|
||||
### 구현 내용
|
||||
|
||||
- venue가 누락되거나 `null`인 buy/sell intent를 `SOR`로 정규화하고 KIS 요청에 `EXCG_ID_DVSN_CD="SOR"`를 명시한다.
|
||||
- explicit `KRX`/`NXT`/`SOR`를 submit·ack·slot·restart·cancel 전 과정에서 원주문 venue로 보존한다.
|
||||
- `AUTO`를 admission에서 거부하고 wall-clock KRX/NXT routing을 제거했다.
|
||||
- persisted `AUTO`를 `SOR`로 전환하고 이후 invalid venue 저장을 차단한다.
|
||||
- 원주문 `order_venue`와 broker-authoritative actual execution venue를 분리한다. 취소·재시작은 원주문 venue를, ledger/outbox actual venue는 KRX/NXT 또는 미확정 NULL을 사용한다.
|
||||
- historical SOR actual은 임의 추론하지 않고 NULL로 보존하며 migration replay가 정상 order/execution venue 조합을 오염시키지 않는다.
|
||||
- current SOR 계약과 충돌하던 interface 문서와 KIS adapter 주석을 정정했다.
|
||||
- omitted와 explicit `venue: null`을 각각 검증하는 regression을 추가했다.
|
||||
|
||||
### 실제 검증 결과
|
||||
|
||||
- 구현자 비-DB focused: `107 passed`
|
||||
- 구현자 explicit omitted/null focused: `8 passed`
|
||||
- 구현자 disposable PostgreSQL 16: `24 passed`
|
||||
- 구현자 전체 회귀: `1074 passed, 52 skipped`
|
||||
- Ruff·ProofLine validate·diff check: PASS
|
||||
- 최종 독립 재QC: PASS — blocker 0 / major 0 / minor 0
|
||||
- 최종 worktree: clean
|
||||
|
||||
최초 combined focused 실행의 `1 failed, 5 errors`는 종료된 이전 QC PostgreSQL DSN의 connection refused였으며, 새 disposable PostgreSQL 16에서 semantic migration suite를 재실행해 `24 passed`를 확인했다.
|
||||
|
||||
### 로컬 커밋
|
||||
|
||||
- 기능 구현 기반: `15aeae6930f8c3e6ef9cf659f41278b099a78459`, `7366cadf03fc6002bfd01ecf0cba7c24486bb618`, `359ea098ff717e7f04cf4206dcbc64ad17b47755`
|
||||
- 계약 문서 정합: `64e4e32f9d7abf7082588b3c4c9a8c0d272762f6`
|
||||
- explicit null regression: `43f6fea7ac805f27fba35586af27f0090a672222`
|
||||
|
||||
### 비차단 후속 권고
|
||||
|
||||
- 실제 KIS 운영계좌 SOR 주문과 외부 인프라 검증은 별도 승인된 환경에서 수행한다.
|
||||
- migration runner의 replay-safe 불변식을 향후 migration 변경에서도 유지한다.
|
||||
|
||||
### 범위 경계
|
||||
|
||||
현재 완료된 것은 **로컬 `main` 구현·테스트·PostgreSQL 검증·커밋과 독립 QC PASS**다. push, PR, 원격 main 반영, image 게시, 운영 migration, 배포, GitHub Release, issue 종료와 실주문은 수행하지 않았다.
|
||||
@@ -0,0 +1,51 @@
|
||||
# GitHub issue #61 comment evidence
|
||||
|
||||
- Source: https://github.com/fourblocks2020/trex-core/issues/61#issuecomment-5337421562
|
||||
- Author: `genichin`
|
||||
- Created At: `2026-08-19T04:10:59Z`
|
||||
- Evidence Role: repository-local snapshot of a non-canonical implementation comment
|
||||
- Canonical Authority: GitHub source comment; this snapshot does not create ProofLine lifecycle status
|
||||
|
||||
---
|
||||
|
||||
## 구현 진행 상황
|
||||
|
||||
- **대상:** [Discovery] 명시 venue 기반 주문 실행 계약
|
||||
- **브랜치:** `main`
|
||||
- **기준:** `main` (`4975d7166fa70e045096503e85c26d740ae92c55`)
|
||||
- **상태:** 로컬 main 구현·검증·커밋 및 독립 QC PASS — 미푸시, 미배포
|
||||
- **최종 업데이트:** 2026-08-19 13:17:45 KST
|
||||
|
||||
### 구현 계획 및 작업 목록
|
||||
|
||||
- [x] venue가 없는 매수·매도 주문을 SOR 주문으로 제출한다.
|
||||
- 누락과 `null` 모두 같은 기본값을 사용하고 KIS 요청에 SOR를 명시한다.
|
||||
- [x] 사용자가 지정한 KRX·NXT·SOR venue를 주문 전 과정에서 그대로 보존한다.
|
||||
- 주문 접수부터 KIS 제출, 재시작 후 조회와 취소까지 원주문 venue가 바뀌지 않아야 한다.
|
||||
- [x] AUTO venue를 입력·실행·저장 경계에서 제거한다.
|
||||
- AUTO 요청을 입구에서 거부하고 시간대에 따라 KRX/NXT를 선택하는 동작도 제거한다.
|
||||
- [x] 기존 저장 데이터의 AUTO venue를 SOR로 안전하게 전환한다.
|
||||
- 실제 PostgreSQL에서 반복 적용과 저장 제약을 함께 검증한다.
|
||||
- [x] SOR 원주문 venue와 실제 체결된 KRX/NXT venue를 구분해 보존한다.
|
||||
- 취소·재시작은 원주문 SOR를 사용하고 체결 원장에는 확인된 실제 거래소만 기록한다.
|
||||
- [x] 문서·설정·테스트에 폐기된 runtime AUTO 계약이 남아 있지 않은지 점검한다.
|
||||
- [x] 관련 집중 테스트, 전체 회귀 테스트, PostgreSQL migration 검증과 코드 품질 검사를 실행한다.
|
||||
- 검증 실패가 승인 범위 안의 결함이면 수정하고, 계획의 의미나 범위를 바꿔야 하면 즉시 중지하고 재승인을 요청한다.
|
||||
|
||||
### 진행 기록
|
||||
|
||||
- 2026-08-19 13:10:40 KST — 승인된 이슈 본문, `main` branch와 clean worktree, 기준 SHA `4975d7166fa70e045096503e85c26d740ae92c55`를 확인했다. 별도 worktree나 기능 branch를 만들지 않고 구현·검증을 시작한다.
|
||||
|
||||
- 2026-08-19 13:12:28 KST — 기존 local main 구현에서 누락/null→SOR, explicit KRX/NXT/SOR 보존, AUTO admission 거부와 wall-clock routing 제거, order/execution venue 분리를 확인했다. 관련 비-DB 집중 테스트 `107 passed`.
|
||||
- 2026-08-19 13:12:28 KST — 최초 focused 실행은 종료된 이전 QC의 stale PostgreSQL DSN(`127.0.0.1:32778`) 때문에 `107 passed, 1 failed, 5 errors`였으며 코드 실패가 아니었다. 새 disposable PostgreSQL 16에서 migration·outbox·repository `24 passed`를 확인하고 컨테이너를 제거했다.
|
||||
- 2026-08-19 13:12:28 KST — current 계약과 충돌하던 interface 문서의 과거 KRX-default 설명 및 KIS adapter 주석을 SOR intent normalization 기준으로 수정했다.
|
||||
|
||||
- 2026-08-19 13:13:08 KST — repository 전체 AUTO 검색에서 잔존 항목은 admission 거부·migration 변환 검증과 현재 문서의 폐기 설명뿐이며 runtime AUTO 생성·허용 계약은 확인되지 않았다.
|
||||
- 2026-08-19 13:13:08 KST — 전체 회귀 `1074 passed, 52 skipped`, Ruff·ProofLine validate·diff check PASS. 로컬 main commit `64e4e32f9d7abf7082588b3c4c9a8c0d272762f6`을 생성하고 worktree clean을 확인했다. push·PR·배포·릴리스·실주문은 수행하지 않았다.
|
||||
|
||||
- 2026-08-19 13:16:22 KST — 독립 read-only QC PASS: blocker 0, major 0, minor 1. 기능 결함은 없었고 explicit wire `venue: null`을 독립적으로 이름 붙인 테스트가 없다는 minor 검증 공백을 확인했다.
|
||||
- 2026-08-19 13:16:22 KST — 승인 계획의 누락/null→SOR 검증 범위 안에서 omitted/null parameterized regression을 추가했다. focused `8 passed`, Ruff·diff check PASS, commit `43f6fea7ac805f27fba35586af27f0090a672222`, worktree clean. 독립 재QC를 요청한다.
|
||||
|
||||
- 2026-08-19 13:17:45 KST — 독립 재QC PASS: blocker 0, major 0, minor 0. omitted/null 두 케이스의 SOR normalization, broker request, ack 후 slot routing provenance를 독립 확인했다. 최종 HEAD `43f6fea7ac805f27fba35586af27f0090a672222`, worktree clean.
|
||||
|
||||
> 각 작업이 실제로 완료되고 검증될 때마다 이 댓글의 체크박스와 진행 기록을 갱신한다. 체크 표시는 구현 완료 또는 해당 검증의 실제 통과를 의미하며, 배포·릴리스 완료를 의미하지 않는다.
|
||||
Reference in New Issue
Block a user