trex-core/docs/srs/Documentation/req-094_event-publisher-reliability-baseline-alignment.md

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