State 005 Learning Guide
Position In Learning Graph​
- Previous state(s): 004-postgres-database-replacement
- Dotted-line parent(s): none
- Next state(s): 006-observability-lgtm-compose
Convergence Metadata​
- Convergence state:
no - Convergence level:
none - Lineage role:
canonical - Nearest previous convergence:
none - Nearest next convergence:
none
Rendered Code​
- Generated branch: code/generated-state-005-messaging-nats-replacement
- Authoring branch (spec source): feature/agentic-renovation
Code Comparison With Previous State​
- Compare against
004-postgres-database-replacement: code/generated-state-004-postgres-database-replacement...code/generated-state-005-messaging-nats-replacement
Plain-English Code Delta​
- Added: Broker-backed subject contract for backend event publication/consumption.
- Added: Broker-backed websocket stream path for frontend subscriptions.
- Changed: Trade messaging transport changes:
- Changed: from Socket.IO channels in
trade-feed, - Changed: to NATS subjects in
nats-broker. - Changed: Event producer/consumer client logic in trade-service, trade-processor, and frontend stream subscriber.
- Changed: Frontend realtime position handling keeps baseline aggregate blotter semantics by upserting rows for existing securities.
- Removed: Dedicated Socket.IO messaging service role (
trade-feed) in target runtime topology.
Run This State​
./scripts/start-state-005-messaging-nats-replacement-generated.sh
Canonical Spec Links​
- State spec pack: /specs/messaging-nats-replacement
- Architecture: /specs/messaging-nats-replacement/system/architecture
- Flows / topology: /specs/messaging-nats-replacement/system/runtime-topology
- Research: link
- Data model: link
- Quickstart: link
- State ADR: link