feat(multi-instance): dcy-009 BAT-013 — RabbitMQ 다중 인스턴스 토폴로지 (REQ-048~051)

dcy-009(다중 인스턴스 RabbitMQ 토폴로지) 전체 SDLC: draft-req → confirm-req → draft-batch(BAT-013) → run-batch-delivery → confirm-req-implemented. - REQ-048 (Configuration): DaemonInstanceConfig.from_toml + DaemonConfig.from_config (env 병합, portfolio_hub_token 주입) + 데몬 --config 필수 argparse + .gitignore 인스턴스 TOML + config/instance.example.toml - REQ-049 (Interface): topology 동적 큐명 빌더 intent/snapshot/control_queue(instance_key) — default=리터럴 큐명(하위호환), named=`{base}.{instance_key}` + daemon per-instance 구독 - REQ-050 (Integration): trex.direct(topic)/trex.broadcast(fanout) exchange + declare_topology(instance_key) per-instance binding + control dual binding + direct_routing_key - REQ-051 (Documentation): interface-contract/runtime-flows/project-structure 정합 하위호환: instance_key="default" → 기존 리터럴 큐명·RPC 경로 무회귀(FR-5). split-brain 방지(NFR-3): 인스턴스 전용 큐. 민감값(NFR-4): TOML + gitignore. 검증: 신규 9 단위 + RabbitMQ 라우팅 2, 단위 271 passed, 인프라 게이트 301 passed(directed 격리 S-2 + broadcast dual S-3 + default 무회귀 S-4), ruff clean. REQ-048~051 Implemented, BAT-013 release-candidate. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-07 15:10:36 +09:00
parent 7e23648489
commit 9f83c64a40
24 changed files with 1223 additions and 85 deletions
@@ -0,0 +1,144 @@
+# req-051: multi-instance topology baseline 문서 정합
+
+- Status: Implemented
+- Type: Documentation
+- Priority: Medium
+- Owner: project maintainers
+
+## Intent
+
+dcy-009(다중 인스턴스 RabbitMQ 토폴로지) 구현(REQ-048~050) 완료 후 `docs/runtime-flows.md`, `docs/project-structure.md`, `docs/interface-contract.md` 세 baseline 문서를 multi-instance topology + TOML 기반 기동 기준으로 정합시킨다(dcy-009 FR-6).
+
+## Requirement
+
+- `docs/interface-contract.md` 에 반영한다:
+  - routing key 계약: directed = `{instance_key}.{channel_type}`(`trex.direct` topic), broadcast = `trex.broadcast`(fanout, 전역 control)
+  - 인스턴스별 큐명 규칙(`{base}.{instance_key}`, default = 리터럴 하위호환)
+- `docs/runtime-flows.md` 에 반영한다:
+  - TOML(`--config`) 기반 기동 절차(instance_key/portfolio_hub_token 로드)
+  - multi-instance directed vs broadcast 라우팅 흐름, split-brain 방지(인스턴스 전용 큐) 설명
+- `docs/project-structure.md` 에 반영한다:
+  - `topology.py` 역할 변경(고정 상수 → 동적 큐명/exchange 빌더)
+  - 설정 계층(TOML + env 병합), `DaemonInstanceConfig`, `--config` 진입점
+  - `trex.direct`/`trex.broadcast` exchange
+
+## Acceptance Criteria
+
+1. Given `docs/interface-contract.md`, When routing key 규칙을 찾으면, Then directed(`{instance_key}.{channel_type}`)와 broadcast(fanout) 계약 + 인스턴스 큐명 규칙이 명시되어 있다.
+2. Given `docs/runtime-flows.md`, When 기동/라우팅 흐름을 찾으면, Then TOML(`--config`) 기동 + directed/broadcast 라우팅 + split-brain 방지가 서술되어 있다.
+3. Given `docs/project-structure.md`, When topology/설정 항목을 찾으면, Then 동적 큐명 빌더 + `DaemonInstanceConfig`/`--config` + `trex.direct`/`trex.broadcast` 가 반영되어 있다.
+
+## Impacted Area
+
+- Docs:
+  - `docs/interface-contract.md`
+  - `docs/runtime-flows.md`
+  - `docs/project-structure.md`
+- Modules: 없음 (문서 전용)
+- Tests: 없음
+
+## Notes
+
+- REQ-048~050 구현 완료 후 batch verification 단계에서 최신 구현 상태를 반영해 수행한다(REQ-042/047 선례).
+- baseline 갱신이므로 `bootstrap-baseline` 선행 불필요.
+
+## Change Log
+
+### CHG-20260607-01
+
+- Date: 2026-06-07
+- Author: Justin Ko
+
+#### Change Summary
+
+- dcy-009(confirmed) → REQ-051 초안 생성.
+
+#### Intent
+
+- multi-instance 구현 후 세 baseline 문서 정합(FR-6)을 Documentation REQ 로 정규화.
+
+#### Acceptance Criteria Delta
+
+- Added: AC-1~3 전체
+
+#### Impacted Area Delta
+
+- Docs: interface-contract.md, runtime-flows.md, project-structure.md
+
+#### Delivery Trace Delta
+
+- Batches: none (미할당)
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: confirm-req 로 승인 (REQ-048~050 구현 batch 이후 연계).
+
+### CHG-20260607-02
+
+- Date: 2026-06-07
+- Author: Justin Ko
+
+#### Change Summary
+
+- Proposed → Approved (confirm-req).
+
+#### Intent
+
+- 승인 게이트 통과: 필수 필드·구체 AC·Impacted Area·Change Log 완비. baseline 정합 문서 REQ로 REQ-048~050 구현 후 verification 단계 수행.
+
+#### Acceptance Criteria Delta
+
+- (변경 없음)
+
+#### Impacted Area Delta
+
+- (변경 없음)
+
+#### Delivery Trace Delta
+
+- Batches: none (미할당)
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: suggest-batch-reqs / draft-batch 로 delivery 편성(REQ-048~050 이후 연계).
+
+### CHG-20260607-03
+
+- Date: 2026-06-07
+- Author: Justin Ko
+
+#### Change Summary
+
+- Status Approved → Implemented (confirm-req-implemented, 근거 batch BAT-013 release-candidate).
+
+#### Intent
+
+- BAT-013 에서 baseline 3문서 정합 완료: interface-contract(multi-instance routing: 큐명 규칙·trex.direct/trex.broadcast·routing key), runtime-flows(`--config` 기동 + multi-instance 라우팅 흐름 + split-brain 방지), project-structure(동적 큐명 빌더·DaemonInstanceConfig/`--config`·exchange). AC-1~3 충족.
+
+#### Acceptance Criteria Delta
+
+- (변경 없음)
+
+#### Impacted Area Delta
+
+- (변경 없음)
+
+#### Delivery Trace Delta
+
+- Batches: BAT-013 (release-candidate)
+- Releases: none
+
+#### Revalidation Impact
+
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current (Implemented)
+- Follow-up Action: draft-release 로 BAT-013 배포 편성.