# req-094: 이벤트 발행 신뢰성 baseline 문서 정합 (runtime-flows / project-structure / operations 갱신)

- Status: Implemented
- 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 편성 예정