fix(execution): dcy-012 매도 가격 버그 정정 — slot entry_price→limit_price rename (BAT-016)

매도(sell) 주문이 현재가가 아닌 매수가(entry_price) 지정가로 나가던 버그(issue #10) 정정. 슬롯의 매수 전용 entry_price 를 side 무관 "현재 pending 주문 지정가" limit_price 로 내부 rename 하고, pending 이탈(→holding/→closed) 시 clear 해 매수 지정가가 매도로 누수되는 경로를 구조적으로 제거. 거버넌스: 전부 change-req (신규 REQ 없음, dcy-012 OQ-3). - REQ-002: Slot entry_price→limit_price rename + clear-on-exit 생애주기 - REQ-006: daily_slot 컬럼 rename 마이그레이션 006 (idempotent) + persistence 매핑 - REQ-013: _dispatch 가 slot.limit_price 단일 필드로 가격/주문유형 결정 - REQ-007: SellIntent/sell payload optional limit_price + _admit_sell 운반 - REQ-036: SlotService.sell optional 가격 → 자율 매도(safety-sell/kill-switch) 시장가 - REQ-003: 컬럼 계약/드리프트 가드 limit_price 반영 - REQ-015: runtime-flows/interface-contract/data-model 정합 매도 정책(OQ-1 하이브리드): 가격 지정→지정가("00"), 미지정→시장가("01"). 자율 매도는 가격 미전달 → 항상 시장가 (손절 미체결 pending_sell 갇힘 방지, issue #9 연계). 검증: 단위 286 passed/32 skipped, 인프라 게이트(PG+RabbitMQ) 318 passed, ruff clean. 신규 test_sell_pricing(recording broker)로 지정가 매수 슬롯의 매도가 매수가 재사용 안 함을 직접 검증. BAT-016 release-candidate. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-08 13:41:46 +09:00
parent aee3512383
commit cc28e1fba5
28 changed files with 1003 additions and 25 deletions
@@ -152,3 +152,42 @@

 #### Validation Plan
 - BAT-002 verification evidence 재참조로 충분.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-012) `daily_slot.entry_price` → `limit_price` 컬럼 rename 마이그레이션(`006_rename_entry_price_to_limit_price.sql`, idempotent DO-block) + persistence 매핑(`_SLOT_COLUMNS`/update_slot/_row_to_slot) 갱신. 순수 rename 으로 기존 행 데이터 보존(S-3). BAT-016 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 도메인 필드 rename(REQ-002)을 영속 스키마/매핑에 반영하면서 기존 데이터를 보존.
+
+#### Acceptance Criteria Delta
+
+- Updated:
+  - daily_slot 컬럼 entry_price → limit_price (마이그레이션 006, 데이터 보존). persistence read/write 매핑 동기화.
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/adapters/persistence/postgresql.py`, `trex_core/adapters/persistence/sql/006_rename_entry_price_to_limit_price.sql`(신규)
+- Tests: tests/adapters/persistence/test_migration_and_drift.py(컬럼 계약 = limit_price, 마이그레이션 idempotent)
+
+#### Delivery Trace Delta
+
+- Batches: BAT-016
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-016 에서 완료)
+- Existing Implementation Invalidated: yes (entry_price 컬럼/매핑)
+- Status Recommendation: Implemented (change-req → BAT-016 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-016).
+
+#### Validation Plan
+
+- BAT-016: PG 게이트 마이그레이션 round-trip + 컬럼 계약(limit_price) + idempotency.
@@ -147,3 +147,41 @@

 #### Validation Plan
 - BAT-004 verification evidence 재참조로 충분.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-012) baseline 문서를 새 매도 가격 정책·`limit_price` 생애주기·컬럼 rename 에 맞춰 정합: `docs/runtime-flows.md`(dispatch 가격 결정 = slot.limit_price 단일 필드 + 생애주기 set/clear), `docs/interface-contract.md`(sell payload optional limit_price + ORD_DVSN 매핑), `docs/data-model.md`(슬롯 limit_price 컬럼). BAT-016 정합 완료 → Implemented 유지.
+
+#### Intent
+
+- 코드(execution/intents/slot/persistence) 변경과 baseline 문서를 일치(S-4)시켜 운영자/전략 개발자 참조 정합 유지.
+
+#### Acceptance Criteria Delta
+
+- Updated:
+  - runtime-flows/interface-contract/data-model 의 매도 가격·limit_price 기술 정합.
+
+#### Impacted Area Delta
+
+- Docs: docs/runtime-flows.md, docs/interface-contract.md, docs/data-model.md
+
+#### Delivery Trace Delta
+
+- Batches: BAT-016
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: no (문서 정합)
+- Existing Implementation Invalidated: no
+- Status Recommendation: Implemented (change-req → BAT-016 정합)
+- Follow-up Action: confirm-req-implemented(BAT-016).
+
+#### Validation Plan
+
+- BAT-016: 코드-문서 diff 대조(S-4).
@@ -150,3 +150,42 @@

 #### Validation Plan
 - BAT-004 verification evidence 재참조로 충분.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-012/issue #10) `_dispatch` 의 매도 가격 버그 정정: side 분기로 `entry_price`(매수가)를 지정가로 재사용하던 로직을 제거하고, side 무관 슬롯 `limit_price` **단일 필드**만 읽어 주문유형/가격을 결정한다 — 값 있으면 `order_type="00"`(그 지정가), 없으면 `order_type="01"`(시장가). BAT-016 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 매도가 매수 지정가에 걸린 지정가로 나가 미체결되는 정합성 버그(issue #10) 제거. dispatch 의 가격 결정을 `slot.limit_price` 로 일원화.
+
+#### Acceptance Criteria Delta
+
+- Updated:
+  - dispatch 가격/주문유형은 `slot.limit_price` 한 필드로 결정(side 분기 없음, 매수가 재사용 금지).
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/application/execution.py`(`_dispatch`)
+- Tests: tests/application/test_sell_pricing.py(지정가 매수 슬롯의 시장가/지정가 매도, 회귀)
+
+#### Delivery Trace Delta
+
+- Batches: BAT-016
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-016 에서 완료)
+- Existing Implementation Invalidated: yes (entry_price 재사용 dispatch 경로)
+- Status Recommendation: Implemented (change-req → BAT-016 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-016).
+
+#### Validation Plan
+
+- BAT-016: 지정가 매수 슬롯 + 가격 미전달 매도 → 시장가(entry_price 미사용 증명), + 가격 전달 매도 → 그 지정가, 시장가 매수 슬롯 회귀.
@@ -152,3 +152,42 @@

 #### Validation Plan
 - BAT-001 verification evidence 재참조로 충분.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-012/issue #10) 슬롯 도메인 필드 `entry_price` → `limit_price`(side 무관 "현재 pending 주문 지정가") 내부 rename + 생애주기 정의: pending 진입 시 set, pending 이탈(→HOLDING/→CLOSED) 시 None clear. `transit_slot`/`_apply_transition_fields` 파라미터·`EXPECTED_SLOT_FIELDS` 반영. BAT-016 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 매수 지정가가 매도 주문에 누수되는 구조적 원인을 도메인 모델에서 제거(clear-on-exit). 가격 필드 의미를 side 무관으로 통일.
+
+#### Acceptance Criteria Delta
+
+- Updated:
+  - Slot.`entry_price` → `limit_price`; →HOLDING/→CLOSED 전이 시 limit_price clear, →PENDING_* 전이 시 set.
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/domain/slot/models.py`(Slot/EXPECTED_SLOT_FIELDS), `trex_core/domain/slot/service.py`(transit_slot/_apply_transition_fields clear-on-exit)
+- Tests: tests/domain/slot/test_service.py(holding clear), tests/domain/slot/test_contract.py(필드셋)
+
+#### Delivery Trace Delta
+
+- Batches: BAT-016
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-016 에서 완료)
+- Existing Implementation Invalidated: yes (entry_price 필드명/유지 의미)
+- Status Recommendation: Implemented (change-req → BAT-016 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-016).
+
+#### Validation Plan
+
+- BAT-016: 전이별 set/clear 단위 + 컬럼 계약 가드(REQ-003) 정합.
@@ -195,3 +195,43 @@
 #### Validation Plan

 - BAT-015 verification: portfolio_id_required/unknown_portfolio/symbol resolve 단위 + 전체 회귀(314 passed).
+
+### CHG-20260608-02
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-012) sell intent 계약에 optional 매도 가격 필드 추가: `SellIntent.limit_price`(+ sell payload `limit_price`) → `_admit_sell` 이 슬롯 `limit_price` 로 운반. 지정 시 지정가 매도, 미지정 시 시장가(자율 매도 기본 경로). buy 의 `entry_price` 는 동일 슬롯 `limit_price` 로 매핑(동작 동일). BAT-016 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 매도 가격 하이브리드 정책(가격 유무 분기, dcy-012 OQ-1/OQ-2)을 intent 제출 계약에 반영. 기존 재량 매도 호출(가격 미지정)은 시장가로 안전 동작(NFR-3).
+
+#### Acceptance Criteria Delta
+
+- Added:
+  - sell intent/payload optional `limit_price`(미지정 → 시장가, 지정 → 지정가). admission 이 슬롯 limit_price 로 운반.
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/application/intents.py`(SellIntent/_admit_sell, _admit_buy limit_price 매핑), `trex_core/application/messaging_handlers.py`(sell payload limit_price)
+- Docs: docs/interface-contract.md
+- Tests: tests/application/test_sell_pricing.py
+
+#### Delivery Trace Delta
+
+- Batches: BAT-016
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-016 에서 완료)
+- Existing Implementation Invalidated: no (optional 추가, 기존 sell 호출 시장가로 호환)
+- Status Recommendation: Implemented (change-req → BAT-016 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-016).
+
+#### Validation Plan
+
+- BAT-016: 가격 전달 매도 → 지정가 / 미전달 → 시장가 단위 + 핸들러 payload.
@@ -110,3 +110,42 @@
 - Existing Implementation Invalidated: no
 - Status Recommendation: keep-current
 - Follow-up Action: suggest-batch-reqs 후 batch 배정
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-012) `SlotService.sell` 에 optional `limit_price` 파라미터(default None) 추가. 자율 매도(safety-sell/kill-switch)는 가격 미전달 → 시장가로 즉시 체결(미체결 pending_sell 갇힘 방지), 재량 경로만 지정가 전달 가능. BAT-016 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 자동 매도 내부 경로가 매수 지정가에 걸리지 않고 시장가로 체결되도록(issue #10/#9 연계), 가격 파라미터를 optional 로 추가하되 기본값 None 으로 자율 경로 체결성을 보장.
+
+#### Acceptance Criteria Delta
+
+- Updated:
+  - `SlotService.sell(..., limit_price=None)` — 미전달 시 시장가(슬롯 limit_price None), 전달 시 지정가.
+
+#### Impacted Area Delta
+
+- Modules: `trex_core/domain/slot/service.py`(`sell`)
+- Tests: tests/application/test_sell_pricing.py::test_safety_sell_dispatches_at_market
+
+#### Delivery Trace Delta
+
+- Batches: BAT-016
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-016 에서 완료)
+- Existing Implementation Invalidated: no (시그니처 확장, 기존 호출 default None 동일 동작)
+- Status Recommendation: Implemented (change-req → BAT-016 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-016).
+
+#### Validation Plan
+
+- BAT-016: svc.sell 가격 미전달 → 시장가 + closed 전이 단위.
@@ -152,3 +152,42 @@

 #### Validation Plan
 - BAT-001 verification evidence 재참조로 충분.
+
+### CHG-20260608-01
+
+- Date: 2026-06-08
+- Author: Justin Ko
+
+#### Change Summary
+
+- (change-req, dcy-012) 컬럼 계약 가드를 `entry_price` → `limit_price` rename 에 맞춰 갱신. `EXPECTED_SLOT_FIELDS`(REQ-002)와 daily_slot 실제 컬럼(information_schema) 대조가 `limit_price` 기준으로 통과. BAT-016 재구현·재검증 완료 → Implemented 유지.
+
+#### Intent
+
+- 도메인/스키마 rename 후에도 코드 계약 ↔ DB 컬럼 드리프트 가드가 정확히 작동하도록 동기화.
+
+#### Acceptance Criteria Delta
+
+- Updated:
+  - 컬럼 계약/드리프트 테스트 기준 필드 entry_price → limit_price.
+
+#### Impacted Area Delta
+
+- Tests: tests/domain/slot/test_contract.py, tests/adapters/persistence/test_migration_and_drift.py
+- Modules: (없음 — 가드는 EXPECTED_SLOT_FIELDS 상수 참조)
+
+#### Delivery Trace Delta
+
+- Batches: BAT-016
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: yes (BAT-016 에서 완료)
+- Existing Implementation Invalidated: no (가드 로직 불변, 기대 필드셋만 rename 반영)
+- Status Recommendation: Implemented (change-req → BAT-016 재검증)
+- Follow-up Action: confirm-req-implemented(BAT-016).
+
+#### Validation Plan
+
+- BAT-016: 도메인 필드셋 가드 + PG 컬럼 드리프트 가드 green.
@@ -139,8 +139,8 @@

 ## Recent Change Log Summary

+- 2026-06-08 :: REQ-013/007/036/002/006/003/015 change-req (dcy-012, BAT-016): 매도 주문이 매수가(entry_price) 지정가로 나가던 버그(issue #10) 정정. 슬롯 `entry_price`→`limit_price`(side 무관 pending 지정가) rename + pending 이탈 clear(REQ-002), 컬럼 rename 마이그레이션 006(REQ-006), `_dispatch` 가 slot.limit_price 단일 필드로 가격/주문유형 결정(REQ-013), SellIntent/sell payload optional limit_price·_admit_sell 운반(REQ-007), SlotService.sell optional 가격→자율 매도 시장가(REQ-036), 컬럼 계약 가드(REQ-003), baseline 3문서 정합(REQ-015). 전부 change-req(신규 REQ 없음, OQ-3). 단위 286 passed, 인프라 게이트 318 passed, ruff clean. (change-req/confirm-req-implemented)
 - 2026-06-08 :: REQ-007/018/021 change-req + REQ-055 생성·Implemented (dcy-011, BAT-015): buy intent 계약 hard cutover — portfolio_id 필수화 + symbol 서버 resolve(SnapshotStore) + unknown_portfolio/portfolio_id_required 거부(REQ-007), buy payload symbol 제거(REQ-021), ledger skip 가시화(WARN+ledger_skipped 카운터, REQ-018), closed↔outbox anti-join 운영 점검 `find_ledger_gap_slots` 신규(REQ-055). 전체 인프라 게이트 314 passed, ruff clean. (change-req/draft-req/confirm-req-implemented)
 - 2026-06-08 :: REQ-052~054 Approved → Implemented (confirm-req-implemented): BAT-014(batch-lite) verify 완료(신규 8 단위, 전체 278 passed, ruff clean). SafetySellService per-slot 쿨다운(skip/만료재시도/경고/prune, market_close 제외), SafetySellConfig env 2종(min_retry_interval_sec 600/max_retry_warn_count 3), runtime-flows 정합. (confirm-req-implemented)
 - 2026-06-08 :: REQ-052~054 Proposed → Approved (confirm-req): dcy-010 safety-sell 쿨다운 3개 전원 승인 게이트 통과. dcy-010(confirmed) FR/OQ 와 모순 없음, 필수 필드·구체 AC 완비. 피드백 채널·DB 영속은 Out of Scope 비핵심. (confirm-req)
 - 2026-06-08 :: REQ-052~054 생성 (draft-req): dcy-010(safety-sell 영속 거부 재시도 백오프, confirmed) → 3개 REQ 초안. per-slot 쿨다운+경고(052), 쿨다운 env 2종(053), runtime-flows 정합(054). OQ-1(600s)/OQ-2(3회 경고)/OQ-3(단일 per-slot) Answered. (draft-req)
- 2026-06-07 :: REQ-048~051 Approved → Implemented (confirm-req-implemented): BAT-013 verify 완료(신규 9 단위 + RabbitMQ 라우팅 2, 단위 271 passed, 인프라 게이트 301 passed(directed 격리 S-2 + broadcast dual S-3 + default 무회귀 S-4), ruff clean). per-instance TOML 로더+`--config`, instance_key 동적 큐명(default 리터럴 하위호환), trex.direct/trex.broadcast exchange+바인딩, baseline 3문서 정합. (confirm-req-implemented)