# req-090: 관측성 baseline 문서 정합 — 로깅/관측성·PnL 조회 흐름

- Status: Implemented
- Type: Documentation
- Priority: Medium
- Owner: project maintainers

## Intent
- dcy-029가 런타임 로깅·청산 분류·PnL 조회 흐름을 바꾸므로 baseline 문서를 실제 구현과 정합시킨다. (dcy-029 FR-6)

## Requirement
- `docs/runtime-flows.md`에 다음 흐름을 추가/갱신한다:
  - 구조화 로깅 기반(ISO8601 KST 타임스탬프·레벨·JSON/Loki·correlation id, REQ-084).
  - 주문 결과 로깅(submit/fill/reject 일관 라인, REQ-085) 및 거부 ERROR 가시성(REQ-087).
  - 청산 reason+actor 동반 노출(REQ-086).
  - 운영자 조회 CLI(보유/오늘 체결/실현 PnL/대기 주문, REQ-088).
- `docs/project-structure.md`에 신규 로깅 모듈(REQ-084) 책임을 반영한다.
- baseline 문서는 전체 흐름을 복제하지 않고 구현된 제약·진입점만 정합 수준으로 기술한다.

## Acceptance Criteria
1. Given runtime-flows.md, When 갱신 후, Then 구조화 로깅·correlation id 흐름이 기술돼 있다.
2. Given runtime-flows.md, When 갱신 후, Then 주문 결과 로깅·거부 ERROR·청산 reason+actor·PnL 조회 CLI가 기술돼 있다.
3. Given project-structure.md, When 갱신 후, Then 신규 로깅 모듈이 모듈 트리에 반영돼 있다.
4. Given baseline 문서, When 확인, Then 실제 구현(REQ-084~088)과 모순이 없다.

## Impacted Area
- Docs: docs/runtime-flows.md, docs/project-structure.md
- Modules: 없음(문서)
- Tests: 없음(문서 — verification은 정합 리뷰)

## Notes
- 본 REQ는 P1 batch 구현 완료 후 정합한다(REQ-084~088 결과 반영).
- 출처: dcy-029 FR-6.

## Change Log

### CHG-20260616-01
- Date: 2026-06-16
- Author: Justin Ko

#### Change Summary
- dcy-029 FR-6로부터 최초 생성(Proposed).

### CHG-20260616-02
- Date: 2026-06-16
- Author: Justin Ko
- Type: status
- Summary: Proposed → **Approved** (confirm-req). 필수 필드·구체 AC 충족, source dcy-029(confirmed, Open OQ 0) 정합. dcy-029 P0/P1 batch 편성 예정.

### CHG-20260616-IMPL
- Date: 2026-06-16
- Author: Justin Ko
- Type: status
- Summary: Approved → **Implemented** (confirm-req-implemented, BAT-046 release-candidate, dcy-029 P1). 근거: 단위/문서 AC 매핑(REQ-086 reason+actor 로그·interface-contract; REQ-088 operator_report 집계·net PnL·KST 경계·CLI report; REQ-089 docs/operations.md 4영역; REQ-090 runtime-flows·project-structure 정합). 14 passed(report+safety_sell), 전체 537 passed/47 skipped 회귀 0, ruff clean. report direct-DB·Loki 실 적재는 release 운영 검증 위임. Blocking Issues 없음.