How mounish-28/anti-money-laundaring-detection works
QuantumAML Nexus is an AML detection and investigation platform: transaction, time-series, and crypto events enter through scoring or live dispatch, receive model-based risk tiers, and can trigger alerts or SAR workflows for analyst review and export. The main dashboard supports live triage, batch work, and monitoring; a separate investigation workbench supports case and entity analysis. The README documents additional dataset engines and monitoring capabilities, but sampled excerpts do not establish all their runtime wiring, so uncertain links are omitted.
Main entry points: main.py FastAPI Service · App.jsx Nexus Dashboard · useLiveFeed.js Live Feed Hook · InvestigationContext.jsx Investigation Context
Components 28
Event Intake
- FastAPI Service
app/main.py - Transaction API
app/routers/transaction.py - Crypto API
app/routers/crypto.py - Batch API
app/routers/batch.py - Transaction Streamer
streamer.py - Crypto Feed
live_crypto_feed.py
Detection and Scoring
- Inference Engine
app/services/inference_engine.py - Risk Engine
app/services/risk_engine.py - Model Registry
app/services/model_registry.py
Alerts and SAR
- SAR Service
app/services/sar_service.py - SAR Exporter
app/services/sar_exporter.py - Alert Routes
app/routers/alerts.py
Analyst Interfaces
- Nexus Dashboard
nexus-frontend/src/App.jsx - Live Feed Hook
nexus-frontend/src/hooks/useLiveFeed.js - Transaction Triage
nexus-frontend/src/components/TransactionTriage.jsx - Crypto Triage
nexus-frontend/src/components/CryptoTriage.jsx - Batch Portal
nexus-frontend/src/components/BatchPortal.jsx - SAR Case Manager
nexus-frontend/src/components/SARCaseManager.jsx - Investigation Workbench
quantumaml-investigation/src/App.jsx - Investigation Context
quantumaml-investigation/src/context/InvestigationContext.jsx - Case API Client
quantumaml-investigation/src/api/casesApi.js - SAR API Client
quantumaml-investigation/src/api/sarApi.js
Dataset Engines
- IBM Transaction Engine
src/pipeline_ibm_transactions.py - Time-Series Engine
src/pipeline_timeseries.py - SAML-D Engine
src/pipeline_samld.py - AMLSim Graph Engine
src/pipeline_amlsim.py - Elliptic Trainer
models/train_elliptic.py
Other components
- Analyst
Connections 28
- Analyst → Nexus Dashboard: uses
- Analyst → Investigation Workbench: investigates
- Nexus Dashboard → Live Feed Hook: initializes
- Nexus Dashboard → Transaction Triage: renders
- Nexus Dashboard → Crypto Triage: renders
- Nexus Dashboard → Batch Portal: renders
- Nexus Dashboard → SAR Case Manager: renders
- Transaction Triage → FastAPI Service: scores via API
- Crypto Triage → FastAPI Service: scores via API
- Batch Portal → FastAPI Service: submits batches
- Live Feed Hook → FastAPI Service: connects WebSocket
- Live Feed Hook → FastAPI Service: dispatches REST
- Transaction Streamer → FastAPI Service: streams events
- Crypto Feed → FastAPI Service: streams crypto
- FastAPI Service → Inference Engine: scores events
- FastAPI Service → Risk Engine: scores transactions
- Transaction API → Risk Engine: scores request
- Crypto API → Inference Engine: scores crypto
- Batch API → Inference Engine: scores batch
- Risk Engine → Model Registry: reads models
- FastAPI Service → SAR Service: processes SAR
- FastAPI Service → Alert Routes: queues alerts
- SAR Service → SAR Exporter: exports dossier
- Investigation Workbench → Investigation Context: provides state
- Investigation Context → Case API Client: loads cases
- Investigation Context → SAR API Client: loads SAR data
- Case API Client → FastAPI Service: requests cases
- SAR API Client → FastAPI Service: requests SAR