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>
This commit is contained in:
2026-06-07 15:10:36 +09:00
co-authored by Claude Opus 4.8
parent 7e23648489
commit 9f83c64a40
24 changed files with 1223 additions and 85 deletions
@@ -0,0 +1,64 @@
# BAT-013 Verification
- Status: verified
- Batch: BAT-013
## Acceptance Mapping
> 구현 완료 후 각 AC 에 evidence 매핑. 아래는 계획 골격.
### REQ-048 (TOML 로더 + --config)
| AC | Evidence (예정) |
|----|---------|
| AC-1 from_toml 파싱 | 로더 단위 |
| AC-2 --config 누락 종료 | 진입점 단위/검사 |
| AC-3 token 주입 | 로더 단위(S-5) |
| AC-4 필수 필드 누락 오류 | 로더 단위 |
| AC-5 .gitignore TOML | gitignore 확인 |
| AC-6 token 로그 미노출 | 코드/로그 검사 |
### REQ-049 (동적 큐명 + 하위호환)
| AC | Evidence (예정) |
|----|---------|
| AC-1 named suffix | 큐명 빌더 단위 |
| AC-2 default 리터럴 | 동일 |
| AC-3 declare named 큐 | 인프라 게이트 |
| AC-4 default 회귀 없음 | 전체 pytest |
| AC-5 per-thread/스레드 수 | daemon 검사 |
| AC-6 인스턴스 격리 | 인프라 게이트/e2e |
### REQ-050 (exchange + binding)
| AC | Evidence (예정) |
|----|---------|
| AC-1 direct/broadcast 선언 | 인프라 게이트 |
| AC-2 direct binding | 인프라 게이트 |
| AC-3 routing key 빌더 | 단위 |
| AC-4 directed 격리 | 인프라 게이트(2큐) |
| AC-5 broadcast dual 전달 | 인프라 게이트(2큐) |
| AC-6 default 회귀 | 전체 pytest |
### REQ-051 (baseline 정합)
| AC | Evidence (예정) |
|----|---------|
| AC-1 interface-contract routing key | 문서 diff |
| AC-2 runtime-flows 기동/라우팅 | 문서 diff |
| AC-3 project-structure 동적큐/설정/exchange | 문서 diff |
## Evidence
- Test:
- REQ-048 로더 6 단위(from_toml/필수 누락/token 주입 S-5/default ik/`--config` 누락 subprocess 종료/gitignore) green.
- REQ-049/050 토폴로지 3 단위(builders default vs named/routing key) + 인프라 게이트 2(directed 격리 S-2 / broadcast dual S-3) green.
- 단위 전체 회귀: `271 passed / 30 skipped`(`::test_sandbox_token_and_submit` deselect).
- 인프라 게이트(PG trex_core_test + RabbitMQ): `301 passed`(directed 라우팅 격리 + broadcast dual + default 무회귀 S-4 + 마이그레이션 round-trip 포함).
- `ruff check trex_core tests` → All passed.
- Logs: `271 passed, 30 skipped` / `301 passed ... ~15s`.
## Carried-Over / e2e
- S-1(named 큐 선언)·S-2(directed 격리)·S-3(broadcast dual): RabbitMQ 인프라 게이트 통합 테스트로 확인.
- S-4(default 무회귀): 전체 pytest 301 passed.
- S-5(TOML token 주입): 로더 단위.
- (이월, 비차단) 실 2-인스턴스 동시 기동 manual e2e: 실 다중 인스턴스 운영 시점 확인.
## Result
- Ready for Release: true
- Blocking Issues:
- 없음. 제어 큐 rename(BAT-012 R-1)·old 큐 자연 소멸(OQ-1)·strategy publish 변경(Out of Scope)·2-인스턴스 manual e2e 는 비차단(인프라 게이트 통합으로 핵심 라우팅 검증됨).