How concurrents-org/ledgerzero works
LedgerZero is a UPI-style payment and fraud-analysis platform. The user journey runs from authentication and onboarding through account access, payment initiation, transaction routing and bank processing; fraud scoring and graph-based investigation add risk decisions and forensic reports. The sampled frontend and Python backend show API access, graph retrieval, Gemini-backed analysis, and graph synchronization. The README documents Java payment services and broader features, but those service sources are absent from this tree, so their links are documentation-based rather than source-verified.
Main entry points: api.ts API Client · app.py Fraud API · graph_sync_service.py Graph Sync · graph_rag.py Forensic GraphRAG
Components 20
Payment Client
- Authentication
website/src/pages/auth/AuthPage.tsx - Onboarding
website/src/pages/onboarding/OnboardingPage.tsx - Account Views
website/src/hooks/useAccountData.ts - Send Payment
website/src/pages/send/SendMoneyPage.tsx - Transaction History
website/src/pages/transactions/TransactionsPage.tsx - API Client
website/src/services/api.ts - Client State
website/src/store/index.ts - Live Notifications
website/src/hooks/usePaymentNotifications.ts
Payment Services
- Gateway Service
- Transaction Switch
- Bank Service
Fraud Analysis
- Fraud API
Python Backend/app.py - Graph Sync
Python Backend/DB Poller/graph_sync_service.py - Forensic GraphRAG
Python Backend/graph_rag.py - GNN Risk Detection
Python Backend
Data Stores
- Neo4j Graph
- PostgreSQL
- Redis
Other components
- Payment User
- Google Gemini
Connections 25
- Payment User → Authentication: authenticates
- Payment User → Onboarding: sets up account
- Payment User → Send Payment: initiates payment
- Authentication → API Client: calls
website/src/pages/auth/AuthPage.tsx - Onboarding → API Client: calls
website/src/pages/onboarding/OnboardingPage.tsx - Send Payment → API Client: calls
website/src/pages/send/SendMoneyPage.tsx - Account Views → API Client: fetches data
website/src/hooks/useAccountData.ts - Account Views → Client State: updates
website/src/hooks/useAccountData.ts - Transaction History → API Client: fetches history
website/src/pages/transactions/TransactionsPage.tsx - API Client → Gateway Service: sends requests
- Gateway Service → Transaction Switch: routes payments
- Transaction Switch → Bank Service: requests processing
- Gateway Service → Fraud API: streams events
- Transaction Switch → Fraud API: requests risk score
- Fraud API → Forensic GraphRAG: initializes engine
Python Backend/app.py - Fraud API → Graph Sync: runs synchronization
- Graph Sync → PostgreSQL: reads transactions
Python Backend/DB Poller/graph_sync_service.py - Graph Sync → Neo4j Graph: syncs graph
- Graph Sync → Redis: stores sync state
Python Backend/DB Poller/graph_sync_service.py - Forensic GraphRAG → Neo4j Graph: retrieves ego graph
Python Backend/graph_rag.py - Forensic GraphRAG → Google Gemini: generates report
Python Backend/graph_rag.py - Fraud API → GNN Risk Detection: scores transactions
Python Backend/app.py - Payment User → Transaction History: views history
- Gateway Service → Live Notifications: publishes alerts
- Live Notifications → Client State: updates balance
website/src/hooks/usePaymentNotifications.ts