How shreyshringare/conduit works
Conduit provides a TCP message broker with producer/consumer clients, durable partition logs, group offsets, topic management, rate limiting, metrics, and a RingWatch fraud-ring stream processor. The same repository also contains MerchantRisk, whose API-facing engine evaluates configured rules and velocity limits with per-merchant circuit breaking and optional event publishing. Edges reflect README descriptions or visible call/reference evidence; unsampled connections are omitted rather than inferred.
Main entry points: BrokerConnectionHandler.java Request handler · MerchantRiskEngine.java Risk engine · RingWatchConsumer.java RingWatch consumer · PartitionLog.java Partition log
Components 27
Broker clients
Broker runtime
- Wire codec
conduit-core/src/main/java/dev/conduit/protocol/FrameDecoder.java - Request handler
conduit-core/src/main/java/dev/conduit/broker/BrokerConnectionHandler.java - Broker server
conduit-core/src/main/java/dev/conduit/broker/Broker.java - Connection rate limits
conduit-core/src/main/java/dev/conduit/ratelimit/ConnectionRateLimits.java - Broker metrics
conduit-core/src/main/java/dev/conduit/metrics/BrokerMetrics.java
Log and offsets
- Topics and partitions
conduit-core/src/main/java/dev/conduit/topic/TopicManager.java - Partition log
conduit-core/src/main/java/dev/conduit/log/PartitionLog.java - Mapped segments
conduit-core/src/main/java/dev/conduit/log/SegmentFile.java - Sparse offset index
conduit-core/src/main/java/dev/conduit/log/SparseOffsetIndex.java - Log retention
conduit-core/src/main/java/dev/conduit/log/LogRetentionManager.java - Consumer offsets
conduit-core/src/main/java/dev/conduit/consumer/OffsetStore.java
RingWatch detection
- RingWatch consumer
conduit-client/src/main/java/dev/conduit/ringwatch/RingWatchConsumer.java - Incremental graph
conduit-core/src/main/java/dev/conduit/ringwatch/IncrementalGraph.java - Sliding-window SCC
conduit-core/src/main/java/dev/conduit/ringwatch/SlidingWindowSCC.java - Fraud ring event
conduit-core/src/main/java/dev/conduit/ringwatch/FraudRingDetectedEvent.java
MerchantRisk engine
- Risk API model
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/api/TransactionContext.java - Risk engine
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/MerchantRiskEngine.java - Rule loader
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/rules/RuleLoader.java - Rule evaluator
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/rules/RuleEvaluator.java - Velocity checker
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/velocity/SlidingWindowVelocityChecker.java - Merchant circuit breaker
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/circuit/MerchantCircuitBreaker.java - Risk event publisher
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/event/RiskEventPublisher.java
Other components
- Producer application
- Consumer application
- Risk API caller
Connections 32
- Producer application → Producer: sends messages
- Producer → Wire codec: encodes requests
conduit-client/src/main/java/dev/conduit/client/ConduitProducer.java - Consumer application → Consumer: polls records
- Consumer → Wire codec: encodes requests
conduit-client/src/main/java/dev/conduit/client/ConduitConsumer.java - Broker server → Request handler: dispatches connections
conduit-core/src/main/java/dev/conduit/broker/Broker.java - Request handler → Wire codec: decodes frames
conduit-core/src/main/java/dev/conduit/broker/BrokerConnectionHandler.java - Request handler → Topics and partitions: resolves partitions
conduit-core/src/main/java/dev/conduit/broker/BrokerConnectionHandler.java - Request handler → Connection rate limits: checks produce limits
conduit-core/src/main/java/dev/conduit/broker/BrokerConnectionHandler.java - Request handler → Consumer offsets: stores offsets
conduit-core/src/main/java/dev/conduit/broker/BrokerConnectionHandler.java - Request handler → Broker metrics: records metrics
conduit-core/src/main/java/dev/conduit/broker/BrokerConnectionHandler.java - Topics and partitions → Partition log: creates and returns
conduit-core/src/main/java/dev/conduit/topic/TopicManager.java - Partition log → Mapped segments: appends and reads
conduit-core/src/main/java/dev/conduit/log/PartitionLog.java - Partition log → Sparse offset index: indexes offsets
- Log retention → Partition log: manages retention
conduit-core/src/main/java/dev/conduit/log/LogRetentionManager.java - Request handler → Partition log: appends or fetches
conduit-core/src/main/java/dev/conduit/broker/BrokerConnectionHandler.java - Consumer → Request handler: requests fetch and commit
- Risk API caller → Risk engine: evaluates transaction
- Risk engine → Risk API model: builds context
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/MerchantRiskEngine.java - Risk engine → Rule loader: loads configured rules
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/MerchantRiskEngine.java - Risk engine → Rule evaluator: evaluates rules
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/MerchantRiskEngine.java - Rule loader → Rule evaluator: provides rule definitions
- Risk engine → Velocity checker: checks velocity
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/MerchantRiskEngine.java - Risk engine → Merchant circuit breaker: checks and records outcomes
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/MerchantRiskEngine.java - Risk engine → Risk event publisher: publishes decisions
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/MerchantRiskEngine.java - Merchant circuit breaker → Risk event publisher: publishes circuit events
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/circuit/MerchantCircuitBreaker.java - Risk event publisher → Producer: publishes via client
merchantrisk-core/src/main/java/dev/conduit/merchantrisk/event/RiskEventPublisher.java - RingWatch consumer → Consumer: consumes transactions
conduit-client/src/main/java/dev/conduit/ringwatch/RingWatchConsumer.java - RingWatch consumer → Incremental graph: adds transaction edges
conduit-client/src/main/java/dev/conduit/ringwatch/RingWatchConsumer.java - Sliding-window SCC → Incremental graph: analyzes graph
conduit-core/src/main/java/dev/conduit/ringwatch/SlidingWindowSCC.java - RingWatch consumer → Sliding-window SCC: detects cycles
conduit-client/src/main/java/dev/conduit/ringwatch/RingWatchConsumer.java - RingWatch consumer → Fraud ring event: creates alert event
conduit-client/src/main/java/dev/conduit/ringwatch/RingWatchConsumer.java - RingWatch consumer → Producer: publishes alert and DLQ
conduit-client/src/main/java/dev/conduit/ringwatch/RingWatchConsumer.java