How royaldev06/bitsentry works
BitSentry AML is a Bitcoin AML monitoring and investigation application. Analysts enter through a React dashboard and can navigate to alerts, transactions, address investigation, and cases; the documented workflow spans monitoring and risk assessment through alert review and case resolution. The sampled dashboard uses React Query and mock-backed service functions, while the backend directories are largely package initializers. Backend domain capabilities and blockchain integration are therefore represented at directory level without asserting unsampled call paths.
Main entry points: App.tsx Application routes · useDashboard.ts Dashboard queries · DashboardPage.tsx Dashboard page · RiskDistributionCard.tsx Risk distribution
Components 30
Analyst interface
- Application routes
frontend/src/App.tsx - Application layout
frontend/src/components/layout/AppLayout.tsx - Dashboard page
frontend/src/pages/Dashboard/DashboardPage.tsx - Summary cards
frontend/src/components/dashboard/SummaryCards.tsx - Alert summary
frontend/src/components/dashboard/AlertSummaryCard.tsx - Risk distribution
frontend/src/components/dashboard/RiskDistributionCard.tsx - Recent activity
frontend/src/components/dashboard/RecentActivityCard.tsx - Dashboard presentation
frontend/src/components/dashboard/SectionCard.tsx - Loading and empty states
frontend/src/components/dashboard/StateView.tsx - Risk badge
frontend/src/components/ui/RiskBadge.tsx - Dashboard formatting
frontend/src/components/dashboard/dashboardUtils.ts - Dashboard queries
frontend/src/hooks/useDashboard.ts - Theme preference
frontend/src/hooks/useTheme.ts - Alerts screen
frontend/src/pages/Alerts/Alerts.tsx - Transactions screen
frontend/src/pages/Transactions/Transactions.tsx - Address investigation screen
frontend/src/pages/Addresses/Addresses.tsx - Cases screen
frontend/src/pages/Cases/Cases.tsx
AML backend domains
- Transaction monitoring
backend/app/transactions - Risk assessment
backend/app/risk - Detection and rules
backend/app/detection - Alert management
backend/app/alerts - Address investigation
backend/app/addresses - Case management
backend/app/cases - Bitcoin data services
backend/app/bitcoin - Backend dashboard
backend/app/dashboard
Data and contracts
- Dashboard data service
frontend/src/services/dashboard.ts - Dashboard data contracts
frontend/src/types/dashboard.ts - Application database
backend/app/database.py
Other components
- Compliance analyst
- Bitcoin blockchain data
Connections 36
- Compliance analyst → Application routes: uses
README.md - Application routes → Dashboard page: routes to
frontend/src/App.tsx - Application routes → Alerts screen: routes to
frontend/src/App.tsx - Application routes → Transactions screen: routes to
frontend/src/App.tsx - Application routes → Address investigation screen: routes to
frontend/src/App.tsx - Application routes → Cases screen: routes to
frontend/src/App.tsx - Application routes → Application layout: renders
frontend/src/App.tsx - Dashboard page → Summary cards: renders
frontend/src/pages/Dashboard/DashboardPage.tsx - Dashboard page → Alert summary: renders
frontend/src/pages/Dashboard/DashboardPage.tsx - Dashboard page → Risk distribution: renders
frontend/src/pages/Dashboard/DashboardPage.tsx - Dashboard page → Recent activity: renders
frontend/src/pages/Dashboard/DashboardPage.tsx - Dashboard page → Theme preference: uses
frontend/src/pages/Dashboard/DashboardPage.tsx - Summary cards → Dashboard queries: queries
frontend/src/components/dashboard/SummaryCards.tsx - Alert summary → Dashboard queries: queries
frontend/src/components/dashboard/AlertSummaryCard.tsx - Risk distribution → Dashboard queries: queries
frontend/src/components/dashboard/RiskDistributionCard.tsx - Recent activity → Dashboard queries: queries
frontend/src/components/dashboard/RecentActivityCard.tsx - Dashboard queries → Dashboard data service: calls
frontend/src/hooks/useDashboard.ts - Dashboard data service → Dashboard data contracts: uses
frontend/src/services/dashboard.ts - Risk distribution → Dashboard presentation: renders
frontend/src/components/dashboard/RiskDistributionCard.tsx - Recent activity → Dashboard presentation: renders
frontend/src/components/dashboard/RecentActivityCard.tsx - Alert summary → Dashboard presentation: renders
frontend/src/components/dashboard/AlertSummaryCard.tsx - Risk distribution → Loading and empty states: renders
frontend/src/components/dashboard/RiskDistributionCard.tsx - Recent activity → Loading and empty states: renders
frontend/src/components/dashboard/RecentActivityCard.tsx - Recent activity → Risk badge: renders
frontend/src/components/dashboard/RecentActivityCard.tsx - Risk badge → Dashboard formatting: uses labels
frontend/src/components/ui/RiskBadge.tsx - Risk distribution → Dashboard formatting: uses labels
frontend/src/components/dashboard/RiskDistributionCard.tsx - Dashboard queries → Transaction monitoring: retrieves monitoring data
README.md - Dashboard queries → Risk assessment: retrieves risk data
README.md - Detection and rules → Alert management: generates alerts
README.md - Alert management → Case management: initiates investigations
README.md - Address investigation screen → Address investigation: investigates
README.md - Transactions screen → Transaction monitoring: reviews transactions
README.md - Bitcoin data services → Bitcoin blockchain data: integrates data
README.md - Transaction monitoring → Application database: persists data
- Alert management → Application database: stores alerts
- Case management → Application database: stores cases