How shereiff1/finguard works
FinGuard streams transactions from clients through Go ingestion and Kafka, scores them with a Python ONNX service using Redis profile features, then settles or flags them in a Java/PostgreSQL ledger. The graph preserves the documented ingestion, scoring, settlement, and fraud-handling stages. Internal relationships are shown where excerpts or the README support them; unsampled wiring is not inferred.
Main entry points: LedgerService.java Ledger settlement · FraudHandlerService.java Fraud handling · kafka_worker.py Scoring worker · main.py ML service lifecycle
Components 25
Transaction ingestion
- WebSocket transport
finguard-ingestion/internal/transport/http.go - Transaction model
finguard-ingestion/internal/domain/transaction.go - Kafka worker pool
finguard-ingestion/internal/worker/kafka_worker.go - Ingestion server
finguard-ingestion/cmd/server/main.go
Fraud scoring
- ML service lifecycle
finguard-ml/app/main.py - Scoring worker
finguard-ml/app/services/kafka_worker.py - ONNX inference
finguard-ml/app/services/inference.py - Feature cache
finguard-ml/app/services/cache.py - ML configuration
finguard-ml/app/config.py
Ledger settlement
- Transaction consumer
finguard-ledger/src/main/java/com/finguard/ledger/consumer/TransactionConsumer.java - Evaluated transaction DTO
finguard-ledger/src/main/java/com/finguard/ledger/dto/EvaluatedTransaction.java - Ledger settlement
finguard-ledger/src/main/java/com/finguard/ledger/service/LedgerService.java - Fraud handling
finguard-ledger/src/main/java/com/finguard/ledger/service/FraudHandlerService.java - Account repository
finguard-ledger/src/main/java/com/finguard/ledger/repository/AccountRepository.java - Transaction repository
finguard-ledger/src/main/java/com/finguard/ledger/repository/LedgerTransactionRepository.java - Fraud alert repository
finguard-ledger/src/main/java/com/finguard/ledger/repository/FraudAlertRepository.java - Account entity
finguard-ledger/src/main/java/com/finguard/ledger/domain/Account.java - Ledger transaction entity
finguard-ledger/src/main/java/com/finguard/ledger/domain/LedgerTransaction.java - Fraud alert entity
finguard-ledger/src/main/java/com/finguard/ledger/domain/FraudAlert.java
Streaming and storage
- Apache Kafka
- Raw transactions
- Redis profiles
- Evaluated transactions
- PostgreSQL
Other components
- Transaction client
Connections 25
- Transaction client → WebSocket transport: streams transactions
README.md - WebSocket transport → Kafka worker pool: publishes asynchronously
README.md - Kafka worker pool → Raw transactions: publishes events
README.md - Raw transactions → Scoring worker: consumes
README.md - ML service lifecycle → Scoring worker: starts
finguard-ml/app/main.py - ML service lifecycle → Feature cache: creates
finguard-ml/app/main.py - ML service lifecycle → ONNX inference: creates
finguard-ml/app/main.py - Scoring worker → Feature cache: reads profiles
finguard-ml/app/services/kafka_worker.py - Scoring worker → ONNX inference: scores features
finguard-ml/app/services/kafka_worker.py - Feature cache → Redis profiles: reads profiles
README.md - Scoring worker → Evaluated transactions: publishes scored events
finguard-ml/app/services/kafka_worker.py - Evaluated transactions → Transaction consumer: delivers events
README.md - Transaction consumer → Evaluated transaction DTO: deserializes as
finguard-ledger/src/main/java/com/finguard/ledger/consumer/TransactionConsumer.java - Transaction consumer → Ledger settlement: calls process
finguard-ledger/src/main/java/com/finguard/ledger/consumer/TransactionConsumer.java - Ledger settlement → Fraud handling: checks and handles fraud
finguard-ledger/src/main/java/com/finguard/ledger/service/LedgerService.java - Ledger settlement → Account repository: locks and updates accounts
finguard-ledger/src/main/java/com/finguard/ledger/service/LedgerService.java - Ledger settlement → Transaction repository: persists transactions
finguard-ledger/src/main/java/com/finguard/ledger/service/LedgerService.java - Fraud handling → Account repository: freezes account
finguard-ledger/src/main/java/com/finguard/ledger/service/FraudHandlerService.java - Fraud handling → Transaction repository: marks rollback
finguard-ledger/src/main/java/com/finguard/ledger/service/FraudHandlerService.java - Fraud handling → Fraud alert repository: saves alert
finguard-ledger/src/main/java/com/finguard/ledger/service/FraudHandlerService.java - Account repository → Account entity: maps entity
finguard-ledger/src/main/java/com/finguard/ledger/repository/AccountRepository.java - Transaction repository → Ledger transaction entity: maps entity
finguard-ledger/src/main/java/com/finguard/ledger/repository/LedgerTransactionRepository.java - Fraud alert repository → Fraud alert entity: maps entity
finguard-ledger/src/main/java/com/finguard/ledger/repository/FraudAlertRepository.java - Ledger settlement → PostgreSQL: persists settlement
README.md - Fraud handling → PostgreSQL: persists alerts
README.md