toki
0d9555f9a3
운영 표면과 거래 확장 phase를 완료 상태로 정리하고 ROADMAP에서 archive 경로로 이동되도록 반영한다. 또한 포트 슬롯 정책과 host publish 근거 문구를 README에 추가해 workspace 공통 대역 정합성을 문서화한다.
72 lines
4.3 KiB
Markdown
72 lines
4.3 KiB
Markdown
# Milestone: Live Trading Boundary
|
|
|
|
## 위치
|
|
|
|
- Roadmap: `agent-roadmap/ROADMAP.md`
|
|
- Phase: `agent-roadmap/phase/trading-expansion/PHASE.md`
|
|
|
|
## 목표
|
|
|
|
실거래 adapter, 주문 관리, 리스크 관리, 포트폴리오 동기화 경계를 paper trading 안정화 이후에 연다. 이 milestone은 실제 주문 제출을 서두르지 않고, broker adapter와 운영 안전장치를 먼저 명확히 하는 데 목적이 있다.
|
|
|
|
## 상태
|
|
|
|
[완료]
|
|
|
|
## 구현 잠금
|
|
|
|
- 상태: 해제
|
|
- 결정 필요: 없음
|
|
- 결정 내용:
|
|
- [x] 실거래를 열기 전 paper trading 안정화 기준은 수익성 검증과 운영 안정성 검증을 모두 포함한다. 비용/슬리피지 반영 후 양의 기대값과 양의 순손익이 필요하며, 주문 lifecycle, risk guard, kill switch, 계좌/포지션 sync, audit trail이 반복 검증 가능해야 한다.
|
|
- [x] 첫 live broker/provider는 이전 Milestone 결정과 KIS live data evidence를 승계해 KIS-first로 둔다. 다만 domain/contract/worker 경계는 broker/provider-neutral port를 유지하고, KIS 특수성은 adapter와 runtime config 안에 격리한다.
|
|
- [x] 실거래 주문 capability는 설계에서 임의로 제한하지 않는다. 현재 구체 구현 대상을 좁히더라도 broker port와 order lifecycle은 KIS와 후속 broker가 제공할 수 있는 주문 유형, 정정/취소, 체결 상태, 오류 상태를 확장 가능하게 표현해야 한다.
|
|
- [x] 리스크 한도는 조정 가능한 정책 값으로 둔다. 에이전트가 보수적인 기본값을 제안하고 config/test fixture로 구현하되, 이후 수치 조정만으로 변경 가능하게 한다.
|
|
|
|
## 범위
|
|
|
|
- broker adapter boundary
|
|
- order lifecycle
|
|
- risk guard and kill switch
|
|
- portfolio/account sync
|
|
- audit log and operator confirmation
|
|
|
|
## 기능
|
|
|
|
### Epic: [live-boundary] Live trading boundary
|
|
|
|
실거래 adapter, 주문 lifecycle, risk guard, account sync, audit trail 경계를 묶는다.
|
|
|
|
- [x] [broker-port] broker adapter port가 paper/live 공통 경계를 갖는다. 검증: paper trading과 live trading 경계가 명확히 분리되고, live adapter 없이도 domain/contract 테스트가 가능하다.
|
|
- [x] [order-lifecycle] 주문 생성, 제출, 체결, 취소, 실패 lifecycle이 정의된다. 검증: 실거래 주문 제출은 operator confirmation을 통과해야 한다.
|
|
- [x] [risk-limits] 실거래 전 최소 risk limit과 kill switch가 있다. 검증: 실거래 주문 제출은 risk guard를 통과해야 한다.
|
|
- [x] [account-sync] 계좌/포지션 동기화 경계가 있다.
|
|
- [x] [audit-trail] live operation audit trail이 있다.
|
|
|
|
## 완료 리뷰
|
|
|
|
- 상태: 승인됨
|
|
- 요청일: 2026-06-08
|
|
- 완료 근거: `broker-port`, `order-lifecycle`, `risk-limits`, `account-sync`, `audit-trail`이 모두 PASS 완료 로그로 충족됐다.
|
|
- 완료 근거: `account-sync`는 `agent-task/archive/2026/06/m-live-trading-boundary/04+01_account_sync/complete.log`의 Roadmap Completion으로 확인했다.
|
|
- 완료 근거: `audit-trail`은 `agent-task/archive/2026/06/m-live-trading-boundary/05+02,03,04_audit_trail/complete.log`의 Roadmap Completion으로 확인했다.
|
|
- 리뷰 필요:
|
|
- [x] 사용자가 완료 결과를 확인했다
|
|
- [x] archive 이동을 승인했다
|
|
- 리뷰 코멘트: 사용자 승인에 따라 Milestone을 `[완료]`로 전환하고 archive 이동한다.
|
|
|
|
## 범위 제외
|
|
|
|
- MVP 단계 실거래 실행
|
|
- 무인 자동 실거래
|
|
- 고빈도/초단타 execution
|
|
|
|
## 작업 컨텍스트
|
|
|
|
- 관련 경로: `services/worker/`, `services/api/`, `apps/cli/`, `packages/domain/`
|
|
- 표준선(선택): 실거래는 수익성 기준과 운영 안정성 기준을 모두 충족한 paper trading 안정화 이후에만 경계를 열며, UI는 live boundary 후보까지 command/headless로 정리된 뒤 후순위 Phase에서 다룬다.
|
|
- 표준선(선택): 주문 capability는 설계상 닫지 않는다. 실제 돈이 움직이는 운영 rollout은 별도 확인을 거치더라도, domain/contract/worker port는 주문 유형과 broker별 상태 확장을 막지 않는다.
|
|
- 선행 작업: Paper Trading Readiness, Paper Trading Command Workflow, US Market Expansion
|
|
- 후속 작업: Flutter Operator Console MVP
|
|
- 확인 필요: 없음
|
|
- 현재 작업 현황: 모든 기능 Task 완료. 사용자 확인과 archive 승인 완료.
|