How miloszpodsiadly/fraud-detection-platform works
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: App.jsx Analyst console · CompositeFraudScoringEngine.java Fraud scoring · TransactionIngestService.java Transaction ingestion · EngineIntelligenceProjectionService.java Alert and projection
Components 20
Transaction processing
- Synthetic replay
transaction-simulator-service/src/main/java/com/frauddetection/simulator/service/TransactionReplayService.java - Transaction ingestion
transaction-ingest-service/src/main/java/com/frauddetection/ingest/service/TransactionIngestService.java - Raw event contract
common-events/src/main/java/com/frauddetection/common/events/contract/TransactionRawEvent.java - Kafka event bus
- Feature enrichment
feature-enricher-service/src/main/java/com/frauddetection/enricher/service/TransactionFeatureEnricherService.java - Fraud scoring
fraud-scoring-service/src/main/java/com/frauddetection/scoring/service/CompositeFraudScoringEngine.java - Scored event contract
common-events/src/main/java/com/frauddetection/common/events/contract/TransactionScoredEvent.java
Analyst operations
- Alert and projection
alert-service/src/main/java/com/frauddetection/alert/engineintelligence/EngineIntelligenceProjectionService.java - Alert persistence
alert-service/src/main/java/com/frauddetection/alert/persistence/ScoredTransactionRepository.java - Fraud case queue
alert-service/src/main/java/com/frauddetection/alert/service/FraudCaseQueryService.java - Analyst console
analyst-console-ui/src/App.jsx - Case summary assistant
alert-service/src/main/java/com/frauddetection/alert/assistant/AnalystCaseSummaryUseCase.java
Scoring intelligence
- Engine aggregation
fraud-scoring-service/src/main/java/com/frauddetection/scoring/orchestration/aggregation/FraudEngineAggregationService.java - ML inference
ml-inference-service/app/server.py - Engine feedback
alert-service/src/main/java/com/frauddetection/alert/engineintelligence/api/EngineIntelligenceFeedbackService.java - Feedback dataset export
alert-service/src/main/java/com/frauddetection/alert/engineintelligence/dataset/EngineIntelligenceFeedbackDatasetExportService.java
Audit and trust
- Audit and evidence
alert-service/src/main/java/com/frauddetection/alert/audit/AuditService.java - Trust authority
audit-trust-authority/src/main/java/com/frauddetection/trustauthority/TrustAuthorityService.java
Other components
- Transaction submitter
- Fraud analyst
Connections 21
- Transaction submitter → Transaction ingestion: submits transaction
- Synthetic replay → Transaction ingestion: sends replay traffic
- Transaction ingestion → Raw event contract: maps request
transaction-ingest-service/src/main/java/com/frauddetection/ingest/service/TransactionIngestService.java - Transaction ingestion → Kafka event bus: publishes event
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
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
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
alert-service/src/main/java/com/frauddetection/alert/engineintelligence/dataset/EngineIntelligenceFeedbackDatasetExportService.java - Feedback dataset export → Alert and projection: reads projection
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