From f9dce75d9ec9e58a9c84321a638674a7ba314e9c Mon Sep 17 00:00:00 2001 From: Justin Ko Date: Tue, 14 Jul 2026 16:36:43 +0900 Subject: [PATCH] docs(discovery): confirm manual ledger API discovery --- ...14_manual-ledger-write-api-owner-scoped.md | 20 +++++++++---------- docs/discovery/index.md | 2 +- 2 files changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/discovery/dcy-012_20260714_manual-ledger-write-api-owner-scoped.md b/docs/discovery/dcy-012_20260714_manual-ledger-write-api-owner-scoped.md index 52680f0..f759f2f 100644 --- a/docs/discovery/dcy-012_20260714_manual-ledger-write-api-owner-scoped.md +++ b/docs/discovery/dcy-012_20260714_manual-ledger-write-api-owner-scoped.md @@ -1,15 +1,15 @@ # 0. 문서 상태 이 문서의 현재 상태와 식별 정보를 기록한다. 문서 추적과 승인 흐름에 필요한 최소 메타데이터를 적는다. -- 상태: draft +- 상태: confirmed - 문서 ID: dcy-012_20260714_manual-ledger-write-api-owner-scoped - 이슈명: 사용자 수동 장부 입력 API — INVEST/BUFFER/BUY/SELL/WITHDRAW/PROFIT 계약 및 owner-scoped ledger write - 작성 시각(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 - Project #7 item: `PVTI_lADOBCBKFM4BbUVHzgyvA9A` — `portfolio-hub: 수동 장부 입력 API 계약 — INVEST/BUFFER/BUY/SELL/WITHDRAW` (문서상 PROFIT 포함 결정 반영; Project title은 후속 정리 가능) -- 생성된 REQ 참조: 없음(draft) +- 생성된 REQ 참조: 없음(REQ draft 진행 예정) # 1. 계획 상태 요약 - 연계 문서 현황: @@ -230,8 +230,8 @@ - [x] daemon-managed confirmation contract 확정(OQ-4) — API-level explicit confirmation 강제 - [x] history response fields 확정(OQ-5) — `total_value_after` 포함, `cumulative_profit_withdrawn` 별도 지표 - [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 -- [ ] Freeze 확정 담당자(CONFIRMED_BY) 지정 +- [x] Scope owner: `portfolio-hub-dev` primary, `trex-web/service-dev` consumer, `qc-reviewer` verification +- [x] Freeze 확정 담당자(CONFIRMED_BY) 지정 — Justin Ko # 9. 파일 처리 결과 - 처리 결과: 생성 @@ -264,8 +264,8 @@ - existing tests coverage for CLI invest/transfer/buy/sell flows # 11. Discovery Freeze -- Handoff Decision: 보류(draft) -- Handoff Rationale: trex-web dcy-011의 backend-first 후속 Discovery로 생성했다. 현행 portfolio-hub 구조와 action/effect는 확인했고, 기존 `/ledger/trades` 유지 + 신규 `/ledger/manual` 추가 방향은 확정했다. 주요 Open Question은 모두 해소되었고, 남은 것은 scope owner/freeze 승인이다. -- Ready for REQ Drafting: false — 주요 OQ는 해소되었으나 confirm-discovery 승인 전 -- Confirmed By: 미정 -- Confirmed At (KST): 미정 +- Handoff Decision: approved-for-req +- 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: true +- Confirmed By: Justin Ko +- Confirmed At (KST): 2026-07-14 16:35 KST diff --git a/docs/discovery/index.md b/docs/discovery/index.md index 57bdf6c..2133c99 100644 --- a/docs/discovery/index.md +++ b/docs/discovery/index.md @@ -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-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-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 |