How mongodb-developer/frauddetector works
This Spring Boot demo seeds customer profiles and historical transactions, then generates live synthetic transactions, embeds them, and sends them through Kafka into MongoDB. MongoDB change streams trigger per-user vector similarity checks; the service marks transactions fraudulent when there are no matches or a match is already fraudulent. The graph preserves the documented runtime stages and major integrations. Some service-to-service links are supported by the README or SOURCE INDEX references; unsampled internals are not inferred beyond those relationships.
Main entry points: TransactionSeeder.java Historical seeder · TransactionProducer.java Live producer · CustomerSeeder.java Customer seeder · TransactionChangeStreamListener.java Change stream listener
Components 16
Generation and seeding
- Customer seeder
src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java - Historical seeder
src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java
Kafka messaging
- Live producer
src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java - Transactions topic
- Kafka consumer
src/main/java/com/mongodb/frauddetector/service/TransactionConsumer.java
Fraud evaluation
- Change stream listener
src/main/java/com/mongodb/frauddetector/service/TransactionChangeStreamListener.java - Vector fraud evaluator
src/main/java/com/mongodb/frauddetector/service/TransactionVectorSearchService.java
MongoDB persistence
- Customer repository
src/main/java/com/mongodb/frauddetector/repository/CustomerRepository.java - Transaction repository
src/main/java/com/mongodb/frauddetector/repository/TransactionRepository.java - MongoDB Atlas
Domain and embeddings
- Customer profile
src/main/java/com/mongodb/frauddetector/model/Customer.java - Transaction model
src/main/java/com/mongodb/frauddetector/model/Transaction.java - Transaction enums
src/main/java/com/mongodb/frauddetector/enums - Embedding generator
src/main/java/com/mongodb/frauddetector/service/EmbeddingGenerator.java
Other components
- Application startup
src/main/java/com/mongodb/frauddetector/FrauddetectorApplication.java - OpenAI embeddings
Connections 23
- Application startup → Customer seeder: starts
README.md - Application startup → Historical seeder: starts
README.md - Customer seeder → MongoDB Atlas: seeds customers
src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java - Customer seeder → Customer profile: creates profiles
src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java - Historical seeder → Customer repository: loads customers
src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java - Historical seeder → Transaction model: generates history
src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java - Historical seeder → Embedding generator: requests embeddings
src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java - Historical seeder → Transaction repository: saves history
src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java - Historical seeder → Change stream listener: starts listener
src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java - Live producer → Customer repository: loads profiles
src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java - Live producer → Transaction model: generates transactions
README.md - Live producer → Embedding generator: requests embeddings
src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java - Live producer → Transactions topic: publishes
README.md - Transactions topic → Kafka consumer: delivers messages
README.md - Kafka consumer → Transaction repository: persists transactions
src/main/java/com/mongodb/frauddetector/service/TransactionConsumer.java - Customer repository → MongoDB Atlas: reads and writes
README.md - Transaction repository → MongoDB Atlas: reads and writes
README.md - MongoDB Atlas → Change stream listener: notifies inserts
README.md - Change stream listener → Vector fraud evaluator: evaluates inserts
src/main/java/com/mongodb/frauddetector/service/TransactionChangeStreamListener.java - Vector fraud evaluator → MongoDB Atlas: searches and updates
src/main/java/com/mongodb/frauddetector/service/TransactionVectorSearchService.java - Embedding generator → OpenAI embeddings: requests vectors
README.md - Customer profile → Transaction enums: uses profile values
src/main/java/com/mongodb/frauddetector/model/Customer.java - Transaction model → Transaction enums: uses transaction values
src/main/java/com/mongodb/frauddetector/model/Transaction.java