docs(dcy-031): OPS-005 이벤트 발행 신뢰성 Discovery + REQ-091~094

운영팀 OPS-005(이벤트 발행 실패) 코드검증 → dcy-031 confirm-discovery. 스코프 B(재시도/강제재연결)+A(idle keepalive)+D(DLQ 가시성/emit 경보). REQ-091~094 draft-req → confirm-req 완료(4건 Approved). M2 트랙B. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VHtM5Ws1HKCKQ4JGi6GRb5
2026-06-19 21:21:19 +09:00
parent 9e35467336
commit bc79f60274
7 changed files with 603 additions and 1 deletions
@@ -0,0 +1,101 @@
+# req-094: 이벤트 발행 신뢰성 baseline 문서 정합 (runtime-flows / project-structure / operations 갱신)
+
+- Status: Approved
+- Type: Documentation
+- Priority: Medium
+- Owner: project maintainers
+
+## Intent
+- REQ-091(발행 재시도+재연결), REQ-092(idle keepalive), REQ-093(DLQ 가시성/emit 경보) 구현 후 `docs/runtime-flows.md`와 `docs/project-structure.md`의 `슬롯 이벤트 발행/구독` 및 `데몬 lifecycle` 흐름 기술이 구현과 어긋나게 된다. 또한 `docs/operations.md`에 DLQ 관측/경보 운영 절차가 신규 필요하다. 구현 완료 시점에 세 baseline 문서를 실제 구현과 정합시킨다.
+
+## Requirement
+- REQ-091~093 구현 완료 후, 아래 baseline 문서를 실제 구현 결과와 정합시킨다.
+  - `docs/runtime-flows.md`: `슬롯 이벤트 발행/구독` 흐름에 재시도/강제 재연결 경로, idle keepalive 동작, DLQ 유입 관측성을 반영한다.
+  - `docs/runtime-flows.md`: `데몬 lifecycle` 흐름에 keepalive 틱 연동(OQ-1 결정 결과)을 반영한다.
+  - `docs/project-structure.md`: keepalive 컴포넌트 또는 관측성 훅이 새 모듈/함수로 추가된 경우 구조 기술을 갱신한다.
+  - `docs/operations.md`: DLQ 가시성/경보(OQ-3 결정 결과 반영), 운영자 조치 절차, 경보 임계값 기준을 신규 기재한다.
+- 문서 갱신은 배포 wire 계약(`docs/interface-contract.md`)을 변경하지 않는다. AMQP 토폴로지·큐·exchange·라우팅 키 계약은 불변이며 본 REQ 범위 밖이다.
+
+## Acceptance Criteria
+1. Given REQ-091~093 구현이 완료된 상태에서, When `docs/runtime-flows.md`를 확인하면, Then `슬롯 이벤트 발행/구독` 항목이 재시도/강제 재연결 경로와 idle keepalive를 포함하여 실제 구현과 일치한다.
+2. Given OQ-1(keepalive 실행 위치)이 batch design에서 확정된 후, When `docs/runtime-flows.md`의 `데몬 lifecycle` 흐름을 확인하면, Then keepalive 틱 연동이 결정된 구현 방식대로 기술되어 있다.
+3. Given OQ-3(DLQ 가시성 구현 방식)이 batch design에서 확정된 후, When `docs/operations.md`를 확인하면, Then DLQ 유입/깊이 관측 방법과 운영자 조치 절차가 신규 기재되어 있다.
+4. Given `docs/project-structure.md`를 확인할 때, When keepalive 또는 관측성 훅이 신규 모듈로 추가된 경우, Then 해당 모듈이 구조 문서에 누락 없이 반영되어 있다.
+5. Given `docs/interface-contract.md`를 확인할 때, When 본 REQ 작업이 완료되면, Then AMQP 토폴로지·큐·exchange·라우팅 키 기술이 변경되지 않았다(wire 계약 무회귀).
+
+## Impacted Area
+- Docs: docs/runtime-flows.md(발행/keepalive 흐름 갱신), docs/project-structure.md(신규 컴포넌트 반영), docs/operations.md(DLQ 운영 절차 신규). docs/interface-contract.md는 불변.
+- Modules: 없음 (문서 전용 REQ).
+- Tests: 없음. 단, batch verification 시 문서-구현 정합 체크리스트 수동 검증.
+
+## Notes
+- 출처: dcy-031 §4(영향 범위 — 문서 영향), NFR-1(wire 계약 무회귀).
+- 이 REQ는 문서 전용이며 코드 변경 없이 구현된다. batch 편성 시 REQ-091~093와 같은 batch에 묶어 구현 완료 후 문서 갱신 단계로 처리한다.
+- OQ-1·OQ-3 결정 전에는 해당 항목(AC-2, AC-3)을 확정할 수 없다. batch design 완료 후 갱신 내용이 확정된다.
+- `docs/interface-contract.md`는 AMQP wire 계약 문서이며 trex-orb-v1·trex-tsl-v1에 파급 영향이 있다. 본 주기에서 wire 계약을 변경하지 않으므로 이 파일은 본 REQ 범위 밖이다(SDLC 교차 영향 사안 해당 없음).
+
+## Change Log
+
+### CHG-20260619-01
+- Date: 2026-06-19
+- Author: trex-core-dev
+
+#### Change Summary
+- dcy-031 §4(문서 영향 범위)로부터 최초 생성(Proposed). REQ-091~093 구현 후 baseline 정합 문서 REQ.
+
+#### Intent
+- 이벤트 발행 신뢰성 구현 후 runtime-flows / project-structure / operations baseline 문서 갱신을 backlog에 정규화한다.
+
+#### Acceptance Criteria Delta
+- Added:
+  - AC-1: runtime-flows 발행/keepalive 경로 정합
+  - AC-2: OQ-1 결정 결과 데몬 lifecycle 반영
+  - AC-3: OQ-3 결정 결과 operations.md DLQ 절차 신규
+  - AC-4: project-structure 신규 컴포넌트 반영
+  - AC-5: interface-contract.md 불변 확인
+- Updated: 없음
+- Removed: 없음
+
+#### Impacted Area Delta
+- Docs:
+  - docs/runtime-flows.md, docs/project-structure.md, docs/operations.md
+- Modules:
+  - 없음
+- Tests:
+  - 없음 (수동 검증)
+
+#### Delivery Trace Delta
+- Batches:
+  - none (draft-req 단계, batch 미편성)
+- Releases:
+  - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: confirm-req 후 REQ-091~093과 함께 단일 batch 편성 예정
+
+#### Validation Plan
+- batch verification 단계에서 docs/runtime-flows.md · docs/project-structure.md · docs/operations.md의 변경 내용이 구현과 일치하는지 수동 체크리스트로 확인. docs/interface-contract.md 불변 diff 확인.
+
+### CHG-20260619-02
+- Date: 2026-06-19
+- Author: 팀장 (confirm-req)
+
+#### Change Summary
+- Proposed → **Approved**. 문서 전용 REQ. 필수 필드 충족, source dcy-031 정합. AC-2/AC-3은 OQ-1/OQ-3 design 확정 후 충족(구현 후 정합 단계라 승인 비차단).
+
+#### Intent
+- delivery input 승인. REQ-091~093 구현 후 baseline 문서 정합을 같은 batch에서 처리.
+
+#### Acceptance Criteria Delta
+- Added: 없음
+- Updated: 없음
+- Removed: 없음
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: REQ-091~093과 함께 단일 batch 편성 예정