How iamyogeshmohan/nexguard-ai-wallet works
NexGuard is a simulated digital-wallet and payment platform paired with a bank security operations center. A customer authenticates, submits a payment with device and transaction telemetry, and receives an allow, verify, or block decision; analysts monitor alerts and can remediate accounts and incidents. The graph includes the documented mobile, SOC, and supporting risk capabilities. Some links rely on README architecture descriptions because frontend pages and several backend routers were not sampled.
Main entry points: main.py FastAPI application · models.py Wallet and risk records · transactions.py Transaction lifecycle · websocket.py Live event channels
Components 22
Customer experience
- Mobile wallet
frontend/src/app/mobile/dashboard/page.tsx - Send payment flow
frontend/src/app/wallet/send/page.tsx - Customer authentication
frontend/src/app/register/page.tsx - SOC command center
frontend/src/app/soc/page.tsx - Server operations UI
frontend/src/app/server/page.tsx - API client
frontend/src/lib/api.ts
Payment and identity API
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/routers/auth.py - Wallet routes
backend/app/routers/wallet.py - Transaction lifecycle
backend/app/routers/transactions.py - Account controls
backend/app/routers/accounts.py
Risk assessment
- Multi-agent risk engine
backend/app/agents.py
SOC operations
- SOC and threat intelligence
backend/app/routers/soc.py - Platform operations
backend/app/routers/server_ops.py - Incident handling
backend/app/routers/incidents.py - Live event channels
backend/app/websocket.py
Shared platform services
- Database access
backend/app/database.py - Wallet and risk records
backend/app/models.py - Audit log service
backend/app/audit.py - Token and access security
backend/app/security.py - Demo data bootstrap
backend/app/bootstrap.py
Other components
- Wallet customer
Connections 39
- Wallet customer → Mobile wallet: uses
- Wallet customer → Customer authentication: authenticates
- Mobile wallet → Send payment flow: starts payment
- Send payment flow → API client: submits request
- Customer authentication → API client: sends credentials
- API client → FastAPI application: calls API
- FastAPI application → Authentication routes: routes requests
backend/app/main.py - FastAPI application → Wallet routes: routes requests
backend/app/main.py - FastAPI application → Transaction lifecycle: routes requests
backend/app/main.py - FastAPI application → Incident handling: routes requests
backend/app/main.py - FastAPI application → SOC and threat intelligence: routes requests
backend/app/main.py - FastAPI application → Live event channels: serves channels
backend/app/main.py - FastAPI application → Demo data bootstrap: seeds demo data
backend/app/main.py - Transaction lifecycle → Multi-agent risk engine: evaluates risk
backend/app/routers/transactions.py - Transaction lifecycle → Wallet and risk records: records payment
backend/app/routers/transactions.py - Transaction lifecycle → Database access: queries database
backend/app/routers/transactions.py - Transaction lifecycle → Audit log service: writes audit log
backend/app/routers/transactions.py - Transaction lifecycle → Live event channels: notifies SOC
backend/app/routers/transactions.py - Multi-agent risk engine → Transaction lifecycle: returns decision
backend/app/routers/transactions.py - Authentication routes → Token and access security: uses token security
backend/app/routers/auth.py - Authentication routes → Wallet and risk records: queries users
backend/app/routers/auth.py - Wallet routes → Wallet and risk records: reads wallet records
backend/app/routers/wallet.py - Wallet routes → Database access: queries database
backend/app/routers/wallet.py - Account controls → Live event channels: publishes updates
backend/app/routers/accounts.py - Account controls → Audit log service: writes audit log
backend/app/routers/accounts.py - Account controls → Wallet and risk records: updates accounts
backend/app/routers/accounts.py - SOC command center → API client: requests SOC data
- Server operations UI → API client: requests operations data
- SOC and threat intelligence → Multi-agent risk engine: reports agent status
backend/app/routers/soc.py - SOC and threat intelligence → Wallet and risk records: reads SOC records
backend/app/routers/soc.py - Platform operations → Wallet and risk records: monitors records
backend/app/routers/server_ops.py - Platform operations → Live event channels: sends notifications
backend/app/routers/server_ops.py - Platform operations → Audit log service: records actions
backend/app/routers/server_ops.py - Incident handling → Live event channels: alerts analysts
- Demo data bootstrap → Wallet and risk records: seeds records
backend/app/bootstrap.py - Demo data bootstrap → Token and access security: uses security utilities
backend/app/bootstrap.py - Audit log service → Wallet and risk records: creates audit records
backend/app/audit.py - Wallet and risk records → Database access: binds ORM base
backend/app/models.py - Live event channels → SOC command center: streams SOC events