# mongodb-developer/frauddetector architecture

> Architecture diagram of the GitHub repository mongodb-developer/frauddetector, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mongodb-developer/frauddetector
- Repository: https://github.com/mongodb-developer/frauddetector

## Overview

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: [`src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java`](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java) (Historical seeder), [`src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java`](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java) (Live producer), [`src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java`](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java) (Customer seeder), [`src/main/java/com/mongodb/frauddetector/service/TransactionChangeStreamListener.java`](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionChangeStreamListener.java) (Change stream listener)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_generation["Generation and seeding"]
  node_customer_seed["Customer seeder"]
  node_transaction_seed["Historical seeder"]
end

subgraph group_messaging["Kafka messaging"]
  node_producer["Live producer"]
  node_kafka["Transactions topic"]
  node_consumer["Kafka consumer"]
end

subgraph group_fraud["Fraud evaluation"]
  node_change_stream["Change stream listener"]
  node_vector_search["Vector fraud evaluator"]
end

subgraph group_persistence["MongoDB persistence"]
  node_customer_repo["Customer repository"]
  node_transaction_repo["Transaction repository"]
  node_mongo[("MongoDB Atlas")]
end

subgraph group_domain["Domain and embeddings"]
  node_customer_model["Customer profile<br/>[Customer.java]"]
  node_transaction_model["Transaction model<br/>[Transaction.java]"]
  node_enums["Transaction enums"]
  node_embedding["Embedding generator"]
end

node_startup["Application startup"]
node_openai["OpenAI embeddings"]

node_startup -->|"starts"| node_customer_seed
node_startup -->|"starts"| node_transaction_seed
node_customer_seed -->|"seeds customers"| node_mongo
node_customer_seed -->|"creates profiles"| node_customer_model
node_transaction_seed -->|"loads customers"| node_customer_repo
node_transaction_seed -->|"generates history"| node_transaction_model
node_transaction_seed -->|"requests embeddings"| node_embedding
node_transaction_seed -->|"saves history"| node_transaction_repo
node_transaction_seed -->|"starts listener"| node_change_stream
node_producer -->|"loads profiles"| node_customer_repo
node_producer -->|"generates transactions"| node_transaction_model
node_producer -->|"requests embeddings"| node_embedding
node_producer -->|"publishes"| node_kafka
node_kafka -->|"delivers messages"| node_consumer
node_consumer -->|"persists transactions"| node_transaction_repo
node_customer_repo -->|"reads and writes"| node_mongo
node_transaction_repo -->|"reads and writes"| node_mongo
node_mongo -->|"notifies inserts"| node_change_stream
node_change_stream -->|"evaluates inserts"| node_vector_search
node_vector_search -->|"searches and updates"| node_mongo
node_embedding -->|"requests vectors"| node_openai
node_customer_model -->|"uses profile values"| node_enums
node_transaction_model -->|"uses transaction values"| node_enums

click node_startup "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/FrauddetectorApplication.java"
click node_customer_seed "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java"
click node_transaction_seed "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java"
click node_producer "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java"
click node_consumer "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionConsumer.java"
click node_change_stream "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionChangeStreamListener.java"
click node_vector_search "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionVectorSearchService.java"
click node_customer_repo "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/repository/CustomerRepository.java"
click node_transaction_repo "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/repository/TransactionRepository.java"
click node_customer_model "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/model/Customer.java"
click node_transaction_model "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/model/Transaction.java"
click node_enums "https://github.com/mongodb-developer/frauddetector/tree/master/src/main/java/com/mongodb/frauddetector/enums"
click node_embedding "https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/EmbeddingGenerator.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_customer_seed,node_transaction_seed toneBlue
class node_producer,node_kafka,node_consumer toneAmber
class node_change_stream,node_vector_search toneMint
class node_customer_repo,node_transaction_repo,node_mongo toneRose
class node_customer_model,node_transaction_model,node_enums,node_embedding,node_openai toneIndigo
class node_startup toneTeal
```

## Components

### Generation and seeding

- [Customer seeder](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java): `src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java`
- [Historical seeder](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java): `src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java`

### Kafka messaging

- [Live producer](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java): `src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java`
- **Transactions topic**
- [Kafka consumer](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionConsumer.java): `src/main/java/com/mongodb/frauddetector/service/TransactionConsumer.java`

### Fraud evaluation

- [Change stream listener](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionChangeStreamListener.java): `src/main/java/com/mongodb/frauddetector/service/TransactionChangeStreamListener.java`
- [Vector fraud evaluator](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/TransactionVectorSearchService.java): `src/main/java/com/mongodb/frauddetector/service/TransactionVectorSearchService.java`

### MongoDB persistence

- [Customer repository](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/repository/CustomerRepository.java): `src/main/java/com/mongodb/frauddetector/repository/CustomerRepository.java`
- [Transaction repository](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/repository/TransactionRepository.java): `src/main/java/com/mongodb/frauddetector/repository/TransactionRepository.java`
- **MongoDB Atlas**

### Domain and embeddings

- [Customer profile](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/model/Customer.java): `src/main/java/com/mongodb/frauddetector/model/Customer.java`
- [Transaction model](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/model/Transaction.java): `src/main/java/com/mongodb/frauddetector/model/Transaction.java`
- [Transaction enums](https://github.com/mongodb-developer/frauddetector/tree/master/src/main/java/com/mongodb/frauddetector/enums): `src/main/java/com/mongodb/frauddetector/enums`
- [Embedding generator](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/service/EmbeddingGenerator.java): `src/main/java/com/mongodb/frauddetector/service/EmbeddingGenerator.java`

### Other components

- [Application startup](https://github.com/mongodb-developer/frauddetector/blob/master/src/main/java/com/mongodb/frauddetector/FrauddetectorApplication.java): `src/main/java/com/mongodb/frauddetector/FrauddetectorApplication.java`
- **OpenAI embeddings**

## Connections

- Application startup → Customer seeder: starts (evidence: `README.md`)
- Application startup → Historical seeder: starts (evidence: `README.md`)
- Customer seeder → MongoDB Atlas: seeds customers (evidence: `src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java`)
- Customer seeder → Customer profile: creates profiles (evidence: `src/main/java/com/mongodb/frauddetector/service/CustomerSeeder.java`)
- Historical seeder → Customer repository: loads customers (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java`)
- Historical seeder → Transaction model: generates history (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java`)
- Historical seeder → Embedding generator: requests embeddings (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java`)
- Historical seeder → Transaction repository: saves history (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java`)
- Historical seeder → Change stream listener: starts listener (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionSeeder.java`)
- Live producer → Customer repository: loads profiles (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java`)
- Live producer → Transaction model: generates transactions (evidence: `README.md`)
- Live producer → Embedding generator: requests embeddings (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionProducer.java`)
- Live producer → Transactions topic: publishes (evidence: `README.md`)
- Transactions topic → Kafka consumer: delivers messages (evidence: `README.md`)
- Kafka consumer → Transaction repository: persists transactions (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionConsumer.java`)
- Customer repository → MongoDB Atlas: reads and writes (evidence: `README.md`)
- Transaction repository → MongoDB Atlas: reads and writes (evidence: `README.md`)
- MongoDB Atlas → Change stream listener: notifies inserts (evidence: `README.md`)
- Change stream listener → Vector fraud evaluator: evaluates inserts (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionChangeStreamListener.java`)
- Vector fraud evaluator → MongoDB Atlas: searches and updates (evidence: `src/main/java/com/mongodb/frauddetector/service/TransactionVectorSearchService.java`)
- Embedding generator → OpenAI embeddings: requests vectors (evidence: `README.md`)
- Customer profile → Transaction enums: uses profile values (evidence: `src/main/java/com/mongodb/frauddetector/model/Customer.java`)
- Transaction model → Transaction enums: uses transaction values (evidence: `src/main/java/com/mongodb/frauddetector/model/Transaction.java`)
