How jessicapersou/fraud-detection-sdd works
This is a real-time fraud detection system built from three Kafka-connected services. A client submits an idempotent transaction; the transaction service stores it with an outbox event, fraud analysis evaluates frequency and amount rules and emits alerts for medium/high risk, and notification processing records delivery attempts and sends through a provider. The README documents the cross-service event flow; sampled use cases show their internal calls. Several adapters and listeners are listed in the tree but were not sampled, so their wiring is not asserted beyond documented relationships.
Main entry points: AnalyzeTransactionService.java Analyze transaction · ReceiveTransactionService.java Receive transaction · ProcessFraudAlertService.java Process alert · OutboxPublisher.java Outbox publisher
Components 20
Transaction intake
- Transaction REST
transaction-service/src/main/java/com/persou/antifraud/transaction/adapter/in/rest/TransactionController.java - Receive transaction
transaction-service/src/main/java/com/persou/antifraud/transaction/application/usecase/ReceiveTransactionService.java - Transaction store
transaction-service/src/main/java/com/persou/antifraud/transaction/adapter/out/persistence/JpaTransactionRepositoryAdapter.java - Idempotency store
transaction-service/src/main/java/com/persou/antifraud/transaction/adapter/out/persistence/JpaIdempotencyRepositoryAdapter.java - Outbox store
transaction-service/src/main/java/com/persou/antifraud/transaction/adapter/out/persistence/JpaOutboxRepositoryAdapter.java - Outbox publisher
transaction-service/src/main/java/com/persou/antifraud/transaction/adapter/out/kafka/OutboxPublisher.java
Fraud analysis
- Transaction listener
fraud-service/src/main/java/com/persou/antifraud/fraud/adapter/in/kafka/TransactionCreatedListener.java - Analyze transaction
fraud-service/src/main/java/com/persou/antifraud/fraud/application/usecase/AnalyzeTransactionService.java - Fraud rules
fraud-service/src/main/java/com/persou/antifraud/fraud/domain/service/FraudRuleEvaluator.java - Frequency history
fraud-service/src/main/java/com/persou/antifraud/fraud/adapter/out/persistence/JpaTransactionFrequencyAdapter.java - Analysis store
fraud-service/src/main/java/com/persou/antifraud/fraud/adapter/out/persistence/JpaFraudAnalysisAdapter.java - Alert publisher
fraud-service/src/main/java/com/persou/antifraud/fraud/adapter/out/kafka/KafkaFraudAlertPublisher.java
Alert notifications
- Fraud alert listener
notification-service/src/main/java/com/persou/antifraud/notification/adapter/in/kafka/FraudAlertListener.java - Process alert
notification-service/src/main/java/com/persou/antifraud/notification/application/usecase/ProcessFraudAlertService.java - Notification store
notification-service/src/main/java/com/persou/antifraud/notification/adapter/out/persistence/JpaNotificationRepositoryAdapter.java - Notification provider
notification-service/src/main/java/com/persou/antifraud/notification/adapter/out/mail/SmtpNotificationProvider.java
Event contracts
- Transaction event
event-contracts/src/main/java/com/persou/antifraud/contracts/TransactionCreatedEvent.java - Fraud alert event
event-contracts/src/main/java/com/persou/antifraud/contracts/FraudDetectedEvent.java
Other components
- API client
- Kafka
Connections 18
- API client → Transaction REST: submits transaction
README.md - Transaction REST → Receive transaction: invokes
transaction-service/src/main/java/com/persou/antifraud/transaction/adapter/in/rest/TransactionController.java - Receive transaction → Idempotency store: checks and reserves
transaction-service/src/main/java/com/persou/antifraud/transaction/application/usecase/ReceiveTransactionService.java - Receive transaction → Transaction store: saves transaction
transaction-service/src/main/java/com/persou/antifraud/transaction/application/usecase/ReceiveTransactionService.java - Receive transaction → Outbox store: saves event
transaction-service/src/main/java/com/persou/antifraud/transaction/application/usecase/ReceiveTransactionService.java - Outbox publisher → Outbox store: publishes pending
- Outbox publisher → Kafka: publishes event
README.md - Kafka → Transaction listener: delivers event
README.md - Transaction listener → Analyze transaction: dispatches
- Analyze transaction → Frequency history: records and counts
fraud-service/src/main/java/com/persou/antifraud/fraud/application/usecase/AnalyzeTransactionService.java - Analyze transaction → Fraud rules: evaluates findings
fraud-service/src/main/java/com/persou/antifraud/fraud/application/usecase/AnalyzeTransactionService.java - Analyze transaction → Analysis store: stores analysis
fraud-service/src/main/java/com/persou/antifraud/fraud/application/usecase/AnalyzeTransactionService.java - Analyze transaction → Alert publisher: publishes qualifying alert
fraud-service/src/main/java/com/persou/antifraud/fraud/application/usecase/AnalyzeTransactionService.java - Alert publisher → Kafka: publishes alert
README.md - Kafka → Fraud alert listener: delivers alert
README.md - Fraud alert listener → Process alert: dispatches
- Process alert → Notification store: records attempts
notification-service/src/main/java/com/persou/antifraud/notification/application/usecase/ProcessFraudAlertService.java - Process alert → Notification provider: sends notification
notification-service/src/main/java/com/persou/antifraud/notification/application/usecase/ProcessFraudAlertService.java