How arayikgevorgyan/aml_system works
This is an AML transaction-monitoring platform: analysts and supervisors use a React interface to manage customers and transactions, review detection alerts, investigate cases, and support SAR reporting. The FastAPI backend exposes the product’s operational modules, with SQLite-backed records and separate rule, sanctions, analysis, and ML capabilities. The README documents the major domain stages; sampled code confirms application routing, authentication, audit logging, database setup, and frontend API behavior. Some feature-level connections rely on README documentation because their implementation files were not sampled.
Main entry points: routers Domain API routes · App.js React application · main.py FastAPI application · client.js API client
Components 20
Analyst interface
- React application
frontend/src/App.js - Customer workspace
frontend/src/pages/Customers.js - Sanctions workspace
frontend/src/pages/Sanctions.js - Operations workspaces
frontend/src/pages - API client
frontend/src/api/client.js
Application API
- FastAPI application
backend/main.py - Authentication routes
backend/routers/auth.py - Domain API routes
backend/routers
Monitoring and screening
- Transaction monitoring
backend/services/transaction_service.py - AML rules engine
backend/services/rules_engine.py - Sanctions screening
backend/services/sanctions_screener.py - Risk and ML analysis
backend/ml
Investigation and reporting
- Alerts
backend/services/alert_service.py - Cases and SAR
backend/services/case_service.py - Compliance reporting
backend/reports - Audit trail
backend/services/audit_service.py
Platform foundations
- SQLite database
backend/database.py - Authentication service
backend/services/auth_service.py - User records
backend/models/user.py
Other components
- AML analyst
Connections 25
- AML analyst → React application: uses
README.md - React application → Customer workspace: routes to
frontend/src/App.js - React application → Sanctions workspace: routes to
frontend/src/App.js - React application → Operations workspaces: routes to
frontend/src/App.js - Customer workspace → API client: calls
frontend/src/pages/Customers.js - Sanctions workspace → API client: calls
- Operations workspaces → API client: calls
frontend/src/pages/Sessions.js - API client → FastAPI application: HTTP requests
README.md - FastAPI application → Authentication routes: registers
backend/main.py - FastAPI application → Domain API routes: registers
backend/main.py - Authentication routes → Authentication service: calls
backend/routers/auth.py - Authentication service → User records: reads and writes
backend/services/auth_service.py - Authentication service → Audit trail: logs actions
backend/services/auth_service.py - FastAPI application → SQLite database: creates tables
backend/main.py - Domain API routes → Transaction monitoring: submits transactions
- Transaction monitoring → AML rules engine: evaluates rules
README.md - Transaction monitoring → Risk and ML analysis: scores risk
README.md - AML rules engine → Alerts: generates alerts
README.md - Domain API routes → Sanctions screening: screens names
README.md - Domain API routes → Cases and SAR: manages investigations
README.md - Cases and SAR → Compliance reporting: supports SAR filing
README.md - Domain API routes → Compliance reporting: provides reports
README.md - Compliance reporting → SQLite database: queries records
backend/reports/compliance_report.py - Alerts → SQLite database: stores alerts
- Cases and SAR → SQLite database: stores cases