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
+20 -8
View File
@@ -217,7 +217,7 @@ class Daemon:
transport = _build_transport(self.config)
self._transports.append(transport)
try:
transport.declare_topology()
transport.declare_topology(self.config.instance_key)
except Exception: # noqa: BLE001
pass
handler = make_intent_rpc_handler(
@@ -225,13 +225,14 @@ class Daemon:
slot_service=self.slot_service,
watchdog_store=self.watchdog,
)
transport.consume_rpc_forever(topology.INTENT_REQ_QUEUE, handler, self.stop)
transport.consume_rpc_forever(
topology.intent_queue(self.config.instance_key), handler, self.stop)
def _snapshot_rpc_loop(self) -> None:
transport = _build_transport(self.config)
self._transports.append(transport)
try:
transport.declare_topology()
transport.declare_topology(self.config.instance_key)
except Exception: # noqa: BLE001
pass
handler = make_snapshot_rpc_handler(
@@ -242,20 +243,22 @@ class Daemon:
watchdog_store=self.watchdog,
killswitch_store=self.killswitch_store,
)
transport.consume_rpc_forever(topology.SNAPSHOT_REQ_QUEUE, handler, self.stop)
transport.consume_rpc_forever(
topology.snapshot_queue(self.config.instance_key), handler, self.stop)
def _control_rpc_loop(self) -> None:
# REQ-043: operator control channel (pause/resume/list + kill_switch/resume_kill_switch).
transport = _build_transport(self.config)
self._transports.append(transport)
try:
transport.declare_topology()
transport.declare_topology(self.config.instance_key)
except Exception: # noqa: BLE001
pass
handler = make_control_rpc_handler(
self.pause_store, kill_switch_service=self.kill_switch,
)
transport.consume_rpc_forever(topology.CONTROL_REQ_QUEUE, handler, self.stop)
transport.consume_rpc_forever(
topology.control_queue(self.config.instance_key), handler, self.stop)
def _safety_sell_loop(self) -> None:
# REQ-037/038/039: forced_close / stop-loss·take-profit / market-close.
@@ -281,7 +284,7 @@ class Daemon:
)
self.execution.reconcile() # REQ-014 restart recovery
try:
self.event_publisher.declare_topology()
self.event_publisher.declare_topology(self.config.instance_key)
except Exception: # noqa: BLE001
_log.warning("event publisher topology declare failed", exc_info=True)
@@ -325,8 +328,17 @@ class Daemon:
def main() -> None: # pragma: no cover - process entrypoint
import argparse
logging.basicConfig(level=logging.INFO)
config = DaemonConfig.from_env()
parser = argparse.ArgumentParser(prog="trex-core-daemon")
parser.add_argument(
"--config", required=True,
help="per-instance TOML config path (instance_key, portfolio_hub_token). "
"Required — no default (REQ-048 / dcy-009 OQ-2).",
)
args = parser.parse_args()
config = DaemonConfig.from_config(args.config)
Daemon(config).run()