docs(discovery): confirm manual ledger API discovery
This commit is contained in:
@@ -1,15 +1,15 @@
|
|||||||
# 0. 문서 상태
|
# 0. 문서 상태
|
||||||
이 문서의 현재 상태와 식별 정보를 기록한다. 문서 추적과 승인 흐름에 필요한 최소 메타데이터를 적는다.
|
이 문서의 현재 상태와 식별 정보를 기록한다. 문서 추적과 승인 흐름에 필요한 최소 메타데이터를 적는다.
|
||||||
|
|
||||||
- 상태: draft
|
- 상태: confirmed
|
||||||
- 문서 ID: dcy-012_20260714_manual-ledger-write-api-owner-scoped
|
- 문서 ID: dcy-012_20260714_manual-ledger-write-api-owner-scoped
|
||||||
- 이슈명: 사용자 수동 장부 입력 API — INVEST/BUFFER/BUY/SELL/WITHDRAW/PROFIT 계약 및 owner-scoped ledger write
|
- 이슈명: 사용자 수동 장부 입력 API — INVEST/BUFFER/BUY/SELL/WITHDRAW/PROFIT 계약 및 owner-scoped ledger write
|
||||||
- 작성 시각(KST): 2026-07-14 14:01
|
- 작성 시각(KST): 2026-07-14 14:01
|
||||||
- 마지막 갱신 시각(KST): 2026-07-14 14:01 KST (new-discovery draft)
|
- 마지막 갱신 시각(KST): 2026-07-14 16:35 KST (confirm-discovery)
|
||||||
- 대체됨: 없음
|
- 대체됨: 없음
|
||||||
- 교차 발원: trex-web `docs/discovery/dcy-011_20260714_portfolio-manual-ledger-balance-quantity.md` confirmed by Justin Ko
|
- 교차 발원: trex-web `docs/discovery/dcy-011_20260714_portfolio-manual-ledger-balance-quantity.md` confirmed by Justin Ko
|
||||||
- Project #7 item: `PVTI_lADOBCBKFM4BbUVHzgyvA9A` — `portfolio-hub: 수동 장부 입력 API 계약 — INVEST/BUFFER/BUY/SELL/WITHDRAW` (문서상 PROFIT 포함 결정 반영; Project title은 후속 정리 가능)
|
- Project #7 item: `PVTI_lADOBCBKFM4BbUVHzgyvA9A` — `portfolio-hub: 수동 장부 입력 API 계약 — INVEST/BUFFER/BUY/SELL/WITHDRAW` (문서상 PROFIT 포함 결정 반영; Project title은 후속 정리 가능)
|
||||||
- 생성된 REQ 참조: 없음(draft)
|
- 생성된 REQ 참조: 없음(REQ draft 진행 예정)
|
||||||
|
|
||||||
# 1. 계획 상태 요약
|
# 1. 계획 상태 요약
|
||||||
- 연계 문서 현황:
|
- 연계 문서 현황:
|
||||||
@@ -230,8 +230,8 @@
|
|||||||
- [x] daemon-managed confirmation contract 확정(OQ-4) — API-level explicit confirmation 강제
|
- [x] daemon-managed confirmation contract 확정(OQ-4) — API-level explicit confirmation 강제
|
||||||
- [x] history response fields 확정(OQ-5) — `total_value_after` 포함, `cumulative_profit_withdrawn` 별도 지표
|
- [x] history response fields 확정(OQ-5) — `total_value_after` 포함, `cumulative_profit_withdrawn` 별도 지표
|
||||||
- [x] legacy `PROFIT` mapping policy 확정(OQ-6) — `PROFIT`은 신규 manual API 필수 action
|
- [x] legacy `PROFIT` mapping policy 확정(OQ-6) — `PROFIT`은 신규 manual API 필수 action
|
||||||
- [ ] Scope owner: `portfolio-hub-dev` primary, `trex-web/service-dev` consumer, `qc-reviewer` verification
|
- [x] Scope owner: `portfolio-hub-dev` primary, `trex-web/service-dev` consumer, `qc-reviewer` verification
|
||||||
- [ ] Freeze 확정 담당자(CONFIRMED_BY) 지정
|
- [x] Freeze 확정 담당자(CONFIRMED_BY) 지정 — Justin Ko
|
||||||
|
|
||||||
# 9. 파일 처리 결과
|
# 9. 파일 처리 결과
|
||||||
- 처리 결과: 생성
|
- 처리 결과: 생성
|
||||||
@@ -264,8 +264,8 @@
|
|||||||
- existing tests coverage for CLI invest/transfer/buy/sell flows
|
- existing tests coverage for CLI invest/transfer/buy/sell flows
|
||||||
|
|
||||||
# 11. Discovery Freeze
|
# 11. Discovery Freeze
|
||||||
- Handoff Decision: 보류(draft)
|
- Handoff Decision: approved-for-req
|
||||||
- Handoff Rationale: trex-web dcy-011의 backend-first 후속 Discovery로 생성했다. 현행 portfolio-hub 구조와 action/effect는 확인했고, 기존 `/ledger/trades` 유지 + 신규 `/ledger/manual` 추가 방향은 확정했다. 주요 Open Question은 모두 해소되었고, 남은 것은 scope owner/freeze 승인이다.
|
- Handoff Rationale: trex-web dcy-011의 backend-first 후속 Discovery로 생성했다. 현행 portfolio-hub 구조와 action/effect는 확인했고, 기존 `/ledger/trades` 유지 + 신규 `/ledger/manual` 추가 방향을 확정했다. OQ-1~OQ-6은 모두 Answered이며, owner-scoped manual ledger API REQ 초안 작성으로 넘긴다.
|
||||||
- Ready for REQ Drafting: false — 주요 OQ는 해소되었으나 confirm-discovery 승인 전
|
- Ready for REQ Drafting: true
|
||||||
- Confirmed By: 미정
|
- Confirmed By: Justin Ko
|
||||||
- Confirmed At (KST): 미정
|
- Confirmed At (KST): 2026-07-14 16:35 KST
|
||||||
|
|||||||
@@ -17,4 +17,4 @@
|
|||||||
| dcy-009_20260627_user-read-asset-catalog-and-daemons | 20260627 | 사용자용 read 2종 — GET /v1/assets require_read 완화 + 사용자 가용 데몬 목록 신규(교차 발원 trex-web 포트폴리오 관리 dcy-007) | [Discovery](./dcy-009_20260627_user-read-asset-catalog-and-daemons.md) | confirmed |
|
| dcy-009_20260627_user-read-asset-catalog-and-daemons | 20260627 | 사용자용 read 2종 — GET /v1/assets require_read 완화 + 사용자 가용 데몬 목록 신규(교차 발원 trex-web 포트폴리오 관리 dcy-007) | [Discovery](./dcy-009_20260627_user-read-asset-catalog-and-daemons.md) | confirmed |
|
||||||
| dcy-010_20260627_daemon-scoped-broker-credential-provisioning | 20260627 | daemon-scoped 브로커(KIS) 인증정보 소유·전달 — 다중 인스턴스 trex-core가 daemon별 다른 계좌로 거래 (교차 발원 trex-core 중장기 멀티 인스턴스) | [Discovery](./dcy-010_20260627_daemon-scoped-broker-credential-provisioning.md) | confirmed |
|
| dcy-010_20260627_daemon-scoped-broker-credential-provisioning | 20260627 | daemon-scoped 브로커(KIS) 인증정보 소유·전달 — 다중 인스턴스 trex-core가 daemon별 다른 계좌로 거래 (교차 발원 trex-core 중장기 멀티 인스턴스) | [Discovery](./dcy-010_20260627_daemon-scoped-broker-credential-provisioning.md) | confirmed |
|
||||||
| dcy-011_20260628_daemon-crud-and-self-service-credential-api | 20260628 | 데몬 admin CRUD API + 사용자 self-service 브로커 인증정보 관리 API — 소유 스코프 write/rotate/메타데이터(복호화 secret 미반환), 데몬 생성·할당·(비)활성화는 admin (교차 발원 trex-web dcy-009) | [Discovery](./dcy-011_20260628_daemon-crud-and-self-service-credential-api.md) | confirmed |
|
| dcy-011_20260628_daemon-crud-and-self-service-credential-api | 20260628 | 데몬 admin CRUD API + 사용자 self-service 브로커 인증정보 관리 API — 소유 스코프 write/rotate/메타데이터(복호화 secret 미반환), 데몬 생성·할당·(비)활성화는 admin (교차 발원 trex-web dcy-009) | [Discovery](./dcy-011_20260628_daemon-crud-and-self-service-credential-api.md) | confirmed |
|
||||||
| dcy-012_20260714_manual-ledger-write-api-owner-scoped | 20260714 | 사용자 수동 장부 입력 API — INVEST/BUFFER/BUY/SELL/WITHDRAW 계약 및 owner-scoped ledger write | [Discovery](./dcy-012_20260714_manual-ledger-write-api-owner-scoped.md) | draft |
|
| dcy-012_20260714_manual-ledger-write-api-owner-scoped | 20260714 | 사용자 수동 장부 입력 API — INVEST/BUFFER/BUY/SELL/WITHDRAW/PROFIT 계약 및 owner-scoped ledger write | [Discovery](./dcy-012_20260714_manual-ledger-write-api-owner-scoped.md) | confirmed |
|
||||||
|
|||||||
Reference in New Issue
Block a user