docs(discovery): confirm manual ledger API discovery

This commit is contained in:
2026-07-14 16:36:43 +09:00
parent ecc269ad49
commit f9dce75d9e
2 changed files with 11 additions and 11 deletions
@@ -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
+1 -1
View File
@@ -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 |