docs(REQ-110): change-req CHG-20260626-02 — 매수 fee 편입 반영(NFR-2 엄격, buy_fee_only_assets 제거)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHtM5Ws1HKCKQ4JGi6GRb5

docs/srs/Interface/req-110_operator-report-wac-realized-pnl.md

@@ -10,21 +10,21 @@
 - 현재 `operator_report.py`(REQ-088)의 `realized_pnl(trades)`은 당일 net 현금흐름(`Σ매도대금 − Σ매수대금 − 수수료 − 세금`)을 사용한다. 중장기 인스턴스에서 전일 매수→당일 매도 시 cost basis가 반영되지 않아 실현손익이 왜곡된다. portfolio-hub WAC API(`/pnl/realized`)를 소비해 전 인스턴스 공통으로 정확한 실현손익을 산출하고 리포트에 표시한다. (dcy-035 FR-2, FR-3, FR-4, OQ-1=전 인스턴스 WAC 통일, NFR-2)
 
 ## Requirement
-- `operator_report.py`의 `OperatorReport`에 WAC 실현손익 관련 필드를 추가한다: `realized_pnl_wac: float`, `realized_pnl_wac_by_asset: dict[str, float]`, `buy_fee_only_assets: dict[str, float]`(매수만 한 기간의 수수료 비용 별도), `data_completeness_warning: bool`.
+- `operator_report.py`의 `OperatorReport`에 WAC 실현손익 관련 필드를 추가한다: `realized_pnl_wac: float`, `realized_pnl_wac_by_asset: dict[str, float]`, `data_completeness_warning: bool`. (CHG-20260626-02: `buy_fee_only_assets` 필드 제거 — 아래 매수 fee 편입 결정 반영.)
 - 운영 리포트(`trex-core report` CLI)는 당일 net 대신 portfolio-hub WAC 실현손익(`/pnl/realized`)을 **전 인스턴스 공통**으로 사용해 실현손익을 표시한다.
-- 매도가 있는 자산: WAC 기준 실현손익(`(매도가 − WAC) × qty − fee − tax`)을 자산별로 분해해 출력한다.
-- 매수만 한 기간(해당 자산의 매도 0): 실현손익 0으로 표시하고, **수수료 비용(`buy_fee_only_assets`)을 별도 항목으로 명시**한다. 수수료 출처는 `ledger_outbox` 당일 거래(기존 경로 재사용; OQ-3 deferred).
+- 매도가 있는 자산: WAC 기준 실현손익(`(매도가 − WAC) × qty − fee − tax`)을 자산별로 분해해 출력한다. portfolio-hub WAC는 **매수 수수료를 cost basis에 편입**(REQ-041 CHG-20260626-01)하므로 이 실현손익은 매수·매도 fee를 모두 정확히 반영한다.
+- 매수만 한 기간(해당 자산의 매도 0): 실현손익 0으로 표시한다. **매수 수수료는 cost basis(WAC)에 편입되어 매도 시 실현**되므로, 별도 "수수료 비용" 라인은 두지 않는다(CHG-20260626-02 — 별도 라인은 매도 시 실현분과 이중계상되어 제거).
 - portfolio-hub 응답의 `data_completeness_warning: true` 시 리포트 출력에 경고를 표면화한다(텍스트/JSON 모두 포함).
 - `render_text` / `render_json`을 WAC 모드에 맞게 갱신한다.
 - CLI `report` 서브커맨드에서 portfolio-hub 설정(`cfg.portfolio_hub.base_url`)이 있을 때 WAC 경로를 사용하고, 미설정이면 REQ-111 degrade 경로로 위임한다.
 
 ## Acceptance Criteria
 1. Given 전일 매수 + 당일 매도 시나리오(portfolio-hub `/pnl/realized` 모킹 응답), When `report` 실행, Then 실현손익이 WAC 기준 정확값(`(매도가 − WAC) × qty − fee − tax`)으로 표시되고 당일 net 왜곡값과 다르다.
-2. Given 동일 날 매수 + 매도(일중) 시나리오(WAC = 당일 매수가), When `report` 실행, Then WAC 실현손익 == 기존 당일 net과 수치 일치한다(NFR-2 회귀 보장).
-3. Given 매수만 한 기간(매도 0), When `report` 실행, Then 실현손익 0 + `buy_fee_only_assets` 수수료 비용이 별도 항목으로 표시된다.
+2. Given 동일 날 **닫힌** 매수+매도(일중, buy_qty==sell_qty) 시나리오, When `report` 실행, Then WAC 실현손익이 기존 당일 net과 **정확히 일치**한다(`==`, NFR-2 회귀 보장). (CHG-20260626-02: 매수 fee 편입(REQ-041)으로 일중 닫힌 거래는 WAC==net이 엄격 성립 — `≈`가 아니라 `==`로 단언.)
+3. Given 매수만 한 기간(매도 0), When `report` 실행, Then 실현손익 0으로 표시되고 별도 수수료 비용 라인은 없다(매수 fee는 cost basis 편입, 매도 시 실현). (CHG-20260626-02: 기존 `buy_fee_only_assets` 별도 라인 제거.)
 4. Given portfolio-hub 응답에 `data_completeness_warning: true`, When `report` 실행, Then 텍스트 출력과 `--json` 출력 모두에 completeness 경고가 표시된다.
 5. Given 자산별 실현손익 분해, When `report` 실행, Then `realized_pnl_wac_by_asset`에 자산(symbol)별 WAC 실현손익이 분해된다.
-6. Given `--json` 플래그, When `report` 실행, Then `render_json` 출력에 `realized_pnl_wac`, `realized_pnl_wac_by_asset`, `buy_fee_only_assets`, `data_completeness_warning` 필드가 포함된다.
+6. Given `--json` 플래그, When `report` 실행, Then `render_json` 출력에 `realized_pnl_wac`, `realized_pnl_wac_by_asset`, `data_completeness_warning` 필드가 포함된다. (CHG-20260626-02: `buy_fee_only_assets` 제거.)
 7. Given portfolio-hub `base_url` 미설정(cfg.portfolio_hub None 또는 base_url 미정의), When `report` 실행, Then REQ-111 degrade 경로로 처리된다(에러 표시).
 
 ## Impacted Area
@@ -48,6 +48,34 @@
 
 ## Change Log
 
+### CHG-20260626-02
+- Date: 2026-06-26
+- Author: 팀장 (Claude)
+
+#### Change Summary
+- 사장님 결정(2026-06-26): portfolio-hub WAC에 매수 수수료 편입(REQ-041 CHG-20260626-01). 그 결과 (1) 일중 닫힌 거래에서 WAC 실현손익 == 당일 net이 **엄격히** 성립 → AC-2를 `≈`에서 `==`로 강화. (2) 매수 fee가 cost basis에 편입되므로 매수전용일의 별도 "수수료 비용" 라인(`buy_fee_only_assets`)은 매도 시 실현분과 **이중계상** → 제거.
+
+#### Intent
+- 매수 fee 편입 결정과 정합: 단일 정확 실현손익 숫자, NFR-2 엄격 성립, 이중계상 제거.
+
+#### Acceptance Criteria Delta
+- Updated:
+  - AC-2: 일중 닫힌 거래 WAC==net **엄격 일치**(`==`)로 강화.
+  - AC-3: 매수전용일 별도 수수료 비용 라인 제거(매수 fee는 cost basis 편입·매도 시 실현).
+  - AC-6: `--json` 필드에서 `buy_fee_only_assets` 제거.
+- Removed:
+  - `OperatorReport.buy_fee_only_assets` 필드 및 관련 산출/렌더.
+
+#### Impacted Area Delta
+- Modules: operator_report.py(buy_fee_only_assets 제거, NFR-2 테스트 강화), cli.py(해당 표시 제거)
+- Tests: NFR-2 일중 회귀 테스트를 `==` 단언으로 강화, buy_fee_only_assets 테스트 제거/대체
+
+#### Revalidation Impact
+- Reverification Needed: yes (BAT-052 보정 후 재검증)
+- Existing Implementation Invalidated: partial (BAT-052 구현 중 buy_fee_only_assets 부분)
+- Status Recommendation: keep-current (Approved)
+- Follow-up Action: BAT-052 보정 → 재QC → confirm-batch-verification
+
 ### CHG-20260626-01
 - Date: 2026-06-26
 - Author: trex-core-dev