How thillainirmal-tech/sentinelpay works
SentinelPay is a simulated UPI payment platform that evaluates fraud before moving money, then processes payment outcomes and notifications asynchronously. The principal workflow starts with a customer submitting a payment, continues through transaction event publication and layered fraud analysis, and reaches bank debit only after approval. Separate branches cover registration and authentication, customer dashboards and fraud views, refunds/payment integrations, and notification delivery. Some service links and capabilities are documented in the README; unsampled implementation details are not asserted as verified calls.
Main entry points: FraudDetectionService.java Fraud verdict engine · PaymentProcessorService.java Payment processor · App.jsx React dashboard · AuthService.java Auth and tokens
Components 26
Customer application
- React dashboard
sentinelpay-frontend/src/App.jsx - Dashboard views
sentinelpay-frontend/src/pages/Dashboard.jsx - Fraud alerts
sentinelpay-frontend/src/pages/FraudAlerts.jsx
Identity and access
- API gateway
api-gateway/src/main/java/com/fraud/gateway/ApiGatewayApplication.java - Auth endpoints
auth-service/src/main/java/com/fraud/auth/controller/AuthController.java - Auth and tokens
auth-service/src/main/java/com/fraud/auth/service/AuthService.java - User records
auth-service/src/main/java/com/fraud/auth/entity/User.java
Payment intake
- Transaction intake
transaction-service/src/main/java/com/fraud/transaction/service/UpiPaymentService.java - Transaction event
common-dto/src/main/java/com/fraud/common/dto/TransactionEvent.java - Kafka event backbone
transaction-service/src/main/java/com/fraud/transaction/service/KafkaProducerService.java
Fraud and payment processing
- Transaction consumer
fraud-detection-service/src/main/java/com/fraud/detection/consumer/TransactionConsumer.java - Fraud verdict engine
fraud-detection-service/src/main/java/com/fraud/detection/service/FraudDetectionService.java - Rule configuration
fraud-detection-service/src/main/java/com/fraud/detection/config/FraudRulesProperties.java - Behavior history
fraud-detection-service/src/main/java/com/fraud/detection/model/UserTransactionHistory.java - Redis risk state
fraud-detection-service/src/main/java/com/fraud/detection/service/RedisService.java - AI analysis
fraud-detection-service/src/main/java/com/fraud/detection/service/AiFraudAnalysisService.java - Payment processor
fraud-detection-service/src/main/java/com/fraud/detection/payment/PaymentProcessorService.java - Razorpay integration
fraud-detection-service/src/main/java/com/fraud/detection/payment/RazorpayService.java - Bank service client
fraud-detection-service/src/main/java/com/fraud/detection/client/BankServiceClient.java
Banking and notifications
- Bank account service
bank-service/src/main/java/com/fraud/bank/service/BankService.java - Account and ledger
bank-service/src/main/java/com/fraud/bank/entity/BankAccount.java - Alert publisher
fraud-detection-service/src/main/java/com/fraud/detection/producer/NotificationProducer.java - Notification consumer
notification-service/src/main/java/com/fraud/notification/consumer/NotificationConsumer.java - Email delivery
notification-service/src/main/java/com/fraud/notification/service/EmailService.java
Other components
- Customer
- Email provider
Connections 27
- Customer → React dashboard: uses
README.md - React dashboard → API gateway: sends requests
- React dashboard → Dashboard views: routes to
sentinelpay-frontend/src/App.jsx - React dashboard → Fraud alerts: routes to
sentinelpay-frontend/src/App.jsx - API gateway → Auth endpoints: routes requests
README.md - Auth endpoints → Auth and tokens: delegates to
auth-service/src/main/java/com/fraud/auth/controller/AuthController.java - Auth and tokens → User records: persists users
auth-service/src/main/java/com/fraud/auth/service/AuthService.java - Auth and tokens → Bank account service: creates account
auth-service/src/main/java/com/fraud/auth/service/AuthService.java - Customer → Transaction intake: submits payment
README.md - Transaction intake → Transaction event: builds event
transaction-service/src/main/java/com/fraud/transaction/service/UpiPaymentService.java - Transaction intake → Kafka event backbone: publishes event
transaction-service/src/main/java/com/fraud/transaction/service/UpiPaymentService.java - Kafka event backbone → Transaction consumer: delivers events
README.md - Transaction consumer → Fraud verdict engine: analyzes transaction
- Fraud verdict engine → Rule configuration: uses thresholds
fraud-detection-service/src/main/java/com/fraud/detection/service/FraudDetectionService.java - Fraud verdict engine → Behavior history: evaluates history
fraud-detection-service/src/main/java/com/fraud/detection/service/FraudDetectionService.java - Fraud verdict engine → Redis risk state: reads and writes
fraud-detection-service/src/main/java/com/fraud/detection/service/FraudDetectionService.java - Fraud verdict engine → AI analysis: requests analysis
fraud-detection-service/src/main/java/com/fraud/detection/service/FraudDetectionService.java - Fraud verdict engine → Payment processor: gates payment
- Payment processor → Redis risk state: checks and stores
fraud-detection-service/src/main/java/com/fraud/detection/payment/PaymentProcessorService.java - Payment processor → Bank service client: requests money movement
fraud-detection-service/src/main/java/com/fraud/detection/payment/PaymentProcessorService.java - Bank service client → Bank account service: calls bank API
- Payment processor → Razorpay integration: creates order
fraud-detection-service/src/main/java/com/fraud/detection/payment/PaymentProcessorService.java - Bank account service → Account and ledger: persists balances
bank-service/src/main/java/com/fraud/bank/service/BankService.java - Payment processor → Alert publisher: publishes alerts
fraud-detection-service/src/main/java/com/fraud/detection/payment/PaymentProcessorService.java - Alert publisher → Notification consumer: sends events
- Notification consumer → Email delivery: dispatches email
- Email delivery → Email provider: sends mail