# miloszpodsiadly/fraud-detection-platform architecture

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

- Interactive diagram: https://gitdiagram.com/miloszpodsiadly/fraud-detection-platform
- Repository: https://github.com/miloszpodsiadly/fraud-detection-platform

## Overview

This is a multi-service fraud detection platform. Its main workflow accepts or replays transactions, enriches features, scores risk, and presents resulting alerts and cases for analyst review. Supporting branches cover model-assisted scoring, engine-intelligence feedback and reporting, and the platform’s append-only audit and local trust-authority workflows. The README documents service ownership and the event-driven handoffs; sampled source confirms ingestion publication, scoring aggregation, and alert-side projection behavior. Other subsystem links are limited to documented capabilities because their implementation excerpts were not provided.

Main entry points: [`analyst-console-ui/src/App.jsx`](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/analyst-console-ui/src/App.jsx) (Analyst console), [`fraud-scoring-service/src/main/java/com/frauddetection/scoring/service/CompositeFraudScoringEngine.java`](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/fraud-scoring-service/src/main/java/com/frauddetection/scoring/service/CompositeFraudScoringEngine.java) (Fraud scoring), [`transaction-ingest-service/src/main/java/com/frauddetection/ingest/service/TransactionIngestService.java`](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/transaction-ingest-service/src/main/java/com/frauddetection/ingest/service/TransactionIngestService.java) (Transaction ingestion), [`alert-service/src/main/java/com/frauddetection/alert/engineintelligence/EngineIntelligenceProjectionService.java`](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/engineintelligence/EngineIntelligenceProjectionService.java) (Alert and projection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_transaction_flow["Transaction processing"]
  node_simulator["Synthetic replay"]
  node_ingest["Transaction ingestion"]
  node_raw_contract["Raw event contract"]
  node_kafka["Kafka event bus"]
  node_enrichment["Feature enrichment"]
  node_scoring["Fraud scoring"]
  node_scored_contract["Scored event contract"]
end

subgraph group_analyst_workflow["Analyst operations"]
  node_alert_projection["Alert and projection"]
  node_alert_store[("Alert persistence")]
  node_case_queue["Fraud case queue"]
  node_console["Analyst console<br/>[App.jsx]"]
  node_case_assistant["Case summary assistant"]
end

subgraph group_intelligence["Scoring intelligence"]
  node_engine_aggregation["Engine aggregation"]
  node_ml_runtime["ML inference<br/>[server.py]"]
  node_feedback["Engine feedback"]
  node_feedback_export["Feedback dataset export"]
end

subgraph group_trust_audit["Audit and trust"]
  node_audit[("Audit and evidence<br/>[AuditService.java]")]
  node_trust_authority["Trust authority"]
end

node_submitter(("Transaction submitter"))
node_analyst(("Fraud analyst"))

node_submitter -->|"submits transaction"| node_ingest
node_simulator -.->|"sends replay traffic"| node_ingest
node_ingest -->|"maps request"| node_raw_contract
node_ingest -->|"publishes event"| node_kafka
node_kafka -->|"delivers transaction"| node_enrichment
node_enrichment -->|"forwards features"| node_scoring
node_scoring -.->|"requests inference"| node_ml_runtime
node_scoring -->|"aggregates results"| node_engine_aggregation
node_scoring -->|"publishes score"| node_scored_contract
node_scored_contract -->|"travels as event"| node_kafka
node_kafka -->|"delivers score"| node_alert_projection
node_alert_projection -.->|"persists projection"| node_alert_store
node_analyst -->|"reviews cases"| node_console
node_console -.->|"requests work queue"| node_case_queue
node_case_queue -.->|"reads scored records"| node_alert_store
node_console -.->|"submits feedback"| node_feedback
node_feedback_export -->|"reads alert context"| node_alert_store
node_feedback_export -->|"reads projection"| node_alert_projection
node_console -.->|"requests case summary"| node_case_assistant
node_console -->|"uses secured workflows"| node_audit
node_audit -->|"uses local signing"| node_trust_authority

click node_simulator "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/transaction-simulator-service/src/main/java/com/frauddetection/simulator/service/TransactionReplayService.java"
click node_ingest "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/transaction-ingest-service/src/main/java/com/frauddetection/ingest/service/TransactionIngestService.java"
click node_raw_contract "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/common-events/src/main/java/com/frauddetection/common/events/contract/TransactionRawEvent.java"
click node_enrichment "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/feature-enricher-service/src/main/java/com/frauddetection/enricher/service/TransactionFeatureEnricherService.java"
click node_scoring "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/fraud-scoring-service/src/main/java/com/frauddetection/scoring/service/CompositeFraudScoringEngine.java"
click node_engine_aggregation "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/fraud-scoring-service/src/main/java/com/frauddetection/scoring/orchestration/aggregation/FraudEngineAggregationService.java"
click node_ml_runtime "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/ml-inference-service/app/server.py"
click node_scored_contract "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/common-events/src/main/java/com/frauddetection/common/events/contract/TransactionScoredEvent.java"
click node_alert_projection "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/engineintelligence/EngineIntelligenceProjectionService.java"
click node_alert_store "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/persistence/ScoredTransactionRepository.java"
click node_case_queue "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/service/FraudCaseQueryService.java"
click node_console "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/analyst-console-ui/src/App.jsx"
click node_feedback "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/engineintelligence/api/EngineIntelligenceFeedbackService.java"
click node_feedback_export "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/engineintelligence/dataset/EngineIntelligenceFeedbackDatasetExportService.java"
click node_case_assistant "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/assistant/AnalystCaseSummaryUseCase.java"
click node_audit "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/audit/AuditService.java"
click node_trust_authority "https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/audit-trust-authority/src/main/java/com/frauddetection/trustauthority/TrustAuthorityService.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_simulator,node_ingest,node_raw_contract,node_kafka,node_enrichment,node_scoring,node_scored_contract toneBlue
class node_alert_projection,node_alert_store,node_case_queue,node_console,node_case_assistant toneAmber
class node_engine_aggregation,node_ml_runtime,node_feedback,node_feedback_export toneMint
class node_audit,node_trust_authority toneRose
class node_submitter,node_analyst toneIndigo
```

## Components

### Transaction processing

- [Synthetic replay](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/transaction-simulator-service/src/main/java/com/frauddetection/simulator/service/TransactionReplayService.java): `transaction-simulator-service/src/main/java/com/frauddetection/simulator/service/TransactionReplayService.java`
- [Transaction ingestion](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/transaction-ingest-service/src/main/java/com/frauddetection/ingest/service/TransactionIngestService.java): `transaction-ingest-service/src/main/java/com/frauddetection/ingest/service/TransactionIngestService.java`
- [Raw event contract](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/common-events/src/main/java/com/frauddetection/common/events/contract/TransactionRawEvent.java): `common-events/src/main/java/com/frauddetection/common/events/contract/TransactionRawEvent.java`
- **Kafka event bus**
- [Feature enrichment](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/feature-enricher-service/src/main/java/com/frauddetection/enricher/service/TransactionFeatureEnricherService.java): `feature-enricher-service/src/main/java/com/frauddetection/enricher/service/TransactionFeatureEnricherService.java`
- [Fraud scoring](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/fraud-scoring-service/src/main/java/com/frauddetection/scoring/service/CompositeFraudScoringEngine.java): `fraud-scoring-service/src/main/java/com/frauddetection/scoring/service/CompositeFraudScoringEngine.java`
- [Scored event contract](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/common-events/src/main/java/com/frauddetection/common/events/contract/TransactionScoredEvent.java): `common-events/src/main/java/com/frauddetection/common/events/contract/TransactionScoredEvent.java`

### Analyst operations

- [Alert and projection](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/engineintelligence/EngineIntelligenceProjectionService.java): `alert-service/src/main/java/com/frauddetection/alert/engineintelligence/EngineIntelligenceProjectionService.java`
- [Alert persistence](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/persistence/ScoredTransactionRepository.java): `alert-service/src/main/java/com/frauddetection/alert/persistence/ScoredTransactionRepository.java`
- [Fraud case queue](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/service/FraudCaseQueryService.java): `alert-service/src/main/java/com/frauddetection/alert/service/FraudCaseQueryService.java`
- [Analyst console](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/analyst-console-ui/src/App.jsx): `analyst-console-ui/src/App.jsx`
- [Case summary assistant](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/assistant/AnalystCaseSummaryUseCase.java): `alert-service/src/main/java/com/frauddetection/alert/assistant/AnalystCaseSummaryUseCase.java`

### Scoring intelligence

- [Engine aggregation](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/fraud-scoring-service/src/main/java/com/frauddetection/scoring/orchestration/aggregation/FraudEngineAggregationService.java): `fraud-scoring-service/src/main/java/com/frauddetection/scoring/orchestration/aggregation/FraudEngineAggregationService.java`
- [ML inference](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/ml-inference-service/app/server.py): `ml-inference-service/app/server.py`
- [Engine feedback](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/engineintelligence/api/EngineIntelligenceFeedbackService.java): `alert-service/src/main/java/com/frauddetection/alert/engineintelligence/api/EngineIntelligenceFeedbackService.java`
- [Feedback dataset export](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/engineintelligence/dataset/EngineIntelligenceFeedbackDatasetExportService.java): `alert-service/src/main/java/com/frauddetection/alert/engineintelligence/dataset/EngineIntelligenceFeedbackDatasetExportService.java`

### Audit and trust

- [Audit and evidence](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/alert-service/src/main/java/com/frauddetection/alert/audit/AuditService.java): `alert-service/src/main/java/com/frauddetection/alert/audit/AuditService.java`
- [Trust authority](https://github.com/miloszpodsiadly/fraud-detection-platform/blob/master/audit-trust-authority/src/main/java/com/frauddetection/trustauthority/TrustAuthorityService.java): `audit-trust-authority/src/main/java/com/frauddetection/trustauthority/TrustAuthorityService.java`

### Other components

- **Transaction submitter**
- **Fraud analyst**

## Connections

- Transaction submitter → Transaction ingestion: submits transaction
- Synthetic replay → Transaction ingestion: sends replay traffic
- Transaction ingestion → Raw event contract: maps request (evidence: `transaction-ingest-service/src/main/java/com/frauddetection/ingest/service/TransactionIngestService.java`)
- Transaction ingestion → Kafka event bus: publishes event (evidence: `transaction-ingest-service/src/main/java/com/frauddetection/ingest/service/TransactionIngestService.java`)
- Kafka event bus → Feature enrichment: delivers transaction
- Feature enrichment → Fraud scoring: forwards features
- Fraud scoring → ML inference: requests inference
- Fraud scoring → Engine aggregation: aggregates results (evidence: `fraud-scoring-service/src/main/java/com/frauddetection/scoring/orchestration/aggregation/FraudEngineAggregationService.java`)
- Fraud scoring → Scored event contract: publishes score
- Scored event contract → Kafka event bus: travels as event
- Kafka event bus → Alert and projection: delivers score
- Alert and projection → Alert persistence: persists projection (evidence: `alert-service/src/main/java/com/frauddetection/alert/engineintelligence/EngineIntelligenceProjectionService.java`)
- Fraud analyst → Analyst console: reviews cases
- Analyst console → Fraud case queue: requests work queue
- Fraud case queue → Alert persistence: reads scored records
- Analyst console → Engine feedback: submits feedback
- Feedback dataset export → Alert persistence: reads alert context (evidence: `alert-service/src/main/java/com/frauddetection/alert/engineintelligence/dataset/EngineIntelligenceFeedbackDatasetExportService.java`)
- Feedback dataset export → Alert and projection: reads projection (evidence: `alert-service/src/main/java/com/frauddetection/alert/engineintelligence/dataset/EngineIntelligenceFeedbackDatasetExportService.java`)
- Analyst console → Case summary assistant: requests case summary
- Analyst console → Audit and evidence: uses secured workflows
- Audit and evidence → Trust authority: uses local signing
